Hooke / manulife-weapp

## 主要变更

### 优化
- 移除硬编码的 CATEGORY_IDS 和 loopNav 配置
- 新增 fetchHomeIcons 函数，从 API 动态获取导航数据
- 实现智能参数解析，自动提取 link 字段中的路由和查询参数
- 支持任意数量的查询参数（如 cid, category_id 等）
- API 失败时自动降级到默认配置，保证可用性

### 导航跳转逻辑优化
- 重构 handleGridNav 函数，使用通用的参数提取逻辑
- 自动添加 title 参数到目标页面
- 移除硬编码的路由判断，提升可维护性

### 代码质量提升
- 性能优化：使用 shallowRef 存储导航数据
- 错误处理：完善的 try-catch 和降级方案
- 代码注释：添加完整的 JSDoc 注释

## 影响文件
- src/pages/index/index.vue
- docs/CHANGELOG.md

## 技术细节
- link 字段格式：/pages/category-list/index?cid=3129684
- 自动解析路由和查询参数
- 参数值自动 URL 解码
- 灵活支持后台配置，无需发版

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

## 主要修改

### 1. 修复 OpenAPI 生成器 (scripts/generateApiFromOpenAPI.js)
- 修复 extractAPIInfo is not defined 错误
- 增强 generateReturnJSDoc 函数，支持正确解析数组类型的 data 字段
- 新增对 Array<{...}> 类型的完整字段描述生成

### 2. 优化 API 文档 JSDoc 注释
- news.js: data 字段从 any 改为详细的 Array<{...}> 类型
- home.js: 新增 home 模块 API（首页图标列表）

### 3. 添加无限滚动功能 (src/pages/material-list/index.vue)
- 实现 useReachBottom 触底加载更多
- 添加分页状态管理（currentPage, hasMore, loadingMore）
- 支持各分类独立的分页缓存
- 优化加载状态显示（加载中/没有更多了）
- 添加自定义加载动画

## 技术细节
- 使用防抖（300ms）避免频繁触发加载
- 区分首次加载和加载更多的状态
- 正确处理搜索、子分类、全部列表的分页逻辑
- 保存并恢复各分类的分页状态

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

新增功能：
- 创建本周热门资料详情页面，复用资料列表样式
- 学习人数和热度标签统一显示样式
- 添加文件大小显示

样式优化：
- 统一 tag 样式（padding、圆角、字体大小）
- 加强卡片阴影效果（shadow-sm → shadow-md）
- 添加多行文本省略样式支持（index、week-hot-material、knowledge-base）

Bug 修复：
- 修复收藏状态判断逻辑，支持布尔值 true
- 移除学习人数标签中的火焰图标（避免重复）

页面路由：
- 注册 week-hot-material 页面路由
- 首页"查看更多"链接指向新页面

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Document the extraction of duplicate collection logic into a reusable composable.

- Created useCollectOperation composable with optimistic UI updates
- Refactored index and material-list pages (removed 89 lines of duplicate code)
- Fixed runtime module resolution issue
- Net reduction: 82 lines of code

Extracted 89 lines of duplicate collection/favorite operation code from index and material-list pages into a reusable composable.

Changes:
- Created src/composables/useCollectOperation.js with unified collection logic
- Refactored src/pages/index/index.vue to use the composable (-44 lines)
- Refactored src/pages/material-list/index.vue to use the composable (-45 lines)
- Fixed runtime import issue by using relative path in composable

Features:
- Optimistic UI updates with automatic rollback on error
- Consistent error handling and user feedback
- JSDoc documentation with usage examples
- Supports both meta_id and id fields

Impact:
- Net reduction: 82 lines of code eliminated
- Improved maintainability and DRY compliance
- Enhanced code reusability across pages

Co-Authored-By: Claude Code <noreply@anthropic.com>

- 新增分类列表页,支持二级分类展示和跳转
- 资料列表页实现动态 Tab 切换和搜索功能
- 首页接入热门产品和热门资料 API
- 收藏页接入列表和删除 API
- fileListAPI 新增 child_id 和 keyword 参数
- 修复 fn.js 类型检查逻辑 (String → number)

影响文件:
- src/pages/category-list/ (新建)
- src/pages/material-list/index.vue
- src/pages/index/index.vue
- src/pages/favorites/index.vue
- src/api/file.js
- src/api/fn.js
- src/app.config.js

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

新增功能：
- 创建通用埋点 Composable (useEventTracking)
  - 支持 READ_FILE 等事件类型追踪
  - 静默处理错误，不影响用户体验
  - 提供便捷方法 trackFileRead()

- ListItemActions 组件集成埋点
  - 新增 itemId prop，自动发送埋点数据
  - 向后兼容，不破坏现有代码

