txai-dev/yu-zhi-ran
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 全面升级项目架构 - PostgreSQL迁移 + 配置化改造

Browse Source 
主要变更:
- 数据库: SQLite → PostgreSQL (yzr_nr)
- 选题系统: 硬编码字段 → 配置化 (TopicField/TopicConfigField/TopicStatusConfig)
- 新增模型: ContentCalendar, ContentMetrics, MediaAsset, PlatformConfig, ContentTask
- 新增 API: topic-config, calendar, metrics, assets, tasks, platform-config
- 数据迁移: 现有选题数据迁移到新 schema (field_id/tags/custom_data/scoring_data)
- 初始化数据: 10个领域, 5种状态, 3个平台配置

服务运行: http://localhost:8001
默认账号: admin / admin123
This commit is contained in:
lt
2026-05-08 18:26:01 +08:00
parent ac48304532
commit cf5103bbca
14 changed files with 2701 additions and 344 deletions
Download Patch File Download Diff File Expand all files Collapse all files
PROJECT_UPGRADE.md
+321
View File
@@ -0,0 +1,321 @@
# 宇之然内容平台 - 项目升级规划
> 从"可持续生活垂直工具" → "通用内容运营全流程平台"
> Phase 1: 自用验证 → Phase 2: SaaS 产品化
> **最后更新: 2026-05-08**
---
## 一、项目定位
**目标**: 构建覆盖"选题→创作→审核→发布→搜集→反馈"全链路的内容运营工具。
**当前阶段**: 自用验证（Own Use），同时为 SaaS 产品化预留架构。
**核心原则**:
- 所有业务逻辑不写死领域/行业相关字段
- 选题系统完全配置化（评分字段/状态/标签/分类均可自定义）
- 数据库迁移到 PostgreSQL，支持后续多租户扩展
---
## 二、当前进度
### ✅ 已完成
| 模块 | 状态 | 说明 |
|------|------|------|
| **数据库迁移** | ✅ 完成 | SQLite → PostgreSQL (yzr_nr)，所有表已创建/同步 |
| **选题配置化** | ✅ 完成 | TopicField + TopicConfigField + TopicStatusConfig 模型，灵活领域/评分字段 |
| **选题 CRUD** | ✅ 完成 | 支持 field_id/status/tags 过滤，批量操作，评分计算 |
| **内容日历 API** | ✅ 完成 | 创建/更新/删除排期，按年月查询，状态管理 |
| **数据追踪 API** | ✅ 完成 | ContentMetrics 模型，仪表盘/趋势/多平台汇总 |
| **素材库 API** | ✅ 完成 | 上传/管理/标签/搜索，usage_count 统计 |
| **创作任务 API** | ✅ 完成 | ContentTask 异步任务，状态/进度/结果管理 |
| **平台配置 API** | ✅ 完成 | 知乎/微信/小红书 平台配置，含合规规则 |
| **初始化数据** | ✅ 完成 | 默认领域(10个)、状态(5种)、平台(3个)、管理员 |
| **服务器运行** | ✅ 运行中 | http://localhost:8001 |
### ⚠️ 待前端适配
以下新 API 已完成后端，但前端页面尚未适配：
| 模块 | API | 前端文件 |
|------|-----|---------|
| 选题配置 | /api/topic-config/* | topics.html 需改版 |
| 内容日历 | /api/calendar/* | 需新建 calendar.html |
| 数据分析 | /api/metrics/* | 需新建 metrics.html |
| 素材库 | /api/assets/* | 需新建 assets.html |
| 创作任务 | /api/tasks/* | 需新建 tasks.html |
| 平台配置 | /api/platform-config/* | 需新建 platforms.html |
### ⏳ 未实现功能
| 优先级 | 模块 | 功能点 | 说明 |
|--------|------|--------|------|
| P0 | **内容日历前端** | 日历视图、拖拽排期、提醒设置 | API 已就绪，需前端 |
| P0 | **数据看板前端** | 趋势图、平台对比、选题推荐 | API 已就绪，需前端 |
| P0 | **素材库前端** | 图片上传/管理/预览 | API 已就绪，需前端 |
| P0 | **创作任务前端** | 实时进度条、任务列表、取消 | API 已就绪，需前端 |
| P1 | **多平台适配** | 一篇长文 → 知乎/小红书/微信各格式 | 核心差异化功能 |
| P1 | **热点采集** | 跨平台热搜、趋势追踪 | 有 collector 脚本待集成 |
| P1 | **选题推荐** | 基于历史数据推荐选题 | API 已就绪 (recommend-topics) |
| P2 | **内容复用** | 长文 → 短笔记 → 回答 → 朋友圈文案 | 自动化脚本 |
| P2 | **通知系统** | 企业微信/飞书推送 | 有 wecom_notifier.py 待集成 |
| P2 | **定时任务** | APScheduler 自动执行流水线 | core/scheduler.py 已有 |
| P3 | **多租户** | 租户隔离、团队协作 | SaaS 预留 |
| P3 | **支付订阅** | 免费/专业版分级、用量统计 | SaaS 预留 |
---
## 三、技术架构
### 3.1 技术栈
| 层次 | 技术 | 说明 |
|------|------|------|
| 后端 | FastAPI 0.104+ | ASGI 异步框架 |
| ORM | SQLAlchemy 2.0+ | PostgreSQL + psycopg2 |
| 前端 | Vue 3 (CDN) + Element Plus | SPA 单页应用 |
| 数据库 | PostgreSQL 15 | 自用阶段单租户，SaaS 预留多租户 |
| 认证 | JWT (python-jose) + bcrypt | Bearer Token |
| 定时 | APScheduler | 内容日历/定时任务 |
### 3.2 数据库连接
```
环境变量:
USE_POSTGRES=true
PG_HOST=127.0.0.1
PG_PORT=5432
PG_DATABASE=yzr_nr
PG_USER=yzr_nr
PG_PASSWORD=aTX3WKKnPfRnM5PC
```
### 3.3 项目结构（后端）
```
platform/backend/app/
├── api/ # REST API 路由
│ ├── auth.py # 认证
│ ├── topics.py # 选题 CRUD [重构]
│ ├── articles.py # 文章管理
│ ├── publishing.py # 发布记录
│ ├── calendar.py # 内容日历 [NEW]
│ ├── metrics.py # 数据分析 [NEW]
│ ├── assets.py # 素材库 [NEW]
│ ├── tasks.py # 创作任务 [NEW]
│ ├── platform_config.py # 平台配置 [NEW]
│ ├── topic_config.py # 选题配置 [NEW]
│ └── admin/ # 管理后台
├── core/ # 业务逻辑
├── models.py # SQLAlchemy 模型 [重构]
├── schemas.py # Pydantic 验证 [重构]
├── database.py # 数据库连接 [重构]
├── initial_data.py # 初始化数据 [重构]
└── main.py # FastAPI 入口 [更新]
platform/frontend/
├── index.html # 主仪表盘
├── topics.html # 选题管理
├── calendar.html # 内容日历 [待建]
├── metrics.html # 数据分析 [待建]
├── assets.html # 素材库 [待建]
├── login.html
├── admin.html
└── ...
```
---
## 四、数据模型
### 4.1 选题系统（配置化）
```
TopicField（领域/分类）
id, name, icon, color, description, parent_id, sort_order, is_active
TopicConfigField（选题评分字段配置）
id, field_id → TopicField, name, key, field_type, weight, options, min/max, is_required, sort_order
TopicStatusConfig（状态配置）
id, status, label, color, icon, sort_order, is_default
Topic（选题，主表）
id, field_id → TopicField, field_name, title, status, priority_score, total_score,
format, core_concept, audience_pain, unique_angle, priority,
tags(JSON), custom_data(JSON), scoring_data(JSON),
cases(JSON), source_file, lock_by, lock_at,
created_at, updated_at, generated_at, ready_at, published_at,
compliance_score, platform_urls(JSON)
```
### 4.2 新增模型
| 模型 | 用途 |
|------|------|
| ContentCalendar | 内容日历/排期管理 |
| ContentMetrics | 文章数据追踪（阅读/点赞/评论等） |
| MediaAsset | 素材库（图片/视频/文档） |
| PlatformConfig | 平台配置（知乎/微信/小红书格式规则） |
| ContentTask | 创作任务（异步流水线状态） |
---
## 五、API 清单
### 选题配置
```
GET /api/topic-config/fields
POST /api/topic-config/fields
PUT /api/topic-config/fields/{field_id}
DELETE /api/topic-config/fields/{field_id}
GET /api/topic-config/fields/{field_id}/scoring
POST /api/topic-config/fields/{field_id}/scoring
PUT /api/topic-config/scoring/{config_id}
DELETE /api/topic-config/scoring/{config_id}
POST /api/topic-config/fields/{field_id}/scoring/batch
```
### 选题
```
GET /api/topics?field_id=&status=&tag=&search=&limit=&offset=
POST /api/topics
GET /api/topics/stats
GET /api/topics/{topic_id}
PUT /api/topics/{topic_id}
DELETE /api/topics/{topic_id}
POST /api/topics/{topic_id}/score
POST /api/topics/{topic_id}/publish
POST /api/topics/{topic_id}/lock
POST /api/topics/{topic_id}/unlock
GET /api/topics/{topic_id}/articles
GET /api/topics/{topic_id}/metrics
POST /api/topics/batch-update-status
GET /api/topics/field-distribution
```
### 内容日历
```
GET /api/calendar?year=&month=
GET /api/calendar/entries?start_date=&end_date=&status=&platform=
POST /api/calendar/entries
PUT /api/calendar/entries/{entry_id}
DELETE /api/calendar/entries/{entry_id}
POST /api/calendar/entries/bind-topic
POST /api/calendar/entries/from-topic?topic_id=&platform=
GET /api/calendar/stats?year=&month=
```
### 数据分析
```
GET /api/metrics/dashboard?days=
GET /api/metrics/trend?days=&group_by=
GET /api/metrics/entries?topic_id=&platform=
POST /api/metrics/entries
PUT /api/metrics/entries/{metric_id}
DELETE /api/metrics/entries/{metric_id}
GET /api/metrics/topics/{topic_id}
GET /api/metrics/by-platform
GET /api/metrics/recommend-topics?limit=
```
### 素材库
```
GET /api/assets?file_type=&tag=&topic_id=&search=&limit=&offset=
GET /api/assets/tags
GET /api/assets/counts
POST /api/assets/upload
PUT /api/assets/{asset_id}
DELETE /api/assets/{asset_id}
POST /api/assets/{asset_id}/use
```
### 创作任务
```
GET /api/tasks?status=&topic_id=&stage=&limit=
GET /api/tasks/active
POST /api/tasks
GET /api/tasks/{task_id}
PUT /api/tasks/{task_id}/start
PUT /api/tasks/{task_id}/progress
PUT /api/tasks/{task_id}/complete
PUT /api/tasks/{task_id}/fail
DELETE /api/tasks/{task_id}
POST /api/tasks/run-creator
```
### 平台配置
```
GET /api/platform-config?active_only=
POST /api/platform-config
GET /api/platform-config/{platform}
PUT /api/platform-config/{platform}
DELETE /api/platform-config/{platform}
```
---
## 六、实施计划
### Phase 1（当前）：自用验证
**目标**: 2个月内完成全链路闭环，自己稳定产出10-20篇文章
**已完成**:
- ✅ 数据库迁移 PostgreSQL
- ✅ 选题系统配置化
- ✅ 所有新模型 + API 后端完成
- ✅ 服务运行中
**进行中**:
- ⏳ 前端适配（新页面）
**待开发**:
- 前端: 内容日历/数据分析/素材库/创作任务 页面
- 前端: 选题管理改版（适配配置化）
- 集成: 热点采集脚本 → API
- 集成: 企微通知 → API
- 集成: 多平台格式适配
### Phase 2：SaaS 产品化（待定）
---
## 七、启动方式
```bash
cd /root/openclaw-workspace/projects/yu-zhi-ran/platform/backend
# 环境变量（.env 已配置）
USE_POSTGRES=true PG_HOST=127.0.0.1 PG_PORT=5432 \
PG_DATABASE=yzr_nr PG_USER=yzr_nr PG_PASSWORD=aTX3WKKnPfRnM5PC \
python3 -m uvicorn app.main:app --host 0.0.0.0 --port 8001 --reload
# 默认管理员: admin / admin123
# API 文档: http://localhost:8001/docs
```
---
## 八、数据库当前状态
```
领域: 10 个（未来工作方式、AI与效率、可持续生活、数字游民、个人成长、科技人文、个人知识工厂、科技人文交叉、可持续生活系统、测试）
选题: 26 个
状态分布: 待处理20 / 待审查2 / 待发布3 / 已发布1
平台: 3 个（知乎/微信公众号/小红书）
```
---
*文档版本: v0.2*
*更新时间: 2026-05-08*