Hooke / manulife-weapp

- 添加 Word (docx) 测试文件 URL
- 添加 PowerPoint (pptx) 测试文件 URL
- 添加 Excel (xlsx) 测试文件 URL
- 保留原有的 PDF、图片和文本文件 URL
- 所有测试 URL 均来自可靠的公开资源

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

- 优化 getDocumentIcon 支持多种扩展名来源
- 增强 extractExtensionFromFile 支持更多解析路径
- 改进 JSDoc 文档

Co-Authored-By: Claude Sonnet 4.5

- 添加真实的可预览测试文件地址（PDF、图片、文本）
- 优化所有数据生成函数使用 getTestFileUrl

Co-Authored-By: Claude Sonnet 4.5

移除重复的图片预览判断逻辑，统一使用 useFileOperation

- 新增 extractExtensionFromFile() 统一函数
- 优先使用 extension 字段
- 更新 documentIcons.js/tools.js/useFileOperation.js 使用统一函数
- 更新 API 类型定义和组件

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

- 新增 headerImageError 状态管理
- 实现 handleHeaderImageError 错误处理函数
- 图片加载失败时显示蓝色渐变背景降级UI
- 优化用户体验，避免图片加载失败影响页面展示

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

- 优化页面背景色为淡灰色
- 添加头像展示卡片和圆环边框
- 改进编辑图标为右下角悬浮样式
- 统一底部按钮风格

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

- 新增 mockPlanListAPI 函数支持分页、状态筛选、关键词搜索
- 集成 Mock 数据开关，开发环境自动启用
- 支持测试分页加载、状态筛选、关键词搜索、查看功能
- 数据结构完全符合 API 文档规范

- 删除后保持在当前页，不再跳回第1页
- 本地立即移除删除的项（用户马上看到效果）
- 如果当前页被删空，自动回到上一页
- 静默刷新当前页数据（后台同步，用户无感知）

影响文件:
- src/pages/plan/index.vue

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

- 记录新增的计划书 CRUD 接口
- 记录 API 规范文档的格式修复

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

- 修复 list.md 的 OpenAPI 文档格式问题（重复内容、YAML 结构错误）
- 新增 delete.md 和 view.md API 规范文档
- 重新生成 plan.js，补充完整的 4 个接口（add, delete, view, list）
- 为 deleteAPI 和 viewAPI 添加参数说明（params.i）
- 为 listAPI 添加详细的参数说明（status, keyword, limit, page）
- 优化 JSDoc 类型注释（integer → number）
- 添加完整的返回值类型定义

影响文件:
- docs/api-specs/plan/list.md (格式修复)
- docs/api-specs/plan/delete.md (新增)
- docs/api-specs/plan/view.md (新增)
- src/api/plan.js (接口补充)

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

- lessons-learned.md: 新增"状态标记组件模式"案例
- README.md: 添加最新更新章节（计划书状态标记、UI优化）
- CLAUDE.md: 更新最新功能和常见问题表格

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

- 在卡片右上角显示计划书状态（生成中/已完成）
- 生成中状态：黄色背景 + 橙色文字
- 已完成状态：绿色背景 + 深绿色文字
- 使用圆角徽章样式，与整体设计一致

影响文件: src/pages/plan/index.vue

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

- ProductCard 组件：降低对比度，更加柔和
  - 边框颜色调整为 border-gray-200，增强可见性
  - 阴影优化：更细腻的阴影参数
  - 装饰背景从蓝色改为中性灰色光晕
  - 按钮样式调整为浅色背景（浅蓝 + 浅灰）
- 首页"查看更多"按钮：移除背景色，改为透明样式
- 金额输入弹窗：调整弹窗位置为 top: 40%，更符合视觉中心

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

