hookehuyr

docs(plan): 添加计划书模块文档索引 README

- 按用途分类文档导航(快速开始/架构/配置/规划)
- 提供按场景查找指引(添加产品/理解架构/新员工入职)
- 包含核心概念速查表(Schema层级/字段类型/操作符)
- 关联代码位置索引,方便开发者快速定位

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
# 计划书模块文档
本目录包含臻奇智荟圈小程序中**计划书模块**的完整技术文档,涵盖架构设计、Schema 规范、快速指南和后端迁移方案。
---
## 📑 文档导航
### 🚀 快速开始
| 文档 | 说明 | 适合人群 |
|------|------|---------|
| **[快速使用指南](./plan-entry-quick-guide.md)** | 5分钟集成计划书功能 | 前端开发者 |
| **[计划书模板定义](./计划书模板.md)** | 业务字段需求说明(人寿/重疾) | 业务分析师 |
---
### 🏗️ 架构与设计
| 文档 | 说明 | 适合人群 |
|------|------|---------|
| **[录入架构设计](./plan-entry-architecture.md)** | 完整架构设计方案(已批准) | 架构师、后端开发者 |
| **[后端迁移指南](./plan-backend-migration-guide.md)** | 配置架构与迁移方案 | 后端开发者 |
| **[架构图解](./plan-backend-migration-architecture.drawio)** | 可视化架构图 | 架构师 |
---
### 📋 配置规范
| 文档 | 说明 | 适合人群 |
|------|------|---------|
| **[Schema 规范参考](./plan-config-schema-reference.md)** | JSON Schema 完整定义 | 前后端开发者 |
| **[Schema 使用指南](./plan-form-schema-usage.md)** | 表单配置与映射实战 | 前端开发者 |
---
### 📊 项目规划
| 文档 | 说明 | 适合人群 |
|------|------|---------|
| **[前端开发计划](./前端开发计划.md)** | 30天开发路线图(已更新) | 前端开发者、项目经理 |
| **[项目开发计划](./项目开发计划.md)** | 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 接口
---
## 🔗 外部关联文档
- **[项目 README](../../README.md)** - 项目概述
- **[经验教训总结](../lessons-learned.md)** - 开发经验与最佳实践
- **[接口联调日志](../api-integration-log.md)** - API 集成状态
---
**文档维护**: 本目录文档由 Claude Code 自动生成和维护
**最后更新**: 2026-02-25