This commit is contained in:
zlwu committed 2026-09-22 19:22:18 +08:00
1 parent 5fd0042068
commit 1e6dcb164c
94 files changed
+796 -312

No files matched your search

@@ -2,8 +2,8 @@
## 文档信息
- **版本**:1.0.0
- **最后更新**:2025-07-01
- **版本**:1.0.1
- **最后更新**:2026-09-20
- **作者**:Cursor AI
- **分类**:后勤管理模块
@@ -11,6 +11,13 @@
本文档详细说明后勤满意度调查系统的API接口设计,包括问卷管理、题目管理、选项管理、答题记录等功能。系统采用前后端分离架构,接口采用RESTful API风格设计,所有接口均需通过Token进行身份验证。
### 问卷过期处理(2026-09-20)
- 原依赖 SnailJob 任务 `surveyEndTimeJob` / `surveyEndTimeJobExecutor` 每小时扫描过期问卷。
- 已改为 Spring `@Scheduled`:`HqSatSurveyExpireTask`(cron:`0 0 * * * ?`),将 `hq_sat_survey` 中 `end_time` 已过期且未结束的记录 `status` 更新为 `2`。
- 多实例通过 Redis 锁 `hq:sat:survey:expire:lock` 避免重复执行。
- 测试库已关闭对应 SnailJob 任务(`job_status=0`),避免与 `@Scheduled` 双跑。
## 通用响应格式
### 成功响应
+1 -1
View File
@@ -649,4 +649,4 @@
1. 职位申请提交前需要先保存应聘者信息,获取applicantId
2. 职位状态更改会影响前台展示,下线的职位不会在公开列表中展示
3. 所有API请求需要在Header中附带Token
4. 公开的API(如public/list、public/{jobId})可以通过权限配置允许匿名访问
4. 公开的API(如public/list、public/{jobId})可以通过权限配置允许匿名访问;`POST /rs/application/submit` 须登录后调用
@@ -331,8 +331,8 @@ DEFAULT_TENANT_ID = 000000
## 7. 后续优化建议
1. **配置外置化**:将 CAS 地址、client_id、client_secret、redirect_uri 移至 `application.yml`,避免硬编码
2. **密钥安全**:前端不应保留 `CAS_CLIENT_SECRET`(当前未使用但存在代码中,建议删除)
1. **配置外置化**:将 CAS 地址、client_id、client_secret、redirect_uri 移至 `application.yml`,避免硬编码(后端 secret 仍待外置)
2. **密钥安全**:~~前端不应保留 `CAS_CLIENT_SECRET`~~(已删除;换票仅走后端;CAS 相关日志已脱敏,禁止打印 secret/token/profile)
3. **租户映射**:如需支持多租户,可恢复对 CAS `TENANTID` 的解析逻辑
4. **用户自动注册**:CAS 用户首次登录时自动创建本地账号(需评估权限与安全策略)
5. **移动端接入**:mobile 工程可参考相同 OAuth2 流程实现统一认证登录