Yuzhiran Dev
9c37c9a574
Phase 4: org_id 注入 JWT/API 过滤/组织管理 CRUD/前端组织列 测试: tests/test_phase_upgrades.py 97项全覆盖 CSS: theme-modern.css 共享 mobile-card-list/status-dot/search-bar 等模式 修复: initial_data.py LLM配置 NOT NULL 约束, TopicResponse 含 org_id
172 lines
9.3 KiB
Markdown
172 lines
9.3 KiB
Markdown
# 宇之然 · 项目进度总览
|
||
|
||
> 本文件为项目进度唯一真理源，所有进度信息以此为准。
|
||
> 其他文档中的进度描述一律以本文为准。
|
||
|
||
**最后更新**：2026-05-16 (v14)
|
||
|
||
---
|
||
|
||
## 一、项目总览
|
||
|
||
| 项目 | 内容 |
|
||
|------|------|
|
||
| 品牌 | 宇之然 — 科技沟通万物，愿世间百态回归自然 |
|
||
| 技术栈 | FastAPI + SQLAlchemy + PostgreSQL 15 + Vue 3 (CDN) + Element Plus |
|
||
| 平台服务 | 运行中 (端口 8001) |
|
||
| 策略阶段 | 全球-本土对比研究（2026-04-15 升级） |
|
||
| Git 提交 | 92 commits · 4 tags (v1.0.0~v1.0.4) · main 分支 |
|
||
|
||
---
|
||
|
||
## 二、里程碑完成情况
|
||
|
||
| 里程碑 | 说明 | 计划 | 实际 | 状态 |
|
||
|--------|------|------|------|------|
|
||
| M1 | 项目框架搭建完成 | 2026-04-10 | 2026-04-10 | ✅ |
|
||
| M2 | 首批选题确定 | 2026-04-12 | 2026-04-10 | ✅ |
|
||
| M3 | 首篇文章发布 | 2026-04-14 | 2026-04-14 | ✅ |
|
||
| M4 | 首月发布4篇 | 2026-05-10 | — | ⏳ 3篇完成 |
|
||
|
||
---
|
||
|
||
## 三、发布记录
|
||
|
||
| 编号 | 标题 | 日期 | 平台 | 状态 |
|
||
|------|------|------|------|------|
|
||
| 001 | 种菜一年，焦虑降了43%：我在阳台治愈了自己 | 2026-04-14 | 知乎/微信/小红书 | ✅ 已发布 [知乎链接](https://zhuanlan.zhihu.com/p/2026998296120411553) |
|
||
| TOPIC-BBB1CC | 城市农业新趋势：东京垂直农场与上海阳台种菜对比研究 | 2026-04-21 | 知乎/微信/小红书 | ✅ 已发布 |
|
||
| A01 | 远程工作2026中国指南：从"不可能"到"可行"的路径图 | 2026-04-23 | 知乎/微信/小红书 | ✅ 已发布 |
|
||
|
||
---
|
||
|
||
## 四、模块进度
|
||
|
||
### 4.1 平台系统
|
||
|
||
| 模块 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| 后端 API (auth/topics/articles/publishing/calendar/metrics/assets/tasks/platform_config/admin) | ✅ 完成 | 核心 11 个 API 模块，JWT 认证 |
|
||
| 扩展 API (cases/audit/llm_configs/system_configs/optimizer_logs/task_logs) | ✅ 完成 | 新增案例库、审计、LLM 配置等模块 |
|
||
| 前端页面 (仪表盘/选题/日历/数据/素材/任务/平台/系统管理/用户/日志/文章) | ✅ 完成 | Vue 3 + Element Plus SPA |
|
||
| 数据库 (PostgreSQL 15) | ✅ 运行中 | `yzr_nr` 库 |
|
||
| 服务 | ✅ 运行中 | 端口 8001 |
|
||
| 数据库迁移 (SQLite→PostgreSQL) | ✅ 完成 | 2026-05-08 |
|
||
| PWA 离线支持 | ✅ 完成 | manifest.json + Service Worker + 离线页面 |
|
||
| articles 表 + 数据迁移 | ✅ 完成 | 48 篇文章从文件系统迁入 DB，释放文件已清理 |
|
||
|
||
### 4.2 内容生产
|
||
|
||
| 模块 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| 选题库 | ✅ 完成 | 10 个旧选题 (001~010) + 20 个新选题 (4 大支柱) |
|
||
| 文章草稿 (001 系列) | ✅ 完成 | 大纲/初稿/优化版/微信版 四版齐备 |
|
||
| 配图生产 | ✅ 完成 | 10 张 SVG + 10 张 PNG，含压缩版 |
|
||
| 合规审查 | ✅ 完成 | 评分 9.2/10，引用来源补充完成 |
|
||
| 多平台发布 (001 / BBB1CC / A01) | ✅ 完成 | 知乎/微信/小红书 三平台均已发布 |
|
||
| 银发科技适配指南 | ⏳ 写作中 | drafts 中 302 行初稿 |
|
||
| F01 AI写作实战 | ✅ 已入库 | 三平台文章已存入 articles 表，待审查通过后发布 |
|
||
| F02 平台差异策略 | ✅ 已入库 | 三平台文章已存入 articles 表，待审查通过后发布 |
|
||
|
||
### 4.3 自动化系统
|
||
|
||
| 脚本 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| publish_to_zhihu.sh | ✅ 可用 | 知乎自动发布 |
|
||
| publish_to_wechat_mp.sh | ✅ 可用 | 微信公众号自动发布 |
|
||
| generate_images.py / image_generator.py | ✅ 可用 | SVG + PNG 配图生成 |
|
||
| compliance_checker.py | ✅ 可用 | 合规审查（敏感词/平台规则/品牌规范） |
|
||
| compliance_optimizer.py | ✅ 重构 | 移除 manual_review，改为迭代LLM修复（最多3次），合规分回写入Topic |
|
||
| creator.py / writer.py / outline.py / research.py | ✅ 优化 | 全链路LLM提示词优化（SEO/平台适配/真人感） |
|
||
| collector.py / collector_db_integration.py | ✅ 可用 | 趋势采集 |
|
||
| wecom_notifier.py | ✅ 可用 | 企业微信通知 |
|
||
| db_helper.py | ✅ 扩展 | update_topic_status 支持保存 compliance_score |
|
||
|
||
### 4.4 流水线流程
|
||
|
||
| 步骤 | 触发方式 | 说明 |
|
||
|------|---------|------|
|
||
| 采集 | 定时 01:30 | 热点趋势采集→生成选题建议→存入选题库 |
|
||
| 同步 | 定时 02:30 | DB → JSON 备份同步 |
|
||
| 创作 | 手动点击 / 定时 03:30 | 生成三平台文章 → 存入 articles 表 → 状态→待审查 |
|
||
| 审查 | 手动点击 / 创作后自动 | 从 articles 表读取 → 合规检查 → LLM迭代修复(最多3次)→合规分回写→状态→待发布 |
|
||
| 发布 | 手动点击 | 仅待发布状态可选 |
|
||
|
||
---
|
||
|
||
## 五、当前任务队列
|
||
|
||
### ✅ 已完成
|
||
|
||
| 任务 | 完成日期 | 备注 |
|
||
|------|---------|------|
|
||
| 审查流程优化（移除 manual_review） | 2026-05-14 | 改为迭代LLM修复(最多3次)，合规分回写Topic |
|
||
| 内容采集加入定时调度 | 2026-05-14 | scheduler 新增 scheduled_collect 01:30 |
|
||
| 全链路LLM提示词优化 | 2026-05-14 | 覆盖trends/topic_selector/research/outline/writer/nvidia_client/compliance 共8文件≈24个提示词，增强SEO/平台推荐/真人感 |
|
||
| 导航布局重构 | 2026-05-16 | navbar + navigation 合并为 uni-nav，单行 top-bar 自适应 PC/H5，10 页迁移完成 |
|
||
| 文章管理页面 (articles.html) | 2026-05-16 | 新增 articles API (list/detail/delete) + 完整管理页面，支持筛选/搜索/预览/删除 |
|
||
| CSS架构统一整合 | 2026-05-16 | reset/body/layout/card/page-header/filter/toolbar 移入 theme-modern.css（86→127行），10页内联CSS总量从~660行降至~400行；preview对话框CSS归一化；删除 dead JS；index.html双style块合并为单一亮色主题 |
|
||
| Phase 1.1 配图集成到创作流水线 | 2026-05-16 | image_generator.py 支持 --topic-id 参数, DB读写图片路径; Article 新增 images JSON字段+迁移; creator.py 新增配图步骤; API GET /api/articles/{topic_id}/images; 文章页预览显示封面图 |
|
||
| Phase 1.3 统一前端体验 | 2026-05-16 | users.html 补 loading+空状态; index.html 渲染loadingStats+fetchModules错误提示; metrics.html 渲染loadingDashboard |
|
||
| Phase 2.1 发布审批 UI | 2026-05-16 | 后端 MultiPublishRequest 多平台发布 API; 前端发布确认弹窗+平台勾选 |
|
||
| Phase 2.2 日历关联文章状态 | 2026-05-16 | 后端 enrich_entry 添加 topic_status+platform_icon; 前端日历卡片显示平台图标+Topic状态标签; 修复 el-tag 缺少闭合 |
|
||
| emoji 替换为 Element Plus 图标 | 2026-05-16 | icon-components.js 注册 25 个 SVG 图标组件; 11 页 emoji → `<el-icon>` 批量替换 |
|
||
| H5 卡片布局补全 | 2026-05-16 | metrics.html 热门选题/平台对比/选题推荐三表加 H5 卡片视图 |
|
||
| Phase 3.1 平台数据对接 | 2026-05-16 | scripts/sync_metrics.py (估计算法); scheduler 新增 scheduled_metrics_sync 06:00 |
|
||
| Phase 3.2 数据看板增强 | 2026-05-16 | Chart.js 集成: 趋势折线图/状态环形图/平台对比柱状图 |
|
||
| Phase 4 多租户隔离 (JWT+API 层) | 2026-05-16 | org_id 注入 JWT payload; 12 个 API 模块添加 org 过滤; 创建选题自动继承用户 org; 管理端组织 CRUD |
|
||
| Phase 4 前端多租户 | 2026-05-16 | admin.html 新增组织管理标签页 (列表/创建/编辑/删除); users.html 增加组织列+H5卡片显示 |
|
||
| Phase 4 预置数据修复 | 2026-05-16 | initial_data.py 管理员用户添加 org_id; opencode-go LLM config 补全 user_prompt_template |
|
||
|
||
### ⏳ 待办
|
||
|
||
| 任务 | 优先级 | 备注 |
|
||
|------|--------|------|
|
||
| M4 第 4 篇文章发布 (首月目标) | 中 | 可用银发科技或 F01 补齐 |
|
||
| 数据追踪接入 (阅读量/互动) | 中 | 需要对接平台 API |
|
||
| 选题库数据库同步 | 低 | 将选题从 markdown 同步至 PG |
|
||
| 归档 IMPLEMENTATION_PLAN.md | 低 | 内容已过时，与实际架构不符 |
|
||
|
||
---
|
||
|
||
## 六、归档日志
|
||
|
||
> 过时文档统一移入 `archive/`，防止误导。
|
||
|
||
| 日期 | 路径 | 原因 |
|
||
|------|------|------|
|
||
| 2026-05-12 | `tasks/todo.md` → `archive/tasks/todo.md.2026-04-10` | 内容停滞于 2026-04-10，信息过时 |
|
||
| 2026-05-12 | `content/ideas/001-compliance.md` → `archive/content/ideas/` | 001 已发布，合规报告无须保留在活跃目录 |
|
||
| 2026-05-12 | `content/ideas/001-research.md` → `archive/content/ideas/` | 001 已发布，研究笔记无须保留在活跃目录 |
|
||
| 2026-05-12 | `content/publishing/001-images.md` → `archive/content/` | 配图已生成，规划稿无须保留在活跃目录 |
|
||
|
||
---
|
||
|
||
## 七、规范说明
|
||
|
||
### 规划文档
|
||
|
||
| 文档 | 位置 | 说明 |
|
||
|------|------|------|
|
||
| 升级计划 | `docs/upgrade-plan.md` | 分 4 阶段的技术升级路线图 |
|
||
|
||
### 文档管理原则
|
||
|
||
1. **单一真理源**：PROGRESS.md 为唯一进度文档，进度信息不出现于第二个文档中。
|
||
2. **及时归档**：阶段完成后，对应过程文档移入 `archive/`（含日期后缀），避免误导。
|
||
3. **一致性**：README.md 仅引用 PROGRESS.md 摘要，不独立维护进度状态。
|
||
4. **可追溯**：archive 保留完整历史，按 `YYYY-MM-DD` 子目录组织。
|
||
5. **及时更新**：每次新工作结束（或次日开始前）更新 PROGRESS.md，确保最后更新日期与实际同步。
|
||
|
||
### 工作流程
|
||
|
||
```
|
||
梳理需求/任务 → 读取 PROGRESS.md 了解当前状态
|
||
↓
|
||
按 PROGRESS.md 执行开发
|
||
↓
|
||
阶段任务完成 → 更新 PROGRESS.md + 归档冗余文档
|
||
↓
|
||
如需 → 同步 README.md 摘要
|
||
```
|