hookehuyr

docs: 添加项目开发计划文档和Claude本地配置

添加项目开发计划文档,详细说明臻奇智荟圈小程序的功能模块、技术架构、开发计划和验收标准。同时添加Claude本地配置文件,允许使用pandoc相关命令。
{
"permissions": {
"allow": [
"Bash(pandoc:*)"
]
}
}
# 臻奇智荟圈小程序 - 项目开发计划
## 📋 项目概览
### 项目基础信息
- **项目名称**: 臻奇智荟圈小程序
- **项目编号**: ITX20260119
- **合同编号**: ITX2026012301
- **客户名称**: Candy
- **开发周期**: 2026-01-20 至 2026-02-28(约5周)
- **报价有效期**: 2026-02-28
### 项目定位
服务保险团队内部同事的轻量化微信小程序,核心解决三大痛点:
1. 计划书快速生成+状态实时反馈
2. 沉淀内部培训、服务资料,打造专属知识库
3. AI智能问答功能
### 核心技术决策
- **不对接保险公司官方API**:规避高成本、高门槛问题
- **采用半人工方式**:前端提交+后台人工协同的低成本落地方案
- **AI功能**:采用腾讯元宝AI,建立团队私有的知识库
---
## 🎯 需求分析
### 一、核心功能模块
#### 模块1:计划书快速生成模块
**前端输入界面**(7-8个核心字段)
| 字段名称 | 类型 | 说明 | 验证规则 |
|---------|------|------|---------|
| 客户姓名 | 输入框 | 文本输入 | 必填,2-20字符 |
| 客户性别 | 单选 | 男/女 | 必填 |
| 客户年龄 | 选择器 | 18-65岁 | 必填,匹配保险产品年龄限制 |
| 产品名称 | 下拉选择 | 预设团队主推产品列表 | 必填,后台可维护 |
| 缴费年限 | 下拉选择 | 1年/5年/10年/终身 | 必填,绑定对应产品可选年限 |
| 货币类型 | 单选 | 美元/港币/人民币 | 必填 |
| 总保费金额 | 输入框 | 数字格式 | 必填,数字格式验证 |
| 备注栏 | 文本框 | 客户特殊需求 | 选填,最多500字符 |
**后台协同流程**
1. 同事提交信息后,小程序自动生成唯一订单号,状态为「待处理」
2. 后台助理端(PC管理后台)收到实时提醒,显示待处理订单列表
3. 助理用公司现有系统生成PDF计划书和相关附件,上传至对应订单,状态更新为「已生成」
4. 提交同事的小程序收到消息推送,可查看PDF或图片
**状态流转逻辑**
```
待处理 → 处理中 → 已生成 → 已查看
```
支持后台手动修改状态,应对特殊情况
#### 模块2:内部培训资料库模块
**资料分类管理**
| 分类名称 | 内容示例 |
|---------|---------|
| 入职相关 | 入职前(考试报名、刷题、签约规则)<br>入职中(时间线、财务计划、基本法对比)<br>入职后(必修课、升职流程、平台使用)<br>续签资料汇总 |
| 签单相关 | 培训板块(公司介绍、产品介绍及更新)<br>签单前(预核保、做计划书)<br>签单中(信息收集、健康告知、缴费、体检)<br>签单后(批单跟进、核保/pending、续保)<br>售后(香港医生资源) |
| AI答疑 | 腾讯元宝AI功能,创建专有知识库,24小时答疑秘书 |
| 家办业务 | 家庭生活相关资料管理 |
**核心权限与功能**
- **管理员权限**:可上传、编辑、删除、分类资料;可维护同事账号列表
- **普通同事权限**:仅在线查看(无下载按钮),支持PDF在线预览、视频在线播放
- **检索功能**:按分类/关键词搜索
- **更新提醒**:资料库新增/更新时推送通知
**资料格式支持**
- 视频、音频、PDF、图片等格式
- 可由管理员动态添加分类
- 上传内容可同时存放多种分类
- 支持标签管理
#### 模块3:计划书简化海报生成(附加功能)
**核心功能**
1. 助理上传PDF后,自动提取关键信息:
- 客户姓名、年龄
- 产品名称
- 核心收益/保障
- 缴费周期
2. 预设3-5套海报模板(专业、简洁风格)
3. 一键生成图片,支持分享给客户
#### 模块4:AI辅助功能
**功能设计**
1. 预设打通AI辅助功能
2. 启用腾讯元宝,建立团队私有知识库
3. 开发对话方式查询界面
4. 以内部数据库为核心知识来源
---
## 🏗️ 技术架构设计
### 技术栈选型
| 技术组件 | 用途 | 技术选型 |
|---------|------|---------|
| 小程序前端 | 同事操作界面 | Taro 4 + Vue 3 + NutUI |
| 后端API | 业务逻辑处理 | Node.js + Express |
| 数据库 | 存储订单、用户、资料数据 | MySQL / PostgreSQL |
| 文件存储 | PDF、培训资料、海报、视频 | 七牛云私有云存储 |
| CDN加速 | 视频、图片加速 | 七牛云CDN |
| AI服务 | 智能问答 | 腾讯元宝AI |
| 即时通讯 | 消息推送 | 微信小程序订阅消息 |
### 系统架构图
```
┌─────────────────────────────────────────────────────────────┐
│ 微信小程序前端 │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │计划书生成 │ │ 资料库 │ │ AI问答 │ │ 个人中心 │ │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
└─────────────────────────────────────────────────────────────┘
↕ HTTPS
┌─────────────────────────────────────────────────────────────┐
│ 后端API服务 │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ 订单管理 │ │ 资料管理 │ │ 权限控制 │ │ 消息推送 │ │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
└─────────────────────────────────────────────────────────────┘
↕ ↕ ↕ ↕
┌─────────┐ ┌─────────┐ ┌──────────┐ ┌──────────┐
│ 数据库 │ │云存储 │ │ 腾讯AI │ │微信消息 │
└─────────┘ └─────────┘ └──────────┘ └──────────┘
```
---
## 💾 数据库设计
### 核心数据表
#### 1. 用户表 (users)
```sql
CREATE TABLE users (
id INT PRIMARY KEY AUTO_INCREMENT,
openid VARCHAR(100) UNIQUE NOT NULL COMMENT '微信openid',
name VARCHAR(50) NOT NULL COMMENT '姓名',
role ENUM('admin', 'user') DEFAULT 'user' COMMENT '角色',
status ENUM('active', 'inactive') DEFAULT 'active' COMMENT '状态',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);
```
#### 2. 订单表 (orders)
```sql
CREATE TABLE orders (
id INT PRIMARY KEY AUTO_INCREMENT,
order_no VARCHAR(50) UNIQUE NOT NULL COMMENT '订单号',
user_id INT NOT NULL COMMENT '提交用户ID',
customer_name VARCHAR(50) NOT NULL COMMENT '客户姓名',
customer_gender ENUM('male', 'female') NOT NULL COMMENT '客户性别',
customer_age INT NOT NULL COMMENT '客户年龄',
product_name VARCHAR(100) NOT NULL COMMENT '产品名称',
payment_period VARCHAR(20) NOT NULL COMMENT '缴费年限',
currency_type ENUM('USD', 'HKD', 'CNY') NOT NULL COMMENT '货币类型',
total_amount DECIMAL(15,2) NOT NULL COMMENT '总保费金额',
remark TEXT COMMENT '备注',
status ENUM('pending', 'processing', 'generated', 'viewed') DEFAULT 'pending' COMMENT '状态',
pdf_url VARCHAR(500) COMMENT 'PDF计划书URL',
poster_url VARCHAR(500) COMMENT '海报URL',
attachments JSON COMMENT '附件列表',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
FOREIGN KEY (user_id) REFERENCES users(id)
);
```
#### 3. 产品表 (products)
```sql
CREATE TABLE products (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(100) NOT NULL COMMENT '产品名称',
payment_periods JSON NOT NULL COMMENT '可选缴费年限',
age_range JSON NOT NULL COMMENT '年龄限制 [min, max]',
status ENUM('active', 'inactive') DEFAULT 'active' COMMENT '状态',
sort_order INT DEFAULT 0 COMMENT '排序',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
```
#### 4. 资料分类表 (material_categories)
```sql
CREATE TABLE material_categories (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(50) NOT NULL COMMENT '分类名称',
parent_id INT DEFAULT NULL COMMENT '父分类ID',
sort_order INT DEFAULT 0 COMMENT '排序',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
FOREIGN KEY (parent_id) REFERENCES material_categories(id)
);
```
#### 5. 资料表 (materials)
```sql
CREATE TABLE materials (
id INT PRIMARY KEY AUTO_INCREMENT,
title VARCHAR(200) NOT NULL COMMENT '资料标题',
category_id INT NOT NULL COMMENT '分类ID',
file_type ENUM('video', 'audio', 'pdf', 'image') NOT NULL COMMENT '文件类型',
file_url VARCHAR(500) NOT NULL COMMENT '文件URL',
file_size BIGINT COMMENT '文件大小(字节)',
duration INT COMMENT '时长(秒,视频/音频)',
description TEXT COMMENT '描述',
tags JSON COMMENT '标签列表',
created_by INT NOT NULL COMMENT '创建者ID',
status ENUM('active', 'inactive') DEFAULT 'active' COMMENT '状态',
view_count INT DEFAULT 0 COMMENT '查看次数',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
FOREIGN KEY (category_id) REFERENCES material_categories(id),
FOREIGN KEY (created_by) REFERENCES users(id)
);
```
#### 6. 资料分类关联表 (material_category_relations)
```sql
CREATE TABLE material_category_relations (
id INT PRIMARY KEY AUTO_INCREMENT,
material_id INT NOT NULL COMMENT '资料ID',
category_id INT NOT NULL COMMENT '分类ID',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
FOREIGN KEY (material_id) REFERENCES materials(id),
FOREIGN KEY (category_id) REFERENCES material_categories(id),
UNIQUE KEY unique_relation (material_id, category_id)
);
```
#### 7. 操作日志表 (operation_logs)
```sql
CREATE TABLE operation_logs (
id INT PRIMARY KEY AUTO_INCREMENT,
user_id INT NOT NULL COMMENT '操作用户ID',
action VARCHAR(50) NOT NULL COMMENT '操作类型',
target_type VARCHAR(50) COMMENT '目标类型',
target_id INT COMMENT '目标ID',
details JSON COMMENT '操作详情',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
FOREIGN KEY (user_id) REFERENCES users(id)
);
```
---
## 📅 开发计划与里程碑
### 总体时间规划
- **项目启动**: 2026-01-20
- **需求确认**: 2026-01-25(5天)
- **开发周期**: 2026-01-26 至 2026-02-24(30天)
- **测试上线**: 2026-02-24
- **验收交付**: 2026-02-28
### 第一阶段:MVP版本(3周:2026-01-26 至 2026-02-15)
#### Week 1: 基础搭建与核心功能开发(2026-01-26 至 2026-02-01)
**目标**:完成项目基础架构搭建和计划书生成模块
**前端开发**
- [ ] 项目初始化(Taro + Vue3 + NutUI)
- [ ] 首页设计与开发
- [ ] 计划书提交页面开发
- [ ] 表单设计与验证
- [ ] 产品下拉选择(动态加载)
- [ ] 缴费年限联动选择
- [ ] 货币类型单选
- [ ] 保费金额输入验证
- [ ] 我的订单列表页面
- [ ] 订单状态展示
- [ ] 查看订单详情
- [ ] PDF在线预览
- [ ] 个人中心页面
- [ ] 用户信息展示
- [ ] 权限判断(管理员/普通用户)
**后端开发**
- [ ] 项目初始化(Node.js + Express)
- [ ] 数据库设计与创建
- [ ] 用户认证API
- [ ] 微信登录
- [ ] 用户信息获取
- [ ] 订单管理API
- [ ] 创建订单
- [ ] 订单列表查询
- [ ] 订单详情查询
- [ ] 订单状态更新
- [ ] 产品管理API
- [ ] 产品列表查询
- [ ] 产品可选年限查询
**后台管理**
- [ ] PC管理后台框架搭建
- [ ] 管理员登录
- [ ] 订单管理
- [ ] 待处理订单列表
- [ ] 订单详情查看
- [ ] 上传PDF计划书
- [ ] 更新订单状态
- [ ] 产品管理
- [ ] 产品列表
- [ ] 添加/编辑/删除产品
**测试与验收**
- [ ] 前后端联调
- [ ] 内部测试
- [ ] Bug修复
#### Week 2: 资料库模块开发(2026-02-02 至 2026-02-08)
**目标**:完成内部培训资料库模块
**前端开发**
- [ ] 资料库首页
- [ ] 分类导航
- [ ] 资料列表展示
- [ ] 搜索功能
- [ ] 资料详情页面
- [ ] PDF在线预览(禁止下载)
- [ ] 视频/音频在线播放
- [ ] 图片查看器
- [ ] 资料搜索页面
- [ ] 分类筛选
- [ ] 关键词搜索
- [ ] 标签筛选
**后端开发**
- [ ] 资料管理API
- [ ] 分类列表查询
- [ ] 资料列表查询(分页)
- [ ] 资料详情查询
- [ ] 资料搜索(按分类/关键词/标签)
- [ ] 文件上传API
- [ ] 上传到七牛云
- [ ] 返回文件URL
**后台管理**
- [ ] 资料分类管理
- [ ] 分类列表
- [ ] 添加/编辑/删除分类
- [ ] 分类排序
- [ ] 资料管理
- [ ] 资料列表(按分类筛选)
- [ ] 上传资料(视频/音频/PDF/图片)
- [ ] 编辑资料(标题、描述、分类、标签)
- [ ] 删除资料
- [ ] 批量操作
- [ ] 用户管理
- [ ] 用户列表
- [ ] 添加用户(入职)
- [ ] 禁用用户(离职)
- [ ] 权限管理
**测试与验收**
- [ ] 前后端联调
- [ ] 文件上传测试
- [ ] 权限测试
- [ ] 内部测试
- [ ] Bug修复
#### Week 3: 消息推送与AI功能(2026-02-09 至 2026-02-15)
**目标**:完成消息推送和AI辅助功能
**前端开发**
- [ ] AI问答页面
- [ ] 对话界面
- [ ] 消息列表
- [ ] 输入框
- [ ] 消息通知页面
- [ ] 通知列表
- [ ] 通知详情
**后端开发**
- [ ] 消息推送API
- [ ] 订单状态变更推送
- [ ] 资料更新推送
- [ ] 微信订阅消息集成
- [ ] AI问答API
- [ ] 腾讯元宝AI集成
- [ ] 知识库管理
- [ ] 对话接口
**后台管理**
- [ ] 消息推送管理
- [ ] 推送记录查询
- [ ] 手动发送消息
- [ ] AI知识库管理
- [ ] 知识库内容管理
- [ ] 对话记录查询
**测试与验收**
- [ ] 消息推送测试
- [ ] AI功能测试
- [ ] 内部测试
- [ ] Bug修复
**第一阶段交付**
- [ ] 小程序端功能验收
- [ ] 后台管理功能验收
- [ ] 用户测试报告
### 第二阶段:迭代优化(2周:2026-02-16 至 2026-02-24)
#### Week 4: 海报生成与功能优化(2026-02-16 至 2026-02-22)
**目标**:上线计划书海报生成功能和优化界面交互
**前端开发**
- [ ] 海报生成页面
- [ ] 查看海报
- [ ] 分享海报
- [ ] 保存到本地
- [ ] 界面优化
- [ ] 根据团队反馈调整按钮布局
- [ ] 优化页面交互体验
- [ ] 添加加载动画
- [ ] 优化错误提示
**后端开发**
- [ ] 海报生成API
- [ ] PDF信息提取
- [ ] 海报模板管理
- [ ] 海报生成(使用Canvas或图片合成)
- [ ] 性能优化
- [ ] API响应优化
- [ ] 数据库查询优化
- [ ] 缓存策略
**后台管理**
- [ ] 海报模板管理
- [ ] 模板列表
- [ ] 上传模板
- [ ] 模板预览
- [ ] 数据统计
- [ ] 订单统计
- [ ] 资料查看统计
- [ ] 用户活跃度统计
**测试与验收**
- [ ] 海报生成测试
- [ ] 性能测试
- [ ] 内部测试
- [ ] Bug修复
#### Week 5: 全面测试与上线准备(2026-02-23 至 2026-02-24)
**目标**:完成全面测试并准备上线
**测试**
- [ ] 功能测试(全功能回归测试)
- [ ] 兼容性测试(不同设备、不同微信版本)
- [ ] 性能测试(压力测试、并发测试)
- [ ] 安全测试(权限测试、数据安全)
- [ ] 用户体验测试
**上线准备**
- [ ] 生产环境部署
- [ ] 服务器配置
- [ ] 数据库部署
- [ ] 域名配置
- [ ] SSL证书配置
- [ ] 小程序提交审核
- [ ] 准备审核资料
- [ ] 提交微信审核
- [ ] 运维准备
- [ ] 监控配置
- [ ] 日志收集
- [ ] 备份策略
**文档**
- [ ] 用户操作手册
- [ ] 管理员操作手册
- [ ] 技术文档
- [ ] 运维手册
### 第三阶段:验收与交付(2026-02-24 至 2026-02-28)
#### Week 5: 验收与交付(2026-02-25 至 2026-02-28)
**验收**
- [ ] 功能验收(客户验收)
- [ ] 性能验收
- [ ] 安全验收
- [ ] 用户测试报告确认
**交付**
- [ ] 源代码交付
- [ ] 技术文档交付
- [ ] 需求规格说明书
- [ ] 系统设计文档
- [ ] API接口文档
- [ ] 数据库设计文档
- [ ] 运维手册
- [ ] 培训
- [ ] 管理员培训
- [ ] 用户培训
- [ ] 项目验收确认
---
## 📦 交付物清单
### 1. 功能交付物
- [ ] 微信小程序端(已发布上线)
- [ ] PC后台管理系统
- [ ] API接口服务
### 2. 技术文档
- [ ] 需求规格说明书
- [ ] 系统设计文档
- [ ] 数据库设计文档
- [ ] API接口文档
- [ ] 运维手册
### 3. 用户文档
- [ ] 用户操作手册(小程序端)
- [ ] 管理员操作手册(后台管理)
- [ ] 快速入门指南
### 4. 测试报告
- [ ] 用户测试报告
- [ ] 性能测试报告
- [ ] 安全测试报告
### 5. 源代码
- [ ] 小程序端源代码
- [ ] 后端API源代码
- [ ] 后台管理系统源代码
- [ ] 数据库初始化脚本
---
## ⚠️ 项目约束与风险
### 约束条件
1. **时间限制**:2个月内上线(2026-02-24)
2. **资源限制**:需客户方提供所需的各类资料
3. **技术限制**:不对接保险公司官方API
### 风险评估
| 风险类型 | 风险描述 | 应对策略 | 优先级 |
|---------|---------|---------|-------|
| 时间风险 | 开发周期较短,可能延期 | 分阶段迭代,优先核心功能,预留缓冲时间 | 高 |
| 需求变更 | 客户可能在开发过程中提出新需求 | 严格控制需求变更,变更需评估影响 | 中 |
| 技术风险 | PDF信息提取、海报生成可能遇到技术难点 | 技术预研,准备备选方案 | 中 |
| 第三方依赖 | 腾讯元宝AI、七牛云等第三方服务稳定性 | 选择可靠的服务商,制定降级方案 | 中 |
| 安全风险 | 资料库内容外泄 | 严格权限控制,禁止下载,操作日志记录 | 高 |
| 审核风险 | 小程序审核可能不通过 | 仔细阅读审核规范,提前规避违规内容 | 高 |
---
## 🎯 验收标准
### 功能验收标准
1. **计划书生成模块**
- [ ] 用户能成功提交计划书申请
- [ ] 后台能正常接收和处理订单
- [ ] PDF文件能正常上传和预览
- [ ] 订单状态能正常流转和更新
- [ ] 消息推送能正常发送和接收
2. **资料库模块**
- [ ] 管理员能正常上传和管理资料
- [ ] 用户能在线查看资料,但无法下载
- [ ] 搜索功能正常工作
- [ ] 分类和标签功能正常
3. **海报生成模块**
- [ ] 能从PDF提取关键信息
- [ ] 能生成海报图片
- [ ] 海报能正常分享
4. **AI问答模块**
- [ ] 能与腾讯元宝AI正常交互
- [ ] 能基于内部知识库回答问题
### 性能验收标准
1. 小程序页面加载时间 < 2秒
2. API响应时间 < 1秒
3. 视频播放秒开(使用CDN加速)
4. 支持至少100个并发用户
### 安全验收标准
1. 普通用户无法下载资料库文件
2. 管理员权限严格控制
3. 用户数据安全存储
4. 操作日志完整记录
### 用户体验验收标准
1. 界面简洁美观,操作便捷
2. 错误提示友好
3. 交互流畅,无明显卡顿
4. 适配不同屏幕尺寸
---
## 📊 项目管理
### 沟通机制
- **日常沟通**: 微信群/钉钉群
- **周报**: 每周五提交项目进度报告
- **会议**: 每周一进度同步会议
### 版本管理
- **代码仓库**: Git
- **分支策略**: git-flow
- `main`: 生产环境
- `develop`: 开发环境
- `feature/*`: 功能分支
- `hotfix/*`: 紧急修复分支
### 质量保证
- **代码审查**: 所有代码提交前需经过审查
- **单元测试**: 核心功能编写单元测试
- **集成测试**: 每个阶段完成后进行集成测试
- **用户验收测试**: 每个阶段完成后邀请客户参与验收测试
---
## 📝 待确认事项
1. **业务确认**
- [ ] 产品列表及可选缴费年限
- [ ] 资料分类结构是否满足需求
- [ ] 用户权限角色划分(是否需要多级权限)
2. **技术确认**
- [ ] 服务器配置(云服务商、规格)
- [ ] 域名准备(小程序域名、后台管理域名)
- [ ] 七牛云账号配置
- [ ] 腾讯元宝AI账号配置
- [ ] 微信小程序账号信息(AppID、AppSecret)
3. **设计确认**
- [ ] UI设计风格参考
- [ ] 海报模板设计(3-5套)
- [ ] 小程序logo和图标
4. **资料准备**
- [ ] 初始产品数据
- [ ] 初始资料库内容(入职相关、签单相关等)
- [ ] AI知识库初始内容
---
## 📞 联系方式
- **项目负责人**: [待填写]
- **技术负责人**: [待填写]
- **客户联系人**: Candy
---
**文档版本**: v1.0
**最后更新**: 2026-01-27
**文档状态**: 待审核