weekly-2026-W45
周报 · 2026年第45周(11月02日 - 11月08日)
姓名: 邓星星(dengxingxing) 项目: hoolihome-project 分支: production 提交数: 29 个(含 26 个功能提交)
📋 本周工作汇总
按日期统计
| 日期 | 提交数 | 主要内容 |
|---|---|---|
| 11/02 周一 | 0 | — |
| 11/03 周二 | 10 | 列表接口添加业务跳转文案展示;支持到账流水全选功能并新增导出接口;支持订单取消时间范围查询及相关权限校验 … |
| 11/04 周三 | 6 | 调整OSS客户端配置及完善附件签名校验;限制全选查询最大返回1000条记录;支持iQ多学年数据同步与合并处理 … |
| 11/05 周四 | 9 | 集成管理模块消息通知功能;新增招聘模块并整合权限与统一日志支持;优化通用日志记录执行器实现 … |
| 11/06 周五 | 4 | 优化发票税务字段计算与状态操作锁机制;区分创建时间和评价时间,调整评价记录的时间字段处理;修正员工统计中在职员工计数逻辑 … |
| 11/07 周六 | 0 | — |
| 11/08 周日 | 0 | — |
按模块统计
| 模块 | 提交数 |
|---|---|
| 数据同步 | 5 |
| CRM/销售 | 4 |
| 发票与财务 | 3 |
| 员工人事 | 3 |
| 日志与审计 | 3 |
| 系统配置 | 2 |
| 顾问评价 | 2 |
| 订单中心 | 1 |
| 合作方 | 1 |
| 测试 | 1 |
| 查询与检索 | 1 |
| 消息通知 | 1 |
| 招聘模块 | 1 |
| 房源/房型 | 1 |
🛠 详细工作内容
1. feat(qywx): 列表接口添加业务跳转文案展示 ⭐ 新增
- 提交:
6454412ba0ee(2026-11-03) - 模块: CRM/销售
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/QywxMessageController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/qywx/MessageJumpText.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/qywx/QywxMessageService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/QywxMessageJumpTextTest.java - 改动量: +229 行 / -0 行
- 功能说明: 企业微信消息列表接口新增
jumpText字段,为每条消息生成可直接展示的业务跳转文案。跳转文案根据业务类型、消息数据快照及到账回执信息提取标题,优先使用回执号,其次按既定字段顺序读取快照名称,均缺失时回退到关联业务 ID,同时兼容无效的历史快照。为保障该能力,生产修复测试任务中纳入了新增的QywxMessageJumpTextTest测试。
@@ -50,4 +50,5 @@ tasks.register('testProductionFixes', Test) {
filter {
includeTestsMatching 'com.hoolihome.crm.controller.QywxMessageUnreadTest'
+ includeTestsMatching 'com.hoolihome.crm.controller.QywxMessageJumpTextTest'
includeTestsMatching 'com.hoolihome.crm.service.qywx.MessageFavoriteTest'
includeTestsMatching 'com.hoolihome.admin.controller.QywxAuthUserInfoTest'
@@ -46,6 +46,8 @@ public class QywxMessageController {
if (!list.isEmpty()) {
var hObjs = new ArrayList<Dict>();
+ var jumpTexts = qywxMessageService.getJumpTexts(list);
for (var item : list) {
var vo = BeanUtil.copyProperties( item,Dict.class);
+ vo.set("jumpText", jumpTexts.getOrDefault(item.getId(), ""));
vo.set("attachmentFile", attachmentTraceProvider.enrich(item.getAttachmentFile()));
2. feat(arrival-ledger): 支持到账流水全选功能并新增导出接口 ⭐ 新增
- 提交:
67f8ea00390f(2026-11-03) - 模块: 发票与财务
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/CommissionArrivalLedgerController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/export/ArrivalLedgerExportRow.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/export/ArrivalLedgerExportService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/ArrivalLedgerPageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/CommissionArrivalLedgerService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/export/ArrivalLedgerExportTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/CommissionArrivalLedgerKeywordTest.java等 9 个文件 - 改动量: +370 行 / -6 行
- 功能说明: 在到账流水分页查询中支持
allSelect,返回符合查询条件的所有流水 ID 及数量,便于前端执行全选操作。新增导出字段查询和按已选 ID 导出接口,校验操作权限后异步提交导出任务,完成后通过下载分类消息通知用户;导出内容沿用列表展示口径,并将流水编号、金额及银行参考号按文本写入,避免 Excel 自动格式化。新增到账流水导出模型及相关回归测试任务,用于覆盖筛选、全选和导出流程。
@@ -360,4 +360,17 @@ tasks.register('testAssignableSales', Test) {
}
+// 到账流水筛选、排序、全选、导出与既有维护/展示回归;不连接外部服务。
+tasks.register('testArrivalLedger', Test) {
+ enabled = true
+ useJUnitPlatform()
+ testClassesDirs = sourceSets.test.output.classesDirs
+ classpath = sourceSets.test.runtimeClasspath
+ filter {
+ includeTestsMatching 'com.hoolihome.erp.service.CommissionArrivalLedger*Test'
+ includeTestsMatching 'com.hoolihome.erp.export.ArrivalLedgerExportTest'
+ }
+ systemProperty 'user.timezone', 'Asia/Shanghai'
+}
3. feat(order): 支持订单取消时间范围查询及相关权限校验 ⭐ 新增
- 提交:
922e6b17a0e4(2026-11-03) - 模块: 订单中心
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/OrderPageQuery.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/query/OrderPageQueryService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/query/OrdinaryPageQueryTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/query/OrdinaryQueryHttpTest.java - 改动量: +59 行 / -0 行
- 功能说明: 订单分页查询新增取消时间范围参数
cancelTimeFrom、cancelTimeTo,支持按日期或精确到秒筛选订单取消记录,结束日期仅传日期时包含当天全天。查询构建时将时间条件应用到cancel_time字段,并沿用现有销售、BD等数据权限范围,确保筛选结果不会越权。补充测试覆盖分页与全量查询参数绑定、订单状态组合、权限过滤、空值及非法日期和倒置时间范围校验。
@@ -114,4 +114,10 @@ public class OrderPageQuery extends OrdinaryPageQuery {
private String financialClosingTimeTo;
+ /** 订单取消时间下界;yyyy-MM-dd或yyyy-MM-dd HH:mm:ss */
+ private String cancelTimeFrom;
+
+ /** 订单取消时间上界;仅日期时包含全天 */
+ private String cancelTimeTo;
+
/** 负责销售:USER人员、DEPT部门、SPECIAL本人/下属 */
private List<MemberValue> salesUserIdMembers;
@@ -94,4 +94,5 @@ public class OrderPageQueryService {
dates(q, OrderInfo.FINANCIAL_AUDIT_TIME, p.getFinancialAuditTimeFrom(), p.getFinancialAuditTimeTo(), false);
dates(q, OrderInfo.FINANCIAL_CLOSING_TIME, p.getFinancialClosingTimeFrom(), p.getFinancialClosingTimeTo(), false);
+ dates(q, OrderInfo.CANCEL_TIME, p.getCancelTimeFrom(), p.getCancelTimeTo(), false);
4. fix(management): 优化OSS客户端配置并增强错误日志记录 🐛 修复
- 提交:
9f06c2d23d23(2026-11-03) - 模块: 系统配置
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/management/ManagementAttachmentService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/management/ManagementAttachmentTest.java - 改动量: +45 行 / -2 行
- 功能说明: OSS 客户端改为使用配置的源站 Endpoint,并自动补全 HTTPS 协议、关闭 CNAME 支持,避免带签名的 HEAD 请求被展示域名拒绝,同时继续复用客户端实例。附件校验失败时记录异常类型、OSS 错误码和 RequestId,便于定位存储访问问题,对外仍返回统一的业务错误。补充测试覆盖不同 Endpoint 格式、CNAME 配置、客户端复用,以及展示 URL 与源站对象地址的一致性校验。
@@ -6,4 +6,5 @@ import com.hoolihome.common.utils.OssCnameSignClient;
import com.hoolihome.home.service.IHomeOssFilesService;
import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
import org.springframework.beans.factory.DisposableBean;
@@ -17,4 +18,5 @@ import java.util.zip.ZipInputStream;
@Service
@RequiredArgsConstructor
+@Slf4j
public class ManagementAttachmentService implements DisposableBean {
private static final String BUCKET="bj-files-hoolihome";
@@ -23,5 +25,11 @@ public class ManagementAttachmentService implements DisposableBean {
private OSS client;
5. feat(businessCooperation): 按上海时区格式化创建时间并完善测试 ⭐ 新增
- 提交:
bd1c89834c1b(2026-11-03) - 模块: 合作方
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/management/BusinessCooperationService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/management/ManagementIntegrationTest.java - 改动量: +29 行 / -0 行
- 功能说明: 在商务合作列表、详情等响应中新增
createTime字段,将数据库中的毫秒时间戳统一按上海时区(Asia/Shanghai)格式化,便于业务侧展示一致的本地创建时间。对于缺失、零值或负值的创建时间,明确返回null并保留字段,避免异常时间被误展示;同时补充集成测试,覆盖列表、详情、更新接口的时间格式一致性以及创建时间只读校验。
@@ -11,4 +11,5 @@ import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
+import java.time.*;
import java.util.*;
@@ -84,4 +85,7 @@ public class BusinessCooperationService {
for(String f:List.of("email","wechat","remark","mobile"))d.put(f,r.get(f));d.put("mobilePrefix",r.get("mobile_prefix"));
d.put("userInfo",relations.registered(r.get("user_id")==null?null:((Number)r.get("user_id")).intValue()));d.put("recordVersion",r.get("record_version")
+ Object created=r.get("create_timestamp");
+ d.put("createTime",created instanceof Number&&((Number)created).longValue()>0
+ ?LocalDateTime.ofInstant(Instant.ofEpochMilli(((Number)created).longValue()),ZoneId.of("Asia/Shanghai")).format(ManagementValues.TIME):null);
if(detail){d.put("countryId",r.get("country_id") instanceof Number&&((Number)r.get("country_id")).intValue()!=0?r.get("country_id"):null);d.put("cityId
}
@@ -123,4 +123,29 @@ class ManagementIntegrationTest {
6. feat(avatar): 实现员工账号双头像功能,区分账号头像与顾问主页头像 ⭐ 新增
- 提交:
c2d10d84035e(2026-11-03) - 模块: 员工人事
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/controller/ReportRelationController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/params/CreatePlatformUserParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/params/UpdatePlatformUserParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/service/PlatformUserService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/vo/ReportRelationVo.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/vo/UserVo.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/vo/AdviserVo.java等 20 个文件 - 改动量: +209 行 / -52 行
- 功能说明: 为员工账号增加独立的账号头像
avatar,并通过headImg单独返回顾问主页图片对象,使两套头像在账号信息和上下级关系等接口中互不混淆。平台用户创建、编辑参数同步明确avatar与headerImage的字段语义,顾问缓存键升级至 v3 并在更新后主动清理,确保头像调整能够及时生效。新增专项测试任务,覆盖双头像解析、人员选择与登录、批量装配及相关缓存版本逻辑。
@@ -382,2 +382,18 @@ tasks.register('testInvoiceExport', Test) {
systemProperty 'user.timezone', 'Asia/Shanghai'
}
+
+// 员工账号双头像、人员选择/登录、批量装配及缓存版本专项验证,不连接外部服务。
+tasks.register('testPlatformUserAvatar', Test) {
+ enabled = true
+ useJUnitPlatform()
+ testClassesDirs = sourceSets.test.output.classesDirs
+ classpath = sourceSets.test.runtimeClasspath
+ filter {
+ includeTestsMatching 'com.hoolihome.crm.service.resolve.PlatformUserAvatarTest'
+ includeTestsMatching 'com.hoolihome.crm.service.resolve.AdviserAccountInfoTest'
+ includeTestsMatching 'com.hoolihome.crm.service.resolve.AdviserBatchDetailsTest'
7. refactor(data-cron): 重构八爪鱼数据同步服务与租期处理 ♻️ 重构
- 提交:
d68cc69c345f(2026-11-03) - 模块: 数据同步
- 涉及文件:
hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/build.gradle、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/cron/jobs/house/BazhuayuHouseSync.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/AlliedBZYService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiRoomRentSyncService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/BazhuayuImportRetentionService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/BazhuayuLeaseMapping.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/BazhuayuRoomRentSyncService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/HostBZYService.java等 13 个文件 - 改动量: +445 行 / -571 行
- 功能说明: 八爪鱼房源定时任务改为调用
BazhuayuImportRetentionService清理过期导入租期,并暂时停用 Fresh、CRM 的独立同步入口,继续保留 Allied、Novel Student 和 Host 供应商的数据同步。Allied 同步服务被简化为统一委托BazhuayuRoomRentSyncService处理租期结构映射,同时各同步环节的异常日志补充了堆栈,便于定位失败原因。另新增独立的八爪鱼测试任务,覆盖结构映射、完整快照及失败重试逻辑,并使用上海时区且不连接业务环境。
@@ -49,2 +49,12 @@ tasks.register('testQywxMsgJob', Test) {
systemProperty 'user.timezone', 'Asia/Shanghai'
}
+
+// 八爪鱼结构映射、完整快照和失败重试;不连接业务环境。
+tasks.register('testBazhuayuLeaseSync', Test) {
+ enabled = true
+ useJUnitPlatform()
+ testClassesDirs = sourceSets.test.output.classesDirs
+ classpath = sourceSets.test.runtimeClasspath
+ filter { includeTestsMatching 'com.hoolihome.data.service.Bazhuayu*Test' }
+ systemProperty 'user.timezone', 'Asia/Shanghai'
+}
@@ -13,7 +13,5 @@ public class BazhuayuHouseSync extends BaseSimpleJob {
8. feat(bazhuayu): 增加直连导入保护与失败重试机制 ⭐ 新增
- 提交:
e25702e48944(2026-11-03) - 模块: 数据同步
- 涉及文件:
hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/build.gradle、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiRoomRentSyncService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/BazhuayuImportStability.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/BazhuayuLeaseMapping.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/BazhuayuRoomRentSyncService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/test/java/com/hoolihome/data/service/ApiRoomRentSyncServiceTest.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/test/java/com/hoolihome/data/service/BazhuayuImportFlowTest.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/test/java/com/hoolihome/data/service/BazhuayuImportStabilityTest.java等 10 个文件 - 改动量: +449 行 / -36 行
- 功能说明: 新增八爪鱼导入稳定性观察机制,按内容指纹判断数据是否在可配置的静默窗口内持续未变化;指纹排除同步确认字段,避免确认操作反复重置等待时间,并在重启后重新观察。新增直连导入的合并写入方式,导入数据缺少完整批次标记时清空撤下租期计划,仅同步新增或变更内容,避免误将未返回的源数据视为已下架。原有完整快照同步行为保持不变,用于区分全量同步与直连导入场景。
@@ -50,5 +50,5 @@ tasks.register('testQywxMsgJob', Test) {
}
-// 八爪鱼结构映射、完整快照和失败重试;不连接业务环境。
+// 八爪鱼结构映射、直连导入保护和失败重试;不连接业务环境。
tasks.register('testBazhuayuLeaseSync', Test) {
enabled = true
@@ -31,4 +31,14 @@ public class ApiRoomRentSyncService {
@Transactional(rollbackFor = Exception.class)
public ApiLeaseSyncResult syncWithResult(Integer houseId, Integer roomId, List<RoomRentAttr> incoming) {
+ return write(houseId, roomId, incoming, true);
+ }
+
+ /** 八爪鱼直连导入没有完成标记,缺失源行不能作为撤下租期的依据。 */
+ @Transactional(rollbackFor = Exception.class)
9. fix(personnel): 调整OSS客户端配置及完善附件签名校验 🐛 修复
- 提交:
153a99298ff7(2026-11-04) - 模块: 员工人事
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/personnel/service/PersonnelAttachmentService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/personnel/service/PersonnelAttachmentTest.java - 改动量: +48 行 / -2 行
- 功能说明: 人事附件服务的 OSS 客户端改为使用配置中的源站 Endpoint,并兼容缺少协议的地址,同时关闭 CNAME 支持,避免展示域名拒绝携带签名的 HEAD 请求。元数据、内容及 ACL 校验统一通过 OSS 源站完成,展示签名则继续使用独立的签名客户端。导入附件在生成临时访问 URL 前会先检查对象是否存在且 ACL 为私有,附件缺失或为公共读权限时拒绝签名,防止不安全文件被展示。新增测试覆盖 Endpoint 规范化、客户端复用,以及签名前元数据和私有 ACL 校验顺序。
@@ -34,6 +34,9 @@ public class PersonnelAttachmentService implements DisposableBean {
var meta = properties.getHOss().get(PersonnelAccessService.BUCKET);
if (meta == null) throw new PersonnelException("人事私有文件存储尚未配置");
- var config = new com.aliyun.oss.ClientBuilderConfiguration(); config.setSupportCname(true);
- client = new OSSClientBuilder().build("https://vip-data.hoolihome.com", meta.getAccessKeyId(), meta.getAccessKeySecret(), config);
+ // 展示域名会拒绝带签名的 HEAD;元数据、内容及 ACL 校验使用 OSS 源站。
+ String endpoint = meta.getEndpoint();
+ if (!endpoint.contains("://")) endpoint = "https://" + endpoint;
+ var config = new com.aliyun.oss.ClientBuilderConfiguration(); config.setSupportCname(false);
+ client = new OSSClientBuilder().build(endpoint, meta.getAccessKeyId(), meta.getAccessKeySecret(), config);
}
return client;
@@ -2,5 +2,7 @@ package com.hoolihome.personnel.service;
import com.aliyun.oss.OSS;
10. refactor(query): 限制全选查询最大返回1000条记录 ♻️ 重构
- 提交:
4df8a8a527de(2026-11-04) - 模块: 查询与检索
- 涉及文件:
.gitignore、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/query/builder/OrdinaryQuerySupport.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/ApplicationFormController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/CashBackController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/GiftServiceController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/LeadsController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/OrderController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/ReferralController.java等 23 个文件 - 改动量: +281 行 / -29 行
- 功能说明: 新增
OrdinaryQuerySupport.limitAllSelect统一在全选查询 SQL 末尾追加LIMIT 1000,并保留原有筛选、权限和排序逻辑,不受前端分页参数影响。该限制已应用于申请单和线索的全选 ID 查询,避免一次返回过多记录造成数据库与前端处理压力;返现、礼品等控制器仅更新相关说明文字。另将本地工作区的AGENTS.md加入.gitignore,避免个人代理配置被提交到仓库。
@@ -58,2 +58,5 @@ skills-lock.json
docs/apifox/
.apifox-helper.properties
+
+# Local workspace agent instructions
+/AGENTS.md
@@ -21,4 +21,13 @@ public final class OrdinaryQuerySupport {
private OrdinaryQuerySupport() {}
+ /** 全选统一上限;新增全选入口也必须通过 limitAllSelect 在数据库查询阶段限量。 */
+ public static final int ALL_SELECT_MAX_ROWS = 1000;
+
+ /** 保留原筛选、权限与排序,仅为全选查询加上固定上限,不受前端limit/page控制。 */
+ public static <T> QueryWrapper<T> limitAllSelect(QueryWrapper<T> query) {
+ return query.last("LIMIT " + ALL_SELECT_MAX_ROWS);
11. feat(iq): 支持iQ多学年数据同步与合并处理 ⭐ 新增
- 提交:
7e93de1c98b4(2026-11-04) - 模块: 数据同步
- 涉及文件:
hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiRoomRentSyncService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiSyncBatch.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/IQSyncService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/test/java/com/hoolihome/data/service/ApiIqSyncTest.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/test/java/com/hoolihome/data/service/ApiRoomRentSyncServiceTest.java - 改动量: +192 行 / -24 行
- 功能说明: 同步任务改为根据同步日期动态获取 iQ 学年列表,并将同一公寓各学年的房型数据合并后统一处理,避免逐学年写入时相互覆盖。新增局部合并模式,只新增或更新本轮返回的租期,保留未被本轮数据覆盖的既有租期,防止多学年数据不完整时误撤下租期。同时调整公寓与房型查询及异常报告逻辑,以支持跨学年汇总同步。
@@ -34,5 +34,5 @@ public class ApiRoomRentSyncService {
}
- /** 八爪鱼直连导入没有完成标记,缺失源行不能作为撤下租期的依据。 */
+ /** 八爪鱼直连导入、iQ 多学年等局部来源中,缺失源行不能作为撤下租期的依据。 */
@Transactional(rollbackFor = Exception.class)
public ApiLeaseSyncResult mergeWithResult(Integer houseId, Integer roomId, List<RoomRentAttr> incoming) {
@@ -31,8 +31,19 @@ public final class ApiSyncBatch {
public void flush(ApiRoomRentSyncService service) {
+ flush(service, true);
+ }
+
+ /** 多学年等局部来源只新增和更新,保留本轮未覆盖的既有租期。 */
+ public void merge(ApiRoomRentSyncService service) {
+ flush(service, false);
12. fix(payment-receiver): 补齐收款账户创建人回显 🐛 修复
- 提交:
87c520b743d1(2026-11-04) - 模块: 发票与财务
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/CommissionPaymentReceiverService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/vo/PaymentReceiverVo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/PaymentReceiverCreatorTest.java - 改动量: +143 行 / -4 行
- 功能说明: 在收款账户列表、详情等 VO 构建过程中补充创建人账号 ID 和姓名回显,并通过批量查询平台用户信息避免逐条查询。创建人姓名统一从用户表获取,历史账号停用或不存在时保留可查询到的姓名,无法匹配时返回空字符串,解决收款账户创建人信息缺失的问题。同步新增
PaymentReceiverCreatorTest及 Gradle 测试任务,验证创建人回显和既有通知人维护相关逻辑。
@@ -377,4 +377,17 @@ tasks.register('testArrivalLedger', Test) {
}
+// 收款账户创建人回显及既有通知人维护;不连接外部服务。
+tasks.register('testPaymentReceiver', Test) {
+ enabled = true
+ useJUnitPlatform()
+ testClassesDirs = sourceSets.test.output.classesDirs
+ classpath = sourceSets.test.runtimeClasspath
+ filter {
+ includeTestsMatching 'com.hoolihome.erp.service.PaymentReceiverCreatorTest'
+ includeTestsMatching 'com.hoolihome.erp.service.InvoiceNotificationTest'
+ }
+ systemProperty 'user.timezone', 'Asia/Shanghai'
+}
13. feat(distributor): 新增好友和群绑定状态查询过滤功能 ⭐ 新增
- 提交:
a5d655dd215e(2026-11-04) - 模块: CRM/销售
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/DistributorPageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/DistributorStatisticsParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/DistributorService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/distributor/DistributorBindingFilterTest.java - 改动量: +190 行 / -1 行
- 功能说明: 在合作方分页和统计查询参数中新增好友绑定状态、合作方企业群绑定状态两个过滤条件,分别支持已绑定、未绑定筛选,未传参数时保持原查询逻辑。服务层根据企业微信外部用户 ID 和群 ID 是否为空应用过滤,覆盖合作方用户、企业列表及相关统计查询,便于运营识别未完成微信好友或群绑定的情况。同时补充绑定过滤测试,并将新测试纳入
testDistributorBusinessStatistics测试任务。
@@ -334,5 +334,8 @@ tasks.register('testDistributorBusinessStatistics', Test) {
testClassesDirs = sourceSets.test.output.classesDirs
classpath = sourceSets.test.runtimeClasspath
- filter { includeTestsMatching 'com.hoolihome.crm.service.distributor.DistributorBusinessStatisticsTest' }
+ filter {
+ includeTestsMatching 'com.hoolihome.crm.service.distributor.DistributorBusinessStatisticsTest'
+ includeTestsMatching 'com.hoolihome.crm.service.distributor.DistributorBindingFilterTest'
+ }
systemProperty 'user.timezone', 'Asia/Shanghai'
}
@@ -39,3 +39,9 @@ public class DistributorPageParam extends PageQuery {
private Integer thirdPartyType;
+ /** 好友绑定状态(合作方):1=已绑定,2=未绑定;不传不过滤。 */
+ private Integer friendBinding;
14. refactor(sync): 优化八爪鱼数据同步流程并移除导入稳定检测 ♻️ 重构
- 提交:
d0f796d4d309(2026-11-04) - 模块: 数据同步
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/query/DynamicQueryRetirementTest.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/build.gradle、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/cron/jobs/house/BazhuayuHouseSync.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/AlliedBZYService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/BazhuayuImportStability.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/BazhuayuLeaseMapping.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/BazhuayuRoomRentSyncService.java等 15 个文件 - 改动量: +333 行 / -271 行
- 功能说明: 八爪鱼房源同步由各供应商服务返回逐房型处理报告,调度任务汇总本轮更新、无变化及忽略数量,并向业务方发送同步汇总邮件及完整附件。同步流程对失败或异常报价采取跳过策略、不再自动重试,确保其他正常报价继续处理,同时邮件发送失败不会回滚已同步数据或重复处理整批。相关测试任务与注释也同步调整,移除了直连导入保护/稳定检测相关测试配置,并明确导出接口由独立契约测试覆盖。
@@ -270,5 +270,4 @@ tasks.register('testIncrementalNull', Test) {
includeTestsMatching 'com.hoolihome.erp.service.CommissionArrivalLedgerServiceTest'
includeTestsMatching 'com.hoolihome.erp.service.CommissionBillReceiverServiceTest'
- includeTestsMatching 'com.hoolihome.erp.service.CommissionPaymentReceiverServiceTest'
includeTestsMatching 'com.hoolihome.erp.service.LandlordContactTest'
includeTestsMatching 'com.hoolihome.erp.service.HouseImageFallbackTest'
@@ -13,5 +13,5 @@ import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.
import org.springframework.http.HttpMethod;
-/** 使用实际 Controller 注册 Spring MVC 路由,确认旧接口已经不可达。 */
+/** 使用实际 Controller 确认已退役路由不可达;复用旧路径的新异步导出由导出契约测试验证。 */
class DynamicQueryRetirementTest {
static MockMvc mvc;
@@ -62,5 +62,4 @@ class DynamicQueryRetirementTest {
"POST,/withdrawal-request/list/v2",
15. feat(notification): 集成管理模块消息通知功能 ⭐ 新增
- 提交:
20f7c9f9ba61(2026-11-05) - 模块: 消息通知
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/query/OrderPageQueryService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/management/GraphicRequestNotificationService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/management/GraphicRequestService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/query/OrdinaryPageQueryTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/management/ManagementIntegrationTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/management/ManagementNotificationTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/management/ManagementNotificationTransactionTest.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/controller/client/ClientFeedbackController.java等 13 个文件 - 改动量: +396 行 / -9 行
- 功能说明: 新增设计需求消息通知:创建需求时发送新建通知,状态发生非“待处理”变更时通知相关人员;历史记录从保留的提交人、观察者身份解析接收人,避免按姓名猜测或重复重放通知。同时优化订单搜索,纯数字关键词除匹配订单 ID 外,也可匹配订单编号中的数字部分,提升管理端检索兼容性。
@@ -114,5 +114,6 @@ public class OrderPageQueryService {
if (StrUtil.isNotBlank(p.getKeyword())) {
String keyword = p.getKeyword().trim();
- if (keyword.matches("[0-9]+")) q.eq(OrderInfo.ID, keyword);
+ // 数字既可能是订单ID,也可能是带字母前缀的订单编号中的数字部分。
+ if (keyword.matches("[0-9]+")) q.and(w -> w.eq(OrderInfo.ID, keyword).or().like(OrderInfo.ORDER_CODE, keyword));
else q.and(w -> w.like(OrderInfo.ORDER_CODE, keyword).or().like(OrderInfo.USER_NAME, keyword)
.or().like(OrderInfo.HOUSE_NAME, keyword).or().like(OrderInfo.EMAIL, keyword)
--- /dev/null
@@ -0,0 +1,50 @@
+package com.hoolihome.erp.management;
+
+import com.alibaba.fastjson.JSON;
+import com.hoolihome.common.management.ManagementDocumentRepository;
16. feat(recruitment): 新增招聘模块并整合权限与统一日志支持 ⭐ 新增
- 提交:
353942a7b79d(2026-11-05) - 模块: 招聘模块
- 涉及文件:
docs/personnel/recruitment-release.md、docs/personnel/recruitment-schema.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/LogAccessService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/personnel/recruitment/ApplicationLogProvider.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/personnel/recruitment/CandidateLogProvider.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/personnel/recruitment/InterviewLogProvider.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/personnel/recruitment/OfferLogProvider.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/personnel/recruitment/OnboardingLogProvider.java等 22 个文件 - 改动量: +1443 行 / -2 行
- 功能说明: 本次提交新增招聘模块及六张业务表的数据结构,覆盖岗位、候选人、应聘流程、面试、录用与入职等招聘环节,并通过唯一请求标识、业务版本及关联约束支持幂等创建和流程状态管理。招聘接口统一通过
/rest/crm/personnel/recruitment暴露,复用现有后台角色权限、员工档案新增权限、私有人事上传目录及统一对象日志能力,避免为招聘场景另建授权和日志体系。同时补充发布说明,明确共享枚举依赖需要重新构建发布,数据库脚本需人工核验授权后执行,且不会迁移历史候选人或自动建表。
--- /dev/null
@@ -0,0 +1,11 @@
+# 招聘 API 发布依赖
+
+本次 API 位于 `personnel/recruitment`,通过网关以 `/rest/crm/personnel/recruitment` 访问。接口合同统一维护在 Apifox,人事管理目录下共 25 个入口。候选人仅实现正常新增与流程,不迁移历史或浏览器演示数据。
+
+- 新建六表脚本:`recruitment-schema.sql`。应用不会自动建表,执行必须另行核验目标并取得授权。
+- 共享库 `hoolihome-common-pom/hoolihome-utils` 的 `ObjectDataTypeEnum` 增加 71–76 六类招聘对象;CRM 构建须使用包含该改动的共享依赖。当前未发布共享库。只在本地验证时可用 `--include-build /path/to/hoolihome-
+- 权限复用启用的后台角色。`personnel:recruitment:position`、`candidate`、`interview`、`offer` 各自有 `:read`、`:add`、`:update`。应聘关联操作归 candidate,入职子流程归 offer;实际建档还需员工档案新增权限。超级管理员
+- 人事上传凭证沿用原入口和本人私有上传目录;已获候选人读取及新增/编辑权限者可以申请人事上传。user-api 也应使用包含该 `PersonnelAccessService` 改动的共享模块重新构建,才能让仅获招聘权限的账号上传简历。
+- 统一对象日志仍使用既有日志接口,并按对应招聘模块读取权限校验;不提供独立招聘日志 API。
+
+本地验证使用实际项目 JSON 转换器、Spring 事务、统一日志和内存 SQL;没有执行远端 DDL、写业务数据库或部署服务。候选人/岗位建档及多轮面试、录用接受、实际入职为后端事务;页面布局、按钮、枚举文案及前端本地存储切换由现有调用方处理。
--- /dev/null
17. refactor(log): 优化通用日志记录执行器实现 ♻️ 重构
- 提交:
36b65c2cd1db(2026-11-05) - 模块: 日志与审计
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/AuditObject.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/ObjectAuditAspect.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/ObjectAuditFields.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/ObjectAuditService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/ObjectAuditType.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/management/ManagementDocumentRepository.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/LogController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/NewMediaAccountController.java等 84 个文件 - 改动量: +2317 行 / -1232 行
- 功能说明: 本次提交删除了通用审计注解
AuditObject及其切面ObjectAuditAspect,移除通过 AOP 统一执行业务快照、事务控制和对象日志写入的机制。原有逻辑会在业务异常、失败响应或日志写入异常时回滚,并处理账号、媒体账号及父级对象等关联日志;相关能力现已从代码中下线。此重构可降低审计框架与业务入口的耦合,减少后续维护和执行链路复杂度。
+++ /dev/null
@@ -1,10 +0,0 @@
-package com.hoolihome.common.audit;
-import java.lang.annotation.*;
-/** 仅标记业务写入口;快照、业务写入及日志在同一事务内完成。 */
-@Target(ElementType.METHOD)
-@Retention(RetentionPolicy.RUNTIME)
-public @interface AuditObject {
- ObjectAuditType value();
- /** 1新增、2编辑、3删除。 */
- int action();
-}
+++ /dev/null
@@ -1,113 +0,0 @@
18. fix(log): 兼容lastUpdate接口token参数传递位置并完善权限验证 🐛 修复
- 提交:
665d9dee0b76(2026-11-05) - 模块: 日志与审计
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/LogController.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/audit/ObjectAuditIntegrationTest.java - 改动量: +18 行 / -3 行
- 功能说明:
lastUpdate接口新增兼容 URL 查询参数中的token,当请求体未携带令牌时自动使用查询参数值,确保网关注入身份信息与公共查询参数两种传递方式均可正常鉴权。接口统一使用解析出的会话令牌调用requireRead校验数据读取权限,并在令牌无效时返回相应错误信息。同步补充集成测试,覆盖查询参数令牌成功鉴权及无效令牌拒绝访问场景,同时更新原有测试调用以适配新方法签名。
@@ -81,6 +81,9 @@ public class LogController {
@RequestMapping("lastUpdate")
@Validated
- public ResVo lastUpdate(@RequestBody @Validated LogLastUpdateParam param) {
- try {logAccess.requireRead(param.getDataType(),param.getDataId(),param.getPlatformUserId(),param.getToken());}
+ public ResVo lastUpdate(@RequestBody @Validated LogLastUpdateParam param,
+ @RequestParam(required = false) String token) {
+ // 网关会把身份注入JSON,但公共查询参数中的token仍在URL上,须兼容两种传递位置。
+ String sessionToken = StrUtil.isNotBlank(param.getToken()) ? param.getToken() : token;
+ try {logAccess.requireRead(param.getDataType(),param.getDataId(),param.getPlatformUserId(),sessionToken);}
catch(ManagementException e){return ResVo.resErr(e.getMessage());}
String dataId = param.getDataId();
@@ -93,5 +93,5 @@ class ObjectAuditIntegrationTest {
String match=http.perform(post("/log/list").param("dataType","2002").param("dataId","uuid").param("fieldName","合同状态")).andReturn().getResponse().getCon
19. refactor(audit): 移除日志录制并引入审计注解及访问控制 ♻️ 重构
- 提交:
77ef4a40dafb(2026-11-05) - 模块: 日志与审计
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/AuditObject.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/ObjectAuditAccessService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/ObjectAuditAspect.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/ObjectAuditFields.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/ObjectAuditService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/ObjectAuditType.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/LogController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/NewMediaAccountController.java等 36 个文件 - 改动量: +749 行 / -53 行
- 功能说明: 新增运行时
@AuditObject注解,用于标识业务写入口及新增、编辑、删除操作,并由审计切面在事务内生成对象快照、执行写操作并处理失败回滚,避免业务异常、返回false或无变化操作产生不正确的审计记录。新增审计对象访问控制服务,对员工档案、平面需求、顾问评审、业务合作等类型校验对应模块权限,并为账号记录额外校验操作人是否属于主操作人或辅助人员范围。通过权限认证和对象范围检查,防止人员私密历史或账号信息从通用审计入口越权读取。
--- /dev/null
@@ -0,0 +1,10 @@
+package com.hoolihome.common.audit;
+import java.lang.annotation.*;
+/** 仅标记业务写入口;快照、业务写入及日志在同一事务内完成。 */
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface AuditObject {
+ ObjectAuditType value();
+ /** 1新增、2编辑、3删除。 */
+ int action();
+}
--- /dev/null
@@ -0,0 +1,48 @@
20. fix(crm): 兼容旧页面日志编号,合并补充日志类型查询 🐛 修复
- 提交:
a988049302e7(2026-11-05) - 模块: CRM/销售
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/audit/ObjectAuditType.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/LogController.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/audit/ObjectAuditTypeCompatibilityTest.java - 改动量: +133 行 / -8 行
- 功能说明: 为兼容旧版 CRM 页面已使用的日志业务编号,扩展
ObjectAuditType,为员工档案、顾问评价、商务合作和平面需求增加 54–57 的别名,同时保留原有 2001–2007 编号。查询对象日志时,会按同一对象的全部兼容编号合并读取历史记录,避免旧编号数据因精确匹配而遗漏;新增日志仍沿用现有编号,不迁移历史数据。补充兼容性测试,覆盖旧编号与补充编号的查询行为,降低页面升级后日志丢失的风险。
@@ -4,11 +4,11 @@ import com.hoolihome.common.constants.ObjectDataTypeEnum;
import java.util.*;
-/** CRM补充日志类型;2001-2017为本模块保留编号,不改变公共依赖中的既有编号。 */
+/** CRM补充日志类型;兼容已发布页面的54-57业务编号,保留2001-2017补充编号。 */
public enum ObjectAuditType {
- EMPLOYEE(2001,"员工档案","crm_employee_record",null,true),
+ EMPLOYEE(2001,"员工档案","crm_employee_record",null,true,56),
CONTRACT(2002,"劳动合同","personnel_labor_contract","personnel_labor_contract",true),
- GRAPHIC(2003,"平面需求","erp_graphic_request","erp_graphic_request",true),
- REVIEW(2004,"顾问评价","order_comment","order_comment",false),
- COOPERATION(2005,"商务合作","house_corporation_apply","house_corporation_apply",false),
+ GRAPHIC(2003,"平面需求","erp_graphic_request","erp_graphic_request",true,57),
+ REVIEW(2004,"顾问评价","order_comment","order_comment",false,55),
+ COOPERATION(2005,"商务合作","house_corporation_apply","house_corporation_apply",false,54),
21. fix(crm): 按公寓关联关系查询订单佣金规则 🐛 修复
- 提交:
b7ee26d2b23e(2026-11-05) - 模块: CRM/销售
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/dict/DataDictService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/dict/CommissionSelectorTest.java - 改动量: +199 行 / -6 行
- 功能说明: 将公寓佣金规则的查询从直接匹配
house_commission.house_id改为通过house_commission_rel_house关联表判断,确保同一规则能够被多个公寓复用,并避免旧的house_id字段造成误匹配。公寓 ID 为 0 时仅返回未关联任何公寓的通用兜底规则,同时继续按城市、供应商和有效状态过滤,并按创建时间及规则 ID 倒序保证选择结果稳定。补充了基于 H2 和 MyBatis 的查询及控制器测试,覆盖关联规则、通用规则、失效规则和其他城市/供应商规则等场景。
@@ -135,10 +135,21 @@ public class DataDictService {
return List.of();
}
- var qw = new QueryWrapper<HouseCommission>().lambda();
- qw.eq(houseId != null, HouseCommission::getHouseId, houseId);
- qw.eq(cityId != null, HouseCommission::getCityId, cityId);
- qw.eq(HouseCommission::getLandlordId, landlordId);
- qw.eq(HouseCommission::getStatus, 1);
- qw.orderByDesc(HouseCommission::getCreateTime);
+ var qw = new QueryWrapper<HouseCommission>();
+ if (houseId != null) {
+ if (NumHelper.Int.checkNotZero(houseId)) {
+ // 公寓关联以关系表为准,一条规则可以适用于多个公寓。
+ qw.apply("exists (select 1 from house_commission_rel_house rel "
22. feat(house-building): 新增公寓批量新增楼层图功能 ⭐ 新增
- 提交:
bcb8f83016c7(2026-11-05) - 模块: 房源/房型
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/log/dto/NewMediaMobileLog.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseBuildingController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/log/BillReceiverLog.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/log/BusinessCooperationLog.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/log/PaymentReceiverLog.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/BatchAddFloorParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseBuildingService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/personnel/log/EmployeeRecordLog.java等 16 个文件 - 改动量: +387 行 / -40 行
- 功能说明: 新增同一公寓楼层图的 JSON 批量新增接口
floor/batch-add,通过BatchAddFloorParam接收批量数据并交由HouseBuildingService处理,按提交顺序追加楼层图,任一项失败时整批回滚,避免出现部分成功的数据不一致。接口统一返回“添加成功”结果,满足公寓楼层图批量维护需求。
同时调整操作日志字段策略,移除手机号、电话、银行账号的尾四位脱敏及地址的变更记录限制,使这些字段在日志中按完整值持续记录,便于业务追踪与核查。
@@ -7,5 +7,5 @@ import lombok.Data;
@Data
public class NewMediaMobileLog {
- @LogFieldMate(fieldName = "手机号", zeroAsNull = false, mask = LogFieldMask.LAST_FOUR)
+ @LogFieldMate(fieldName = "手机号", zeroAsNull = false)
private String mobile;
@@ -4,4 +4,5 @@ import com.hoolihome.common.vo.ListVo;
import com.hoolihome.common.web.vo.ResVo;
import com.hoolihome.erp.params.AddFloorParam;
+import com.hoolihome.erp.params.BatchAddFloorParam;
import com.hoolihome.erp.params.RelationDeleteParam;
import com.hoolihome.erp.params.RelationUpdateParam;
@@ -10,4 +11,6 @@ import com.hoolihome.erp.params.UpdateFloorImageParam;
import com.hoolihome.erp.service.HouseBuildingService;
23. refactor(invoice): 优化发票税务字段计算与状态操作锁机制 ♻️ 重构
- 提交:
40ee9037cc75(2026-11-06) - 模块: 发票与财务
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/InvoiceAddParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/InvoiceUpdateParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/CommissionInvoiceService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/InvoiceDisputeTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/InvoiceTaxTotalsTest.java - 改动量: +258 行 / -38 行
- 功能说明: 发票税务字段改为由后端统一计算:新增和编辑时仅接收税名、税率,税费及税后总额不再信任前端传值,并根据有效明细重新计算,税率未配置按无税处理且 0 税率有效。税费金额不再由前端传入并四舍五入写入,改为后端计算,避免前后端计算口径不一致导致金额失真。编辑、移除订单、追加订单等状态操作改用带更新锁的
requireInvoiceForUpdate获取发票,降低并发操作引发数据覆盖或状态异常的风险。
@@ -61,15 +61,15 @@ public class InvoiceAddParam extends CommonReqDTO {
/**
- * 税率(由前端维护,选填)
+ * 税率百分数(选填;未配置按无税计算,0 有效)
*/
private BigDecimal taxRate;
/**
- * 税费(由前端维护,选填)
+ * 税费(兼容旧请求,传入值忽略,由后端计算)
*/
private BigDecimal taxAmount;
/**
- * 税后总额(由前端维护,选填)
+ * 税后总额(兼容旧请求,传入值忽略,由后端计算)
24. refactor(review): 区分创建时间和评价时间,调整评价记录的时间字段处理 ♻️ 重构
- 提交:
6e798e230795(2026-11-06) - 模块: 顾问评价
- 涉及文件:
docs/management/schema.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/CrmLeadsParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/management/AdvisorReviewService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/leads/LeadsUpdateNewMediaTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/management/ManagementIntegrationTest.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/service/mdy/executor/impl/MdyOrderCommentExecutor.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/CommentService.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/controller/open/OrderCommentFlowTest.java等 10 个文件 - 改动量: +134 行 / -6 行
- 功能说明: 为评价记录新增独立的
create_time字段,并通过“先允许为空、再设置默认当前时间”的迁移方式避免给历史记录伪造创建时间;后台新增评价时写入该字段,查询展示时也将其与客户端评价时间create_timestamp分开处理。CRM 线索更新参数不再默认忽略新媒体账号和平台字段,明确支持二者独立更新,并在传入0时清除关联,同时补充相关更新测试。
@@ -22,4 +22,8 @@ ALTER TABLE order_comment
-- IMPORT表示纳入本次管理能力的历史存量,不据此伪造历史提交人/创建时间。
+-- 创建时间独立于旧create_timestamp(客户端评价时间);先新增为空,再设置新记录默认值,避免给历史记录补造当前时间。
+ALTER TABLE order_comment ADD COLUMN create_time DATETIME(3) NULL;
+ALTER TABLE order_comment MODIFY COLUMN create_time DATETIME(3) NULL DEFAULT CURRENT_TIMESTAMP(3);
+
CREATE TABLE IF NOT EXISTS erp_graphic_request (
id VARCHAR(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
@@ -18,5 +18,5 @@ public class CrmLeadsParam extends CommonReqDTO {
public static String[] updateIgnoreProperties = {"userId", "liveTime", "endRentTime", "rentTimeUnit", "moneyUnit",
- "sourceUserCompany","sourceUserId","newMediaId","newMediaPlatform", "groupLeadsId", "externalUserId", "qywxGroupId"};
+ "sourceUserCompany","sourceUserId", "groupLeadsId", "externalUserId", "qywxGroupId"};
@NotNull(groups = {update.class}, message = "id不能为空")
@@ -108,6 +108,8 @@ public class CrmLeadsParam extends CommonReqDTO {
25. fix(personnel): 修正员工统计中在职员工计数逻辑 🐛 修复
- 提交:
87016e77b325(2026-11-06) - 模块: 员工人事
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/personnel/recruitment/RecruitmentRepository.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/personnel/service/EmployeeRecordService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/personnel/recruitment/RecruitmentTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/personnel/service/EmployeeRecordTest.java - 改动量: +66 行 / -2 行
- 功能说明: 修正员工记录统计逻辑,将
allCount改为仅统计状态为“在职”的员工,避免把试用期、离职等记录计入在职人数。针对 Connector/J 返回LocalDate/LocalDateTime与 H2Date/Timestamp类型不一致的问题,统一转换日期时间格式后再进行业务校验和响应,避免合法时间被误判为非法入参。补充相关测试,验证 JDBC 4.2 日期时间类型在面试信息读取及反馈流程中的兼容性。
@@ -8,4 +8,6 @@ import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Repository;
import java.sql.*;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
import java.util.*;
import static com.hoolihome.personnel.recruitment.RecruitmentResource.*;
@@ -32,4 +34,8 @@ public class RecruitmentRepository {
if(v instanceof java.sql.Date)v=((java.sql.Date)v).toLocalDate().toString();
if(v instanceof Timestamp)v=((Timestamp)v).toLocalDateTime().format(RecruitmentRules.TIME);
+ // Connector/J的DATETIME默认返回LocalDateTime,与H2的Timestamp不同。
+ // 在进入业务校验和响应前统一格式,避免把合法数据库时间判为非法入参。
+ if(v instanceof LocalDate)v=v.toString();
+ if(v instanceof LocalDateTime)v=((LocalDateTime)v).format(RecruitmentRules.TIME);
26. fix(advisor-review): 兼容处理 MySQL DATETIME 与 Timestamp 类型日期时间 🐛 修复
- 提交:
a6d150e452ac(2026-11-06) - 模块: 顾问评价
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/management/AdvisorReviewService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/management/ManagementIntegrationTest.java - 改动量: +34 行 / -2 行
- 功能说明: 兼容 MySQL
DATETIME返回LocalDateTime与其他 JDBC 驱动返回Timestamp两种日期时间类型,统一按本地时间格式化且不做时区转换,避免评价时间和创建时间出现类型兼容问题或时间偏移。评价时间优先取review_time,为空时回退到按上海时区转换的create_timestamp,创建时间则直接格式化create_time。同时补充集成测试,验证 MySQL 日期时间对象在详情和列表接口中的返回结果符合预期。
@@ -89,7 +89,7 @@ public class AdvisorReviewService {
d.put("rating",r.get("service_score"));d.put("status",flag(r.get("state"))?"上架":"下架");d.put("content",r.get("service_comment"));d.put("anonymous",flag(
Integer check=number(r.get("content_check_status"));String audit=null;if(Integer.valueOf(ScCheckStatus.CHECK_STATUS_PASS).equals(check))audit="正常";else
- Object t=r.get("review_time");d.put("reviewTime",t instanceof java.sql.Timestamp?((java.sql.Timestamp)t).toLocalDateTime().format(ManagementValues.TIME
+ String reviewTime=formatDateTime(r.get("review_time"));d.put("reviewTime",reviewTime!=null?reviewTime:formatTimestamp(r.get("create_timestamp")));
String source=Objects.toString(r.get("source"),"IMPORT");d.put("source",source);d.put("createUser",relations.employee(number(r.get("create_user_id"))))
- Object created=r.get("create_time");d.put("createTime",created instanceof java.sql.Timestamp?((java.sql.Timestamp)created).toLocalDateTime().format(Man
+ d.put("createTime",formatDateTime(r.get("create_time")));d.put("recordVersion",r.get("record_version"));
if(detail) {
d.put("tags",jdbc.queryForList("SELECT cl.label_text FROM comment_rel_label crl JOIN comment_label cl ON cl.id=crl.label_id WHERE crl.comment_id=?
@@ -108,4 +108,10 @@ public class AdvisorReviewService {
private static Integer number(Object n){return n instanceof Number?((Number)n).intValue():null;}
private static boolean flag(Object n){return n instanceof Boolean?(Boolean)n:n instanceof Number&&((Number)n).intValue()==1;}
+ /** MySQL DATETIME返回LocalDateTime;其他JDBC驱动也可能返回Timestamp。两者都不做时区转换。 */
📊 本周工作总结
【核心成果】第45周完成房源同步、CRM销售、订单中心、发票财务、员工人事及招聘模块的重点建设:八爪鱼同步支持按供应商汇总处理报告,iQ支持多学年房型合并;订单新增取消时间筛选,合作方支持好友与企微群绑定过滤;到账流水支持全选、导出及下载通知;员工双头像、招聘全流程、业务合作时间展示、楼层图批量新增、设计需求通知和顾问评价时间体系同步落地。
【技术亮点】同步链路采用局部合并、异常隔离及汇总报告,避免不完整数据误撤下租期;发票税费改为后端统一计算,并通过更新锁降低并发覆盖风险。楼层图批量写入启用事务回滚,全选查询限制千条,OSS强化私有权限与源站校验;审计机制增加对象范围和模块权限控制,并兼容新旧日志编号。关键流程均补充回归及集成测试。
【业务价值】统一了跨学年与多供应商数据口径,降低同步异常对在租房源的影响;提升销售筛选、佣金规则匹配、到账导出及招聘管理效率。双头像、消息跳转和检索增强改善业务操作体验,后端计税、审计及权限控制则强化财务准确性、数据一致性与安全合规。
报告生成时间:2026-11-06 18:04