汽车代办服务系统详细设计说明书

1. 引言

1.1 编写目的

本文档旨在详细描述汽车代办服务系统的设计细节，包括模块设计、接口设计、数据库设计等，为开发人员提供明确的开发指导，确保系统能够满足业务需求并具备良好的扩展性和维护性。

1.2 项目背景

随着汽车保有量的增加，车主对于车辆上牌、过户、年检、违章处理等代办服务的需求日益增长。为提升服务效率和客户体验，需建设一套集成化、智能化的汽车代办服务系统，实现业务流程数字化、信息透明化、服务智能化。

项目名称: 汽车代办服务系统 开发单位: [开发单位名称]
用户群体: 管理员、代理商、客户、财务人员、运营人员

1.3 术语定义

1.4 参考资料

• 《汽车代办服务系统需求文档》
• 《系统架构设计规范》
• 《数据库设计规范》
• 《API 接口设计规范》

2. 系统概述

2.1 系统目标

• 主要目标: 搭建高效、稳定、安全的汽车代办服务后台管理平台
• 功能目标: 支持多角色协作、流程自动化、数据统计分析
• 性能目标: 页面响应时间 ≤2 秒，支持 500 人同时在线
• 安全目标: 数据加密传输存储，多角色权限认证

2.2 系统架构

2.2.1 整体架构

系统采用前后端分离的单体架构：

单体架构优势：

• 开发简单: 所有功能模块集中在一个应用中，开发、测试、部署相对简单
• 性能优良: 避免了微服务间的网络调用开销，系统响应更快
• 维护方便: 代码集中管理，问题定位和修复更加便捷
• 资源利用率高: 减少了服务间的资源消耗，整体资源利用率更高
• 数据一致性: 所有业务操作在同一事务中，数据一致性更容易保证
• 成本较低: 减少了基础设施和运维成本

单体架构部署：

• 应用部署: 单个 Spring Boot 应用，包含所有业务模块
• 数据库: 统一使用 MySQL 数据库，所有业务数据集中存储
• 缓存: 使用 Redis 作为统一缓存，提升系统性能
• 负载均衡: 可通过 Nginx 实现多实例负载均衡
• 监控: 统一监控应用性能、数据库性能、系统资源使用情况

2.2.2 系统功能架构

2.2.3 核心模块

1. 用户管理模块: 管理员、代理商、客户信息管理
2. 订单管理模块: 代办订单全流程管理
3. 车辆管理模块: 车辆信息及办理记录管理
4. 服务管理模块: 服务类型及价格配置
5. 财务管理模块: 订单收支及结算管理
6. 资金管理模块: 财务数据统计及可视化
7. 检测站管理模块: 检测站信息及业务管理
8. 代驾管理模块: 代驾服务及人员管理
9. 客户管理模块: 客户信息及积分管理
10. 部门管理模块: 组织架构管理
11. 角色管理模块: 角色及权限管理
12. 菜单管理模块: 系统菜单配置
13. 字典管理模块: 系统字典维护
14. 通知管理模块: 消息推送及公告管理
15. 统计分析模块: 业务数据统计及报表
16. 系统配置模块: 系统参数配置

2.3 运行环境

2.3.1 硬件环境

• 服务器: 4 核 8G 内存，100GB 存储空间
• 数据库服务器: 8 核 16G 内存，500GB 存储空间
• 缓存服务器: 2 核 4G 内存，50GB 存储空间

2.3.2 软件环境

• 操作系统: CentOS 7.6 / Ubuntu 18.04
• 数据库: MySQL 8.0
• 缓存: Redis 6.0
• 消息队列: RabbitMQ 3.8
• 容器化: Docker 20.10

2.3.3 开发环境

• 后端: Java 11, Spring Boot 2.6
• 前端: Vue.js 3.0 / React 18.0
• 移动端: React Native 0.70
• 构建工具: Maven 3.8, Node.js 16.0

3. 模块详细设计

3.1 用户管理模块

3.1.1 功能描述

管理系统中所有用户信息，包括管理员、代理商、客户等不同角色的用户，提供用户注册、登录、权限分配、信息维护等功能。

3.1.2 输入输出

• 输入: 用户注册信息、登录凭证、权限配置、用户信息更新
• 输出: 用户认证结果、用户信息、权限列表、操作日志

3.1.3 处理流程

用户注册/登录流程

权限验证流程

3.1.4 接口设计

用户注册接口

• 接口名称: /api/user/register
• 请求方法: POST
• 请求参数:
  • username: String (必填) - 用户名
  • password: String (必填) - 密码
  • email: String (必填) - 邮箱
  • phone: String (必填) - 手机号
  • role: String (必填) - 用户角色
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 用户信息

用户登录接口

• 接口名称: /api/user/login
• 请求方法: POST
• 请求参数:
  • username: String (必填) - 用户名
  • password: String (必填) - 密码
  • captcha: String (必填) - 验证码
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 包含 token 和用户信息

3.2 订单管理模块

3.2.1 功能描述

管理代办订单的全生命周期，包括订单创建、状态流转、进度跟踪、订单查询等功能，支持多种代办服务类型的订单处理。

3.2.2 输入输出

• 输入: 订单创建信息、状态更新、进度信息、查询条件
• 输出: 订单详情、状态列表、进度信息、统计数据

3.2.3 处理流程

