# 物业报修管理模块 - 数据库设计

## 📋 文档信息

**文档名称**：物业报修管理模块数据库设计  
**文档版本**：v1.0  
**创建日期**：2025-01-23  
**设计规范**：严格遵循 `docs/设计文档/database/mysql-database-standard.md`  
**依据文档**：功能需求清单.md

## 🎯 数据库设计原则

### 核心设计理念

1. **严格遵循项目规范**：所有表必须包含标准基础字段
2. **业务导向设计**：基于实际业务流程设计表结构
3. **性能优化**：合理设计索引，支持高效查询
4. **扩展性考虑**：预留扩展字段和机制
5. **数据完整性**：通过应用层维护关联关系

### 关键约束

-   ✅ **使用雪花 ID**作为主键
-   ✅ **强制逻辑删除**，禁止物理删除
-   ✅ **多租户支持**，所有表包含 tenant_id
-   ✅ **禁用外键约束**，关联关系通过应用层维护
-   ✅ **完整中文注释**，便于理解和维护

## 📊 数据模型概览

### 🗂️ 表结构清单

| 表名                        | 中文名称   | 用途                   | 关联关系     |
| --------------------------- | ---------- | ---------------------- | ------------ |
| `hq_pm_repair_order`        | 报修工单表 | 存储报修申请的核心信息 | 核心表       |
| `hq_pm_repair_attachment`   | 报修附件表 | 存储报修相关附件文件   | 关联报修工单 |
| `hq_pm_repair_progress`     | 维修进度表 | 记录维修过程状态变更   | 关联报修工单 |
| `hq_pm_service_evaluation`  | 服务评价表 | 存储用户服务质量评价   | 关联报修工单 |
| `hq_pm_repair_category`     | 维修类型表 | 报修类型分类配置       | 字典表       |
| `hq_pm_system_config`       | 系统配置表 | 模块系统参数配置       | 配置表       |

### 📈 数据流转关系

```mermaid
graph TD
    A[用户提交报修] --> B[hq_pm_repair_order 报修工单]
    B --> C[hq_pm_repair_attachment 附件]
    B --> D[hq_pm_repair_progress 进度]
    B --> E[hq_pm_service_evaluation 评价]
    F[hq_pm_repair_category 类型] --> B
    G[hq_pm_system_config 配置] --> B
    H[sys_user 系统用户] --> B
    H --> D
```

## 🏗️ 详细表结构设计

### 1. 报修工单表 (hq_pm_repair_order)

> **核心业务表**：存储报修申请的所有核心信息，是整个模块的数据中心

