docs: v23 PROGRESS.md + archive WORKSPACE_REDESIGN.md
This commit is contained in:
+77
-2
@@ -3,7 +3,7 @@
|
|||||||
> 本文件为项目进度唯一真理源,所有进度信息以此为准。
|
> 本文件为项目进度唯一真理源,所有进度信息以此为准。
|
||||||
> 其他文档中的进度描述一律以本文为准。
|
> 其他文档中的进度描述一律以本文为准。
|
||||||
|
|
||||||
**最后更新**:2026-06-16 (v22)
|
**最后更新**:2026-06-17 (v23)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -383,7 +383,82 @@ admin.html 新增「GEO 就绪度」标签页包含:
|
|||||||
- 登录流程验证:登录后跳转 `/index.html`
|
- 登录流程验证:登录后跳转 `/index.html`
|
||||||
- 服务已重启生效
|
- 服务已重启生效
|
||||||
|
|
||||||
## 十一、规范说明
|
## 十一、工作台改造与数据隔离(v23 · 2026-06-17)
|
||||||
|
|
||||||
|
### 从「管理工具」到「内容工作台」
|
||||||
|
|
||||||
|
**背景**:此前平台虽功能完整但偏向管理后台视角,缺乏面向内容创作者的工作台体验;且所有业务数据缺乏组织隔离(org_id),多组织共存时数据混淆。
|
||||||
|
|
||||||
|
### Wave 1 — 数据隔离基础设施
|
||||||
|
|
||||||
|
| 改动 | 文件 |
|
||||||
|
|------|------|
|
||||||
|
| 10 个业务模型追加 `org_id` 列 | `models.py`(User/Topic/ContentCalendar/MediaAsset/ContentTask/Article/PublishRecord/ContentMetrics/SearchRanking/GeoReadinessScore) |
|
||||||
|
| ALTER TABLE 迁移语句 | `database.py`(5 条 `ADD COLUMN IF NOT EXISTS`) |
|
||||||
|
| Schema 追加 `org_id` | `schemas.py`(ArticleBase/ContentCalendarResponse/ContentMetricsResponse/MediaAssetResponse/ContentTaskResponse/PublishRecordResponse) |
|
||||||
|
| JWT 认证追加 org_filter | `auth.py` — `get_current_admin` 返回 `org_id`,新增 `require_role(required_role)` 工厂函数 |
|
||||||
|
| 导航重构为流程导向 5 项 | `uni-nav.js` — 工作台/内容工厂/数据洞察/资产库/系统管理 |
|
||||||
|
|
||||||
|
### Wave 2 — API 隔离 + 新前端页面
|
||||||
|
|
||||||
|
| 改动 | 说明 |
|
||||||
|
|------|------|
|
||||||
|
| `articles.py` | Article 创建 upsert 时从 JWT 自动注入 org_id |
|
||||||
|
| `publishing.py` | PublishRecord 创建时从关联 Topic 继承 org_id |
|
||||||
|
| `metrics.py` | ContentMetrics 创建时继承 Topic.org_id |
|
||||||
|
| `calendar.py` | ContentCalendar CRUD 添加 org_id 校验 |
|
||||||
|
| `tasks.py` | ContentTask 创建时自动注入 org_id |
|
||||||
|
| `search_rankings.py` | GEO 端点添加 org_filter |
|
||||||
|
| `factory.html` | **新建** — 内容工厂流水线页面(3Tab:待创作/进行中/待审查) |
|
||||||
|
| `insights.html` | **新建** — 数据洞察页面(4Tab:内容概览/搜索排名/GEO就绪度/平台对比) |
|
||||||
|
|
||||||
|
### Wave 3 — 仪表盘重设计 + RBAC
|
||||||
|
|
||||||
|
| 改动 | 说明 |
|
||||||
|
|------|------|
|
||||||
|
| `index.html` | 从系统监控仪表盘改为用户中心工作台(欢迎横幅/摘要卡片/今日待办/AI智能建议/管理员模块折叠隐藏) |
|
||||||
|
| `ai-assistant.js` | 新增 factory/insights 页面映射 + 问候语;API 调用带入 org_id |
|
||||||
|
| `require_role` 导入 | 10 个 admin 路由文件(admin/menu_configs/role_configs/system_configs/llm_configs/collector_mgmt/prompt_configs/task_configs/search_providers/config_items)追加 import |
|
||||||
|
|
||||||
|
### Wave 4 — 验证
|
||||||
|
|
||||||
|
- **集成测试**:33/33 通过(Python 编译检查/服务启动/登录/CRUD/权限验证)
|
||||||
|
- **手动 QA**:
|
||||||
|
- `/` → 200(landing.html)
|
||||||
|
- `/index.html` → 200(工作台仪表盘)
|
||||||
|
- `/factory.html` → 200(内容工厂)
|
||||||
|
- `/insights.html` → 200(数据洞察)
|
||||||
|
- 登录正常,auth me 返回 `admin/admin/default`
|
||||||
|
- 未认证访问 401,认证后正常访问
|
||||||
|
- 系统状态 API 正常(41 topics, 22 pending, 2 published)
|
||||||
|
- **Git 提交**:4 个 commit 分 Wave 提交(dcfeccc / 5caf7bc / f6e5e90)
|
||||||
|
|
||||||
|
### 关键架构决策
|
||||||
|
|
||||||
|
- org_id 从 JWT 自动注入,不在客户端提交(防篡改)
|
||||||
|
- 工厂页和数据洞察页新建文件,不改造现有页面
|
||||||
|
- RBAC 使用 `require_role()` 工厂模式,逐步替换 `get_current_admin`
|
||||||
|
- 平台配置(platform_config)为全局共享,不按组织隔离
|
||||||
|
- 数据隔离为 P1 级安全修复,优先于所有其他改造
|
||||||
|
|
||||||
|
### 关键文件变更
|
||||||
|
|
||||||
|
| 文件 | 改动 |
|
||||||
|
|------|------|
|
||||||
|
| `platform/backend/app/models.py` | 10 个模型追加 org_id(941 行)|
|
||||||
|
| `platform/backend/app/database.py` | ALTER TABLE 迁移逻辑(170 行)|
|
||||||
|
| `platform/backend/app/api/auth.py` | org_filter + require_role(196 行)|
|
||||||
|
| `platform/backend/app/schemas.py` | 6 个响应 schema 追加 org_id(637 行)|
|
||||||
|
| `platform/frontend/index.html` | 用户中心仪表盘重设计 |
|
||||||
|
| `platform/frontend/factory.html` | **新建** 内容工厂流水线页 |
|
||||||
|
| `platform/frontend/insights.html` | **新建** 数据洞察页(945 行)|
|
||||||
|
| `platform/frontend/uni-nav.js` | 流程导向导航(333 行)|
|
||||||
|
| `platform/frontend/ai-assistant.js` | 页面映射 + org_id 感知 |
|
||||||
|
| `platform/backend/app/api/*.py` | 10 个路由文件追加 require_role |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 十二、规范说明
|
||||||
|
|
||||||
### 规划文档
|
### 规划文档
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user