订单创建流程

订单状态流转

订单进度跟踪

3.2.4 接口设计

创建订单接口

• 接口名称: /api/order/create
• 请求方法: POST
• 请求参数:
  • serviceType: String (必填) - 服务类型
  • vehicleInfo: Object (必填) - 车辆信息
  • customerInfo: Object (必填) - 客户信息
  • documents: Array (必填) - 证件文件列表
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 订单信息

更新订单状态接口

• 接口名称: /api/order/status/update
• 请求方法: PUT
• 请求参数:
  • orderId: Long (必填) - 订单 ID
  • status: String (必填) - 新状态
  • remark: String (可选) - 备注信息
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息

3.3 车辆管理模块

3.3.1 功能描述

管理车辆基础信息、证件信息、办理记录等，支持车辆信息的录入、查询、更新，以及车辆历史办理记录的追踪。

3.3.2 输入输出

• 输入: 车辆信息、证件文件、查询条件
• 输出: 车辆详情、证件信息、办理记录、统计数据

3.3.3 处理流程

车辆信息录入流程

车辆查询流程

3.3.4 接口设计

添加车辆信息接口

• 接口名称: /api/vehicle/add
• 请求方法: POST
• 请求参数:
  • brand: String (必填) - 品牌
  • model: String (必填) - 型号
  • plateNumber: String (必填) - 车牌号
  • vinCode: String (必填) - VIN 码
  • ownerInfo: Object (必填) - 车主信息
  • documents: Array (必填) - 证件文件
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 车辆信息

查询车辆信息接口

• 接口名称: /api/vehicle/query
• 请求方法: GET
• 请求参数:
  • plateNumber: String (可选) - 车牌号
  • vinCode: String (可选) - VIN 码
  • ownerPhone: String (可选) - 车主手机号
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 车辆信息及历史记录

3.4 服务管理模块

3.4.1 功能描述

配置和管理可办理的服务类型，包括服务价格设置、办理流程配置、材料清单管理等，为订单创建提供基础配置支持。

3.4.2 输入输出

• 输入: 服务类型信息、价格配置、流程设置、材料清单
• 输出: 服务列表、价格信息、流程配置、材料要求

3.4.3 处理流程

服务配置流程

价格计算流程

3.4.4 接口设计

创建服务类型接口

• 接口名称: /api/service/create
• 请求方法: POST
• 请求参数:
  • serviceName: String (必填) - 服务名称
  • serviceCode: String (必填) - 服务代码
  • basePrice: BigDecimal (必填) - 基础价格
  • description: String (可选) - 服务描述
  • materials: Array (必填) - 材料清单
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 服务信息

查询服务列表接口

• 接口名称: /api/service/list
• 请求方法: GET
• 请求参数:
  • status: String (可选) - 服务状态
  • page: Integer (可选) - 页码
  • size: Integer (可选) - 每页大小
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 服务列表及分页信息

3.5 财务管理模块

3.5.1 功能描述

管理订单收支明细、代理商结算、财务报表等财务相关功能，提供完整的财务管理解决方案。

3.5.2 输入输出

• 输入: 订单支付信息、结算数据、查询条件
• 输出: 收支明细、结算报表、财务报表、统计数据

3.5.3 处理流程

订单支付流程

代理商结算流程

3.5.4 接口设计

订单支付接口

• 接口名称: /api/finance/pay
• 请求方法: POST
• 请求参数:
  • orderId: Long (必填) - 订单 ID
  • payMethod: String (必填) - 支付方式
  • amount: BigDecimal (必填) - 支付金额
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 支付结果

代理商结算接口

• 接口名称: /api/finance/agent/settle
• 请求方法: POST
• 请求参数:
  • agentId: Long (必填) - 代理商 ID
  • startDate: String (必填) - 开始日期
  • endDate: String (必填) - 结束日期
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 结算信息

3.6 通知管理模块

3.6.1 功能描述

管理订单进度通知、系统公告、异常提醒等消息推送功能，支持多种通知方式（短信、微信、APP 推送）。

3.6.2 输入输出

• 输入: 通知内容、接收对象、通知类型、发送时间
• 输出: 发送状态、通知历史、统计信息

3.6.3 处理流程

消息发送流程

通知模板管理

3.6.4 接口设计

发送通知接口

• 接口名称: /api/notification/send
• 请求方法: POST
• 请求参数:
  • templateId: String (必填) - 模板 ID
  • recipients: Array (必填) - 接收对象
  • params: Object (可选) - 模板参数
  • sendTime: String (可选) - 发送时间
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 发送结果

查询通知历史接口

• 接口名称: /api/notification/history
• 请求方法: GET
• 请求参数:
  • userId: Long (可选) - 用户 ID
  • type: String (可选) - 通知类型
  • startDate: String (可选) - 开始日期
  • endDate: String (可选) - 结束日期
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 通知历史列表

3.7 资金管理模块

3.7.1 功能描述

管理系统的财务数据，包括营业额、净利润、支出等，提供财务数据统计、分析和可视化展示功能。

3.7.2 输入输出

• 输入: 订单收入数据、支出记录、时间范围、统计维度
• 输出: 财务统计数据、图表展示、财务报表、趋势分析

3.7.3 处理流程

财务数据统计流程

数据可视化流程

3.7.4 接口设计

获取财务统计数据接口

