yu-zhi-ran/platform/ARCHITECTURE.md

宇之然内容创作管理平台 - 架构设计

愿景

打造一个可视化、可管理、可持续的内容生产系统，从脚本驱动升级为完整的软件产品。

技术栈

• 后端: FastAPI
• 前端: Vue 3 + Element Plus (CDN引入，无需构建)
• 数据库: SQLite (单文件，便于备份)
• 部署: Docker Compose (后端 + Nginx + 前端)
• 认证: 无（个人使用，本地访问）

核心模块

1. 选题管理: 选题CRUD、状态流转、优先级排序
2. 内容创作: 调用现有creator、预览、手动编辑
3. 合规审核: 自动检查、自动修复、人工审核
4. 发布管理: 多平台发布向导、链接记录、状态更新
5. 系统设置: 定时任务管理、日志查看

实施阶段

• 阶段1: 服务化改造（封装现有脚本为FastAPI接口）
• 阶段2: 基础Web界面（Vue单页应用，通过CDN加载）
• 阶段3: 完善与优化（图片上传、批量操作等）

部署

• Docker Compose 部署：app (FastAPI) + nginx (静态文件 + 反向代理)
• 数据持久化：数据库文件映射到宿主机
• 日志：容器内部分享，可导出

项目结构

platform/
├── docker-compose.yml
├── backend/
│   ├── Dockerfile
│   ├── requirements.txt
│   ├── app/
│   │   ├── main.py
│   │   ├── database.py
│   │   ├── models.py
│   │   ├── schemas.py
│   │   ├── api/
│   │   └── core/
│   └── logs/
├── frontend/
│   ├── index.html
│   ├── app.js
│   └── style.css
└── data/
    └── database.sqlite

决策

• 使用SQLite，无需额外服务
• 前端用CDN方式，避免Node.js构建复杂度
• 复用现有脚本，通过subprocess调用
• 未来可扩展PostgreSQL