文档	讲什么	受众
`.clinerules`	Cline 协作规则 + 业务约定 + 已知避坑	AI 必读,人类一并看
`project_plan.md`	产品 / 业务 / 用户(做什么、为谁做)	全员
`dev_plan.md`	技术路线 / 阶段计划(怎么做、何时做)	制片人 + AI
`docs/git_workflow.md`	Git 操作手册	制片人 + AI
`logs/phase{N}_log.md`	各 Phase 进度档案	接力者

新人 / 失忆接手时的标准动作:依次读完上面五类文档,再做任何改动。

当前进度

详见 logs/ 下最新一份日志。

Phase	状态
Phase 0 环境 + Git	单位机进行中
Phase 1 后端骨架	家用机已完成,单位机走"路径 B 迁移"
Phase 1 前端骨架	未开始
Phase 2-5	未开始

协作团队

角色	谁 / 什么	做什么
制片人	刘统(人)	拍板、产品决策、领域知识
高级技术顾问	Claude Opus 4.7(claude.ai 网页)	架构指导、关键决策审核
架构师	Sonnet 4.6 → MiniMax M2.7(Phase 2 起)	Cline Plan 模式,出方案
执行者	DeepSeek v4 pro	Cline Act 模式,写代码

详见 .clinerules 第二章。

技术栈速览

前端:React 18 + Vite + Ant Design 5 + Zustand(JavaScript,不用 TS)
后端:FastAPI + SQLModel(同步)
数据库:PostgreSQL 16 + pgvector(1536 维)
认证:Session + Cookie
AI 嵌入:DeepSeek 或 OpenAI 兼容 embedding API
Word 生成:docxtpl
部署:Nginx 反向代理 + 腾讯云 4核8G(待租)

详见 dev_plan.md 第五章。

服务整合架构

                  ┌────────────────────┐
   主域名访问 →   │  腾讯云 4核8G 新机  │  ← TPS 中台主体
                  │  (Nginx + FastAPI │
                  │   + PostgreSQL +  │
                  │   React 前端)     │
                  └─────────┬──────────┘
                            │
                       Nginx 反代
                            │
                            ▼
                  ┌────────────────────┐
                  │  老服务器 2核2G    │  ← 蓝皓 TTS 2.0 + MMIM
                  │  101.42.29.217     │
                  └────────────────────┘

详见 project_plan.md 第八章。

快速开始(Phase 1 后端验证)

假设你已完成 Phase 0(Python / Node / PG / Git 都装好,仓库已 clone)。

cd backend

# 1. 装依赖
pip install -r requirements.txt

# 2. 建库 + 建表
psql -U postgres -d milsci_dev -f sql/001_init.sql

# 3. 创建管理员账号(交互式)
python scripts/create_admin.py

# 4. 启动 FastAPI
uvicorn app.main:app --reload

# 5. 验证
#    GET  http://localhost:8000/docs        ← FastAPI 自动文档
#    POST http://localhost:8000/api/auth/login
#    GET  http://localhost:8000/api/auth/me

前端启动详见 dev_plan.md Phase 1 Day 5-7。

不在 1.0 范围内

明确不做、留到 2.0 或更远的:

TypeScript 改造、Alembic、async SQLAlchemy
AI 模型配置 UI(写死 .env)
模块 D 的 AI 预测(只展示原文)
文稿写作辅助系统
Karpathy LLM Wiki 知识库形态(仅预埋接口)
移动端 App
多栏目复用

详见 project_plan.md 第十二章 + dev_plan.md 第八章。

联系与求助

状况	找谁
项目方向 / 产品决策	刘统(制片人)
关键架构 / 风险 / 卡壳兜底	Claude Opus 4.7(claude.ai 网页)
日常方案 / 改动审查	Sonnet 4.6(VS Code Cline Plan)
写代码	DeepSeek v4 pro(VS Code Cline Act)
Git 历史搞乱了 / 不小心 commit 了 .env	立刻找 Claude Opus 4.7,不要自己瞎搞

版本演进

版本	日期	变化
v1	2026-05-06	初版,作为单位机仓库门牌

这是项目门牌号。详细内容请翻 project_plan.md / dev_plan.md / .clinerules / docs/git_workflow.md。