hookehuyr

docs: 更新项目文档记录最新开发进展

- 新增"最新更新"部分,记录计划书功能优化、样式改进、认证优化
- 更新常见问题快速解决表,新增嵌套弹窗和401重定向问题
- 更新 Composables 表格,新增 useCollectOperation
- 更新页面列表,新增消息、产品中心、周热门资料、分类列表页面
- 更新组件库说明,新增 PlanFields 组件集
- 同步组件自包含原则到最佳实践部分

🤖 Generated with assistance from Claude Code
Showing 1 changed file with 74 additions and 16 deletions
......@@ -28,6 +28,33 @@ pnpm dev:tt # 字节跳动小程序开发
## 📋 快速参考
### 🆕 最新更新(2026-02)
**计划书功能优化**
- ✅ 修复嵌套弹窗层级冲突(使用 provide/inject 模式)
- ✅ 优化页面滚动加载并清理调试代码
- ✅ 修复搜索栏清空按钮点击无效
- ✅ 修改提交结果页按钮为"返回上一页"
**样式改进**
- ✅ 增强资料卡片边框可见性(border-gray-200)
- ✅ 增大产品中心和详情页的字体与图标尺寸
- ✅ 添加全局背景色
- ✅ 增大全局字体和图标尺寸以提升可读性
**认证优化**
- ✅ 修复 401 重定向死循环和返回报错问题
**新增功能**
- ✅ 消息列表和消息详情页
- ✅ 产品中心页
- ✅ 周热门资料页
- ✅ 分类列表页
- ✅ PlanFields 表单字段组件集
- ✅ useCollectOperation composable
---
### ⚡ 常见问题快速解决
| 问题 | 解决方案 | 参考文档 |
......@@ -37,6 +64,8 @@ pnpm dev:tt # 字节跳动小程序开发
| SVG 图标加载失败(500 错误) | 使用 `import` 导入 | [经验教训](docs/lessons-learned.md#静态资源加载问题) |
| 代码重复 3 次 | 抽取为 Composable | [经验教训](docs/lessons-learned.md#组件抽取与复用) |
| 组件对象响应式警告 | 使用 `shallowRef` + `markRaw` | [经验教训](docs/lessons-learned.md#性能优化) |
| 嵌套弹窗层级冲突 | 使用 provide/inject 模式 | 最近提交记录(3357bed) |
| 401 重定向死循环 | 检查重定向拦截器逻辑 | 最近提交记录(6d2a4ec) |
### 🎯 核心架构模式
......@@ -152,6 +181,7 @@ go.back() // 返回上一页
| `useSectionList` | 分组列表管理 | [经验教训](docs/lessons-learned.md#案例-1-usesectionlist-composable) |
| `useFileOperation` | 文件下载、预览、打开 | [经验教训](docs/lessons-learned.md#案例-2-usefileoperation-composable) |
| `useListItemClick` | 统一的列表点击处理 | [经验教训](docs/lessons-learned.md#案例-3-uselistitemclick-composable) |
| `useCollectOperation` | 收藏操作(新增) | 处理收藏/取消收藏逻辑 |
**抽取原则**:"第 3 次出现原则" - 当相同代码模式出现 3 次时,**必须**抽取为 Composable。
......@@ -230,24 +260,34 @@ src/pages/your-page/
**业务页面**
7. `pages/family-office/index` - 家族办公室服务
8. `pages/knowledge-base/index` - 知识库(培训材料、案例)
9. `pages/product-detail/index` - 产品详情页
- 通过 Taro 的 `useLoad` hook 接收 `id` 参数
- 导航示例:`go('/pages/product-detail/index', { id: 1 })`
- 参数可用于从 API 获取产品详情
10. `pages/material-list/index` - 资料/文档列表页
11. `pages/signing/index` - 签约
12. `pages/mine/index` - 用户资料
13. `pages/plan/index` - 业务计划管理
14. `pages/plan-submit-result/index` - 计划提交结果页
8. `pages/product-center/index` - 产品中心页
9. `pages/category-list/index` - 分类列表页
10. `pages/product-detail/index` - 产品详情页
- 通过 Taro 的 `useLoad` hook 接收 `id` 参数
- 导航示例:`go('/pages/product-detail/index', { id: 1 })`
- 参数可用于从 API 获取产品详情
11. `pages/material-list/index` - 资料/文档列表页
12. `pages/week-hot-material/index` - 周热门资料页
- 使用 MaterialCard 组件展示热门资料
- 支持分页加载和触底加载更多
13. `pages/signing/index` - 签约
14. `pages/mine/index` - 用户资料
15. `pages/plan/index` - 业务计划管理
- 使用 PlanSchemes 和 PlanPopup 组件
- 支持嵌套弹窗交互(provide/inject 模式)
- 支持滚动加载和分页
16. `pages/plan-submit-result/index` - 计划提交结果页
- 导航按钮:返回上一页(非首页)
**用户相关页面**
15. `pages/favorites/index` - 用户收藏
16. `pages/avatar/index` - 头像设置
17. `pages/feedback-list/index` - 反馈列表
18. `pages/feedback/index` - 用户反馈
19. `pages/login/index` - 登录页
20. `pages/help-center/index` - 帮助中心和常见问题页
17. `pages/favorites/index` - 用户收藏
18. `pages/avatar/index` - 头像设置
19. `pages/message/index` - 消息列表页
20. `pages/message-detail/index` - 消息详情页
21. `pages/feedback-list/index` - 反馈列表
22. `pages/feedback/index` - 用户反馈
23. `pages/login/index` - 登录页
24. `pages/help-center/index` - 帮助中心和常见问题页
**开发测试页面**(仅开发环境):
- `pages/test-tabs/index` - 标签页测试
......@@ -269,7 +309,15 @@ src/pages/your-page/
- `SectionItem.vue` - 分组列表项组件
- `ListItemActions/` - 列表项操作按钮
- `MaterialCard.vue` - 资料卡片组件(可复用)
- 自包含业务逻辑:查看、收藏
- 支持动态标签、文件大小格式化、学习人数显示
- 支持图片文件预览(使用 Taro.previewImage)
- 使用页面:首页、搜索页、周热门资料页
- 使用 composable:useCollectOperation、useListItemClick
- `ProductCard.vue` - 产品卡片组件(可复用)
- 自定义样式:动态标签、封面图
- 支持产品详情查看和计划书功能
- 使用页面:首页、搜索页、产品中心页
**表单与输入组件**
- `FilterTabs.vue` - 过滤标签组件
......@@ -283,6 +331,16 @@ src/pages/your-page/
**业务组件**
- `PlanSchemes/` - 计划方案组件(SchemeA, SchemeB)
- `PlanPopup/` - 计划弹窗组件
- 使用 provide/inject 模式实现父子弹窗通信
- 子弹窗打开时自动隐藏父级 footer
- 支持 AgePicker、DatePicker、SelectPicker 等字段组件
- `PlanFields/` - 计划书表单字段组件
- `AgePicker.vue` - 年龄选择器
- `AmountInput.vue` - 金额输入框
- `DatePicker.vue` - 日期选择器
- `SelectPicker.vue` - 下拉选择器
- `RadioGroup.vue` - 单选按钮组
- `PlanTemplates/` - 计划模板组件
**工具组件**
- `PosterBuilder/` - 海报生成器
......