75 lines
3.7 KiB
Markdown
75 lines
3.7 KiB
Markdown
# 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`：确认在项目根目录（Windows 下为 `D:\PythonP\chisup`，WSL / bash 下为 `/mnt/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 # PowerShell
|
||
# bash 等价: find . -type f -not -path './.git/*'
|
||
```
|
||
|
||
项目初始化后，把真实命令同步到 [03-tech-stack.md](03-tech-stack.md)、[05-coding-rules.md](05-coding-rules.md) 和 [current-state.md](current-state.md)。
|