Health Git

# health-git

把 Git 工作流语义（Issue → Branch → Commit → PR → Review → Merge）搬到健康干预场景的 AI 助手技能。

用户每次打卡/录入数据 = `care_commit`，健康管理师/医生 Review 后 `merge` 进下一周计划，所有事件可审计。

## 使用场景

- **患者/消费者**：记录每日饮食、运动、用药打卡，提交 PR，等待审核
- **健康管理师/医生**：查看待审 PR，运行安全检查，approve/reject 干预计划
- **数据分析**：查看依从率、merge 率等指标，作为 reward model 训练信号

## 前置条件

服务默认运行在 `http://localhost:8090`，可通过环境变量覆盖：

```bash
export HEALTH_GIT_BASE_URL=http://localhost:8090
# 如开启鉴权：
export AUTH_ENABLED=true
export CONSUMER_API_KEY=consumer-key
export REVIEWER_API_KEY=reviewer-key
```

启动服务：
```bash
cd <项目目录>
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8090
```

初始化示例数据：
```bash
curl -X POST http://localhost:8090/api/seed
```

## API 速查

| 操作 | 方法 | 路径 |
|------|------|------|
| 健康检查 | GET | /api/health |
| 初始化数据 | POST | /api/seed |
| 查看全局看板 | GET | /api/dashboard |
| 提交打卡（care commit） | POST | /api/commits |
| 开启干预 PR | POST | /api/prs |
| 审核 PR | POST | /api/prs/{pr_id}/review |
| 记录结果指标 | POST | /api/outcomes |
| 查看指标 | GET | /api/metrics |
| 查看事件日志 | GET | /api/events |
| 查看检查规则 | GET | /api/rules |
| 更新检查规则 | PATCH | /api/rules/{rule_id} |

## 对话示例

**用户**：帮我记录今天的打卡：步行8000步，依从度80分

**助手操作**：
```bash
curl -s -X POST http://localhost:8090/api/commits \
  -H "Content-Type: application/json" \
  -d '{"branch_id":1,"user_id":1,"task_type":"exercise","evidence_text":"步行8000步","metric_value":8000,"adherence_score":80}'
```

---

**用户**：帮我提交本周干预计划的 PR，低风险

**助手操作**：
```bash
curl -s -X POST http://localhost:8090/api/prs \
  -H "Content-Type: application/json" \
  -d '{"branch_id":1,"requested_by":1,"summary":"本周饮食控制+步行计划","risk_level":"low"}'
```

---

**用户**：审核一下 PR #1，批准通过

**助手操作**...