• 接口名称: /api/finance/statistics
• 请求方法: GET
• 请求参数:
  • timeRange: String (必填) - 时间范围(day/week/month)
  • startDate: String (可选) - 开始日期
  • endDate: String (可选) - 结束日期
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 财务统计数据

获取财务趋势图表接口

• 接口名称: /api/finance/trend
• 请求方法: GET
• 请求参数:
  • chartType: String (必填) - 图表类型
  • timeRange: String (必填) - 时间范围
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 图表数据

3.8 检测站管理模块

3.8.1 功能描述

管理系统中的检测站信息及业务，包括检测站的增删改查、业务统计、服务评价等功能。

3.8.2 输入输出

• 输入: 检测站信息、业务数据、评价信息、查询条件
• 输出: 检测站列表、业务统计、评价数据、详细信息

3.8.3 处理流程

检测站管理流程

检测站业务统计流程

3.8.4 接口设计

添加检测站接口

• 接口名称: /api/inspection-station/add
• 请求方法: POST
• 请求参数:
  • stationName: String (必填) - 检测站名称
  • stationCode: String (必填) - 检测站编码
  • address: String (必填) - 检测站地址
  • contactPhone: String (必填) - 联系电话
  • serviceTypes: Array (必填) - 服务类型
  • status: Integer (必填) - 状态
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 检测站信息

查询检测站列表接口

• 接口名称: /api/inspection-station/list
• 请求方法: GET
• 请求参数:
  • page: Integer (可选) - 页码
  • size: Integer (可选) - 每页大小
  • status: Integer (可选) - 状态
  • keyword: String (可选) - 关键词
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 检测站列表及分页信息

3.9 代驾管理模块

3.9.1 功能描述

管理系统中的代驾服务及代驾人员，包括代驾人员的增删改查、订单分配、服务评价、费用结算等功能。

3.9.2 输入输出

• 输入: 代驾人员信息、订单分配、评价数据、结算信息
• 输出: 代驾人员列表、订单状态、评价统计、结算报表

3.9.3 处理流程

代驾人员管理流程

代驾订单分配流程

3.9.4 接口设计

添加代驾人员接口

• 接口名称: /api/driver/add
• 请求方法: POST
• 请求参数:
  • driverName: String (必填) - 代驾人员姓名
  • phone: String (必填) - 联系电话
  • idCard: String (必填) - 身份证号
  • licenseNumber: String (必填) - 驾驶证号
  • serviceArea: Array (必填) - 服务区域
  • hourlyRate: BigDecimal (必填) - 小时费率
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 代驾人员信息

分配代驾订单接口

• 接口名称: /api/driver/assign-order
• 请求方法: POST
• 请求参数:
  • orderId: Long (必填) - 订单 ID
  • driverId: Long (必填) - 代驾人员 ID
  • pickupLocation: String (必填) - 接车地点
  • dropoffLocation: String (必填) - 送车地点
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 分配结果

3.10 客户管理模块

3.10.1 功能描述

管理客户信息及历史订单，包括客户信息的增删改查、实名认证、历史订单查询、积分管理等功能。

3.10.2 输入输出

• 输入: 客户信息、认证数据、查询条件、积分操作
• 输出: 客户列表、认证状态、历史订单、积分信息

3.10.3 处理流程

客户信息管理流程

客户积分管理流程

3.10.4 接口设计

添加客户信息接口

• 接口名称: /api/customer/add
• 请求方法: POST
• 请求参数:
  • customerName: String (必填) - 客户姓名
  • phone: String (必填) - 手机号
  • idCard: String (必填) - 身份证号
  • email: String (可选) - 邮箱
  • address: String (可选) - 地址
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 客户信息

客户实名认证接口

• 接口名称: /api/customer/verify
• 请求方法: POST
• 请求参数:
  • customerId: Long (必填) - 客户 ID
  • idCardFront: String (必填) - 身份证正面照片
  • idCardBack: String (必填) - 身份证背面照片
  • facePhoto: String (必填) - 人脸照片
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 认证结果

3.11 部门管理模块

3.11.1 功能描述

管理系统的组织架构，包括部门的增删改查、层级管理、人员统计等功能。

3.11.2 输入输出

• 输入: 部门信息、层级关系、查询条件
• 输出: 部门列表、层级结构、人员统计、详细信息

3.11.3 处理流程

部门管理流程

部门人员统计流程

3.11.4 接口设计

添加部门接口

• 接口名称: /api/department/add
• 请求方法: POST
• 请求参数:
  • deptName: String (必填) - 部门名称
  • deptCode: String (必填) - 部门编码
  • parentId: Long (可选) - 父部门 ID
  • leaderId: Long (可选) - 部门负责人 ID
  • description: String (可选) - 部门描述
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 部门信息

查询部门树结构接口

• 接口名称: /api/department/tree
• 请求方法: GET
• 请求参数:
  • includeDisabled: Boolean (可选) - 是否包含禁用部门
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Array - 部门树结构

3.12 角色管理模块

3.12.1 功能描述

管理系统角色及权限分配，包括角色的增删改查、权限配置、用户关联等功能。

3.12.2 输入输出

• 输入: 角色信息、权限配置、用户关联、查询条件
• 输出: 角色列表、权限信息、用户列表、详细信息

3.12.3 处理流程

角色管理流程

