# 项目文档导航

## 一句话定位

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

## 文档导航

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

## 事实来源

当前可用事实来源：

- `reverse_file/20260702_442525195910165439_create_health_check.har`：CHIS 登录、查询、体检相关请求样例。
- `reverse_file/chis.application.hc.script.HealthCheckHtmlForm.js`：CHIS 前端体检表单保存逻辑。
- `reverse_file/chis.application.hc.schemas.*.sc`：体检相关 schema 逆向资料。
- 后续用户提供的其他项目 CHIS 登录代码和账号信息查询代码。

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