项目开发计划.md 21.9 KB

Raw Blame History Permalink



臻奇智荟圈小程序 - 项目开发计划


📋 项目概览


项目基础信息


项目名称: 臻奇智荟圈小程序

项目编号: ITX20260119

合同编号: ITX2026012301

客户名称: Candy

开发周期: 2026-01-20 至 2026-02-28（约5周）

报价有效期: 2026-02-28


项目定位

服务保险团队内部同事的轻量化微信小程序，核心解决三大痛点：


计划书管理与状态实时反馈
产品与资料沉淀、统一检索与消息通知
反馈闭环与个人中心能力


核心技术决策


不对接保险公司官方API：规避高成本、高门槛问题

采用半人工方式：前端提交+后台人工协同的低成本落地方案

AI能力：采用腾讯元宝AI进行外部配置，不在小程序内置页面


✅ 当前业务概览


核心模块


产品与资料：产品中心、资料分类、周热门、签单与家办入口
计划书：计划书列表、提交结果与消息联动
搜索与消息：全局搜索、消息列表与详情
个人中心与反馈：我的、收藏、头像、帮助中心、意见反馈


当前路由基准

以 src/app.config.js 为准，涉及页面包含首页、搜索、文档预览、文档演示、产品中心、计划书、消息、反馈、登录等。


🗃️ 历史需求分析（已停用）


一、核心功能模块


模块1：计划书快速生成模块

前端输入界面（7-8个核心字段）
| 字段名称 | 类型 | 说明 | 验证规则 |
|---------|------|------|---------|
| 客户姓名 | 输入框 | 文本输入 | 必填，2-20字符 |
| 客户性别 | 单选 | 男/女 | 必填 |
| 客户年龄 | 选择器 | 18-65岁 | 必填，匹配保险产品年龄限制 |
| 产品名称 | 下拉选择 | 预设团队主推产品列表 | 必填，后台可维护 |
| 缴费年限 | 下拉选择 | 1年/5年/10年/终身 | 必填，绑定对应产品可选年限 |
| 货币类型 | 单选 | 美元/港币/人民币 | 必填 |
| 总保费金额 | 输入框 | 数字格式 | 必填，数字格式验证 |
| 备注栏 | 文本框 | 客户特殊需求 | 选填，最多500字符 |

后台协同流程


同事提交信息后，小程序自动生成唯一订单号，状态为「待处理」
后台助理端（PC管理后台）收到实时提醒，显示待处理订单列表
助理用公司现有系统生成PDF计划书和相关附件，上传至对应订单，状态更新为「已生成」
提交同事的小程序收到消息推送，可查看PDF或图片


状态流转逻辑

待处理 → 处理中 → 已生成 → 已查看


支持后台手动修改状态，应对特殊情况


模块2：内部培训资料库模块

资料分类管理
| 分类名称 | 内容示例 |
|---------|---------|
| 入职相关 | 入职前（考试报名、刷题、签约规则）
入职中（时间线、财务计划、基本法对比）
入职后（必修课、升职流程、平台使用）
续签资料汇总 |
| 签单相关 | 培训板块（公司介绍、产品介绍及更新）
签单前（预核保、做计划书）
签单中（信息收集、健康告知、缴费、体检）
签单后（批单跟进、核保/pending、续保）
售后（香港医生资源） |
| AI答疑 | 腾讯元宝AI功能，创建专有知识库，24小时答疑秘书 |
| 家办业务 | 家庭生活相关资料管理 |

核心权限与功能


管理员权限：可上传、编辑、删除、分类资料；可维护同事账号列表

普通同事权限：仅在线查看（无下载按钮），支持PDF在线预览、视频在线播放

检索功能：按分类/关键词搜索

更新提醒：资料库新增/更新时推送通知


资料格式支持


视频、音频、PDF、图片等格式
可由管理员动态添加分类
上传内容可同时存放多种分类
支持标签管理


模块3：计划书简化海报生成（附加功能）

核心功能


助理上传PDF后，自动提取关键信息：


客户姓名、年龄
产品名称
核心收益/保障
缴费周期


预设3-5套海报模板（专业、简洁风格）
一键生成图片，支持分享给客户


模块4：AI辅助功能

功能设计


预设打通AI辅助功能
启用腾讯元宝，建立团队私有知识库
开发对话方式查询界面
以内部数据库为核心知识来源


🏗️ 技术架构设计


技术栈选型


技术组件
用途
技术选型


小程序前端
同事操作界面
Taro 4 + Vue 3 + NutUI


后端API
业务逻辑处理
Node.js + Express


数据库
存储订单、用户、资料数据
MySQL / PostgreSQL