权限配置流程

3.12.4 接口设计

添加角色接口

• 接口名称: /api/role/add
• 请求方法: POST
• 请求参数:
  • roleName: String (必填) - 角色名称
  • roleCode: String (必填) - 角色编码
  • description: String (可选) - 角色描述
  • menuIds: Array (可选) - 菜单权限 ID 列表
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 角色信息

配置角色权限接口

• 接口名称: /api/role/permission/config
• 请求方法: POST
• 请求参数:
  • roleId: Long (必填) - 角色 ID
  • menuIds: Array (必填) - 菜单权限 ID 列表
  • dataScope: String (可选) - 数据权限范围
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息

3.13 菜单管理模块

3.13.1 功能描述

系统菜单配置与管理，包括菜单的增删改查、层级管理、权限分配等功能。

3.13.2 输入输出

• 输入: 菜单信息、层级关系、权限配置、查询条件
• 输出: 菜单列表、层级结构、权限信息、详细信息

3.13.3 处理流程

菜单管理流程

菜单权限分配流程

3.13.4 接口设计

添加菜单接口

• 接口名称: /api/menu/add
• 请求方法: POST
• 请求参数:
  • menuName: String (必填) - 菜单名称
  • parentId: Long (可选) - 父菜单 ID
  • menuType: Integer (必填) - 菜单类型
  • path: String (可选) - 路由路径
  • component: String (可选) - 组件路径
  • perms: String (可选) - 权限标识
  • icon: String (可选) - 菜单图标
  • sort: Integer (可选) - 显示顺序
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Object - 菜单信息

获取菜单树结构接口

• 接口名称: /api/menu/tree
• 请求方法: GET
• 请求参数:
  • includeDisabled: Boolean (可选) - 是否包含禁用菜单
• 响应参数:
  • code: Integer - 响应码
  • message: String - 响应消息
  • data: Array - 菜单树结构

3.14 字典管理模块

3.14.1 功能描述

系统字典项维护，包括字典类型和字典数据的增删改查、分类管理、导入导出等功能。

3.14.2 输入输出

• 输入: 字典类型信息、字典数据、查询条件、导入数据
• 输出: 字典列表、字典数据、分类信息、导出数据

3.14.3 处理流程

字典类型管理流程

字典数据管理流程

4. 数据库详细设计

4.1 数据库概述

系统采用 MySQL 8.0 作为主数据库，Redis 6.0 作为缓存数据库。数据库设计遵循第三范式，确保数据一致性和完整性。

4.2 数据表结构

4.2.1 系统基础表

1. 管理员表(sys_user)

索引设计：

• 主键索引：user_id
• 唯一索引：phone
• 普通索引：user_name, account
• 复合索引：phone, create_time

2. 部门表 (sys_dept)

3. 角色信息表 (sys_role)

4. 菜单权限表 (sys_menu)

5. 岗位信息表 (sys_post)

6. 字典类型表 (sys_dict_type)

7. 字典数据表 (sys_dict_data)

8. 通知公告表 (sys_notice)

4.2.2 关联表

1. 用户和角色关联表 (sys_user_role)

2. 用户与岗位关联表 (sys_user_post)

3. 角色和菜单关联表 (sys_role_menu)

4.2.3 日志表

1. 系统访问记录表 (sys_login_log)

2. 操作日志记录表 (sys_oper_log)

4.2.4 监控表

1. 监控服务器表 (monitor_server)

2. 监控任务表 (monitor_task)

4.2.5 业务表

1. 订单表 (car_order)

2. 车辆信息表 (car_vehicle)

3. 服务类型表 (car_service_type)

4. 客户信息表 (car_customer)

5. 代理商表 (car_agent)

6. 检测站表 (car_inspection_station)

7. 代驾人员表 (car_driver)

8. 代驾订单表 (car_driver_order)

9. 支付记录表 (car_payment_record)

10. 财务统计表 (car_finance_statistics)

11. 通知记录表 (car_notification_record)

12. 积分记录表 (car_points_record)

13. 评价记录表 (car_evaluation_record)

14. 文件上传表 (car_file_upload)

15. 操作记录表 (car_operation_log)

这些业务表的具体结构将在后续版本中详细补充。

4.3 数据关系

4.3.1 主要关系

1. 用户-角色关系: 多对多关系，通过 sys_user_role 关联表实现
2. 用户-部门关系: 多对一关系，一个部门可以有多个用户
3. 用户-岗位关系: 多对多关系，通过 sys_user_post 关联表实现
4. 角色-菜单关系: 多对多关系，通过 sys_role_menu 关联表实现
5. 部门层级关系: 自关联关系，通过 parent_id 字段实现树形结构
6. 菜单层级关系: 自关联关系，通过 parent_id 字段实现树形结构
7. 字典类型-字典数据关系: 一对多关系，一个字典类型可以有多个字典数据
8. 订单-客户关系: 多对一关系，一个客户可以有多个订单
9. 订单-代理商关系: 多对一关系，一个代理商可以有多个订单
10. 订单-服务类型关系: 多对一关系，一个服务类型可以有多个订单
11. 订单-车辆关系: 多对一关系，一个车辆可以有多个订单
12. 订单-支付记录关系: 一对多关系，一个订单可以有多个支付记录
13. 客户-车辆关系: 一对多关系，一个客户可以有多个车辆
14. 客户-积分记录关系: 一对多关系，一个客户可以有多个积分记录
15. 客户-评价记录关系: 一对多关系，一个客户可以有多个评价记录
16. 代驾人员-代驾订单关系: 一对多关系，一个代驾人员可以有多个代驾订单
17. 检测站-评价关系: 一对多关系，一个检测站可以有多个评价
18. 财务统计-支出记录关系: 一对多关系，一个统计周期可以有多个支出记录