- NavHeader 组件增强：支持自定义背景、文字颜色和覆盖模式
- 我的页面全面升级：
  - 新增渐变背景头部（深蓝到科技蓝）
  - 用户卡片优化：头像编辑徽章、精致阴影、装饰圆圈
  - 菜单图标彩色化：每个功能对应独特的品牌色背景
  - 退出登录按钮优化：白色卡片样式，更统一
  - 新增页脚版权信息
- 整体视觉风格与首页保持一致

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

- 容器升级：统一圆角卡片、自定义阴影和装饰光晕
- 图标优化：增大尺寸，增加渐变背景和微边框
- 交互增强：添加点击微缩放效果 (active:scale-95)
- 排版优化：调整文字字重，提升精致感
- 保持首页三个核心板块视觉统一性

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

- 热卖产品和热门资料区块：增加背景装饰光晕和圆角标题指示条
- 优化"查看更多"按钮样式：灰色圆角背景 + 更精致的图标
- 统一卡片阴影和边框样式，与 ProductCard 保持一致
- 增加相对定位层级，确保装饰背景不影响交互

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

- 升级为高端专业风格（白色背景 + 细腻阴影 + 装饰光晕）
- 移除 nut-button 依赖，改用原生 view 实现精确样式控制
- 增加点击微缩放交互效果 (active:scale-[0.99])
- 优化标签样式和标题排版对比度

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

由于 Apifox 接口调整，无法自动访问，改为手动维护文档。

删除内容：
- MCP 服务器配置（.claude/settings.json, .claude/settings.local.json）
- Apifox 集成指南和 MCP 配置文档（6 份）
- Apifox 测试脚本（2 个）
- 环境变量配置示例

保留内容：
- docs/api-specs/ - OpenAPI 文档（手动维护）
- scripts/generateApiFromOpenAPI.js - 代码生成脚本
- api:generate 命令仍可使用

影响范围：删除 11 个文件，移除 1219 行代码

## 变更内容

### 文档更新
- 在 plan/index.vue 中添加详细的 TODO 注释，记录后端 API 缺少的关键参数
- 更新 API 集成日志，明确列出 4 个缺失的查询参数
- 更新 CHANGELOG，标注 order_status 状态值的不确定性

### 缺失的后端参数
1. **分页参数**（必须）：`page`、`limit`
2. **状态筛选参数**（必须）：`order_status`
3. **搜索参数**（建议）：`keyword`

### 重要说明
- ⚠️ order_status 状态值（"3"=生成中, "5"=已生成）是前端推测，需要与后端确认
- 🔴 当前使用前端过滤作为临时方案，存在性能和分页准确性问题
- 后端添加参数支持后，前端可改用服务端分页和过滤

## 影响文件
- src/pages/plan/index.vue: 添加 TODO 注释
- docs/api-docs/API 集成日志.md: 更新接口状态和问题记录
- docs/CHANGELOG.md: 记录状态值不确定性

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

- 修复 smoking_status 字段映射（之前错误映射为 smoker）
- 删除未使用的 formatAmounts 函数
- 将所有"客户姓名"统一改为"申请人"
- 更新表单标签、占位符和错误提示

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

- 添加 OpenAPI 生成器 title 字段识别修复的记录
- 详细说明影响文件和技术细节

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

修改内容：
- 修复 generateApiFromOpenAPI.js 同时支持 description 和 title 字段
- 更新 plan/add.md 文档格式（application/json，使用 title 字段）
- 重新生成 plan.js 和 user.js API 文件

影响：
- API 参数描述现在能正确显示中文名称（从 title 字段提取）
- 修正了参数类型（如 customer_age 从 string 改为 integer）

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

- 更新总体进度：联调中 2个接口（6.9%）
- addAPI（新增计划书）：后端开发中 → 联调中
- listAPI（计划书列表）：后端开发中 → 联调中
- 记录当前问题：后端还有点问题
- 新增联调中接口快速清单

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

在.gitignore中添加.swc/目录以忽略SWC编译缓存
将NameInput.vue中的字体大小单位从rpx改为响应式单位，提高可维护性
更新组件文件描述为更准确的中文说明

