cykj/hzdyjs
1
0 Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

refactor: 物业报修模块重构

Browse Source 
1. 重命名物业报修相关类，统一添加Hq前缀
2. 更新相关文档和SQL文件
3. 优化前端样式和视图
4. 清理无用的测试文件

Issue #123
This commit is contained in:
zlwu committed 2025-07-09 16:55:24 +08:00
1 parent 90b13a6e0c
commit f969e4ff7d
68 files changed
+1956 -781
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/业务模块/property-maintenance/README.md
+11 -11
View File
@@ -273,7 +273,7 @@ sequenceDiagram
### 核心实体
#### 报修单表 (pm_repair_order)
#### 报修单表 (hq_pm_repair_order)
| 字段名 | 类型 | 长度 | 非空 | 默认值 | 说明 |
| ------------------ | ------------ | ---- | ---- | ------- | ------------- |
@@ -303,7 +303,7 @@ sequenceDiagram
| update_time | DATETIME | - | Y | - | 更新时间 |
| deleted | TINYINT | - | Y | 0 | 删除标记 |
#### 报修附件表 (pm_repair_attachment)
#### 报修附件表 (hq_pm_repair_attachment)
| 字段名 | 类型 | 长度 | 非空 | 默认值 | 说明 |
| --------------- | -------- | ---- | ---- | ------ | --------- |
@@ -321,7 +321,7 @@ sequenceDiagram
| update_time | DATETIME | - | Y | - | 更新时间 |
| deleted | TINYINT | - | Y | 0 | 删除标记 |
#### 维修进度记录表 (pm_repair_progress)
#### 维修进度记录表 (hq_pm_repair_progress)
| 字段名 | 类型 | 长度 | 非空 | 默认值 | 说明 |
| --------------- | -------- | ---- | ---- | ------ | ------------ |
@@ -341,12 +341,12 @@ sequenceDiagram
```mermaid
erDiagram
PM_REPAIR_ORDER ||--o{ PM_REPAIR_ATTACHMENT : "一对多"
PM_REPAIR_ORDER ||--o{ PM_REPAIR_PROGRESS : "一对多"
PM_REPAIR_ORDER }o--|| SYS_USER : "报修人"
PM_REPAIR_ORDER }o--|| SYS_USER : "维修员"
HQ_PM_REPAIR_ORDER ||--o{ HQ_PM_REPAIR_ATTACHMENT : "一对多"
HQ_PM_REPAIR_ORDER ||--o{ HQ_PM_REPAIR_PROGRESS : "一对多"
HQ_PM_REPAIR_ORDER }o--|| SYS_USER : "报修人"
HQ_PM_REPAIR_ORDER }o--|| SYS_USER : "维修员"
PM_REPAIR_ORDER {
HQ_PM_REPAIR_ORDER {
bigint id PK
varchar order_no UK
varchar title
@@ -357,7 +357,7 @@ erDiagram
datetime create_time
}
PM_REPAIR_ATTACHMENT {
HQ_PM_REPAIR_ATTACHMENT {
bigint id PK
bigint repair_order_id FK
varchar file_name
@@ -365,7 +365,7 @@ erDiagram
varchar file_type
}
PM_REPAIR_PROGRESS {
HQ_PM_REPAIR_PROGRESS {
bigint id PK
bigint repair_order_id FK
varchar status
@@ -610,7 +610,7 @@ src/views/maintenance/
#### 数据库命名规范
- **表名**：pm_repair_order、pm_repair_attachment、pm_repair_progress
- **表名**：hq_pm_repair_order、hq_pm_repair_attachment、hq_pm_repair_progress
- **字段名**：repair_order_id、contact_name、urgency_level
- **索引名**：idx_repair_order_status、idx_repair_order_assignee
docs/业务模块/property-maintenance/技术设计/数据库设计.md
+60 -60
View File
@@ -30,41 +30,41 @@
### 🗂️ 表结构清单
| 表名 | 中文名称 | 用途 | 关联关系 |
| ----------------------- | ---------- | ---------------------- | ------------ |
| `pm_repair_order` | 报修工单表 | 存储报修申请的核心信息 | 核心表 |
| `pm_repair_attachment` | 报修附件表 | 存储报修相关附件文件 | 关联报修工单 |
| `pm_repair_progress` | 维修进度表 | 记录维修过程状态变更 | 关联报修工单 |
| `pm_service_evaluation` | 服务评价表 | 存储用户服务质量评价 | 关联报修工单 |
| `pm_repair_category` | 维修类型表 | 报修类型分类配置 | 字典表 |
| `pm_system_config` | 系统配置表 | 模块系统参数配置 | 配置表 |
| 表名 | 中文名称 | 用途 | 关联关系 |
| --------------------------- | ---------- | ---------------------- | ------------ |
| `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[pm_repair_order 报修工单]
B --> C[pm_repair_attachment 附件]
B --> D[pm_repair_progress 进度]
B --> E[pm_service_evaluation 评价]
F[pm_repair_category 类型] --> B
G[pm_system_config 配置] --> B
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. 报修工单表 (pm_repair_order)
### 1. 报修工单表 (hq_pm_repair_order)
> **核心业务表**：存储报修申请的所有核心信息，是整个模块的数据中心
```sql
-- ----------------------------
-- Table structure for pm_repair_order
-- Table structure for hq_pm_repair_order
-- ----------------------------
DROP TABLE IF EXISTS `pm_repair_order`;
CREATE TABLE `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 '租户编号',
@@ -82,7 +82,7 @@ CREATE TABLE `pm_repair_order` (
`repair_location` varchar(200) NOT NULL COMMENT '报修地点',
-- 分类和紧急程度
`category_id` bigint(20) NOT NULL COMMENT '维修类型ID，关联pm_repair_category.id',
`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 '期望完成时间',
@@ -138,16 +138,16 @@ CREATE TABLE `pm_repair_order` (
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报修工单表';
```
### 2. 报修附件表 (pm_repair_attachment)
### 2. 报修附件表 (hq_pm_repair_attachment)
> **附件管理表**：存储报修过程中上传的图片、视频等多媒体文件信息
```sql
-- ----------------------------
-- Table structure for pm_repair_attachment
-- Table structure for hq_pm_repair_attachment
-- ----------------------------
DROP TABLE IF EXISTS `pm_repair_attachment`;
CREATE TABLE `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 '租户编号',
@@ -159,7 +159,7 @@ CREATE TABLE `pm_repair_attachment` (
`deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',
-- 关联信息
`order_id` bigint(20) NOT NULL COMMENT '报修工单ID，关联pm_repair_order.id',
`order_id` bigint(20) NOT NULL COMMENT '报修工单ID，关联hq_pm_repair_order.id',
-- 文件信息
`file_name` varchar(200) NOT NULL COMMENT '文件原始名称',
@@ -196,16 +196,16 @@ CREATE TABLE `pm_repair_attachment` (
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报修附件表';
```
### 3. 维修进度表 (pm_repair_progress)
### 3. 维修进度表 (hq_pm_repair_progress)
> **进度跟踪表**：记录维修过程中的每一个状态变更和进度更新
```sql
-- ----------------------------
-- Table structure for pm_repair_progress
-- Table structure for hq_pm_repair_progress
-- ----------------------------
DROP TABLE IF EXISTS `pm_repair_progress`;
CREATE TABLE `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 '租户编号',
@@ -217,7 +217,7 @@ CREATE TABLE `pm_repair_progress` (
`deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',
-- 关联信息
`order_id` bigint(20) NOT NULL COMMENT '报修工单ID，关联pm_repair_order.id',
`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-其他',
@@ -260,16 +260,16 @@ CREATE TABLE `pm_repair_progress` (
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='维修进度表';
```
### 4. 服务评价表 (pm_service_evaluation)
### 4. 服务评价表 (hq_pm_service_evaluation)
> **评价反馈表**：存储用户对维修服务的多维度评价和反馈信息
```sql
-- ----------------------------
-- Table structure for pm_service_evaluation
-- Table structure for hq_pm_service_evaluation
-- ----------------------------
DROP TABLE IF EXISTS `pm_service_evaluation`;
CREATE TABLE `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 '租户编号',
@@ -281,7 +281,7 @@ CREATE TABLE `pm_service_evaluation` (
`deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',
-- 关联信息
`order_id` bigint(20) NOT NULL COMMENT '报修工单ID，关联pm_repair_order.id',
`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',
@@ -330,16 +330,16 @@ CREATE TABLE `pm_service_evaluation` (
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务评价表';
```
### 5. 维修类型表 (pm_repair_category)
### 5. 维修类型表 (hq_pm_repair_category)
> **分类字典表**：存储维修类型的分类信息，支持层级结构
```sql
-- ----------------------------
-- Table structure for pm_repair_category
-- Table structure for hq_pm_repair_category
-- ----------------------------
DROP TABLE IF EXISTS `pm_repair_category`;
CREATE TABLE `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 '租户编号',
@@ -395,16 +395,16 @@ CREATE TABLE `pm_repair_category` (
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='维修类型表';
```
### 6. 系统配置表 (pm_system_config)
### 6. 系统配置表 (hq_pm_system_config)
> **配置管理表**：存储物业报修模块的系统参数和配置信息
```sql
-- ----------------------------
-- Table structure for pm_system_config
-- Table structure for hq_pm_system_config
-- ----------------------------
DROP TABLE IF EXISTS `pm_system_config`;
CREATE TABLE `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 '租户编号',
@@ -510,16 +510,16 @@ CREATE TABLE `pm_system_config` (
```sql
-- 报修工单表的核心查询索引
-- 1. 按状态和时间查询（管理员常用）
CREATE INDEX idx_status_time ON pm_repair_order (order_status, create_time);
CREATE INDEX idx_status_time ON hq_pm_repair_order (order_status, create_time);
-- 2. 按维修员查询其工单（维修员常用）
CREATE INDEX idx_assignee_status ON pm_repair_order (assignee_id, order_status);
CREATE INDEX idx_assignee_status ON hq_pm_repair_order (assignee_id, order_status);
-- 3. 按报修人查询（用户查看自己的工单）
CREATE INDEX idx_reporter_time ON pm_repair_order (reporter_id, create_time);
CREATE INDEX idx_reporter_time ON hq_pm_repair_order (reporter_id, create_time);
-- 4. 按紧急程度和分派时间查询（工单分派）
CREATE INDEX idx_priority_assign ON pm_repair_order (priority_level, assign_time);
CREATE INDEX idx_priority_assign ON hq_pm_repair_order (priority_level, assign_time);
```
### 2. 附件查询索引
@@ -527,10 +527,10 @@ CREATE INDEX idx_priority_assign ON pm_repair_order (priority_level, assign_time
```sql
-- 附件表的查询索引
-- 1. 按工单查询附件（最常用）
CREATE INDEX idx_order_stage ON pm_repair_attachment (order_id, upload_stage);
CREATE INDEX idx_order_stage ON hq_pm_repair_attachment (order_id, upload_stage);
-- 2. 按上传者查询附件
CREATE INDEX idx_uploader_time ON pm_repair_attachment (uploader_id, create_time);
CREATE INDEX idx_uploader_time ON hq_pm_repair_attachment (uploader_id, create_time);
```
### 3. 进度查询索引
@@ -538,24 +538,24 @@ CREATE INDEX idx_uploader_time ON pm_repair_attachment (uploader_id, create_time
```sql
-- 进度表的查询索引
-- 1. 按工单查询进度（时间线显示）
CREATE INDEX idx_order_operation_time ON pm_repair_progress (order_id, operation_time);
CREATE INDEX idx_order_operation_time ON hq_pm_repair_progress (order_id, operation_time);
-- 2. 按操作人查询进度
CREATE INDEX idx_operator_time ON pm_repair_progress (operator_id, operation_time);
CREATE INDEX idx_operator_time ON hq_pm_repair_progress (operator_id, operation_time);
```
## 📊 数据存储预估
### 表数据量预估
| 表名 | 日增长量 | 年数据量 | 存储空间预估 |
| --------------------- | ---------- | ------------ | ------------ |
| pm_repair_order | 50-100 条 | 2-4 万条 | 50-100MB |
| pm_repair_attachment | 200-400 条 | 8-16 万条 | 100-200MB |
| pm_repair_progress | 300-600 条 | 12-24 万条 | 150-300MB |
| pm_service_evaluation | 40-80 条 | 1.6-3.2 万条 | 20-40MB |
| pm_repair_category | 0-5 条 | 100-200 条 | <1MB |
| pm_system_config | 0-2 条 | 50-100 条 | <1MB |
| 表名 | 日增长量 | 年数据量 | 存储空间预估 |
| --------------------------- | ---------- | ------------ | ------------ |
| 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 |
### 存储优化建议
@@ -570,7 +570,7 @@ CREATE INDEX idx_operator_time ON pm_repair_progress (operator_id, operation_tim
```sql
-- 插入基础维修类型分类
INSERT INTO `pm_repair_category` (
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`,
@@ -588,7 +588,7 @@ INSERT INTO `pm_repair_category` (
```sql
-- 插入系统配置参数
INSERT INTO `pm_system_config` (
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`
docs/变更管理/code-adjust-record-2025-01-23-wuzilong.md
+204 -281
View File
@@ -1,321 +1,244 @@
# 代码调整记录 - 2025-01-23 - wuzilong
# 代码调整记录 - 2025-01-23
## 📋 本次变更概述
## 📋 变更概述
**变更类型**: 🏗️ 架构重构 - 后端模块工程统一管理
**变更时间**: 2025-01-23 15:00:00
**影响范围**: 后端模块架构、开发规范、工程结构
**变更日期**: 2025-01-23
**操作人员**: wuzilong
**变更类型**: 数据库表名规范化调整
**影响模块**: 物业报修管理模块
**优先级**: 高
## 🎯 变更背景
## 🎯 变更目标
基于ruoyi-hq工程的成功实践，为了规范化管理后端业务模块，建立统一的工程管理标准，便于后续各业务模块的开发和维护。
将物业报修管理模块的数据库表名从 `pm_*` 格式调整为 `hq_pm_*` 格式，符合项目数据库表名规范要求（后勤管理模块使用 `hq_` 前缀）。
## 🔧 变更详情
## 📊 变更详情
### 1. 📋 后端开发规范更新
### 1. SQL文件调整
**文件**: `.cursor/cursorrules-backend.md`
**新增内容**:
- ✅ **模块工程管理规范（强制性）**
- ✅ **模块命名和位置规范**
- ✅ **Maven配置标准模板**
- ✅ **包结构规范标准**
- ✅ **代码规范要求**
- ✅ **权限命名规范**
- ✅ **模块开发最佳实践**
- ✅ **模块创建检查清单**
**已规划模块列表**:
- ✅ `ruoyi-hq` - 后勤管理模块 (已完成)
- 🚧 `ruoyi-rs` - 人事管理模块
- 🚧 `ruoyi-cw` - 财务管理模块
- 🚧 `ruoyi-aqbw` - 安全保卫管理模块
- 🚧 `ruoyi-zsjy` - 招生就业管理模块
- 🚧 `ruoyi-xg` - 学工管理模块
### 2. 🏗️ 新增业务模块工程
**创建的5个标准业务模块**:
#### 📁 ruoyi-rs (人事管理模块)
```
backend/ruoyi-modules/ruoyi-rs/
├── pom.xml # Maven配置
└── src/main/
├── java/org/dromara/rs/
│ ├── controller/ # 控制器层
│ ├── service/ # 服务接口层
│ │ └── impl/ # 服务实现层
│ ├── mapper/ # 数据访问层
│ └── domain/ # 数据对象层
│ ├── bo/ # 业务对象
│ └── vo/ # 视图对象
└── resources/
└── mapper/ # MyBatis映射文件
```
#### 📁 ruoyi-cw (财务管理模块)
```
backend/ruoyi-modules/ruoyi-cw/
├── pom.xml # Maven配置
└── src/main/
├── java/org/dromara/cw/
│ ├── controller/ # 控制器层
│ ├── service/ # 服务接口层
│ │ └── impl/ # 服务实现层
│ ├── mapper/ # 数据访问层
│ └── domain/ # 数据对象层
│ ├── bo/ # 业务对象
│ └── vo/ # 视图对象
└── resources/
└── mapper/ # MyBatis映射文件
```
#### 📁 ruoyi-aqbw (安全保卫管理模块)
```
backend/ruoyi-modules/ruoyi-aqbw/
├── pom.xml # Maven配置
└── src/main/
├── java/org/dromara/aqbw/
│ ├── controller/ # 控制器层
│ ├── service/ # 服务接口层
│ │ └── impl/ # 服务实现层
│ ├── mapper/ # 数据访问层
│ └── domain/ # 数据对象层
│ ├── bo/ # 业务对象
│ └── vo/ # 视图对象
└── resources/
└── mapper/ # MyBatis映射文件
```
#### 📁 ruoyi-zsjy (招生就业管理模块)
```
backend/ruoyi-modules/ruoyi-zsjy/
├── pom.xml # Maven配置
└── src/main/
├── java/org/dromara/zsjy/
│ ├── controller/ # 控制器层
│ ├── service/ # 服务接口层
│ │ └── impl/ # 服务实现层
│ ├── mapper/ # 数据访问层
│ └── domain/ # 数据对象层
│ ├── bo/ # 业务对象
│ └── vo/ # 视图对象
└── resources/
└── mapper/ # MyBatis映射文件
```
#### 📁 ruoyi-xg (学工管理模块)
```
backend/ruoyi-modules/ruoyi-xg/
├── pom.xml # Maven配置
└── src/main/
├── java/org/dromara/xg/
│ ├── controller/ # 控制器层
│ ├── service/ # 服务接口层
│ │ └── impl/ # 服务实现层
│ ├── mapper/ # 数据访问层
│ └── domain/ # 数据对象层
│ ├── bo/ # 业务对象
│ └── vo/ # 视图对象
└── resources/
└── mapper/ # MyBatis映射文件
```
### 3. ⚙️ Maven配置更新
**文件**: `backend/ruoyi-modules/pom.xml`
**文件**: `docs/设计文档/database/07-property-maintenance-module.sql`
**变更内容**:
```xml
<modules>
<module>ruoyi-demo</module>
<module>ruoyi-generator</module>
<module>ruoyi-job</module>
<module>ruoyi-system</module>
<module>ruoyi-workflow</module>
<module>ruoyi-hq</module>
+ <module>ruoyi-rs</module>
+ <module>ruoyi-cw</module>
+ <module>ruoyi-aqbw</module>
+ <module>ruoyi-zsjy</module>
+ <module>ruoyi-xg</module>
</modules>
- 将所有表名从 `pm_*` 调整为 `hq_pm_*`
- 更新相关注释和关联引用
- 版本号更新至 V1.0.2
**具体表名变更**:
| 原表名 | 新表名 |
|--------|--------|
| `pm_repair_order` | `hq_pm_repair_order` |
| `pm_repair_attachment` | `hq_pm_repair_attachment` |
| `pm_repair_progress` | `hq_pm_repair_progress` |
| `pm_service_evaluation` | `hq_pm_service_evaluation` |
| `pm_repair_category` | `hq_pm_repair_category` |
| `pm_system_config` | `hq_pm_system_config` |
### 2. 数据库重命名脚本
**新增文件**: `docs/设计文档/database/08-property-maintenance-table-rename.sql`
**功能**:
- 智能检测现有表是否存在
- 批量重命名所有物业报修相关表
- 提供验证结果显示
- 支持幂等操作
### 3. 规范文档更新
**更新文件**:
- `docs/业务模块/property-maintenance/技术设计/数据库设计.md`
- `docs/业务模块/property-maintenance/README.md`
**变更内容**:
- 更新所有表名引用
- 修正实体关系图
- 更新数据流转图
### 4. 后端代码调整
**Entity实体类更新**:
- `PmRepairOrder.java` - @TableName("hq_pm_repair_order")
- `PmRepairAttachment.java` - @TableName("hq_pm_repair_attachment")
- `PmRepairProgress.java` - @TableName("hq_pm_repair_progress")
- `PmServiceEvaluation.java` - @TableName("hq_pm_service_evaluation")
- `PmRepairCategory.java` - @TableName("hq_pm_repair_category")
**Mapper XML文件更新**:
- `PmRepairAttachmentMapper.xml` - selectVo中的表名更新
- `PmRepairProgressMapper.xml` - selectVo中的表名更新
- `PmServiceEvaluationMapper.xml` - 新创建完整的Mapper XML
**VO类和BO类完善**:
- 新增：`PmRepairProgressVo.java`、`PmServiceEvaluationVo.java`
- 新增：`PmRepairProgressBo.java`、`PmServiceEvaluationBo.java`
- 更新：所有VO/BO类中的注释表名引用
**Service接口完善**:
- 新增：`IPmRepairProgressService.java`
- 新增：`IPmServiceEvaluationService.java`
**涉及文件**:
```
backend/ruoyi-modules/ruoyi-hq/src/main/java/org/dromara/hq/
├── domain/
│ ├── PmRepairOrder.java ✅
│ ├── PmRepairAttachment.java ✅
│ ├── PmRepairProgress.java ✅
│ ├── PmServiceEvaluation.java ✅
│ ├── PmRepairCategory.java ✅
│ ├── vo/
│ │ ├── PmRepairProgressVo.java ✅ (新增)
│ │ ├── PmServiceEvaluationVo.java ✅ (新增)
│ │ ├── PmRepairOrderVo.java ✅ (注释更新)
│ │ ├── PmRepairAttachmentVo.java ✅ (注释更新)
│ │ └── PmRepairCategoryVo.java ✅ (注释更新)
│ └── bo/
│ ├── PmRepairProgressBo.java ✅ (新增)
│ ├── PmServiceEvaluationBo.java ✅ (新增)
│ ├── PmRepairOrderBo.java ✅ (注释更新)
│ ├── PmRepairAttachmentBo.java ✅ (注释更新)
│ └── PmRepairCategoryBo.java ✅ (注释更新)
├── service/
│ ├── IPmRepairProgressService.java ✅ (新增)
│ └── IPmServiceEvaluationService.java ✅ (新增)
└── resources/mapper/
├── PmRepairAttachmentMapper.xml ✅ (表名更新)
├── PmRepairProgressMapper.xml ✅ (表名更新)
└── PmServiceEvaluationMapper.xml ✅ (新增)
```
### 4. 📂 目录结构说明文件
## 🛠️ 执行步骤
**为每个模块的各层级目录添加了.gitkeep文件**，包含详细的目录用途说明：
- controller/ - REST API控制器层
- service/ - 业务服务接口层
- service/impl/ - 业务服务实现层
- mapper/ - 数据访问层
- domain/ - 实体类
- domain/bo/ - 业务对象
- domain/vo/ - 视图对象
- resources/mapper/ - MyBatis映射文件
### 步骤1: SQL文件调整 ✅
- [x] 更新表结构定义
- [x] 更新关联引用
- [x] 更新索引定义
- [x] 更新初始化数据
## 🎯 模块工程标准化规范
### 步骤2: 数据库表重命名 🔄
- [x] 创建重命名脚本
- [ ] 执行数据库重命名（需手动执行）
### 📋 统一的Maven依赖配置
所有新模块都采用统一的依赖配置，包括：
- **通用工具**: core、doc、mybatis、log、security、web、excel、idempotent、tenant、social、ratelimiter、mail
- **系统模块**: system、job
- **扩展模块**: generator、demo、workflow
### 步骤3: 文档更新 ✅
- [x] 数据库设计文档
- [x] 模块总览文档
- [x] 实体关系图
### 🏛️ 统一的包结构规范
- **包名格式**: `org.dromara.{模块简称}`
- **分层架构**: controller → service → mapper → domain
- **对象分离**: Entity(实体) + BO(业务对象) + VO(视图对象)
### 步骤4: 代码调整 ✅
- [x] Entity类@TableName注解
- [x] 注释中的表名引用
- [x] Mapper XML文件表名更新
- [x] 创建缺失的VO和BO类
- [x] 创建缺失的Service接口
- [x] 创建缺失的Mapper XML文件
### 🔐 统一的权限命名规范
- **权限编码格式**: `{模块简称}:{功能}:{操作}`
- **示例**:
- `rs:employee:list` - 人事模块员工列表查询权限
- `cw:budget:add` - 财务模块预算新增权限
## 📋 验证清单
## ✅ 验证和测试
### 数据库层面
- [ ] 确认旧表名不存在
- [ ] 确认新表名存在且结构正确
- [ ] 确认索引重建成功
- [ ] 确认数据完整性
### 🔧 编译验证
- ✅ 所有新模块Maven配置正确
- ✅ 父模块pom.xml更新成功
- ✅ 目录结构符合标准规范
### 代码层面
- [x] Entity类编译通过
- [x] Mapper XML语法正确
- [x] VO/BO类创建完成
- [x] Service接口定义完成
- [ ] Service实现类创建（待完成）
- [ ] Controller类创建（待完成）
- [ ] 单元测试执行成功
- [ ] API接口调用正常
- [ ] 前端页面显示正常
### 📁 文件结构验证
- ✅ 5个新模块目录结构完整
- ✅ 每个目录都有说明文件
- ✅ 包结构符合ruoyi-hq标准
### 文档层面
- [x] 所有文档表名更新完成
- [x] 图表和示例代码正确
- [x] 变更记录完整
## 🎯 后续计划
## ⚠️ 注意事项
### 🚧 短期计划 (1-2周)
1. **业务需求梳理**: 为每个模块梳理详细的业务需求
2. **数据库设计**: 设计各模块的数据表结构
3. **API设计**: 制定标准的API接口规范
### 数据库操作
1. **备份重要性**: 执行表重命名前务必备份数据库
2. **停机时间**: 重命名操作需要停止相关服务
3. **权限验证**: 确保有足够的数据库操作权限
### 📋 中期计划 (1个月)
1. **核心功能开发**: 优先开发人事管理(rs)和财务管理(cw)模块的核心功能
2. **权限配置**: 完善各模块的菜单和权限配置
3. **测试用例**: 编写完整的测试用例
### 代码部署
1. **同步部署**: 数据库重命名与代码部署需同步进行
2. **回滚预案**: 准备回滚脚本以防意外情况
3. **测试验证**: 部署后需全面测试业务功能
### 🎯 长期计划 (3个月)
1. **功能完善**: 完成所有5个模块的核心功能开发
2. **系统集成**: 各模块之间的数据交互和业务流程打通
3. **性能优化**: 系统性能优化和并发处理能力提升
### 数据一致性
1. **外键约束**: 确认没有外键约束冲突
2. **应用层关联**: 验证应用层关联逻辑正确
3. **缓存刷新**: 清理相关缓存数据
## 📝 注意事项
## 🔧 执行命令
### ⚠️ 开发规范
1. **严格遵循**: 必须按照`.cursor/cursorrules-backend.md`中的模块工程管理规范进行开发
2. **代码质量**: 所有代码必须符合Alibaba Java开发手册规范
3. **文档同步**: 每次代码变更必须同步更新相关文档
### 数据库重命名
```bash
# 连接到MySQL数据库
mysql -h 47.99.164.66 -P 3306 -u root -p hzdyjs_xg
### 🔐 权限管理
1. **权限前缀**: 每个模块的权限前缀不能冲突
2. **菜单配置**: 需要在数据库中配置对应的菜单和权限
3. **接口权限**: 每个API接口必须添加@SaCheckPermission注解
# 执行重命名脚本
source docs/设计文档/database/08-property-maintenance-table-rename.sql;
```
### 📊 数据库规范
1. **基础字段**: 必须包含统一的基础字段（id、tenant_id、create_by等）
2. **逻辑删除**: 统一使用逻辑删除，禁止物理删除
3. **多租户**: 所有业务表必须支持多租户
### 代码重新编译
```bash
# 后端重新编译
cd backend
mvn clean compile
```
## 🏆 变更价值
## 📈 影响评估
### 📈 技术价值
1. **架构统一**: 建立了标准的模块工程架构，便于后续开发和维护
2. **开发效率**: 标准化的结构可以大幅提升新模块的开发效率
3. **代码质量**: 统一的规范保证了代码质量和一致性
### 正面影响
1. **规范统一**: 符合项目数据库命名规范
2. **维护性提升**: 表名更清晰易理解
3. **模块区分**: 清晰区分后勤管理模块表
### 🎯 业务价值
1. **功能扩展**: 为后续各业务模块的开发提供了坚实的基础
2. **系统完整性**: 逐步完善校园管理系统的各个业务模块
3. **运维便利**: 统一的架构降低了系统运维的复杂度
### 风险评估
1. **低风险**: 仅表名变更，表结构不变
2. **影响范围**: 仅限物业报修模块
3. **恢复时间**: 如有问题可快速回滚
### 👥 团队价值
1. **开发规范**: 为团队建立了统一的开发标准和最佳实践
2. **知识沉淀**: 将ruoyi-hq的成功经验规范化并推广到其他模块
3. **协作效率**: 标准化的结构提升了团队协作效率
## ✅ 验证结果
## 🔄 相关文件变更
### 文件变更统计
- SQL文件: 2个（1个更新，1个新增）
- 文档文件: 2个更新
- Entity类: 5个更新（@TableName注解和注释）
- Mapper XML: 3个（2个更新，1个新增）
- VO类: 7个（2个新增，5个注释更新）
- BO类: 7个（2个新增，5个注释更新）
- Service接口: 2个新增
- 总变更行数: 约800行
### 📝 新增文件
1. `.cursor/cursorrules-backend.md` - 新增模块工程管理规范
2. `backend/ruoyi-modules/ruoyi-rs/` - 人事管理模块完整工程
3. `backend/ruoyi-modules/ruoyi-cw/` - 财务管理模块完整工程
4. `backend/ruoyi-modules/ruoyi-aqbw/` - 安全保卫管理模块完整工程
5. `backend/ruoyi-modules/ruoyi-zsjy/` - 招生就业管理模块完整工程
6. `backend/ruoyi-modules/ruoyi-xg/` - 学工管理模块完整工程
### 测试状态
- [ ] 本地环境测试
- [ ] 开发环境验证
- [ ] 功能回归测试
### ✏️ 修改文件
1. `backend/ruoyi-modules/pom.xml` - 添加5个新模块到模块列表
## 📝 后续任务
### 📋 新增前端文件（2025-01-23 15:30:00更新）
1. **数据库执行**: 在测试环境执行表重命名脚本
2. **完善代码层**:
- 创建 `PmRepairProgressServiceImpl.java` 和 `PmServiceEvaluationServiceImpl.java`
- 创建 `PmRepairProgressController.java` 和 `PmServiceEvaluationController.java`
- 完善Mapper接口方法
3. **代码测试**: 验证所有API接口正常工作
4. **前端联调**: 确认前端页面数据显示正常
5. **文档同步**: 更新相关API文档和使用说明
**前端界面文件夹** (web/src/views/):
- ✅ `web/src/views/rs/` - 人事管理界面文件夹 + README.md
- ✅ `web/src/views/cw/` - 财务管理界面文件夹 + README.md
- ✅ `web/src/views/xg/` - 学工管理界面文件夹 + README.md
- ✅ `web/src/views/zsjy/` - 招生就业管理界面文件夹 + README.md
- ✅ `web/src/views/aqbw/` - 安全保卫管理界面文件夹 + README.md
## 🔗 相关文档
**前端API文件夹** (web/src/api/):
- ✅ `web/src/api/rs/` - 人事管理API文件夹 + index.ts + README.md
- ✅ `web/src/api/cw/` - 财务管理API文件夹 + index.ts + README.md
- ✅ `web/src/api/xg/` - 学工管理API文件夹 + index.ts + README.md
- ✅ `web/src/api/zsjy/` - 招生就业管理API文件夹 + index.ts + README.md
- ✅ `web/src/api/aqbw/` - 安全保卫管理API文件夹 + index.ts + README.md
### 📋 影响评估
- **编译构建**: ✅ 正常，新模块已正确集成到Maven构建流程
- **运行时**: ✅ 正常，新模块目前为空工程，不影响现有功能
- **依赖关系**: ✅ 正常，所有依赖配置正确
- **前端构建**: ✅ 正常，新增的TypeScript文件不会影响编译
## 🔄 数据库表命名规范补充更新 (2025-01-23 16:30:00)
### 📋 变更背景
为了配合新创建的5个业务模块，需要建立统一的数据库表命名规范，确保不同模块的数据库表有清晰的命名区分，便于后续开发和维护。
### 🔴 新增表命名规范（强制性）
**文件**: `.cursor/cursorrules-backend.md`
**新增内容**: 在数据库规范章节添加了完整的表命名规范
**模块表名前缀规范**：
- **后勤管理**：`hq_` 开头 (如：`hq_repair`, `hq_maintenance`)
- **人事管理**：`rs_` 开头 (如：`rs_employee`, `rs_department`)
- **财务管理**：`cw_` 开头 (如：`cw_budget`, `cw_expense`)
- **学工管理**：`xg_` 开头 (如：`xg_student`, `xg_dormitory`)
- **招生就业**：`zsjy_` 开头 (如：`zsjy_application`, `zsjy_job`)
- **安全保卫**：`aqbw_` 开头 (如：`aqbw_security`, `aqbw_patrol`)
- **系统公共**：`common_` 开头 (如：`common_dict`, `common_config`)
### ✅ 规范内容要点
1. **命名示例**: 提供了7个模块的完整CREATE TABLE示例
2. **强制性要求**: 明确了6个强制性命名要求和4个禁止事项
3. **实体类映射**: 提供了表名到Java实体类的命名对应规则
4. **规范位置**: 放置在数据库规范的强制性核心规范之后，基础字段模板之前
### 🔄 后勤管理模块补充更新 (2025-01-23 16:35:00)
**补充内容**: 添加后勤管理模块的表命名规范
- ✅ **后勤管理**: `hq_` 开头 (如：`hq_repair`, `hq_maintenance`)
- ✅ **命名示例**: 添加了后勤管理模块的CREATE TABLE示例
- ✅ **实体类映射**: 添加了 `hq_repair` → `HqRepair` 的命名对应示例
**更新说明**: 现在表命名规范涵盖完整的7个业务模块，包括已开发的后勤管理模块和5个新规划模块。
### 🎯 规范价值
1. **模块区分**: 清晰区分不同业务模块的数据表
2. **开发效率**: 标准化命名减少开发时的困惑
3. **维护便利**: 便于后续数据库维护和权限管理
4. **团队协作**: 为团队提供统一的数据库命名标准
- [项目数据库命名规范](docs/设计文档/database/mysql-database-standard.md)
- [物业报修模块文档](docs/业务模块/property-maintenance/README.md)
- [数据库设计文档](docs/业务模块/property-maintenance/技术设计/数据库设计.md)
---
**总结**: 本次变更成功建立了前后端模块工程的统一管理规范，创建了5个后端业务模块和对应的前端文件夹结构，并补充完善了包含7个业务模块的完整数据库表命名规范（后勤、人事、财务、学工、招生就业、安全保卫、系统公共），为后续各业务模块的全栈开发奠定了坚实的架构基础。所有变更都经过仔细验证，确保系统稳定性不受影响。
**变更完成时间**: 2025-01-23 18:45:00
**最后更新**: 2025-01-23 18:45:00 - 完成所有表名调整和基础代码结构
**下次更新计划**: 待Service实现类和Controller创建完成后更新验证结果
docs/测试文档/后勤管理/报告厅信息/报告厅信息界面测试执行报告-2025-07-09.md
+47
View File
@@ -0,0 +1,47 @@
# 报告厅信息界面测试执行报告 (2025-07-09)
## ✨ 执行概览
- **执行时间**: 2025-07-09
- **测试环境**: macOS darwin 24.5.0 / Chrome (Playwright MCP 默认浏览器)
- **前端地址**: http://localhost
- **后端地址**: http://localhost:8080
- **登录账号**: admin / admin123
## 📋 关联用例
来源: `报告厅信息界面测试用例-2025-07-09.md`
## 🧪 执行结果一览
| 用例编号 | 用例名称 | 结果 | 备注 |
|----------|----------|------|------|
| TC001 | 页面加载和核心元素检查 | ❌ 失败 | 访问路径 `/hq/hallInfo` 返回 404 页面 |
| TC002-TC012 | 依赖页面正常加载 | ⏸ 未执行 | 前置条件 (TC001) 不通过 |
## ❌ 失败详情 (TC001)
1. **操作步骤回放**
- 访问登录页 `http://localhost`，成功登录 (admin / admin123)。
- 登录后自动跳转到首页 `/index`。
- 调用 `page.goto('http://localhost/hq/hallInfo')`。
- 等待 3 秒后页面展示 **404 错误**，提示“找不到网页”。
2. **预期**: 报告厅信息页在 3 秒内加载并显示核心元素。
3. **实际**: 返回 404，页面不存在。
4. **截图**: (已保存在 Playwright 执行记录)
## 🔍 结论 & 建议
- **路由未注册**: 前端路由 `/hq/hallInfo` 在当前发布版本中未生效，导致 404。
- **菜单/权限缺失**: 若使用动态路由，请确认后台菜单数据已包含 `hq/hallInfo` 且管理员拥有 `hq:hallInfo:query` 权限。
- **接口可用性**: API 文件和 Vue 组件已存在，说明功能开发中；建议前端注册路由并在后台菜单启用后重新执行测试。
## 📌 后续行动
1. 核对后台菜单配置，确认是否已发布“报告厅信息”功能。
2. 确认前端 `router.ts` (或动态路由加载逻辑) 已包含该页面。
3. 功能上线完成后重新执行全部 12 条用例，并生成新的执行报告。
---
> **提示**: 测试执行失败时，应先解决环境/功能就绪问题，再进行自动化测试脚本调试。
docs/测试文档/后勤管理/报告厅信息/报告厅信息界面测试用例-2025-07-09.md
+204
View File
@@ -0,0 +1,204 @@
# 报告厅信息界面功能测试用例
## 🎯 测试概览
**编写时间**: 2025-07-09
**测试工具**: Cursor + Playwright MCP
**测试范围**: 后勤管理 → 报告厅信息界面
**测试类型**: 端到端功能 + UI 可用性 + 校验逻辑
**预计执行时长**: 40–60 分钟
## 📋 测试准备
### 1. 环境要求
- ✅ 前端运行地址: `http://localhost` (默认 80 端口)
- ✅ 后端运行地址: `http://localhost:8080`
- ✅ 管理员测试账号: `admin / admin123`
- ✅ Playwright MCP 插件已启用
- ✅ 测试图片目录: `test/hall-info/test-images/`
### 2. 基础测试数据
```json
{
"testHalls": [
{
"hallName": "测试报告厅 A",
"hallDescription": "可容纳 200 人的大型多媒体报告厅",
"hallStatus": "1",
"hallImageFile": "报告厅-01.jpg"
},
{
"hallName": "测试报告厅 B",
"hallDescription": "小型多功能报告厅，适合研讨会",
"hallStatus": "1",
"hallImageFile": "报告厅-02.jpg"
}
]
}
```
## 🧪 测试执行计划
> **Playwright 代码片段**示例均遵循 MCP snapshot → click/type → waitFor 的通用写法，可直接复制到 Playwright 脚本中。
### 阶段一：页面基础验证（10 分钟）
#### TC001: 页面加载和核心元素检查
| 字段 | 说明 |
|------|------|
| **测试目标** | 验证“报告厅信息”页面可以在 3 秒内完成加载并正确渲染核心元素 |
| **前置条件** | 已登录系统，导航到 `后勤管理 → 报告厅管理 → 报告厅信息` 菜单 |
| **步骤** | 1. 调用 `browser.navigate('http://localhost/hq/bgtgl/hallInfo')` <br/>2. `await browser.waitFor(3000)` <br/>3. `const snapshot = await browser.snapshot()` 验证页面包含“报告厅信息”标题、搜索框、【新增】按钮、表格区域、分页组件 |
| **预期结果** | 页面 3 秒内加载完成；所有核心元素可见且可交互 |
| **Playwright 示例** |
```javascript
await browser.navigate('http://localhost/hq/hallInfo');
await browser.waitFor(3000);
const snapshot = await browser.snapshot();
// 断言标题存在
```
#### TC002: 默认数据列表展示
| 字段 | 说明 |
|------|------|
| **测试目标** | 验证表格列（名称、状态、图片、描述、操作）显示完整，数据加载正确 |
| **步骤** | 1. 页面加载完成后解析表格 <br/>2. 检查列头文本 <br/>3. 验证至少存在 1 条数据 |
| **预期结果** | 列头文本正确，数据行显示完整，分页信息正确 |
### 阶段二：CRUD 功能测试（20 分钟）
#### TC003: 新增报告厅信息
| 字段 | 说明 |
|------|------|
| **测试目标** | 验证新增功能完整性，包括表单校验、图片上传、保存成功提示及列表刷新 |
| **前置条件** | None |
| **步骤** | 1. 点击【新增】按钮 <br/>2. 填写“报告厅名称”、“描述” <br/>3. 选择状态为“可用” <br/>4. 上传 任意一张图片 (路径: test/hall-info/test-images/`) <br/>5. 点击【保存】按钮 <br/>6. 等待成功提示并搜索新增名称 |
| **预期结果** | 弹窗关闭、提示“操作成功”，列表第一行显示新数据，图片缩略图显示正常 |
| **Playwright 示例** |
```javascript
await browser.click('新增按钮', "button:has-text('新增')");
await browser.type('名称', "input[placeholder*='报告厅名称']", '测试报告厅 A');
await browser.type('描述', "textarea[placeholder*='描述']", '可容纳 200 人的大型多媒体报告厅');
await browser.click('状态下拉', "select[placeholder*='状态']");
await browser.selectOption('状态选项', 'select', ['1']);
// 上传图片
await browser.fileUpload('选择图片', "input[type='file']", 'test/hall-info/test-images/');
await browser.click('保存', "button:has-text('保存')");
await browser.waitFor(2000);
```
#### TC004: 编辑报告厅信息
| 字段 | 说明 |
|------|------|
| **测试目标** | 验证编辑功能并确保修改后的数据正确保存 |
| **前置条件** | 已存在“测试报告厅 A”记录 |
| **步骤** | 1. 在列表中搜索并点击对应行【编辑】 <br/>2. 修改描述为“可容纳 180–200 人，带高清投影” <br/>3. 点击【保存】 <br/>4. 验证修改生效 |
| **预期结果** | 提示“操作成功”，描述字段显示新内容 |
#### TC005: 状态切换（可用 ↔ 不可用）
| 字段 | 说明 |
|------|------|
| **测试目标** | 验证状态切换按钮或下拉框能实时更新报告厅可用状态 |
| **步骤** | 1. 点击状态切换或下拉，改为“不可用” <br/>2. 等待提示刷新 <br/>3. 再次切换回“可用” |
| **预期结果** | 状态字段值正确切换，表格颜色/标签同步更新 |
#### TC006: 删除报告厅信息
| 字段 | 说明 |
|------|------|
| **测试目标** | 验证单条删除与批量删除功能 |
| **步骤** | 1. 勾选“测试报告厅 A”复选框 <br/>2. 点击【删除】按钮，确认弹窗 <br/>3. 验证提示成功并列表中不再出现该数据 |
| **预期结果** | 数据删除成功，表格刷新后该条目消失 |
### 阶段三：表单校验与异常测试（5 分钟）
#### TC007: 必填字段校验
| 字段 | 说明 |
|------|------|
| **测试目标** | 验证未填写必填项时的校验提示 |
| **步骤** | 1. 点击【新增】 <br/>2. 不填任何字段直接保存 |
| **预期结果** | 名称、状态、图片均显示红色校验提示，无法提交成功 |
#### TC008: 名称重复校验
| 字段 | 说明 |
|------|------|
| **测试目标** | 当报告厅名称已存在时，系统应提示重复并阻止保存 |
| **步骤** | 1. 新增或编辑时填写已存在的名称“测试报告厅 B” <br/>2. 点击保存 |
| **预期结果** | 弹窗提示“报告厅名称已存在”，表单不关闭 |
### 阶段四：搜索、排序与分页（5 分钟）
#### TC009: 关键字搜索
| 字段 | 说明 |
|------|------|
| **步骤** | 1. 在搜索框输入“测试报告厅” <br/>2. 点击【搜索】 |
| **预期结果** | 表格仅显示名称包含“测试报告厅”的记录，分页信息更新 |
#### TC010: 分页跳转
| 字段 | 说明 |
|------|------|
| **步骤** | 1. 若数据超过 10 条，点击分页到第 2 页 <br/>2. 观察页面加载 |
| **预期结果** | 正确跳转到第 2 页，数据加载正常 |
### 阶段五：图片上传专项测试（5 分钟）
#### TC011: 多张图片上传
| 字段 | 说明 |
|------|------|
| **测试目标** | 验证支持一次上传多张图片并正确保存 |
| **步骤** | 1. 新增报告厅时选择 任意多张图片 <br/>2. 保存后查看图片列表 |
| **预期结果** | 所有上传图片均生成缩略图，放大预览正常 |
#### TC012: 不合法格式/大小校验
| 字段 | 说明 |
|------|------|
| **测试目标** | 上传超出大小或非图片格式文件时提示错误 |
| **步骤** | 1. 尝试上传 `test.txt` 或 >5MB 的图片 |
| **预期结果** | 显示“仅支持 jpg/png 且大小 ≤5MB”错误提示，禁止上传 |
### 阶段六：权限与安全（可选）
- TC013: 普通用户无法访问“报告厅信息”菜单
- TC014: Token 失效后访问页面应跳转登录
## ✅ 验证点汇总
- 页面元素存在性与响应速度
- CRUD 全流程成功提示与数据持久化
- 表单前端 & 后端校验一致性
- 图片上传与文件系统存储完整性
- 搜索/分页/排序交互稳定性
- 权限与安全控制
## ⏱️ 性能指标
| 指标 | 目标 |
|------|------|
| 页面首次加载 | ≤ 3 秒 |
| 新增 / 编辑请求 | ≤ 1 秒 |
| 图片上传 | ≤ 2 秒/张 |
## 📂 Playwright 代码与资源路径
- **脚本目录**: `test/hall-info/`
- **示例脚本**: `test/hall-info/hall-info-e2e.spec.js`
- **图片资源**: `test/hall-info/test-images/`
## 📝 备注
1. 以上测试用例可作为 Playwright 自动化脚本直接参考。
2. 图片上传请使用绝对路径或 `path.join(process.env.HOME, 'Downloads/报告厅照片', fileName)` 动态拼接。
3. 测试完成后，请生成执行报告并提交至 `docs/测试文档/后勤管理/报告厅信息/` 目录下，命名为 `报告厅信息界面测试执行报告-YYYY-MM-DD.md`。
docs/设计文档/database/07-property-maintenance-module.sql
+34 -33
View File
@@ -1,10 +1,11 @@
-- ==========================================
-- 物业报修管理模块数据库脚本
-- 版本：V1.0.1
-- 功能：物业报修管理模块完整表结构
-- 版本：V1.0.2
-- 功能：物业报修管理模块完整表结构（表名规范化调整）
-- 作者：Cursor AI 辅助
-- 时间：2025-01-23
-- 依据文档：docs/业务模块/property-maintenance/技术设计/数据库设计.md
-- 表名规范：使用hq_前缀标识后勤管理模块
-- ==========================================
-- 设置字符集
@@ -12,10 +13,10 @@ SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;
-- ----------------------------
-- Table structure for pm_repair_order
-- Table structure for hq_pm_repair_order
-- ----------------------------
DROP TABLE IF EXISTS `pm_repair_order`;
CREATE TABLE `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 '租户编号',
@@ -33,7 +34,7 @@ CREATE TABLE `pm_repair_order` (
`repair_location` varchar(200) NOT NULL COMMENT '报修地点',
-- 分类和紧急程度
`category_id` bigint(20) NOT NULL COMMENT '维修类型ID，关联pm_repair_category.id',
`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 '期望完成时间',
@@ -89,10 +90,10 @@ CREATE TABLE `pm_repair_order` (
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报修工单表';
-- ----------------------------
-- Table structure for pm_repair_attachment
-- Table structure for hq_pm_repair_attachment
-- ----------------------------
DROP TABLE IF EXISTS `pm_repair_attachment`;
CREATE TABLE `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 '租户编号',
@@ -104,7 +105,7 @@ CREATE TABLE `pm_repair_attachment` (
`deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',
-- 关联信息
`order_id` bigint(20) NOT NULL COMMENT '报修工单ID，关联pm_repair_order.id',
`order_id` bigint(20) NOT NULL COMMENT '报修工单ID，关联hq_pm_repair_order.id',
-- 文件信息
`file_name` varchar(200) NOT NULL COMMENT '文件原始名称',
@@ -141,10 +142,10 @@ CREATE TABLE `pm_repair_attachment` (
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='报修附件表';
-- ----------------------------
-- Table structure for pm_repair_progress
-- Table structure for hq_pm_repair_progress
-- ----------------------------
DROP TABLE IF EXISTS `pm_repair_progress`;
CREATE TABLE `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 '租户编号',
@@ -156,7 +157,7 @@ CREATE TABLE `pm_repair_progress` (
`deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',
-- 关联信息
`order_id` bigint(20) NOT NULL COMMENT '报修工单ID，关联pm_repair_order.id',
`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-其他',
@@ -199,10 +200,10 @@ CREATE TABLE `pm_repair_progress` (
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='维修进度表';
-- ----------------------------
-- Table structure for pm_service_evaluation
-- Table structure for hq_pm_service_evaluation
-- ----------------------------
DROP TABLE IF EXISTS `pm_service_evaluation`;
CREATE TABLE `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 '租户编号',
@@ -214,7 +215,7 @@ CREATE TABLE `pm_service_evaluation` (
`deleted` tinyint(1) DEFAULT 0 COMMENT '删除标志（0代表存在 1代表删除）',
-- 关联信息
`order_id` bigint(20) NOT NULL COMMENT '报修工单ID，关联pm_repair_order.id',
`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',
@@ -263,10 +264,10 @@ CREATE TABLE `pm_service_evaluation` (
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务评价表';
-- ----------------------------
-- Table structure for pm_repair_category
-- Table structure for hq_pm_repair_category
-- ----------------------------
DROP TABLE IF EXISTS `pm_repair_category`;
CREATE TABLE `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 '租户编号',
@@ -322,10 +323,10 @@ CREATE TABLE `pm_repair_category` (
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='维修类型表';
-- ----------------------------
-- Table structure for pm_system_config
-- Table structure for hq_pm_system_config
-- ----------------------------
DROP TABLE IF EXISTS `pm_system_config`;
CREATE TABLE `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 '租户编号',
@@ -373,7 +374,7 @@ CREATE TABLE `pm_system_config` (
-- ----------------------------
-- 初始化数据：维修类型分类
-- ----------------------------
INSERT INTO `pm_repair_category` (
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`,
@@ -389,7 +390,7 @@ INSERT INTO `pm_repair_category` (
-- ----------------------------
-- 初始化数据：系统配置参数
-- ----------------------------
INSERT INTO `pm_system_config` (
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`
@@ -410,16 +411,16 @@ INSERT INTO `pm_system_config` (
-- 创建核心业务查询索引
-- ----------------------------
-- 报修工单表的核心查询索引
CREATE INDEX idx_status_time ON pm_repair_order (order_status, create_time);
CREATE INDEX idx_assignee_status ON pm_repair_order (assignee_id, order_status);
CREATE INDEX idx_reporter_time ON pm_repair_order (reporter_id, create_time);
CREATE INDEX idx_priority_assign ON pm_repair_order (priority_level, assign_time);
CREATE INDEX idx_status_time ON hq_pm_repair_order (order_status, create_time);
CREATE INDEX idx_assignee_status ON hq_pm_repair_order (assignee_id, order_status);
CREATE INDEX idx_reporter_time ON hq_pm_repair_order (reporter_id, create_time);
CREATE INDEX idx_priority_assign ON hq_pm_repair_order (priority_level, assign_time);
-- 附件表的查询索引
CREATE INDEX idx_uploader_time ON pm_repair_attachment (uploader_id, create_time);
CREATE INDEX idx_uploader_time ON hq_pm_repair_attachment (uploader_id, create_time);
-- 进度表的查询索引
CREATE INDEX idx_order_operation_time ON pm_repair_progress (order_id, operation_time);
CREATE INDEX idx_operator_time ON pm_repair_progress (operator_id, operation_time);
CREATE INDEX idx_order_operation_time ON hq_pm_repair_progress (order_id, operation_time);
CREATE INDEX idx_operator_time ON hq_pm_repair_progress (operator_id, operation_time);
SET FOREIGN_KEY_CHECKS = 1;
docs/设计文档/database/08-property-maintenance-table-rename.sql
+166
View File
@@ -0,0 +1,166 @@
-- ==========================================
-- 物业报修管理模块表名重命名脚本
-- 版本：V1.0.0
-- 功能：将现有pm_开头的表名重命名为hq_pm_开头
-- 作者：Cursor AI 辅助
-- 时间：2025-01-23
-- 目的：符合项目表名规范（后勤管理模块使用hq_前缀）
-- ==========================================
-- 设置字符集
SET NAMES utf8mb4;
-- 检查表是否存在并进行重命名
-- 注意：在重命名之前请确保没有其他进程在使用这些表
-- 1. 重命名报修工单表
-- 先检查表是否存在
SELECT 'Checking table existence...' AS step;
-- 重命名主要业务表
-- 1. pm_repair_order -> hq_pm_repair_order
SET @sql = IF(
(SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_repair_order') > 0,
'RENAME TABLE pm_repair_order TO hq_pm_repair_order',
'SELECT "Table pm_repair_order does not exist" AS info'
);
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
-- 2. pm_repair_attachment -> hq_pm_repair_attachment
SET @sql = IF(
(SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_repair_attachment') > 0,
'RENAME TABLE pm_repair_attachment TO hq_pm_repair_attachment',
'SELECT "Table pm_repair_attachment does not exist" AS info'
);
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
-- 3. pm_repair_progress -> hq_pm_repair_progress
SET @sql = IF(
(SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_repair_progress') > 0,
'RENAME TABLE pm_repair_progress TO hq_pm_repair_progress',
'SELECT "Table pm_repair_progress does not exist" AS info'
);
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
-- 4. pm_service_evaluation -> hq_pm_service_evaluation
SET @sql = IF(
(SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_service_evaluation') > 0,
'RENAME TABLE pm_service_evaluation TO hq_pm_service_evaluation',
'SELECT "Table pm_service_evaluation does not exist" AS info'
);
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
-- 5. pm_repair_category -> hq_pm_repair_category
SET @sql = IF(
(SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_repair_category') > 0,
'RENAME TABLE pm_repair_category TO hq_pm_repair_category',
'SELECT "Table pm_repair_category does not exist" AS info'
);
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
-- 6. pm_system_config -> hq_pm_system_config
SET @sql = IF(
(SELECT COUNT(*) FROM INFORMATION_SCHEMA.TABLES
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_system_config') > 0,
'RENAME TABLE pm_system_config TO hq_pm_system_config',
'SELECT "Table pm_system_config does not exist" AS info'
);
PREPARE stmt FROM @sql;
EXECUTE stmt;
DEALLOCATE PREPARE stmt;
-- 验证重命名结果
SELECT 'Verifying table rename results...' AS step;
-- 检查新表名是否存在
SELECT
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'hq_pm_repair_order')
THEN 'EXISTS'
ELSE 'NOT EXISTS'
END AS hq_pm_repair_order_status,
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'hq_pm_repair_attachment')
THEN 'EXISTS'
ELSE 'NOT EXISTS'
END AS hq_pm_repair_attachment_status,
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'hq_pm_repair_progress')
THEN 'EXISTS'
ELSE 'NOT EXISTS'
END AS hq_pm_repair_progress_status,
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'hq_pm_service_evaluation')
THEN 'EXISTS'
ELSE 'NOT EXISTS'
END AS hq_pm_service_evaluation_status,
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'hq_pm_repair_category')
THEN 'EXISTS'
ELSE 'NOT EXISTS'
END AS hq_pm_repair_category_status,
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'hq_pm_system_config')
THEN 'EXISTS'
ELSE 'NOT EXISTS'
END AS hq_pm_system_config_status;
-- 检查旧表名是否还存在（应该不存在）
SELECT
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_repair_order')
THEN 'STILL EXISTS (ERROR)'
ELSE 'REMOVED (OK)'
END AS old_pm_repair_order_status,
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_repair_attachment')
THEN 'STILL EXISTS (ERROR)'
ELSE 'REMOVED (OK)'
END AS old_pm_repair_attachment_status,
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_repair_progress')
THEN 'STILL EXISTS (ERROR)'
ELSE 'REMOVED (OK)'
END AS old_pm_repair_progress_status,
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_service_evaluation')
THEN 'STILL EXISTS (ERROR)'
ELSE 'REMOVED (OK)'
END AS old_pm_service_evaluation_status,
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_repair_category')
THEN 'STILL EXISTS (ERROR)'
ELSE 'REMOVED (OK)'
END AS old_pm_repair_category_status,
CASE
WHEN EXISTS (SELECT 1 FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'pm_system_config')
THEN 'STILL EXISTS (ERROR)'
ELSE 'REMOVED (OK)'
END AS old_pm_system_config_status;
SELECT 'Table rename operation completed!' AS result;