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

resolve: 解决合并冲突

Browse Source
This commit is contained in:
wuzhen committed 2025-07-10 18:02:35 +08:00
2 parents 661a513f57 3f9838e8f1
commit 80dface225
97 files changed
+4789 -1686
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/变更管理/code-adjust-record-2025-01-09-wuzilong.md
+448
View File
@@ -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
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/变更管理/code-adjust-record-2025-07-01-wuzilong.md
+26
View File
@@ -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