chisup/docs/README.md

项目文档导航

一句话定位

chisup 是一个面向第三方业务系统的基卫 CHIS 体检数据上报中间服务，第一版先跑通“第三方提交体检数据 -> 校验与幂等 -> 获取有效 CHIS 会话 -> 转换为 CHIS 体检保存格式 -> 提交 CHIS -> 返回统一结果”的闭环。

文档导航

• ../AGENTS.md：Codex / 通用 AI coding agent 的仓库级入口。
• ../CLAUDE.md：Claude Code 薄入口，具体规则以 AGENTS.md 为准。
• ../tasks.md：根目录任务总览。
• ../progress.md：执行历史流水，只追加记录任务执行、验证、阻塞和决策。
• AI 开发入口：agent 每次开始工作的入口、阅读顺序和任务领取规则。
• 项目愿景：为什么做、为谁做、产品原则、非目标。
• 需求：MVP 要什么、用户故事、验收标准。
• 技术栈：Python / Flask / Redis 等选型与命令。
• 架构设计：系统结构、模块职责、数据流和关键风险。
• 编码规则：AI 写代码前必须遵守的硬约束。
• 任务看板：按依赖拆分的小任务，agent 每轮只做一个。
• API 合约：第三方接口、错误格式、内部模块合约。
• 当前实现状态：当前代码现实、可运行命令和下一步。
• 收尾检查清单：会话结束前逐项检查。

事实来源

当前可用事实来源：

• reverse_file/20260702_442525195910165439_create_health_check.har：CHIS 登录、查询、体检保存相关请求样例。
• reverse_file/20260704_query_health_check.har：体检详情只读查询 HAR，包含 getHMNIListOfHTML 和 getCheckInfoDetail，Phase 2 只读验证的主要事实来源。
• reverse_file/20260704_sm2s.js：CHIS 前端 SM2 加密脚本，做 T-101 登录与密码/时间戳加密时对照参考（当前 SM2 另参考 hans_chis.sm2.sm2_encrypt）。
• reverse_file/chis.application.hc.script.HealthCheckHtmlForm.js：CHIS 前端体检表单保存逻辑。
• reverse_file/chis.application.hc.schemas.*.sc：体检相关 schema 逆向资料。
• 后续用户提供的其他项目 CHIS 登录代码和账号信息查询代码。

不要把未验证的猜测写入实现。