feat: 同步代码与文档,完善满意度调查相关功能及文档记录(含前后端、API文档、变更日志等)

This commit is contained in:
zlwu committed 2025-07-15 19:52:54 +08:00
1 parent eeb79de050
commit 7a10da0ffc
15 files changed
+460 -177

No files matched your search

@@ -0,0 +1,64 @@
# 代码调整记录(2025-07-15 cursor)
## 变更时间
2025-07-15 20:00:00
## 变更人
cursor
## 变更内容
- 【满意度调查-问卷管理】新增弹窗时,问卷编号(surveyCode)自动生成唯一值并填入表单,无需手动输入。
- 生成规则:编号格式为 `SAT-YYYYMMDD-xxxxxx`,其中 `xxxxxx` 为基于时间和随机数的唯一字符串。
- 主要代码位置:`web/src/views/hq/satSurvey/index.vue`,`handleAdd` 方法。
- 复用工具:`@/utils/index` 的 `createUniqueString`。
## 规范说明
- 遵循前端开发规范,自动生成唯一编号,提升用户体验,避免重复。
- 变更已同步记录至本文件,符合项目文档同步要求。
---
## 变更时间
2025-07-15 14:30:00
## 变更人
cursor
## 变更内容
- 【满意度调查-题库管理】新增API查询所有题目分类(包括已逻辑删除的),解决题目列表显示已删除分类的问题。
- 后端:`HqSatCategoryController`添加`/listAllIncludeDeleted`接口,`IHqSatCategoryService`添加`queryListWithDeleted`方法
- 前端:`api/hq/satCategory/index.ts`添加`listAllSatCategory`方法,`views/hq/satQuestion/index.vue`修改`getAllCategoryList`
- 技术实现:通过SQL条件`last("AND 1=1")`忽略MyBatis-Plus自动添加的逻辑删除条件,实现查询所有数据(包括已删除)
## 规范说明
- 遵循后端开发规范,保留原有接口功能,新增接口处理特殊需求
- 逻辑删除规范:系统中所有删除为逻辑删除,但特殊场景需要查询所有数据时,通过专门接口实现
- 变更已同步记录至本文件,符合项目文档同步要求
## 相关文档
- **API文档**: `docs/开发文档/API/后勤满意度调查API.md`
- **数据库设计**: `docs/设计文档/database/满意度调查模块表设计.sql`
---
## 变更时间
2025-07-15 16:00:00
## 变更人
cursor
## 变更内容
- 【满意度调查-题库管理】修复查询所有题目分类接口SQL语法错误问题
- 错误原因:使用MyBatis-Plus的`last("AND 1=1")`方法导致生成的SQL语法错误
```sql
SELECT ... FROM hq_sat_category WHERE deleted=0 ORDER BY id ASC AND 1=1
```
- 修复方案:改用更可靠的Java Stream API方式处理数据
1. 使用`baseMapper.selectByMap(null)`获取所有记录
2. 通过Stream流式处理,手动实现过滤、转换和排序
3. 不再依赖SQL语法,避免复杂的SQL拼接问题
## 规范说明
- 遵循异常处理规范,通过代码调整解决生产环境中出现的问题
- 使用函数式编程,提高代码可读性和可维护性
- 变更已同步记录至本文件,符合项目文档同步要求