# AI 开发入口

> 给 AI coding agent 的项目入口。这里负责导航和流程，硬性编码规则见 [05-coding-rules.md](05-coding-rules.md)。

## 一句话定位

`chisup` 是基卫 CHIS 体检数据上报中间服务。MVP 先完成稳定后端 API：先用 CHIS 只读体检详情查询验证登录、会话、加密和通用请求，再接入第三方体检数据上报与 CHIS 保存。

## 必读顺序

每次开始写代码前，按这个顺序建立上下文：

1. [../AGENTS.md](../AGENTS.md)：仓库级规则。
2. [01-vision.md](01-vision.md)：为什么做、为谁做、什么不做。
3. [02-requirements.md](02-requirements.md)：MVP 要什么、怎么算达成。
4. [03-tech-stack.md](03-tech-stack.md)：既定技术选型。
5. [04-architecture.md](04-architecture.md)：系统结构、职责划分、数据流和风险。
6. [05-coding-rules.md](05-coding-rules.md)：写代码前必须遵守的规则。
7. [06-tasks.md](06-tasks.md)：领取本轮唯一任务。
8. [../progress.md](../progress.md)：历史执行记录、验证结果、阻塞点和关键决策。
9. [current-state.md](current-state.md)：当前代码现实、可运行命令、下一步任务。

## 固定开工流程

1. `pwd`：确认在 `D:\PythonP\chisup`。
2. 读 [../progress.md](../progress.md) 和 [current-state.md](current-state.md)。
3. 查看当前文件清单和最近改动；如果未来接入 git，先看 `git status` 和 `git log --oneline -5`。
4. 若已有项目代码，运行标准验证命令；如果还未初始化代码，先完成 Phase 0 任务。
5. 从 [06-tasks.md](06-tasks.md) 领取第一个 `TODO` 且依赖均完成的任务。
6. 开始前把任务标为 `DOING`，完成并验证后标为 `DONE`。
7. 结束前更新 [current-state.md](current-state.md)，向 [../progress.md](../progress.md) 追加记录，并检查 [clean-state-checklist.md](clean-state-checklist.md)。

## MVP 边界

MVP 只做：

- 第三方体检上报 API。
- 第三方请求鉴权、参数校验和幂等。
- CHIS 登录会话管理：优先复用 Redis 中有效会话，失效后重登。
- 用账号信息查询或等价接口确认 CHIS 会话有效。
- 体检详情只读查询：先用 `healthCheck + phrId + idCard + checkDate` 验证 CHIS 通道。
- 体检数据到 CHIS 保存请求的最小转换闭环。
- 通用 CHIS request 封装、错误码映射、日志脱敏。

MVP 不做：

- 管理后台。
- 多业务类型全面覆盖。
- 批量导入 UI。
- 绕过 CHIS 权限、验证码、风控或审计。
- 把第三方数据直接落入 CHIS 数据库。

## 常见任务该看哪里

做 API：先看 [api.md](api.md)，再看 [04-architecture.md](04-architecture.md)。

做 CHIS 登录：先看 `D:\hans\chupd\chis\login_client_v2.py`，再看 HAR 中 `myRoles`、`myApps` 链路；public key 从配置读取，不硬编码。

做 CHIS 只读查询：先看 `reverse_file/20260704_query_health_check.har`，优先实现 `getHMNIListOfHTML` 和 `getCheckInfoDetail`；当前不能假设只传 `healthCheck` 就能查详情。

做体检转换：先看 `reverse_file/chis.application.hc.script.HealthCheckHtmlForm.js` 的 `getSaveRequest` 和 `saveToServer`，再看 schema 文件，最后补充 mapper 测试。

做 Redis 会话：先看 [04-architecture.md](04-architecture.md) 的会话对象设计，不要只保存裸 cookie。

## 当前验证命令

当前尚未初始化代码，文档检查命令：

```powershell
Get-ChildItem -Recurse -File
```

项目初始化后，把真实命令同步到 [03-tech-stack.md](03-tech-stack.md)、[05-coding-rules.md](05-coding-rules.md) 和 [current-state.md](current-state.md)。