docs: clarify system python 3.8 usage

This commit is contained in:
ila
2026-07-04 22:46:26 +08:00
parent baf77d1176
commit 21dbdf81ed
5 changed files with 18 additions and 5 deletions
+4 -2
View File
@@ -6,7 +6,7 @@
| 维度 | 选型 | 状态 | 理由 / 说明 |
| --- | --- | --- | --- |
| 运行时 | Python 3.8 | 已定 | 用户指定 |
| 运行时 | 当前系统 Python 3.8 | 已定 | 用户指定,不创建虚拟环境 |
| Web 框架 | Flask 3.0.3 | 已定 | 用户指定,适合轻量 API 服务 |
| 数据校验 | 待定,建议 Pydantic v1 或 Marshmallow | 待定 | Python 3.8 下需注意版本兼容 |
| HTTP 客户端 | 待定,建议 `requests.Session` | 待定 | CHIS 会话 cookie 管理简单稳定 |
@@ -20,6 +20,7 @@
## 二、决策记录与演进
- Flask 3.0.3 + Python 3.8 已定,但 Python 3.8 生命周期已结束;如果部署环境允许,未来建议评估 Python 3.10+。
- 本项目使用当前系统 Python 3.8 环境,不创建虚拟环境;依赖仍必须写入 `requirements.txt` 并固定关键版本。
- Redis 是会话缓存核心,不建议把 CHIS 会话保存在进程内存。
- CHIS public key 从配置文件或环境变量读取;当前不依赖 `/chis/logon/publicKey` 动态获取。
- CHIS 登录代码来自 Django 项目参考实现,迁移到 Flask 时只复用登录链路、SM2 算法和请求形状,不复用 Django model/cache。
@@ -32,7 +33,7 @@
| 用途 | 命令 |
| --- | --- |
| 安装依赖 | 待定 |
| 安装依赖 | `python -m pip install -r requirements.txt` |
| 本地开发 | 待定 |
| 测试 | 待定 |
| 格式化 / 静态检查 | 待定 |
@@ -46,5 +47,6 @@ Get-ChildItem -Recurse -File
## 四、依赖纪律
- 新增依赖前先说明用途、替代方案和 Python 3.8 兼容性。
- 不创建 `.venv`、`venv` 或其他项目虚拟环境目录;如需隔离,必须先更新本文并取得确认。
- 和 CHIS 登录、SM2/RSA/AES 加密相关的依赖必须由真实登录代码驱动,不要凭 HAR 猜;当前 SM2 参考 `hans_chis.sm2.sm2_encrypt`。
- 不允许在代码或 `.env.example` 中写真实 CHIS 地址、账号、密码、Cookie。