- 图片预览支持
  - useFileOperation 添加 isImageFile() 判断
  - 图片文件使用 Taro.previewImage 直接预览
  - 支持 jpg, jpeg, png, gif, webp, bmp, svg 格式

- 产品详情页文件预览
  - 集成 useFileOperation
  - 自动判断文件类型并选择最优预览方式

文档：
- 更新 CHANGELOG 记录变更
- 新增埋点功能使用指南

技术栈：Vue 3, Taro 4, Composition API

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 接入收藏列表API (listAPI) 和取消收藏API (delAPI)
- 移除分类Tabs逻辑，简化为统一列表展示
- 添加自定义loading spinner，替代NutUI组件
- 完善错误处理和用户提示
- 更新API联调日志和CHANGELOG

注意：实际联调需等有数据后验证

🤖 Generated with Claude Code
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 添加 2026-02-05 条目，记录文档整理变更
- 说明删除重复文件、文档归类优化的具体内容
- 记录整理收益和影响范围

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

删除重复文件：
- DOCS_STRUCTURE.md（与 README.md 内容重复）

文档归类优化：
- auth-debug-guide.md → guides/auth-debug-guide.md（认证调试指南）
- TARO_QUICK_REFERENCE.md → guides/TARO_QUICK_REFERENCE.md（Taro 速查表）
- api-integration-log-template.md → api-specs/api-integration-log-template.md（API 联调模板）

更新文档：
- README.md：更新目录结构说明，添加新归类文档的导航

收益：
- 文档结构更清晰，按功能分类组织
- 减少顶层文件数量，保留核心文档
- 便于开发者快速查找所需文档

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 创建 docs/reports/ 目录用于存放审核和分析报告
- 按日期组织子目录结构: YYYY-MM-DD
- 移动已有的两个文档到 reports/2026-02-05/
- 更新 CHANGELOG 中的文档路径引用

- 删除未定义的 store.changeUserInfo(null) 调用
- userStore.logout() 已经清除了所有用户信息
- mainStore 在项目中未被使用
- 修复 ESLint 错误: 'store' is not defined

相关文档: docs/code-review-2026-02-05.md

- 安装 husky 和 lint-staged 依赖
- 创建 pre-commit hook（代码检查、改动规模评估、CHANGELOG 检查）
- 创建 commit-msg hook（提交信息格式验证）
- 创建 pre-push hook（推送前检查）
- 创建 post-commit hook（提交成功反馈）
- 修复 src/pages/mine/index.vue 中的 ESLint 错误（删除未定义的 store 引用）

相关文档：
- docs/code-review-2026-02-05.md（代码审核报告）
- docs/userinfo-storage-logic-analysis.md（用户信息存储逻辑分析）

- 更新 API 接口联调日志
  - 文档模块接口状态从"初稿"更新为"待联调"
  - weekHotAPI（本周热门资料）：字段已确认
  - fileListAPI（文档列表）：字段已确认，修正接口路径为 `/srv/?a=file&t=file_list`
  - 更新总体进度：26个接口（12个已完成，11个待联调，3个已废弃）
- 更新 CHANGELOG 记录本次文档更新
- 更新接口文档版本至 v2.4

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

新增功能：
- 添加 SearchBar 搜索组件
- 实现实时搜索功能（带 500ms 防抖优化）
- 支持按回车键立即搜索
- 支持一键清空搜索内容
- 搜索与分类筛选联动（可组合使用）

优化体验：
- 输入时实时搜索（防抖延迟 500ms）
- 按回车键立即搜索（取消防抖定时器）
- 清空搜索时恢复当前分类的所有产品
- 切换分类时保持搜索状态

技术实现：
- API 接口：使用 listAPI 的 keyword 参数
- 防抖逻辑：使用 setTimeout 实现搜索防抖
- 状态管理：新增 searchValue 搜索状态
- 样式布局：参考 plan 页面的搜索栏布局

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 将状态判断从严格相等(===)改为宽松相等(==)
- 提高对数字/字符串类型混用的兼容性

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

将“Manulife 臻奇智荟圈”更新为“Manulife 臻奇荟”，以匹配最新的品牌命名规范。

- 将 .claude/ 目录添加到 .gitignore 以避免提交 IDE 配置文件
- 更新首页显示的应用名称为“臻奇荟”
- 在 Claude IDE 配置中移除不再使用的 Apifox 相关脚本
- 修正 PlanPopup 组件的类型声明文件路径

- 删除 7 个不再工作的 Apifox API 相关脚本
- 删除 .env.apifox 配置文件
- 简化 package.json 命令（移除 api:sync 和 api:test）
- 修复 API 生成工具：新增模块接口信息显示为 undefined
- 新增文档模块接口（初稿）：weekHotAPI、fileListAPI
- 创建 API_GUIDE.md 使用指南
- 更新 API 联调日志（v2.3）和 CHANGELOG

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 优化 API 文档生成脚本
  - 添加 CLAUDE.md 文件过滤，避免将文档文件当作 API 文档处理
  - 改进新增模块检测逻辑，显示新增模块包含的所有接口
  - 优化变更检测报告，提升可读性

