Browse Source

docs: add article system redesign design document

Records the design decisions, file changes, navigation flow, and known issues for the article-center (知识中心) unification project.

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
User 4 tháng trước cách đây
mục cha
commit
92ae1fef82
1 tập tin đã thay đổi với 202 bổ sung và 0 xóa
  1. 202 0
      cfc-backend/docs/article-system-redesign.md

+ 202 - 0
cfc-backend/docs/article-system-redesign.md

@@ -0,0 +1,202 @@
+# 小程序知识中心(文章系统)重构设计文档
+
+> 创建日期:2026-07-08
+> 状态:已实现
+
+---
+
+## 一、现状分析
+
+### 1.1 涉及页面一览
+
+| 页面 | 路径 | 当前状态 |
+|------|------|---------|
+| 行主页 | `pages/action/index.vue` | ✅ 已有 DimensionArticles(无需修改) |
+| 身主页 | `pages/body/index.vue` | ✅ 已有 DimensionArticles |
+| 智主页 | `pages/wisdom/index.vue` | ✅ 已有 DimensionArticles |
+| 心主页 | `pages/mind/index.vue` | ✅ 已有 DimensionArticles |
+| 富主页 | `pages/wealth/index.vue` | ❌ 无文章入口(无需删除) |
+| ProfileMenu | `pages/profile/components/ProfileMenu.vue` | 有"成长文章"入口 → 已删除 |
+| 知识中心(改版后) | `pages/article-center/index.vue` | ✅ 作为统一入口 |
+| 文章详情 | `pages/article-center/article-detail.vue` | AI quiz版,article-center列表专用 |
+| 写成长记录 | `pages/article-center/article-edit.vue` | 已有完整表单 |
+| 我的发布 | `pages/article-center/my-posts.vue` | 已有 |
+| 旧心智成长列表 | `pages/mind/articles.vue` | 已清理"推荐阅读",保留基础功能 |
+| 旧心智成长详情 | `pages/mind/article-detail.vue` | 保留,mind/articles列表专用 |
+
+### 1.2 "更多"按钮原导航目标
+
+| 维度页 | 原"更多"目标 | 新"更多"目标 |
+|--------|------------|------------|
+| 心(mind/index) | `/pages/mind/articles` | `/pages/article-center/index?dimension=mind` |
+| 身(body/index) | `/pages/mind-detail/articles` | `/pages/article-center/index?dimension=body` |
+| 智(wisdom/index) | `/pages/mind/articles` | `/pages/article-center/index?dimension=wisdom` |
+| 行(action/index) | `/pages/mind-detail/articles` | `/pages/article-center/index?dimension=action` |
+
+### 1.3 发现的问题
+
+- 行页面**无需添加** DimensionArticles — 已有 ✅
+- 富页面(wealth/index)无"成长文章"入口,无需删除
+- ProfileMenu 的"成长文章"入口已删除
+- mind/articles 有自引用的"🔥 推荐阅读"区块(同一页面自己的文章),已删除
+- mind/articles 的导航标题原为"心智成长",已改为"知识中心"
+
+---
+
+## 二、设计决策
+
+### 2.1 统一知识中心
+
+**决策:所有"更多"统一跳转到 `/pages/article-center/index`(知识中心),并通过 `?dimension=X` 参数默认选中对应维度 tab。**
+
+优点:
+- 单一入口,避免用户迷失在多个文章列表之间
+- article-center/index 已有完整的 tab 维度筛选
+- 统一的内容创作入口(+ 按钮)
+- 统一的知识搜索能力
+
+### 2.2 + 按钮位置
+
+**决策:知识中心页(article-center/index)使用自定义导航栏,+ 按钮放在导航栏右侧。**
+
+实现方式:
+- `navigationStyle: custom` 替换原生导航栏
+- 自定义导航栏包含:←返回 | 搜索框 | +按钮
+- 搜索框点击展开,支持关键词搜索
+
+### 2.3 知识中心导航参数
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `dimension` | 默认选中的维度 tab code | `?dimension=mind` |
+
+示例URL:
+- 心维度进入:`/pages/article-center/index?dimension=mind` → 默认选中"心"tab
+- 身维度进入:`/pages/article-center/index?dimension=body` → 默认选中"身"tab
+- 无参数:默认显示"全部"
+
+**注意**:维度代码遵循项目约定 — `mind`="心"(#FF6B9D), `wisdom`="智"(#6366F1)
+
+### 2.4 创作流程
+
+用户点击导航栏 + 按钮:
+1. 未登录 → 跳转登录页,登录后 redirect 回 `/pages/article-center/index`
+2. 已登录 → 跳转 `/pages/article-center/article-edit`(写成长记录页面)
+
+---
+
+## 三、文件修改清单
+
+### 3.1 新增/改动的文件
+
+| 文件 | 改动类型 | 说明 |
+|------|---------|------|
+| `pages.json:816-819` | 修改 | article-center/index 加 `navigationStyle: custom`,标题改为"知识中心" |
+| `pages/article-center/index.vue` | 重构 | 新增自定义导航栏(含搜索框、+按钮)、支持 `?dimension` URL参数、登录检查 |
+| `pages/article-center/index.vue` | 修复 | 修正 tabList 维度映射:`mind`→"心"、`wisdom`→"智"(与项目约定对齐) |
+| `pages/mind/articles.vue` | 重构 | 新增导航栏搜索框(与 article-center 一致)、`goDetail` 改为 `/pages/article-center/article-detail` |
+| `pages/mind/index.vue:730-731` | 修改 | `goArticles` 导航目标改为 `/pages/article-center/index?dimension=mind` |
+| `pages/body/index.vue:523-524` | 修改 | `goMoreArticles` 导航目标改为 `/pages/article-center/index?dimension=body` |
+| `pages/wisdom/index.vue:481-482` | 修改 | `goMoreArticles` 导航目标改为 `/pages/article-center/index?dimension=wisdom` |
+| `pages/action/index.vue:464-465` | 修改 | `goMoreArticles` 导航目标改为 `/pages/article-center/index?dimension=action` |
+| `pages/profile/components/ProfileMenu.vue:11-14` | 删除 | 删除"成长文章"菜单项及 `goToArticleCenter` 方法 |
+
+### 3.2 无需改动的文件(已确认)
+
+| 文件 | 原因 |
+|------|------|
+| `pages/wealth/index.vue` | 无"成长文章"入口,无需删除 |
+| `pages/action/index.vue` | 已有 DimensionArticles,无需添加 |
+| `components/DimensionArticles.vue` | 无需修改,DimensionArticles 组件工作正常 |
+| `pages/article-center/article-edit.vue` | 已是完整的文章创建表单,无需修改 |
+| `pages/article-center/my-posts.vue` | 已是用户文章管理页,无需修改 |
+
+---
+
+## 四、知识中心页面结构(article-center/index.vue)
+
+```
+┌─────────────────────────────────┐
+│  ←  [ 🔍 搜索文章...      ]  +  │  ← 自定义导航栏(橙色渐变背景)
+├─────────────────────────────────┤
+│ [全部] [身] [智] [心] [行] [富]  │  ← Tab维度筛选(sticky)
+├─────────────────────────────────┤
+│ ┌─────────────────────────────┐ │
+│ │ 封面图                       │ │
+│ │ 分类标签         3分钟       │ │
+│ │ 文章标题                     │ │
+│ │ 摘要内容...                  │ │
+│ │ 作者    日期    收藏数        │ │
+│ │ ●●●(五维彩点)              │ │
+│ └─────────────────────────────┘ │
+│         ...更多文章...           │
+│                          [+FAB] │  ← 右下角橙色FAB(已存在)
+└─────────────────────────────────┘
+```
+
+---
+
+## 五、导航流程图
+
+```
+心/身/智/行 Tab页
+    │
+    ├──[推荐阅读·点击文章卡片]──→ /pages/mind-detail/article-detail?id=X
+    │
+    └──[更多›]──→ /pages/article-center/index?dimension=X
+           或 /pages/mind/articles?dimension=X
+                        │
+                        ├──[Tab筛选]──→ 按维度过滤文章
+                        ├──[搜索]──→ 按关键词搜索
+                        ├──[+按钮]──→ /pages/article-center/article-edit
+                        └──[文章卡片]──→ /pages/article-center/article-detail?id=X (统一详情页)
+```
+
+---
+
+## 六、仍需关注的问题
+
+### 6.1 五维标签显示 undefined
+
+**现象**:文章卡片的五维标签(彩色圆点)可能显示 undefined。
+
+**可能原因**:`relatedDimensions` 字段中的维度代码在 `dimMap` 中找不到匹配项(如数据库存了 `Body` 而代码期望 `body`)。
+
+**建议处理**:
+- 检查 `article.relatedDimensions` 的实际数据格式
+- 在 `parseDimensions` 函数中增强对异常值的处理
+- 上线后如有 undefined 现象,在控制台打印 `relatedDimensions` 实际值
+
+### 6.2 mind/articles 与 article-center/index 并存
+
+mind/articles 仍作为独立页面存在(可被直接访问)。当前已清理了自引用的"推荐阅读"区块,保留了基础的维度筛选、文章列表和 + 按钮。
+
+建议后续:如有需要,可将此页面重定向到 article-center/index,或将其作为备用入口保留。
+
+### 6.3 维度名称对齐(已修复)
+
+`article-center/index.vue` 的 `tabList` 和 `parseDimensions` 中 `mind`/`wisdom` 映射曾与项目约定矛盾:
+- 旧:`mind`→"智"(#6366F1), `wisdom`→"心"(#FF6B9D)
+- 新:`mind`→"心"(#FF6B9D), `wisdom`→"智"(#6366F1)
+- 对齐了 README 五维全景:`pages/mind/index`="心"(心理/情感), `pages/wisdom/index`="智"(心智测评)
+
+`mind/articles.vue` 的 `dimensionConfig` 一直正确,无需修改。
+
+---
+
+## 七、测试验证清单
+
+- [ ] 从心/身/智/行 Tab 点击"更多 ›" → 应进入知识中心,默认选中对应维度
+- [ ] 知识中心导航栏 + 按钮 → 未登录跳转登录页,已登录跳转写文章页
+- [ ] 知识中心搜索框 → 输入关键词后回车,应过滤文章列表
+- [ ] 知识中心 Tab 切换 → 应重新加载对应维度文章,不带搜索关键词
+- [ ] ProfileMenu → "成长文章"入口已删除(不再显示)
+- [ ] article-center Tab 名称正确:`mind`="心"、`wisdom`="智"
+- [ ] article-center 文章卡片五维圆点颜色正确(心=粉、智=紫)
+- [ ] mind/articles → 导航栏有搜索框,搜索可过滤文章
+- [ ] mind/articles → 点击文章卡片进入 `/pages/article-center/article-detail`(统一详情页)
+- [ ] 编译无新增错误
+
+---
+
+*本文档为知识中心重构的操作记录和设计依据。*