4.3.2 数据库 ER 图

4.3.3 索引设计

主键索引

• 所有表的主键字段都建立主键索引

唯一索引

• sys_user.phone - 手机号唯一索引
• sys_user.account - 账号唯一索引
• car_order.order_no - 订单号唯一索引
• car_vehicle.plate_number - 车牌号唯一索引
• car_vehicle.vin_code - VIN 码唯一索引
• car_customer.phone - 客户手机号唯一索引
• car_customer.id_card - 客户身份证号唯一索引
• car_agent.agent_code - 代理商编码唯一索引
• car_driver.driver_code - 代驾人员编码唯一索引
• car_driver.phone - 代驾人员手机号唯一索引
• car_driver.id_card - 代驾人员身份证号唯一索引
• car_inspection_station.station_code - 检测站编码唯一索引
• car_payment_record.payment_no - 支付单号唯一索引

普通索引

• sys_user.user_name - 用户姓名索引
• sys_user.create_time - 用户创建时间索引
• car_order.customer_id - 订单客户 ID 索引
• car_order.agent_id - 订单代理商 ID 索引
• car_order.order_status - 订单状态索引
• car_order.create_time - 订单创建时间索引
• car_vehicle.customer_id - 车辆客户 ID 索引
• car_vehicle.brand - 车辆品牌索引
• car_vehicle.model - 车辆型号索引
• car_customer.customer_name - 客户姓名索引
• car_customer.create_time - 客户创建时间索引
• car_agent.agent_name - 代理商名称索引
• car_driver.driver_name - 代驾人员姓名索引
• car_driver_order.driver_id - 代驾订单代驾人员 ID 索引
• car_payment_record.order_id - 支付记录订单 ID 索引
• car_payment_record.payment_status - 支付状态索引
• car_evaluation_record.order_id - 评价记录订单 ID 索引
• car_evaluation_record.customer_id - 评价记录客户 ID 索引

复合索引

• sys_user.phone, sys_user.create_time - 手机号创建时间复合索引
• car_order.customer_id, car_order.create_time - 客户 ID 创建时间复合索引
• car_order.order_status, car_order.create_time - 订单状态创建时间复合索引
• car_payment_record.order_id, car_payment_record.payment_status - 订单 ID 支付状态复合索引

4.3.4 外键约束

系统表外键约束

• sys_user.dept_id → sys_dept.dept_id
• sys_user_role.user_id → sys_user.user_id
• sys_user_role.role_id → sys_role.role_id
• sys_user_post.user_id → sys_user.user_id
• sys_user_post.post_id → sys_post.post_id
• sys_role_menu.role_id → sys_role.role_id
• sys_role_menu.menu_id → sys_menu.menu_id
• sys_dict_data.dict_type → sys_dict_type.dict_type

业务表外键约束

• car_order.customer_id → car_customer.customer_id
• car_order.agent_id → car_agent.agent_id
• car_order.service_type_id → car_service_type.service_id
• car_order.vehicle_id → car_vehicle.vehicle_id
• car_vehicle.customer_id → car_customer.customer_id
• car_driver_order.order_id → car_order.order_id
• car_driver_order.driver_id → car_driver.driver_id
• car_payment_record.order_id → car_order.order_id
• car_points_record.customer_id → car_customer.customer_id
• car_points_record.order_id → car_order.order_id
• car_evaluation_record.order_id → car_order.order_id
• car_evaluation_record.customer_id → car_customer.customer_id
• car_notification_record.recipient_id → car_customer.customer_id
• car_file_upload.upload_user_id → sys_user.user_id
• car_operation_log.operator_id → sys_user.user_id

4.3.5 数据完整性约束

非空约束

• 所有主键字段
• 业务关键字段：订单号、客户姓名、手机号、车牌号等
• 金额字段：订单金额、支付金额等
• 状态字段：订单状态、支付状态等

检查约束

• 手机号格式：11 位数字
• 身份证号格式：18 位
• 车牌号格式：符合车牌号规则
• VIN 码格式：17 位字母数字组合
• 金额字段：大于等于 0
• 评分字段：1-5 分
• 状态字段：预定义状态值

默认值约束

• 创建时间：CURRENT_TIMESTAMP
• 更新时间：CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
• 状态字段：'ACTIVE'、'PENDING'等
• 金额字段：0.00
• 数量字段：0
• 评分字段：5.00

4.3.6 分区策略

按时间分区

• car_order 表按 create_time 字段按月分区
• car_payment_record 表按 payment_time 字段按月分区
• car_evaluation_record 表按 create_time 字段按月分区
• car_operation_log 表按 operation_time 字段按月分区

按业务分区

• car_vehicle 表按 brand 字段分区
• car_order 表按 order_status 字段分区
• car_payment_record 表按 payment_status 字段分区

4.3.7 数据归档策略

归档条件

