docs: 更新 phase1_log,记录一致性审查结果并立项 .env.example

This commit is contained in:
simonkoson
2026-05-11 10:37:17 +08:00
parent 906936a2d1
commit 110e26f752
+7
View File
@@ -98,6 +98,12 @@ Session + Cookie 跨域时,CORS 必须 `allow_credentials=True`,且 `allow_origi
- [ ] **前后端联调验收**:浏览器登录 → 看到主框架 → 刷新登录态保持 → 登出回到登录页 - [ ] **前后端联调验收**:浏览器登录 → 看到主框架 → 刷新登录态保持 → 登出回到登录页
- [ ] **本地后端首次启动验证**:psql 跑 001_init.sql、create_admin.py 创管理员、uvicorn 启动后端、curl 或浏览器测三个接口 - [ ] **本地后端首次启动验证**:psql 跑 001_init.sql、create_admin.py 创管理员、uvicorn 启动后端、curl 或浏览器测三个接口
- [x] **路径 B 启动前一致性审查完成**(2026-05-11):
- 1 项必改(.env 密码)、2 项建议改(create_admin.py 注释 + editor_name_snapshot NOT NULL)、
4 项漏点已落实(.env 全审、cookie.txt 删除、__pycache__ 清理、.env.example 立项)
- 1 项 user.py sa_column 写法留至 Phase 1 末再决
- 1 项 schemas/auth.py 旧式 Config 留至 Phase 2+
### 5.2 跨 Phase 遗留(后续 Phase 触发时处理) ### 5.2 跨 Phase 遗留(后续 Phase 触发时处理)
- [ ] **SECRET_KEY 占位符**:`.env` 当前是 `change-me-to-a-random-string-in-production`,**Phase 5 部署到腾讯云前必须改**为真实随机值。生成命令:`python -c "import secrets; print(secrets.token_urlsafe(32))"` - [ ] **SECRET_KEY 占位符**:`.env` 当前是 `change-me-to-a-random-string-in-production`,**Phase 5 部署到腾讯云前必须改**为真实随机值。生成命令:`python -c "import secrets; print(secrets.token_urlsafe(32))"`
@@ -113,6 +119,7 @@ Session + Cookie 跨域时,CORS 必须 `allow_credentials=True`,且 `allow_origi
- [ ] **其他 Phase 的 SQLModel 模型文件**:001_init.sql 已建齐 12 张表,但模型文件目前只有 user.py。各 Phase 启动时再建对应的 episode.py / topic.py / knowledge_item.py 等 - [ ] **其他 Phase 的 SQLModel 模型文件**:001_init.sql 已建齐 12 张表,但模型文件目前只有 user.py。各 Phase 启动时再建对应的 episode.py / topic.py / knowledge_item.py 等
- [ ] **scripts 目录用途**:专门放运维脚本(create_admin.py 已就位,未来可能加 seed_data.py、reset_password.py),**不要混进 app/** - [ ] **scripts 目录用途**:专门放运维脚本(create_admin.py 已就位,未来可能加 seed_data.py、reset_password.py),**不要混进 app/**
- [ ] **`.env.example` 文件待创建**:供其他开发机 / Phase 5 部署参考。结构应与 .env 一致,但所有真实秘密替换为占位符。Phase 2 或 Phase 5 触发时补建。
--- ---