chisup/docs/00-ai-start-here.md

AI 开发入口

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

一句话定位

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

必读顺序

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

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

固定开工流程

1. pwd：确认在项目根目录（Windows 下为 D:\PythonP\chisup，WSL / bash 下为 /mnt/d/PythonP/chisup）。
2. 读 ../progress.md 和 current-state.md。
3. 查看当前文件清单和最近改动；如果未来接入 git，先看 git status 和 git log --oneline -5。
4. 若已有项目代码，运行标准验证命令；如果还未初始化代码，先完成 Phase 0 任务。
5. 从 06-tasks.md 领取第一个 TODO 且依赖均完成的任务。
6. 开始前把任务标为 DOING，完成并验证后标为 DONE。
7. 结束前更新 current-state.md，向 ../progress.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，再看 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 的会话对象设计，不要只保存裸 cookie。

当前验证命令

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

Get-ChildItem -Recurse -File          # PowerShell
# bash 等价: find . -type f -not -path './.git/*'

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