• 订单数据：完成超过 2 年的订单
• 支付记录：支付完成超过 3 年的记录
• 操作日志：超过 1 年的日志
• 评价记录：超过 2 年的评价
• 通知记录：超过 1 年的通知

归档方式

• 按时间范围批量归档
• 归档到历史表
• 保留必要的查询索引
• 定期清理归档数据

4.4 数据库性能优化

4.4.1 查询优化

1. 索引优化策略

• 为高频查询字段建立合适的索引
• 避免在索引字段上使用函数
• 合理使用复合索引，遵循最左前缀原则
• 定期分析索引使用情况，删除无用索引

2. SQL 优化

• 使用 EXPLAIN 分析查询执行计划
• 避免 SELECT *，只查询需要的字段
• 合理使用 LIMIT 分页
• 使用 JOIN 替代子查询
• 避免在 WHERE 子句中使用函数

3. 分页查询优化

-- 优化前
SELECT * FROM car_order ORDER BY create_time DESC LIMIT 10000, 20;

-- 优化后
SELECT * FROM car_order WHERE create_time < '2024-01-01'
ORDER BY create_time DESC LIMIT 20;

4.4.2 连接池配置

1. 连接池参数

# 初始连接数
spring.datasource.hikari.minimum-idle=5
# 最大连接数
spring.datasource.hikari.maximum-pool-size=20
# 连接超时时间
spring.datasource.hikari.connection-timeout=30000
# 空闲连接超时时间
spring.datasource.hikari.idle-timeout=600000
# 连接最大生命周期
spring.datasource.hikari.max-lifetime=1800000

2. 连接池监控

• 监控连接池使用情况
• 设置连接池告警阈值
• 定期清理无效连接

4.4.3 缓存策略

1. Redis 缓存配置

# Redis连接配置
spring.redis.host=localhost
spring.redis.port=6379
spring.redis.password=
spring.redis.database=0
# 连接池配置
spring.redis.lettuce.pool.max-active=8
spring.redis.lettuce.pool.max-idle=8
spring.redis.lettuce.pool.min-idle=0

2. 缓存策略

• 用户信息缓存：TTL 30 分钟
• 字典数据缓存：TTL 1 小时
• 菜单权限缓存：TTL 2 小时
• 订单状态缓存：TTL 5 分钟
• 统计数据缓存：TTL 1 小时

3. 缓存更新策略

• 写入时更新缓存
• 删除时清除缓存
• 定时刷新热点数据

4.4.4 读写分离

1. 主从配置

# 主库配置
spring.datasource.master.url=jdbc:mysql://master:3306/duke-boot
spring.datasource.master.username=root
spring.datasource.master.password=password

# 从库配置
spring.datasource.slave.url=jdbc:mysql://slave:3306/duke-boot
spring.datasource.slave.username=root
spring.datasource.slave.password=password

2. 读写分离规则

• 写操作：主库
• 读操作：从库
• 事务操作：主库
• 统计查询：从库

4.5 数据库备份策略

4.5.1 备份类型

1. 全量备份

• 频率：每日凌晨 2 点
• 保留时间：30 天
• 备份方式：mysqldump
• 压缩存储

2. 增量备份

• 频率：每小时
• 保留时间：7 天
• 备份方式：binlog
• 实时同步

3. 差异备份

• 频率：每周日
• 保留时间：4 周
• 备份方式：基于全量备份
• 压缩存储

4.5.2 备份脚本

1. 全量备份脚本

#!/bin/bash
# 全量备份脚本
DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/backup/mysql"
DB_NAME="duke-boot"
USER="root"
PASSWORD="password"

# 创建备份目录
mkdir -p $BACKUP_DIR

# 执行备份
mysqldump -u$USER -p$PASSWORD --single-transaction --routines --triggers \
    $DB_NAME > $BACKUP_DIR/full_backup_$DATE.sql

# 压缩备份文件
gzip $BACKUP_DIR/full_backup_$DATE.sql

# 删除30天前的备份
find $BACKUP_DIR -name "full_backup_*.sql.gz" -mtime +30 -delete

echo "Full backup completed: full_backup_$DATE.sql.gz"

2. 增量备份脚本

#!/bin/bash
# 增量备份脚本
DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/backup/mysql/binlog"
BINLOG_DIR="/var/lib/mysql"

# 创建备份目录
mkdir -p $BACKUP_DIR

# 获取当前binlog文件
CURRENT_BINLOG=$(mysql -e "SHOW MASTER STATUS\G" | grep File | awk '{print $2}')

# 备份binlog文件
cp $BINLOG_DIR/$CURRENT_BINLOG $BACKUP_DIR/binlog_$DATE

# 压缩备份文件
gzip $BACKUP_DIR/binlog_$DATE

# 删除7天前的备份
find $BACKUP_DIR -name "binlog_*" -mtime +7 -delete

echo "Incremental backup completed: binlog_$DATE.gz"

4.5.3 恢复策略

1. 全量恢复

#!/bin/bash
# 全量恢复脚本
BACKUP_FILE=$1
DB_NAME="duke-boot"
USER="root"
PASSWORD="password"

if [ -z "$BACKUP_FILE" ]; then
    echo "Usage: $0 <backup_file>"
    exit 1
fi

# 解压备份文件
gunzip -c $BACKUP_FILE > /tmp/restore.sql

