# 宇之然内容创作平台

> 覆盖"选题→创作→审核→发布→数据追踪"全链路的内容运营工具

**最后更新: 2026-05-12**

---

> **项目进度 → 详见 [PROGRESS.md](PROGRESS.md)**（本文件为唯一进度真理源）

---

## 技术栈

| 层次 | 技术 |
|------|------|
| 后端 | FastAPI 0.104+ |
| ORM | SQLAlchemy 2.0+ |
| 数据库 | PostgreSQL 16 |
| 前端 | Vue 3 (CDN) + Element Plus |
| 认证 | JWT (python-jose) + bcrypt |

---

## 数据库配置

详见 `platform/backend/.env`

---

## 启动方式

```bash
cd /root/openclaw-workspace/projects/yu-zhi-ran
./start-platform.sh 8001
```

默认管理员: **admin** / **admin123**

---

## 页面入口

| 页面 | 地址 |
|------|------|
| 仪表盘 | http://localhost:8001/ |
| 选题管理 | http://localhost:8001/topics.html |
| 内容日历 | http://localhost:8001/calendar.html |
| 数据分析 | http://localhost:8001/metrics.html |
| 素材库 | http://localhost:8001/assets.html |
| 创作任务 | http://localhost:8001/tasks.html |
| 平台配置 | http://localhost:8001/platforms.html |
| 系统管理 | http://localhost:8001/admin.html |
| API 文档 | http://localhost:8001/docs |

---

## API 模块

| 模块 | 文件 | 功能 |
|------|------|------|
| 认证 | auth.py | 登录/注册/JWT |
| 选题 | topics.py | CRUD、评分、批量操作 |
| 选题配置 | topic_config.py | 领域/评分字段/状态配置 |
| 文章 | articles.py | 文章管理 |
| 发布 | publishing.py | 发布记录 |
| 内容日历 | calendar.py | 排期、绑定选题 |
| 数据分析 | metrics.py | 仪表盘、趋势、推荐 |
| 素材库 | assets.py | 上传、标签、搜索 |
| 创作任务 | tasks.py | 异步任务、进度管理 |
| 平台配置 | platform_config.py | 知乎/微信/小红书 |
| 系统管理 | admin.py | 用户/案例/日志/配置 |

---

## 数据模型

- **TopicField** - 领域分类配置
- **TopicConfigField** - 选题评分字段
- **TopicStatusConfig** - 选题状态配置
- **Topic** - 选题主表
- **ContentCalendar** - 内容日历
- **ContentMetrics** - 数据追踪
- **MediaAsset** - 素材库
- **PlatformConfig** - 平台配置
- **ContentTask** - 创作任务
- **User** - 用户
- **Case** - 案例库

---

## 初始化数据

- 领域: 6 个（未来工作方式、AI与效率、可持续生活、数字游民、个人成长、科技人文）
- 状态: 5 种（待处理、待审查、草稿、待发布、已发布）
- 平台: 3 个（知乎、微信公众号、小红书）
- 管理员: admin/admin123

---

## 项目结构

```
yu-zhi-ran/
├── platform/
│   ├── backend/
│   │   ├── app/
│   │   │   ├── api/          # REST API
│   │   │   ├── core/         # 业务逻辑
│   │   │   ├── models.py     # SQLAlchemy 模型
│   │   │   ├── schemas.py    # Pydantic 验证
│   │   │   ├── database.py  # 数据库连接
│   │   │   ├── main.py       # FastAPI 入口
│   │   │   └── initial_data.py
│   │   └── venv/
│   └── frontend/             # Vue + Element Plus SPA
├── automation/              # 自动化脚本
├── content/                 # 内容数据
└── scripts/                 # 工具脚本
```