删除废弃的API和架构文档
This commit is contained in:
741
docs/requirements/PRD.md
Normal file
741
docs/requirements/PRD.md
Normal file
@@ -0,0 +1,741 @@
|
||||
# 宁夏智慧养殖监管平台产品需求文档
|
||||
|
||||
## 版本历史
|
||||
|
||||
| 版本 | 日期 | 作者 | 描述 |
|
||||
|------|------|------|------|
|
||||
| v1.0 | 2025-01-18 | 产品经理 | 初始版本 |
|
||||
| v2.0 | 2025-01-19 | 产品经理 | 全面重构,增加多端支持 |
|
||||
|
||||
## 1. 项目概述
|
||||
|
||||
### 1.1 项目背景
|
||||
|
||||
宁夏回族自治区作为中国重要的畜牧业基地,养殖业在区域经济发展中占据重要地位。随着现代信息技术的快速发展和国家对食品安全、环境保护要求的不断提高,传统养殖业正面临数字化转型的迫切需求。
|
||||
|
||||
**行业痛点:**
|
||||
- 养殖过程缺乏有效监管,食品安全风险较高
|
||||
- 传统管理方式效率低下,数据记录不完整
|
||||
- 缺乏统一的信息化平台,各部门信息孤岛严重
|
||||
- 应急响应能力不足,疫情防控压力大
|
||||
- 金融保险服务与养殖业结合不够紧密
|
||||
|
||||
### 1.2 项目目标
|
||||
|
||||
**总体目标:** 构建一个现代化、智能化的养殖监管平台,实现养殖全过程数字化管理,提升监管效率,保障食品安全,促进产业升级。
|
||||
|
||||
**具体目标:**
|
||||
- 建立统一的养殖信息管理体系
|
||||
- 实现养殖环境实时监控和预警
|
||||
- 提供全程可追溯的养殖档案管理
|
||||
- 构建多部门协同的监管机制
|
||||
- 集成金融保险服务,支持产业发展
|
||||
|
||||
### 1.3 成功标准
|
||||
|
||||
**业务指标:**
|
||||
- 养殖场数字化覆盖率达到90%以上
|
||||
- 异常事件响应时间缩短至5分钟内
|
||||
- 养殖档案完整性达到95%以上
|
||||
- 用户满意度达到85%以上
|
||||
|
||||
**技术指标:**
|
||||
- 系统可用性达到99.9%
|
||||
- 接口响应时间小于500ms
|
||||
- 支持1000+并发用户访问
|
||||
- 数据准确性达到99.5%以上
|
||||
|
||||
### 1.4 范围界定
|
||||
|
||||
**本版本包含:**
|
||||
- 核心养殖监管平台(Web端)
|
||||
- 数据可视化大屏系统
|
||||
- 银行端小程序(金融服务)
|
||||
- 政府端小程序(监管服务)
|
||||
- 保险端小程序(保险服务)
|
||||
- 官方网站(信息展示)
|
||||
|
||||
**本版本不包含:**
|
||||
- 移动端原生APP(后续版本规划)
|
||||
- 人工智能预测分析(三期规划)
|
||||
- 区块链溯源功能(四期规划)
|
||||
- 国际化多语言支持(后续版本)
|
||||
|
||||
## 2. 用户角色与用例
|
||||
|
||||
### 2.1 用户角色定义
|
||||
|
||||
| 角色 | 描述 | 主要职责 | 权限范围 |
|
||||
|------|------|----------|----------|
|
||||
| **系统管理员** | 平台技术管理员 | 系统维护、用户管理、权限配置 | 全系统权限 |
|
||||
| **监管部门用户** | 政府监管人员 | 监管政策制定、数据审核、异常处理 | 监管数据查看、政策发布 |
|
||||
| **养殖场管理员** | 养殖场负责人 | 养殖场日常管理、数据录入、设备维护 | 本场数据管理权限 |
|
||||
| **养殖场员工** | 一线养殖人员 | 日常养殖操作、数据记录、设备操作 | 基础操作权限 |
|
||||
| **银行业务员** | 金融服务人员 | 贷款审批、风险评估、客户服务 | 金融数据查看权限 |
|
||||
| **保险专员** | 保险服务人员 | 保险承保、理赔处理、风险评估 | 保险相关数据权限 |
|
||||
| **技术支持** | 平台技术支持 | 系统维护、故障处理、用户培训 | 系统维护权限 |
|
||||
|
||||
### 2.2 核心用例场景
|
||||
|
||||
#### 2.2.1 养殖场管理场景
|
||||
**用例:** 新建养殖场档案
|
||||
- **参与者:** 养殖场管理员
|
||||
- **前置条件:** 用户已登录系统,具有养殖场管理权限
|
||||
- **主要流程:**
|
||||
1. 进入养殖场管理模块
|
||||
2. 填写基本信息(名称、地址、规模等)
|
||||
3. 上传相关证件和图片
|
||||
4. 设置地理围栏
|
||||
5. 配置设备信息
|
||||
6. 提交审核
|
||||
- **后置条件:** 养殖场档案创建成功,等待审核
|
||||
|
||||
#### 2.2.2 设备监控场景
|
||||
**用例:** 实时监控设备状态
|
||||
- **参与者:** 养殖场管理员、员工
|
||||
- **前置条件:** 设备已正常连接,用户有监控权限
|
||||
- **主要流程:**
|
||||
1. 进入设备监控界面
|
||||
2. 查看设备实时状态
|
||||
3. 接收异常告警
|
||||
4. 处理异常情况
|
||||
5. 记录处理结果
|
||||
- **后置条件:** 设备状态正常,异常已处理
|
||||
|
||||
#### 2.2.3 金融服务场景
|
||||
**用例:** 申请养殖贷款
|
||||
- **参与者:** 养殖场管理员、银行业务员
|
||||
- **前置条件:** 养殖场已认证,具备贷款条件
|
||||
- **主要流程:**
|
||||
1. 在银行小程序提交贷款申请
|
||||
2. 上传相关材料
|
||||
3. 系统自动评估风险
|
||||
4. 银行业务员审核
|
||||
5. 放款或拒绝
|
||||
- **后置条件:** 贷款申请处理完成
|
||||
|
||||
## 3. 功能需求
|
||||
|
||||
### 3.1 核心业务功能
|
||||
|
||||
#### 3.1.1 养殖场管理模块
|
||||
|
||||
**功能描述:** 提供养殖场全生命周期管理功能
|
||||
|
||||
**用户故事:**
|
||||
- As a 养殖场管理员, I want to 创建和管理养殖场档案, so that 可以规范化管理养殖场信息
|
||||
- As a 监管人员, I want to 查看和审核养殖场信息, so that 确保养殖场符合监管要求
|
||||
- As a 系统管理员, I want to 统计养殖场数据, so that 为决策提供数据支持
|
||||
|
||||
**验收标准:**
|
||||
```gherkin
|
||||
Given 用户是养殖场管理员
|
||||
When 用户填写完整的养殖场信息并提交
|
||||
Then 系统应该创建养殖场档案并生成唯一编号
|
||||
And 系统应该发送审核通知给监管人员
|
||||
And 养殖场状态应该设置为"待审核"
|
||||
```
|
||||
|
||||
**详细功能点:**
|
||||
- 养殖场基本信息管理(名称、地址、规模、类型等)
|
||||
- 证件管理(营业执照、养殖许可证等)
|
||||
- 地理位置标注和电子围栏设置
|
||||
- 圈舍信息管理(数量、面积、容量等)
|
||||
- 养殖场图片和视频管理
|
||||
- 审核流程管理(提交、审核、通过、拒绝)
|
||||
|
||||
#### 3.1.2 动物健康管理模块
|
||||
|
||||
**功能描述:** 提供动物全生命周期健康管理
|
||||
|
||||
**用户故事:**
|
||||
- As a 养殖场员工, I want to 记录动物健康信息, so that 及时发现和处理健康问题
|
||||
- As a 兽医, I want to 查看动物健康历史, so that 制定合适的治疗方案
|
||||
- As a 监管人员, I want to 监控疫情风险, so that 及时采取防控措施
|
||||
|
||||
**验收标准:**
|
||||
```gherkin
|
||||
Given 用户是养殖场员工
|
||||
When 用户录入动物健康检查数据
|
||||
Then 系统应该保存健康记录
|
||||
And 如果发现异常指标,系统应该自动生成告警
|
||||
And 系统应该更新动物健康状态
|
||||
```
|
||||
|
||||
**详细功能点:**
|
||||
- 动物档案管理(品种、年龄、来源、标识等)
|
||||
- 健康检查记录(体温、体重、食欲等)
|
||||
- 疫苗接种管理(疫苗类型、接种时间、有效期等)
|
||||
- 疾病诊疗记录(症状、诊断、治疗方案等)
|
||||
- 批次管理(进场、转移、出场记录)
|
||||
- 死亡和淘汰记录管理
|
||||
|
||||
#### 3.1.3 IoT设备监控模块
|
||||
|
||||
**功能描述:** 实时监控养殖环境和设备状态
|
||||
|
||||
**用户故事:**
|
||||
- As a 养殖场管理员, I want to 实时查看环境数据, so that 及时调整养殖环境
|
||||
- As a 设备维护员, I want to 监控设备运行状态, so that 预防设备故障
|
||||
- As a 系统管理员, I want to 管理设备配置, so that 确保监控系统正常运行
|
||||
|
||||
**验收标准:**
|
||||
```gherkin
|
||||
Given 设备已正常连接到系统
|
||||
When 设备传感器检测到异常数据
|
||||
Then 系统应该立即生成告警
|
||||
And 系统应该通知相关责任人
|
||||
And 系统应该记录异常事件
|
||||
```
|
||||
|
||||
**详细功能点:**
|
||||
- 环境监测(温度、湿度、氨气、二氧化碳等)
|
||||
- 设备状态监控(在线状态、运行参数、故障信息)
|
||||
- 实时数据展示(图表、仪表盘、趋势分析)
|
||||
- 告警管理(阈值设置、告警规则、通知方式)
|
||||
- 历史数据查询和分析
|
||||
- 设备远程控制(开关、参数调节等)
|
||||
|
||||
#### 3.1.4 数据可视化模块
|
||||
|
||||
**功能描述:** 提供丰富的数据分析和可视化功能
|
||||
|
||||
**用户故事:**
|
||||
- As a 管理者, I want to 查看数据统计报表, so that 了解养殖场运营状况
|
||||
- As a 决策者, I want to 分析趋势数据, so that 制定科学的管理策略
|
||||
- As a 监管人员, I want to 监控区域数据, so that 掌握整体监管情况
|
||||
|
||||
**验收标准:**
|
||||
```gherkin
|
||||
Given 用户有数据查看权限
|
||||
When 用户选择查看统计报表
|
||||
Then 系统应该展示相应的图表和数据
|
||||
And 数据应该实时更新
|
||||
And 用户应该能够导出报表
|
||||
```
|
||||
|
||||
**详细功能点:**
|
||||
- 实时数据大屏展示
|
||||
- 统计报表生成(日报、周报、月报)
|
||||
- 趋势分析图表(折线图、柱状图、饼图等)
|
||||
- 地图可视化(养殖场分布、区域统计)
|
||||
- 数据导出功能(Excel、PDF、图片)
|
||||
- 自定义报表配置
|
||||
|
||||
### 3.2 多端应用功能
|
||||
|
||||
#### 3.2.1 银行端小程序
|
||||
|
||||
**功能描述:** 为银行提供养殖业金融服务支持
|
||||
|
||||
**核心功能:**
|
||||
- 客户信息管理和风险评估
|
||||
- 贷款申请和审批流程
|
||||
- 还款管理和逾期提醒
|
||||
- 养殖数据查看和分析
|
||||
- 金融产品推荐
|
||||
|
||||
**用户故事:**
|
||||
- As a 银行业务员, I want to 查看客户养殖数据, so that 评估贷款风险
|
||||
- As a 养殖场主, I want to 在线申请贷款, so that 快速获得资金支持
|
||||
|
||||
#### 3.2.2 政府端小程序
|
||||
|
||||
**功能描述:** 为政府监管部门提供移动监管工具
|
||||
|
||||
**核心功能:**
|
||||
- 养殖场监管和检查记录
|
||||
- 政策发布和通知推送
|
||||
- 应急事件处理和上报
|
||||
- 统计数据查看和分析
|
||||
- 证件审批和管理
|
||||
|
||||
**用户故事:**
|
||||
- As a 监管人员, I want to 移动端查看监管数据, so that 随时掌握监管情况
|
||||
- As a 政策制定者, I want to 发布政策通知, so that 及时传达政策信息
|
||||
|
||||
#### 3.2.3 保险端小程序
|
||||
|
||||
**功能描述:** 为保险公司提供养殖保险服务支持
|
||||
|
||||
**核心功能:**
|
||||
- 保险产品展示和销售
|
||||
- 投保申请和承保管理
|
||||
- 理赔申请和处理流程
|
||||
- 风险评估和定价
|
||||
- 客户服务和咨询
|
||||
|
||||
**用户故事:**
|
||||
- As a 保险专员, I want to 评估养殖风险, so that 制定合理的保险方案
|
||||
- As a 养殖场主, I want to 在线申请理赔, so that 快速获得理赔服务
|
||||
|
||||
## 4. 非功能需求
|
||||
|
||||
### 4.1 性能需求
|
||||
|
||||
**响应时间要求:**
|
||||
- 页面加载时间:≤ 3秒
|
||||
- API接口响应时间:≤ 500ms
|
||||
- 数据库查询时间:≤ 200ms
|
||||
- 大屏数据刷新间隔:≤ 5秒
|
||||
|
||||
**并发性能要求:**
|
||||
- 支持1000+并发用户访问
|
||||
- 支持10000+设备同时在线
|
||||
- 支持100万+历史数据查询
|
||||
- 峰值QPS:1000+
|
||||
|
||||
**吞吐量要求:**
|
||||
- 数据处理能力:10000条/秒
|
||||
- 文件上传速度:≥ 1MB/s
|
||||
- 数据导出速度:≥ 500KB/s
|
||||
|
||||
### 4.2 可靠性需求
|
||||
|
||||
**可用性要求:**
|
||||
- 系统可用性:99.9%
|
||||
- 计划内停机时间:≤ 4小时/月
|
||||
- 故障恢复时间:≤ 30分钟
|
||||
- 数据备份频率:每日备份
|
||||
|
||||
**容错性要求:**
|
||||
- 支持服务降级和熔断
|
||||
- 支持数据库主从切换
|
||||
- 支持负载均衡和故障转移
|
||||
- 支持异常情况下的数据恢复
|
||||
|
||||
### 4.3 安全性需求
|
||||
|
||||
**身份认证:**
|
||||
- 支持多因子认证(MFA)
|
||||
- 密码复杂度要求
|
||||
- 登录失败锁定机制
|
||||
- 会话超时管理
|
||||
|
||||
**数据安全:**
|
||||
- 敏感数据加密存储
|
||||
- 数据传输加密(HTTPS/TLS)
|
||||
- 数据访问权限控制
|
||||
- 数据脱敏和匿名化
|
||||
|
||||
**系统安全:**
|
||||
- SQL注入防护
|
||||
- XSS攻击防护
|
||||
- CSRF攻击防护
|
||||
- API访问频率限制
|
||||
|
||||
### 4.4 可扩展性需求
|
||||
|
||||
**水平扩展:**
|
||||
- 支持微服务架构改造
|
||||
- 支持容器化部署
|
||||
- 支持云原生架构
|
||||
- 支持多数据中心部署
|
||||
|
||||
**功能扩展:**
|
||||
- 支持插件化架构
|
||||
- 支持第三方系统集成
|
||||
- 支持多租户模式
|
||||
- 支持国际化扩展
|
||||
|
||||
## 5. 技术约束
|
||||
|
||||
### 5.1 技术栈要求
|
||||
|
||||
**后端技术栈:**
|
||||
- 运行环境:Node.js 16.20.2+
|
||||
- Web框架:Express.js 4.18+
|
||||
- 数据库:MySQL 8.0+
|
||||
- ORM框架:Sequelize 6.0+
|
||||
- 缓存:Redis 6.0+
|
||||
|
||||
**前端技术栈:**
|
||||
- 框架:Vue 3.4+ + Vite
|
||||
- UI组件库:Ant Design Vue 4.0+
|
||||
- 状态管理:Pinia 2.1+
|
||||
- 图表库:ECharts 5.4+
|
||||
- 地图服务:百度地图API
|
||||
|
||||
**小程序技术栈:**
|
||||
- 框架:uni-app 3.0+
|
||||
- UI组件库:uni-ui
|
||||
- 状态管理:Pinia
|
||||
- HTTP客户端:uni.request
|
||||
|
||||
### 5.2 部署环境要求
|
||||
|
||||
**硬件要求:**
|
||||
- CPU:8核心以上
|
||||
- 内存:16GB以上
|
||||
- 存储:500GB SSD以上
|
||||
- 网络:千兆网络
|
||||
|
||||
**软件环境:**
|
||||
- 操作系统:Ubuntu 20.04 LTS / CentOS 8
|
||||
- 容器:Docker 20.10+
|
||||
- 反向代理:Nginx 1.20+
|
||||
- 进程管理:PM2 5.0+
|
||||
|
||||
### 5.3 第三方服务依赖
|
||||
|
||||
**地图服务:**
|
||||
- 百度地图API(主要)
|
||||
- 高德地图API(备用)
|
||||
|
||||
**消息推送:**
|
||||
- 微信公众号推送
|
||||
- 短信服务(阿里云)
|
||||
- 邮件服务(腾讯企业邮)
|
||||
|
||||
**文件存储:**
|
||||
- 阿里云OSS(主要)
|
||||
- 腾讯云COS(备用)
|
||||
|
||||
## 6. 数据模型设计
|
||||
|
||||
### 6.1 核心实体关系
|
||||
|
||||
```mermaid
|
||||
erDiagram
|
||||
Farm ||--o{ Animal : contains
|
||||
Farm ||--o{ Device : has
|
||||
Farm ||--o{ Pen : includes
|
||||
Farm ||--o{ User : manages
|
||||
Animal }o--|| CattleType : belongs_to
|
||||
Animal }o--|| CattleBatch : belongs_to
|
||||
Device ||--o{ SensorData : generates
|
||||
Device ||--o{ Alert : triggers
|
||||
User }o--|| Role : has
|
||||
Order ||--o{ OrderItem : contains
|
||||
Product ||--o{ OrderItem : includes
|
||||
```
|
||||
|
||||
### 6.2 主要数据表
|
||||
|
||||
#### 6.2.1 养殖场表 (farms)
|
||||
| 字段名 | 类型 | 长度 | 必填 | 说明 |
|
||||
|--------|------|------|------|------|
|
||||
| id | INT | - | 是 | 主键ID |
|
||||
| name | VARCHAR | 100 | 是 | 养殖场名称 |
|
||||
| address | VARCHAR | 200 | 是 | 详细地址 |
|
||||
| latitude | DECIMAL | 10,8 | 否 | 纬度 |
|
||||
| longitude | DECIMAL | 11,8 | 否 | 经度 |
|
||||
| scale | ENUM | - | 是 | 规模(小型/中型/大型) |
|
||||
| type | VARCHAR | 50 | 是 | 养殖类型 |
|
||||
| status | ENUM | - | 是 | 状态(正常/停用/审核中) |
|
||||
| created_at | TIMESTAMP | - | 是 | 创建时间 |
|
||||
| updated_at | TIMESTAMP | - | 是 | 更新时间 |
|
||||
|
||||
#### 6.2.2 动物表 (animals)
|
||||
| 字段名 | 类型 | 长度 | 必填 | 说明 |
|
||||
|--------|------|------|------|------|
|
||||
| id | INT | - | 是 | 主键ID |
|
||||
| farm_id | INT | - | 是 | 养殖场ID |
|
||||
| ear_tag | VARCHAR | 50 | 是 | 耳标号 |
|
||||
| breed | VARCHAR | 50 | 是 | 品种 |
|
||||
| gender | ENUM | - | 是 | 性别 |
|
||||
| birth_date | DATE | - | 否 | 出生日期 |
|
||||
| weight | DECIMAL | 8,2 | 否 | 体重(kg) |
|
||||
| health_status | ENUM | - | 是 | 健康状态 |
|
||||
| created_at | TIMESTAMP | - | 是 | 创建时间 |
|
||||
| updated_at | TIMESTAMP | - | 是 | 更新时间 |
|
||||
|
||||
#### 6.2.3 设备表 (devices)
|
||||
| 字段名 | 类型 | 长度 | 必填 | 说明 |
|
||||
|--------|------|------|------|------|
|
||||
| id | INT | - | 是 | 主键ID |
|
||||
| farm_id | INT | - | 是 | 养殖场ID |
|
||||
| device_id | VARCHAR | 100 | 是 | 设备编号 |
|
||||
| device_name | VARCHAR | 100 | 是 | 设备名称 |
|
||||
| device_type | VARCHAR | 50 | 是 | 设备类型 |
|
||||
| location | VARCHAR | 100 | 否 | 安装位置 |
|
||||
| status | ENUM | - | 是 | 设备状态 |
|
||||
| last_online | TIMESTAMP | - | 否 | 最后在线时间 |
|
||||
| created_at | TIMESTAMP | - | 是 | 创建时间 |
|
||||
| updated_at | TIMESTAMP | - | 是 | 更新时间 |
|
||||
|
||||
## 7. API设计规范
|
||||
|
||||
### 7.1 API设计原则
|
||||
|
||||
**RESTful设计:**
|
||||
- 使用标准HTTP方法(GET、POST、PUT、DELETE)
|
||||
- 资源导向的URL设计
|
||||
- 统一的响应格式
|
||||
- 合理的HTTP状态码使用
|
||||
|
||||
**版本控制:**
|
||||
- URL路径版本控制:`/api/v1/`
|
||||
- 向后兼容性保证
|
||||
- 版本废弃通知机制
|
||||
|
||||
**安全性:**
|
||||
- JWT Token认证
|
||||
- API访问频率限制
|
||||
- 请求参数验证
|
||||
- 响应数据脱敏
|
||||
|
||||
### 7.2 核心API接口
|
||||
|
||||
#### 7.2.1 认证相关API
|
||||
```
|
||||
POST /api/v1/auth/login # 用户登录
|
||||
POST /api/v1/auth/logout # 用户登出
|
||||
POST /api/v1/auth/refresh # 刷新Token
|
||||
GET /api/v1/auth/profile # 获取用户信息
|
||||
PUT /api/v1/auth/profile # 更新用户信息
|
||||
POST /api/v1/auth/change-password # 修改密码
|
||||
```
|
||||
|
||||
#### 7.2.2 养殖场管理API
|
||||
```
|
||||
GET /api/v1/farms # 获取养殖场列表
|
||||
GET /api/v1/farms/{id} # 获取养殖场详情
|
||||
POST /api/v1/farms # 创建养殖场
|
||||
PUT /api/v1/farms/{id} # 更新养殖场信息
|
||||
DELETE /api/v1/farms/{id} # 删除养殖场
|
||||
GET /api/v1/farms/{id}/stats # 获取养殖场统计数据
|
||||
```
|
||||
|
||||
#### 7.2.3 动物管理API
|
||||
```
|
||||
GET /api/v1/animals # 获取动物列表
|
||||
GET /api/v1/animals/{id} # 获取动物详情
|
||||
POST /api/v1/animals # 添加动物
|
||||
PUT /api/v1/animals/{id} # 更新动物信息
|
||||
DELETE /api/v1/animals/{id} # 删除动物记录
|
||||
GET /api/v1/animals/{id}/health # 获取健康记录
|
||||
POST /api/v1/animals/{id}/health # 添加健康记录
|
||||
```
|
||||
|
||||
#### 7.2.4 设备监控API
|
||||
```
|
||||
GET /api/v1/devices # 获取设备列表
|
||||
GET /api/v1/devices/{id} # 获取设备详情
|
||||
POST /api/v1/devices # 添加设备
|
||||
PUT /api/v1/devices/{id} # 更新设备信息
|
||||
DELETE /api/v1/devices/{id} # 删除设备
|
||||
GET /api/v1/devices/{id}/data # 获取设备数据
|
||||
POST /api/v1/devices/{id}/control # 设备控制
|
||||
```
|
||||
|
||||
### 7.3 响应格式规范
|
||||
|
||||
**成功响应格式:**
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "success",
|
||||
"data": {
|
||||
// 具体数据内容
|
||||
},
|
||||
"timestamp": "2025-01-19T10:00:00Z"
|
||||
}
|
||||
```
|
||||
|
||||
**错误响应格式:**
|
||||
```json
|
||||
{
|
||||
"code": 400,
|
||||
"message": "参数错误",
|
||||
"error": {
|
||||
"type": "VALIDATION_ERROR",
|
||||
"details": [
|
||||
{
|
||||
"field": "name",
|
||||
"message": "名称不能为空"
|
||||
}
|
||||
]
|
||||
},
|
||||
"timestamp": "2025-01-19T10:00:00Z"
|
||||
}
|
||||
```
|
||||
|
||||
**分页响应格式:**
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "success",
|
||||
"data": {
|
||||
"items": [],
|
||||
"pagination": {
|
||||
"page": 1,
|
||||
"pageSize": 20,
|
||||
"total": 100,
|
||||
"totalPages": 5
|
||||
}
|
||||
},
|
||||
"timestamp": "2025-01-19T10:00:00Z"
|
||||
}
|
||||
```
|
||||
|
||||
## 8. 用户界面设计要求
|
||||
|
||||
### 8.1 设计原则
|
||||
|
||||
**用户体验原则:**
|
||||
- 简洁直观的界面设计
|
||||
- 一致的交互体验
|
||||
- 快速响应的操作反馈
|
||||
- 友好的错误提示
|
||||
|
||||
**可访问性原则:**
|
||||
- 支持键盘导航
|
||||
- 合理的颜色对比度
|
||||
- 清晰的文字大小
|
||||
- 响应式设计适配
|
||||
|
||||
### 8.2 界面布局要求
|
||||
|
||||
**管理后台布局:**
|
||||
- 左侧导航菜单
|
||||
- 顶部用户信息栏
|
||||
- 主内容区域
|
||||
- 底部状态栏
|
||||
|
||||
**数据大屏布局:**
|
||||
- 全屏显示模式
|
||||
- 多区域数据展示
|
||||
- 实时数据更新
|
||||
- 自适应屏幕尺寸
|
||||
|
||||
**小程序界面:**
|
||||
- 底部Tab导航
|
||||
- 顶部标题栏
|
||||
- 主内容滚动区域
|
||||
- 浮动操作按钮
|
||||
|
||||
### 8.3 交互设计要求
|
||||
|
||||
**操作反馈:**
|
||||
- 加载状态提示
|
||||
- 操作成功/失败提示
|
||||
- 确认对话框
|
||||
- 进度条显示
|
||||
|
||||
**数据展示:**
|
||||
- 表格分页和排序
|
||||
- 图表交互和筛选
|
||||
- 搜索和过滤功能
|
||||
- 数据导出功能
|
||||
|
||||
## 9. 测试要求
|
||||
|
||||
### 9.1 测试策略
|
||||
|
||||
**测试类型:**
|
||||
- 单元测试:覆盖率≥80%
|
||||
- 集成测试:API接口测试
|
||||
- 系统测试:端到端功能测试
|
||||
- 性能测试:负载和压力测试
|
||||
- 安全测试:漏洞扫描和渗透测试
|
||||
|
||||
**测试环境:**
|
||||
- 开发环境:开发人员自测
|
||||
- 测试环境:QA团队测试
|
||||
- 预生产环境:用户验收测试
|
||||
- 生产环境:监控和回归测试
|
||||
|
||||
### 9.2 测试用例要求
|
||||
|
||||
**功能测试用例:**
|
||||
- 正常流程测试
|
||||
- 异常流程测试
|
||||
- 边界值测试
|
||||
- 兼容性测试
|
||||
|
||||
**性能测试用例:**
|
||||
- 响应时间测试
|
||||
- 并发用户测试
|
||||
- 数据量测试
|
||||
- 资源使用测试
|
||||
|
||||
## 10. 部署和运维要求
|
||||
|
||||
### 10.1 部署架构
|
||||
|
||||
**生产环境架构:**
|
||||
- 负载均衡器:Nginx
|
||||
- 应用服务器:Node.js集群
|
||||
- 数据库:MySQL主从架构
|
||||
- 缓存:Redis集群
|
||||
- 文件存储:云存储服务
|
||||
|
||||
**容器化部署:**
|
||||
- Docker容器化
|
||||
- Docker Compose编排
|
||||
- Kubernetes集群管理(可选)
|
||||
|
||||
### 10.2 监控和运维
|
||||
|
||||
**系统监控:**
|
||||
- 服务器资源监控
|
||||
- 应用性能监控
|
||||
- 数据库性能监控
|
||||
- 网络状态监控
|
||||
|
||||
**日志管理:**
|
||||
- 应用日志收集
|
||||
- 错误日志告警
|
||||
- 访问日志分析
|
||||
- 审计日志记录
|
||||
|
||||
**备份策略:**
|
||||
- 数据库定时备份
|
||||
- 文件定时备份
|
||||
- 配置文件备份
|
||||
- 灾难恢复预案
|
||||
|
||||
## 11. 项目里程碑
|
||||
|
||||
### 11.1 开发计划
|
||||
|
||||
| 阶段 | 时间节点 | 交付物 | 负责人 |
|
||||
|------|----------|--------|--------|
|
||||
| 需求确认 | 2025-01-25 | 需求规格说明书 | 产品经理 |
|
||||
| 架构设计 | 2025-02-05 | 技术架构文档 | 架构师 |
|
||||
| 数据库设计 | 2025-02-10 | 数据库设计文档 | 数据库工程师 |
|
||||
| 后端开发 | 2025-03-15 | 后端API服务 | 后端团队 |
|
||||
| 前端开发 | 2025-03-20 | 前端管理界面 | 前端团队 |
|
||||
| 小程序开发 | 2025-03-25 | 三端小程序 | 小程序团队 |
|
||||
| 集成测试 | 2025-04-05 | 测试报告 | 测试团队 |
|
||||
| 用户验收 | 2025-04-15 | 验收报告 | 产品经理 |
|
||||
| 上线部署 | 2025-04-20 | 生产环境 | 运维团队 |
|
||||
|
||||
### 11.2 风险管控
|
||||
|
||||
**技术风险:**
|
||||
- 第三方API服务不稳定
|
||||
- 数据库性能瓶颈
|
||||
- 前端兼容性问题
|
||||
- 小程序审核风险
|
||||
|
||||
**业务风险:**
|
||||
- 需求变更频繁
|
||||
- 用户接受度不高
|
||||
- 竞品冲击
|
||||
- 政策法规变化
|
||||
|
||||
**项目风险:**
|
||||
- 人员流动
|
||||
- 进度延期
|
||||
- 质量问题
|
||||
- 预算超支
|
||||
|
||||
**应对措施:**
|
||||
- 制定详细的风险应对预案
|
||||
- 建立风险监控机制
|
||||
- 定期进行风险评估
|
||||
- 及时调整项目计划
|
||||
|
||||
---
|
||||
|
||||
**文档维护说明:**
|
||||
- 本文档将根据项目进展定期更新
|
||||
- 所有变更需经过评审和批准
|
||||
- 文档版本控制采用Git管理
|
||||
- 相关干系人需及时同步文档变更
|
||||
|
||||
*最后更新时间:2025-01-19*
|
||||
*文档版本:v2.0*
|
||||
*维护人员:产品经理*
|
||||
536
docs/requirements/official-website-prd.md
Normal file
536
docs/requirements/official-website-prd.md
Normal file
@@ -0,0 +1,536 @@
|
||||
# 宁夏智慧养殖监管平台官网产品需求文档
|
||||
|
||||
## 版本历史
|
||||
| 版本 | 日期 | 作者 | 描述 |
|
||||
|------|------|------|------|
|
||||
| v1.2 | 2025-01-19 | 产品经理 | 增加养殖管理系统、银行监管系统、保险监管系统、政府监管系统入口需求 |
|
||||
| v1.1 | 2025-01-19 | 产品经理 | 增加小程序二维码入口需求 |
|
||||
| v1.0 | 2025-01-18 | 产品经理 | 初版PRD文档创建 |
|
||||
|
||||
## 1. 项目概述
|
||||
|
||||
### 1.1 项目背景
|
||||
宁夏智慧养殖监管平台是面向宁夏回族自治区养殖产业的数字化管理平台,官网作为平台对外的形象展示窗口,需要全面展示平台价值、功能特性和技术优势。
|
||||
|
||||
### 1.2 项目目标
|
||||
- **品牌展示**:建立专业、可信的品牌形象
|
||||
- **用户获取**:通过官网吸引潜在用户注册使用
|
||||
- **产品推广**:提供产品介绍和下载服务
|
||||
- **信息传递**:向合作伙伴和监管机构传达平台价值
|
||||
|
||||
### 1.3 成功标准
|
||||
- 官网访问量每月达到10,000+ PV
|
||||
- 用户注册转化率提升至5%
|
||||
- 产品下载量每月达到500+
|
||||
- 品牌认知度在目标用户中达到80%
|
||||
|
||||
### 1.4 范围界定
|
||||
**本版本包含:**
|
||||
- 静态内容展示页面
|
||||
- 响应式HTML5+Bootstrap设计
|
||||
- 品牌形象展示功能
|
||||
- 用户注册入口
|
||||
- 产品下载功能
|
||||
|
||||
**本版本不包含:**
|
||||
- 动态交互功能
|
||||
- 用户登录系统
|
||||
- 在线支付功能
|
||||
- 后台管理系统集成
|
||||
|
||||
## 2. 用户角色与用例
|
||||
|
||||
### 2.1 用户角色
|
||||
| 角色 | 描述 | 核心需求 |
|
||||
|------|------|----------|
|
||||
| 养殖企业用户 | 养殖场主、养殖技术人员 | 使用养殖管理系统进行生产管理、监控养殖数据 |
|
||||
| 银行人员 | 金融机构信贷风险管理人员 | 使用银行监管系统进行信贷风险评估、监控抵押物 |
|
||||
| 保险公司人员 | 保险业务员、理赔专员 | 使用保险监管系统进行养殖保险业务管理、理赔处理 |
|
||||
| 政府监管官员 | 农业部门、畜牧监管部门官员 | 使用政府监管系统进行行业监管、政策执行监督 |
|
||||
| 潜在客户 | 寻求养殖管理解决方案的用户 | 了解产品功能、查看案例、获取联系方式 |
|
||||
| 现有用户 | 已使用平台的用户 | 获取最新资讯、下载更新版本 |
|
||||
| 合作伙伴 | 设备厂商、技术服务商 | 了解合作机会、查看技术文档 |
|
||||
| 监管机构 | 政府监管部门 | 了解平台合规性、监管功能 |
|
||||
|
||||
### 2.2 核心用例
|
||||
|
||||
#### 用例1:了解平台功能
|
||||
**As a** 潜在客户
|
||||
**I want to** 浏览平台功能介绍
|
||||
**So that** 我可以评估是否满足需求
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户访问官网首页
|
||||
- When 点击功能介绍板块
|
||||
- Then 显示详细的功能特性说明
|
||||
- And 包含图文并茂的展示
|
||||
|
||||
#### 用例2:用户注册
|
||||
**As a** 新用户
|
||||
**I want to** 注册平台账号
|
||||
**So that** 我可以开始使用平台服务
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户找到注册入口
|
||||
- When 填写注册信息并提交
|
||||
- Then 显示注册成功提示
|
||||
- And 跳转到登录页面
|
||||
|
||||
#### 用例3:产品下载
|
||||
**As a** 用户
|
||||
**I want to** 下载平台客户端
|
||||
**So that** 我可以在本地安装使用
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入下载页面
|
||||
- When 选择适合的版本
|
||||
- Then 开始下载安装包
|
||||
- And 提供详细的安装说明
|
||||
|
||||
## 3. 功能需求
|
||||
|
||||
### 3.1 首页模块
|
||||
|
||||
#### 3.1.1 品牌展示
|
||||
**用户故事:** As a 访问者,I want to 第一眼看到专业的品牌形象,so that 我对平台产生信任感
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户打开官网
|
||||
- Then 显示平台logo和slogan
|
||||
- And 设计风格专业严谨
|
||||
- And 体现现代科技感
|
||||
- And 融入农业特色元素
|
||||
|
||||
#### 3.1.2 导航菜单
|
||||
**用户故事:** As a 用户,I want to 快速找到需要的板块,so that 我可以高效浏览网站
|
||||
|
||||
**验收标准:**
|
||||
- Given 页面加载完成
|
||||
- Then 显示清晰的导航菜单
|
||||
- And 包含所有主要板块链接
|
||||
- And 支持平滑滚动到对应位置
|
||||
|
||||
### 3.2 产品介绍模块
|
||||
|
||||
#### 3.2.1 平台概述
|
||||
**用户故事:** As a 潜在客户,I want to 了解平台的整体概况,so that 我能够快速理解平台价值
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入产品介绍页面
|
||||
- Then 显示平台定位和使命
|
||||
- And 包含核心价值主张
|
||||
- And 使用图文结合的方式展示
|
||||
|
||||
#### 3.2.2 功能特性
|
||||
**用户故事:** As a 技术决策者,I want to 详细了解平台功能,so that 我可以评估技术匹配度
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户查看功能特性板块
|
||||
- Then 分类展示各项功能(监控、管理、分析等)
|
||||
- And 每个功能有详细说明和示意图
|
||||
- And 突出技术优势和创新点
|
||||
|
||||
### 3.3 技术优势模块
|
||||
|
||||
#### 3.3.1 技术架构
|
||||
**用户故事:** As a 技术人员,I want to 了解平台的技术架构,so that 我可以评估技术可靠性
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入技术优势页面
|
||||
- Then 展示技术栈和架构图
|
||||
- And 说明技术选型理由
|
||||
- And 突出性能和安全优势
|
||||
|
||||
#### 3.3.2 创新亮点
|
||||
**用户故事:** As a 行业专家,I want to 了解平台的技术创新,so that 我可以认可平台的技术实力
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户浏览创新亮点
|
||||
- Then 展示核心技术专利
|
||||
- And 说明技术创新点
|
||||
- And 提供技术白皮书链接
|
||||
|
||||
### 3.4 客户案例模块
|
||||
|
||||
#### 3.4.1 成功案例
|
||||
**用户故事:** As a 潜在客户,I want to 查看成功案例,so that 我可以参考其他用户的实施效果
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入案例页面
|
||||
- Then 展示真实的客户案例
|
||||
- And 包含客户背景和挑战
|
||||
- And 说明解决方案和成果
|
||||
- And 提供客户评价和数据指标
|
||||
|
||||
#### 3.4.2 行业应用
|
||||
**用户故事:** As a 行业用户,I want to 了解在特定行业的应用,so that 我可以看到相关参考
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户查看行业应用
|
||||
- Then 按行业分类展示案例
|
||||
- And 突出行业特色解决方案
|
||||
- And 包含规模化养殖、散养等不同模式
|
||||
|
||||
### 3.5 新闻动态模块
|
||||
|
||||
#### 3.5.1 公司新闻
|
||||
**用户故事:** As a 关注者,I want to 了解公司最新动态,so that 我可以掌握平台发展情况
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入新闻页面
|
||||
- Then 按时间倒序展示新闻列表
|
||||
- And 包含标题、摘要、发布时间
|
||||
- And 支持分页浏览
|
||||
|
||||
#### 3.5.2 行业资讯
|
||||
**用户故事:** As a 行业从业者,I want to 获取行业相关资讯,so that 我可以了解行业趋势
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户查看行业资讯
|
||||
- Then 展示养殖行业相关新闻
|
||||
- And 包含政策解读、技术动态
|
||||
- And 提供有价值的行业信息
|
||||
|
||||
### 3.6 联系方式模块
|
||||
|
||||
#### 3.6.1 联系信息
|
||||
**用户故事:** As a 意向客户,I want to 找到联系方式,so that 我可以咨询或合作
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入联系页面
|
||||
- Then 显示完整的联系信息
|
||||
- And 包含地址、电话、邮箱
|
||||
- And 提供在线留言表单
|
||||
|
||||
#### 3.6.2 地图定位
|
||||
**用户故事:** As a 访客,I want to 查看公司位置,so that 我可以方便来访
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户查看公司地址
|
||||
- Then 显示地图定位
|
||||
- And 标注具体位置
|
||||
- And 提供导航指引
|
||||
|
||||
### 3.7 用户注册模块
|
||||
|
||||
#### 3.7.1 注册表单
|
||||
**用户故事:** As a 新用户,I want to 快速完成注册,so that 我可以开始使用平台
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入注册页面
|
||||
- Then 显示简洁的注册表单
|
||||
- And 包含必填字段验证
|
||||
- And 提供注册协议链接
|
||||
|
||||
#### 3.7.2 注册成功
|
||||
**用户故事:** As a 用户,I want to 确认注册成功,so that 我知道下一步该做什么
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户提交注册信息
|
||||
- Then 显示注册成功提示
|
||||
- And 提供登录指引
|
||||
- And 发送欢迎邮件
|
||||
|
||||
### 3.8 下载中心模块
|
||||
|
||||
#### 3.8.1 版本选择
|
||||
**用户故事:** As a 用户,I want to 选择适合的版本下载,so that 我可以获得正确的安装包
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入下载页面
|
||||
- Then 清晰区分不同版本
|
||||
- And 说明版本特性和系统要求
|
||||
- And 提供版本更新说明
|
||||
|
||||
#### 3.8.2 下载流程
|
||||
**用户故事:** As a 下载者,I want to 顺利下载安装包,so that 我可以安装使用
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户选择下载版本
|
||||
- Then 开始下载文件
|
||||
- And 显示下载进度
|
||||
- And 提供安装指南链接
|
||||
|
||||
### 3.9 多系统入口模块
|
||||
|
||||
#### 3.9.1 养殖管理系统入口
|
||||
**用户故事:** As a 养殖企业用户,I want to 快速访问养殖管理系统,so that 我可以进行养殖生产管理和数据监控
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户访问官网首页
|
||||
- Then 在功能区显示养殖管理系统入口
|
||||
- And 提供系统功能简介和核心价值
|
||||
- And 点击后跳转到 ad.ningmuyun.com 养殖管理系统
|
||||
- And 入口设计体现养殖行业特色
|
||||
|
||||
#### 3.9.2 银行监管系统入口
|
||||
**用户故事:** As a 银行人员,I want to 快速访问银行监管系统,so that 我可以进行信贷风险评估和抵押物监控
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户访问官网首页
|
||||
- Then 在功能区显示银行监管系统入口
|
||||
- And 提供系统功能简介和核心价值
|
||||
- And 点击后跳转到 ad.ningmuyun.com 银行监管系统
|
||||
- And 入口设计体现金融行业特色
|
||||
|
||||
#### 3.9.3 保险监管系统入口
|
||||
**用户故事:** As a 保险公司人员,I want to 快速访问保险监管系统,so that 我可以进行养殖保险业务管理和理赔处理
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户访问官网首页
|
||||
- Then 在功能区显示保险监管系统入口
|
||||
- And 提供系统功能简介和核心价值
|
||||
- And 点击后跳转到 ad.ningmuyun.com 保险监管系统
|
||||
- And 入口设计体现保险行业特色
|
||||
|
||||
#### 3.9.4 政府监管系统入口
|
||||
**用户故事:** As a 政府监管官员,I want to 快速访问政府监管系统,so that 我可以进行行业监管和政策执行监督
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户访问官网首页
|
||||
- Then 在功能区显示政府监管系统入口
|
||||
- And 提供系统功能简介和核心价值
|
||||
- And 点击后跳转到 ad.ningmuyun.com 政府监管系统
|
||||
- And 入口设计体现政府监管特色
|
||||
|
||||
### 3.10 系统介绍页面模块
|
||||
|
||||
#### 3.10.1 养殖管理系统介绍
|
||||
**用户故事:** As a 潜在用户,I want to 详细了解养殖管理系统的功能,so that 我可以评估是否满足养殖管理需求
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入养殖管理系统介绍页面
|
||||
- Then 展示系统核心功能:养殖档案管理、生长监控、饲料管理、疫病防控、环境监测、生产计划
|
||||
- And 包含系统界面截图和操作流程
|
||||
- And 提供成功案例和用户评价
|
||||
- And 显示系统访问入口和联系方式
|
||||
|
||||
#### 3.10.2 银行监管系统介绍
|
||||
**用户故事:** As a 银行人员,I want to 详细了解银行监管系统的功能,so that 我可以了解如何通过系统进行信贷风险管理
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入银行监管系统介绍页面
|
||||
- Then 展示系统核心功能:养殖资产估值、信贷风险评估、抵押物监控、还款提醒、风险预警
|
||||
- And 包含系统界面截图和操作流程
|
||||
- And 提供合作银行案例和风控效果数据
|
||||
- And 显示系统访问入口和联系方式
|
||||
|
||||
#### 3.10.3 保险监管系统介绍
|
||||
**用户故事:** As a 保险公司人员,I want to 详细了解保险监管系统的功能,so that 我可以了解如何通过系统进行养殖保险业务管理
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入保险监管系统介绍页面
|
||||
- Then 展示系统核心功能:保单管理、理赔处理、风险定价、防损管理、数据统计分析
|
||||
- And 包含系统界面截图和操作流程
|
||||
- And 提供合作保险公司案例和理赔效率数据
|
||||
- And 显示系统访问入口和联系方式
|
||||
|
||||
#### 3.10.4 政府监管系统介绍
|
||||
**用户故事:** As a 政府官员,I want to 详细了解政府监管系统的功能,so that 我可以了解如何通过系统进行行业监管和政策执行
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户进入政府监管系统介绍页面
|
||||
- Then 展示系统核心功能:养殖场备案管理、防疫监管、质量追溯、政策执行监督、数据统计分析
|
||||
- And 包含系统界面截图和操作流程
|
||||
- And 提供监管成效案例和政策执行数据
|
||||
- And 显示系统访问入口和联系方式
|
||||
|
||||
### 3.11 小程序入口模块
|
||||
|
||||
#### 3.11.1 小程序二维码展示
|
||||
**用户故事:** As a 移动端用户,I want to 快速找到小程序入口,so that 我可以通过微信扫码直接使用小程序
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户访问官网
|
||||
- Then 在显著位置显示小程序二维码
|
||||
- And 二维码清晰可扫描
|
||||
- And 提供小程序功能简介
|
||||
- And 支持点击放大查看
|
||||
|
||||
#### 3.11.2 多平台入口整合
|
||||
**用户故事:** As a 不同设备用户,I want to 看到所有平台入口,so that 我可以选择最适合的使用方式
|
||||
|
||||
**验收标准:**
|
||||
- Given 用户查看下载或入口页面
|
||||
- Then 同时展示PC客户端、移动APP和小程序入口
|
||||
- And 清晰说明各平台的功能差异
|
||||
- And 提供对应的下载或使用指引
|
||||
|
||||
## 4. 非功能需求
|
||||
|
||||
### 4.1 设计需求
|
||||
- **风格要求**:专业严谨、现代科技、农业特色相结合
|
||||
- **色彩方案**:以蓝色系为主,体现科技感;搭配绿色系,体现农业特色
|
||||
- **字体规范**:使用清晰易读的字体,中文优先使用思源黑体
|
||||
- **图片标准**:高质量图片,体现养殖场景和科技感
|
||||
|
||||
### 4.2 性能要求
|
||||
- 页面加载时间:<3秒
|
||||
- 首屏加载时间:<1.5秒
|
||||
- 资源压缩:CSS/JS文件压缩优化
|
||||
- 图片优化:使用WebP格式,支持懒加载
|
||||
|
||||
### 4.3 兼容性要求
|
||||
- **浏览器支持**:Chrome、Firefox、Safari、Edge最新版本
|
||||
- **移动端适配**:完全响应式设计,支持各种屏幕尺寸
|
||||
- **分辨率支持**:从320px到1920px自适应
|
||||
|
||||
### 4.4 SEO要求
|
||||
- 页面标题和描述优化
|
||||
- 语义化HTML结构
|
||||
- 合理的heading标签使用
|
||||
- 图片alt属性优化
|
||||
|
||||
## 5. 原型说明
|
||||
|
||||
### 5.1 页面结构
|
||||
|
||||
#### 5.1.1 首页布局
|
||||
- **顶部导航栏**:Logo、主导航菜单、语言切换、注册/登录入口
|
||||
- **Banner区域**:主视觉图、平台slogan、核心价值主张
|
||||
- **功能展示区**:核心功能图标+文字介绍
|
||||
- **系统入口功能区**:养殖管理系统、银行监管系统、保险监管系统、政府监管系统入口卡片,每个入口包含图标、系统名称、功能简介和访问按钮
|
||||
- **数据看板**:关键数据统计展示
|
||||
- **小程序入口**:微信小程序二维码+功能简介
|
||||
- **客户证言**:精选客户评价
|
||||
- **底部信息**:版权信息、备案信息、联系方式
|
||||
|
||||
#### 5.1.2 内页布局
|
||||
- **面包屑导航**:显示当前位置
|
||||
- **左侧菜单**:二级导航(针对多内容板块)
|
||||
- **主内容区**:详细内容展示
|
||||
- **相关推荐**:相关内容链接
|
||||
- **联系CTA**:联系我们的行动号召
|
||||
|
||||
### 5.2 设计元素
|
||||
|
||||
#### 5.2.1 色彩体系
|
||||
- **主色调**:科技蓝 (#1E88E5)
|
||||
- **辅助色**:农业绿 (#43A047)
|
||||
- **强调色**:活力橙 (#FF9800)
|
||||
- **中性色**:深灰 (#212121)、中灰 (#757575)、浅灰 (#BDBDBD)
|
||||
|
||||
#### 5.2.2 图标设计
|
||||
- 使用线性图标风格
|
||||
- 统一图标大小和风格
|
||||
- 农业相关图标体现行业特色
|
||||
- 科技感图标体现平台特性
|
||||
|
||||
#### 5.2.3 图片风格
|
||||
- 真实的养殖场景照片
|
||||
- 科技感的界面截图
|
||||
- 专业的企业环境图片
|
||||
- 高质量的图表和数据可视化
|
||||
|
||||
### 5.3 内容规范
|
||||
|
||||
#### 5.3.1 文案风格
|
||||
- 专业严谨但不生硬
|
||||
- 简洁明了易于理解
|
||||
- 突出价值主张
|
||||
- 符合行业术语规范
|
||||
|
||||
#### 5.3.2 内容组织
|
||||
- 重要信息优先展示
|
||||
- 层次分明结构清晰
|
||||
- 图文结合增强可读性
|
||||
- 数据支撑增强说服力
|
||||
|
||||
## 6. 内容规划
|
||||
|
||||
### 6.1 首页内容
|
||||
1. **主Banner**:平台整体介绍+核心价值
|
||||
2. **数字统计**:服务客户数、监控设备数、处理数据量
|
||||
3. **核心功能**:4-6个核心功能亮点
|
||||
4. **技术优势**:关键技术指标和创新点
|
||||
5. **系统入口功能区**:养殖管理系统、银行监管系统、保险监管系统、政府监管系统入口
|
||||
6. **客户案例**:精选3个典型客户案例
|
||||
7. **新闻动态**:最新3条新闻动态
|
||||
8. **下载入口**:明显的下载按钮
|
||||
9. **小程序入口**:微信小程序二维码展示
|
||||
10. **联系入口**:多种联系方式的入口
|
||||
|
||||
### 6.2 产品介绍页
|
||||
1. **平台概述**:使命、愿景、价值观
|
||||
2. **功能矩阵**:所有功能的分类展示
|
||||
3. **应用场景**:不同养殖模式的应用
|
||||
4. **技术架构**:系统架构和技术栈
|
||||
5. **版本历史**:重要版本更新记录
|
||||
|
||||
### 6.3 下载中心页
|
||||
1. **版本说明**:各个版本的功能差异
|
||||
2. **系统要求**:硬件和软件环境要求
|
||||
3. **安装指南**:详细的安装步骤
|
||||
4. **更新日志**:每个版本的更新内容
|
||||
5. **多平台入口**:PC客户端、移动APP、小程序二维码
|
||||
6. **常见问题**:下载和安装的FAQ
|
||||
|
||||
## 7. 技术实现
|
||||
|
||||
### 7.1 前端技术
|
||||
- **HTML5**:语义化标签结构
|
||||
- **CSS3**:现代样式特性
|
||||
- **Bootstrap 5**:响应式框架
|
||||
- **JavaScript**:基础交互功能
|
||||
- **jQuery**:DOM操作和Ajax(可选)
|
||||
|
||||
### 7.2 开发规范
|
||||
- 代码注释规范清晰
|
||||
- 文件结构组织合理
|
||||
- 资源引用路径统一
|
||||
- 浏览器兼容性处理
|
||||
|
||||
### 7.3 部署要求
|
||||
- 支持静态文件部署
|
||||
- CDN加速支持
|
||||
- HTTPS安全访问
|
||||
- 域名绑定配置
|
||||
|
||||
## 8. 项目计划
|
||||
|
||||
### 8.1 开发阶段
|
||||
1. **需求确认**:1天
|
||||
2. **UI设计**:3天
|
||||
3. **前端开发**:5天
|
||||
4. **内容填充**:2天
|
||||
5. **测试验收**:2天
|
||||
6. **部署上线**:1天
|
||||
|
||||
### 8.2 资源需求
|
||||
- UI设计师:1人
|
||||
- 前端开发:1人
|
||||
- 内容编辑:1人
|
||||
- 测试人员:1人
|
||||
|
||||
## 9. 风险控制
|
||||
|
||||
### 9.1 技术风险
|
||||
- 浏览器兼容性问题
|
||||
- 移动端适配挑战
|
||||
- 性能优化难度
|
||||
|
||||
### 9.2 内容风险
|
||||
- 文案准确性
|
||||
- 图片版权问题
|
||||
- 信息更新及时性
|
||||
|
||||
### 9.3 应对措施
|
||||
- 提前进行兼容性测试
|
||||
- 建立内容审核流程
|
||||
- 制定定期更新计划
|
||||
|
||||
## 10. 后续规划
|
||||
|
||||
### 10.1 功能扩展
|
||||
- 多语言支持
|
||||
- 用户评论系统
|
||||
- 在线客服功能
|
||||
- 数据统计后台
|
||||
|
||||
### 10.2 技术升级
|
||||
- 渐进式Web应用(PWA)
|
||||
- 静态站点生成器(SSG)
|
||||
- 前端框架迁移
|
||||
|
||||
---
|
||||
*文档最后更新:2025年1月18日*
|
||||
358
docs/requirements/保险端产品需求文档.md
Normal file
358
docs/requirements/保险端产品需求文档.md
Normal file
@@ -0,0 +1,358 @@
|
||||
# 保险端产品需求文档 (PRD)
|
||||
|
||||
## 版本历史
|
||||
|
||||
| 版本 | 日期 | 作者 | 变更说明 |
|
||||
|------|------|------|----------|
|
||||
| v1.0 | 2025-01-19 | 产品经理 | 初始版本,基于宁夏智慧养殖监管平台需求梳理 |
|
||||
|
||||
---
|
||||
|
||||
## 1. 项目概述
|
||||
|
||||
### 1.1 背景
|
||||
宁夏智慧养殖监管平台中的保险监管系统,旨在为保险公司提供专业的养殖保险业务管理解决方案。通过数字化手段实现保险业务的智能化、规范化和高效化管理,降低保险公司运营成本,提高理赔效率和客户满意度。
|
||||
|
||||
### 1.2 目标
|
||||
- **业务目标**:提升保险业务处理效率60%,降低运营成本40%,提高客户满意度35%
|
||||
- **用户目标**:为保险公司提供一站式养殖保险业务管理平台
|
||||
- **技术目标**:构建稳定、安全、可扩展的保险业务管理系统
|
||||
|
||||
### 1.3 成功标准
|
||||
- 理赔处理时间缩短70%
|
||||
- 风险识别准确率达到90%
|
||||
- 赔付率下降25%
|
||||
- 系统可用性达到99.9%
|
||||
|
||||
### 1.4 范围界定
|
||||
**包含范围:**
|
||||
- 保单全生命周期管理
|
||||
- 理赔流程管理
|
||||
- 风险定价与评估
|
||||
- 防损管理
|
||||
- 数据统计分析
|
||||
- 业务监控预警
|
||||
|
||||
**不包含范围:**
|
||||
- 财务核算系统
|
||||
- 人力资源管理
|
||||
- 第三方支付接口
|
||||
|
||||
---
|
||||
|
||||
## 2. 用户角色与用例
|
||||
|
||||
### 2.1 用户角色
|
||||
|
||||
| 角色 | 描述 | 主要职责 |
|
||||
|------|------|----------|
|
||||
| 保险业务员 | 负责保险销售和客户服务 | 保单录入、客户咨询、业务推广 |
|
||||
| 理赔专员 | 负责理赔案件处理 | 理赔审核、现场查勘、赔付处理 |
|
||||
| 风控专员 | 负责风险评估和控制 | 风险定价、防损管理、数据分析 |
|
||||
| 系统管理员 | 负责系统维护和用户管理 | 用户权限管理、系统配置、数据备份 |
|
||||
|
||||
### 2.2 核心用例
|
||||
|
||||
1. **保单管理**:投保、续保、批改、退保
|
||||
2. **理赔处理**:报案登记、查勘定损、理赔审核、赔付处理
|
||||
3. **风险管理**:风险评估、定价策略、防损措施
|
||||
4. **数据分析**:业务统计、趋势分析、报表生成
|
||||
|
||||
---
|
||||
|
||||
## 3. 功能需求
|
||||
|
||||
### 3.1 保单管理模块
|
||||
|
||||
#### 3.1.1 保单录入
|
||||
**用户故事:** As a 保险业务员,I want to 快速录入保单信息,so that 我可以高效完成投保业务
|
||||
|
||||
**功能描述:**
|
||||
- 支持养殖保险保单信息录入
|
||||
- 自动校验保单信息完整性和准确性
|
||||
- 支持批量导入保单数据
|
||||
- 关联养殖场和牲畜信息
|
||||
|
||||
**验收标准:**
|
||||
- Given 业务员登录系统
|
||||
- When 选择新增保单功能
|
||||
- Then 显示保单录入表单
|
||||
- And 支持必填字段验证
|
||||
- And 保存成功后生成唯一保单号
|
||||
|
||||
#### 3.1.2 保单查询与管理
|
||||
**功能描述:**
|
||||
- 多维度保单查询(保单号、投保人、保险类型、状态等)
|
||||
- 保单详情查看和编辑
|
||||
- 保单状态管理(有效、过期、待审核等)
|
||||
- 保单续保提醒
|
||||
|
||||
**数据字段:**
|
||||
- 保单号(policyNo)
|
||||
- 投保人(insured)
|
||||
- 保险类型(type)
|
||||
- 保险金额(amount)
|
||||
- 保费(premium)
|
||||
- 生效日期(startDate)
|
||||
- 到期日期(endDate)
|
||||
- 状态(status)
|
||||
|
||||
### 3.2 理赔处理模块
|
||||
|
||||
#### 3.2.1 报案登记
|
||||
**用户故事:** As a 理赔专员,I want to 快速登记理赔案件,so that 我可以及时启动理赔流程
|
||||
|
||||
**功能描述:**
|
||||
- 理赔案件信息登记
|
||||
- 关联保单信息验证
|
||||
- 上传相关证明材料
|
||||
- 自动分配查勘人员
|
||||
|
||||
#### 3.2.2 查勘定损
|
||||
**功能描述:**
|
||||
- 现场查勘记录
|
||||
- 损失评估和定损
|
||||
- 查勘照片和视频上传
|
||||
- 查勘报告生成
|
||||
|
||||
#### 3.2.3 理赔审核
|
||||
**功能描述:**
|
||||
- 理赔材料审核
|
||||
- 赔付金额计算
|
||||
- 审核流程管理
|
||||
- 审核意见记录
|
||||
|
||||
#### 3.2.4 赔付处理
|
||||
**功能描述:**
|
||||
- 赔付金额确认
|
||||
- 赔付方式选择
|
||||
- 赔付状态跟踪
|
||||
- 赔付凭证生成
|
||||
|
||||
### 3.3 风险管理模块
|
||||
|
||||
#### 3.3.1 风险评估
|
||||
**功能描述:**
|
||||
- 基于历史数据的风险评估模型
|
||||
- 养殖场风险等级评定
|
||||
- 个体牲畜风险评估
|
||||
- 区域风险分析
|
||||
|
||||
#### 3.3.2 风险定价
|
||||
**功能描述:**
|
||||
- 动态费率计算
|
||||
- 风险系数调整
|
||||
- 保费优惠政策管理
|
||||
- 定价策略配置
|
||||
|
||||
#### 3.3.3 防损管理
|
||||
**功能描述:**
|
||||
- 风险预警机制
|
||||
- 防损措施建议
|
||||
- 防损效果跟踪
|
||||
- 防损成本分析
|
||||
|
||||
### 3.4 数据统计分析模块
|
||||
|
||||
#### 3.4.1 业务统计
|
||||
**功能描述:**
|
||||
- 保单统计(数量、金额、类型分布)
|
||||
- 理赔统计(案件数、赔付率、处理时效)
|
||||
- 收入统计(保费收入、增长趋势)
|
||||
- 客户统计(新增客户、续保率)
|
||||
|
||||
#### 3.4.2 数据可视化
|
||||
**功能描述:**
|
||||
- 参保统计图表(如牛只参保统计)
|
||||
- 保险公司业务分布
|
||||
- 理赔趋势分析
|
||||
- 风险热力图
|
||||
|
||||
#### 3.4.3 报表管理
|
||||
**功能描述:**
|
||||
- 标准报表模板
|
||||
- 自定义报表配置
|
||||
- 报表定时生成
|
||||
- 报表导出功能
|
||||
|
||||
### 3.5 系统管理模块
|
||||
|
||||
#### 3.5.1 用户管理
|
||||
**功能描述:**
|
||||
- 用户账号管理
|
||||
- 角色权限配置
|
||||
- 登录日志记录
|
||||
- 密码策略管理
|
||||
|
||||
#### 3.5.2 参数配置
|
||||
**功能描述:**
|
||||
- 保险产品配置
|
||||
- 费率参数设置
|
||||
- 业务流程配置
|
||||
- 系统参数管理
|
||||
|
||||
---
|
||||
|
||||
## 4. 非功能需求
|
||||
|
||||
### 4.1 性能要求
|
||||
- **响应时间**:页面加载时间 < 3秒,API响应时间 < 1秒
|
||||
- **并发用户**:支持1000个并发用户
|
||||
- **数据处理**:支持单次处理10万条保单数据
|
||||
|
||||
### 4.2 安全要求
|
||||
- **数据加密**:采用HTTPS加密传输,敏感数据AES-256加密存储
|
||||
- **身份认证**:JWT令牌机制,支持单点登录
|
||||
- **权限控制**:基于角色的访问控制(RBAC)
|
||||
- **安全防护**:SQL注入防护、XSS防护、CSRF防护
|
||||
|
||||
### 4.3 可靠性要求
|
||||
- **系统可用性**:99.9%
|
||||
- **数据备份**:每日自动备份,支持增量备份
|
||||
- **故障恢复**:RTO < 4小时,RPO < 1小时
|
||||
- **容错机制**:关键业务支持降级处理
|
||||
|
||||
### 4.4 兼容性要求
|
||||
- **浏览器支持**:Chrome 70+、Firefox 65+、Safari 12+、Edge 79+
|
||||
- **移动端适配**:响应式设计,支持主流移动设备
|
||||
- **操作系统**:Windows 10+、macOS 10.14+、主流Linux发行版
|
||||
|
||||
---
|
||||
|
||||
## 5. 技术架构
|
||||
|
||||
### 5.1 技术栈
|
||||
- **前端**:Vue.js 3.x + Ant Design Vue + ECharts
|
||||
- **后端**:Node.js + Express/NestJS
|
||||
- **数据库**:MySQL 8.0+
|
||||
- **缓存**:Redis
|
||||
- **构建工具**:Vite
|
||||
|
||||
### 5.2 系统架构
|
||||
- **表现层**:Vue.js组件化开发
|
||||
- **业务层**:RESTful API服务
|
||||
- **数据层**:MySQL关系型数据库
|
||||
- **缓存层**:Redis缓存热点数据
|
||||
|
||||
---
|
||||
|
||||
## 6. 数据字典
|
||||
|
||||
### 6.1 保单状态枚举
|
||||
```javascript
|
||||
const PolicyStatus = {
|
||||
ACTIVE: 'active', // 有效
|
||||
EXPIRED: 'expired', // 已过期
|
||||
PENDING: 'pending', // 待审核
|
||||
CANCELLED: 'cancelled' // 已取消
|
||||
}
|
||||
```
|
||||
|
||||
### 6.2 理赔状态枚举
|
||||
```javascript
|
||||
const ClaimStatus = {
|
||||
REPORTED: 'reported', // 已报案
|
||||
SURVEYING: 'surveying', // 查勘中
|
||||
REVIEWING: 'reviewing', // 审核中
|
||||
APPROVED: 'approved', // 已批准
|
||||
PAID: 'paid', // 已赔付
|
||||
REJECTED: 'rejected' // 已拒赔
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 7. API规范
|
||||
|
||||
### 7.1 通用响应格式
|
||||
```javascript
|
||||
{
|
||||
"code": 200,
|
||||
"message": "success",
|
||||
"data": {},
|
||||
"timestamp": "2025-01-19T10:00:00Z"
|
||||
}
|
||||
```
|
||||
|
||||
### 7.2 错误处理
|
||||
```javascript
|
||||
{
|
||||
"code": 400,
|
||||
"message": "参数错误",
|
||||
"error": "详细错误信息",
|
||||
"timestamp": "2025-01-19T10:00:00Z"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. 部署要求
|
||||
|
||||
### 8.1 环境要求
|
||||
- **开发环境**:Node.js 16+、MySQL 8.0+、Redis 6.0+
|
||||
- **生产环境**:Docker容器化部署,支持负载均衡
|
||||
- **监控要求**:系统监控、性能监控、业务监控
|
||||
|
||||
### 8.2 安全配置
|
||||
- 防火墙配置
|
||||
- SSL证书配置
|
||||
- 数据库安全配置
|
||||
- 日志审计配置
|
||||
|
||||
---
|
||||
|
||||
## 9. 项目计划
|
||||
|
||||
### 9.1 开发阶段
|
||||
- **需求分析**:1周
|
||||
- **系统设计**:1周
|
||||
- **开发实现**:6周
|
||||
- **测试验收**:2周
|
||||
- **部署上线**:1周
|
||||
|
||||
### 9.2 里程碑
|
||||
- M1:需求确认完成
|
||||
- M2:系统设计评审通过
|
||||
- M3:核心功能开发完成
|
||||
- M4:系统测试通过
|
||||
- M5:生产环境部署完成
|
||||
|
||||
---
|
||||
|
||||
## 10. 风险与约束
|
||||
|
||||
### 10.1 技术风险
|
||||
- 数据迁移风险
|
||||
- 系统集成风险
|
||||
- 性能瓶颈风险
|
||||
|
||||
### 10.2 业务约束
|
||||
- 监管合规要求
|
||||
- 数据安全要求
|
||||
- 业务连续性要求
|
||||
|
||||
### 10.3 资源约束
|
||||
- 开发团队规模
|
||||
- 项目预算限制
|
||||
- 时间进度要求
|
||||
|
||||
---
|
||||
|
||||
## 11. 附录
|
||||
|
||||
### 11.1 参考文档
|
||||
- 宁夏智慧养殖监管平台整体PRD
|
||||
- 保险行业监管要求
|
||||
- 技术架构设计文档
|
||||
|
||||
### 11.2 术语表
|
||||
- **保单**:保险合同的书面凭证
|
||||
- **理赔**:保险事故发生后的赔偿处理
|
||||
- **风控**:风险识别、评估和控制
|
||||
- **防损**:预防和减少损失的措施
|
||||
|
||||
---
|
||||
|
||||
*文档版本:v1.0*
|
||||
*最后更新:2025年1月19日*
|
||||
*文档状态:待评审*
|
||||
454
docs/requirements/政府端产品需求文档.md
Normal file
454
docs/requirements/政府端产品需求文档.md
Normal file
@@ -0,0 +1,454 @@
|
||||
# 政府端产品需求文档 (PRD)
|
||||
|
||||
## 版本历史
|
||||
|
||||
| 版本 | 日期 | 作者 | 变更说明 |
|
||||
|------|------|------|----------|
|
||||
| v1.0 | 2025-01-19 | 产品经理 | 初始版本,定义政府端核心功能需求 |
|
||||
|
||||
## 1. 项目概述
|
||||
|
||||
### 1.1 产品背景
|
||||
宁夏智慧养殖监管平台政府端是专为政府监管部门设计的综合性管理系统,旨在提升政府对养殖业的监管效率,实现监管工作的智能化、规范化和高效化。
|
||||
|
||||
### 1.2 业务目标
|
||||
- **监管效率提升70%**:通过智能化监管工具,减少人工工作量
|
||||
- **监管精准度提升**:精准识别监管重点,提高监管针对性和有效性
|
||||
- **应急响应时间缩短80%**:建立快速响应机制,提高应急处置能力
|
||||
- **监管覆盖率达到95%**:实现养殖业全面监管覆盖
|
||||
|
||||
### 1.3 产品定位
|
||||
面向政府监管部门的专业化养殖业监管平台,提供全方位的监管解决方案。
|
||||
|
||||
## 2. 用户角色与用例
|
||||
|
||||
### 2.1 核心用户角色
|
||||
|
||||
#### 2.1.1 政府监管官员
|
||||
- **角色描述**:农业部门、畜牧监管部门官员
|
||||
- **核心需求**:进行行业监管、政策执行监督、数据统计分析
|
||||
- **使用场景**:日常监管工作、政策制定、应急处理
|
||||
|
||||
#### 2.1.2 防疫监管人员
|
||||
- **角色描述**:动物疫病防控监管人员
|
||||
- **核心需求**:疫病监控、疫苗管理、防疫监督
|
||||
- **使用场景**:疫情监控、防疫检查、疫苗分发
|
||||
|
||||
#### 2.1.3 质量安全监管员
|
||||
- **角色描述**:农产品质量安全监管人员
|
||||
- **核心需求**:质量追溯、安全检测、违规处理
|
||||
- **使用场景**:质量检查、追溯管理、安全监督
|
||||
|
||||
### 2.2 用户故事
|
||||
|
||||
#### 故事1:养殖场备案管理
|
||||
**As a** 政府监管官员
|
||||
**I want to** 管理养殖场备案登记
|
||||
**So that** 我可以实现养殖主体信息的规范化管理
|
||||
|
||||
**验收标准**:
|
||||
- Given 监管官员登录系统
|
||||
- When 查看养殖场备案列表
|
||||
- Then 显示所有养殖场的备案信息
|
||||
- And 支持按地区、规模、类型筛选
|
||||
- And 可以审批新的备案申请
|
||||
|
||||
#### 故事2:防疫监管
|
||||
**As a** 防疫监管人员
|
||||
**I want to** 监控动物疫病防控情况
|
||||
**So that** 我可以确保养殖业生产安全和公共卫生安全
|
||||
|
||||
**验收标准**:
|
||||
- Given 防疫人员登录系统
|
||||
- When 查看防疫监管面板
|
||||
- Then 显示疫情分布地图
|
||||
- And 显示疫苗接种统计
|
||||
- And 可以发布防疫预警
|
||||
|
||||
#### 故事3:政策法规发布
|
||||
**As a** 政府监管官员
|
||||
**I want to** 发布养殖业相关政策法规
|
||||
**So that** 我可以指导养殖业规范发展
|
||||
|
||||
**验收标准**:
|
||||
- Given 监管官员有发布权限
|
||||
- When 创建新政策文档
|
||||
- Then 可以编辑政策内容
|
||||
- And 可以设置生效时间
|
||||
- And 可以推送给相关养殖场
|
||||
|
||||
## 3. 功能需求
|
||||
|
||||
### 3.1 核心功能模块
|
||||
|
||||
#### 3.1.1 政府监管仪表板
|
||||
**功能描述**:提供政府监管工作的全局视图和关键指标监控
|
||||
|
||||
**主要功能**:
|
||||
- 监管数据统计展示(注册养殖场、监管动物总数、注册兽医、预警信息)
|
||||
- 养殖场地区分布图表
|
||||
- 监管任务进度跟踪
|
||||
- 实时预警信息展示
|
||||
- 今日工作概览
|
||||
|
||||
**技术要求**:
|
||||
- 支持实时数据更新
|
||||
- 响应式图表展示
|
||||
- 数据钻取功能
|
||||
|
||||
#### 3.1.2 养殖场备案管理
|
||||
**功能描述**:管理养殖场的备案登记、审批和证书发放
|
||||
|
||||
**主要功能**:
|
||||
- 养殖场备案申请审批
|
||||
- 养殖场信息管理
|
||||
- 许可证管理(养殖许可证、运输许可证、屠宰许可证、饲料生产许可证)
|
||||
- 证书到期提醒
|
||||
- 备案信息查询和统计
|
||||
|
||||
**业务流程**:
|
||||
1. 养殖场提交备案申请
|
||||
2. 监管部门审核材料
|
||||
3. 现场检查(如需要)
|
||||
4. 审批决定
|
||||
5. 证书发放
|
||||
6. 定期复审
|
||||
|
||||
#### 3.1.3 防疫监管系统
|
||||
**功能描述**:动物疫病防控监管,确保养殖业生产安全
|
||||
|
||||
**主要功能**:
|
||||
- 疫情监控和预警
|
||||
- 疫苗管理(库存、分发、接种记录)
|
||||
- 防疫活动管理
|
||||
- 防疫机构管理
|
||||
- 疫情报告和统计
|
||||
|
||||
**关键指标**:
|
||||
- 疫苗接种覆盖率
|
||||
- 疫情发生频率
|
||||
- 防疫响应时间
|
||||
- 疫苗库存预警
|
||||
|
||||
#### 3.1.4 质量安全追溯
|
||||
**功能描述**:农产品质量安全追溯体系,实现全链条监管
|
||||
|
||||
**主要功能**:
|
||||
- 产品追溯码管理
|
||||
- 质量检测记录
|
||||
- 问题产品召回
|
||||
- 追溯链条查询
|
||||
- 质量安全报告
|
||||
|
||||
**追溯环节**:
|
||||
- 养殖环节:饲料、兽药使用记录
|
||||
- 屠宰环节:检疫检验记录
|
||||
- 流通环节:运输、储存记录
|
||||
- 销售环节:销售去向记录
|
||||
|
||||
#### 3.1.5 政策法规管理
|
||||
**功能描述**:发布和管理养殖业相关政策法规
|
||||
|
||||
**主要功能**:
|
||||
- 政策文档管理
|
||||
- 政策发布和推送
|
||||
- 政策执行监督
|
||||
- 政策效果评估
|
||||
- 政策法规查询
|
||||
|
||||
**政策类型**:
|
||||
- 养殖业发展政策
|
||||
- 环保要求
|
||||
- 补贴政策
|
||||
- 技术标准
|
||||
- 安全规范
|
||||
|
||||
#### 3.1.6 行业数据统计
|
||||
**功能描述**:全面的养殖业数据统计分析,为政策制定提供数据支持
|
||||
|
||||
**主要功能**:
|
||||
- 养殖业发展趋势分析
|
||||
- 区域对比分析
|
||||
- 行业结构分析
|
||||
- 经济效益分析
|
||||
- 数据报表生成
|
||||
|
||||
**统计维度**:
|
||||
- 时间维度:日、周、月、季、年
|
||||
- 地区维度:省、市、县、乡镇
|
||||
- 类型维度:养殖品种、规模、模式
|
||||
|
||||
#### 3.1.7 应急事件处理
|
||||
**功能描述**:突发事件应急处理机制,快速响应各类突发事件
|
||||
|
||||
**主要功能**:
|
||||
- 应急事件上报
|
||||
- 应急预案管理
|
||||
- 应急响应流程
|
||||
- 资源调度管理
|
||||
- 事件处理跟踪
|
||||
|
||||
**应急事件类型**:
|
||||
- 重大疫情
|
||||
- 食品安全事故
|
||||
- 环境污染事件
|
||||
- 自然灾害
|
||||
- 市场异常波动
|
||||
|
||||
### 3.2 辅助功能模块
|
||||
|
||||
#### 3.2.1 用户权限管理
|
||||
- 角色权限配置
|
||||
- 用户账号管理
|
||||
- 操作日志记录
|
||||
- 数据访问控制
|
||||
|
||||
#### 3.2.2 系统设置
|
||||
- 系统参数配置
|
||||
- 通知设置
|
||||
- 数据备份
|
||||
- 系统监控
|
||||
|
||||
#### 3.2.3 报表中心
|
||||
- 标准报表模板
|
||||
- 自定义报表
|
||||
- 报表导出
|
||||
- 报表分发
|
||||
|
||||
## 4. 非功能需求
|
||||
|
||||
### 4.1 性能要求
|
||||
- **响应时间**:页面加载时间 < 3秒,查询响应时间 < 2秒
|
||||
- **并发用户**:支持1000个并发用户同时在线
|
||||
- **数据处理**:支持百万级数据量的查询和统计
|
||||
- **可用性**:系统可用性 ≥ 99.5%
|
||||
|
||||
### 4.2 安全要求
|
||||
- **身份认证**:支持多因子认证
|
||||
- **数据加密**:敏感数据传输和存储加密
|
||||
- **访问控制**:基于角色的权限控制
|
||||
- **审计日志**:完整的操作审计记录
|
||||
- **数据备份**:定期数据备份和恢复机制
|
||||
|
||||
### 4.3 兼容性要求
|
||||
- **浏览器兼容**:支持Chrome、Firefox、Safari、Edge最新版本
|
||||
- **移动端适配**:响应式设计,支持平板和手机访问
|
||||
- **操作系统**:支持Windows、macOS、Linux
|
||||
|
||||
### 4.4 可扩展性要求
|
||||
- **模块化设计**:支持功能模块的独立部署和扩展
|
||||
- **API接口**:提供标准REST API接口
|
||||
- **第三方集成**:支持与其他政府系统的数据对接
|
||||
- **负载均衡**:支持水平扩展和负载均衡
|
||||
|
||||
## 5. 技术架构
|
||||
|
||||
### 5.1 前端技术栈
|
||||
- **框架**:Vue.js 3.x
|
||||
- **UI组件库**:Ant Design Vue
|
||||
- **状态管理**:Pinia
|
||||
- **路由管理**:Vue Router
|
||||
- **图表库**:ECharts
|
||||
- **地图服务**:百度地图API
|
||||
- **构建工具**:Vite
|
||||
|
||||
### 5.2 后端技术栈
|
||||
- **运行环境**:Node.js
|
||||
- **Web框架**:Express/NestJS
|
||||
- **数据库**:MySQL
|
||||
- **ORM**:TypeORM/Sequelize
|
||||
- **认证**:JWT
|
||||
- **API文档**:Swagger
|
||||
|
||||
### 5.3 部署架构
|
||||
- **容器化**:Docker
|
||||
- **编排工具**:Docker Compose
|
||||
- **反向代理**:Nginx
|
||||
- **监控**:Prometheus + Grafana
|
||||
|
||||
## 6. 数据字典
|
||||
|
||||
### 6.1 核心数据实体
|
||||
|
||||
#### 6.1.1 养殖场信息 (Farm)
|
||||
| 字段名 | 类型 | 长度 | 必填 | 说明 |
|
||||
|--------|------|------|------|------|
|
||||
| id | VARCHAR | 32 | 是 | 养殖场唯一标识 |
|
||||
| name | VARCHAR | 100 | 是 | 养殖场名称 |
|
||||
| owner | VARCHAR | 50 | 是 | 养殖场主 |
|
||||
| address | VARCHAR | 200 | 是 | 详细地址 |
|
||||
| scale | ENUM | - | 是 | 养殖规模(small/medium/large) |
|
||||
| type | ENUM | - | 是 | 养殖类型(cattle/pig/sheep/poultry) |
|
||||
| status | ENUM | - | 是 | 状态(active/inactive/suspended) |
|
||||
| license_no | VARCHAR | 50 | 否 | 许可证编号 |
|
||||
| register_date | DATETIME | - | 是 | 注册日期 |
|
||||
|
||||
#### 6.1.2 政策信息 (Policy)
|
||||
| 字段名 | 类型 | 长度 | 必填 | 说明 |
|
||||
|--------|------|------|------|------|
|
||||
| id | VARCHAR | 32 | 是 | 政策唯一标识 |
|
||||
| title | VARCHAR | 200 | 是 | 政策标题 |
|
||||
| content | TEXT | - | 是 | 政策内容 |
|
||||
| type | ENUM | - | 是 | 政策类型 |
|
||||
| status | ENUM | - | 是 | 状态(draft/active/expired) |
|
||||
| effective_date | DATETIME | - | 是 | 生效日期 |
|
||||
| expiry_date | DATETIME | - | 否 | 失效日期 |
|
||||
| publisher | VARCHAR | 50 | 是 | 发布人 |
|
||||
|
||||
#### 6.1.3 疫苗信息 (Vaccine)
|
||||
| 字段名 | 类型 | 长度 | 必填 | 说明 |
|
||||
|--------|------|------|------|------|
|
||||
| id | VARCHAR | 32 | 是 | 疫苗唯一标识 |
|
||||
| name | VARCHAR | 100 | 是 | 疫苗名称 |
|
||||
| type | ENUM | - | 是 | 疫苗类型 |
|
||||
| manufacturer | VARCHAR | 100 | 是 | 生产厂家 |
|
||||
| batch_no | VARCHAR | 50 | 是 | 批次号 |
|
||||
| production_date | DATE | - | 是 | 生产日期 |
|
||||
| expiry_date | DATE | - | 是 | 有效期 |
|
||||
| stock_quantity | INT | - | 是 | 库存数量 |
|
||||
|
||||
## 7. API规范
|
||||
|
||||
### 7.1 API设计原则
|
||||
- 遵循RESTful设计规范
|
||||
- 统一的响应格式
|
||||
- 完善的错误处理
|
||||
- API版本控制
|
||||
|
||||
### 7.2 核心API接口
|
||||
|
||||
#### 7.2.1 养殖场管理API
|
||||
```
|
||||
GET /api/v1/farms - 获取养殖场列表
|
||||
GET /api/v1/farms/{id} - 获取养殖场详情
|
||||
POST /api/v1/farms - 创建养殖场
|
||||
PUT /api/v1/farms/{id} - 更新养殖场信息
|
||||
DELETE /api/v1/farms/{id} - 删除养殖场
|
||||
```
|
||||
|
||||
#### 7.2.2 政策管理API
|
||||
```
|
||||
GET /api/v1/policies - 获取政策列表
|
||||
GET /api/v1/policies/{id} - 获取政策详情
|
||||
POST /api/v1/policies - 发布政策
|
||||
PUT /api/v1/policies/{id} - 更新政策
|
||||
DELETE /api/v1/policies/{id} - 删除政策
|
||||
```
|
||||
|
||||
#### 7.2.3 统计分析API
|
||||
```
|
||||
GET /api/v1/statistics/dashboard - 获取仪表板统计数据
|
||||
GET /api/v1/statistics/farms - 获取养殖场统计
|
||||
GET /api/v1/statistics/epidemic - 获取防疫统计
|
||||
GET /api/v1/statistics/quality - 获取质量安全统计
|
||||
```
|
||||
|
||||
### 7.3 响应格式
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"message": "success",
|
||||
"data": {},
|
||||
"timestamp": "2025-01-19T10:00:00Z"
|
||||
}
|
||||
```
|
||||
|
||||
## 8. 部署要求
|
||||
|
||||
### 8.1 硬件要求
|
||||
- **CPU**:8核心以上
|
||||
- **内存**:16GB以上
|
||||
- **存储**:500GB SSD
|
||||
- **网络**:千兆网络
|
||||
|
||||
### 8.2 软件环境
|
||||
- **操作系统**:Ubuntu 20.04 LTS或CentOS 8
|
||||
- **Node.js**:v18.x以上
|
||||
- **MySQL**:v8.0以上
|
||||
- **Nginx**:v1.20以上
|
||||
- **Docker**:v20.x以上
|
||||
|
||||
### 8.3 部署架构
|
||||
- **负载均衡**:Nginx反向代理
|
||||
- **应用服务**:多实例部署
|
||||
- **数据库**:主从复制
|
||||
- **缓存**:Redis集群
|
||||
- **监控**:Prometheus + Grafana
|
||||
|
||||
## 9. 项目计划
|
||||
|
||||
### 9.1 开发阶段
|
||||
|
||||
#### 第一阶段(4周):基础框架搭建
|
||||
- 项目架构设计
|
||||
- 基础组件开发
|
||||
- 用户认证系统
|
||||
- 权限管理系统
|
||||
|
||||
#### 第二阶段(6周):核心功能开发
|
||||
- 政府监管仪表板
|
||||
- 养殖场备案管理
|
||||
- 防疫监管系统
|
||||
- 政策法规管理
|
||||
|
||||
#### 第三阶段(4周):高级功能开发
|
||||
- 质量安全追溯
|
||||
- 行业数据统计
|
||||
- 应急事件处理
|
||||
- 报表中心
|
||||
|
||||
#### 第四阶段(2周):测试与优化
|
||||
- 功能测试
|
||||
- 性能测试
|
||||
- 安全测试
|
||||
- 用户体验优化
|
||||
|
||||
### 9.2 里程碑
|
||||
- **M1**:基础框架完成(第4周)
|
||||
- **M2**:核心功能完成(第10周)
|
||||
- **M3**:全功能完成(第14周)
|
||||
- **M4**:系统上线(第16周)
|
||||
|
||||
## 10. 风险与约束
|
||||
|
||||
### 10.1 技术风险
|
||||
- **数据安全风险**:政府敏感数据的安全保护
|
||||
- **性能风险**:大数据量处理的性能瓶颈
|
||||
- **集成风险**:与现有政府系统的集成复杂度
|
||||
|
||||
### 10.2 业务风险
|
||||
- **需求变更风险**:政策法规变化导致的需求调整
|
||||
- **用户接受度风险**:政府用户对新系统的接受程度
|
||||
- **合规风险**:系统需符合政府信息化相关规范
|
||||
|
||||
### 10.3 约束条件
|
||||
- **预算约束**:项目预算限制
|
||||
- **时间约束**:项目交付时间要求
|
||||
- **人力约束**:开发团队规模限制
|
||||
- **技术约束**:现有技术栈和基础设施限制
|
||||
|
||||
## 11. 附录
|
||||
|
||||
### 11.1 术语表
|
||||
- **PRD**:Product Requirements Document,产品需求文档
|
||||
- **API**:Application Programming Interface,应用程序编程接口
|
||||
- **REST**:Representational State Transfer,表述性状态转移
|
||||
- **JWT**:JSON Web Token,JSON网络令牌
|
||||
- **ORM**:Object-Relational Mapping,对象关系映射
|
||||
|
||||
### 11.2 参考文档
|
||||
- 《政府信息化建设规范》
|
||||
- 《农业信息化标准》
|
||||
- 《数据安全法》
|
||||
- 《网络安全法》
|
||||
|
||||
### 11.3 联系信息
|
||||
- **产品经理**:张三 (zhangsan@example.com)
|
||||
- **技术负责人**:李四 (lisi@example.com)
|
||||
- **项目经理**:王五 (wangwu@example.com)
|
||||
|
||||
---
|
||||
|
||||
**文档状态**:已完成
|
||||
**最后更新**:2025-01-19
|
||||
**下次评审**:2025-01-26
|
||||
420
docs/requirements/银行端小程序产品需求文档.md
Normal file
420
docs/requirements/银行端小程序产品需求文档.md
Normal file
@@ -0,0 +1,420 @@
|
||||
# 银行端小程序产品需求文档 (PRD)
|
||||
|
||||
## 版本历史
|
||||
|
||||
| 版本 | 日期 | 作者 | 变更说明 |
|
||||
|------|------|------|----------|
|
||||
| v1.0 | 2025-01-19 | 产品经理 | 初始版本,定义银行端小程序核心功能需求 |
|
||||
|
||||
---
|
||||
|
||||
## 1. 项目概述
|
||||
|
||||
### 1.1 背景
|
||||
基于宁夏智慧养殖监管平台的银行监管系统,为银行机构开发专用的微信小程序,实现移动端的信贷风险管理、抵押物监控、客户服务等核心业务功能。通过小程序的便携性和实时性,提升银行人员的工作效率和客户服务质量。
|
||||
|
||||
### 1.2 业务目标
|
||||
- **提升工作效率**:银行人员可随时随地处理业务,提高响应速度
|
||||
- **降低风险成本**:实时监控抵押物状态,及时预警风险事件
|
||||
- **优化客户体验**:为养殖企业客户提供便捷的金融服务入口
|
||||
- **数字化转型**:推动银行业务向移动化、智能化方向发展
|
||||
|
||||
### 1.3 产品定位
|
||||
面向银行信贷风险管理人员和养殖企业客户的专业金融服务小程序,集成信贷管理、风险监控、客户服务于一体的移动端解决方案。
|
||||
|
||||
---
|
||||
|
||||
## 2. 用户角色与用例
|
||||
|
||||
### 2.1 核心用户角色
|
||||
|
||||
| 角色 | 描述 | 核心需求 |
|
||||
|------|------|----------|
|
||||
| 银行信贷经理 | 负责信贷业务审批和管理 | 客户信息查询、信贷审批、风险评估 |
|
||||
| 银行风控专员 | 负责风险监控和预警处理 | 抵押物监控、风险预警、数据分析 |
|
||||
| 银行客户经理 | 负责客户关系维护和服务 | 客户沟通、业务推广、服务支持 |
|
||||
| 养殖企业客户 | 银行信贷服务的使用者 | 贷款申请、还款管理、资产查询 |
|
||||
|
||||
### 2.2 用户故事
|
||||
|
||||
#### 用户故事1:移动端信贷管理
|
||||
**As a** 银行信贷经理
|
||||
**I want to** 在小程序中查看和处理信贷申请
|
||||
**So that** 我可以随时随地处理业务,提高工作效率
|
||||
|
||||
#### 用户故事2:实时风险监控
|
||||
**As a** 银行风控专员
|
||||
**I want to** 实时监控抵押物状态和风险预警
|
||||
**So that** 我可以及时发现和处理潜在风险
|
||||
|
||||
#### 用户故事3:便捷客户服务
|
||||
**As a** 养殖企业客户
|
||||
**I want to** 通过小程序查询贷款信息和还款计划
|
||||
**So that** 我可以方便地管理自己的金融业务
|
||||
|
||||
---
|
||||
|
||||
## 3. 功能需求
|
||||
|
||||
### 3.1 核心功能模块
|
||||
|
||||
#### 3.1.1 用户认证与权限管理
|
||||
**功能描述**:基于现有银行后端系统的用户认证和角色权限管理
|
||||
|
||||
**主要功能**:
|
||||
- 微信授权登录
|
||||
- 手机号验证
|
||||
- 角色权限验证
|
||||
- 会话管理
|
||||
- 安全退出
|
||||
|
||||
**验收标准**:
|
||||
- 支持微信一键登录
|
||||
- 集成现有银行用户体系
|
||||
- 实现基于角色的功能访问控制
|
||||
- 会话超时自动跳转登录页
|
||||
|
||||
#### 3.1.2 客户信息管理
|
||||
**功能描述**:银行客户信息的查询、管理和维护
|
||||
|
||||
**主要功能**:
|
||||
- 客户基本信息查询
|
||||
- 客户信用评级查看
|
||||
- 客户资产信息展示
|
||||
- 客户联系记录管理
|
||||
- 客户标签分类
|
||||
|
||||
**验收标准**:
|
||||
- 支持多条件客户搜索
|
||||
- 客户信息实时同步
|
||||
- 敏感信息权限控制
|
||||
- 客户互动记录完整
|
||||
|
||||
#### 3.1.3 信贷业务管理
|
||||
**功能描述**:信贷申请、审批、放款、还款全流程管理
|
||||
|
||||
**主要功能**:
|
||||
- 信贷申请查看和处理
|
||||
- 信贷审批流程管理
|
||||
- 放款进度跟踪
|
||||
- 还款计划管理
|
||||
- 逾期提醒处理
|
||||
|
||||
**验收标准**:
|
||||
- 审批流程状态实时更新
|
||||
- 支持移动端审批操作
|
||||
- 还款提醒及时推送
|
||||
- 逾期处理流程完整
|
||||
|
||||
#### 3.1.4 抵押物监控
|
||||
**功能描述**:养殖资产作为抵押物的实时监控和管理
|
||||
|
||||
**主要功能**:
|
||||
- 抵押物基本信息查看
|
||||
- 抵押物价值评估
|
||||
- 抵押物状态监控
|
||||
- 抵押物变更记录
|
||||
- 抵押物风险预警
|
||||
|
||||
**验收标准**:
|
||||
- 抵押物信息实时更新
|
||||
- 价值评估算法准确
|
||||
- 异常状态及时预警
|
||||
- 变更记录完整追溯
|
||||
|
||||
#### 3.1.5 风险预警系统
|
||||
**功能描述**:基于多维度数据的风险识别和预警
|
||||
|
||||
**主要功能**:
|
||||
- 风险等级评估
|
||||
- 预警信息推送
|
||||
- 风险处理建议
|
||||
- 风险趋势分析
|
||||
- 预警历史记录
|
||||
|
||||
**验收标准**:
|
||||
- 风险评估模型准确
|
||||
- 预警推送及时有效
|
||||
- 处理建议具有指导性
|
||||
- 趋势分析直观易懂
|
||||
|
||||
#### 3.1.6 数据统计分析
|
||||
**功能描述**:业务数据的统计分析和可视化展示
|
||||
|
||||
**主要功能**:
|
||||
- 业务数据概览
|
||||
- 风险指标统计
|
||||
- 客户分布分析
|
||||
- 业绩指标展示
|
||||
- 趋势图表分析
|
||||
|
||||
**验收标准**:
|
||||
- 数据统计准确及时
|
||||
- 图表展示清晰美观
|
||||
- 支持多维度分析
|
||||
- 数据导出功能完善
|
||||
|
||||
### 3.2 辅助功能模块
|
||||
|
||||
#### 3.2.1 消息通知
|
||||
- 系统消息推送
|
||||
- 业务提醒通知
|
||||
- 风险预警通知
|
||||
- 客户互动消息
|
||||
|
||||
#### 3.2.2 文档管理
|
||||
- 合同文档查看
|
||||
- 资料上传下载
|
||||
- 文档版本管理
|
||||
- 电子签名支持
|
||||
|
||||
#### 3.2.3 设置中心
|
||||
- 个人信息设置
|
||||
- 通知偏好设置
|
||||
- 安全设置管理
|
||||
- 系统参数配置
|
||||
|
||||
---
|
||||
|
||||
## 4. 非功能需求
|
||||
|
||||
### 4.1 性能要求
|
||||
- **响应时间**:页面加载时间 < 3秒,接口响应时间 < 2秒
|
||||
- **并发用户**:支持1000+并发用户同时使用
|
||||
- **数据同步**:关键数据实时同步,延迟 < 5秒
|
||||
- **离线支持**:支持基础功能离线查看
|
||||
|
||||
### 4.2 安全要求
|
||||
- **数据加密**:敏感数据传输和存储加密
|
||||
- **访问控制**:基于角色的细粒度权限控制
|
||||
- **审计日志**:完整的操作日志记录
|
||||
- **合规性**:符合银行业数据安全规范
|
||||
|
||||
### 4.3 兼容性要求
|
||||
- **微信版本**:支持微信7.0+版本
|
||||
- **设备兼容**:支持iOS 12+、Android 8+
|
||||
- **屏幕适配**:支持主流手机屏幕尺寸
|
||||
- **网络环境**:支持4G/5G/WiFi网络
|
||||
|
||||
### 4.4 可扩展性要求
|
||||
- **模块化设计**:支持功能模块独立开发和部署
|
||||
- **接口标准化**:遵循RESTful API设计规范
|
||||
- **配置化管理**:支持业务规则和参数配置化
|
||||
- **多租户支持**:支持多银行机构独立使用
|
||||
|
||||
---
|
||||
|
||||
## 5. 技术架构
|
||||
|
||||
### 5.1 前端技术栈
|
||||
- **开发框架**:Vue.js 3.x + uni-app
|
||||
- **状态管理**:Pinia
|
||||
- **UI组件**:自定义组件 + uni-app内置组件
|
||||
- **网络请求**:基于uni.request()封装
|
||||
- **构建工具**:HBuilderX + Vite
|
||||
|
||||
### 5.2 后端集成
|
||||
- **API接口**:完全复用现有bank-backend系统
|
||||
- **数据模型**:User、Account、Transaction、Role等
|
||||
- **认证方式**:JWT Token认证
|
||||
- **数据格式**:JSON格式数据交换
|
||||
|
||||
### 5.3 部署架构
|
||||
- **小程序发布**:微信小程序平台
|
||||
- **后端服务**:复用现有bank-backend服务
|
||||
- **数据库**:复用现有MySQL数据库
|
||||
- **文件存储**:支持本地存储和云存储
|
||||
|
||||
---
|
||||
|
||||
## 6. 数据字典
|
||||
|
||||
### 6.1 核心数据实体
|
||||
|
||||
#### 6.1.1 用户信息 (User)
|
||||
| 字段名 | 类型 | 说明 | 示例 |
|
||||
|--------|------|------|------|
|
||||
| id | Integer | 用户ID | 1001 |
|
||||
| username | String | 用户名 | zhangsan |
|
||||
| real_name | String | 真实姓名 | 张三 |
|
||||
| phone | String | 手机号 | 13800138000 |
|
||||
| role_id | Integer | 角色ID | 1 |
|
||||
| status | Enum | 用户状态 | active |
|
||||
|
||||
#### 6.1.2 账户信息 (Account)
|
||||
| 字段名 | 类型 | 说明 | 示例 |
|
||||
|--------|------|------|------|
|
||||
| id | Integer | 账户ID | 2001 |
|
||||
| account_number | String | 账户号码 | 6228480012345678 |
|
||||
| user_id | Integer | 用户ID | 1001 |
|
||||
| account_type | Enum | 账户类型 | savings |
|
||||
| balance | BigInt | 账户余额(分) | 100000 |
|
||||
| status | Enum | 账户状态 | active |
|
||||
|
||||
#### 6.1.3 交易记录 (Transaction)
|
||||
| 字段名 | 类型 | 说明 | 示例 |
|
||||
|--------|------|------|------|
|
||||
| id | Integer | 交易ID | 3001 |
|
||||
| transaction_number | String | 交易流水号 | TXN20250119001 |
|
||||
| account_id | Integer | 账户ID | 2001 |
|
||||
| transaction_type | Enum | 交易类型 | deposit |
|
||||
| amount | BigInt | 交易金额(分) | 50000 |
|
||||
| status | Enum | 交易状态 | completed |
|
||||
|
||||
---
|
||||
|
||||
## 7. API规范
|
||||
|
||||
### 7.1 设计原则
|
||||
- **RESTful设计**:遵循REST架构风格
|
||||
- **统一响应格式**:标准化的JSON响应结构
|
||||
- **错误处理**:完善的错误码和错误信息
|
||||
- **版本管理**:支持API版本控制
|
||||
|
||||
### 7.2 核心接口
|
||||
|
||||
#### 7.2.1 用户认证
|
||||
```
|
||||
POST /api/auth/login
|
||||
POST /api/auth/logout
|
||||
GET /api/auth/profile
|
||||
```
|
||||
|
||||
#### 7.2.2 客户管理
|
||||
```
|
||||
GET /api/users
|
||||
GET /api/users/:id
|
||||
POST /api/users
|
||||
PUT /api/users/:id
|
||||
```
|
||||
|
||||
#### 7.2.3 账户管理
|
||||
```
|
||||
GET /api/accounts
|
||||
GET /api/accounts/:id
|
||||
POST /api/accounts
|
||||
PUT /api/accounts/:id
|
||||
```
|
||||
|
||||
#### 7.2.4 交易管理
|
||||
```
|
||||
GET /api/transactions
|
||||
GET /api/transactions/:id
|
||||
POST /api/transactions/transfer
|
||||
GET /api/transactions/stats
|
||||
```
|
||||
|
||||
### 7.3 响应格式
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {},
|
||||
"message": "操作成功",
|
||||
"timestamp": "2025-01-19T10:30:00Z"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. 部署要求
|
||||
|
||||
### 8.1 硬件要求
|
||||
- **服务器配置**:复用现有bank-backend服务器
|
||||
- **存储空间**:小程序包大小 < 2MB
|
||||
- **网络带宽**:支持高并发访问
|
||||
|
||||
### 8.2 软件要求
|
||||
- **Node.js版本**:16.20.2(与保险小程序保持一致)
|
||||
- **微信开发者工具**:最新稳定版
|
||||
- **后端服务**:复用现有bank-backend服务
|
||||
|
||||
### 8.3 部署架构
|
||||
- **开发环境**:本地开发 + 测试后端
|
||||
- **测试环境**:微信开发者工具预览
|
||||
- **生产环境**:微信小程序平台发布
|
||||
|
||||
---
|
||||
|
||||
## 9. 项目计划
|
||||
|
||||
### 9.1 开发阶段
|
||||
|
||||
#### 第一阶段:基础框架搭建(1周)
|
||||
- 项目初始化和环境配置
|
||||
- 基础组件和工具类开发
|
||||
- 用户认证和权限管理
|
||||
- 基础页面框架搭建
|
||||
|
||||
#### 第二阶段:核心功能开发(3周)
|
||||
- 客户信息管理模块
|
||||
- 信贷业务管理模块
|
||||
- 抵押物监控模块
|
||||
- 风险预警系统
|
||||
|
||||
#### 第三阶段:辅助功能开发(2周)
|
||||
- 数据统计分析模块
|
||||
- 消息通知功能
|
||||
- 文档管理功能
|
||||
- 设置中心功能
|
||||
|
||||
#### 第四阶段:测试优化(1周)
|
||||
- 功能测试和性能优化
|
||||
- 兼容性测试
|
||||
- 安全性测试
|
||||
- 用户体验优化
|
||||
|
||||
### 9.2 里程碑
|
||||
- **M1**:基础框架完成,用户认证可用
|
||||
- **M2**:核心业务功能完成,基本可用
|
||||
- **M3**:所有功能完成,进入测试阶段
|
||||
- **M4**:测试完成,准备发布上线
|
||||
|
||||
---
|
||||
|
||||
## 10. 风险与约束
|
||||
|
||||
### 10.1 技术风险
|
||||
- **微信平台限制**:小程序功能和性能限制
|
||||
- **后端依赖**:依赖现有bank-backend系统稳定性
|
||||
- **数据同步**:实时数据同步的技术挑战
|
||||
- **安全合规**:银行业安全规范的严格要求
|
||||
|
||||
### 10.2 业务风险
|
||||
- **用户接受度**:银行人员对移动端工具的接受程度
|
||||
- **业务复杂性**:银行业务流程的复杂性和特殊性
|
||||
- **监管要求**:金融监管政策的变化影响
|
||||
- **竞争压力**:同类产品的竞争压力
|
||||
|
||||
### 10.3 项目约束
|
||||
- **开发周期**:7周开发周期的时间约束
|
||||
- **资源限制**:开发人员和测试资源的限制
|
||||
- **预算控制**:项目预算和成本控制要求
|
||||
- **质量标准**:银行级应用的高质量标准
|
||||
|
||||
---
|
||||
|
||||
## 11. 附录
|
||||
|
||||
### 11.1 参考文档
|
||||
- 银行监管系统需求文档
|
||||
- 现有bank-backend API文档
|
||||
- 保险小程序开发经验总结
|
||||
- 微信小程序开发规范
|
||||
|
||||
### 11.2 术语表
|
||||
- **PRD**:Product Requirements Document,产品需求文档
|
||||
- **API**:Application Programming Interface,应用程序接口
|
||||
- **JWT**:JSON Web Token,JSON网络令牌
|
||||
- **RBAC**:Role-Based Access Control,基于角色的访问控制
|
||||
|
||||
### 11.3 联系方式
|
||||
- **产品经理**:负责需求确认和产品规划
|
||||
- **技术负责人**:负责技术架构和开发指导
|
||||
- **测试负责人**:负责测试计划和质量保证
|
||||
- **项目经理**:负责项目进度和资源协调
|
||||
|
||||
---
|
||||
|
||||
**文档状态**:已完成
|
||||
**最后更新**:2025-01-19
|
||||
**下次评审**:待定
|
||||
Reference in New Issue
Block a user