# 恢复数据库
mysql -u$USER -p$PASSWORD $DB_NAME < /tmp/restore.sql

# 清理临时文件
rm /tmp/restore.sql

echo "Database restored from: $BACKUP_FILE"

2. 增量恢复

#!/bin/bash
# 增量恢复脚本
BINLOG_FILE=$1
DB_NAME="duke-boot"
USER="root"
PASSWORD="password"

if [ -z "$BINLOG_FILE" ]; then
    echo "Usage: $0 <binlog_file>"
    exit 1
fi

# 解压binlog文件
gunzip -c $BINLOG_FILE > /tmp/restore.binlog

# 应用binlog
mysqlbinlog /tmp/restore.binlog | mysql -u$USER -p$PASSWORD

# 清理临时文件
rm /tmp/restore.binlog

echo "Incremental restore completed from: $BINLOG_FILE"

4.5.4 备份监控

1. 备份状态监控

-- 检查备份状态
SELECT
    backup_type,
    backup_time,
    backup_size,
    backup_status,
    backup_duration
FROM backup_log
WHERE backup_time >= DATE_SUB(NOW(), INTERVAL 1 DAY)
ORDER BY backup_time DESC;

2. 备份告警

• 备份失败告警
• 备份文件大小异常告警
• 备份时间过长告警
• 磁盘空间不足告警

4.6 数据库安全

4.6.1 访问控制

1. 用户权限管理

-- 创建应用用户
CREATE USER 'app_user'@'%' IDENTIFIED BY 'strong_password';

-- 授予必要权限
GRANT SELECT, INSERT, UPDATE, DELETE ON duke-boot.* TO 'app_user'@'%';

-- 创建只读用户
CREATE USER 'readonly_user'@'%' IDENTIFIED BY 'readonly_password';

-- 授予只读权限
GRANT SELECT ON duke-boot.* TO 'readonly_user'@'%';

2. 网络访问控制

• 限制数据库访问 IP
• 使用 SSL 连接
• 配置防火墙规则

4.6.2 数据加密

1. 传输加密

# 启用SSL连接
spring.datasource.url=jdbc:mysql://localhost:3306/duke-boot?useSSL=true&requireSSL=true

2. 存储加密

• 敏感字段加密存储
• 使用 AES 加密算法
• 密钥安全管理

4.6.3 审计日志

1. 启用审计日志

-- 启用审计日志
SET GLOBAL audit_log = ON;
SET GLOBAL audit_log_file = '/var/log/mysql/audit.log';

2. 审计内容

• 用户登录记录
• 数据修改记录
• 权限变更记录
• 异常访问记录

4.7 数据库监控

4.7.1 性能监控

1. 关键指标

• 连接数
• 查询响应时间
• 慢查询数量
• 锁等待时间
• 缓存命中率

2. 监控脚本

-- 查看当前连接数
SHOW STATUS LIKE 'Threads_connected';

-- 查看慢查询
SHOW VARIABLES LIKE 'slow_query_log';
SHOW VARIABLES LIKE 'long_query_time';

-- 查看锁等待
SHOW ENGINE INNODB STATUS;

4.7.2 容量监控

1. 存储空间

• 数据库大小
• 表空间使用情况
• 索引大小
• 日志文件大小

2. 增长趋势

• 数据增长速率
• 备份文件大小
• 日志文件增长

4.7.3 告警配置

1. 告警阈值

• 连接数 > 80%
• 慢查询 > 10 个/分钟
• 锁等待 > 5 秒
• 磁盘使用率 > 85%

2. 告警方式

• 邮件通知
• 短信通知
• 钉钉/企业微信通知
• 系统日志记录

5. 系统配置

5.1 系统参数配置

系统参数配置包括系统基本配置、安全配置、性能配置等，为系统运行提供基础支持。

5.2 配置文件

系统配置文件包括 application.properties 和 application.yml，分别用于配置系统参数和环境变量。

5.3 配置管理

系统配置管理包括配置的增删改查、版本控制、动态刷新等功能，为系统配置的灵活管理提供支持。

单体架构配置管理特点：

• 集中配置: 所有配置集中在 application.yml 文件中管理
• 环境分离: 通过 Spring Profiles 实现开发、测试、生产环境配置分离
• 动态刷新: 支持配置热更新，无需重启应用
• 配置加密: 敏感配置支持加密存储
• 配置验证: 启动时验证配置项的有效性
• 配置监控: 监控配置变更和应用状态

6. 系统部署

6.1 部署环境

系统部署环境包括硬件环境、软件环境、网络环境等，为系统部署提供基础支持。

单体架构部署特点：

• 应用部署: 单个 Spring Boot 应用，包含所有业务模块
• 数据库: 统一使用 MySQL 数据库，所有业务数据集中存储
• 缓存: 使用 Redis 作为统一缓存，提升系统性能
• 负载均衡: 可通过 Nginx 实现多实例负载均衡
• 容器化: 使用 Docker 容器化部署，简化环境配置
• 监控: 统一监控应用性能、数据库性能、系统资源使用情况

6.2 部署流程

系统部署流程包括环境准备、应用部署、配置初始化、数据迁移等步骤，为系统部署提供详细指导。

单体架构部署流程：

