# AGENTS.md

> Codex / AI coding agent 的仓库级入口。进入本仓库后，先读本文，再进入 `docs/00-ai-start-here.md`。

## 项目定位

`chisup` 是一个基卫 CHIS 上报数据后端服务，第一版目标是提供 API 给第三方提交体检数据，并将数据转换为 CHIS 体检保存接口所需格式后提交到 CHIS。

当前不是完整代码仓库，处于文档和逆向资料整理阶段。已有 `reverse_file/` 中的 CHIS 前端脚本、schema 和 HAR；`D:\hans\chupd\chis\login_client_v2.py` 可作为 CHIS 登录链路参考，`reverse_file/20260704_query_health_check.har` 可作为体检详情只读查询参考。

## 必读顺序

每次开始工作前，按顺序读取：

1. `README.md`：了解项目定位和文档集合。
2. `docs/README.md`：了解文档导航。
3. `docs/00-ai-start-here.md`：理解 AI 开发入口流程。
4. `docs/05-coding-rules.md`：理解编码和安全纪律。
5. `docs/current-state.md`：确认当前仓库现实。
6. `docs/06-tasks.md`：领取本轮唯一任务。
7. 与当前任务相关的具体文档。

如果用户提供新的 CHIS 请求样例、schema 或业务规则，先把事实同步到相关文档，再进入实现。

## 工作规则

- 不臆造 CHIS 字段、接口、错误码、登录参数和加密规则。
- 不把真实账号、密码、Cookie、内网地址、token 写入代码或文档样例。
- CHIS 逆向资料仅作为事实来源之一；最终以可运行请求、用户提供代码和实际响应为准。
- view 层保持薄，业务转换放在 service / mapper，CHIS 网络调用放在 client / auth。
- 第三方调用鉴权、CHIS 账号凭证、Redis 会话缓存、幂等和日志脱敏是必须重点关注的边界。
- 任务完成必须有真实验证命令或明确说明当前无法验证的原因。

## 当前优先级

1. 建立 Flask 3.0.3 + Python 3.8 最小可运行地基。
2. 迁移 CHIS 登录链路，并用账号信息查询确认会话有效。
3. 设计 Redis 会话缓存和失效重登策略。
4. 先跑通体检详情只读查询，验证登录、会话、加密和通用 request。
5. 建立第三方体检上报 API 合约、参数校验和幂等。
6. 实现体检数据转换和 CHIS 保存提交。

## 验证

当前尚未有生产代码，暂以文件和文档检查为主：

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

项目初始化后，必须把真实安装、测试和启动命令同步到 `docs/03-tech-stack.md`、`docs/05-coding-rules.md` 和 `docs/current-state.md`。