- 更新 API 接口联调日志
  - 收藏模块：3个接口后端已完成，标记为待联调
  - 埋点模块：1个接口后端已完成，标记为待联调
  - 更新总体进度：24个接口（12已完成，9待联调，3已废弃）

- 新增埋点模块
  - 添加埋点接口（addAPI）
  - 生成 API 文档和接口代码

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 移除视频中央的播放/暂停按钮，避免遮挡画面
- 将播放控制集成到底部进度条区域（play-btn-position='bottom'）
- 优化播放结束提示为弱提示（移除图标，缩短显示时间）

优化用户观看体验，提供更沉浸式的视频播放效果。

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

新增功能：
- 添加视频文件类型判断（MP4、M4V、MOV）
- 创建视频播放页面，支持全屏播放、进度控制等功能
- 文件操作支持视频，点击查看自动跳转播放页面

优化体验：
- 移除页面初始加载状态，直接展示视频播放器
- 移除加载状态遮罩层，使用播放器自带指示器
- 修复页面高度问题，使用 flex 布局
- 更新测试视频 URL 为 CDN 地址

文档更新：
- 更新 CHANGELOG 记录所有变更

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

更新CHANGELOG.md，记录将"工具箱"模块更名为"客户服务"的变更。此修改已在首页网格导航和设计文档中同步实施，仅涉及显示名称优化，不涉及功能变更。

修复注销按钮与上方内容间距过大的问题，提升界面布局的紧凑性

- 修正头像字段路径：avatar_url → avatar?.src
- 使用强制刷新 fetchUserInfo(true) 跳过防抖
- 确保从头像设置页面返回时能立即看到最新头像

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

性能优化：
- User Store 添加防抖机制（5秒内不重复请求）
- 修复 useShow 为 useDidShow（使用正确的 Taro 生命周期）
- "我的"页面统一使用 userStore.fetchUserInfo()
- 移除本地 userInfo ref 和 fetchUserProfile 函数
- 移除对 mainStore 和 getProfileAPI 的直接依赖

配置优化：
- 添加 @/config 路径别名到 config/index.js

效果：
- 从首页跳转到"我的"页面时，请求次数从 2 次减少到 1 次
- 页面间快速切换不会触发重复请求
- 统一状态管理，代码更简洁

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 添加功能开关配置系统（src/config/features.js）
  - 支持全局开关控制功能启用/禁用
  - 可配置红点字段名称和显示阈值
  - 方便灰度发布和功能回滚

- TabBar 组件自动从 Store 读取红点状态
  - 移除手动传递 badges prop
  - 组件内部自动管理红点显示逻辑
  - 只处理"我的"按钮的红点

- User Store 新增红点状态自动计算
  - 新增 tabBarBadges 计算属性
  - 根据用户信息自动计算红点状态
  - 支持数字和布尔类型字段
  - 响应式更新，无需手动管理

- 首页添加用户信息自动刷新
  - useShow 生命周期自动刷新
  - 只在已登录状态下请求
  - 添加错误处理

- 创建完整的使用文档（docs/features/tabbar-badge.md）
  - 功能说明和启用方法
  - 数据流程图和测试方法
  - 常见问题解答

功能默认关闭（features.tabbarBadge = false）
当前使用 unread_count 字段（待确认）

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

优化内容：
- 清空时重置到初始状态，不再显示"暂无搜索结果"
- 添加分类相关的动态引导文案（全部/产品/资料）
- 实时搜索监听器优化：清空关键词时也重置状态

影响文件：
- src/pages/search/index.vue
- docs/CHANGELOG.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

替换多个页面的自定义空状态为 NutUI 的 Empty 组件，提升 UI 一致性和用户体验。涉及页面包括：搜索页、知识库页、资料列表页、计划书页、收藏页和意见反馈页。

添加消息列表页和消息详情页，支持查看系统消息详情
在个人中心菜单中增加消息入口，并更新组件类型声明

- 更新项目文档结构与实际保持一致
- 新增文档索引和组件/工具函数文档
- 更正身份认证流程说明

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

主要更新：
- 新增接口联调日志和变更日志的文档索引
- 更正身份认证流程说明（openid.js 替代不存在的 authRedirect.js）
- 删除不存在的 auth/index 页面
- 新增 3 个页面：plan-submit-result、feedback-list、test-tabs
- 新增 11 个组件：DocumentPreview、PdfPreview、OfficeViewer 等
- 新增 3 个工具函数：documentIcons.js、tools.js、openid.js
- 更新关键文件总结和会话管理说明

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 在文件大小前面显示文件类型（如：PDF · 2.5MB）
- 使用 getDocumentLabel 工具函数自动识别文件类型
- 支持常见文件格式：PDF、Word、Excel、PPT、图片、视频等