1. 环境准备: 准备服务器环境，安装 Java、MySQL、Redis 等基础软件
2. 应用打包: 使用 Maven 打包 Spring Boot 应用为 JAR 文件
3. 容器构建: 使用 Docker 构建应用镜像
4. 数据库初始化: 创建数据库，执行初始化脚本
5. 应用部署: 部署应用容器，配置环境变量
6. 负载均衡: 配置 Nginx 负载均衡（如需要多实例）
7. 监控配置: 配置应用监控、数据库监控、系统监控
8. 功能测试: 验证系统功能正常
9. 性能测试: 验证系统性能满足要求

6.3 部署工具

系统部署工具包括 Docker、Jenkins 等，为系统部署提供自动化支持。

7. 系统测试

7.1 测试环境

系统测试环境包括开发环境、测试环境、生产环境等，为系统测试提供多样化的测试场景。

7.2 测试流程

系统测试流程包括单元测试、集成测试、系统测试、性能测试等步骤，为系统测试提供全面覆盖。

7.3 测试工具

系统测试工具包括 JUnit、Mockito、Selenium、LoadRunner 等，为系统测试提供自动化支持。

8. 系统运维

8.1 监控告警

系统监控告警包括性能监控、容量监控、异常监控、日志监控等功能，为系统运维提供实时监控和告警支持。

8.2 日志管理

系统日志管理包括系统日志、操作日志、审计日志等，为系统运维提供详细的日志记录和查询功能。

8.3 备份恢复

系统备份恢复包括全量备份、增量备份、差异备份、备份监控等功能，为系统数据安全和快速恢复提供支持。

8.4 安全管理

系统安全管理包括用户权限管理、网络访问控制、数据加密、审计日志等功能，为系统安全提供全面保障。

9. 系统扩展

9.1 功能扩展

系统功能扩展包括新功能开发、现有功能优化、业务流程调整等，为系统功能升级提供支持。

单体架构功能扩展特点：

• 模块化开发: 在单体应用中按模块组织代码，便于功能扩展
• 插件化架构: 支持插件化扩展，新功能可作为插件集成
• API 版本管理: 通过 API 版本控制实现向后兼容
• 数据库扩展: 通过数据库设计支持新功能的数据存储
• 配置化扩展: 通过配置参数支持功能开关和参数调整

9.2 性能扩展

系统性能扩展包括数据库优化、缓存优化、读写分离、分页查询优化等，为系统性能提升提供支持。

单体架构性能扩展策略：

• 应用集群: 部署多个应用实例，通过负载均衡分发请求
• 数据库优化: 优化 SQL 查询、添加索引、分库分表
• 缓存策略: 使用 Redis 缓存热点数据，提升响应速度
• 异步处理: 使用消息队列处理耗时操作
• CDN 加速: 静态资源使用 CDN 加速

9.3 安全扩展

系统安全扩展包括访问控制、数据加密、审计日志、备份恢复等，为系统安全保障提供支持。

10. 系统维护

10.1 日常维护

系统日常维护包括系统监控、日志分析、性能优化、备份恢复等，为系统稳定运行提供支持。

单体架构维护特点：

• 统一监控: 监控单个应用的性能、资源使用、错误日志
• 日志集中: 所有模块的日志统一收集和分析
• 一键部署: 整个应用可以一键部署和回滚
• 问题定位: 问题定位相对简单，无需跨服务排查
• 版本管理: 统一的版本管理和发布流程

10.2 版本升级

系统版本升级包括新版本发布、旧版本升级、功能优化等，为系统功能升级提供支持。

单体架构版本升级策略：

• 全量升级: 整个应用统一升级，确保版本一致性
• 灰度发布: 通过负载均衡实现部分用户使用新版本
• 回滚机制: 快速回滚到上一个稳定版本
• 数据迁移: 数据库结构变更的统一迁移
• 兼容性测试: 确保新版本与现有数据的兼容性

10.3 故障处理

系统故障处理包括常见故障排查、应急响应、问题追踪等，为系统稳定运行提供支持。

11. 系统文档

11.1 用户手册

用户手册包括系统功能介绍、操作流程、常见问题解答等，为系统用户提供详细的使用指导。

11.2 开发文档

开发文档包括系统架构设计、模块设计、接口设计、数据库设计等，为系统开发人员提供详细的开发指导。

11.3 运维文档

运维文档包括系统部署、配置管理、监控告警、日志管理、备份恢复等，为系统运维人员提供详细的运维指导。

12. 系统评估

12.1 功能评估

系统功能评估包括系统功能覆盖率、用户体验、业务流程合理性等，为系统功能完善提供参考。

12.2 性能评估

系统性能评估包括系统响应时间、并发用户数、数据库性能等，为系统性能优化提供参考。

12.3 安全评估

系统安全评估包括系统安全性、数据安全性、访问控制等，为系统安全保障提供参考。

13. 系统迁移

13.1 迁移方案

系统迁移方案包括系统备份、数据迁移、应用部署等步骤，为系统迁移提供详细指导。

13.2 迁移工具

系统迁移工具包括 mysqldump、rsync、Ansible 等，为系统迁移提供自动化支持。

14. 系统备份

14.1 备份策略

系统备份策略包括全量备份、增量备份、差异备份、备份监控等，为系统数据安全和快速恢复提供支持。

14.2 备份工具

系统备份工具包括 mysqldump、rsync、tar 等，为系统备份提供自动化支持。