```sql
-- ----------------------------
-- Table structure for hq_pm_repair_order
-- ----------------------------
DROP TABLE IF EXISTS `hq_pm_repair_order`;
CREATE TABLE `hq_pm_repair_order` (
  -- 标准基础字段（必须）
  `id` bigint(20) NOT NULL COMMENT '主键ID',
  `tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号',
  `create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门',
  `create_by` bigint(20) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` bigint(20) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',

  -- 业务基础信息
  `order_no` varchar(50) NOT NULL COMMENT '工单编号，格式：RO+年月日+4位流水号',
  `title` varchar(200) NOT NULL COMMENT '报修标题',
  `description` text NOT NULL COMMENT '问题描述',
  `repair_location` varchar(200) NOT NULL COMMENT '报修地点',

  -- 分类和紧急程度
  `category_id` bigint(20) NOT NULL COMMENT '维修类型ID，关联hq_pm_repair_category.id',
  `priority_level` tinyint(1) NOT NULL DEFAULT 3 COMMENT '紧急程度：1-非常紧急，2-紧急，3-一般，4-不紧急，5-可延后',
  `expected_finish_time` datetime DEFAULT NULL COMMENT '期望完成时间',

  -- 报修人信息
  `reporter_id` bigint(20) NOT NULL COMMENT '报修人ID，关联sys_user.id',
  `reporter_name` varchar(50) NOT NULL COMMENT '报修人姓名',
  `reporter_phone` varchar(20) NOT NULL COMMENT '报修人电话',
  `reporter_dept` varchar(100) DEFAULT NULL COMMENT '报修人部门',

  -- 工单状态和处理信息
  `order_status` char(1) NOT NULL DEFAULT '1' COMMENT '工单状态：1-待分派，2-已分派，3-进行中，4-已完成，5-已评价，6-已归档，9-已取消',
  `assign_time` datetime DEFAULT NULL COMMENT '分派时间',
  `assignee_id` bigint(20) DEFAULT NULL COMMENT '分派维修员ID，关联sys_user.id',
  `assignee_name` varchar(50) DEFAULT NULL COMMENT '分派维修员姓名',
  `assign_remark` varchar(500) DEFAULT NULL COMMENT '分派备注说明',

  -- 处理时间信息
  `start_time` datetime DEFAULT NULL COMMENT '开始处理时间',
  `finish_time` datetime DEFAULT NULL COMMENT '完成时间',
  `total_duration` int(11) DEFAULT NULL COMMENT '总处理时长（分钟）',

  -- 处理结果
  `repair_result` text DEFAULT NULL COMMENT '维修结果描述',
  `used_materials` varchar(500) DEFAULT NULL COMMENT '使用材料清单',
  `follow_suggestions` varchar(500) DEFAULT NULL COMMENT '后续建议',

  -- 评价相关
  `evaluation_score` decimal(3,1) DEFAULT NULL COMMENT '综合评价得分（1.0-5.0）',
  `evaluation_time` datetime DEFAULT NULL COMMENT '评价时间',

  -- 统计字段
  `attachment_count` int(11) DEFAULT 0 COMMENT '附件数量',
  `progress_count` int(11) DEFAULT 0 COMMENT '进度记录数量',

  -- 其他字段
  `cancel_reason` varchar(500) DEFAULT NULL COMMENT '取消原因',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注信息',

  -- 主键和索引
  PRIMARY KEY (`id`) USING BTREE,
  UNIQUE KEY `uk_order_no` (`order_no`, `tenant_id`),
  KEY `idx_tenant_id` (`tenant_id`),
  KEY `idx_deleted` (`deleted`),
  KEY `idx_order_status` (`order_status`),
  KEY `idx_priority_level` (`priority_level`),
  KEY `idx_create_time` (`create_time`),
  KEY `idx_reporter_id` (`reporter_id`),
  KEY `idx_assignee_id` (`assignee_id`),
  KEY `idx_category_id` (`category_id`),
  KEY `idx_assign_time` (`assign_time`),
  KEY `idx_finish_time` (`finish_time`),
  KEY `idx_tenant_status` (`tenant_id`, `order_status`, `deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报修工单表';
```

### 2. 报修附件表 (hq_pm_repair_attachment)

> **附件管理表**：存储报修过程中上传的图片、视频等多媒体文件信息

```sql
-- ----------------------------
-- Table structure for hq_pm_repair_attachment
-- ----------------------------
DROP TABLE IF EXISTS `hq_pm_repair_attachment`;
CREATE TABLE `hq_pm_repair_attachment` (
  -- 标准基础字段（必须）
  `id` bigint(20) NOT NULL COMMENT '主键ID',
  `tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号',
  `create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门',
  `create_by` bigint(20) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` bigint(20) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',

  -- 关联信息
  `order_id` bigint(20) NOT NULL COMMENT '报修工单ID，关联hq_pm_repair_order.id',

  -- 文件信息
  `file_name` varchar(200) NOT NULL COMMENT '文件原始名称',
  `file_path` varchar(500) NOT NULL COMMENT '文件存储路径',
  `file_size` bigint(20) NOT NULL COMMENT '文件大小（字节）',
  `file_type` varchar(20) NOT NULL COMMENT '文件类型：image-图片，video-视频',
  `file_extension` varchar(10) NOT NULL COMMENT '文件扩展名',
  `file_mime_type` varchar(100) DEFAULT NULL COMMENT '文件MIME类型',

  -- 上传信息
  `upload_stage` char(1) NOT NULL DEFAULT '1' COMMENT '上传阶段：1-报修申请，2-维修过程，3-完成确认',
  `uploader_id` bigint(20) NOT NULL COMMENT '上传人ID，关联sys_user.id',
  `uploader_name` varchar(50) NOT NULL COMMENT '上传人姓名',

  -- 文件处理
  `thumbnail_path` varchar(500) DEFAULT NULL COMMENT '缩略图路径（图片文件）',
  `duration` int(11) DEFAULT NULL COMMENT '时长（视频文件，秒）',
  `resolution` varchar(20) DEFAULT NULL COMMENT '分辨率（如：1920x1080）',

  -- 业务信息
  `description` varchar(200) DEFAULT NULL COMMENT '文件描述说明',
  `sort_order` int(11) DEFAULT 0 COMMENT '排序顺序',

  -- 主键和索引
  PRIMARY KEY (`id`) USING BTREE,
  KEY `idx_tenant_id` (`tenant_id`),
  KEY `idx_deleted` (`deleted`),
  KEY `idx_order_id` (`order_id`),
  KEY `idx_upload_stage` (`upload_stage`),
  KEY `idx_uploader_id` (`uploader_id`),
  KEY `idx_create_time` (`create_time`),
  KEY `idx_file_type` (`file_type`),
  KEY `idx_order_stage` (`order_id`, `upload_stage`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报修附件表';
```

### 3. 维修进度表 (hq_pm_repair_progress)

> **进度跟踪表**：记录维修过程中的每一个状态变更和进度更新

```sql
-- ----------------------------
-- Table structure for hq_pm_repair_progress
-- ----------------------------
DROP TABLE IF EXISTS `hq_pm_repair_progress`;
CREATE TABLE `hq_pm_repair_progress` (
  -- 标准基础字段（必须）
  `id` bigint(20) NOT NULL COMMENT '主键ID',
  `tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号',
  `create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门',
  `create_by` bigint(20) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` bigint(20) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',

  -- 关联信息
  `order_id` bigint(20) NOT NULL COMMENT '报修工单ID，关联hq_pm_repair_order.id',

  -- 进度信息
  `progress_type` char(1) NOT NULL COMMENT '进度类型：1-工单分派，2-接收确认，3-到达现场，4-开始维修，5-进度更新，6-完成维修，7-用户评价，8-工单归档，9-其他',
  `progress_status` varchar(50) NOT NULL COMMENT '进度状态描述',
  `progress_detail` text DEFAULT NULL COMMENT '进度详细描述',

  -- 操作人信息
  `operator_id` bigint(20) NOT NULL COMMENT '操作人ID，关联sys_user.id',
  `operator_name` varchar(50) NOT NULL COMMENT '操作人姓名',
  `operator_role` varchar(20) NOT NULL COMMENT '操作人角色：user-用户，admin-管理员，worker-维修员',

  -- 位置信息
  `location_info` varchar(200) DEFAULT NULL COMMENT '操作位置信息',
  `gps_latitude` decimal(10,7) DEFAULT NULL COMMENT 'GPS纬度',
  `gps_longitude` decimal(10,7) DEFAULT NULL COMMENT 'GPS经度',

  -- 时间信息
  `operation_time` datetime NOT NULL COMMENT '操作时间',
  `estimated_duration` int(11) DEFAULT NULL COMMENT '预计耗时（分钟）',

  -- 附加信息
  `attachment_ids` varchar(500) DEFAULT NULL COMMENT '关联附件ID列表（逗号分隔）',
  `next_step` varchar(200) DEFAULT NULL COMMENT '下一步计划',
  `issues_encountered` varchar(500) DEFAULT NULL COMMENT '遇到的问题',
  `materials_needed` varchar(200) DEFAULT NULL COMMENT '需要的材料',

  -- 其他信息
  `remark` varchar(500) DEFAULT NULL COMMENT '备注信息',

  -- 主键和索引
  PRIMARY KEY (`id`) USING BTREE,
  KEY `idx_tenant_id` (`tenant_id`),
  KEY `idx_deleted` (`deleted`),
  KEY `idx_order_id` (`order_id`),
  KEY `idx_progress_type` (`progress_type`),
  KEY `idx_operator_id` (`operator_id`),
  KEY `idx_operation_time` (`operation_time`),
  KEY `idx_create_time` (`create_time`),
  KEY `idx_order_time` (`order_id`, `operation_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='维修进度表';
```

### 4. 服务评价表 (hq_pm_service_evaluation)

> **评价反馈表**：存储用户对维修服务的多维度评价和反馈信息

```sql
-- ----------------------------
-- Table structure for hq_pm_service_evaluation
-- ----------------------------
DROP TABLE IF EXISTS `hq_pm_service_evaluation`;
CREATE TABLE `hq_pm_service_evaluation` (
  -- 标准基础字段（必须）
  `id` bigint(20) NOT NULL COMMENT '主键ID',
  `tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号',
  `create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门',
  `create_by` bigint(20) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` bigint(20) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',

  -- 关联信息
  `order_id` bigint(20) NOT NULL COMMENT '报修工单ID，关联hq_pm_repair_order.id',
  `evaluator_id` bigint(20) NOT NULL COMMENT '评价人ID，关联sys_user.id',
  `evaluator_name` varchar(50) NOT NULL COMMENT '评价人姓名',
  `evaluated_worker_id` bigint(20) NOT NULL COMMENT '被评价维修员ID，关联sys_user.id',
  `evaluated_worker_name` varchar(50) NOT NULL COMMENT '被评价维修员姓名',

  -- 评价得分（1-5星，支持小数）
  `overall_score` decimal(3,1) NOT NULL COMMENT '综合评价得分（1.0-5.0）',
  `quality_score` decimal(3,1) NOT NULL COMMENT '维修质量得分（1.0-5.0）',
  `attitude_score` decimal(3,1) NOT NULL COMMENT '服务态度得分（1.0-5.0）',
  `response_speed_score` decimal(3,1) NOT NULL COMMENT '响应速度得分（1.0-5.0）',
  `communication_score` decimal(3,1) NOT NULL COMMENT '沟通效果得分（1.0-5.0）',

  -- 评价内容
  `evaluation_content` text DEFAULT NULL COMMENT '文字评价内容',
  `satisfaction_level` char(1) NOT NULL COMMENT '满意度等级：1-非常满意，2-满意，3-一般，4-不满意，5-非常不满意',

  -- 评价设置
  `is_anonymous` tinyint(1) DEFAULT 0 COMMENT '是否匿名评价（0-实名，1-匿名）',
  `is_public` tinyint(1) DEFAULT 1 COMMENT '是否公开显示（0-不公开，1-公开）',

  -- 时间信息
  `evaluation_time` datetime NOT NULL COMMENT '评价时间',
  `service_start_time` datetime DEFAULT NULL COMMENT '服务开始时间',
  `service_end_time` datetime DEFAULT NULL COMMENT '服务结束时间',
  `service_duration` int(11) DEFAULT NULL COMMENT '服务时长（分钟）',

  -- 标签和建议
  `positive_tags` varchar(200) DEFAULT NULL COMMENT '正面标签（逗号分隔）',
  `negative_tags` varchar(200) DEFAULT NULL COMMENT '负面标签（逗号分隔）',
  `improvement_suggestions` varchar(500) DEFAULT NULL COMMENT '改进建议',

  -- 其他信息
  `remark` varchar(500) DEFAULT NULL COMMENT '备注信息',

  -- 主键和索引
  PRIMARY KEY (`id`) USING BTREE,
  UNIQUE KEY `uk_order_evaluation` (`order_id`, `tenant_id`),
  KEY `idx_tenant_id` (`tenant_id`),
  KEY `idx_deleted` (`deleted`),
  KEY `idx_evaluator_id` (`evaluator_id`),
  KEY `idx_evaluated_worker_id` (`evaluated_worker_id`),
  KEY `idx_overall_score` (`overall_score`),
  KEY `idx_satisfaction_level` (`satisfaction_level`),
  KEY `idx_evaluation_time` (`evaluation_time`),
  KEY `idx_create_time` (`create_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务评价表';
```

### 5. 维修类型表 (hq_pm_repair_category)

> **分类字典表**：存储维修类型的分类信息，支持层级结构

```sql
-- ----------------------------
-- Table structure for hq_pm_repair_category
-- ----------------------------
DROP TABLE IF EXISTS `hq_pm_repair_category`;
CREATE TABLE `hq_pm_repair_category` (
  -- 标准基础字段（必须）
  `id` bigint(20) NOT NULL COMMENT '主键ID',
  `tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号',
  `create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门',
  `create_by` bigint(20) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` bigint(20) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',

  -- 分类信息
  `category_name` varchar(50) NOT NULL COMMENT '类型名称',
  `category_code` varchar(20) NOT NULL COMMENT '类型编码',
  `category_description` varchar(200) DEFAULT NULL COMMENT '类型描述',

  -- 层级结构
  `parent_id` bigint(20) DEFAULT 0 COMMENT '父级ID，顶级为0',
  `ancestor_ids` varchar(500) DEFAULT '0' COMMENT '祖级列表（逗号分隔）',
  `level_depth` tinyint(2) DEFAULT 1 COMMENT '层级深度（1-顶级，2-二级...）',
  `children_count` int(11) DEFAULT 0 COMMENT '子类数量',

  -- 专业技能
  `required_skills` varchar(200) DEFAULT NULL COMMENT '所需专业技能（逗号分隔）',
  `skill_level` char(1) DEFAULT '1' COMMENT '技能等级要求：1-初级，2-中级，3-高级',

  -- 时间和成本预估
  `estimated_duration` int(11) DEFAULT NULL COMMENT '预估维修时长（分钟）',
  `standard_cost` decimal(10,2) DEFAULT NULL COMMENT '标准成本（元）',

  -- 显示控制
  `icon_url` varchar(200) DEFAULT NULL COMMENT '分类图标URL',
  `color_code` varchar(10) DEFAULT '#1890ff' COMMENT '分类颜色代码',
  `sort_order` int(11) DEFAULT 0 COMMENT '排序顺序',
  `status` char(1) DEFAULT '1' COMMENT '状态（0-停用，1-正常）',

  -- 统计信息
  `usage_count` int(11) DEFAULT 0 COMMENT '使用次数统计',
  `last_used_time` datetime DEFAULT NULL COMMENT '最后使用时间',

  -- 其他信息
  `remark` varchar(500) DEFAULT NULL COMMENT '备注信息',

  -- 主键和索引
  PRIMARY KEY (`id`) USING BTREE,
  UNIQUE KEY `uk_category_code` (`category_code`, `tenant_id`),
  KEY `idx_tenant_id` (`tenant_id`),
  KEY `idx_deleted` (`deleted`),
  KEY `idx_parent_id` (`parent_id`),
  KEY `idx_status` (`status`),
  KEY `idx_sort_order` (`sort_order`),
  KEY `idx_level_depth` (`level_depth`),
  KEY `idx_usage_count` (`usage_count`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='维修类型表';
```

### 6. 系统配置表 (hq_pm_system_config)

> **配置管理表**：存储物业报修模块的系统参数和配置信息

```sql
-- ----------------------------
-- Table structure for hq_pm_system_config
-- ----------------------------
DROP TABLE IF EXISTS `hq_pm_system_config`;
CREATE TABLE `hq_pm_system_config` (
  -- 标准基础字段（必须）
  `id` bigint(20) NOT NULL COMMENT '主键ID',
  `tenant_id` varchar(20) NOT NULL DEFAULT '000000' COMMENT '租户编号',
  `create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门',
  `create_by` bigint(20) DEFAULT NULL COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` bigint(20) DEFAULT NULL COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',

  -- 配置信息
  `config_key` varchar(100) NOT NULL COMMENT '配置键名',
  `config_value` text DEFAULT NULL COMMENT '配置值',
  `config_type` varchar(20) NOT NULL COMMENT '配置类型：string-字符串，number-数字，boolean-布尔，json-JSON对象',
  `config_group` varchar(50) NOT NULL COMMENT '配置分组：file-文件设置，time-时间设置，notice-通知设置，workflow-流程设置',

  -- 配置描述
  `config_name` varchar(100) NOT NULL COMMENT '配置名称',
  `config_description` varchar(500) DEFAULT NULL COMMENT '配置描述说明',
  `default_value` text DEFAULT NULL COMMENT '默认值',

  -- 配置约束
  `is_system` tinyint(1) DEFAULT 0 COMMENT '是否系统内置（0-否，1-是，系统内置不可删除）',
  `is_editable` tinyint(1) DEFAULT 1 COMMENT '是否可编辑（0-否，1-是）',
  `validation_rule` varchar(200) DEFAULT NULL COMMENT '验证规则（正则表达式或范围）',

  -- 显示控制
  `sort_order` int(11) DEFAULT 0 COMMENT '排序顺序',
  `status` char(1) DEFAULT '1' COMMENT '状态（0-停用，1-正常）',

  -- 其他信息
  `remark` varchar(500) DEFAULT NULL COMMENT '备注信息',

  -- 主键和索引
  PRIMARY KEY (`id`) USING BTREE,
  UNIQUE KEY `uk_config_key` (`config_key`, `tenant_id`),
  KEY `idx_tenant_id` (`tenant_id`),
  KEY `idx_deleted` (`deleted`),
  KEY `idx_config_group` (`config_group`),
  KEY `idx_status` (`status`),
  KEY `idx_sort_order` (`sort_order`),
  KEY `idx_is_system` (`is_system`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统配置表';
```

## 📝 数据字典

### 1. 工单状态枚举 (order_status)

| 状态码 | 状态名称 | 描述                       | 可执行操作               |
| ------ | -------- | -------------------------- | ------------------------ |
| 1      | 待分派   | 用户刚提交，等待管理员分派 | 分派、取消、修改         |
| 2      | 已分派   | 已分派给维修员，等待接收   | 接收、拒绝、重新分派     |
| 3      | 进行中   | 维修员已接收，正在处理     | 更新进度、完成、上报问题 |
| 4      | 已完成   | 维修已完成，等待评价       | 评价、重新打开           |
| 5      | 已评价   | 用户已评价，等待归档       | 归档                     |
| 6      | 已归档   | 工单已归档，流程结束       | 查看历史                 |
| 9      | 已取消   | 工单已取消                 | 查看原因                 |

### 2. 紧急程度枚举 (priority_level)

| 等级 | 名称     | 描述               | 响应时限  | 颜色标识 |
| ---- | -------- | ------------------ | --------- | -------- |
| 1    | 非常紧急 | 影响安全或正常运转 | 1 小时内  | 红色     |
| 2    | 紧急     | 影响重要功能使用   | 4 小时内  | 橙色     |
| 3    | 一般     | 常规维修需求       | 24 小时内 | 蓝色     |
| 4    | 不紧急   | 不影响使用的问题   | 72 小时内 | 绿色     |
| 5    | 可延后   | 可以安排时间处理   | 一周内    | 灰色     |

### 3. 进度类型枚举 (progress_type)

| 类型码 | 类型名称 | 操作人角色  | 描述               |
| ------ | -------- | ----------- | ------------------ |
| 1      | 工单分派 | 管理员      | 工单分派给维修员   |
| 2      | 接收确认 | 维修员      | 维修员确认接收工单 |
| 3      | 到达现场 | 维修员      | 维修员到达维修现场 |
| 4      | 开始维修 | 维修员      | 开始进行维修作业   |
| 5      | 进度更新 | 维修员      | 维修过程进度更新   |
| 6      | 完成维修 | 维修员      | 维修工作已完成     |
| 7      | 用户评价 | 用户        | 用户提交服务评价   |
| 8      | 工单归档 | 系统/管理员 | 工单归档处理       |
| 9      | 其他     | 任意角色    | 其他类型操作       |

### 4. 文件类型枚举 (file_type)

| 类型  | 名称 | 支持格式            | 大小限制 |
| ----- | ---- | ------------------- | -------- |
| image | 图片 | jpg, jpeg, png, gif | 5MB      |
| video | 视频 | mp4, avi, mov       | 50MB     |

### 5. 上传阶段枚举 (upload_stage)

| 阶段码 | 阶段名称 | 描述                   |
| ------ | -------- | ---------------------- |
| 1      | 报修申请 | 用户提交报修时上传     |
| 2      | 维修过程 | 维修员维修过程中上传   |
| 3      | 完成确认 | 维修完成时上传结果照片 |

## 🔧 索引优化策略

### 1. 核心业务查询索引

```sql
-- 报修工单表的核心查询索引
-- 1. 按状态和时间查询（管理员常用）
CREATE INDEX idx_status_time ON hq_pm_repair_order (order_status, create_time);

-- 2. 按维修员查询其工单（维修员常用）
CREATE INDEX idx_assignee_status ON hq_pm_repair_order (assignee_id, order_status);

-- 3. 按报修人查询（用户查看自己的工单）
CREATE INDEX idx_reporter_time ON hq_pm_repair_order (reporter_id, create_time);

-- 4. 按紧急程度和分派时间查询（工单分派）
CREATE INDEX idx_priority_assign ON hq_pm_repair_order (priority_level, assign_time);
```

### 2. 附件查询索引

```sql
-- 附件表的查询索引
-- 1. 按工单查询附件（最常用）
CREATE INDEX idx_order_stage ON hq_pm_repair_attachment (order_id, upload_stage);

-- 2. 按上传者查询附件
CREATE INDEX idx_uploader_time ON hq_pm_repair_attachment (uploader_id, create_time);
```

### 3. 进度查询索引

```sql
-- 进度表的查询索引
-- 1. 按工单查询进度（时间线显示）
CREATE INDEX idx_order_operation_time ON hq_pm_repair_progress (order_id, operation_time);

-- 2. 按操作人查询进度
CREATE INDEX idx_operator_time ON hq_pm_repair_progress (operator_id, operation_time);
```

## 📊 数据存储预估

### 表数据量预估

| 表名                        | 日增长量   | 年数据量     | 存储空间预估 |
| --------------------------- | ---------- | ------------ | ------------ |
| hq_pm_repair_order          | 50-100 条  | 2-4 万条     | 50-100MB     |
| hq_pm_repair_attachment     | 200-400 条 | 8-16 万条    | 100-200MB    |
| hq_pm_repair_progress       | 300-600 条 | 12-24 万条   | 150-300MB    |
| hq_pm_service_evaluation    | 40-80 条   | 1.6-3.2 万条 | 20-40MB      |
| hq_pm_repair_category       | 0-5 条     | 100-200 条   | <1MB         |
| hq_pm_system_config         | 0-2 条     | 50-100 条    | <1MB         |

### 存储优化建议

1. **定期归档**：超过 2 年的已完成工单可归档到历史表
2. **附件清理**：定期清理无效或重复的附件文件
3. **索引维护**：定期重建和优化索引
4. **分区策略**：可考虑按年份或状态分区存储

## 🔄 数据初始化脚本

### 1. 维修类型初始化数据

```sql
-- 插入基础维修类型分类
INSERT INTO `hq_pm_repair_category` (
  `id`, `tenant_id`, `category_name`, `category_code`, `category_description`,
  `parent_id`, `level_depth`, `required_skills`, `skill_level`,
  `estimated_duration`, `icon_url`, `color_code`, `sort_order`, `status`,
  `create_time`, `create_by`
) VALUES
(1, '000000', '电路维修', 'ELECTRIC', '电路、照明、开关、插座等电气设备维修', 0, 1, '电工技能', '2', 60, '/icons/electric.svg', '#ff6b35', 1, '1', NOW(), 1),
(2, '000000', '水暖维修', 'PLUMBING', '水管、暖气、卫生间、厨房设备维修', 0, 1, '水暖技能', '2', 90, '/icons/plumbing.svg', '#1890ff', 2, '1', NOW(), 1),
(3, '000000', '土建维修', 'CONSTRUCTION', '墙面、地面、天花板、门窗等土建维修', 0, 1, '泥工技能,木工技能', '2', 120, '/icons/construction.svg', '#52c41a', 3, '1', NOW(), 1),
(4, '000000', '设备维修', 'EQUIPMENT', '空调、电梯、监控等设备维修', 0, 1, '设备维修技能', '3', 90, '/icons/equipment.svg', '#722ed1', 4, '1', NOW(), 1),
(5, '000000', '园林维修', 'GARDEN', '绿化、草坪、树木修剪等园林维护', 0, 1, '园林技能', '1', 45, '/icons/garden.svg', '#13c2c2', 5, '1', NOW(), 1),
(6, '000000', '清洁维护', 'CLEANING', '日常清洁、垃圾处理、环境维护', 0, 1, '清洁技能', '1', 30, '/icons/cleaning.svg', '#fa8c16', 6, '1', NOW(), 1);
```

### 2. 系统配置初始化数据

```sql
-- 插入系统配置参数
INSERT INTO `hq_pm_system_config` (
  `id`, `tenant_id`, `config_key`, `config_value`, `config_type`, `config_group`,
  `config_name`, `config_description`, `default_value`, `is_system`, `is_editable`,
  `sort_order`, `status`, `create_time`, `create_by`
) VALUES
(1, '000000', 'file.upload.image.max_size', '5242880', 'number', 'file', '图片文件最大大小', '图片文件上传的最大字节数（5MB）', '5242880', 1, 1, 1, '1', NOW(), 1),
(2, '000000', 'file.upload.video.max_size', '52428800', 'number', 'file', '视频文件最大大小', '视频文件上传的最大字节数（50MB）', '52428800', 1, 1, 2, '1', NOW(), 1),
(3, '000000', 'file.upload.allowed_image_types', 'jpg,jpeg,png,gif', 'string', 'file', '允许的图片类型', '允许上传的图片文件类型（逗号分隔）', 'jpg,jpeg,png,gif', 1, 1, 3, '1', NOW(), 1),
(4, '000000', 'file.upload.allowed_video_types', 'mp4,avi,mov', 'string', 'file', '允许的视频类型', '允许上传的视频文件类型（逗号分隔）', 'mp4,avi,mov', 1, 1, 4, '1', NOW(), 1),
(5, '000000', 'workflow.auto_assign_enabled', 'true', 'boolean', 'workflow', '启用自动分派', '是否启用智能自动分派功能', 'false', 1, 1, 11, '1', NOW(), 1),
(6, '000000', 'workflow.auto_archive_days', '7', 'number', 'workflow', '自动归档天数', '工单评价后多少天自动归档', '7', 1, 1, 12, '1', NOW(), 1),
(7, '000000', 'time.priority1_response_hours', '1', 'number', 'time', '非常紧急响应时限', '非常紧急工单的响应时限（小时）', '1', 1, 1, 21, '1', NOW(), 1),
(8, '000000', 'time.priority2_response_hours', '4', 'number', 'time', '紧急响应时限', '紧急工单的响应时限（小时）', '4', 1, 1, 22, '1', NOW(), 1),
(9, '000000', 'time.priority3_response_hours', '24', 'number', 'time', '一般响应时限', '一般工单的响应时限（小时）', '24', 1, 1, 23, '1', NOW(), 1),
(10, '000000', 'time.working_hours_start', '08:00', 'string', 'time', '工作时间开始', '工作日开始时间（HH:mm格式）', '08:00', 1, 1, 31, '1', NOW(), 1),
(11, '000000', 'time.working_hours_end', '18:00', 'string', 'time', '工作时间结束', '工作日结束时间（HH:mm格式）', '18:00', 1, 1, 32, '1', NOW(), 1);
```

## 📋 数据迁移计划

### 迁移脚本版本规划

1. **V1.0.1** - 创建基础表结构
2. **V1.0.2** - 插入初始化数据
3. **V1.0.3** - 创建性能优化索引
4. **V1.1.0** - 功能扩展字段添加

### 部署验证清单

-   [ ] 表结构创建成功
-   [ ] 基础索引创建完成
-   [ ] 初始化数据插入成功
-   [ ] 性能索引创建完成
-   [ ] 数据完整性约束验证
-   [ ] 权限配置正确
-   [ ] 备份恢复测试通过

---

**文档状态**：✅ 初稿完成  
**关联文档**：功能需求清单.md  
**下一步**：API 接口设计