计划书模块文档
本目录包含臻奇智荟圈小程序中计划书模块的完整技术文档，涵盖架构设计、Schema 规范、快速指南和后端迁移方案。
📑 文档导航
🚀 快速开始
| 文档 | 说明 | 适合人群 |
|---|---|---|
| 快速使用指南 | 5分钟集成计划书功能 | 前端开发者 |
| 计划书模板定义 | 业务字段需求说明（人寿/重疾） | 业务分析师 |
🏗️ 架构与设计
| 文档 | 说明 | 适合人群 |
|---|---|---|
| 录入架构设计 | 完整架构设计方案（已批准） | 架构师、后端开发者 |
| 后端迁移指南 | 配置架构与迁移方案 | 后端开发者 |
| 架构图解 | 可视化架构图 | 架构师 |
📋 配置规范
| 文档 | 说明 | 适合人群 |
|---|---|---|
| Schema 规范参考 | JSON Schema 完整定义 | 前后端开发者 |
| Schema 使用指南 | 表单配置与映射实战 | 前端开发者 |
📊 项目规划
| 文档 | 说明 | 适合人群 |
|---|---|---|
| 前端开发计划 | 30天开发路线图（已更新） | 前端开发者、项目经理 |
| 项目开发计划 | 5周完整项目计划 | 项目经理 |
📄 附件
| 文件 | 说明 |
|---|---|
| 计划书模版.docx | 储蓄型产品业务需求（第二版） |
| 计划书模版2.docx | 提取计划详细字段说明 |
🎯 按场景查找文档
我想添加新产品配置
1. 先读: plan-entry-quick-guide.md (快速集成)
2. 参考: plan-form-schema-usage.md (配置字段)
3. 查阅: plan-config-schema-reference.md (Schema 规范)
我需要理解系统架构
1. 先读: plan-entry-architecture.md (架构概览)
2. 再看: plan-backend-migration-architecture.drawio (可视化图)
3. 深入: plan-backend-migration-guide.md (后端方案)
我是新加入的开发者
1. 先读: plan-entry-quick-guide.md (快速上手)
2. 再看: plan-form-schema-usage.md (理解配置)
3. 实践: 前端开发计划.md (了解全貌)
🗂️ 核心概念速查
Schema 层级
TemplateConfig (模板配置)
└─ config
├─ currency (币种)
├─ payment_periods (缴费年期)
├─ age_range (年龄范围)
├─ withdrawal_plan (提取计划)
├─ form_schema (表单结构)
│ ├─ base_fields (基础字段)
│ └─ withdrawal_fields (提取字段)
└─ submit_mapping (API 字段映射)
字段类型
| type | 组件 | 用途 |
|---|---|---|
name |
PlanFieldName | 姓名输入 |
text |
nut-input | 普通文本 |
amount |
PlanFieldAmount | 金额键盘 |
radio |
PlanFieldRadio | 单选 |
select |
PlanFieldSelect | 下拉选择 |
payment_period |
PaymentPeriodRadio | 缴费年期 |
date |
PlanFieldDatePicker | 日期选择 |
age |
PlanFieldAgePicker | 年龄选择 |
条件操作符
| 操作符 | 说明 |
|---|---|
eq |
等于 |
ne |
不等于 |
gt / lt
|
大于 / 小于 |
gte / lte
|
大于等于 / 小于等于 |
in |
包含于 |
📚 相关代码位置
配置文件
-
src/config/plan-templates.js- 产品模板配置 -
src/config/plan-fields.js- 字段定义库
组件
-
src/components/plan/PlanFormContainer.vue- 计划书容器 -
src/components/plan/PlanTemplates/- 模板组件（人寿/重疾/储蓄） -
src/components/plan/PlanFields/- 字段组件
API
-
src/api/plan.js- 计划书 API 接口
🔗 外部关联文档
文档维护: 本目录文档由 Claude Code 自动生成和维护 最后更新: 2026-03-04
🆕 最近更新（2026-03-04）
新增功能
- 提取期自定义输入：支持用户自定义输入提取期（1-100年）
- 出生年月日推算年龄：从出生日期自动推算年龄，用于判断多阶段提取方案
- 千分位分隔符：年缴保费显示添加千分位格式化
修复优化
- 年龄/出生年月日独立：移除联动逻辑，改为二选一独立字段
- 弹窗遮挡修复：修复提取期弹窗嵌套被遮挡问题
- 触发区域隐藏：PeriodInput 组件触发区域样式优化