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 与 H2 Date/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