# TPS 中台

> 央视《军事科技》栏目内部工作台
> 仓库:`tps-dashboard` · 内部团队可见

---

## 这是什么

一个面向《军事科技》栏目 8 人团队的内部工作台,核心模块包括:

- **TPS**(选题策划系统):查重 + 知识库参考 + 报题单一键生成
- **仪表盘**:近 4 期收视成绩 + 未来 6 期排期一目了然
- **知识库**:往期文稿、军报材料、专家库、外拍线索一站式检索
- **个人首页**:每位编导有自己的工作台 + 今日热点雷达
- **拍摄资源库**:外拍联系人 / 单位 / 线索来源结构化沉淀

详细模块说明见 `project_plan.md`。

---

## 设计哲学

**辅助而不替代,AI 给方向不给答案,保护编导创作主权。**

任何让 AI 替编导拍板的功能都不要做;任何把编导逼向"按 AI 建议改"的设计都要重做。

---

## 项目宪法(必读,优先级从高到低)

| 文档 | 讲什么 | 受众 |
|---|---|---|
| `.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)。

```bash
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`。*