refactor: establish standalone application boundary

This commit is contained in:
leefer
2026-08-03 21:42:25 +08:00
parent cc5fb8d73e
commit e1e76cd51e
324 changed files with 63090 additions and 44743 deletions
+37
View File
@@ -0,0 +1,37 @@
# 小白复盘维护约束
本目录是小白复盘唯一正式源码。任何修改开始前必须读取:
1. `ARCHITECTURE.md`
2. `docs/product/小白复盘-完整产品规格说明书.md`
3. 与任务有关的`config/*.json`、源码和测试
`docs/migration/`保存迁移事实与历史证据,不是第二套产品实现。发生冲突时,依次以用户当前明确
决定、当前正式程序的真实行为、产品规格说明书为准。
## 产品边界
- 保持已经验收的功能、视觉、布局、动画、交互、响应式行为和日夜主题。
- 保持API路径、字段、状态码、流式协议、数据库兼容和账户隔离。
- 保持数据来源、日期、单位、复权、新鲜度、覆盖率和禁止静默降级规则。
- LLM只通过`backend/llm/`调用;浏览器请求只通过`frontend/shared/api.js`发出。
- 不得读取、导入或运行本目录父级的旧源码、静态资源、配置、测试或数据。
## 结构边界
- 保持模块化单体技术栈:一个Python进程、一个SQLite数据库、无构建前端。
- 业务代码进入`backend/features/<feature>/`,数据适配进入`backend/data/`,后台任务进入
`backend/jobs/`HTTP公共能力进入`backend/http/`
- 页面结构、行为和样式分别由`frontend/pages/<feature>/``frontend/shared/`的唯一所有者维护。
- 不建立根级兼容转发文件、第二套路由、第二套数据客户端或晚加载CSS补丁层。
- 不确定代码默认保留;删除前必须有引用扫描、测试和真实浏览器证据。
## 最低验收
1. 运行相关领域测试。
2. 运行`python tools/verify_baseline.py`
3. 涉及运行时或前端时运行`python tools/verify_baseline.py --e2e`
4. 检查`git diff --check`,并确认没有密钥、数据库和运行产物进入Git。
5. 用户可观察行为发生变化时,必须说明并由用户验收。
数据和`.env`必须成对备份。`data/private-mentor-skills/``data/*.db``runtime/``.env`不得提交。