49 lines
3.2 KiB
Markdown
49 lines
3.2 KiB
Markdown
# chisup
|
||
|
||
基卫 CHIS 上报数据项目。项目目标是提供稳定的后端 API，供第三方系统提交体检数据；`chisup` 负责校验、转换、维护 CHIS 登录会话，并把符合 CHIS 接口格式的数据提交到基卫 CHIS。
|
||
|
||
当前仓库处于 MVP 起步阶段：已有 Flask application factory 地基、health check、基础配置和架构包目录。当前已确认可参考 `D:\hans\chupd\chis\login_client_v2.py` 迁移 CHIS 登录链路，public key 由配置提供；访问 CHIS 支持可选 `CHIS_PROXY` SOCKS5 代理；保存上报前先实现只读体检详情查询来验证登录、会话、加密和通用请求。
|
||
|
||
## 文档入口
|
||
|
||
| 文档 | 作用 |
|
||
| --- | --- |
|
||
| [AGENTS.md](AGENTS.md) | Codex / AI coding agent 的仓库级入口 |
|
||
| [CLAUDE.md](CLAUDE.md) | Claude Code 薄入口，指向 `AGENTS.md` |
|
||
| [tasks.md](tasks.md) | 根目录任务总览，详细任务以 `docs/06-tasks.md` 为准 |
|
||
| [progress.md](progress.md) | 执行历史流水，只追加记录 |
|
||
| [docs/README.md](docs/README.md) | 项目文档导航 |
|
||
| [docs/00-ai-start-here.md](docs/00-ai-start-here.md) | AI 开发入口、阅读顺序和任务领取规则 |
|
||
| [docs/01-vision.md](docs/01-vision.md) | 项目愿景、价值和非目标 |
|
||
| [docs/02-requirements.md](docs/02-requirements.md) | MVP 需求和验收标准 |
|
||
| [docs/03-tech-stack.md](docs/03-tech-stack.md) | 技术栈、运行命令和待定项 |
|
||
| [docs/04-architecture.md](docs/04-architecture.md) | 架构设计、模块职责、数据流和风险 |
|
||
| [docs/05-coding-rules.md](docs/05-coding-rules.md) | 编码纪律和验证规则 |
|
||
| [docs/06-tasks.md](docs/06-tasks.md) | 可逐步交付的任务看板 |
|
||
| [docs/api.md](docs/api.md) | 对第三方 API 与内部模块合约 |
|
||
| [docs/current-state.md](docs/current-state.md) | 当前代码现实、可运行命令和下一步 |
|
||
| [docs/clean-state-checklist.md](docs/clean-state-checklist.md) | 每轮结束前的收尾检查 |
|
||
|
||
## 当前事实
|
||
|
||
- Python 版本目标：当前系统 Python 3.8，不创建虚拟环境。
|
||
- Web 框架目标：Flask 3.0.3。
|
||
- Flask 结构：使用 application factory 模式，T-001 实现 `create_app(config_object=None)`。
|
||
- 依赖管理：T-001 创建 `requirements.txt`，使用 `python -m pip install -r requirements.txt` 安装到当前系统 Python 3.8 环境。
|
||
- 计划使用 Redis 保存 CHIS 会话缓存。
|
||
- 访问 CHIS 支持可选 `CHIS_PROXY`：为空直连，有值时 CHIS 登录、查询和保存请求走 SOCKS5 代理。
|
||
- 当前已有资料：`reverse_file/` 下的 CHIS 前端脚本、schema 和 HAR。
|
||
- 当前已有查询 HAR：`reverse_file/20260704_query_health_check.har`，包含 `getHMNIListOfHTML` 和 `getCheckInfoDetail`。
|
||
- 当前尚未确认：数据库、部署方式、第三方鉴权方式、仅凭 `healthCheck` 反查查询详情所需参数的链路。
|
||
|
||
## 推荐开工方式
|
||
|
||
新一轮开发先读：
|
||
|
||
1. [AGENTS.md](AGENTS.md)
|
||
2. [docs/00-ai-start-here.md](docs/00-ai-start-here.md)
|
||
3. [docs/current-state.md](docs/current-state.md)
|
||
4. [docs/06-tasks.md](docs/06-tasks.md)
|
||
|
||
编码前优先完成任务看板中的 Phase 0，先建立最小可运行 Flask 地基，再接入 CHIS 登录与会话验证，随后跑通只读体检详情查询，最后再做保存上报。
|