- 新增 PlanFieldName（NameInput）组件用于输入客户姓名
- 在重疾险、寿险、储蓄险三个模板中集成客户姓名字段
- 添加客户姓名必填校验逻辑
- 优化 NameInput 组件样式，使用 Tailwind CSS 和圆角边框
- 重构计划书页面代码，减少代码重复

影响文件:
- src/components/plan/PlanFields/NameInput.vue (新增)
- src/components/plan/PlanTemplates/*.vue (修改)
- src/components/plan/PlanFormContainer.vue (重构)
- src/pages/plan/index.vue (重构)

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

- 简化 API 包装函数（file.js, get_product.js, plan.js）
- 更新计划书 API：新增 addAPI 和 listAPI
- 统一使用 fn(fetch.post/get) 调用方式
- 清理文件头部注释
- 新增计划书 API 文档（docs/api-specs/plan/）

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

- 新增 docs/api-docs/README.md（API 文档缓存说明）
- 新增 docs/api-docs/常用组件速查表.md（组件使用速查）
- 更新 .claude/settings.local.json（权限配置）

---

**详细信息**：
- **影响文件**: .claude/settings.local.json, docs/api-docs/README.md, docs/api-docs/常用组件速查表.md
- **技术栈**: 文档
- **测试状态**: N/A
- **备注**: 提供 Taro 和 NutUI 文档缓存方案及常用组件使用示例

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

- 添加 hasTemplate prop 控制底部按钮显示状态
- 未找到模板时只显示"关闭"按钮
- 找到模板时显示"取消"和"生成计划书"按钮
- 改进用户体验，避免在无模板时显示无用的按钮

影响文件:
- src/components/plan/PlanPopupNew.vue
- src/components/plan/PlanFormContainer.vue

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

更新 CHANGELOG.md 记录 Taro 4.1.9 → 4.1.11 和 NutUI 4.3.13 → 4.3.14 的升级

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

- 升级 @nutui/nutui-taro: 4.3.13 → 4.3.14
- 升级 Taro 框架: 4.1.9 → 4.1.11
  - 所有 @tarojs/* 核心包升级
  - 新增 @tarojs/service 依赖
- 更新 pnpm-lock.yaml

改进内容：
- NutUI 4.3.14 的 bug 修复和性能优化
- Taro 4.1.11 的小程序平台兼容性改进
- 更好的 TypeScript 支持

影响文件：
- package.json
- pnpm-lock.yaml

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

- 开发环境(NODE_ENV=development)自动使用Mock数据
- 生产环境自动使用真实API
- 移除硬编码的USE_MOCK_DATA开关

将 Mock 数据相关文档从 docs/api-specs/数据文档/ 移动到 docs/guides/数据文档/

变更内容:
- 重命名: Mock 数据完整总结.md
- 重命名: Mock 数据设置指南.md

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

将文档移动到更合理的目录位置：
- 移动 GlobalPopupManager-弹窗管理器.md 到 docs/guides/
- 移动 lessons-learned.md 到 docs/lessons-learned/ 子目录
- 提升文档组织清晰度

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

- 新增 2026-02-09 变更记录
- 记录 API 集成日志更新（3个接口联调完成）
- 记录经验教训文档更新（新增复杂功能修改流程）

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

API 集成日志：
- 完成 3 个待联调接口联调（addAPI, weekHotAPI, fileListAPI）
- 新增待联调接口快速清单（便于快速定位）
- 新增 myPlanListAPI 接口定义（我的计划书列表）
- 更新进度追踪：29个接口，82.8% 已完成

经验教训文档：
- 新增"复杂功能修改的系统性问题"章节
- 记录计划书模块开发中的系统性问题
- 提供系统化修改流程解决方案（5步完整流程）
- 包含反面案例和正面案例对比

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