resolve: 解决合并冲突
This commit is contained in:
wuzhen committed
commit
80dface225
97 files changed
+4789
-1686
No files matched your search
@@ -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
|
||||
|
||||
|
||||
@@ -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`
|
||||
|
||||
@@ -285,6 +285,7 @@ private Date updateTime;
|
||||
**文档版本**: v1.0
|
||||
**下次评审**: 根据实际使用情况优化
|
||||
|
||||
<<<<<<< HEAD
|
||||
---
|
||||
|
||||
# 代码调整记录 - 2025-01-09 - wuzilong
|
||||
@@ -619,3 +620,450 @@ private Date updateTime;
|
||||
|
||||
**📝 维护人员**: wuzilong
|
||||
**📅 更新时间**: 2025-01-09 23:50:00
|
||||
=======
|
||||
## 报告厅预约时间冲突检查功能优化
|
||||
|
||||
### 变更时间
|
||||
2025-01-09 14:30:00
|
||||
|
||||
### 变更内容
|
||||
1. 新增后端时间冲突检查接口
|
||||
- 添加 `/hq/hallReservation/checkTimeConflict` 接口
|
||||
- 实现精确的时间冲突检查逻辑
|
||||
- 支持排除当前预约记录的冲突检查
|
||||
|
||||
2. 前端代码优化
|
||||
- 将时间冲突检查逻辑从前端移至后端
|
||||
- 添加相关API调用和类型定义
|
||||
- 优化界面显示效果
|
||||
|
||||
3. API文档更新
|
||||
- 在场地预约管理API文档中添加时间冲突检查接口说明
|
||||
- 完善接口参数和响应说明
|
||||
- 添加使用示例
|
||||
|
||||
### 涉及文件
|
||||
1. 后端文件：
|
||||
- `HallReservationController.java`
|
||||
- `IHallReservationService.java`
|
||||
- `HallReservationServiceImpl.java`
|
||||
- `HallReservationTimeCheckDTO.java`
|
||||
|
||||
2. 前端文件：
|
||||
- `web/src/api/hq/hallAudit/index.ts`
|
||||
- `web/src/api/hq/hallAudit/types.ts`
|
||||
- `web/src/views/hq/hallAudit/index.vue`
|
||||
|
||||
3. 文档文件：
|
||||
- `docs/开发文档/API/场地预约管理API.md`
|
||||
|
||||
### 变更原因
|
||||
1. 提高时间冲突检查的准确性
|
||||
2. 优化代码结构，将业务逻辑移至后端
|
||||
3. 提升系统性能和可维护性
|
||||
|
||||
### 测试验证
|
||||
1. 接口测试
|
||||
- [x] 正常时间段检查
|
||||
- [x] 边界时间检查
|
||||
- [x] 排除当前记录的检查
|
||||
- [x] 错误参数处理
|
||||
|
||||
2. 前端功能测试
|
||||
- [x] 审核建议显示
|
||||
- [x] 时间冲突提示
|
||||
- [x] 界面交互体验
|
||||
|
||||
### 注意事项
|
||||
1. 时间格式统一使用：yyyy-MM-dd HH:mm:ss
|
||||
2. 注意处理时区问题
|
||||
3. 确保前端传参格式正确
|
||||
|
||||
### 后续计划
|
||||
1. 添加批量时间冲突检查功能
|
||||
2. 优化冲突提示的展示方式
|
||||
3. 考虑添加预约时间段可视化展示
|
||||
|
||||
### 相关文档
|
||||
- [场地预约管理API文档](../开发文档/API/场地预约管理API.md)
|
||||
- [报告厅预约系统设计说明](../需求文档/后勤报告厅预约需求/简化版报告厅预约系统设计说明.md)
|
||||
|
||||
# 代码调整记录 2025-01-09
|
||||
|
||||
## 报告厅预约时间冲突检查功能迁移
|
||||
|
||||
### 变更时间
|
||||
2025-01-09 15:30:00
|
||||
|
||||
### 变更内容
|
||||
1. 代码迁移
|
||||
- 将代码从 `com.ruoyi.hq` 迁移到 `org.dromara.hq`
|
||||
- 按照新的项目规范重构代码结构
|
||||
- 完善实体类和VO类的定义
|
||||
|
||||
2. 功能优化
|
||||
- 优化时间冲突检查逻辑
|
||||
- 完善参数校验
|
||||
- 规范化异常处理
|
||||
- 添加详细的注释说明
|
||||
|
||||
3. 规范遵循
|
||||
- 遵循新的包结构规范
|
||||
- 实现标准的实体类继承关系
|
||||
- 完善API文档
|
||||
|
||||
### 涉及文件
|
||||
1. 后端文件：
|
||||
- `org.dromara.hq.domain.HallReservation`
|
||||
- `org.dromara.hq.domain.vo.HallReservationVO`
|
||||
- `org.dromara.hq.domain.dto.HallReservationTimeCheckDTO`
|
||||
- `org.dromara.hq.mapper.HallReservationMapper`
|
||||
- `org.dromara.hq.service.IHallReservationService`
|
||||
- `org.dromara.hq.service.impl.HallReservationServiceImpl`
|
||||
- `org.dromara.hq.controller.HallReservationController`
|
||||
|
||||
2. 文档文件：
|
||||
- `docs/开发文档/API/场地预约管理API.md`
|
||||
- `docs/变更管理/code-adjust-record-2025-01-09-wuzilong.md`
|
||||
|
||||
### 变更原因
|
||||
1. 遵循新的项目规范要求
|
||||
2. 优化代码结构和可维护性
|
||||
3. 统一项目包命名规范
|
||||
|
||||
### 测试验证
|
||||
1. 功能测试
|
||||
- [x] 时间冲突检查
|
||||
- [x] 参数校验
|
||||
- [x] 异常处理
|
||||
|
||||
2. 规范检查
|
||||
- [x] 包结构符合规范
|
||||
- [x] 类名和方法名符合规范
|
||||
- [x] 注释完整规范
|
||||
|
||||
### 遗留问题
|
||||
1. Excel导出相关的注解依赖需要确认
|
||||
2. 部分Mapper方法可能需要优化
|
||||
|
||||
### 后续计划
|
||||
1. 完善Excel导出功能
|
||||
2. 优化查询性能
|
||||
3. 添加缓存支持
|
||||
|
||||
### 备注
|
||||
代码迁移后进行了全面的功能测试，确保所有功能正常运行。如有问题及时反馈。
|
||||
|
||||
# 代码调整记录 2025-01-09
|
||||
|
||||
## 报告厅预约模块代码规范优化
|
||||
|
||||
### 1. 类名规范调整
|
||||
- 添加模块前缀 `Hq`
|
||||
- 将 `DTO` 改为 `Bo`
|
||||
- 涉及文件：
|
||||
- `HallReservationTimeCheckDTO.java` → `HqHallReservationTimeCheckBo.java`
|
||||
- 相关的Service、Controller等引用
|
||||
|
||||
### 2. 代码结构优化
|
||||
- 创建标准的VO类：`HallReservationTimeCheckVO`
|
||||
- 优化Mapper接口和XML映射文件
|
||||
- 完善了时间冲突检查的业务逻辑
|
||||
|
||||
### 3. 前端代码同步更新
|
||||
- 更新API接口定义
|
||||
- 添加TypeScript类型声明
|
||||
- 优化接口返回值处理
|
||||
|
||||
### 4. 文档更新
|
||||
- 更新API文档
|
||||
- 添加变更记录
|
||||
|
||||
## 遗留问题
|
||||
- [ ] 需要进行完整的功能测试
|
||||
- [ ] 可能需要补充单元测试用例
|
||||
|
||||
## 后续计划
|
||||
- [ ] 继续优化其他模块的代码规范
|
||||
- [ ] 完善测试覆盖率
|
||||
|
||||
## 变更人
|
||||
- 作者：wuzilong
|
||||
- 日期：2025-01-09
|
||||
- 时间：15:30:00
|
||||
|
||||
# 代码调整记录 - 2025-01-09 - wuzilong
|
||||
|
||||
## 📋 本日工作总览
|
||||
|
||||
**工作重点**: 为报告厅审核建议功能添加后端接口支持
|
||||
|
||||
**工作时间**: 2025-01-09 14:00:00 - 17:00:00
|
||||
|
||||
**参与人员**: wuzilong
|
||||
|
||||
---
|
||||
|
||||
## 🚀 主要变更内容
|
||||
|
||||
### 1. 📝 VO类基础字段规范修复
|
||||
|
||||
**时间**: 2025-01-09 16:00:00
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-hq/src/main/java/org/dromara/hq/domain/vo/HqHallReservationVo.java`
|
||||
|
||||
**变更内容**:
|
||||
- ✅ 添加缺失的基础字段（符合强制性规范）
|
||||
- ✅ 包含createBy、createTime、updateBy、updateTime四个字段
|
||||
- ✅ 时间字段使用`@JsonFormat`注解格式化
|
||||
- ✅ 创建时间字段支持Excel导出
|
||||
|
||||
**技术细节**:
|
||||
```java
|
||||
// 添加的基础字段
|
||||
private Long createBy; // 创建者
|
||||
private Date createTime; // 创建时间
|
||||
private Long updateBy; // 更新者
|
||||
private Date updateTime; // 更新时间
|
||||
```
|
||||
|
||||
**符合规范**: `.cursor/cursorrules-backend.md` → "VO类基础字段规范（强制性）"
|
||||
|
||||
### 2. 🆕 新增业务对象类
|
||||
|
||||
**时间**: 2025-01-09 16:15:00
|
||||
|
||||
#### A. 时间冲突检查BO类
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-hq/src/main/java/org/dromara/hq/domain/bo/HqHallTimeCheckBo.java`
|
||||
|
||||
**功能**: 接收前端时间冲突检查请求参数
|
||||
- ✅ 报告厅ID（必填）
|
||||
- ✅ 开始时间/结束时间（必填，JSON格式化）
|
||||
- ✅ 排除预约ID（可选，用于编辑时排除自身）
|
||||
- ✅ 完整的参数验证注解
|
||||
|
||||
#### B. 时间冲突检查结果VO类
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-hq/src/main/java/org/dromara/hq/domain/vo/HqHallTimeCheckVo.java`
|
||||
|
||||
**功能**: 返回时间冲突检查结果
|
||||
- ✅ 是否存在冲突（Boolean）
|
||||
- ✅ 冲突预约列表（List<HqHallReservationVo>）
|
||||
- ✅ 冲突描述信息（String）
|
||||
- ✅ 静态工厂方法：noConflict()、hasConflict()
|
||||
|
||||
### 3. 🔧 服务层接口扩展
|
||||
|
||||
**时间**: 2025-01-09 16:25:00
|
||||
|
||||
#### A. Service接口
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-hq/src/main/java/org/dromara/hq/service/IHqHallReservationService.java`
|
||||
|
||||
**新增方法**:
|
||||
```java
|
||||
/**
|
||||
* 检查报告厅时间冲突
|
||||
* @param timeCheckBo 时间检查参数
|
||||
* @return 时间冲突检查结果
|
||||
*/
|
||||
HqHallTimeCheckVo checkTimeConflict(HqHallTimeCheckBo timeCheckBo);
|
||||
```
|
||||
|
||||
#### B. Service实现类
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-hq/src/main/java/org/dromara/hq/service/impl/HqHallReservationServiceImpl.java`
|
||||
|
||||
**核心业务逻辑**:
|
||||
- ✅ 智能时间重叠检测算法
|
||||
- ✅ 只检查已批准状态（status='1'）的预约
|
||||
- ✅ 支持排除指定预约ID（编辑场景）
|
||||
- ✅ 详细的日志记录
|
||||
- ✅ 构建标准化返回结果
|
||||
|
||||
**时间冲突判定规则**:
|
||||
```sql
|
||||
-- 时间重叠条件：
|
||||
-- startTime < existingEndTime AND endTime > existingStartTime
|
||||
lqw.and(wrapper -> wrapper
|
||||
.lt(HqHallReservation::getStartTime, timeCheckBo.getEndTime())
|
||||
.gt(HqHallReservation::getEndTime, timeCheckBo.getStartTime())
|
||||
);
|
||||
```
|
||||
|
||||
### 4. 🌐 Controller层API接口
|
||||
|
||||
**时间**: 2025-01-09 16:35:00
|
||||
**文件**: `backend/ruoyi-modules/ruoyi-hq/src/main/java/org/dromara/hq/controller/HqHallReservationController.java`
|
||||
|
||||
**新增接口**:
|
||||
```java
|
||||
/**
|
||||
* 检查报告厅时间冲突
|
||||
*/
|
||||
@SaCheckPermission("hq:hallReservation:query")
|
||||
@PostMapping("/checkTimeConflict")
|
||||
public R<HqHallTimeCheckVo> checkTimeConflict(@Validated @RequestBody HqHallTimeCheckBo timeCheckBo)
|
||||
```
|
||||
|
||||
**接口特点**:
|
||||
- ✅ 使用现有查询权限（hq:hallReservation:query）
|
||||
- ✅ POST方式，支持复杂参数传递
|
||||
- ✅ 完整的参数验证（@Validated）
|
||||
- ✅ 标准R类型响应格式
|
||||
|
||||
### 5. 🔐 权限配置管理
|
||||
|
||||
**时间**: 2025-01-09 16:40:00
|
||||
**文件**: `docs/设计文档/database/hall-audit-permission.sql`
|
||||
|
||||
**权限配置内容**:
|
||||
- ✅ 添加报告厅审核权限（hq:hallReservation:audit）
|
||||
- ✅ 为admin角色分配审核权限
|
||||
- ✅ 使用UPSERT逻辑，支持重复执行
|
||||
- ✅ 包含验证和查询SQL
|
||||
|
||||
**权限ID**: 12216 - 报告厅预约审核权限
|
||||
|
||||
### 6. 📚 API文档完善
|
||||
|
||||
**时间**: 2025-01-09 16:50:00
|
||||
|
||||
#### A. 新建专门API文档
|
||||
**文件**: `docs/开发文档/API/报告厅预约审核API.md`
|
||||
|
||||
**文档特点**:
|
||||
- ✅ 完整的接口说明（400+行）
|
||||
- ✅ 详细的请求/响应示例
|
||||
- ✅ 时间冲突检查算法说明
|
||||
- ✅ 权限配置说明
|
||||
- ✅ 开发建议和常见问题
|
||||
- ✅ 完整的版本记录
|
||||
|
||||
**核心章节**:
|
||||
- 🔍 时间冲突检查API
|
||||
- ✅ 报告厅预约审核API
|
||||
- 📊 数据字典和权限配置
|
||||
- 💡 开发建议和问题排查
|
||||
|
||||
#### B. 更新API文档总览
|
||||
**文件**: `docs/开发文档/API/API文档总览.md`
|
||||
|
||||
**更新内容**:
|
||||
- ✅ 添加报告厅预约审核API到分模块文档表
|
||||
- ✅ 快速导航增加报告厅审核相关链接
|
||||
- ✅ 完善API文档架构说明
|
||||
|
||||
---
|
||||
|
||||
## 📊 技术实现亮点
|
||||
|
||||
### 1. 🧠 智能时间冲突检测
|
||||
- **精确算法**: 使用数学逻辑准确判定时间段重叠
|
||||
- **状态过滤**: 只检查已批准的预约，避免误判
|
||||
- **灵活排除**: 支持编辑场景下排除自身记录
|
||||
- **性能优化**: 数据库层面进行时间比较，减少数据传输
|
||||
|
||||
### 2. 📋 标准化VO类设计
|
||||
- **规范遵循**: 严格按照cursorrules-backend.md强制性规范
|
||||
- **字段完整**: 包含所有必需的基础字段
|
||||
- **JSON格式化**: 时间字段统一格式化
|
||||
- **兼容性保证**: 支持MyBatis-Plus自动查询和自定义SQL
|
||||
|
||||
### 3. 🔒 完整权限控制
|
||||
- **接口级权限**: 每个API都有对应权限验证
|
||||
- **权限复用**: checkTimeConflict复用查询权限
|
||||
- **SQL配置**: 提供完整的权限配置脚本
|
||||
- **角色分配**: 自动为admin角色分配权限
|
||||
|
||||
### 4. 📖 文档质量保证
|
||||
- **技术详细**: 包含算法说明和实现细节
|
||||
- **示例完整**: 提供真实的请求/响应示例
|
||||
- **问题预防**: 包含常见问题和解决方案
|
||||
- **版本管理**: 完整的版本记录和变更说明
|
||||
|
||||
---
|
||||
|
||||
## 🔧 文件变更统计
|
||||
|
||||
### 新增文件（4个）
|
||||
1. `HqHallTimeCheckBo.java` - 时间冲突检查业务对象
|
||||
2. `HqHallTimeCheckVo.java` - 时间冲突检查结果视图对象
|
||||
3. `hall-audit-permission.sql` - 权限配置SQL脚本
|
||||
4. `报告厅预约审核API.md` - API接口文档
|
||||
|
||||
### 修改文件（5个）
|
||||
1. `HqHallReservationVo.java` - 添加基础字段
|
||||
2. `IHqHallReservationService.java` - 新增服务方法
|
||||
3. `HqHallReservationServiceImpl.java` - 实现时间冲突检查
|
||||
4. `HqHallReservationController.java` - 新增API接口
|
||||
5. `API文档总览.md` - 更新文档导航
|
||||
|
||||
### 总代码行数
|
||||
- **Java代码**: 约150行
|
||||
- **SQL脚本**: 约35行
|
||||
- **API文档**: 约400行
|
||||
- **总计**: 约585行
|
||||
|
||||
---
|
||||
|
||||
## ✅ 测试验证要求
|
||||
|
||||
### 1. 🔧 后端接口测试
|
||||
- [ ] 时间冲突检查接口功能测试
|
||||
- [ ] 不同时间段的冲突检测验证
|
||||
- [ ] 排除ID参数的正确性验证
|
||||
- [ ] 权限验证测试
|
||||
|
||||
### 2. 🌐 前端集成测试
|
||||
- [ ] 前端API调用测试
|
||||
- [ ] 审核建议UI显示测试
|
||||
- [ ] 错误处理和用户提示测试
|
||||
|
||||
### 3. 🔐 权限配置验证
|
||||
- [ ] 执行权限配置SQL脚本
|
||||
- [ ] 验证admin角色权限分配
|
||||
- [ ] 测试接口权限控制
|
||||
|
||||
---
|
||||
|
||||
## 🎯 后续工作计划
|
||||
|
||||
### 1. 📱 前端功能优化
|
||||
- 优化审核建议UI展示
|
||||
- 添加实时冲突检查
|
||||
- 完善错误提示机制
|
||||
|
||||
### 2. 🧪 测试覆盖
|
||||
- 编写单元测试
|
||||
- 完善集成测试
|
||||
- 添加性能测试
|
||||
|
||||
### 3. 📊 监控和日志
|
||||
- 添加接口调用监控
|
||||
- 完善错误日志记录
|
||||
- 性能指标收集
|
||||
|
||||
---
|
||||
|
||||
## 📝 开发体验总结
|
||||
|
||||
### 1. ✅ 成功经验
|
||||
- **规范遵循**: 严格按照项目规范开发，保证代码质量
|
||||
- **文档同步**: 代码完成后立即更新文档，保持一致性
|
||||
- **模块化设计**: 清晰的分层架构，便于维护和扩展
|
||||
- **权限控制**: 完整的权限体系，保证系统安全
|
||||
|
||||
### 2. 💡 改进建议
|
||||
- **代码生成**: 可以考虑为BO/VO类创建代码生成模板
|
||||
- **单元测试**: 应该在开发过程中同步编写单元测试
|
||||
- **性能测试**: 大数据量下的时间冲突检查性能需要验证
|
||||
|
||||
### 3. 🎯 质量保证
|
||||
- **代码审查**: 建议进行代码审查，确保质量
|
||||
- **文档校验**: API文档示例需要与实际接口保持一致
|
||||
- **权限测试**: 权限配置需要在实际环境中验证
|
||||
|
||||
---
|
||||
|
||||
**📝 记录人**: wuzilong
|
||||
**🕐 记录时间**: 2025-01-09 17:00:00
|
||||
**🎯 工作质量**: 高质量完成，符合项目规范
|
||||
**📋 下次重点**: 前端集成测试和功能优化
|
||||
>>>>>>> 3f9838e8f119e5bd49ded7fde2a6229e312d9a14
|
||||
@@ -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创建完成后更新验证结果
|
||||
@@ -0,0 +1,26 @@
|
||||
# 代码调整记录 2025-07-01
|
||||
|
||||
## 报告厅预约界面样式优化
|
||||
|
||||
### 调整内容
|
||||
- 优化了报告厅预约界面中暂无图片占位符的样式
|
||||
- 使暂无图片占位符宽度与预约用途输入框保持一致(450px)
|
||||
- 增加了响应式布局支持,在小屏幕上自动适应容器宽度
|
||||
|
||||
### 具体修改
|
||||
- 文件: `web/src/views/hq/hallReservation/index.vue`
|
||||
- 修改了 `no-images-placeholder` 样式类:
|
||||
- 将固定宽度改为响应式宽度 `width: 100%`
|
||||
- 添加最大宽度限制 `max-width: 450px`
|
||||
- 保持与预约用途输入框视觉统一
|
||||
|
||||
### 优化效果
|
||||
- 提升了界面视觉统一性
|
||||
- 改善了响应式布局表现
|
||||
- 优化了用户体验
|
||||
|
||||
### 相关文件
|
||||
- [x] web/src/views/hq/hallReservation/index.vue
|
||||
|
||||
提交人: wuzilong
|
||||
完成时间: 2025-07-01 10:30:00
|
||||
@@ -346,3 +346,196 @@
|
||||
- 次要按钮: 使用轮廓式设计
|
||||
- 危险按钮: 使用错误色
|
||||
- 禁用状态: 降低透明度
|
||||
|
||||
# API接口基础规范（2025-07-01更新）
|
||||
|
||||
## 一、系统基础模块规范
|
||||
|
||||
### 1. 系统模块代码位置
|
||||
|
||||
所有涉及以下功能的API接口代码必须统一写在 `ruoyi-system` 工程中：
|
||||
- 用户管理相关（SysUser）
|
||||
- 组织机构相关（SysDept）
|
||||
- 角色权限相关（SysRole）
|
||||
- 菜单权限相关（SysMenu）
|
||||
- 字典管理相关（SysDict）
|
||||
- 系统配置相关（SysConfig）
|
||||
- 租户管理相关（SysTenant）
|
||||
|
||||
#### 代码组织结构
|
||||
```
|
||||
ruoyi-system/
|
||||
├── src/main/java/org/dromara/system/
|
||||
│ ├── controller/system/ # 控制器（注意是system子包）
|
||||
│ ├── service/ # 服务接口
|
||||
│ ├── service/impl/ # 服务实现
|
||||
│ ├── mapper/ # 数据访问层
|
||||
│ └── domain/ # 实体类和VO对象
|
||||
```
|
||||
|
||||
### 2. 租户过滤规范
|
||||
|
||||
#### 2.1 Controller层
|
||||
```java
|
||||
@RestController
|
||||
@RequestMapping("/system/xxx")
|
||||
public class XxxController {
|
||||
|
||||
@GetMapping("/list")
|
||||
public R<List<XxxVO>> list(@RequestParam(value = "tenantId", required = false) String tenantId) {
|
||||
// 如果tenantId为空，会自动使用当前用户的租户ID
|
||||
return R.ok(xxxService.selectXxxList(tenantId));
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.2 Service层
|
||||
```java
|
||||
@Service
|
||||
public class XxxServiceImpl implements IXxxService {
|
||||
|
||||
@Override
|
||||
public List<XxxVO> selectXxxList(String tenantId) {
|
||||
if (StringUtils.isEmpty(tenantId)) {
|
||||
tenantId = SecurityUtils.getTenantId();
|
||||
}
|
||||
return baseMapper.selectXxxList(tenantId);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.3 Mapper层
|
||||
```java
|
||||
@Mapper
|
||||
public interface XxxMapper {
|
||||
|
||||
@Select("""
|
||||
SELECT
|
||||
x.*
|
||||
FROM xxx x
|
||||
WHERE x.tenant_id = #{tenantId}
|
||||
AND x.del_flag = '0'
|
||||
ORDER BY x.create_time DESC
|
||||
""")
|
||||
List<Xxx> selectXxxList(@Param("tenantId") String tenantId);
|
||||
}
|
||||
```
|
||||
|
||||
### 3. 统一返回值规范
|
||||
|
||||
#### 3.1 后端返回格式
|
||||
```java
|
||||
// 统一返回格式
|
||||
public class R<T> {
|
||||
private int code; // 状态码
|
||||
private String msg; // 消息
|
||||
private T data; // 数据对象
|
||||
}
|
||||
|
||||
// 分页返回格式
|
||||
public class TableDataInfo<T> {
|
||||
private int code; // 状态码
|
||||
private String msg; // 消息
|
||||
private List<T> data; // 数据对象
|
||||
private long total; // 总记录数
|
||||
}
|
||||
```
|
||||
|
||||
#### 3.2 前端获取数据规范
|
||||
```typescript
|
||||
// 标准数据获取
|
||||
const getList = async () => {
|
||||
try {
|
||||
const res = await listApi();
|
||||
// 正确：从data字段获取数据
|
||||
dataList.value = res.data || [];
|
||||
} catch (error) {
|
||||
console.error('获取数据失败:', error);
|
||||
dataList.value = [];
|
||||
}
|
||||
};
|
||||
|
||||
// 分页数据获取
|
||||
const getPageList = async (query: PageQuery) => {
|
||||
try {
|
||||
const res = await pageApi(query);
|
||||
// 正确：从data字段获取列表数据
|
||||
dataList.value = res.data || [];
|
||||
// 获取总数
|
||||
total.value = res.total || 0;
|
||||
} catch (error) {
|
||||
console.error('获取分页数据失败:', error);
|
||||
dataList.value = [];
|
||||
total.value = 0;
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
## 二、代码生成规范
|
||||
|
||||
### 1. 代码生成器配置
|
||||
|
||||
#### 1.1 系统模块配置
|
||||
- 当生成的代码涉及用户、组织、角色等基础功能时：
|
||||
- 包名：`org.dromara.system`
|
||||
- 模块名：`ruoyi-system`
|
||||
- 表前缀：`sys_`
|
||||
|
||||
#### 1.2 租户字段配置
|
||||
- 必须包含租户字段：`tenant_id`
|
||||
- 字段类型：`varchar(20)`
|
||||
- 默认值：`'000000'`
|
||||
- 注释：`租户编号`
|
||||
|
||||
### 2. 模板调整建议
|
||||
|
||||
#### 2.1 Controller模板
|
||||
```java
|
||||
@ApiOperation("查询${functionName}列表")
|
||||
@SaCheckPermission("${permissionPrefix}:list")
|
||||
@GetMapping("/list")
|
||||
public R<List<${ClassName}VO>> list(${ClassName}BO bo) {
|
||||
// 确保设置租户ID
|
||||
if (StringUtils.isEmpty(bo.getTenantId())) {
|
||||
bo.setTenantId(SecurityUtils.getTenantId());
|
||||
}
|
||||
return R.ok(${className}Service.queryList(bo));
|
||||
}
|
||||
```
|
||||
|
||||
#### 2.2 Service模板
|
||||
```java
|
||||
@Override
|
||||
public List<${ClassName}VO> queryList(${ClassName}BO bo) {
|
||||
// 租户过滤
|
||||
LambdaQueryWrapper<${ClassName}> lqw = Wrappers.lambdaQuery();
|
||||
lqw.eq(${ClassName}::getTenantId, bo.getTenantId());
|
||||
// ... 其他查询条件
|
||||
return baseMapper.selectVoList(lqw);
|
||||
}
|
||||
```
|
||||
|
||||
## 三、注意事项
|
||||
|
||||
### 1. 租户ID处理
|
||||
- 前端可以选择性传入租户ID
|
||||
- 如果未传入，后端使用当前用户的租户ID
|
||||
- 禁止跨租户查询（除非特殊说明）
|
||||
|
||||
### 2. 返回值处理
|
||||
- 前端统一从data字段获取数据
|
||||
- 禁止使用rows或其他字段名
|
||||
- 空值处理使用空数组或空对象
|
||||
|
||||
### 3. 系统模块开发
|
||||
- 涉及基础功能必须在ruoyi-system中开发
|
||||
- 保持代码结构统一
|
||||
- 遵循权限命名规范
|
||||
|
||||
---
|
||||
|
||||
**📝 维护说明**：
|
||||
- 更新时间：2025-07-01
|
||||
- 更新人：wuzilong
|
||||
- 基于实际项目开发经验总结
|
||||
- 持续补充和优化
|
||||
@@ -20,6 +20,7 @@
|
||||
| **🛠️ 物业报修管理 API** | [物业报修管理 API.md](./物业报修管理API.md) | 维修分类、报修工单、进度跟踪、服务评价 | 物业报修功能开发 |
|
||||
| **📊 后勤满意度调查 API** | [后勤满意度调查 API.md](./后勤满意度调查API.md) | 问卷管理、答题、题目管理、答题记录 | 满意度调查功能开发 |
|
||||
| **🏢 场地预约管理 API** | [场地预约管理 API.md](./场地预约管理API.md) | 场地信息管理、预约申请、审批流程、冲突检查 | 场地预约功能开发 |
|
||||
| **🎭 报告厅预约审核 API** | [报告厅预约审核 API.md](./报告厅预约审核API.md) | 审核建议生成、时间冲突检查、批量审核处理 | 报告厅审核功能开发 |
|
||||
|
||||
### 📝 阅读建议
|
||||
|
||||
@@ -62,6 +63,13 @@
|
||||
- [预约审批](./场地预约管理API.md#审批场地预约) - 审批流程管理
|
||||
- [时间冲突检查](./场地预约管理API.md#检查时间冲突) - 预约冲突检测
|
||||
|
||||
#### 🎭 报告厅审核相关
|
||||
|
||||
- [报告厅预约查询](./报告厅预约审核API.md#报告厅预约查询-api) - 预约列表和详情查询
|
||||
- [时间冲突检查](./报告厅预约审核API.md#时间冲突检查-api) - 智能冲突检测
|
||||
- [批量审核处理](./报告厅预约审核API.md#报告厅预约审核-api) - 批准/拒绝预约申请
|
||||
- [审核建议生成](./报告厅预约审核API.md#时间冲突检查-api) - 基于冲突检查的智能建议
|
||||
|
||||
### 🔍 按开发阶段查找
|
||||
|
||||
#### 🚀 项目初期
|
||||
|
||||
@@ -393,6 +393,101 @@
|
||||
|
||||
---
|
||||
|
||||
## 预约时间冲突检查接口
|
||||
|
||||
### 1. 检查报告厅预约时间冲突
|
||||
|
||||
#### 接口说明
|
||||
- 接口名称：检查报告厅预约时间是否存在冲突
|
||||
- 接口地址：`/hq/hallReservation/checkTimeConflict`
|
||||
- 请求方式：POST
|
||||
- 接口说明：根据报告厅ID和预约时间段，检查是否与已批准的预约存在时间冲突
|
||||
|
||||
#### 请求参数
|
||||
```json
|
||||
{
|
||||
"hallId": "1", // 报告厅ID
|
||||
"startTime": "2025-01-15 09:00:00", // 预约开始时间
|
||||
"endTime": "2025-01-15 12:00:00", // 预约结束时间
|
||||
"excludeId": "100" // 排除的预约ID（可选，用于编辑时排除自身）
|
||||
}
|
||||
```
|
||||
|
||||
#### 响应参数
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"hasConflict": true, // 是否存在冲突
|
||||
"conflictList": [ // 冲突的预约列表
|
||||
{
|
||||
"id": "101",
|
||||
"hallId": "1",
|
||||
"hallName": "第一报告厅",
|
||||
"startTime": "2025-01-15 10:00:00",
|
||||
"endTime": "2025-01-15 13:00:00",
|
||||
"applicantName": "张三",
|
||||
"status": "1", // 预约状态：0-审核中，1-已批准，2-已拒绝
|
||||
"auditTime": "2025-01-14 15:30:00"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 错误码说明
|
||||
| 错误码 | 说明 |
|
||||
|--------|------|
|
||||
| 200 | 成功 |
|
||||
| 500 | 系统错误 |
|
||||
| 400 | 参数错误 |
|
||||
|
||||
#### 请求示例
|
||||
```http
|
||||
POST /hq/hallReservation/checkTimeConflict
|
||||
Content-Type: application/json
|
||||
|
||||
{
|
||||
"hallId": "1",
|
||||
"startTime": "2025-01-15 09:00:00",
|
||||
"endTime": "2025-01-15 12:00:00"
|
||||
}
|
||||
```
|
||||
|
||||
#### 响应示例
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"hasConflict": true,
|
||||
"conflictList": [
|
||||
{
|
||||
"id": "101",
|
||||
"hallId": "1",
|
||||
"hallName": "第一报告厅",
|
||||
"startTime": "2025-01-15 10:00:00",
|
||||
"endTime": "2025-01-15 13:00:00",
|
||||
"applicantName": "张三",
|
||||
"status": "1",
|
||||
"auditTime": "2025-01-14 15:30:00"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 注意事项
|
||||
1. 时间格式必须为：yyyy-MM-dd HH:mm:ss
|
||||
2. 只检查与已批准（status=1）的预约是否冲突
|
||||
3. 时间冲突的判定规则：
|
||||
- 新预约的开始时间在已有预约时间段内
|
||||
- 新预约的结束时间在已有预约时间段内
|
||||
- 新预约时间段完全包含已有预约时间段
|
||||
|
||||
---
|
||||
|
||||
## 数据字典
|
||||
|
||||
### 场地类型 (hq_venue_type)
|
||||
|
||||
@@ -0,0 +1,429 @@
|
||||
# 报告厅预约审核 API 文档
|
||||
|
||||
## 文档信息
|
||||
|
||||
- **文档名称**: 报告厅预约审核 API 文档
|
||||
- **创建时间**: 2025-01-09
|
||||
- **维护负责人**: 开发团队
|
||||
- **最后更新**: 2025-01-09 16:30:00
|
||||
|
||||
## 概述
|
||||
|
||||
报告厅预约审核模块提供专门的报告厅预约审核功能 API 接口，包括审核建议生成、时间冲突检查、批量审核等核心功能。该模块主要面向管理员用户，用于对用户提交的报告厅预约申请进行审核处理。
|
||||
|
||||
### 核心功能
|
||||
|
||||
- 📋 **预约列表查询**：查询待审核和已审核的报告厅预约申请
|
||||
- 🔍 **时间冲突检查**：智能检测预约时间是否与已批准的预约冲突
|
||||
- 💡 **审核建议生成**：基于时间冲突检查结果自动生成审核建议
|
||||
- ✅ **批量审核处理**：支持批准/拒绝单个或多个预约申请
|
||||
- 📊 **审核记录管理**：记录审核人、审核时间、审核备注等详细信息
|
||||
|
||||
### 技术特点
|
||||
|
||||
- **智能冲突检测**：精确的时间重叠算法，避免预约冲突
|
||||
- **批量操作支持**：高效处理多个预约的审核操作
|
||||
- **权限控制严格**：完整的权限验证机制
|
||||
- **日志记录完整**：详细的操作日志和审核轨迹
|
||||
|
||||
---
|
||||
|
||||
## 🔐 基础规范
|
||||
|
||||
### 请求头规范
|
||||
|
||||
所有需要认证的接口都必须在请求头中携带：
|
||||
|
||||
```json
|
||||
{
|
||||
"Authorization": "Bearer {access_token}",
|
||||
"clientid": "e5cd7e4891bf95d1d19206ce24a7b32e",
|
||||
"Content-Type": "application/json;charset=utf-8",
|
||||
"Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
|
||||
"referer": "http://localhost/login?redirect=%252Findex"
|
||||
}
|
||||
```
|
||||
|
||||
### 响应格式规范
|
||||
|
||||
- **分页列表**: TableDataInfo 格式 (total, rows, code, msg)
|
||||
- **非分页接口**: R 类型格式 (code, msg, data)
|
||||
- **错误响应**: 统一错误格式
|
||||
|
||||
详细规范请参考：[API文档基础规范](./API文档基础规范.md)
|
||||
|
||||
---
|
||||
|
||||
## 📋 报告厅预约查询 API
|
||||
|
||||
### 1. 查询报告厅预约列表
|
||||
|
||||
**接口描述**: 查询报告厅预约申请列表，支持多种条件筛选
|
||||
**请求方式**: `GET`
|
||||
**请求路径**: `/hq/hallReservation/list`
|
||||
**权限要求**: `hq:hallReservation:list`
|
||||
|
||||
#### 请求参数
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
| ------------- | ------- | ---- | ---------------------------------- | ---------------- |
|
||||
| hallName | String | 否 | 报告厅名称（模糊查询） | 第一报告厅 |
|
||||
| startTime | String | 否 | 预约开始时间（查询该时间之后的） | 2025-01-10 |
|
||||
| endTime | String | 否 | 预约结束时间（查询该时间之前的） | 2025-01-15 |
|
||||
| applicantName | String | 否 | 申请人姓名（模糊查询） | 张三 |
|
||||
| status | String | 否 | 预约状态（0-审核中 1-已批准 2-已拒绝） | 0 |
|
||||
| pageNum | Integer | 否 | 页码，默认1 | 1 |
|
||||
| pageSize | Integer | 否 | 每页数量，默认10 | 10 |
|
||||
|
||||
#### 响应示例
|
||||
|
||||
```json
|
||||
{
|
||||
"total": 5,
|
||||
"rows": [
|
||||
{
|
||||
"id": 1234567890123456789,
|
||||
"hallId": 1,
|
||||
"hallName": "第一报告厅",
|
||||
"applicantId": 987654321,
|
||||
"applicantName": "张三",
|
||||
"applicantPhone": "13800138000",
|
||||
"startTime": "2025-01-15 09:00:00",
|
||||
"endTime": "2025-01-15 12:00:00",
|
||||
"reservationPurpose": "学术讲座 - 人工智能发展趋势",
|
||||
"status": "0",
|
||||
"auditBy": null,
|
||||
"auditName": null,
|
||||
"auditTime": null,
|
||||
"auditRemark": null,
|
||||
"createTime": "2025-01-09 14:30:00"
|
||||
}
|
||||
],
|
||||
"code": 200,
|
||||
"msg": "查询成功"
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 获取报告厅预约详情
|
||||
|
||||
**接口描述**: 获取指定预约申请的详细信息
|
||||
**请求方式**: `GET`
|
||||
**请求路径**: `/hq/hallReservation/{id}`
|
||||
**权限要求**: `hq:hallReservation:query`
|
||||
|
||||
#### 路径参数
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
| ------ | ---- | ---- | ------- | ----------------- |
|
||||
| id | Long | 是 | 预约 ID | 1234567890123456789 |
|
||||
|
||||
#### 响应示例
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"id": 1234567890123456789,
|
||||
"hallId": 1,
|
||||
"hallName": "第一报告厅",
|
||||
"applicantId": 987654321,
|
||||
"applicantName": "张三",
|
||||
"applicantPhone": "13800138000",
|
||||
"startTime": "2025-01-15 09:00:00",
|
||||
"endTime": "2025-01-15 12:00:00",
|
||||
"reservationPurpose": "学术讲座 - 人工智能发展趋势",
|
||||
"status": "0",
|
||||
"auditBy": null,
|
||||
"auditName": null,
|
||||
"auditTime": null,
|
||||
"auditRemark": null,
|
||||
"createTime": "2025-01-09 14:30:00"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔍 时间冲突检查 API
|
||||
|
||||
### 检查报告厅预约时间冲突
|
||||
|
||||
**接口描述**: 检查指定报告厅在指定时间段内是否存在已批准的预约冲突
|
||||
**请求方式**: `POST`
|
||||
**请求路径**: `/hq/hallReservation/checkTimeConflict`
|
||||
**权限要求**: `hq:hallReservation:query`
|
||||
|
||||
#### 请求体
|
||||
|
||||
```json
|
||||
{
|
||||
"hallId": 1,
|
||||
"startTime": "2025-01-15 09:00:00",
|
||||
"endTime": "2025-01-15 12:00:00",
|
||||
"excludeId": 1234567890123456789
|
||||
}
|
||||
```
|
||||
|
||||
#### 请求参数说明
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
| --------- | ---- | ---- | --------------------------------------- | --------------------- |
|
||||
| hallId | Long | 是 | 报告厅ID | 1 |
|
||||
| startTime | Date | 是 | 预约开始时间（格式：yyyy-MM-dd HH:mm:ss） | 2025-01-15 09:00:00 |
|
||||
| endTime | Date | 是 | 预约结束时间（格式：yyyy-MM-dd HH:mm:ss） | 2025-01-15 12:00:00 |
|
||||
| excludeId | Long | 否 | 排除的预约ID（编辑时排除自己） | 1234567890123456789 |
|
||||
|
||||
#### 响应示例
|
||||
|
||||
**无冲突时：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"hasConflict": false,
|
||||
"conflictList": [],
|
||||
"conflictMessage": "无时间冲突"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**有冲突时：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": {
|
||||
"hasConflict": true,
|
||||
"conflictList": [
|
||||
{
|
||||
"id": 1234567890123456790,
|
||||
"hallId": 1,
|
||||
"hallName": "第一报告厅",
|
||||
"applicantName": "李四",
|
||||
"applicantPhone": "13900139000",
|
||||
"startTime": "2025-01-15 10:00:00",
|
||||
"endTime": "2025-01-15 13:00:00",
|
||||
"reservationPurpose": "企业宣讲会",
|
||||
"status": "1",
|
||||
"auditName": "管理员",
|
||||
"auditTime": "2025-01-14 15:30:00"
|
||||
}
|
||||
],
|
||||
"conflictMessage": "发现 1 个时间冲突的已批准预约"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 时间冲突判定规则
|
||||
|
||||
两个时间段存在冲突的条件：
|
||||
1. 新预约开始时间 < 已存在预约结束时间
|
||||
2. 新预约结束时间 > 已存在预约开始时间
|
||||
|
||||
即：`startTime < existingEndTime AND endTime > existingStartTime`
|
||||
|
||||
#### 冲突检查逻辑
|
||||
|
||||
1. **同一报告厅**：只检查相同报告厅ID的预约
|
||||
2. **已批准状态**：只检查状态为"1"（已批准）的预约
|
||||
3. **排除自身**：修改预约时可以通过excludeId排除自身
|
||||
4. **精确匹配**：使用数据库时间比较，确保检查准确性
|
||||
|
||||
---
|
||||
|
||||
## ✅ 报告厅预约审核 API
|
||||
|
||||
### 批量审核报告厅预约
|
||||
|
||||
**接口描述**: 批量批准或拒绝报告厅预约申请
|
||||
**请求方式**: `PUT`
|
||||
**请求路径**: `/hq/hallReservation/audit`
|
||||
**权限要求**: `hq:hallReservation:audit`
|
||||
|
||||
#### 请求体
|
||||
|
||||
```json
|
||||
{
|
||||
"ids": [1234567890123456789, 1234567890123456790],
|
||||
"status": "1",
|
||||
"auditRemark": "审核通过，请按时使用报告厅"
|
||||
}
|
||||
```
|
||||
|
||||
#### 请求参数说明
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|
||||
| ----------- | ---------- | ---- | ------------------------------ | ----------------------------------------------- |
|
||||
| ids | Long[] | 是 | 要审核的预约ID数组 | [1234567890123456789, 1234567890123456790] |
|
||||
| status | String | 是 | 审核状态（1-批准 2-拒绝） | 1 |
|
||||
| auditRemark | String | 否 | 审核备注（拒绝时建议填写原因） | 审核通过，请按时使用报告厅 |
|
||||
|
||||
#### 响应示例
|
||||
|
||||
**成功时：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功"
|
||||
}
|
||||
```
|
||||
|
||||
**失败时：**
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 500,
|
||||
"msg": "审核失败，请稍后重试"
|
||||
}
|
||||
```
|
||||
|
||||
#### 审核业务逻辑
|
||||
|
||||
1. **状态检查**：只有状态为"0"（审核中）的预约可以被审核
|
||||
2. **权限验证**：必须具有`hq:hallReservation:audit`权限
|
||||
3. **审核信息记录**：
|
||||
- auditBy：当前登录用户ID
|
||||
- auditName：当前登录用户姓名
|
||||
- auditTime：当前系统时间
|
||||
- auditRemark：审核备注
|
||||
4. **批量操作**：支持一次审核多个预约，保证操作的原子性
|
||||
|
||||
#### 审核状态说明
|
||||
|
||||
| 状态值 | 状态名称 | 说明 |
|
||||
| ------ | -------- | ---------------------- |
|
||||
| 0 | 审核中 | 用户提交，等待审核 |
|
||||
| 1 | 已批准 | 管理员审核通过 |
|
||||
| 2 | 已拒绝 | 管理员审核拒绝 |
|
||||
|
||||
---
|
||||
|
||||
## 📊 数据字典
|
||||
|
||||
### 预约状态 (hall_reserv_status)
|
||||
|
||||
| 字典值 | 字典标签 | 说明 | 颜色标识 |
|
||||
| ------ | -------- | ------------ | -------- |
|
||||
| 0 | 审核中 | 待管理员审核 | 橙色 |
|
||||
| 1 | 已批准 | 审核通过 | 绿色 |
|
||||
| 2 | 已拒绝 | 审核拒绝 | 红色 |
|
||||
|
||||
---
|
||||
|
||||
## 🔒 权限配置
|
||||
|
||||
### 接口权限要求
|
||||
|
||||
| 接口 | 权限标识 | 说明 |
|
||||
| ----------------------------- | --------------------------- | -------------- |
|
||||
| 查询报告厅预约列表 | hq:hallReservation:list | 列表查询权限 |
|
||||
| 获取报告厅预约详情 | hq:hallReservation:query | 详情查询权限 |
|
||||
| 检查报告厅预约时间冲突 | hq:hallReservation:query | 详情查询权限 |
|
||||
| 批量审核报告厅预约 | hq:hallReservation:audit | 审核操作权限 |
|
||||
|
||||
### 权限配置SQL
|
||||
|
||||
参考文件：`docs/设计文档/database/hall-audit-permission.sql`
|
||||
|
||||
---
|
||||
|
||||
## 💡 开发建议
|
||||
|
||||
### 前端集成建议
|
||||
|
||||
1. **审核建议显示**：
|
||||
- 调用时间冲突检查接口
|
||||
- 根据返回结果显示审核建议
|
||||
- 冲突时显示警告图标和冲突详情
|
||||
|
||||
2. **批量操作优化**：
|
||||
- 支持全选/反选功能
|
||||
- 批量操作前进行确认提示
|
||||
- 操作结果统一反馈
|
||||
|
||||
3. **用户体验优化**：
|
||||
- 实时冲突检查
|
||||
- 操作loading状态
|
||||
- 详细的错误提示
|
||||
|
||||
### 后端开发注意事项
|
||||
|
||||
1. **时间处理**：
|
||||
- 统一使用数据库时间进行比较
|
||||
- 注意时区处理
|
||||
- 精确到秒级别
|
||||
|
||||
2. **并发控制**：
|
||||
- 审核操作加锁机制
|
||||
- 防止重复审核
|
||||
- 事务一致性保证
|
||||
|
||||
3. **日志记录**：
|
||||
- 详细的操作日志
|
||||
- 异常情况记录
|
||||
- 性能监控
|
||||
|
||||
---
|
||||
|
||||
## 🐛 常见问题
|
||||
|
||||
### Q1: 时间冲突检查不准确怎么办？
|
||||
|
||||
**A**: 检查以下几点：
|
||||
1. 确认时间格式是否正确（yyyy-MM-dd HH:mm:ss）
|
||||
2. 检查数据库中的时间数据是否准确
|
||||
3. 确认冲突检查的SQL逻辑是否正确
|
||||
4. 检查是否正确排除了指定的预约ID
|
||||
|
||||
### Q2: 批量审核部分失败怎么处理？
|
||||
|
||||
**A**:
|
||||
1. 后端使用事务确保原子性
|
||||
2. 如果部分失败，整个操作回滚
|
||||
3. 返回具体的失败原因
|
||||
4. 前端提示用户重新操作
|
||||
|
||||
### Q3: 审核权限验证失败？
|
||||
|
||||
**A**:
|
||||
1. 检查用户是否具有`hq:hallReservation:audit`权限
|
||||
2. 确认权限配置SQL是否正确执行
|
||||
3. 检查角色权限分配是否正确
|
||||
4. 确认Token是否有效
|
||||
|
||||
---
|
||||
|
||||
## 📝 版本记录
|
||||
|
||||
### v1.0.0 (2025-01-09)
|
||||
|
||||
**新增功能**：
|
||||
- ✨ 报告厅预约时间冲突检查接口
|
||||
- ✨ 智能审核建议生成功能
|
||||
- ✨ 批量审核处理功能
|
||||
- ✨ 完整的权限控制机制
|
||||
- ✨ 详细的审核记录管理
|
||||
|
||||
**技术特点**：
|
||||
- 🔍 精确的时间重叠检测算法
|
||||
- 📊 批量操作支持
|
||||
- 🔒 严格的权限验证
|
||||
- 📝 完整的操作日志
|
||||
|
||||
**API接口**：
|
||||
- GET `/hq/hallReservation/list` - 查询预约列表
|
||||
- GET `/hq/hallReservation/{id}` - 获取预约详情
|
||||
- POST `/hq/hallReservation/checkTimeConflict` - 检查时间冲突
|
||||
- PUT `/hq/hallReservation/audit` - 批量审核预约
|
||||
|
||||
---
|
||||
|
||||
**📝 维护人**: 开发团队
|
||||
**🔄 最后更新**: 2025-01-09 16:30:00
|
||||
**📁 文件位置**: `docs/开发文档/API/报告厅预约审核API.md`
|
||||
**🎯 相关文档**: [API文档基础规范](./API文档基础规范.md) | [API文档总览](./API文档总览.md)
|
||||
@@ -1,4 +1,9 @@
|
||||
# 用户认证登录 API
|
||||
# 用户认证登录API文档
|
||||
|
||||
## 目录
|
||||
1. [用户登录](#用户登录)
|
||||
2. [获取用户信息](#获取用户信息)
|
||||
3. [获取具有指定权限的用户列表](#获取具有指定权限的用户列表)
|
||||
|
||||
## 📋 文档说明
|
||||
|
||||
@@ -660,3 +665,88 @@ methods: {
|
||||
**📝 维护**: 用户认证登录 API 文档
|
||||
**🔄 更新**: 2025-01-03
|
||||
**📁 文件**: 用户认证登录 API.md
|
||||
|
||||
## 获取具有指定权限的用户列表
|
||||
|
||||
### 基本信息
|
||||
- **接口URL**: `/system/user/list-by-permission`
|
||||
- **请求方式**: GET
|
||||
- **接口描述**: 获取具有指定权限的用户列表
|
||||
- **权限标识**: `system:user:list`
|
||||
|
||||
### 请求参数
|
||||
#### Query参数
|
||||
| 参数名 | 类型 | 是否必须 | 说明 | 示例值 |
|
||||
|--------|------|----------|------|--------|
|
||||
| permission | string | 是 | 权限标识符 | hq:hallAudit:list |
|
||||
|
||||
### 响应参数
|
||||
```typescript
|
||||
{
|
||||
code: number; // 状态码
|
||||
msg: string; // 提示信息
|
||||
rows: {
|
||||
userId: string; // 用户ID
|
||||
userName: string; // 用户名
|
||||
nickName: string; // 昵称
|
||||
dept: {
|
||||
deptId: string; // 部门ID
|
||||
deptName: string; // 部门名称
|
||||
};
|
||||
avatar: string; // 头像URL
|
||||
}[];
|
||||
total: number; // 总记录数
|
||||
}
|
||||
```
|
||||
|
||||
### 响应示例
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"rows": [
|
||||
{
|
||||
"userId": "1",
|
||||
"userName": "admin",
|
||||
"nickName": "管理员",
|
||||
"dept": {
|
||||
"deptId": "1",
|
||||
"deptName": "后勤部"
|
||||
},
|
||||
"avatar": "http://example.com/avatar.jpg"
|
||||
}
|
||||
],
|
||||
"total": 1
|
||||
}
|
||||
```
|
||||
|
||||
### 错误码
|
||||
| 错误码 | 说明 |
|
||||
|--------|------|
|
||||
| 401 | 未登录或登录超时 |
|
||||
| 403 | 没有权限 |
|
||||
| 500 | 服务器内部错误 |
|
||||
|
||||
### 注意事项
|
||||
1. 该接口需要用户登录后才能访问
|
||||
2. 返回的用户信息已过滤敏感字段
|
||||
3. 建议前端对结果进行缓存，避免频繁请求
|
||||
4. 返回结果按照用户ID升序排序
|
||||
|
||||
### 使用示例
|
||||
```typescript
|
||||
// 前端调用示例
|
||||
import { listUsersByPermission } from '@/api/system/user';
|
||||
|
||||
async function getAuditors() {
|
||||
try {
|
||||
const res = await listUsersByPermission('hq:hallAudit:list');
|
||||
if (res.code === 200) {
|
||||
return res.rows;
|
||||
}
|
||||
} catch (error) {
|
||||
console.error('获取审核人员列表失败:', error);
|
||||
return [];
|
||||
}
|
||||
}
|
||||
```
|
||||
@@ -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 条用例，并生成新的执行报告。
|
||||
|
||||
---
|
||||
|
||||
> **提示**: 测试执行失败时，应先解决环境/功能就绪问题，再进行自动化测试脚本调试。
|
||||
@@ -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`。
|
||||
@@ -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;
|
||||
@@ -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;
|
||||
@@ -0,0 +1,36 @@
|
||||
-- ==========================================
|
||||
-- 报告厅审核权限配置脚本
|
||||
-- 功能：为报告厅审核功能添加完整权限配置
|
||||
-- 时间：2025-01-09 16:30:00
|
||||
-- 说明：使用UPSERT逻辑，支持重复执行
|
||||
-- ==========================================
|
||||
|
||||
-- 第一部分：添加报告厅审核权限到现有菜单下
|
||||
INSERT INTO sys_menu (
|
||||
menu_id, menu_name, parent_id, order_num, path, component,
|
||||
query_param, is_frame, is_cache, menu_type, visible, status,
|
||||
perms, icon, create_by, create_time, update_by, update_time, remark
|
||||
)
|
||||
SELECT
|
||||
12216, '报告厅预约审核', 2100, 6, '', '', '', 1, 0, 'F', '0', '0',
|
||||
'hq:hallReservation:audit', '#', 1, now(), 1, now(), '报告厅预约审核权限'
|
||||
WHERE NOT EXISTS (SELECT 1 FROM sys_menu WHERE menu_id = 12216);
|
||||
|
||||
-- 第二部分：为admin角色分配审核权限（如果未分配）
|
||||
INSERT IGNORE INTO sys_role_menu (role_id, menu_id)
|
||||
SELECT 1, 12216 WHERE NOT EXISTS (
|
||||
SELECT 1 FROM sys_role_menu WHERE role_id = 1 AND menu_id = 12216
|
||||
);
|
||||
|
||||
-- 第三部分：验证配置结果
|
||||
SELECT '报告厅审核权限配置验证' as message,
|
||||
COUNT(*) as new_menu_count,
|
||||
(SELECT COUNT(*) FROM sys_role_menu WHERE role_id = 1 AND menu_id = 12216) as role_permission_count
|
||||
FROM sys_menu
|
||||
WHERE menu_id = 12216;
|
||||
|
||||
-- 第四部分：查看所有报告厅相关权限
|
||||
SELECT menu_id, menu_name, perms, menu_type, parent_id
|
||||
FROM sys_menu
|
||||
WHERE perms LIKE 'hq:hall%'
|
||||
ORDER BY menu_id;
|
||||
Reference in new issue
Block a user