文件存储
PDF、培训资料、海报、视频
七牛云私有云存储


CDN加速
视频、图片加速
七牛云CDN


AI服务
外部知识库配置
腾讯元宝AI（外部配置）


即时通讯
消息推送
微信小程序订阅消息


系统架构图

┌─────────────────────────────────────────────────────────────┐
│                        微信小程序前端                          │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  │
│  │计划书流程 │  │  资料中心 │  │ 搜索消息  │  │  个人中心 │  │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  │
└─────────────────────────────────────────────────────────────┘
                              ↕ HTTPS
┌─────────────────────────────────────────────────────────────┐
│                        后端API服务                            │
│  ┌───────────┐  ┌───────────┐  ┌───────────┐  ┌───────────┐  │
│  │ 订单管理  │  │ 资料管理  │  │  权限控制 │  │  消息推送 │  │
│  └───────────┘  └───────────┘  └───────────┘  └───────────┘  │
└─────────────────────────────────────────────────────────────┘
          ↕           ↕               ↕           ↕
    ┌─────────┐  ┌─────────┐   ┌──────────┐  ┌──────────┐
    │ 数据库  │  │云存储   │   │  腾讯AI  │  │微信消息  │
    └─────────┘  └─────────┘   └──────────┘  └──────────┘


💾 数据库设计


核心数据表


1. 用户表 (users)

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)

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)

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)

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)

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)

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)

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源代码

 后台管理系统源代码

 数据库初始化脚本


⚠️ 项目约束与风险


约束条件


时间限制：2个月内上线（2026-02-24）

资源限制：需客户方提供所需的各类资料

技术限制：不对接保险公司官方API


风险评估


风险类型
风险描述
应对策略
优先级


时间风险
开发周期较短，可能延期
分阶段迭代，优先核心功能，预留缓冲时间
高


需求变更
客户可能在开发过程中提出新需求
严格控制需求变更，变更需评估影响
中


技术风险
PDF信息提取、海报生成可能遇到技术难点
技术预研，准备备选方案
中


第三方依赖
腾讯元宝AI、七牛云等第三方服务稳定性
选择可靠的服务商，制定降级方案
中


安全风险
资料库内容外泄
严格权限控制，禁止下载，操作日志记录
高


审核风险
小程序审核可能不通过
仔细阅读审核规范，提前规避违规内容
高


🎯 验收标准


功能验收标准


计划书生成模块


 用户能成功提交计划书申请

 后台能正常接收和处理订单

 PDF文件能正常上传和预览

 订单状态能正常流转和更新

 消息推送能正常发送和接收


资料库模块


 管理员能正常上传和管理资料

 用户能在线查看资料，但无法下载

 搜索功能正常工作

 分类和标签功能正常


海报生成模块


 能从PDF提取关键信息

 能生成海报图片

 海报能正常分享


AI问答模块


 能与腾讯元宝AI正常交互

 能基于内部知识库回答问题


性能验收标准


小程序页面加载时间 < 2秒
API响应时间 < 1秒
视频播放秒开（使用CDN加速）
支持至少100个并发用户


安全验收标准


普通用户无法下载资料库文件
管理员权限严格控制
用户数据安全存储
操作日志完整记录


用户体验验收标准


界面简洁美观，操作便捷
错误提示友好
交互流畅，无明显卡顿
适配不同屏幕尺寸


📊 项目管理


沟通机制


日常沟通: 微信群/钉钉群

周报: 每周五提交项目进度报告

会议: 每周一进度同步会议


版本管理


代码仓库: Git

分支策略: git-flow


main: 生产环境

develop: 开发环境

feature/*: 功能分支

hotfix/*: 紧急修复分支


质量保证


代码审查: 所有代码提交前需经过审查

单元测试: 核心功能编写单元测试

集成测试: 每个阶段完成后进行集成测试

用户验收测试: 每个阶段完成后邀请客户参与验收测试


📝 待确认事项


业务确认


 产品列表及可选缴费年限

 资料分类结构是否满足需求

 用户权限角色划分（是否需要多级权限）


技术确认


 服务器配置（云服务商、规格）

 域名准备（小程序域名、后台管理域名）

 七牛云账号配置

 腾讯元宝AI账号配置

 微信小程序账号信息（AppID、AppSecret）


设计确认


 UI设计风格参考

 海报模板设计（3-5套）

 小程序logo和图标


资料准备


 初始产品数据

 初始资料库内容（入职相关、签单相关等）

 AI知识库初始内容


📞 联系方式


项目负责人: [待填写]

技术负责人: [待填写]

客户联系人: Candy


文档版本: v1.0
最后更新: 2026-01-27
文档状态: 待审核