173 lines
5.0 KiB
Markdown
173 lines
5.0 KiB
Markdown
|
# 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`。*
|