Hooke / manulife-weapp

Go to a project
Toggle navigation Toggle navigation pinning
hookehuyr
6622141c 1 parent 4185076a

docs(readme): 优化文档结构，移除重复内容 

- 移除 README.md 重复的"最新更新"内容（约137行）
- 建立文档单一真实来源：CHANGELOG.md 为版本历史权威来源
- README.md 新增简洁"近期亮点"部分
- 更新 docs/README.md 添加测试策略文档引用
- 更新架构图视图位置

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Inline Side-by-side
Showing 4 changed files with 34 additions and 139 deletions
......@@ -49,143 +49,17 @@ pnpm lint
- ✅ **文档预览能力** - DocumentPreview 支持多格式文件预览
- ✅ **统一列表交互** - 搜索、收藏、资料列表统一点击与操作逻辑
## 🆕 最新更新（2026-02-15 & 2026-02-14）
### 文档解析重大升级（2026-02-15）
- ✅ **多产品文档解析** - 支持自动识别和分割包含多个保险产品的文档
- ✅ **智能字段提取器** - 实现 smartExtractList() 智能列表边界识别
- ✅ **产品边界检测** - 支持产品代码（GS、GC、FA、LV2）和命名模式识别
- ✅ **MCP 解析切换** - 完善 markitdown 文档解析服务集成
- ✅ **审核流程落地** - 待审核文件管理，人工确认后才写入配置
### Git 工作流优化（2026-02-14）
- ✅ **版本管理标准化** - 使用 standard-version 替代自定义脚本
- ✅ **Conventional Commits** - 配置提交信息规范
- ✅ **自动化版本发布** - 自动更新版本号和生成 Git 标签
- ✅ **人工维护 CHANGELOG** - 配置跳过自动生成，使用自定义模板
### 消息功能全面优化（2026-02-14）
- ✅ **列表布局优化** - 提升消息卡片信息可读性
- ✅ **代码简化** - 移除冗余逻辑，提升可维护性
- ✅ **详情页优化** - 避免内容重复显示，统一交互体验
### 计划书模块重构（2026-02-14）
- ✅ **Schema 驱动** - 储蓄类/人寿/重疾模板字段配置化
- ✅ **提交映射优化** - 从容器迁移到模板配置
- ✅ **校验提示改进** - 必填提示与百分比校验统一
### 构建告警修复（2026-02-14）
- ✅ **usePlanView 导出补齐** - 补充 usePlanView 导出并绑定 viewFile，修复构建告警
### 计划书表单演进
- ✅ **Schema 驱动** - 储蓄类模板字段由配置驱动渲染与校验
- ✅ **提交映射下沉** - 提交字段映射从容器迁移到模板配置
- ✅ **人寿/重疾同步** - 人寿与重疾模板改为 Schema 驱动
- ✅ **校验提示优化** - 必填提示与百分比校验统一更准确
### 字段命名优化
- ✅ **提取方式字段** - 统一将 specified_amount_type 重命名为 withdrawal_method
- ✅ **文档同步** - 更新提取计划相关文档字段示例
- ✅ **优化建议** - 提取计划相关字段命名保持“功能优先”的语义一致性
### 文档对齐
- ✅ **业务模块更新** - README 页面清单与业务模块对齐现有路由
- ✅ **新人指南更新** - 入口文档从工具生成器调整为业务上手流程
- ✅ **文档导航同步** - docs/README 快速导航修正与补充
### 文档解析改造
- ✅ **任务清单** - 输出文档解析改造任务清单，便于跟踪与回顾
- ✅ **文本抽取管线** - 接入 PDF/Docx 文本抽取与统一结构输出
- ✅ **结构化校验** - 接入 JSON Schema 校验并阻断非法配置写入
- ✅ **写入稳态化** - 结构化插入、重复检测与 dry-run 预览已接入
- ✅ **输出结构补齐** - 解析输出 JSON 结构与稳定 form_sn 规则已明确
- ✅ **审计与摘要** - 解析摘要与审计日志输出已接入
- ✅ **审核流程规划** - 整理审核流程方案并对齐字段与目录规范
- ✅ **审核模板落地** - 待审核文件输出完善，默认不写入配置，需显式 --write-config
- ✅ **链路与思路** - 补充解析链路与使用思路，明确审核与合并边界
### 测试与验证
- ✅ **回归测试** - pnpm test 通过，pnpm lint 存在 30 个现存警告
### 计划书模块定位
- ✅ **配置与入口整理** - 补充计划书模块入口、配置与 API 位置说明
- ✅ **优化建议** - 新增产品时优先补齐 form_sn 与 plan_config，避免模板缺失
### 计划书模块优化补齐
- ✅ **字段分组补齐** - 补齐基本信息/保障/提取字段分组
- ✅ **错误回调兼容** - 支持 onError 回调并保持 onViewError 兼容
- ✅ **转换逻辑修正** - 分元双向转换统一使用转换器
- ✅ **依赖检测测试** - 补充循环依赖检测单测与分组工具测试
### 计划书配置核查
- ✅ **配置应用核查** - 确认 plan-templates 已驱动表单渲染与提交映射，plan-fields 与字段关联/转换 composable 尚未接入生成链路
- ✅ **依赖与转换接入** - 表单可见性接入 useFieldDependencies，提交金额转换接入 useFieldValueTransform
- ✅ **提取字段拆分** - 指定提取金额与最高固定提取金额字段独立显示与提交映射
## 🆕 最新更新（2026-02-14）
### 文档解析
- ✅ **解析验证** - 成功解析 测试计划书-智享未来.md 并生成配置
- ✅ **优化建议** - 解析结果需补齐 form_schema 与 submit_mapping 以便直接渲染
- ✅ **规则落地** - 解析生成按保险类型自动注入 form_schema 与 submit_mapping
- ✅ **空值回退** - 空 schema 自动回退默认 schema，避免生成空表单
- ✅ **文件过滤** - 解析批量扫描时自动跳过 docs/to-parse/README.md
### 测试与验证
- ✅ **测试修正** - 搜索页单测固定使用真实 API Mock，避免受全局 Mock 开关影响
## 🆕 最新更新（2026-02-13）
### 权限与测试
- ✅ **资料查看权限** - 资料查看入口增加登录校验，支持动作级权限扩展
- ✅ **回跳路径统一** - 统一保存登录回跳路径，确保权限拦截后可恢复
- ✅ **搜索页测试** - 搜索页测试对齐当前实现并补充接口 Mock
### 文档解析
- ✅ **配置生成修复** - 修复文档解析生成配置的 form_sn 前缀、category 位置与插入稳定性
## 🆕 最新更新（2026-02-12）
### 计划书功能优化
- ✅ **状态标记** - 添加计划书卡片状态标记（"生成中" / "已完成"）
- 黄色背景表示"生成中"状态
- 绿色背景表示"已完成"状态
- 使用条件类名动态切换样式
- ✅ **查看状态更新** - 仅在预览成功后标记为已查看，返回列表不刷新位置
- ✅ **提交跳转体验** - 提交后先关闭并重置弹框，再无固定延迟跳转结果页
- ✅ **返回重置体验** - 关闭弹框时清理已选产品，确保返回后表单为空
- ✅ **字段优化** - 优化提取金额字段并新增每年提取字段
### 认证与权限优化
- ✅ **登录权限检查** - 为所有制作计划书按钮添加登录权限检查
- ✅ **红点状态管理** - 修复退出登录时红点状态未重置的问题
- ✅ **TabBar 红点** - 配置 TabBar 红点功能使用新的 unread_msg_count 字段
- ✅ **登录页返回** - 修复登录页返回按钮，清空 router store 并跳转到首页
- ✅ **401 修复** - 修复 401 重定向死循环和返回报错问题
### 消息功能优化
- ✅ **消息列表** - 优化消息列表卡片布局，提升信息可读性
- ✅ **消息详情** - 优化消息详情页布局，避免内容重复显示
- ✅ **未读提示** - 增加未读消息红点提示
- ✅ **API 错误处理** - 添加消息列表 API 错误提示
### 视觉优化
- ✅ **首页网格导航** - 优化导航图标视觉体验
- ✅ **产品卡片** - 优化 ProductCard 组件视觉样式
- ✅ **页面风格** - 重构"我的"页面为专业高端风格
- ✅ **统一视觉** - 优化视觉柔和度和整体统一性
- ✅ **头图优化** - 优化首页头图 CDN 加载
### API 集成
- ✅ **接口联调完成** - 计划书模块接口联调完成（submitPlanAPI、listAPI）
- ✅ **总进度** - 29 个接口，已完成 26 个（89.7%）
- ✅ **关闭 Mock** - 禁用消息列表 Mock 数据，使用真实接口
## 📝 更新日志
### 代码质量
- ✅ **移除本地配置** - 从版本控制中移除本地配置文件 settings.local.json
- ✅ **Composable 抽取** - 提取计划书提交回调逻辑为 composable
- ✅ **清理调试日志** - 清理项目中的调试日志
- ✅ **文档更新** - 完善开发文档和经验教训总结
> **完整更新记录请查看 [CHANGELOG.md](docs/CHANGELOG.md)**
### 近期亮点
- **多产品文档解析** - 支持自动识别和分割包含多个保险产品的文档
- **计划书 Schema 驱动** - 储蓄类/人寿/重疾模板字段配置化
- **Git 工作流标准化** - 使用 standard-version + Conventional Commits
- **认证系统完善** - 401 自动刷新、登录权限检查、TabBar 红点
- **API 集成进度** - 29 个接口，已完成 26 个（89.7%）
## ⚡ 常见问题
......
# CHANGELOG
## [2026-02-22] - 文档结构优化
### 文档
- 优化 README.md 结构，移除重复的"最新更新"内容（约137行）
- 建立文档单一真实来源：CHANGELOG.md 为版本历史权威来源
- README.md 新增简洁"近期亮点"部分，引导用户查看完整 CHANGELOG
---
## [2026-02-22] - 测试策略文档
### 文档
- 新增微信小程序测试策略指南（docs/testing-strategy.md）
- 定义测试金字塔：70% 单元测试 + 20% 集成测试 + 5% E2E 测试 + 5% 手动测试
- 记录现有测试基础设施：Vitest + @vue/test-utils + happy-dom
- 制定短/中/长期测试实施路线图
---
## [2026-02-15] - 项目架构图整理
### 文档
......
......@@ -9,6 +9,7 @@ docs/
├── CHANGELOG.md # 项目变更日志（核心文档）
├── README.md # 本文件（文档导航索引）
├── lessons-learned.md # 经验教训总结（核心文档）
├── testing-strategy.md # 微信小程序测试策略指南
│
├── guides/ # 📘 使用指南和教程
│ ├── 新人入门指南.md # 新人入门指南
......@@ -84,6 +85,7 @@ docs/
- 📖 [项目变更日志](CHANGELOG.md) - 所有功能、修复和优化的记录
- 📖 [经验教训总结](lessons-learned.md) - 开发中的最佳实践和常见陷阱
- 📖 [API 联调日志](api-docs/API 集成日志.md) - 接口联调状态记录
- 📖 [微信小程序测试策略指南](testing-strategy.md) - 完整的测试分层策略和实施方案
### 新手入门
👉 **[guides/新人入门指南.md](guides/新人入门指南.md)** - 快速了解业务与页面结构
......@@ -176,4 +178,4 @@ UI/UX 设计稿和生成的代码：
---
**最后更新**: 2026-02-14
**最后更新**: 2026-02-22
......
<mxfile host="65bd71144e">
<diagram id="b5dOQcsEGuaq2pC0fEqS" name="第 1 页">
<mxGraphModel dx="1990" dy="1355" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="0" pageScale="1" pageWidth="1600" pageHeight="1200" math="0" shadow="0">
<mxGraphModel dx="1953" dy="1355" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="0" pageScale="1" pageWidth="1600" pageHeight="1200" math="0" shadow="0">
<root>
<mxCell id="0"/>
<mxCell id="1" parent="0"/>
......@@ -147,7 +147,7 @@
</mxCell>
<mxCell id="flow-label4" value="组件复用" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];fontSize=14;fontStyle=1;fontFamily=Noto Sans JP;labelBackgroundColor=#ffffff;" parent="arrow4" vertex="1" connectable="0">
<mxGeometry x="-0.2" y="2" relative="1" as="geometry">
<mxPoint x="-10" y="-9" as="offset"/>
<mxPoint x="137" y="-9" as="offset"/>
</mxGeometry>
</mxCell>
</root>
......