- 在相关附件标题下方添加灰色提示文字
- 提示用户无法下载时可通过预览页转发到其他设备
- 优化附件下载的用户体验

- 将相机图标背景从 p-[16rpx] 改为固定 w-[96rpx] h-[96rpx]
- 添加 flex 布局确保图标居中
- 确保 rounded-full 始终形成正圆

- 产品列表接口（listAPI）联调成功
  - 知识库页面：动态标签栏、分类筛选、滚动加载功能正常
  - 首页热卖产品：产品列表正常显示
- 更新总体进度：20个接口（12个已完成，0个联调中，3个已废弃，5个后端开发中）
- 文档版本升级至 v2.1

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

将 scroll-view 上的内边距移至内部产品列表容器，确保全宽状态提示条相对于屏幕水平居中，同时保持产品网格布局不变。

- 修复空状态文字水平居中问题
  - 为 text 元素添加 w-full text-center 类
  - 确保 Taro 小程序环境下正确居中显示

- 更新 CHANGELOG 和 API 集成日志
  - 新增产品模块记录（产品列表接口 listAPI）
  - 记录知识库页面 API 集成完成情况
  - 更新接口总数：20 个（11 个已完成，1 个联调中，3 个已废弃，5 个后端开发中）
  - 文档版本升级至 v2.0

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

### 主要改动

1. **集成产品列表 API**（listAPI）
   - 从接口获取产品数据和分类列表
   - 使用 `data.categories` 作为标签栏数据（动态生成）
   - 产品卡片数据严格按照接口文档映射
   - 移除所有硬编码的模拟数据

2. **实现分类筛选功能**
   - 点击标签时传递 `cid` 参数到接口
   - 每次切换分类时重置分页状态（page=0, products=[]）
   - 支持查看"全部"或特定分类的产品

3. **实现滚动加载功能**
   - 使用 `scroll-view` 的 `@scrolltolower` 事件
   - 滚动到底部时自动加载下一页
   - 加载更多时追加数据（不替换）
   - 根据总数判断是否还有更多数据

4. **数据映射（严格遵循接口文档）**
   - `item.id` → 产品 ID
   - `item.product_name` → 产品名称
   - `item.cover_image` → 产品封面图
   - `item.recommend` → 推价位（hot/normal）
   - `item.tags` → 动态标签（含 bg_color、text_color）
   - `categories` → 分类列表（用于标签栏）
   - `total` → 产品总数

### 状态管理

- `loading`: 加载状态（显示加载提示）
- `hasMore`: 是否还有更多数据
- `page`: 当前页码（从 0 开始）
- `limit`: 每页数量（10）
- `categories`: 分类列表（从接口获取）
- `products`: 当前产品列表
- `total`: 产品总数

### 移除的硬编码

- 移除硬编码的 `tabsData`（人寿保险、医疗保险、意外保险）
- 移除模拟产品数据生成函数
- 移除 `descColorPalette` 和 `getDescColor` 函数
- 移除 `currentTabName` 和 `filteredProducts` 计算属性

### 用户体验优化

- 首次加载显示"加载中..."提示
- 滚动到底部时显示"加载中..."
- 没有更多数据时显示"没有更多了"
- 无数据时显示"暂无相关产品"

### 影响文件

- src/pages/knowledge-base/index.vue（完整重构）

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

### 新增内容

1. **新增收藏 API 定义文件**
   - src/api/favorite.js: 收藏相关 API 封装
     - addAPI: 添加收藏
     - delAPI: 取消收藏
     - listAPI: 收藏列表

2. **新增收藏模块 API 规范文档**
   - docs/api-specs/favorite/add.md: 添加收藏接口文档
   - docs/api-specs/favorite/del.md: 取消收藏接口文档
   - docs/api-specs/favorite/list.md: 收藏列表接口文档

3. **更新 API 集成日志**
   - 新增收藏模块章节（3 个接口）
   - 更新总体进度：16 → 19 个接口
   - 更新后端开发中接口数：2 → 5 个
   - 更新快速索引（添加收藏模块）
   - 更新文档版本：v1.8 → v1.9

### 接口状态

所有收藏接口均为 **⏳ 后端开发中**：
- addAPI（添加收藏）
- delAPI（取消收藏）
- listAPI（收藏列表）

### 影响文件

- src/api/favorite.js（新增）
- docs/api-specs/favorite/add.md（新增）
- docs/api-specs/favorite/del.md（新增）
- docs/api-specs/favorite/list.md（新增）
- docs/api-integration-log.md（更新）
- src/api/user.js（linter 自动格式化）

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>