monthly-2026-10

月报 · 2026年十月

姓名: 邓星星(dengxingxing) 项目: hoolihome-project 分支: production 提交数: 161个(含140个功能提交)


📋 本月工作汇总

按周统计

周次 日期范围 提交数
第40周 09/28-10/04 10
第41周 10/05-10/11 22
第42周 10/12-10/18 29
第43周 10/19-10/25 62
第44周 10/26-11/01 38

按模块统计

模块 提交数
房源/房型 43
CRM/销售 25
其他 21
财务/钱包 19
新媒体线索 14
视频处理 11
系统管理 7
搜索/筛选 4
订单/评价 4
企业微信 3
系统同步 3
房东管理 3
合作方 2
数据导出 2

🛠 详细工作内容

1. fix(invoice): 兼容到账流水录入人及修改人为空 🐛 修复

  • 模块: 其他
  • 提交: 1856904fff73(2026-10-30)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/vo/ArrivalLedgerVoBuilder.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/CommissionArrivalLedgerVoBuilderTest.java
  • 改动量: +96行 / -2行
  • 功能说明: 到账流水录入时,兼容录入人和修改人为空的情况,避免历史或异常数据影响账单处理。
+        includeTestsMatching 'com.hoolihome.erp.service.CommissionArrivalLedgerVoBuilderTest'

2. feat(distributor): 新增企业/合作方业务量统计及相关批量查询支持 ⭐ 新增

  • 模块: 合作方
  • 提交: 2c2bfaaf6859(2026-10-30)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/DistributorBusinessStatisticsController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/DistributorBusinessStatisticsParam.java、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/DistributorBusinessStatisticsService.java、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/crm/vo/DistributorBusinessStatisticsVo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/query/OrdinaryPageQueryTest.java…等10个文件
  • 改动量: +393行 / -5行
  • 功能说明: 新增企业及合作方的业务量统计能力,并支持相关数据批量查询。
+
+tasks.register('testDistributorBusinessStatistics', Test) {
+    enabled = true
+    useJUnitPlatform()
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+    filter { includeTestsMatching 'com.hoolihome.crm.service.distributor.DistributorBusinessStatisticsTest' }
+    systemProperty 'user.timezone', 'Asia/Shanghai'
+}

3. feat(api-lease): 优化租期规则映射与同步逻辑 ⭐ 新增

  • 模块: 系统同步
  • 提交: 8ba12e675c70(2026-10-29)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/application/ApplicationFormService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/query/ApplicationFormPageQueryService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/query/OrdinaryPageQueryTest.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiLeaseDiff.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiLeaseMapping.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiLeaseSyncResult.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/IQSyncService.java…等18个文件
  • 改动量: +516行 / -100行
  • 功能说明: 优化租期规则的映射与同步逻辑,并统一申请单按创建时间和编号倒序展示。
-            qw.orderByDesc(ApplicationForm.ID);
+            qw.orderByDesc(ApplicationForm.CREATE_TIME, ApplicationForm.ID);

4. feat(commission): 优化到账账单关键字搜索及佣金标题清理逻辑 ⭐ 新增

  • 模块: 财务/钱包
  • 提交: 320e0ffbc4c3(2026-10-29)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、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/params/ArrivalLedgerParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/ArrivalLedgerStatisticsParam.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/service/CommissionArrivalLedgerKeywordTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/CommissionArrivalLedgerServiceTest.java、tools/commission_title_cleanup.py…等9个文件
  • 改动量: +250行 / -14行
  • 功能说明: 优化到账账单的关键字搜索,同时完善佣金标题的清理规则。
+        includeTestsMatching 'com.hoolihome.erp.service.CommissionArrivalLedgerKeywordTest'

5. feat(order): 集成企业微信群组信息并更新订单响应结构 ⭐ 新增

  • 模块: 企业微信
  • 提交: a1abffc6f0ba(2026-10-29)
  • 涉及文件: 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/service/order/OrderService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/OrderCommentResponseTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/OrderQywxGroupResponseTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/order/OrderListQywxGroupTest.java
  • 改动量: +246行 / -8行
  • 功能说明: 订单信息接入企业微信群组资料,并同步调整订单接口的返回内容。
+import com.hoolihome.crm.service.group.QywxGroupsService;

6. fix(house-commission): 修正仅返回状态为1的关联佣金并按ID降序排序 🐛 修复

  • 模块: 房源/房型
  • 提交: b997b16ce9ee(2026-10-29)
  • 涉及文件: docs/dev_v2_filter/sql/invoice_room_number_255.sql、"docs/dev_v2_filter/sql/invoice\345\273\272\350\241\250.sql"、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseDetailCommissionPolicyTest.java
  • 改动量: +57行 / -5行
  • 功能说明: 修正关联佣金查询,仅返回状态为 1 的有效记录,并按记录 ID 从新到旧排序,方便用户优先查看最新佣金。
    同时将发票订单快照中的房间号容量扩展到 64 个字符,保留原有数据,避免较长房间号被截断。
+-- Invoice 订单快照房间号扩长:保留原字符集、排序规则、可空性、默认值和注释。
+-- 适用前提:核对生产库身份,当前列为下述定义的 varchar(64),且已备份原数据。
+-- 仅扩长,不更新、不截断任何 room_number;执行器须遇错即停,禁止自动降级锁策略。
+SELECT DATABASE() AS target_database, @@server_uuid AS server_uuid;
+
+SELECT COLUMN_TYPE, IS_NULLABLE, COLUMN_DEFAULT, CHARACTER_SET_NAME,
+       COLLATION_NAME, COLUMN_COMMENT
+FROM information_schema.COLUMNS
+WHERE TABLE_SCHEMA = DATABASE()
+  AND TABLE_NAME = 'commission_invoice_order_rel'
+  AND COLUMN_NAME = 'room_number';
+
+ALTER TABLE urcommon.commission_invoice_order_rel
+  MODIFY COLUMN room_number VARCHAR(255)
+    CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci

7. refactor(arrival-ledger): 放宽到账流水业务字段校验与更新逻辑 ♻️ 重构

  • 模块: 其他
  • 提交: 6695e2d293b2(2026-10-29)
  • 涉及文件: "docs/dev_v2_filter/sql/20261029_\345\210\260\350\264\246\346\265\201\346\260\264\344\270\232\345\212\241\345\255\227\346\256\265\345\205\201\350\256\270\344\270\272\347\251\272.sql"、"docs/dev_v2_filter/sql/invoice\345\273\272\350\241\250.sql"、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/mdy/MdySyncService.java、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/params/ArrivalLedgerParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/ArrivalLedgerUpdateParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/CommissionArrivalLedgerService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/CommissionInvoiceService.java…等17个文件
  • 改动量: +346行 / -254行
  • 功能说明: 调整到账流水的登记与更新规则,收款人、到账日期、金额单位、到账金额、付款方名称和银行流水号等业务信息可不填,不再因字段缺失被拒绝。现有流水的编号、状态及历史数据保持不变,数据库字段放宽需在授权后先行执行迁移。
+-- 仅准备,尚未在测试/生产执行。发布放宽字段校验的代码前须先经授权执行本迁移。
+-- 保留流水编号、主键、状态约束;仅放宽6个业务字段,不改历史数据。
+-- 执行前核对 DATABASE()/@@server_uuid 及 SHOW CREATE TABLE commission_arrival_ledger;
+-- 如果列类型、默认值或索引与预期不一致则停止。DDL会隐式提交,不能按事务回滚处理。
+-- 预期:payment_receiver_id INT、arrival_date DATE、money_unit INT、arrival_amount DECIMAL(18,2)、
+-- payer_name VARCHAR(200)、bank_reference VARCHAR(200),当前均为 NOT NULL、无默认值。
+-- 执行后用新连接核对上述6列 IS_NULLABLE=YES、COLUMN_DEFAULT=NULL,索引保持原样。
+SET SESSION lock_wait_timeout = 5;
+ALTER TABLE `commission_arrival_ledger`
+    MODIFY COLUMN `payment_receiver_id` int DEFAULT NULL COMMENT '收款账户ID,关联commission_payment_receiver',
+    MODIFY COLUMN `arrival_date` date DEFAULT NULL COMMENT '实际到账日期',
+    MODIFY COLUMN `money_unit` int DEFAULT NULL COMMENT '币种 code,参考订单币种(CurrencyType),录入到账流水时由接口传入',
+    MODIFY COLUMN `arrival_amount` decimal(18,2) DEFAULT NULL COMMENT '实际到账金额,可空,允许0及负数',
+    MODIFY COLUMN `payer_name` varchar(200) DEFAULT NULL COMMENT '付款方名称(保留银行原始名称)',
+    MODIFY COLUMN `bank_reference` varchar(200) DEFAULT NULL COMMENT '银行流水号(与系统流水编号不同)';

8. fix(service): 优化关键词查询时附件文件名匹配逻辑 🐛 修复

  • 模块: 其他
  • 提交: 278bf171fd59(2026-10-29)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseLiveShotMaterialService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/LiveShotPageQueryTest.java
  • 改动量: +19行 / -13行
  • 功能说明: 优化了实拍素材按关键词检索时对附件文件名的匹配逻辑。系统会先筛选出文件名命中的素材再处理查询结果,减少无效扫描并提升检索效率。
+    // DISTINCT 阻止派生表合并:先物化文件名命中的归属 ID,避免 OR 内的 IN 被改写为逐实拍扫描附件表。
+    private static final String MATCHED_ATTACHMENT_DATA_IDS =
+            "(SELECT matched.data_id FROM (SELECT DISTINCT file_ref.data_id "
+                    + "FROM home_oss_file_ref_data file_ref "
+                    + "JOIN home_oss_files attachment ON attachment.file_id = file_ref.file_id "
+                    + "WHERE file_ref.data_type = {1} AND file_ref.data_sub_type = {2} "
+                    + "AND file_ref.file_type IN (1, 2) AND attachment.file_name LIKE {0}) matched)";
+

9. feat(liveshot): 增加实拍素材关键词模糊搜索支持 ⭐ 新增

  • 模块: 房源/房型
  • 提交: cb85d6edc330(2026-10-29)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/LiveShotMaterialPageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseLiveShotMaterialService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/LiveShotPageQueryTest.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/controller/open/OrderCommentUploadTest.java、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/service/OrderCommentUploadStorage.java
  • 改动量: +110行 / -8行
  • 功能说明: 实拍素材新增关键词模糊搜索,可按标题、备注或关联的图片/视频附件文件名查找,任一匹配即可返回结果。未填写关键词或仅输入空白字符时,不进行筛选。
+    /** 模糊搜索实拍标题、备注或当前关联的图片/视频附件文件名,任一命中即可;未传、null 或空白时不筛选。 */
+    private String keyword;
+

10. feat(feeOrder): 支持交易流水号搜索和完善拆分筛选测试 ⭐ 新增

  • 模块: 搜索/筛选
  • 提交: 51934e5561e1(2026-10-28)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/FeeOrderController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/fee/FeeOrderPageQuery.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/FeeOrderSplitFilterTest.java
  • 改动量: +13行 / -5行
  • 功能说明: 费用订单查询现在支持按交易流水号搜索,用户输入的编号可以同时匹配费用编码或交易流水号,便于快速定位相关订单。同时完善了拆分筛选场景的测试,提升订单筛选结果的可靠性。
-                    }).or().like(HomeFeeOrder.FEE_CODE, query.getCode());
+                    }).or().like(HomeFeeOrder.FEE_CODE, query.getCode())
+                            .or().like(HomeFeeOrder.PAY_CODE, query.getCode());

11. feat(feeOrder): 新增拆分类型筛选功能 ⭐ 新增

  • 模块: 搜索/筛选
  • 提交: 4bcdfeed8bac(2026-10-28)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/FeeOrderController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/fee/FeeOrderPageQuery.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-home/src/main/java/com/hoolihome/entity/home/HomeFeeOrder.java
  • 改动量: +7行 / -0行
  • 功能说明: 费用订单列表新增“是否拆分”筛选条件,支持选择未拆分或已拆分的订单。传入的拆分状态只允许为0或1,其他值会提示参数不支持。
+        if (query.getSplitType() != null && query.getSplitType() != 0 && query.getSplitType() != 1)
+            return R.error("是否拆分仅支持0或1");

12. refactor(fee): 优化收款单业务逻辑移除旧有分配结构 ♻️ 重构

  • 模块: 其他
  • 提交: cf3215c3337f(2026-10-28)
  • 涉及文件: docs/dev_v2_xxskd/sql/qywx_receipt_allocation_backfill.sql、docs/dev_v2_xxskd/sql/qywx_receipt_split.sql、hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/FeeOrderController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/FeeOrderRefundController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/fee/FeeOrderCreateV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/fee/CrmFeeOrderService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/fee/FeeOrderRefundService.java…等34个文件
  • 改动量: +657行 / -858行
  • 功能说明: 优化收款单的分配逻辑,移除原有收款分配结构,改为直接按收费单处理金额与退款信息。同步提供历史收款数据回填方案,确保新旧逻辑切换后数据完整、金额统计一致。
-SELECT DATABASE() AS target_database;
-SELECT collection_method,COUNT(*) AS to_backfill,SUM(amount) AS amount_sum,SUM(COALESCE(refund_amount,0)) AS refund_sum
-FROM home_fee_order f WHERE f.form_id>0 AND NOT EXISTS(SELECT 1 FROM home_fee_order_allocation a WHERE a.fee_order_id=f
-GROUP BY collection_method;
-SELECT id,fee_code,form_id,amount,refund_amount,collection_method
-FROM home_fee_order f WHERE f.form_id>0 AND NOT EXISTS(SELECT 1 FROM home_fee_order_allocation a WHERE a.fee_order_id=f
-ORDER BY id LIMIT 20;
-SELECT COUNT(*) AS unassigned_count FROM home_fee_order WHERE form_id IS NULL OR form_id<=0;
-SELECT id,fee_code,form_id,amount,refund_amount FROM home_fee_order f
-WHERE f.form_id>0 AND NOT EXISTS(SELECT 1 FROM home_fee_order_allocation a WHERE a.fee_order_id=f.id)
- AND (amount IS NULL OR amount<=0 OR COALESCE(refund_amount,0)<0 OR COALESCE(refund_amount,0)>amount)
-ORDER BY id LIMIT 50;
-
-CREATE TABLE IF NOT EXISTS home_fee_allocation_backfill_backup (
- fee_order_id BIGINT NOT NULL PRIMARY KEY,

13. feat(invoice): 支持到账登记时主动传入实收合计金额 ⭐ 新增

  • 模块: 其他
  • 提交: e6fa22983f7a(2026-10-28)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/CommissionInvoiceController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/InvoiceMarkArrivalParam.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/CommissionInvoiceServiceMarkArrivalTest.java
  • 改动量: +120行 / -7行
  • 功能说明: 到账登记时支持主动填写发票实收合计金额,未填写时仍按正常订单明细自动汇总。传入金额后,将优先采用该金额作为本次到账金额。
-     * 入参:id / orderList[](必须包含 Invoice 全部正常订单)/ remark。
+     * 入参:id / orderList[](必须包含 Invoice 全部正常订单)/ arrivalLedgerIdList / remark;
+     * totalActualCommission 选填,非空时优先作为 Invoice 实收合计,未传或 null 时按正常明细合计。

14. feat(fee): 支持企微拆分分配及收款单申请关联回显 ⭐ 新增

  • 模块: CRM/销售
  • 提交: 94fa4ecfd47c(2026-10-28)
  • 涉及文件: docs/dev_v2_xxskd/sql/qywx_receipt_allocation_backfill.sql、docs/dev_v2_xxskd/sql/qywx_receipt_split.sql、hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/FeeOrderController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/FeeOrderRefundController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/fee/FeeOrderCreateV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/fee/CrmFeeOrderService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/fee/FeeOrderRefundService.java…等36个文件
  • 改动量: +1155行 / -492行
  • 功能说明: 新增企业微信收款单的拆分分配能力,并支持关联的收款单申请信息正常回显。历史收款数据按原有完整关联关系补齐,不推断历史拆分,也不改变原收款、退款及订单账面金额。
+-- 仅供审阅,未执行。结构脚本执行后、停写窗口内执行;新版本启用前必须完成本回填。
+-- 所有收款方式统一转入关联表:线上一条全额关联;历史线下同样一条全额关联,不推断历史拆分。
+-- 不改原收款金额、退款金额和订单账面;没有原申请ID的记录保持未关联。
+SELECT DATABASE() AS target_database;
+SELECT collection_method,COUNT(*) AS to_backfill,SUM(amount) AS amount_sum,SUM(COALESCE(refund_amount,0)) AS refund_sum
+FROM home_fee_order f WHERE f.form_id>0 AND NOT EXISTS(SELECT 1 FROM home_fee_order_allocation a WHERE a.fee_order_id=f
+GROUP BY collection_method;
+SELECT id,fee_code,form_id,amount,refund_amount,collection_method
+FROM home_fee_order f WHERE f.form_id>0 AND NOT EXISTS(SELECT 1 FROM home_fee_order_allocation a WHERE a.fee_order_id=f
+ORDER BY id LIMIT 20;
+SELECT COUNT(*) AS unassigned_count FROM home_fee_order WHERE form_id IS NULL OR form_id<=0;
+-- 异常必须先核对,程序会中止整个回填,不能自动跳过后启用新版本。
+SELECT id,fee_code,form_id,amount,refund_amount FROM home_fee_order f
+WHERE f.form_id>0 AND NOT EXISTS(SELECT 1 FROM home_fee_order_allocation a WHERE a.fee_order_id=f.id)
+ AND (amount IS NULL OR amount<=0 OR COALESCE(refund_amount,0)<0 OR COALESCE(refund_amount,0)>amount)

15. feat(commission-invoice): 优化可开票订单筛选及到账标记逻辑 ⭐ 新增

  • 模块: 搜索/筛选
  • 提交: 6785468d2bd6(2026-10-28)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/InvoiceCandidateSearchParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/InvoiceMarkArrivalItem.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/CommissionInvoiceServiceMarkArrivalTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/InvoiceCandidateQueryTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/InvoiceNotificationTest.java
  • 改动量: +291行 / -13行
  • 功能说明: 新增可开票订单的状态多选筛选:不选择状态时查询全部订单,选择后可按指定状态筛选,其中包含“待提交审核”状态。此次调整用于更灵活地定位符合开票条件的订单。
+    /** 订单状态多选;不传或空数组时不限制状态,包含 0=待提交审核。 */
+    private List<Integer> orderStatusList;
+

16. fix(query): 修正查询排序字段为id 🐛 修复

  • 模块: 搜索/筛选
  • 提交: 0ed01303e9b7(2026-10-28)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/query/ApplicationFormPageQueryService.java
  • 改动量: +1行 / -1行
  • 功能说明: 查询结果的默认排序字段由创建时间调整为 ID,确保列表按 ID 顺序稳定返回,避免因创建时间异常导致排序不准确。
-        sort(q, p, SORT_COLUMNS, "createTime");
+        sort(q, p, SORT_COLUMNS, "id");

17. feat(application-mail): 支持邮件模版类型区分与校验 ⭐ 新增

  • 模块: 其他
  • 提交: fefab980ed1c(2026-10-28)
  • 涉及文件: docs/dev_v2_filter/sql/application_mail_template_type.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/ApplicationMailController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/log/dto/ApplicationMailTemplateLog.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/log/dto/ApplicationMailTemplateLogBuilder.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/mail/ApplicationMailTemplatePage.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/application/ApplicationMailService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/application/MailTemplateType.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/application/MailTemplateTypeTest.java…等9个文件
  • 改动量: +216行 / -0行
  • 功能说明: 邮件模板现在可以区分“申请邮件模板”和“Invoice 邮件模板”,并对模板类型进行校验,避免不同业务类型的邮件混用。现有模板默认按申请邮件模板处理,不会根据标题自动推断为 Invoice 类型。
+-- 待执行:发布包含邮件模版类型的新 API 前,先核对目标库及现有字段。
+-- 历史 application_mail_template 记录兼容为申请邮件模版,不根据标题推断 Invoice 类型。
+-- 必须在字段不存在时执行一次;代码不自动运行本脚本。
+ALTER TABLE application_mail_template
+    ADD COLUMN `type` tinyint NOT NULL DEFAULT 1 COMMENT '1 申请邮件模版 2 invoice邮件模版' AFTER `state`;

18. feat(query): 支持订单查询批量中文及拼音姓名文本输入 ⭐ 新增

  • 模块: 搜索/筛选
  • 提交: 1f209eec429d(2026-10-27)
  • 涉及文件: 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
  • 改动量: +73行 / -4行
  • 功能说明: 订单查询新增批量姓名筛选,支持按每行一个完整姓名输入中文姓名或拼音姓名进行查询。系统会自动忽略空行、首尾空白和重复项,并保留拼音姓名内部的空格。
+    /** 批量中文姓名文本,每行一个完整姓名;忽略空行、首尾空白和重复项 */
+    private String batchCnName;
+
+    /** 批量拼音姓名文本,每行一个完整姓名;保留姓名内部空格 */
+    private String batchUserName;
+

19. refactor(api): 标记部分接口为废弃,提示使用新版本接口 ♻️ 重构

  • 模块: 其他
  • 提交: 27114ceaf12d(2026-10-27)
  • 涉及文件: 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/FeeOrderController.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/MediaLeadController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/RoomController.java
  • 改动量: +20行 / -5行
  • 功能说明: 将部分旧版接口标记为废弃并停用,提示调用方改用 list/v2 新接口,引导业务方完成接口升级,避免继续使用已不可用的功能。
+    /** @deprecated 后台已停用,请使用 list/v2。 */
+    @Deprecated

20. Merge branch 'hotfix/wallet-withdrawal-rules-20261026' into production 🐛 修复

  • 模块: 财务/钱包
  • 提交: 930fc86162f3(2026-10-26)
  • 涉及文件: hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/wallet/controller/WalletController.java
  • 改动量: +8行 / -4行
  • 功能说明: 修复钱包提现规则,调整相关提现校验逻辑,确保符合最新业务要求。

21. fix(wallet): 优化钱包提现规则描述 🐛 修复

  • 模块: 财务/钱包
  • 提交: 7a9cc7a2f9a6(2026-10-26)
  • 涉及文件: hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/wallet/controller/WalletController.java
  • 改动量: +8行 / -4行
  • 功能说明: 优化钱包提现规则说明,重新梳理返现与推荐奖励的发放时间、汇率折算及个税代扣等内容的表述,使规则更清晰易读。
-                                "1. 返现奖励与推荐奖励将在对应公寓向我司支付相关佣金后安排发放,一般情况下将于租客入住成功后180个工作日内完成。如遇公寓方结算延迟,发放时间可能会相应顺延,敬请谅解。\
-                                "2. 奖励金额将统一按固定汇率折算为人民币发放。汇率标准以我司最终核定时确认为准。\n" +
-                                "3. 根据国家税收相关法律法规,实际到账金额为代扣个人所得税后的净额。\n" +
-                                "4. 本规则最终解释权归HooliHome平台所有。");
+                                "1. 奖励发放时间:返现奖励与推荐奖励将在对应公寓向我司支付相关佣金后安排发放,一般情况下将于租客入住成功后 180 个工作日内完成。如遇公寓方结算延迟,发放时间可能会相应
+                                "2. 可提现额度:可提现额度以提现页面展示的各类奖励「可提现」金额为准;当可提现金额为 0 时无法发起提现;提现不设最低金额限制,单笔提现金额不得超过当前可提现额度。\n"
+                                "3. 提现时间:提现申请仅在每月 1 日至 10 日开放受理,其余时间不可发起。\n" +
+                                "4. 提现次数:同一时间仅可发起一笔提现,前一笔提现打款完成后才可再次发起。\n" +
+                                "5. 到账时间:提现申请审核通过后由财务统一打款,预计次月中到账;如遇法定节假日则相应顺延,具体到账时间以银行实际处理为准。\n" +
+                                "6. 币种与汇率:奖励金额将统一按固定汇率折算为人民币发放。汇率标准以我司最终核定时确认为准。\n" +
+                                "7. 个人所得税:根据国家税收相关法律法规,实际到账金额为代扣个人所得税后的净额。\n" +
+                                "8. 本规则最终解释权归 HooliHome 平台所有。");

22. feat(house-commission): 实现佣金规则批量修改及分页查询全部ID支持 ⭐ 新增

  • 模块: 房源/房型
  • 提交: 24e70eccce2d(2026-10-26)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseCommissionController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/HouseCommissionBatchUpdateParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/HouseCommissionPageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseCommissionService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseCommissionBatchTest.java
  • 改动量: +405行 / -35行
  • 功能说明: 支持批量修改房屋佣金规则,并完善分页查询能力,可一次获取全部佣金规则 ID。
+
+tasks.register('testHouseCommissionBatch', Test) {
+    enabled = true
+    useJUnitPlatform()
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+    filter { includeTestsMatching 'com.hoolihome.erp.service.HouseCommissionBatchTest' }
+    systemProperty 'user.timezone', 'Asia/Shanghai'
+}

23. refactor(compatibility): 兼容旧版App租期字段的支持与校验 ♻️ 重构

  • 模块: 其他
  • 提交: 1570ef47b0a6(2026-10-26)
  • 涉及文件: hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/controller/client/ClientRoomController.java、hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/vo/client/house/ClientRoomRentAttrVo.java、hoolihome-api-pom/hoollihome-house-api/src/test/java/com/hoolihome/house/controller/client/ClientLeaseDisplayTest.java、hoolihome-common-service-pom/hoolihome-house-service/src/main/java/com/hoolihome/house/vo/ClientRoomRentAttrVo.java、hoolihome-common-service-pom/hoolihome-house-service/src/test/java/com/hoolihome/house/util/ClientLeaseSupportTest.java
  • 改动量: +286行 / -9行
  • 功能说明: 兼容旧版 App 的租期展示与校验:系统继续返回租期方案、起租日期规则等历史字段,确保老版本客户端正常使用。新版客户端则直接使用展示文案和系统解析后的默认日期,避免自行解释租期规则。
-        // Only resolved application defaults leave the API; clients do not interpret lease rules.
+        // Resolved defaults are authoritative; deprecated rule fields below only support old clients.
+        /**
+         * 租期方案编码。
+         * @deprecated 已过期,仅兼容旧版App;新客户端直接使用展示文案和默认日期,旧版退役后删除。
+         */
+        @Deprecated
+        @JSONField(serialzeFeatures = SerializerFeature.WriteMapNullValue)
+        private final Integer leasePlanType;
+
+        /**
+         * 起租日期规则编码。
+         * @deprecated 已过期,仅兼容旧版App;新客户端直接使用展示文案和默认日期,旧版退役后删除。
+         */
+        @Deprecated

24. refactor(service): 移除HouseCommissionService中对房东服务的依赖并调整标题生成逻辑 ♻️ 重构

  • 模块: 房源/房型
  • 提交: 629f3f4a28dd(2026-10-26)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseCommissionService.java、tools/commission_title_cleanup.py、tools/test_commission_title_cleanup.py
  • 改动量: +388行 / -18行
  • 功能说明: 委托标题的生成不再依赖房东服务信息,相关标题生成规则得到同步调整和清理。
-import com.hoolihome.house.service.ILandlordInfoService;

25. feat(user): 统一补空关联申请资料并添加测试覆盖 ⭐ 新增

  • 模块: CRM/销售
  • 提交: c327538f16fe(2026-10-26)
  • 涉及文件: hoolihome-api-pom/hoolihome-user-api/build.gradle、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/mapper/crm/ApplicationFormProfileFillMapper.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/ApplicationFormProfileSyncService.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/UserApplyService.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/service/ApplicationFormProfileSyncTest.java
  • 改动量: +313行 / -0行
  • 功能说明: 统一为用户补全缺失的关联申请资料,避免因资料不完整影响申请流程。
    新增专项测试,验证资料同步与自动补全逻辑的正确性。
+tasks.register('testApplicationProfileSync', Test) {
+    enabled = true
+    useJUnitPlatform()
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+    filter { includeTestsMatching 'com.hoolihome.user.service.ApplicationFormProfileSyncTest' }
+    systemProperty 'user.timezone', 'Asia/Shanghai'
+}
+

26. fix(client-lease): 优化租期截止时间显示和计算逻辑 🐛 修复

  • 模块: 其他
  • 提交: 0149cfa763c7(2026-10-26)
  • 涉及文件: hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/vo/client/house/ClientRoomRentAttrVo.java、hoolihome-api-pom/hoollihome-house-api/src/test/java/com/hoolihome/house/controller/client/ClientLeaseDisplayTest.java、hoolihome-common-service-pom/hoolihome-house-service/src/main/java/com/hoolihome/house/util/ClientLeaseSupport.java、hoolihome-common-service-pom/hoolihome-house-service/src/test/java/com/hoolihome/house/util/ClientLeaseSupportTest.java
  • 改动量: +36行 / -16行
  • 功能说明: 优化客户端租期截止时间的计算与展示,使其与实际租期规则一致,避免出现到期时间显示不准确的问题。
-    /** 是否验证租期规则,1 校验,0 不校验 (用户客户端控制提交表单时租期字段是否强制必填) */
-    private Integer validation = 0;

27. refactor(application): 优化申请表与商机同步逻辑并防止死锁 ♻️ 重构

  • 模块: CRM/销售
  • 提交: b71056766d13(2026-10-26)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/application/ApplicationFormService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/CrmLeadsService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/application/LeadApplicationTeamSyncTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/leads/LeadApplyUserPresentationTest.java
  • 改动量: +335行 / -33行
  • 功能说明: 调整申请单负责人时,会先同步更新关联商机,再更新申请单,确保两边的负责人信息保持一致。统一数据更新顺序可避免申请单与商机同步时相互等待,降低同步失败或系统卡死的风险。
-        af.setApplyUserId(ownerId);
-        af.setOwnerUserId(ownerId);
-        applicationFormService.updateById(af);
+        // 与商机发起同步保持相同写入顺序:先商机、后申请表,避免新增双向锁等待。
+        syncLeadApplyUser(af, ownerId, operationUserId);
+        var wrapper = new UpdateWrapper<ApplicationForm>().eq(ApplicationForm.ID, afId)
+                .set(ApplicationForm.APPLY_USER_ID, ownerId).set(ApplicationForm.OWNER_USER_ID, ownerId)
+                .set(ApplicationForm.SYS_UPDATE_TIME, new Date());
+        if (!applicationFormService.update(wrapper)) {
+            throw new IllegalStateException("申请表人员更新失败");
+        }

28. refactor(lease): 简化并优化租期默认值计算与接口数据结构 ♻️ 重构

  • 模块: 其他
  • 提交: 347974a19b0b(2026-10-26)
  • 涉及文件: hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/controller/client/ClientRoomController.java、hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/vo/client/house/ClientRoomRentAttrVo.java、hoolihome-api-pom/hoollihome-house-api/src/test/java/com/hoolihome/house/controller/client/ClientLeaseDisplayTest.java、hoolihome-common-service-pom/hoolihome-house-service/src/main/java/com/hoolihome/house/util/ClientLeaseSupport.java、hoolihome-common-service-pom/hoolihome-house-service/src/main/java/com/hoolihome/house/vo/ClientRoomRentAttrVo.java、hoolihome-common-service-pom/hoolihome-house-service/src/test/java/com/hoolihome/house/util/ClientLeaseSupportTest.java
  • 改动量: +221行 / -125行
  • 功能说明: 统一了租期默认值的计算逻辑,并将接口中的租期信息整理为结构化数据,减少字段重复和不一致的风险。
-            attrVo.set("rentTimeEnd", attr.getRentTimeEnd());
-            attrVo.set("rentTime", attr.getRentTime());
-            attrVo.set("rentNum", ClientLeaseSupport.durationValue(attr));
-            attrVo.set("rentTimeUnit", attr.getRentTimeUnit());
-            attrVo.set("leasePlanType", attr.getLeasePlanType());
-            attrVo.set("rentEndMode", attr.getRentEndMode());
-            attrVo.set("rentDurationMode", attr.getRentDurationMode());
-            attrVo.set("rentExtraDays", attr.getRentExtraDays());
-            attrVo.set("rentNumMin", attr.getRentNumMin());
-            attrVo.set("rentNumMax", attr.getRentNumMax());
-            attrVo.set("rentStartMode", attr.getRentStartMode());
-            attrVo.set("rentStartFrom", attr.getRentStartFrom());
-            attrVo.set("rentStartTo", attr.getRentStartTo());

29. feat(application-form): 支持申请表待我申请(scope=4)范围筛选 ⭐ 新增

  • 模块: CRM/销售
  • 提交: f756049f20dd(2026-10-26)
  • 涉及文件: 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/params/ApplicationFormPageQuery.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/TabStatisticsParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/query/ApplicationFormPageQueryService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/query/ApplicationFormScopeSupport.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/query/CrmTabStatisticsService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/query/OrdinaryQueryHttpTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/CrmTabStatisticsHttpTest.java…等9个文件
  • 改动量: +180行 / -9行
  • 功能说明: 新增“待我申请”范围筛选,用户可专门查看需要由自己发起或处理的申请表,并在页签统计中展示该范围的数据。
-    /** 独立申请表页签统计;scope=0全部、1我负责的、2我对接的、3我申请的。 */
+    /** 独立申请表页签统计;scope=0全部、1我负责的、2我对接的、3我申请的、4待我申请。 */

30. feat(client-lease): 改进客户端租期展示和序列化逻辑 ⭐ 新增

  • 模块: CRM/销售
  • 提交: 45e0b417ca0b(2026-10-26)
  • 涉及文件: hoolihome-api-pom/hoollihome-house-api/build.gradle、hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/controller/client/ClientRoomController.java、hoolihome-api-pom/hoollihome-house-api/src/test/java/com/hoolihome/house/controller/client/ClientLeaseDisplayTest.java、hoolihome-common-service-pom/hoolihome-house-service/src/main/java/com/hoolihome/house/util/ClientLeaseSupport.java、hoolihome-common-service-pom/hoolihome-house-service/src/test/java/com/hoolihome/house/util/ClientLeaseSupportTest.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-house/src/main/java/com/hoolihome/house/util/RoomRentRules.java
  • 改动量: +298行 / -26行
  • 功能说明: 改进客户端租期的展示与序列化处理,统一相关时间的展示口径。新增专门的测试任务,验证租期展示结果符合预期。
+tasks.register('testClientLeaseDisplay', Test) {
+    enabled = true
+    useJUnitPlatform()
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+    filter { includeTestsMatching 'com.hoolihome.house.controller.client.ClientLeaseDisplayTest' }
+    systemProperty 'user.timezone', 'Asia/Shanghai'
+}
+

31. feat(room-rent): 新增租期时长说明字段及相关支持 ⭐ 新增

  • 模块: 房源/房型
  • 提交: dbe249e66fd7(2026-10-26)
  • 涉及文件: docs/dev_v2_filter/sql/room_rent_duration_description.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/RoomController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/RoomRentAttrParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomRentAttrBizService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/RoomRentRulesPersistenceTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/RoomRentRulesV4Test.java、hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/controller/client/ClientRoomController.java…等13个文件
  • 改动量: +111行 / -8行
  • 功能说明: 新增房间租期时长说明功能,出租时可以使用纯文本补充说明租期时长。该字段非必填,支持清空,且不会自动回填历史数据。
+-- 租期时长说明:独立增量DDL,不重复执行已有租期规则V4脚本。
+-- 执行前核对目标库和字段存在性;不回填历史内容,不修改其他租期字段。
+SELECT DATABASE() AS target_database, @@hostname AS target_host;
+SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_DEFAULT
+FROM information_schema.COLUMNS
+WHERE TABLE_SCHEMA = 'urcommon' AND TABLE_NAME = 'room_rent_attr'
+  AND COLUMN_NAME = 'rent_duration_description';
+
+ALTER TABLE urcommon.room_rent_attr
+  ADD COLUMN rent_duration_description TEXT NULL
+    COMMENT '租期时长说明,非必填纯文本,可清空';

32. feat(rent-attr): 支持并完善新租期规则及兼容旧接口校验 ⭐ 新增

  • 模块: 其他
  • 提交: e4c5417d9c4f(2026-10-25)
  • 涉及文件: docs/dev_v2_filter/sql/room_rent_attr_rules_v4.sql、hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/RoomController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/RoomRentAttrParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomRentAttrBizService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomRentAttrValidator.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomV2Service.java…等33个文件
  • 改动量: +902行 / -170行
  • 功能说明: 支持新的租期组合规则和独立总价计算,并兼容旧接口的参数校验。新规则仅对后续数据生效,不回填或修改历史报价、租期单位及租期数量类型。
+-- 租期组合规则与独立总价:待执行脚本。本次开发不执行任何环境的DDL/DML。
+-- 部署前先核对目标库与SHOW CREATE TABLE;新列必须全部缺失,部分已存在时另拟差异DDL。
+-- 新代码SELECT包含新列,因此须先完成表结构变更,再部署相关API。
+-- 不回填新规则,不计算或回填历史总价,不重标历史报价单位,不改rent_num_type。
+
+SELECT DATABASE() AS target_database, @@hostname AS target_host;
+
+SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_DEFAULT
+FROM information_schema.COLUMNS
+WHERE TABLE_SCHEMA = 'urcommon' AND TABLE_NAME = 'room_rent_attr'
+  AND COLUMN_NAME IN ('rent_num', 'rent_time_unit', 'rent_end_mode', 'rent_duration_mode', 'total_price');
+
+-- 只读核对:固定档期异常须单独确认,不批量改成可协商。
+SELECT COUNT(*) AS invalid_fixed_period_count
+FROM urcommon.room_rent_attr

33. feat(house): 新增房型默认租期单位配置及接口适配 ⭐ 新增

  • 模块: 房源/房型
  • 提交: 14ade9f27ed0(2026-10-25)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/RoomController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseAddressService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/vo/RoomInfoV2Vo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/RoomDetailDefaultRentTimeUnitTest.java
  • 改动量: +136行 / -0行
  • 功能说明: 新增房型默认租期单位配置,房型详情接口会根据房屋地址返回默认租期单位及对应文字说明。未配置时租期单位为空,方便前端展示和后续使用。
+        Integer defaultRentTimeUnit = addressService.getDefaultRoomRentTimeUnit(house);
+        obj.put("rentTimeUnit", defaultRentTimeUnit);
+        obj.put("rentTimeUnitText", defaultRentTimeUnit == null ? "" : TimeUnitEnum.getDesc(defaultRentTimeUnit));

34. Merge branch 'hotfix/production-before-allocation-20261024' into production 🐛 修复

  • 模块: 其他
  • 提交: 47522bfa4550(2026-10-24)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/CashBackController.java
  • 改动量: +2行 / -2行
  • 功能说明: 修复生产环境中返现功能在权益分配前可能出现的异常,确保返现流程正常执行。

35. fix(crm): 修正返现权限校验逻辑 🐛 修复

  • 模块: CRM/销售
  • 提交: e4d1e5e30e5e(2026-10-24)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/CashBackController.java
  • 改动量: +2行 / -2行
  • 功能说明: 修正了返现操作权限校验:管理员或该订单的销售人员可直接进行返现操作,其他用户仅能在本人创建返现记录时操作。
-        if (adminRoleService.checkAdmin(commonReqDTO.getPlatformUserId())) {
+        if (adminRoleService.checkAdmin(commonReqDTO.getPlatformUserId()) || Objects.equals(order.getSalesUserId(), com
-        } else if (Objects.equals(cashBack.getCreateUserId(), commonReqDTO.getPlatformUserId())  || Objects.equals(orde
+        } else if (Objects.equals(cashBack.getCreateUserId(), commonReqDTO.getPlatformUserId())) {

36. feat(crm): 优化线索池接口,批量关联相关数据减少查询次数 ⭐ 新增

  • 模块: CRM/销售
  • 提交: d9151b37c313(2026-10-24)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/AllocationConfigController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/AllocationConfigService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/resolve/UserResolveService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/AllocationPoolListAssociationsTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/resolve/AdviserBatchDetailsTest.java
  • 改动量: +311行 / -154行
  • 功能说明: 优化线索池接口,将顾问和平台用户等相关数据进行批量关联,减少重复查询,提升线索池数据的获取效率与接口响应速度。
-import com.hoolihome.common.vo.AdviserVo;
-import com.hoolihome.entity.platform.PlatformUser;

37. refactor(allocation): 优化bdList数据处理及相关单元测试 ♻️ 重构

  • 模块: 其他
  • 提交: c8ee10efed05(2026-10-24)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/AllocationConfigController.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/AllocationPoolListAssociationsTest.java
  • 改动量: +32行 / -5行
  • 功能说明: 优化了分配列表中 BD 数据的处理逻辑,确保顾问及平台用户信息能够正确转换和返回。同步完善了相关单元测试,验证分配池与 BD 列表的关联处理符合预期。
+import com.hoolihome.common.vo.AdviserVo;
+import com.hoolihome.entity.platform.PlatformUser;

38. refactor(allocation): 优化分配池相关列表与详情接口数据结构 ♻️ 重构

  • 模块: 其他
  • 提交: 02ca6a1e5b75(2026-10-24)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/AllocationConfigController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/QywxMessageController.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/AllocationPoolListAssociationsTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/QywxMessageUnreadTest.java、hoolihome-api-pom/hoolihome-gateway/build.gradle、hoolihome-api-pom/hoolihome-gateway/src/main/java/com/hoolihome/gateway/filters/ParamFilter.java、hoolihome-api-pom/hoolihome-gateway/src/test/java/com/hoolihome/gateway/filters/QueryParameterRewriteTest.java…等14个文件
  • 改动量: +506行 / -45行
  • 功能说明: 新增一组企业微信相关回归测试任务,集中验证消息未读、消息收藏和授权用户信息等功能,便于发布前自动检查并发现潜在问题。
+tasks.register('testProductionFixes', Test) {
+    enabled = true
+    useJUnitPlatform()
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+    filter {
+        includeTestsMatching 'com.hoolihome.crm.controller.QywxMessageUnreadTest'
+        includeTestsMatching 'com.hoolihome.crm.service.qywx.MessageFavoriteTest'
+        includeTestsMatching 'com.hoolihome.admin.controller.QywxAuthUserInfoTest'
+    }
+}
+

39. refactor(allocation): 统一顾问姓名为系统账号,移除独立用户名字段 ♻️ 重构

  • 模块: 系统管理
  • 提交: 3142ec532f62(2026-10-24)
  • 涉及文件: docs/assignable-sales/frontend-account-name-changes.md、docs/dev_v2_filter/sql/drop_assignable_sales_user_name.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/AllocationConfigController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/log/dto/AssignableSalesLog.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/log/dto/LeadsPoolLogBuilder.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/allocation/AssignableSalesParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/AllocationConfigService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/leads/AssignableSalesAccountNameTest.java…等9个文件
  • 改动量: +224行 / -23行
  • 功能说明: 顾问姓名统一改为使用系统账号信息,不再单独维护或传递姓名字段。销售顾问新增、编辑、列表及详情等接口相应调整,前端展示和查询均以关联的系统账号为准,并通过数据库脚本移除原独立姓名字段。
+# 顾问姓名统一使用系统账号:前端调整清单
+
+后端分支:production;当前仅源码调整,未提交、未部署,删字段 SQL 未执行。
+
+## 接口变化
+
+所有 URL 均为 POST,Content-Type 维持原来的 application/x-www-form-urlencoded。
+
+| URL | 前端调整 |
+| --- | --- |
+| `/rest/crm/allocation/sales/add` | 移除 userName;系统账号仍传 userId,其他参数沿用原合同。 |
+| `/rest/crm/allocation/sales/update` | 移除 userName;仍传顾问记录 id;不改变原有账号关联规则。 |
+| `/rest/crm/allocation/sales/list` | 每条记录删除 userName,姓名改读 platformUser?.userName。keyword 仍支持数字匹配系统账号 ID,其余按系统账号姓名模糊查询。
+| `/rest/crm/allocation/sales/info` | 删除 data.userName,姓名改读 data.platformUser?.userName。 |
+| `/rest/crm/allocation/pool/info` | 删除 data.salesList[].sales.userName,新增 sales.platformUser 系统账号对象,姓名读 sales.platform

40. feat(notification): 新增到账通知功能及相关接口优化 ⭐ 新增

  • 模块: 其他
  • 提交: ac49b3462fd6(2026-10-23)
  • 涉及文件: docs/dev_v2_filter/sql/commission_payment_receiver_arrival_notify_users.sql、"docs/dev_v2_filter/sql/invoice\345\273\272\350\241\250.sql"、hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/provider/NotificationProvider.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/OrderService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/qywx/QywxMessageService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/CommissionPaymentReceiverController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/PaymentReceiverParam.java…等16个文件
  • 改动量: +446行 / -15行
  • 功能说明: 为收款账户新增到账通知人配置,指定账户到账后需要通知的平台成员。未配置通知人的账户不会触发通知,也不会补发历史流水通知。
+-- 收款账户到账通知人;上线代码前执行,历史账户默认未配置,不触发历史流水补发。
+ALTER TABLE `commission_payment_receiver`
+    ADD COLUMN `arrival_notify_user_ids` text DEFAULT NULL COMMENT '到账通知人平台成员ID,JSON整数数组,NULL表示未配置'
+    AFTER `money_unit`;

41. feat(house): 增加API同步状态和映射名称字段支持 ⭐ 新增

  • 模块: 房源/房型
  • 提交: 1cc18b639828(2026-10-23)
  • 涉及文件: docs/dev_v2_filter/sql/house_api_mapping_name_nullable.sql、docs/live-shot-watermark/README.md、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/UpdateHouseInfoV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseApiSyncUpdateTest.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/common/controller/LiveShotWatermarkMediaTest.java、tools/lease_cleanup_release.py、tools/test_lease_cleanup_release.py
  • 改动量: +227行 / -1行
  • 功能说明: 新增公寓 API 同步状态及供应商映射名称的字段支持,映射名称现在可以明确记录为空值,便于正确表示未建立或已解除的供应商映射关系。
+-- 公寓供应商映射名称支持显式 NULL。仅准备,未经授权不得执行。
+-- 范围只有 house_info.api_mapping_name;不修改房型字段,也不清洗历史空字符串。
+-- 发布前先确认目标库,备份表结构,并评估 ALTER TABLE 的元数据锁及耗时。
+-- MySQL DDL 隐式提交,不能依赖事务 ROLLBACK 撤销。
+SELECT DATABASE() AS target_database;
+SELECT COLUMN_NAME, COLUMN_TYPE, CHARACTER_SET_NAME, COLLATION_NAME,
+       IS_NULLABLE, COLUMN_DEFAULT, COLUMN_COMMENT, EXTRA
+FROM information_schema.COLUMNS
+WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'house_info'
+  AND COLUMN_NAME = 'api_mapping_name';
+
+-- 保留实际 VARCHAR 长度、字符集、排序规则和注释,只调整可空性和默认值。
+-- 列不存在、不是普通 VARCHAR 或元数据不完整时,PREPARE 报错停止,不执行 ALTER。
+SET @house_api_mapping_name_ddl = (
+    SELECT CONCAT('ALTER TABLE `house_info` MODIFY COLUMN `api_mapping_name` ',

42. feat(data-cron): 调整水印转码以保留原视频分辨率与画质 ⭐ 新增

  • 模块: 视频处理
  • 提交: ae2811ee6326(2026-10-23)
  • 涉及文件: docs/live-shot-watermark/README.md、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/cron/jobs/mdy/LiveShotWatermarkTranscoder.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/resources/application-pro.yml、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/test/java/com/hoolihome/data/cron/jobs/mdy/LiveShotWatermarkWorkerTest.java
  • 改动量: +106行 / -2行
  • 功能说明: 水印转码将保留原视频的分辨率和画质,不再缩放到固定尺寸,并取消固定码率限制,让画面内容决定实际编码质量,同时保持现有视频格式、声音和水印展示效果兼容。已完成且源文件未变化的视频继续复用,未完成的旧任务会自动重新转码。
+
+## 原分辨率与画质保留(2026-10-23)
+
+水印 worker 的生产 `rule-version` 调整为4,素材仍用 `watermarks/live-shot/v3/logo.png`。仅需重新构建发布 `hoolihome-data-cron`;其他API可继续以版本3入队
+
+- 不设置视频Width、Height及LongShortMode,使用原视频分辨率,不再缩到长边1280。2026-10-23只读核对当前云模板,未配置宽高、帧率或码率上限;不修改共享云模板。
+- 移除固定2000 Kbps,显式使用 `TransConfig.TransMode=fixCRF`、`Video.Crf=18`,禁用视频码率检查;不设置Bitrate、Maxrate或Bufsize,由画面内容决定实际码率。不能保证
+- 保持H.264/yuv420p兼容编码、MP4、原声/消音及水印比例、位置、不透明度。叠加水印需要重新编码,此策略尽量保留画质,不承诺无损或HDR色彩保真。
+- 已完成且源未变的视频继续复用,不自动重转。未完成的旧版本任务按既有升级逻辑重置成对产物,避免新旧画质混用;版本4使用独立输出路径,不覆盖旧版本或源文件。无需SQL和历史回填。
+- 官方参数依据:https://help.aliyun.com/zh/mps/developer-reference/parameter-details 。本地测试验证请求和任务流程,不代表已执行真实云转码或发布。
+
+## 竖屏水印比例适配(worker规则v5)
+
+以已认可的9:16效果为基准。对宽高比小于1的竖屏,水印宽度比例按 `0.34 × min(1, (9/16) ÷ 视频显示宽高比)` 计算,再按Logo原比例计算高度。9:16保持原样;3:4时宽度从34%降到25.5%,高度保持约19
+

43. feat(watermark): 固定使用单张透明水印PNG及新版配置规则 ⭐ 新增

  • 模块: 其他
  • 提交: be3c2389391b(2026-10-23)
  • 涉及文件: "docs/dev_v2_filter/\345\217\221\345\270\203\346\240\270\345\257\271/20261022/\347\224\237\344\272\247\346\211\247\350\241\214\347\273\223\346\236\234.md"、"docs/dev_v2_filter/\345\217\221\345\270\203\346\240\270\345\257\271/20261022/\347\272\277\344\270\212\346\234\215\345\212\241\346\243\200\346\237\245.md"、docs/live-shot-watermark/README.md、docs/live-shot-watermark/assets/v3/logo.png、docs/live-shot-watermark/assets/v3/manifest.json、docs/live-shot-watermark/assets/v3/source.png、docs/live-shot-watermark/config.example.yml、docs/live-shot-watermark/schema.sql…等23个文件
  • 改动量: +218行 / -111行
  • 功能说明: 将测试环境中已配置好的11个收款账户及其国家关联导入生产环境,过滤已删除账户和QA测试账户,并保留生产原有账户。完成后生产环境共维护12个收款账户及12条国家关联,未导入测试流水和到账记录。
+## 2026-10-23 00:34 Invoice 收款账户配置导入
+
+按用户明确指令,从测试库导入之前配置好的收款账户及业务国家关联,过滤已删除数据;用户另确认排除未删除的QA自动测试账户。
+
+- 来源:测试urcommon,UUID `9831778a-8b60-11ef-abe3-02420a000105`;目标:生产urcommon,UUID `d78441aa-65e6-11f0-afff-5000e682f806`。
+- 同一事务新增 `commission_payment_receiver` **11条(ID4–14)**、`commission_payment_receiver_rel_country` **11条**。字段值、ID、币种、银行信息
+- 跳过测试已删除账户ID1/2/3及其2条关联;排除QA账户ID15。测试Invoice、到账流水未导入。
+- 生产原有账户ID1及其国家关联原样保留;测试已删除ID1不代表要删除生产同ID账户。完成后生产共 **12个账户、12条国家关联**。
+- 独立只读连接逐字段回读:新增两表与源记录摘要一致、原有记录未变、孤立/无效国家关联0;已删除及QA源记录未导入。完成于2026-10-23 00:34:17(上海)。
+- 导入前已保留目标两表的本地私有JSON/SQL备份。首次使用只读账户被INSERT权限拒绝,事务回滚无变更;随后改用项目既有生产应用写入连接,在再次核对原状态后完成。
+- 私有证据目录:`/Users/yaxiao/IdeaProjects/outputs/invoice-receivers-prod-20261023/`;`receipt.json`为执行/回读回执,`production-befor
+

44. fix(homeuser): 修正权限判断逻辑并新增测试覆盖 🐛 修复

  • 模块: 其他
  • 提交: 2bad2c3a41fc(2026-10-23)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/HomeUserController.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/HomeUserPermissionTest.java
  • 改动量: +83行 / -1行
  • 功能说明: 修正了首页用户的权限判断逻辑,避免出现权限误判或越权访问。同时补充了相关测试,确保各类权限场景均能按预期生效。
+import java.util.Objects;

45. feat(new-media): 补齐公共账号选择器返回字段 ⭐ 新增

  • 模块: 新媒体线索
  • 提交: 35eda858883c(2026-10-23)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/CommonController.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/newmedia/NewMediaAccountKeywordTest.java
  • 改动量: +53行 / -0行
  • 功能说明: 公共账号选择器现在会补充返回新媒体平台的相关信息,确保前端展示的账号选项字段完整可用。
+import com.hoolihome.crm.vo.newmedia.SimpleNewMediaPlatformVo;

46. feat(new-media): 对齐公共账号选择器关键词搜索 ⭐ 新增

  • 模块: 新媒体线索
  • 提交: 91447520c26a(2026-10-23)
  • 涉及文件: 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/newmedia/NewMediaAccountKeywordTest.java
  • 改动量: +41行 / -2行
  • 功能说明: 公共账号选择器现支持通过昵称、账号编号等关键词模糊查找,输入纯数字时还可匹配账号 ID。搜索前会自动去除关键词首尾空格,避免无效字符影响查询结果。
-        if (StrUtil.isNotBlank(param.getKeyword())) {
-            qw.like(NewMediaAccount::getNickname, param.getKeyword());
+        var keyword = StrUtil.trim(param.getKeyword());
+        if (StrUtil.isNotBlank(keyword)) {
+            Long keywordId = keyword.matches("[0-9]{1,10}") ? Long.valueOf(keyword) : null;
+            qw.and(query -> query.like(NewMediaAccount::getNickname, keyword)
+                    .or().like(NewMediaAccount::getAccountNo, keyword)
+                    .or().apply("main_operation_id IN (SELECT id FROM platform_user WHERE user_name LIKE {0})",
+                            "%" + keyword + "%")
+                    .or(keywordId != null && keywordId <= Integer.MAX_VALUE,
+                            idQuery -> idQuery.eq(NewMediaAccount::getId, keywordId)));

47. feat(new-media): 账号关键词支持ID精确匹配 ⭐ 新增

  • 模块: 新媒体线索
  • 提交: 29ddcbe0c9b4(2026-10-23)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/NewMediaAccountController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/newmedia/NewMediaAccountPageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/newmedia/NewMediaAccountKeywordTest.java
  • 改动量: +23行 / -2行
  • 功能说明: 新媒体账号搜索支持输入账号 ID 精确匹配对应账号,便于快速定位指定账号。
+        var keyword = StrUtil.trim(param.getKeyword());
+        Long keywordId = keyword != null && keyword.matches("[0-9]{1,10}")
+                ? Long.valueOf(keyword) : null;

48. feat(new-media): 账号关键词支持搜索主运营名称 ⭐ 新增

  • 模块: 新媒体线索
  • 提交: 331e1decf502(2026-10-23)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/NewMediaAccountController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/newmedia/NewMediaAccountPageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/newmedia/NewMediaAccountKeywordTest.java
  • 改动量: +107行 / -2行
  • 功能说明: 新媒体账号列表的关键词搜索功能扩展为支持按账号编号或主运营人员姓名进行模糊查询,便于快速定位相关账号。
-                        .like(NewMediaAccount::getAccountNo, StrUtil.trim(param.getKeyword())))
+                        .like(NewMediaAccount::getAccountNo, StrUtil.trim(param.getKeyword()))
+                        .or()
+                        .apply("main_operation_id IN (SELECT id FROM platform_user WHERE user_name LIKE {0})",
+                                "%" + StrUtil.trim(param.getKeyword()) + "%"))

49. feat(qywx-message): 增加消息星标功能及相关接口 ⭐ 新增

  • 模块: 企业微信
  • 提交: 1f452b49902d(2026-10-23)
  • 涉及文件: docs/dev_v2_filter/sql/crm_message_favorite_state.sql、"docs/dev_v2_filter/\345\217\221\345\270\203\346\240\270\345\257\271/20261022/\347\272\277\344\270\212\346\234\215\345\212\241\346\243\200\346\237\245.md"、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/DataFavoriteController.java、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/params/MessagePageParam.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/service/qywx/MessageFavoriteTest.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/entity/crm/CrmQywxMessage.java
  • 改动量: +401行 / -25行
  • 功能说明: 为企业微信消息增加星标功能,支持接收人独立标记或取消标记消息,并可按星标状态查询消息。星标状态与已读、删除状态互不影响,历史消息默认未星标。
+-- 仅准备;未执行。获得目标环境 DDL 授权并核对库名、现有字段/索引后执行一次。
+-- 必须在发布包含该实体字段的 crm-api / data-mq 等服务之前执行。
+-- 星标按消息接收人记录,与已读/删除状态独立;历史消息默认未标星。
+ALTER TABLE crm_qywx_message
+    ADD COLUMN favorite_state TINYINT NOT NULL DEFAULT 0 COMMENT '星标状态:0未标星 1已标星',
+    ADD INDEX idx_message_user_favorite_time (user_id, favorite_state, create_time, id);

50. fix(house): 暂缓二代公寓业务国家限制功能 🐛 修复

  • 模块: 房源/房型
  • 提交: 9282d34f8f4a(2026-10-22)
  • 涉及文件: "docs/dev_v2_filter/\345\217\221\345\270\203\346\240\270\345\257\271/20261022/\347\272\277\344\270\212\346\234\215\345\212\241\346\243\200\346\237\245.md"、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/qywx/QywxScheduleService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseV2Controller.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseListCountryScope.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseListCountryScopeTest.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-mq/src/main/java/com/hoolihome/mq/service/CrmSendMessageService.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/controller/client/ClientFeedbackController.java…等10个文件
  • 改动量: +128行 / -60行
  • 功能说明: 暂缓二代公寓的国家/地区限制功能,使相关房源不再因国家范围配置而被限制访问或展示。原有公寓及其他业务规则保持不变。
-> 后续本地修复已完成,等待用户发布:Data API恢复JdbcTemplate自动配置;CRM user-info对空用户返回明确错误,登录组装在用户解析成功后才创建令牌。Java 11离线编译及15项针对性测试通过(0失败、0跳过)
+## 22:10 业务与功能异常复核(最新)
+
+结论:服务存活正常,但房源客户端接口仍有业务异常,不能以 healthy 或 HTTP 200 认定全部功能正常。只读采集 20:55 起至约 22:04–22:07 的当前实例日志,覆盖 CRM、Data API、User API、Ho
+
+### 已确认的业务异常
+
+1. **房源不存在/参数缺失未做空值处理。** House API 两实例原始采集窗口共有 80 次接口 ERROR,发生于 21:02:54–22:02:34,其中 73 次 NullPointerException:详情 `Clie
+2. **展示编号/空值字符串被传入数字 houseId。** 其余 7 次为 BindException/JSON 转换错误;21:49 请求含 `B0753126894`,22:02 请求含字符串 `null`,影响详情、房型、附近房
+
+匿名查询复现(22:08–22:10,不计入上述 80 次):
+
+| 查询 | 结果 |
+| --- | --- |
+| houseId=2729 的公寓详情 | HTTP 200,业务 code=0,有数据 |

51. feat(crm-ai): 优化多客户需求识别与字段提取逻辑 ⭐ 新增

  • 模块: CRM/销售
  • 提交: 2cb8619fb671(2026-10-22)
  • 涉及文件: "docs/dev_v2_filter/\345\217\221\345\270\203\346\240\270\345\257\271/20261022/SHA256SUMS"、"docs/dev_v2_filter/\345\217\221\345\270\203\346\240\270\345\257\271/20261022/SQL\346\211\247\350\241\214\345\205\245\345\217\243.md"、"docs/dev_v2_filter/\345\217\221\345\270\203\346\240\270\345\257\271/20261022/SQL\346\211\247\350\241\214\350\256\241\345\210\222.json"、"docs/dev_v2_filter/\345\217\221\345\270\203\346\240\270\345\257\271/20261022/\347\224\237\344\272\247\345\217\252\350\257\273\346\240\270\345\257\271.md"、"docs/dev_v2_filter/\345\217\221\345\270\203\346\240\270\345\257\271/20261022/\347\224\250\346\210\267\345\206\263\345\256\232\344\270\216\345\216\206\345\217\262\350\247\204\345\210\231\345\244\215\346\240\270.md"、"docs/dev_v2_filter/\345\217\221\345\270\203\346\240\270\345\257\271/20261022/\350\256\242\345\215\225\350\241\245\347\224\263\350\257\267\344\270\216\344\275\243\351\207\221\347\261\273\345\236\213\346\242\263\347\220\206.md"、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/LeadsAiPrefillClient.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/LeadsAiPrefillEvidence.java…等11个文件
  • 改动量: +317行 / -28行
  • 功能说明: 优化了 CRM AI 对同一请求中多个客户需求的识别能力,并能按需求准确提取对应字段,减少需求混淆、遗漏和匹配错误。
-a99d1667ccb363aa297a3da738b6619128c73bbffe80c9de9485d55769d8bb8a  docs/dev_v2_filter/发布核对/20261022/SQL执行入口.md
-a94c80fbfb4c4101bedc6ab4065dc334c7d4547462ab4d68d1ec880e7d8bd2f2  docs/dev_v2_filter/发布核对/20261022/SQL执行计划.json
+e883e0e6130eaeda32eb68c27ee0d41c7d2f453cb0ded208c2a42a8b64c6b0da  docs/dev_v2_filter/发布核对/20261022/SQL执行入口.md
+98e32136d937ba662ef07bad92421dfb75e5f346549189e1a848c952b73c37bf  docs/dev_v2_filter/发布核对/20261022/SQL执行计划.json
-2e232ed9995a5866940ce25d1711fbb93813b8fcbcf6575655b70cbb784c74cd  docs/dev_v2_filter/发布核对/20261022/生产只读核对.md
-748768ab226e8f8e5240dadac447e01f6da48bb34094c35b71e0ec31806e249f  docs/dev_v2_filter/发布核对/20261022/用户决定与历史规则复核.md
+3115b8e1b1eccece33a31c81d9ff8445bbf287bf944150fe3c7f8e10aaa89e5d  docs/dev_v2_filter/发布核对/20261022/生产只读核对.md
+fc5b23532931405e72cd712737590474bd205924c7443531826b3da80e7a3590  docs/dev_v2_filter/发布核对/20261022/用户决定与历史规则复核.md
+6e6f6a8d0f5cf358b3e8cd127d3888f7b602954715e66fdc262ccfb71d5eb58b  docs/dev_v2_filter/发布核对/20261022/订单补申请与佣金类型梳理.md

52. refactor(invoice): 优化发票文件生成路径避免文件覆盖 ♻️ 重构

  • 模块: PDF生成
  • 提交: aae1a19972b1(2026-10-22)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/InvoiceFileGenerateService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/InvoiceFileGenerateServiceTest.java
  • 改动量: +22行 / -3行
  • 功能说明: 优化发票文件生成路径,为每次生成的文件加入唯一标识,避免同名发票文件相互覆盖。
-import java.util.Date;
+import java.util.UUID;

53. feat(crm): 补齐申请订单企微客户展示和商机绑定筛选 ⭐ 新增

  • 模块: CRM/销售
  • 提交: bd690931131e(2026-10-22)
  • 涉及文件: 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/CommonController.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/QywxGroupController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/LeadsPageQuery.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/application/ApplicationFormService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/OrderService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/query/LeadsPageQueryService.java…等11个文件
  • 改动量: +172行 / -11行
  • 功能说明: 补齐 CRM 申请订单中的企业微信客户信息展示,并支持根据客户与商机的绑定关系进行筛选,方便销售快速定位相关客户和订单。
+    private final LeadsQywxCustomerService qywxCustomerService;

54. feat(crm): 增加商机与企业微信群及客户绑定解绑功能 ⭐ 新增

  • 模块: CRM/销售
  • 提交: 6a6f4e17995a(2026-10-22)
  • 涉及文件: docs/dev_v2_filter/sql/qywx_message_sync_state.sql、hoolihome-api-pom/hoolihome-crm-api/build.gradle、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/params/LeadsAiPrefillParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/LeadsQywxBindingParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/group/QywxGroupsService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/CrmLeadsService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/LeadsAiPrefillService.java…等28个文件
  • 改动量: +1552行 / -132行
  • 功能说明: 该功能支持将 CRM 商机与企业微信群及客户建立绑定关系,并可随时解除绑定,便于统一跟进和管理相关客户。
+-- 在目标环境获得DDL授权并核对数据库身份后执行;本脚本不初始化游标或回填消息。
+-- 发布新的拉取代码前先建此表;切换时停用旧版拉取入口,避免旧版绕过数据库租约。
+-- 首次运行以已落库MAX(seq)初始化;以后使用本表检查点,不再使用Redis msgMaxSeq。
+CREATE TABLE IF NOT EXISTS qywx_msg_sync_state (
+  sync_key VARCHAR(64) NOT NULL PRIMARY KEY,
+  last_seq BIGINT NULL COMMENT 'NULL为首次初始化;与消息保存同事务提交',
+  run_id VARCHAR(36) NULL,
+  lease_until BIGINT NOT NULL DEFAULT 0,
+  status VARCHAR(16) NOT NULL DEFAULT 'IDLE' COMMENT 'IDLE/RUNNING/SUCCESS/PARTIAL/FAILED',
+  started_at BIGINT NULL,
+  finished_at BIGINT NULL,
+  last_success_at BIGINT NULL,
+  last_page_at BIGINT NULL,
+  error_code VARCHAR(64) NULL,
+  error_type VARCHAR(128) NULL,

55. fix(landlord): 优化供应商代码唯一性校验并提高并发处理能力 🐛 修复

  • 模块: 房东管理
  • 提交: 3397b124db7d(2026-10-22)
  • 涉及文件: docs/dev_v2_filter/sql/landlord_supplier_code_unique.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/LandlordService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/SupplierCodeConflictTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/SupplierCodeTest.java
  • 改动量: +252行 / -6行
  • 功能说明: 优化供应商代码的唯一性校验,确保同一供应商代码不会被多条供应商记录重复使用,同时支持并发场景下准确判重。供应商修改代码时可保留本人原代码,空值不占用编码,历史上架、禁用或删除的供应商编码也纳入唯一范围。
+-- 供应商代码判重;仅准备,未经单独授权不得执行。
+-- MySQL 8.0.13+。先完成 landlord_supplier_code.sql,再执行本脚本。
+-- 全表唯一(含下架、禁用、已删除供应商),修改时可保留本人的代码。
+-- null / 空串不占用代码,允许多条;纯空格等其他字符串按原值参与判重。
+-- 使用 supplier_code 的现有排序规则(测试库 utf8mb4_0900_ai_ci,大小写不敏感),不 trim、不改写任何历史值。
+-- 参考:https://dev.mysql.com/doc/refman/8.0/en/create-index.html#create-index-functional-key-parts
+SELECT DATABASE() AS target_database, VERSION() AS mysql_version;
+SELECT COLUMN_TYPE, IS_NULLABLE, COLLATION_NAME
+FROM information_schema.COLUMNS
+WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'landlord_info' AND COLUMN_NAME = 'supplier_code';
+
+-- 只读检查:如返回记录,先人工确认处理方式;本脚本不会清洗重复数据。
+SELECT supplier_code, COUNT(*) AS duplicate_count, GROUP_CONCAT(id ORDER BY id) AS supplier_ids
+FROM landlord_info
+WHERE supplier_code IS NOT NULL AND supplier_code <> ''

56. feat(invoice): 新增供应商代码支持优化发票编号生成 ⭐ 新增

  • 模块: PDF生成
  • 提交: 5a7138e1ef4a(2026-10-22)
  • 涉及文件: docs/dev_v2_filter/sql/landlord_supplier_code.sql、hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/LeadsAiPrefillController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/LeadsAiPrefillParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/LeadsAiPrefillAssociations.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/LeadsAiPrefillClient.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/LeadsAiPrefillEvidence.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/LeadsAiPrefillService.java…等22个文件
  • 改动量: +2157行 / -17行
  • 功能说明: 为供应商新增可选的供应商代码,用于优化发票编号的生成与识别,提高发票编号的一致性。该功能不会回填历史供应商代码,也不会重新计算已有发票编号。
+-- 供应商新增可选代码。仅准备,未经单独授权不得执行。
+-- 先执行本 SQL,再发布引用 supplier_code 的服务;不回填历史代码、不重算已有 Invoice 编号。
+SELECT DATABASE() AS target_database;
+SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_DEFAULT
+FROM information_schema.COLUMNS
+WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'landlord_info'
+  AND COLUMN_NAME = 'supplier_code';
+
+-- 列已存在时不重复添加;请核对已有列须为 VARCHAR(32)、允许 NULL。
+SET @landlord_supplier_code_ddl = IF(
+    EXISTS(SELECT 1 FROM information_schema.COLUMNS
+           WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'landlord_info'
+             AND COLUMN_NAME = 'supplier_code'),
+    'SELECT ''supplier_code already exists; verify definition'' AS migration_note',
+    'ALTER TABLE `landlord_info` ADD COLUMN `supplier_code` VARCHAR(32) NULL DEFAULT NULL COMMENT ''供应商代码,用于新建Invoice编号

57. feat(leads): 支持创建商机时绑定企业微信客户和微信群 ⭐ 新增

  • 模块: CRM/销售
  • 提交: 24af9c3f08ac(2026-10-22)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、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/crm/service/leads/CrmLeadsService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseV2Controller.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseListCountryScope.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseV2Service.java…等10个文件
  • 改动量: +446行 / -2行
  • 功能说明: 创建商机时,现在支持同时绑定企业微信客户和微信群,方便将房屋线索与客户及其群聊关联管理。

58. feat(order-comment): 增强附件实际格式校验和配置管理 ⭐ 新增

  • 模块: 其他
  • 提交: a901e9073808(2026-10-21)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/OrderCommentPresentationService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/resources/application-beta.yml、hoolihome-api-pom/hoolihome-crm-api/src/main/resources/application-test.yml、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/OrderCommentResponseTest.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/controller/open/OrderCommentFlowTest.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/controller/open/OrderCommentUploadTest.java、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/service/OrderCommentUploadService.java、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/service/OrderCommentUploadStorage.java
  • 改动量: +127行 / -22行
  • 功能说明: 订单评论附件新增了真实文件格式校验,避免不符合要求的文件被提交。同时,评论页面地址改为必须通过配置明确指定,不再使用默认地址。
-    @Value("${order.comment.page-url:https://example.invalid/order-comment}")
+    @Value("${order.comment.page-url}")

59. refactor(house): 优化供应商关联更新逻辑,支持切换供应商时清除旧关联 ♻️ 重构

  • 模块: 房源/房型
  • 提交: b29533b2025d(2026-10-21)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseV2Controller.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/UpdateHouseInfoV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/UpdateHouseLandlordRelationsParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/PlatformHouseService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseSupplierChangeTest.java
  • 改动量: +311行 / -19行
  • 功能说明: 更新房屋供应商时,如果供应商发生切换,会先清除原供应商关联的佣金、退订政策和活动,再保存新供应商的关联信息。供应商未变化时,仅在传入非空的佣金、政策或活动列表时全量更新对应关联,未传或传空列表则保持原有关联不变。
-     * commissionIds、policyIds、promotionIds 非空时全量替换对应关联,未传、null 或空列表时不修改。
+     * 供应商变化时先清除原佣金、退订政策和供应商活动关联,再保存本次选中的新供应商关联。
+     * 供应商未变化时,commissionIds、policyIds、promotionIds 非空时全量替换,未传、null 或空列表时不修改。

60. refactor(user-resolve): 重构顾问账号信息加载及缓存逻辑 ♻️ 重构

  • 模块: 其他
  • 提交: e5d2c4646b5d(2026-10-21)
  • 涉及文件: 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/common/vo/AdviserVo.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/HomeUserBehaviorController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/fee/CrmFeeOrderService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/resolve/UserResolveService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/resolve/AdviserAccountInfoTest.java、hoolihome-api-pom/hoolihome-user-api/build.gradle、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/controller/open/OrderCommentUploadTest.java…等10个文件
  • 改动量: +235行 / -9行
  • 功能说明: 升级顾问账号信息的缓存规则,按平台用户编号使用新版缓存标识,避免读取旧缓存数据,确保顾问信息加载和更新更准确。
-        var cacheKey = "crm:adviser:id-mp:" + param.getPlatformUserId();
+        var cacheKey = "crm:adviser:v2:id-mp:" + param.getPlatformUserId();

61. feat(order-comment): 实现订单评价附件独立上传签名及验证功能 ⭐ 新增

  • 模块: 其他
  • 提交: dfee7b4143af(2026-10-21)
  • 涉及文件: hoolihome-api-pom/hoolihome-user-api/build.gradle、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/controller/open/OrderCommentPublicController.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/controller/open/OrderCommentFlowTest.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/controller/open/OrderCommentUploadTest.java、hoolihome-common-service-pom/hoolihome-crm-common-service/build.gradle、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/param/OrderCommentUploadParam.java、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/service/OrderCommentService.java、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/service/OrderCommentUploadService.java…等10个文件
  • 改动量: +536行 / -43行
  • 功能说明: 实现了订单评价附件的独立上传流程,支持先获取上传凭证并在上传后验证附件。相关上传测试已纳入自动化测试执行范围。
-    filter { includeTestsMatching 'com.hoolihome.user.controller.open.OrderCommentFlowTest' }
+    filter {
+        includeTestsMatching 'com.hoolihome.user.controller.open.OrderCommentFlowTest'
+        includeTestsMatching 'com.hoolihome.user.controller.open.OrderCommentUploadTest'
+    }

62. fix(wallet): 恢复提现日期限制校验 🐛 修复

  • 模块: 财务/钱包
  • 提交: a5d7e9440b99(2026-10-21)
  • 涉及文件: hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/wallet/controller/WithdrawalRequestController.java
  • 改动量: +1行 / -3行
  • 功能说明: 恢复提现日期限制校验,客户每月仅可在1日至10日申请提现,其他日期将无法提现。
-        // TODO 2026-10-21:临时放开提现日期限制,客户操作完成后恢复以下校验。
-        /* 每月1-10号支持提现
+        //每月1-10号支持提现
-        */

63. feat(order-comment): 重构订单评价接口以支持多媒体与匿名功能 ♻️ 重构

  • 模块: 其他
  • 提交: 8643dc7d2514(2026-10-21)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/resources/application-dev.yml、hoolihome-api-pom/hoolihome-crm-api/src/main/resources/application-pro.yml、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/OrderCommentResponseTest.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/controller/open/OrderCommentFlowTest.java、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/param/OrderCommentPublicParam.java、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/service/OrderCommentService.java、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/vo/OrderCommentInfoVo.java
  • 改动量: +252行 / -45行
  • 功能说明: 订单评价功能重构后支持多媒体和匿名评价,并可根据订单编码及评价类型自动生成对应的评价页面链接,方便用户直达并提交评价。
-    # 独立评价页面尚未开放,/order-comment 为占位路径,后续替换实际页面路由。
-    page-url: https://testwww.hoolihome.com/order-comment
+    # 评价页基础地址,code 与 commentType 由链接生成逻辑追加。
+    page-url: http://testwww.hoolihome.com/order-comment

64. fix(wallet): 临时放开提现日期限制 🐛 修复

  • 模块: 财务/钱包
  • 提交: 1c0f4f149e18(2026-10-21)
  • 涉及文件: hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/wallet/controller/WithdrawalRequestController.java
  • 改动量: +3行 / -1行
  • 功能说明: 临时取消每月仅1—10号可提现的限制,客户在临时开放期间可随时发起提现。客户完成相关操作后,将恢复原有的提现日期限制。
-        //每月1-10号支持提现
+        // TODO 2026-10-21:临时放开提现日期限制,客户操作完成后恢复以下校验。
+        /* 每月1-10号支持提现
+        */

65. feat(room): 实现房型批量编辑及空值映射支持 ⭐ 新增

  • 模块: 房源/房型
  • 提交: a8be46a7f893(2026-10-21)
  • 涉及文件: docs/dev_v2_filter/sql/room_api_mapping_name_nullable.sql、hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/RoomV2Controller.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/vo/RoomInfoV2Vo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/RoomNullBatchTransactionTest.java
  • 改动量: +265行 / -23行
  • 功能说明: 房型管理新增批量编辑能力,可一次更新多条房型信息。供应商映射名称支持显式清空为 null,并提供发布前的数据库字段检查与备份提示,避免误改历史数据。
+-- 房型供应商映射名称支持显式 NULL。仅准备,未经授权不得执行。
+-- 范围只有 room_info.api_mapping_name;不修改公寓字段,也不清洗历史空字符串。
+-- 发布前先确认目标库,备份表结构,并评估 ALTER TABLE 的元数据锁及耗时。
+-- MySQL DDL 隐式提交,不能依赖事务 ROLLBACK 撤销。
+SELECT DATABASE() AS target_database;
+SELECT COLUMN_NAME, COLUMN_TYPE, CHARACTER_SET_NAME, COLLATION_NAME,
+       IS_NULLABLE, COLUMN_DEFAULT, COLUMN_COMMENT, EXTRA
+FROM information_schema.COLUMNS
+WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'room_info'
+  AND COLUMN_NAME = 'api_mapping_name';
+
+-- 保留实际 VARCHAR 长度、字符集、排序规则和注释,只调整可空性和默认值。
+-- 列不存在、不是普通 VARCHAR 或元数据不完整时,PREPARE 报错停止,不执行 ALTER。
+SET @room_api_mapping_name_ddl = (
+    SELECT CONCAT('ALTER TABLE `room_info` MODIFY COLUMN `api_mapping_name` ',

66. feat(api): 支持增量更新接口的JSON请求体和null值处理 ⭐ 新增

  • 模块: 其他
  • 提交: d6bd22a86428(2026-10-21)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、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/LeadsController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/IncrementalUpdateApplicationFormParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/IncrementalUpdateLeadsParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/CrmLeadsService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/newmedia/NewMediaAccountVo.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/newmediaasset/NewMediaEmailItemVo.java…等23个文件
  • 改动量: +601行 / -21行
  • 功能说明: 增量更新接口现已支持通过 JSON 提交更新内容,并正确识别 null 值,从而支持将申请表单或线索中的已有信息清空。
+    // 仅测试依赖:重放真实网关过滤器,再进入 MVC 和 MyBatis 验证清空。
+    testImplementation project(':hoolihome-gateway')
+    testImplementation 'org.springframework.cloud:spring-cloud-starter-gateway'

67. refactor(applicationForm): 移除废弃导出相关代码及查询配置 ♻️ 重构

  • 模块: 数据导出
  • 提交: 2e910962726f(2026-10-21)
  • 涉及文件: docs/dev_v2_filter/README.md、docs/dev_v2_filter/SHA256SUMS、docs/dev_v2_filter/sql/drop_crm_user_saved_filter.sql、"docs/dev_v2_filter/\345\212\250\346\200\201\346\237\245\350\257\242\346\216\245\345\217\243.md"、hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/export/AbstractAsyncExportService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/query/builder/DataPermissionHelper.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/query/builder/DynamicQueryBuilder.java…等96个文件
  • 改动量: +262行 / -8218行
  • 功能说明: 移除了已废弃的导出功能及其相关查询配置,相关接口不再提供使用。文档同步更新,将动态查询接口标记为已移除并归档。
-| 查租房手册、动态查询 | [租房手册](租房手册.md)、[动态查询接口](动态查询接口.md) |
+| 查租房手册、动态查询 | [租房手册](租房手册.md)、[动态查询历史归档(已移除)](动态查询接口.md) |

68. refactor(feeOrder): 重构商机相关字段,优化订单信息关联 ♻️ 重构

  • 模块: CRM/销售
  • 提交: b987302f0735(2026-10-21)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/FeeOrderController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/fee/BaseFeeOrderVo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/FeeOrderRelationsTest.java
  • 改动量: +18行 / -21行
  • 功能说明: 优化费用订单中商机相关信息的关联与展示,改为统一通过订单信息进行补充,减少重复处理并确保关联信息准确一致。
-                fillBriefRelations(vo, form, leads, relatedOrders.get(it.getFormId()));
+                fillOrderInfo(vo, relatedOrders.get(it.getFormId()));

69. feat(order): 实现供应商金额显式null支持及相关接口改造 ⭐ 新增

  • 模块: 其他
  • 提交: 5787695910fb(2026-10-21)
  • 涉及文件: docs/dev_v2_filter/sql/order_supplier_commission_nullable.sql、hoolihome-api-pom/hoolihome-crm-api/build.gradle、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/params/order/ForcedUpdateOrderParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/order/OrderFinancialClosingParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/order/OrderSubmitSupervisorParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/order/SupplierCommissionAmountDeserializer.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/OrderService.java…等15个文件
  • 改动量: +557行 / -30行
  • 功能说明: 订单供应商的应收、实收佣金现在支持明确清空金额,不再只能填写数值或保留原值。强制更新订单和财务结单接口已同步适配,可正确传递并保存供应商金额为空的情况。
+-- 订单供应商应收/实收支持 NULL。仅准备,未经授权不得执行。
+-- 先选择正确数据库,并核对下列两列;应在支持清空的新 CRM API 启用前执行。
+-- 仅改变两列的可空性及默认值,不更新任何历史金额,也不涉及客户佣金。
+-- MySQL DDL 会隐式提交;执行前按发布流程备份表结构。
+SELECT DATABASE() AS target_database;
+SELECT COLUMN_NAME, COLUMN_TYPE, IS_NULLABLE, COLUMN_DEFAULT, COLUMN_COMMENT
+FROM information_schema.COLUMNS
+WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'order_info'
+  AND COLUMN_NAME IN ('landlord_receivable_commission', 'landlord_actual_commission')
+ORDER BY ORDINAL_POSITION;
+
+-- 从当前库读取类型和注释并原样保留;两列必须都存在且为 DECIMAL。
+-- 检查不通过时变量为 NULL,PREPARE 报错停止,不执行任何结构修改。
+SET @order_supplier_commission_ddl = (
+    SELECT CONCAT('ALTER TABLE `order_info` ',

70. feat(order): 支持收款单展示关联正常订单简要信息 ⭐ 新增

  • 模块: 其他
  • 提交: 3f960a83a2fb(2026-10-21)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/FeeOrderController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/fee/CrmFeeOrderService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/fee/BaseFeeOrderVo.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/fee/FeeOrderVoMapper.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/order/SimpleOrderVo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/FeeOrderRelationsTest.java
  • 改动量: +97行 / -23行
  • 功能说明: 收款单现在可以展示其关联的正常订单简要信息,方便查看订单编号、金额等关键内容。
+import com.hoolihome.crm.vo.order.SimpleOrderVo;

71. feat(qywx): 将AI聊天总结概率及理由同步到商机 ⭐ 新增

  • 模块: CRM/销售
  • 提交: 16a50cbf5d8a(2026-10-21)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/CrmLeadsService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/leads/LeadsProbabilityTest.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/build.gradle、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/service/qywx/QywxChatSummaryProbability.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/service/qywx/QywxChatSummaryService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/test/java/com/hoolihome/data/service/qywx/QywxChatSummaryTest.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/entity/crm/CrmLeads.java
  • 改动量: +300行 / -7行
  • 功能说明: 将 AI 对聊天内容的总结评估结果及判断理由同步到对应商机,方便销售人员查看并参考客户的跟进优先级。
+    testImplementation 'org.junit.jupiter:junit-jupiter:5.8.2'
+    testImplementation 'org.mockito:mockito-core:4.0.0'
+
-}
+}
+tasks.register('testLeadsProbability', Test) {
+    enabled = true
+    useJUnitPlatform()
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+    filter { includeTestsMatching 'com.hoolihome.crm.service.leads.LeadsProbabilityTest' }
+    systemProperty 'user.timezone', 'Asia/Shanghai'
+}

72. feat(leads): 优化商机列表增加企微客户显示及测试支持 ⭐ 新增

  • 模块: CRM/销售
  • 提交: 62f7f4dc5ff9(2026-10-20)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/CrmLeadsService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/LeadsQywxCustomerService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/leads/LeadsQywxCustomerTest.java
  • 改动量: +192行 / -4行
  • 功能说明: 商机列表新增企业微信客户信息展示,并支持联调测试时展示临时的预估成单概率及判断原因,便于业务人员和前端验证客户跟进情况。
+    // 前端联调临时测试数据;后续由 AI 群消息总结维护商机预估后,恢复读取持久化字段。
+    private static final int DEBUG_CLOSING_PROBABILITY = 80;
+    private static final String DEBUG_PROBABILITY_REASON = "测试数据:客户租房需求明确,已积极沟通房源,预计成单概率较高。";
+
+    private final LeadsQywxCustomerService qywxCustomerService;

73. refactor(order-comment): 按评价类型拆分公寓和服务评价逻辑 ♻️ 重构

  • 模块: 房源/房型
  • 提交: c8a9e446a5c7(2026-10-20)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/OrderCommentPresentationService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/OrderCommentResponseTest.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/controller/open/OrderCommentPublicController.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/controller/open/OrderCommentFlowTest.java、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/param/OrderCommentPublicParam.java、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/service/OrderCommentService.java、hoolihome-common-service-pom/hoolihome-crm-common-service/src/main/java/com/hoolihome/biz/order/vo/OrderCommentInfoVo.java
  • 改动量: +182行 / -126行
  • 功能说明: 将订单评价按“公寓评价”和“服务评价”拆分处理,评价信息中分别展示对应入口。需要进行公寓评价时才展示公寓评价链接,服务评价链接则始终提供。
-                new OrderCommentInfoVo(url(id), value.getHouseComment(), value.getServiceComment())));
+                new OrderCommentInfoVo(value.isHouseRequired() ? url(id, 1) : null, url(id, 2), value.isHouseRequired()
+                        value.getHouseComment(), value.getServiceComment())));
-    private String url(Long orderId) {
-        return pageUrl + (pageUrl.contains("?") ? "&" : "?") + "code=" + codes.encrypt(orderId);
+    private String url(Long orderId, int commentType) {
+        return pageUrl + (pageUrl.contains("?") ? "&" : "?") + "code=" + codes.encrypt(orderId) + "&commentType=" + com

74. refactor(order-comment): 使用加密订单标识替换明文ID实现评价链接安全访问 ♻️ 重构

  • 模块: 其他
  • 提交: a706f8601378(2026-10-20)
  • 涉及文件: 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/params/order/OrderHouseCommentShareParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/OrderCommentPresentationService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/resources/application-dev.yml、hoolihome-api-pom/hoolihome-crm-api/src/main/resources/application-pro.yml、hoolihome-api-pom/hoolihome-crm-api/src/main/resources/application.yml、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/OrderCommentResponseTest.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/controller/open/OrderCommentPublicController.java…等12个文件
  • 改动量: +140行 / -78行
  • 功能说明: 订单评价分享链接使用加密后的订单标识替代明文订单ID,避免订单信息泄露,并保留免登录查看已评价内容的能力。生成链接时同时校验操作权限和订单有效性,防止无权限访问。
-    /** 生成独立免登录订单评价页面链接,已评价后仍可查看。 */
-    @PostMapping(value = "house-comment/share-url", consumes = MediaType.APPLICATION_JSON_VALUE)
-    public ResVo houseCommentShareUrl(@RequestBody OrderHouseCommentShareParam param) {
-        if (param.getPlatformUserId() == null || param.getPlatformUserId() <= 0) {
-            return ResVo.resErr("没有操作权限!");
-        }
-        if (param.getId() == null || param.getId() <= 0) return ResVo.resErr("请传入有效的订单ID");
-        var query = new OrderPageQuery();
-        query.setPlatformUserId(param.getPlatformUserId());
-        query.setIdList(List.of(param.getId()));
-        // 沿用订单列表的数据可见范围,不另设编辑权限或财务状态门槛。
-        var order = iOrderInfoService.getOne(ordinaryQueryService.filters(query));
-        if (order == null) return ResVo.resErr("订单不存在或无权访问");
-        try {
-            return ResVo.res(orderHouseCommentService.shareUrl(order));

75. feat(order-comment): 新增独立订单评价页面及匿名提交功能 ⭐ 新增

  • 模块: 其他
  • 提交: e420a8ab56e4(2026-10-20)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、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/service/order/OrderCommentPresentationService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/OrderHouseCommentService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/OrderHouseCommentInfoVo.java、hoolihome-api-pom/hoolihome-crm-api/src/main/resources/application.yml、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/OrderCommentResponseTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/OrderHouseCommentFlowTest.java…等15个文件
  • 改动量: +706行 / -367行
  • 功能说明: 新增独立订单评价页面,支持用户对订单及房源进行评价。评价可在匿名状态下提交,方便用户无需暴露身份表达真实反馈。
+    implementation project(':hoolihome-crm-common-service')

76. feat(order-comment): 新增客户公寓评价邀请及链接生成功能 ⭐ 新增

  • 模块: CRM/销售
  • 提交: c864ff9f4629(2026-10-20)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、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/params/order/OrderHouseCommentShareParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/OrderHouseCommentService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/OrderHouseCommentInfoVo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/OrderHouseCommentFlowTest.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiSupplierHttp.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/UnilodgeSyncService.java…等9个文件
  • 改动量: +434行 / -3行
  • 功能说明: 新增客户公寓评价邀请功能,可为已完成订单生成评价邀请链接,引导客户对所住公寓进行评价。同时补充了从邀请链接校验、评价准备到评价提交的完整测试链路,确保功能正常使用。
+    // 隔离验证订单邀请链接与客户端评价准备、提交的完整 API 链路。
+    testImplementation project(':hoolihome-user-api')

77. feat(api-sync): 优化多个供应商API租期同步逻辑并增强错误处理与邮件通知 ⭐ 新增

  • 模块: 系统同步
  • 提交: 758fd82f70fa(2026-10-20)
  • 涉及文件: 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/HouseSync.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiLeaseDiff.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiLeaseMapping.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiLeaseSyncResult.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/ApiSupplierHttp.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/service/ApiSyncBatch.java…等29个文件
  • 改动量: +3112行 / -261行
  • 功能说明: 优化多个供应商 API 租期的同步流程,统一处理同步过程中的异常情况,并通过邮件及时通知同步失败或异常结果。补充相关测试依赖,以保障租期同步功能的稳定性和可靠性。
+    testImplementation 'org.springframework.boot:spring-boot-starter-test'
+    testImplementation 'com.h2database:h2:1.4.200'

78. feat(sql): 添加上线前只读检查及完善迁移脚本说明 ⭐ 新增

  • 模块: 其他
  • 提交: bb688b018f24(2026-10-19)
  • 涉及文件: docs/dev_v2_filter/sql/order_receipt_audit.sql、docs/dev_v2_filter/sql/order_receipt_fee_type_backfill.sql、docs/dev_v2_filter/sql/order_receipt_migration.sql、docs/dev_v2_filter/sql/order_receipt_preflight.sql
  • 改动量: +112行 / -4行
  • 功能说明: 上线前新增只读核查,确认订单收据迁移版本、首次切换时间及备份数据量符合预期,避免未验证就发布。完善上线与回退指引:核对后先发布后端,再依次恢复回调、支付查单、企微拉取和自动取消任务;异常时先停止写入并核查新增支付或退款,再制定差异恢复方案。
+-- 显式设置 @apply_order_receipts=1 后重新执行迁移;核对成功后发布后端;再恢复任务。
+-- 本次不要求修改/发布前端。先恢复回调和支付查单、企微拉取,自动取消任务最后启用。
+-- 回退先停写,确认是否已有新支付/退款和业务写入,再制定按差异恢复方案;
+SET time_zone='+08:00';
+
+-- 必须存在且保持首次时间;不可把version改为本次日期,也不可重新生成completed_at。
+SELECT version,completed_at AS first_cutover_time
+FROM order_receipt_migration_control WHERE version='20261010';
+SELECT 'order_info_receipt_backup' AS backup_table,COUNT(*) AS row_count FROM order_info_receipt_backup
+UNION ALL SELECT 'home_fee_order_receipt_backup',COUNT(*) FROM home_fee_order_receipt_backup
+UNION ALL SELECT 'home_pay_refund_receipt_backup',COUNT(*) FROM home_pay_refund_receipt_backup;
+
+-- 停写窗口内迁移后必须为0:历史佣金账面字段没有被清洗覆盖。
+SELECT COUNT(*) AS changed_historical_commission_rows
+FROM order_info o JOIN order_info_receipt_backup b ON b.id=o.id

79. feat(order-commission): 统一订单佣金口径及详情展示逻辑 ⭐ 新增

  • 模块: 财务/钱包
  • 提交: 87aff86fc2ae(2026-10-19)
  • 涉及文件: docs/dev_v2_filter/sql/order_receipt_audit.sql、docs/dev_v2_filter/sql/order_receipt_migration.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/FeeOrderController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/OrderController.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/controller/OrderReceiptAssociationTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/fee/OrderCommissionCalculationTest.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-home/src/main/java/com/hoolihome/home/service/OrderCommissionService.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-home/src/main/java/com/hoolihome/mapper/home/OrderInfoMapper.java
  • 改动量: +260行 / -114行
  • 功能说明: 统一了订单佣金的金额口径和详情展示:有有效佣金收款单的订单展示汇总金额,历史订单保留原有账面金额,新订单在没有佣金收款单时显示无佣金。新订单的佣金仅在提交主管审核时计算并确定,历史订单不受影响。
+-- 详情:有效佣金收款单取汇总,否则历史订单回退原数据、新订单显示无佣金。
+-- 金额仅在新订单提交主管审核时计算落库;所有历史订单(含已关联状态3)保留账面金额。
+-- 新旧判定读取首次迁移控制记录 completed_at,与订单 create_time 比较,不使用关联枚举判定。

80. feat(common): 优化协作人员列表查询支持多职位类型及状态过滤 ⭐ 新增

  • 模块: 搜索/筛选
  • 提交: 53608131573b(2026-10-19)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/CommonController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/CollaboratorUserListParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/CommonService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/resolve/UserResolveService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/CollaboratorUserListData.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/CollaboratorUserListTest.java
  • 改动量: +223行 / -16行
  • 功能说明: 协作人员列表现在支持按多个职位类型组合查询,并可按人员状态进行筛选,方便用户快速定位目标协作人员。
+import com.hoolihome.crm.params.CollaboratorUserListParam;

81. refactor(video-preview): 重构后台实拍视频预览和分享逻辑 ♻️ 重构

  • 模块: 房源/房型
  • 提交: de92fe13d8b6(2026-10-19)
  • 涉及文件: docs/live-shot-watermark/README.md、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseLiveShotMaterialService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/LiveShotAdminVideoPreview.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/vo/LiveShotMaterialVoBuilder.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/LiveShotWatermarkAdminPreviewTest.java
  • 改动量: +178行 / -87行
  • 功能说明: 纳入处理范围的视频后,对外播放和分享仅提供带水印的原声版或消音版,严格模式下文件未处理完成时先返回等待提示,完成后再跳转访问,且不会暴露原片地址。后台实拍预览及下载统一使用带水印的原声视频,分享则使用带水印的消音视频。
-- 对纳入处理范围的视频,成功时 `originalUrl` 与 `videoUrl` 都指向水印原声MP4,`muteVideoUrl`/分享接口的`muteUrl`指向水印消音MP4。`originalUrl` 在实拍响应中表示可下载
+- 对外媒体接口对纳入处理范围的视频返回水印原声/消音版本;数据库源地址不变。后台实拍的 originalUrl/videoUrl/下载字段遵循下方独立约定。
-- enforce 模式下,仅纳入处理范围的视频要求两种产物全部成功才提供文件;处理中/失败返回稳定的 `.mp4` 等待地址和 watermarkStatus/message,不暴露源地址。等待地址未就绪返回503,完成后302到水印文
+- 对外媒体接口在 enforce 下要求两种水印产物全部完成;未完成返回稳定的 .mp4 等待地址及 watermarkStatus/message,不暴露原片。等待地址未就绪返回503,完成后302跳转水印文件。后台实拍预览见下方约定

82. fix(crm): 水印处理期间后台实拍使用原片预览 🐛 修复

  • 模块: CRM/销售
  • 提交: 575edb0a9460(2026-10-19)
  • 涉及文件: docs/live-shot-watermark/README.md、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseLiveShotMaterialService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/LiveShotAdminVideoPreview.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/vo/LiveShotMaterialVoBuilder.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/LiveShotWatermarkAdminPreviewTest.java
  • 改动量: +97行 / -0行
  • 功能说明: 水印处理中或处理失败时,CRM 后台的实拍预览将直接使用原片,避免因水印素材不可用而无法预览。该规则仅适用于后台音频预览或下载场景。
+
+## CRM preview exception (2026-10-19)
+
+CRM live-shot preview exception: while watermarkStatus is 1 (processing) or 3 (failed), originalUrl/videoUrl return the
+This CRM-only exception supersedes the pending source restrictions above for administrative audio preview/download only

83. fix(media): 修复水印任务源地址比较的排序规则冲突 🐛 修复

  • 模块: 新媒体线索
  • 提交: 0c018318d5b6(2026-10-19)
  • 涉及文件: hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/mapper/home/HomeVideoWatermarkMapper.java
  • 改动量: +2行 / -1行
  • 功能说明: 修复了水印任务源地址因大小写或排序规则差异导致的匹配错误,确保水印任务能够准确关联到对应的媒体资源。
+    // Source URLs are byte-sensitive OSS keys; legacy and watermark tables may use different collations.
-            + "(NOT(w.source_url <=> COALESCE(NULLIF(f.original_url,''),f.url)) "
+            + "(NOT(CAST(w.source_url AS BINARY) <=> CAST(COALESCE(NULLIF(f.original_url,''),f.url) AS BINARY)) "

84. feat(crm): 独立页签统计功能重构及注册用户跟进状态优化 ♻️ 重构

  • 模块: CRM/销售
  • 提交: 836d04ba8b31(2026-10-19)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、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/HomeUserController.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/mapper/CrmHomeUserMapperEx.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/ApplicationFormStatisticsParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/TabStatisticsParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/query/provider/HomeUserQueryConfigProvider.java…等20个文件
  • 改动量: +565行 / -192行
  • 功能说明: 重构 CRM 独立页签的数据统计逻辑,使各页签统计更加独立、准确;同时优化注册用户的跟进状态,提升用户跟进管理与业务判断效率。
+
+tasks.register('testCrmTabStatistics', Test) {
+    enabled = true
+    useJUnitPlatform()
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+    filter {
+        includeTestsMatching 'com.hoolihome.crm.service.query.CrmTabStatisticsTest'
+        includeTestsMatching 'com.hoolihome.crm.service.home.HomeUserStatisticsTest'
+        includeTestsMatching 'com.hoolihome.crm.controller.CrmTabStatisticsHttpTest'
+    }
+    systemProperty 'user.timezone', 'Asia/Shanghai'
+}

85. refactor(core): 将所有BD相关字段统一更名为对接同事以规范命名 ♻️ 重构

  • 模块: 其他
  • 提交: 59622b366105(2026-10-19)
  • 涉及文件: hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-mq/src/main/java/com/hoolihome/mq/consumer/AllocateAgentForCrmLeadsConsumer.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-mq/src/main/java/com/hoolihome/mq/service/allocate/LeadAllocateAgentService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-mq/src/test/java/com/hoolihome/mq/consumer/AllocateAgentForCrmLeadsConsumerTest.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-mq/src/test/java/com/hoolihome/mq/service/allocate/LeadAllocateAgentServiceTest.java、hoolihome-api-pom/hoolihome-user-api/build.gradle、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/controller/client/IntentController.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/ApplicationLeadReusePolicy.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/UserApplyService.java…等17个文件
  • 改动量: +1581行 / -142行
  • 功能说明: 统一规范线索分配相关字段命名,确保与对接方数据口径一致。尚未申请的注册商机继续暂不分配,已申请复用的商机保留原类型并正常进入分配流程。
-            //注册商机暂时不分配
-            if (Objects.equals(leadsBefore.getType(), ICrmLeadsService.TypeEnum.REGISTER.getCode())) {
+            // 尚未申请的注册商机暂不分配;已被申请复用的商机保留原类型并正常分配。
+            if (Objects.equals(leadsBefore.getType(), ICrmLeadsService.TypeEnum.REGISTER.getCode())
+                    && !Objects.equals(leadsBefore.getStatus(), ICrmLeadsService.LeadsStatusEnum.STATUS_SHENQINGZHONG.g
-            leadsAllocateAgentService.allocateIfNeeded(option.getDataId());
+            var allocationResult = leadsAllocateAgentService.allocateIfNeeded(option.getDataId());
+
+            if (allocationResult == LeadAllocateAgentService.AllocationResult.NOT_FOUND
+                    || allocationResult == LeadAllocateAgentService.AllocationResult.SKIPPED) {
+                return;
+            }
-            // 如果分配成功(状态变为待跟进且有销售人员)
+            // 已有销售也正常消费;只有本条消息完成分配才发送成功通知。
-                NumHelper.Int.checkNotZero(leadsAfter.getSalesUserId()) &&

86. refactor(core): 将所有BD相关字段统一更名为对接同事以规范命名 ♻️ 重构

  • 模块: 其他
  • 提交: a0268d105c29(2026-10-18)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/export/DistributorCompanyExportService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/export/DistributorUserExportService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/log/dto/DistributorCompanyLog.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/log/dto/LeadsLog.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/log/dto/OrderLog.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/CrmLeadsPageParam.java、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/crm/params/DistributorCompanyParam.java…等45个文件
  • 改动量: +65行 / -65行
  • 功能说明: 将系统中与 BD 相关的字段统一更名为“对接同事”,规范各业务模块及导出文件中的字段命名,便于业务人员理解和使用。
-            // 归属员工
+            // 对接同事

87. feat(media): 实拍视频按附件变化生成居中半透明水印 ⭐ 新增

  • 模块: 房源/房型
  • 提交: 659689c8828f(2026-10-18)
  • 涉及文件: .gitignore、docs/live-shot-watermark/README.md、docs/live-shot-watermark/assets/1.png、docs/live-shot-watermark/assets/2.png、docs/live-shot-watermark/assets/3.png、docs/live-shot-watermark/assets/4.png、docs/live-shot-watermark/assets/manifest.json、docs/live-shot-watermark/assets/v2/1.png…等36个文件
  • 改动量: +1372行 / -11行
  • 功能说明: 系统可针对实拍视频生成居中的半透明水印,并随附件内容变化同步更新水印展示。
+
+# Local Apifox documentation artifacts
+.apifox/
+docs/apifox/
+.apifox-helper.properties

88. refactor(order): 独立实现订单争议批量标记功能 ♻️ 重构

  • 模块: 其他
  • 提交: c517351b832a(2026-10-18)
  • 涉及文件: 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/params/order/OrderDisputeParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/OrderService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/CommissionInvoiceController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/InvoiceDisputeParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/InvoiceExceptionParam.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…等11个文件
  • 改动量: +180行 / -166行
  • 功能说明: 支持对指定订单批量标记或取消订单争议,并独立于发票状态及关联关系处理。操作完成后会记录每笔订单的处理行为,便于后续追踪。
+    /**
+     * 批量标记/取消订单争议,与 Invoice 状态及关联无关。
+     */
+    @PostMapping(value = "mark-exception-order", consumes = MediaType.APPLICATION_JSON_VALUE)
+    public ResVo markExceptionOrder(@RequestBody OrderDisputeParam param) {
+        try {
+            orderService.markExceptionOrder(param);
+            for (Long orderId : param.getOrderIdList()) {
+                LogRecorder.behavior(ObjectDataTypeEnum.Order.getCode(), orderId)
+                        .actionType(2)
+                        .userId(param.getPlatformUserId())
+                        .operation(Integer.valueOf(0).equals(param.getDisputedStatus()) ? "取消订单争议" : "标记订单争议")
+                        .record(() -> null);
+            }
+            return ResVo.res("争议状态更新成功!");

89. feat(order): 支持争议单筛选和全选查询订单ID ⭐ 新增

  • 模块: 搜索/筛选
  • 提交: 48583079229a(2026-10-18)
  • 涉及文件: 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/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
  • 改动量: +87行 / -4行
  • 功能说明: 支持按争议单条件筛选订单,并在开启全选时基于当前筛选条件和数据权限一次性查询全部订单ID,不再分页。
+            // 全选复用列表筛选和数据权限,不分页,仅查询ID。
+            if (Boolean.TRUE.equals(request.getAllSelect())) {
+                qw.select(OrderInfo.ID);
+                List<Long> idList = iOrderInfoService.list(qw).stream()
+                        .map(OrderInfo::getId)
+                        .collect(Collectors.toList());
+                return ResVo.res(PageBean.make(idList, idList.size(), request));
+            }

90. feat(api): 支持以JSON格式POST方式分页查询直播素材 ⭐ 新增

  • 模块: 其他
  • 提交: 7934abcb0b11(2026-10-16)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseLiveShotMaterialController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/LiveShotMaterialPageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseLiveShotMaterialService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/LiveShotPageQueryTest.java
  • 改动量: +125行 / -2行
  • 功能说明: 支持通过 POST 请求提交 JSON 参数,分页查询直播素材列表。调用方可在请求体中传入分页及筛选条件,便于按业务需求获取直播素材。
+import org.springframework.web.bind.annotation.PostMapping;

91. refactor(export): 支持异步导出使用预构建查询条件 ♻️ 重构

  • 模块: 数据导出
  • 提交: e935e5da20f1(2026-10-16)
  • 涉及文件: docs/dev_v2_filter/sql/order_receipt_fee_type_backfill.sql、docs/dev_v2_filter/sql/order_receipt_migration.sql、hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/export/AbstractAsyncExportService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/params/OrdinaryPageQuery.java、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/FeeOrderController.java…等37个文件
  • 改动量: +3011行 / -247行
  • 功能说明: 支持导出任务直接使用预先构建好的查询条件,并修正历史企微收款单的费用类型:按原收款金额将费用归入服务费或中介费,不影响线上收款、退款及订单佣金等数据。
+-- MySQL 8.0;仅修正 order_receipt_migration.sql 导入的历史企微收款单。
+-- 不处理线上收款、新建线下收款、人工接管的既有单据;不更改金额、退款、申请表和订单佣金。
+-- 按原收款金额(人民币元),不是扣除退款后的净额:六档金额为服务费,其余为中介费。
+-- 默认演练并 ROLLBACK;备份表 DDL 会自动提交,备份数据和分类更新在同一事务内。
+-- 经确认后,在无收款编辑任务运行时,同一连接 SET @apply_receipt_fee_types=1; 再 SOURCE 本文件。
+-- 首次提交会保存每张变更单据的原费用类型和更新时间;重跑不会覆盖备份。
+SET NAMES utf8mb4;
+SET time_zone='+08:00';
+CREATE TABLE IF NOT EXISTS home_fee_order_type_backup_20261016 (
+ id BIGINT PRIMARY KEY,
+ old_fee_type INT NULL,
+ new_fee_type INT NOT NULL,
+ amount DECIMAL(20,4) NOT NULL,
+ old_update_timestamp BIGINT NULL,
+ backed_up_at DATETIME NOT NULL

92. feat(room): 增加供应商 API 房型映射名称支持 ⭐ 新增

  • 模块: 房源/房型
  • 提交: 8b8c9181815c(2026-10-15)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/AddRoomInfoV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/UpdateRoomInfoV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/vo/RoomInfoV2Vo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/RoomApiMappingNameTest.java
  • 改动量: +134行 / -0行
  • 功能说明: 房型新增、修改及查询时支持记录供应商 API 的房型映射名称,便于业务人员识别房型与外部系统的对应关系。
+    /** 供应商 API 房型映射名称,可选,按原值保存。 */
+    private String apiMappingName;
+

93. refactor(user): 统一新用户昵称和头像留空,需用户主动设置 ♻️ 重构

  • 模块: 系统管理
  • 提交: 1129f4464224(2026-10-15)
  • 涉及文件: hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/ThirdService.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/UserBizService.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/UserService.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/vo/client/user/UserInfoVo.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/service/RegistrationProfileTest.java、hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/vo/client/house/ClientRoomRentAttrVo.java
  • 改动量: +117行 / -45行
  • 功能说明: 新用户注册后昵称和头像默认留空,不再自动生成,需要用户主动设置个人资料。
-import cn.hutool.core.util.RandomUtil;
-import com.hoolihome.aliyun.oss.Hoss;

94. feat(api-sync): 新增并支持房型API同步状态字段控制同步开关 ⭐ 新增

  • 模块: 房源/房型
  • 提交: 5b9ad9af993d(2026-10-15)
  • 涉及文件: docs/dev_v2_filter/sql/landlord_contact_owner_role.sql、docs/dev_v2_filter/sql/room_api_sync_status.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/AddRoomInfoV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/UpdateRoomInfoV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/vo/HouseInfoPlatformInfoV2Vo.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/vo/RoomInfoV2Vo.java…等15个文件
  • 改动量: +273行 / -5行
  • 功能说明: 新增房型 API 同步状态,并允许通过该状态控制是否执行房型数据同步。
+-- MySQL 5.7+/8.0;执行前须核对目标环境与前置校验。本版采用直接归属结构。

95. feat(landlord-contact): 优化联系人归属与角色管理逻辑 ⭐ 新增

  • 模块: 房东管理
  • 提交: 160a723e33a5(2026-10-15)
  • 涉及文件: docs/dev_v2_filter/sql/landlord_contact_owner_role.sql、hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/LandlordContactController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/LandlordController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/enums/ContactOwnerType.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/enums/ContactRoleType.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/LandlordContactParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/LandlordContactUpdateParam.java…等15个文件
  • 改动量: +975行 / -107行
  • 功能说明: 将联系人归属调整为互斥的供应商或公寓两类,并优化角色管理;迁移过程中保留原有状态和审计信息,避免影响现有业务数据。
+-- 联系人改为两种互斥的一对多归属:供应商 -> 联系人,公寓 -> 联系人。
+-- MySQL 5.7+/8.0;仅交付,未执行数据库。本版替换此前尚未执行的关联表保留方案。
+-- 供应商联系人:contact_owner_type=1,landlord_id非空,house_id为空。
+-- 公寓联系人:contact_owner_type=2,house_id非空,landlord_id为空。
+-- 顺序:停止联系人/旧关系写入 -> 数据库备份 -> 执行DDL和迁移 -> 验证 -> 部署新API -> 恢复写入。
+-- DDL会隐式提交;DML、备份、复制和旧关系清理处于同一事务,失败回滚。
+-- landlord_relation还供供应商业务国家使用,只清理relation_type=2,不能DROP整表。
+-- 迁移/备份表长期保留;禁止用--force忽略错误;角色留NULL,原状态及审计信息保留。
+-- 已执行旧版脚本的环境不应直接套本版;本版检测旧迁移映射后停止,须另做升级迁移。
+
+DELIMITER $$
+DROP PROCEDURE IF EXISTS prepare_contact_direct_owner_20261015$$
+CREATE PROCEDURE prepare_contact_direct_owner_20261015()
+BEGIN
+    IF EXISTS (SELECT 1 FROM information_schema.tables WHERE table_schema=DATABASE()

96. refactor(billReceiver): 移除按公寓筛选和关联公寓逻辑,新增标题字段 ♻️ 重构

  • 模块: 房源/房型
  • 提交: af4c6083d439(2026-10-14)
  • 涉及文件: docs/dev_v2_filter/sql/commission_bill_receiver_title.sql、"docs/dev_v2_filter/sql/invoice\345\273\272\350\241\250.sql"、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/CommissionBillReceiverController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/enums/ReceiverRangeTypeEnum.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/BillReceiverPageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/BillReceiverParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/BillReceiverUpdateParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/CommissionBillReceiverService.java…等15个文件
  • 改动量: +255行 / -467行
  • 功能说明: 账单接收方不再按公寓范围筛选,也无需维护与公寓的关联关系。新增“标题”字段,用于记录接收方的账单标题,并安排旧版筛选能力及相关数据逐步下线。
+-- 已有数据库升级;新库直接使用 invoice建表.sql,不重复执行本脚本。
+-- 第一步:发布新 API 前新增字段。保留已有 remark,不把备注迁移成标题。
+ALTER TABLE commission_bill_receiver
+    ADD COLUMN title varchar(500) DEFAULT NULL COMMENT '账单接收方标题' AFTER name;
+
+-- 第二步:所有旧版 API 实例下线后执行。执行前备份 range_type 及关联表数据。
+-- 删除后旧版按公寓筛选的 API 不可再运行;回滚需从备份恢复字段/关联数据。
+ALTER TABLE commission_bill_receiver DROP COLUMN range_type;
+DROP TABLE IF EXISTS commission_bill_receiver_rel_house;

97. refactor(house): 优化BD姓名加载逻辑和解析 ♻️ 重构

  • 模块: 房源/房型
  • 提交: 371c552dc407(2026-10-14)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/OrderService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/order/OrderReferralGenerationTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseV2BdNameTest.java
  • 改动量: +262行 / -8行
  • 功能说明: 优化经纪人(BD)姓名的加载与解析逻辑,确保订单及房屋相关业务中能准确获取并使用BD姓名。补充相关测试,提升姓名解析的稳定性和准确性。
+import com.hoolihome.home.service.IHomeUserExtendService;

98. refactor(user): 使用 BaseHomeUserVo 统一处理用户显示信息 ♻️ 重构

  • 模块: 系统管理
  • 提交: add33915bbb6(2026-10-14)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/HomeUserController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/UserController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/FeedbackService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/ReferralService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/UserService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/CrmLeadsService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/WithdrawalRequestService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/resolve/UserResolveService.java…等9个文件
  • 改动量: +126行 / -18行
  • 功能说明: 统一了用户展示信息的处理方式,使首页、反馈、推荐等业务场景中的用户信息展示保持一致,避免重复处理。
+import com.hoolihome.crm.vo.home.BaseHomeUserVo;
+

99. feat(invitation): 重构拉新资格逻辑,注册时确定拉新资格,业务继承注册邀请人 ♻️ 重构

  • 模块: 其他
  • 提交: 397e853125ae(2026-10-14)
  • 涉及文件: "docs/\346\213\211\346\226\260\351\200\273\350\276\221\345\217\230\345\212\250.md"、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/UserApplyService.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/UserBizService.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/service/LaxinApplicationTest.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/service/LaxinInvitationRecordTest.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/service/LaxinLeadPersistenceTest.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/service/LaxinRegistrationSourceTest.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/home/service/IHomeUserExtendService.java…等11个文件
  • 改动量: +535行 / -31行
  • 功能说明: 用户在注册时根据有效邀请和来源条件一次确定拉新资格并记录邀请人,后续提交业务时自动继承该注册邀请人,不再受分享缓存或分享参数变化影响。仅认可注册阶段获得的拉新资格,无注册记录的老用户不会因打开邀请链接或提交邀请码而新增资格。
+# 拉新逻辑变动
+
+## 2026-10-14:注册确定资格,后续客户端业务继承
+
+本节描述本次代码调整,下面的旧规则仅保留作历史参考。本次不批量清洗历史数据。
+
+### 资格与归属
+
+- 未注册用户通过有效邀请分享完成注册,且来源满足原有拉新条件时,保存注册拉新记录。
+- 注册记录指 `home_user_extend_detail` 中该用户的 `lead_id`、`bo_id` 均为空或 0 的记录。若有多条,按 ID 升序取第一条。
+- 只认可注册拉新记录。历史上提交业务产生的明细,即 `lead_id` 或 `bo_id` 非 0,不作为资格。
+- 已有注册资格的用户,后续客户端提交业务时从数据库继承邀请人。不再依赖客户端缓存;缺少分享参数、缓存被清除或换成 B 的分享,均不改变注册邀请人 A。
+- 没有注册记录的老用户,打开邀请链接、登录、携带分享缓存或邀请码提交业务,都不会新增拉新资格。
+- 实际分享来源参数仍用于原有来源计算和留痕;拉新归属独立取注册记录,不代表将本次渠道、新媒体等来源字段统一改写为邀请人。
+

100. feat(feedback): 添加反馈用户头像信息 ⭐ 新增

  • 模块: 系统管理
  • 提交: ac193593f77b(2026-10-14)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/FeedbackService.java
  • 改动量: +1行 / -0行
  • 功能说明: 反馈信息中补充了反馈用户的头像,方便前端展示反馈人的头像信息。
+                        .set("avatar", user.getAvatar())

101. refactor(album): 优化预览图列表设置逻辑 ♻️ 重构

  • 模块: 其他
  • 提交: 0db685c7b776(2026-10-13)
  • 涉及文件: hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/business/service/AlbumService.java
  • 改动量: +2行 / -1行
  • 功能说明: 优化了相册预览图列表的展示逻辑,预览列表仅返回图片内容,不再根据预览图片数量同步设置图片总数,避免数量信息与实际展示不一致。
-            imagePreviewVo.setPreviewList(priviewImageList).addImageCount(priviewImageList.size());
+            imagePreviewVo.setPreviewList(priviewImageList);
+                    //.addImageCount(priviewImageList.size());

102. feat(crm): 新增注册用户统计和按联系方式查询公共接口 ⭐ 新增

  • 模块: CRM/销售
  • 提交: 9b42e37761e5(2026-10-13)
  • 涉及文件: .apifox-helper.properties、.gitignore、hoolihome-api-pom/hoolihome-crm-api/.apifox-helper.properties、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/ContactSearchController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/HomeUserController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/mapper/CrmHomeUserMapperEx.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/mapper/dto/CrmHomeUserPageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/ContactSearchParam.java…等16个文件
  • 改动量: +556行 / -77行
  • 功能说明: CRM 新增注册用户统计功能,并提供按联系方式查询用户的公共接口,方便业务系统获取用户数量及匹配指定联系人的用户信息。
-ignore=#ignore
-field.doc[#maybe]=groovy:it.docs("maybe").collect{helper.resolveLink(it)}.collect{"???:\n\n```json\n" + it.toJson(true)
-folder.name=#folder
-class.prefix.path=/rest
-field.ignore=groovy:```
-                 def condtion = it.hasAnn("com.hoolihome.common.annotations.ApiFox") && it.ann("com.hoolihome.common.an
-                 if (condtion) {
-                   return true
-                 }
-                 def ig = it.containingClass().doc("fieldIgnore")
-                 def ab = tool.split(ig,",")
-                 for(a in ab){
-                   if(it.name().equals(a.trim())){
-                     return true
-                   }

103. refactor(UserApplyService): 优化租期起止日期处理逻辑 ♻️ 重构

  • 模块: 其他
  • 提交: 9437c0f64624(2026-10-12)
  • 涉及文件: hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/UserApplyService.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/service/ClientLeaseApplicationTest.java
  • 改动量: +58行 / -21行
  • 功能说明: 优化用户申请房源时的租期起止日期计算,统一处理不同起租模式,并兼容租住时长为空的情况,避免申请流程异常。
-        if (java.util.Objects.equals(roomAttr.getRentStartMode(), 1)) {
-            leadParam.setLiveTime(roomAttr.getRentTime());
-        } else if (java.util.Objects.equals(roomAttr.getRentStartMode(), 2)
-                && NumHelper.Int64.checkNotZero(leadParam.getLiveTime())
+        applyLeaseDates(leadParam, roomAttr);
+        if (java.util.Objects.equals(roomAttr.getRentStartMode(), 2)
+                && leadParam.getLiveTime() != null
-        if (fixedPeriod) {
-            leadParam.setEndRentTime(roomAttr.getRentTimeEnd());
-        }

104. fix(wallet): 修正提现申请描述信息 🐛 修复

  • 模块: CRM/销售
  • 提交: 8dc8f7863e08(2026-10-12)
  • 涉及文件: .apifox/.gitignore、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/wallet/vo/WithdrawalRequestVo.java
  • 改动量: +2行 / -1行
  • 功能说明: 修正了提现申请中描述信息的展示,使申请记录中的说明内容更加准确、清晰。

105. feat(house-building): 增强楼栋自动编号和迁移脚本逻辑 ⭐ 新增

  • 模块: 房源/房型
  • 提交: d4e02bf126e3(2026-10-12)
  • 涉及文件: docs/dev_v2_filter/SHA256SUMS、docs/dev_v2_filter/sql/house_building_backfill.sql、"docs/dev_v2_filter/\344\270\212\347\272\277\346\270\205\345\215\225.md"、"docs/dev_v2_filter/\345\212\237\350\203\275\350\257\264\346\230\216.md"、"docs/dev_v2_filter/\346\225\260\346\215\256\345\272\223\345\217\202\350\200\203.md"、"docs/dev_v2_filter/\346\225\260\346\215\256\346\270\205\346\264\227.md"、"docs/dev_v2_filter/\346\240\270\351\252\214\351\231\204\344\273\266/building_naming_test_refresh_20261012.json"、"docs/dev_v2_filter/\346\240\270\351\252\214\351\231\204\344\273\266/test_house_building_migration.py"…等12个文件
  • 改动量: +1043行 / -22行
  • 功能说明: 增强了楼栋自动编号及历史数据迁移规则,确保新旧楼栋在迁移后编号连续、一致,并提升迁移脚本的可靠性。
-495937fc750adb851ec224f5168df08e903d7da52c1493598eec7131725fa38f  docs/dev_v2_filter/sql/house_building_backfill.sql
+7526bd64e2d33685ff2bef1d6234ee59748c09c24011d41d09bc7736ac8bd842  docs/dev_v2_filter/sql/house_building_backfill.sql

106. feat(client-lease): 优化租期展示和数据结构支持 ⭐ 新增

  • 模块: 其他
  • 提交: d6d5babecba4(2026-10-12)
  • 涉及文件: hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/controller/client/ClientRoomController.java、hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/vo/client/house/ClientRoomRentAttrVo.java、hoolihome-common-service-pom/hoolihome-house-service/src/main/java/com/hoolihome/house/util/ClientLeaseSupport.java、hoolihome-common-service-pom/hoolihome-house-service/src/main/java/com/hoolihome/house/vo/ClientRoomRentAttrVo.java、hoolihome-common-service-pom/hoolihome-house-service/src/test/java/com/hoolihome/house/util/ClientLeaseSupportTest.java
  • 改动量: +41行 / -4行
  • 功能说明: 优化客户端租期展示,将租期时长统一转换为可直接展示的数值,并同时返回对应的租期单位,便于前台正确展示不同租期信息。
+            attrVo.set("rentNum", ClientLeaseSupport.durationValue(attr));
+            attrVo.set("rentTimeUnit", attr.getRentTimeUnit());

107. refactor(house): 注释顶部图片媒体处理代码 ♻️ 重构

  • 模块: 房源/房型
  • 提交: fa8e55bbbada(2026-10-12)
  • 涉及文件: hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/business/service/AlbumService.java
  • 改动量: +2行 / -2行
  • 功能说明: 停用了相册分类中顶部图片媒体的自动添加处理,相关逻辑暂不生效,仅以注释形式保留,便于后续恢复或参考。
-            var mediaVoWrapper = AlbumMediaVo.createImageMedia(isEn ? HouseEnum.HOUSE_IMAGE_TYPE_TOPS.getEnDescription(
-            albumAllCategory.addMedia(mediaVoWrapper);
+            //var mediaVoWrapper = AlbumMediaVo.createImageMedia(isEn ? HouseEnum.HOUSE_IMAGE_TYPE_TOPS.getEnDescriptio
+            //albumAllCategory.addMedia(mediaVoWrapper);

108. feat(lease): 重构租赁时间处理逻辑并优化租期显示 ♻️ 重构

  • 模块: 其他
  • 提交: 18edcc453e04(2026-10-12)
  • 涉及文件: hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/controller/client/IntentController.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/UserApplyService.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/service/ClientLeaseApplicationTest.java、hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/business/service/HouseService.java、hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/controller/client/ClientHouseController.java、hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/controller/client/ClientRoomController.java、hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/controller/client/v2/ClientHouseControllerV2.java、hoolihome-api-pom/hoollihome-house-api/src/main/java/com/hoolihome/house/controller/client/v2/ClientHouseOptionsController.java…等17个文件
  • 改动量: +445行 / -133行
  • 功能说明: 仅对租期方案为标准类型、没有额外天数且租期不为零的房源执行租赁时间计算与展示,避免异常租期配置影响租期显示。
-            if (NumHelper.Int.checkNotZero(roomAttr.getRentNum())) {
+            if ((roomAttr.getLeasePlanType() == null || java.util.Objects.equals(roomAttr.getLeasePlanType(), 1)
+                    || java.util.Objects.equals(roomAttr.getLeasePlanType(), 2))
+                    && (roomAttr.getRentExtraDays() == null || roomAttr.getRentExtraDays() == 0)
+                    && NumHelper.Int.checkNotZero(roomAttr.getRentNum())) {

109. feat(mediaLead): 新增新媒体线索状态统计功能 ⭐ 新增

  • 模块: 新媒体线索
  • 提交: ea09d13a7f09(2026-10-12)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/MediaLeadController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/medialead/MediaLeadStatisticsParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/medialead/MediaLeadStatisticsService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/medialead/MediaLeadStatisticsVo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/medialead/MediaLeadStatisticsTest.java
  • 改动量: +263行 / -1行
  • 功能说明: 新增新媒体线索状态统计功能,支持按查询条件统计各状态的线索数量并返回统计结果,同时补充相关测试以保障功能正常。
-    filter { includeTestsMatching 'com.hoolihome.crm.service.medialead.MediaLeadUpdateTest' }
+    filter {
+        includeTestsMatching 'com.hoolihome.crm.service.medialead.MediaLeadUpdateTest'
+        includeTestsMatching 'com.hoolihome.crm.service.medialead.MediaLeadStatisticsTest'
+    }

110. refactor(mediaLead): 移除新媒体线索导出功能及相关废弃代码 ♻️ 重构

  • 模块: 数据导出
  • 提交: 8e85b6430076(2026-10-12)
  • 涉及文件: "docs/dev_v2_filter/\345\212\250\346\200\201\346\237\245\350\257\242\346\216\245\345\217\243.md"、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/MediaLeadController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/export/MediaLeadExportRow.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/export/MediaLeadExportService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/medialead/IncrementalUpdateMediaLeadParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/medialead/MediaLeadRequest.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/medialead/NewMediaPageQuery.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/query/provider/MediaLeadQueryConfigProvider.java…等13个文件
  • 改动量: +97行 / -626行
  • 功能说明: 移除了新媒体线索导出功能及相关的废弃代码,并将系统支持的业务模块数量调整为18个。
-所有 `QueryConfigProvider` 实现由 Spring 自动收集并按 `getModuleKey()` 注册。截至当前共 **19 个模块**:
+所有 `QueryConfigProvider` 实现由 Spring 自动收集并按 `getModuleKey()` 注册。截至当前共 **18 个模块**:

111. feat(mediaLead): 增量更新新媒体线索及相关功能优化 ⭐ 新增

  • 模块: 新媒体线索
  • 提交: e7255ccc3e98(2026-10-12)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/MediaLeadController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/medialead/IncrementalUpdateMediaLeadParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/medialead/MediaLeadRequest.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/medialead/NewMediaPageQuery.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/query/provider/MediaLeadQueryConfigProvider.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/medialead/MediaLeadService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/medialead/MediaLeadUpdateService.java…等10个文件
  • 改动量: +743行 / -87行
  • 功能说明: 支持新媒体线索的增量更新,结合查询条件和分页参数筛选需要处理的线索,便于及时同步和更新业务数据。
+
+tasks.register('testMediaLead', Test) {
+    enabled = true
+    useJUnitPlatform()
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+    filter { includeTestsMatching 'com.hoolihome.crm.service.medialead.MediaLeadUpdateTest' }
+    systemProperty 'user.timezone', 'Asia/Shanghai'
+}

112. refactor(house): 优化楼栋楼层和楼高的聚合及展示逻辑 ♻️ 重构

  • 模块: 房源/房型
  • 提交: 5f7ce69a40f5(2026-10-10)
  • 涉及文件: docs/dev_v2_filter/README.md、docs/dev_v2_filter/SHA256SUMS、docs/dev_v2_filter/sql/house_building_backfill.sql、docs/dev_v2_filter/sql/house_image_building_height_fields.sql、docs/dev_v2_filter/sql/house_image_floor_building.sql、"docs/dev_v2_filter/\344\270\212\347\272\277\346\270\205\345\215\225.md"、"docs/dev_v2_filter/\345\212\237\350\203\275\350\257\264\346\230\216.md"、"docs/dev_v2_filter/\346\225\260\346\215\256\345\272\223\345\217\202\350\200\203.md"…等54个文件
  • 改动量: +818行 / -362行
  • 功能说明: 优化楼栋楼层和楼高的汇总与展示逻辑,并自动补齐历史真实楼栋数据,将原有楼栋的楼层数、楼高信息迁移到新的楼栋关联关系中,确保数据完整且展示准确。
+- [house_building_backfill.sql](sql/house_building_backfill.sql):两项楼栋/关联 DDL 完成后执行,代码发布前补齐真实楼栋并迁移层数、层高。

113. feat(payment): 优化收款单支付及取消流程,新增超时自动取消任务 ⭐ 新增

  • 模块: 其他
  • 提交: 641d33fcbf35(2026-10-10)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/FeeOrderController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/OrderController.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/fee/FeeOrderCancellationTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/fee/ReceiptPaymentCallbackTest.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/java/com/hoolihome/data/cron/jobs/pay/FeeOrderExpireJob.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/resources/application-pro.yml、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/resources/application-test.yml、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/user/service/FeeOrderPayBizService.java…等15个文件
  • 改动量: +458行 / -32行
  • 功能说明: 优化收款单的支付和取消处理流程,并新增超时未支付自动取消任务,避免收款单长期滞留。
+    private final com.hoolihome.pay.service.FeeOrderCancellationService cancellationService;

114. feat(fee): 优化企微对外收款流水同步与订单客户佣金处理 ⭐ 新增

  • 模块: CRM/销售
  • 提交: 131bd894a290(2026-10-10)
  • 涉及文件: docs/dev_v2_filter/sql/order_receipt_migration.sql、hoolihome-api-pom/hoolihome-data-pom/hoolihome-data-cron/src/main/resources/application-test.yml
  • 改动量: +9行 / -2行
  • 功能说明: 优化企微对外收款流水的同步机制,确保同步后订单的客户佣金收款状态能够正确更新,同时保留订单原有更新时间。
-SET o.customer_commission_receipt_status=CASE
+SET o.sys_update_time=o.sys_update_time,
+ o.customer_commission_receipt_status=CASE

115. feat(fee): 优化企微对外收款流水同步与订单客户佣金处理 ⭐ 新增

  • 模块: CRM/销售
  • 提交: cc8a809631c2(2026-10-10)
  • 涉及文件: docs/dev_v2_filter/sql/order_receipt_audit.sql、docs/dev_v2_filter/sql/order_receipt_migration.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/FeeOrderController.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/params/order/OrderFinancialAuditParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/order/OrderSubmitSupervisorParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/fee/CrmFeeOrderService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/fee/FeeOrderRefundService.java…等27个文件
  • 改动量: +1038行 / -91行
  • 功能说明: 优化企业微信对外收款流水与订单的客户佣金关联处理,区分无佣金、佣金无法关联收款单及已关联三类状态,并标记需要人工复核的情况。客户佣金金额在提交主管审核时按关联收款单重新汇总;无法关联时保留历史金额,避免影响订单审核和财务数据准确性。
+-- 迁移后核对(只读)。正式执行迁移前先保存数据库备份并停旧版写入任务。
+-- 部署顺序:执行 order_receipt_migration.sql 默认演练;核对输出;
+-- 同一会话 SET @apply_order_receipts=1 后重新执行迁移;部署新后端与前端;恢复任务。
+-- 禁止 mysql --force:遇到任何错误应立即断开会话并排查,未提交事务会回滚。
+-- 回退需停写并按三个 *_receipt_backup 表恢复原订单/收款/退款数据;
+-- 若上线后已产生新业务数据,不能直接全表覆盖,必须逐笔核对新增及更新记录。
+SET NAMES utf8mb4;
+
+-- 枚举:1无客户佣金,2有客户佣金无法关联收款单,3有客户佣金关联收款单。
+-- 接口返回 customerCommission.customerCommissionReceiptStatus 及对应Text;needsReview为状态2。
+-- 金额仅在提交主管审核时计算;状态2保留历史值,其余按关联收款单汇总。
+SELECT id,application_form_id,order_status,customer_commission_order_code,customer_commission_receipt_status,
+ customer_commission_type,customer_receivable_commission,customer_actual_commission
+FROM order_info
+WHERE (order_status IS NULL OR order_status<>4) AND customer_commission_receipt_status=2;

116. feat(attachment): 附件回显添加创建时间倒序排序 ⭐ 新增

  • 模块: 其他
  • 提交: 0ff8efa92efd(2026-10-09)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/provider/AttachmentTraceProvider.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/provider/AttachmentTraceProviderTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/vo/RentalManualAttachmentTraceTest.java
  • 改动量: +115行 / -8行
  • 功能说明: 附件回显时,新增创建人信息,并按附件创建时间从新到旧排序,方便用户优先查看最新上传的附件。
+import java.util.Comparator;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.time.format.DateTimeParseException;
+import java.time.format.ResolverStyle;
- * 附件回显:保留 JSON 字符串协议及原字段,只增加 createUser(AdviserVo)。
+ * 附件回显:保留 JSON 字符串协议及原字段,增加 createUser(AdviserVo)并按创建时间倒序。

117. test(hoolihome-crm-api): 添加公寓图片兜底和新增增量更新调用链回归测试 ⭐ 新增

  • 模块: CRM/销售
  • 提交: 85176d1ab336(2026-10-09)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseInfoImageBizService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/PlatformHouseService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseImageFallbackTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseV2LandlordRelationsTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/PlatformHouseServiceAddRelationsTest.java
  • 改动量: +256行 / -18行
  • 功能说明: 新增公寓图片缺失时的兜底处理,并完善公寓新增后房源、业主等关联数据增量更新的验证,确保图片展示和数据同步链路正常。
+
+tasks.register('testHouseImageFallback', Test) {
+    enabled = true
+    useJUnitPlatform()
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+    filter {
+        includeTestsMatching 'com.hoolihome.erp.service.HouseImageFallbackTest'
+        includeTestsMatching 'com.hoolihome.erp.service.PlatformHouseServiceAddRelationsTest'
+        includeTestsMatching 'com.hoolihome.erp.service.HouseV2LandlordRelationsTest'
+    }
+    systemProperty 'user.timezone', 'Asia/Shanghai'
+}

118. docs(dev_v2_filter): 整理架构方案及新增后端角色权限接口文档 ⭐ 新增

  • 模块: 其他
  • 提交: cbbda2961b76(2026-10-09)
  • 涉及文件: .gitignore、README.md、docs/README.md、"docs/CRM\346\236\266\346\236\204\344\274\230\345\214\226\346\226\271\346\241\210V2.md" => "docs/dev_v2_filter/CRM\346\236\266\346\236\204\346\226\271\346\241\210.md"、"docs/Invoice\344\275\243\351\207\221\345\257\271\350\264\246\346\250\241\345\235\227\345\274\200\345\217\221\346\226\207\346\241\243.md" => "docs/dev_v2_filter/Invoice\344\270\216\345\210\260\350\264\246\346\265\201\346\260\264.md"、docs/dev_v2_filter/README.md、docs/dev_v2_filter/SHA256SUMS、docs/dev_v2_filter/http/admin-role-perms.http…等63个文件
  • 改动量: +85444行 / -1203行
  • 功能说明: 整理并统一维护 dev_v2_filter 的架构方案及后端角色权限接口文档,同时将本机临时工具记录排除在版本管理之外,便于团队查阅和协作。
+# 本机工具迁移与临时记录;版本资料统一放 docs/dev_v2_filter/ 并纳入 Git

119. feat(account): 优化新媒体账号关联资产管理逻辑 ⭐ 新增

  • 模块: 新媒体线索
  • 提交: bea6a50ebd78(2026-10-09)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/NewMediaAccountController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/newmedia/NewMediaAccountParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/newmedia/NewMediaAccountVo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/newmediaasset/NewMediaAccountAssetsTest.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/home/service/INewMediaEmailAccountRelService.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/home/service/INewMediaMobileAccountRelService.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/pub/home/service/impl/NewMediaEmailAccountRelServiceImpl.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/pub/home/service/impl/NewMediaMobileAccountRelServiceImpl.java
  • 改动量: +210行 / -51行
  • 功能说明: 优化了新媒体账号关联资产的查询与管理逻辑,确保关联信息及资产展示更加准确、有序。
-import java.util.Comparator;

120. feat(newmedia): 新增广电运营商枚举及平台账号唯一ID支持 ⭐ 新增

  • 模块: 新媒体线索
  • 提交: 65a6752cad27(2026-10-09)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/newmediaasset/NewMediaEmailRefVo.java
  • 改动量: +12行 / -0行
  • 功能说明: 新增新媒体邮箱引用信息中的记录 ID 和平台账号字段,用于识别不同平台账号并建立唯一关联。
+package com.hoolihome.crm.vo.newmediaasset;
+
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+@Data
+@Accessors(chain = true)
+public class NewMediaEmailRefVo {
+    private Integer id;
+    private String account;
+}

121. feat(newmedia): 新增广电运营商枚举及平台账号唯一ID支持 ⭐ 新增

  • 模块: 新媒体线索
  • 提交: acd211464d0d(2026-10-09)
  • 涉及文件: docs/sql/new_media_account_assets.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/NewMediaAccountController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/newmedia/NewMediaAccountParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/newmediaasset/NewMediaMobileParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/newmediaasset/NewMediaMobileService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/newmediaasset/NewMediaPaidToolService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/newmedia/NewMediaAccountVo.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/newmediaasset/NewMediaMobileItemVo.java…等13个文件
  • 改动量: +168行 / -64行
  • 功能说明: 新增手机号所属运营商选项,支持移动、联通、电信和广电四类运营商。平台账号同时支持使用唯一 ID 进行标识,便于准确关联和管理账号。
+-- 手机号运营商枚举NewMediaMobileCarrierEnum:1移动,2联通,3电信,4广电;字段carrier为INT。

122. feat(house): 支持新增床位类型并统一房间类型文本显示 ⭐ 新增

  • 模块: 房源/房型
  • 提交: 3dfc7dd9cd92(2026-10-09)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/enums/HouseRoomTypeEnum.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/UpdateHouseInfoParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/UpdateHouseInfoV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/vo/HouseInfoPlatformInfoV2Vo.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/vo/HouseLogVoBuilder.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-house/src/main/java/com/hoolihome/entity/house/HouseInfo.java
  • 改动量: +38行 / -7行
  • 功能说明: 支持在房屋管理中新增床位类型,并统一房间类型的文本展示,方便用户准确识别和选择房间类型。
+import com.hoolihome.erp.enums.HouseRoomTypeEnum;

123. feat(house): 优化房型价格列表只显示有效且完整报价 ⭐ 新增

  • 模块: 房源/房型
  • 提交: da893f87d270(2026-10-09)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseListRoomPriceTest.java
  • 改动量: +94行 / -1行
  • 功能说明: 房型价格列表现在只展示有效且信息完整的报价,过滤掉无效或报价不完整的数据,让用户看到的房价更加准确可靠。
-                vo.setRoomPriceList(buildRoomPriceList(rooms, allRentAttrMap));
+                vo.setRoomPriceList(buildAvailableRoomPriceList(rooms, allRentAttrMap));

124. feat(common): 附件回显功能支持新增 ⭐ 新增

  • 模块: 其他
  • 提交: a2525e35c35a(2026-10-09)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/build.gradle、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/common/provider/AttachmentTraceProvider.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/ApplicationMailController.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/QywxMessageController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/EvaluationService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/CrmLeadsService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseController.java…等19个文件
  • 改动量: +428行 / -15行
  • 功能说明: 新增附件回显能力,支持邮件、订单及企业微信消息中新增附件的识别与展示,并补充专项测试确保功能稳定。
+
+tasks.register('testAttachmentTrace', Test) {
+    enabled = true
+    useJUnitPlatform()
+    testClassesDirs = sourceSets.test.output.classesDirs
+    classpath = sourceSets.test.runtimeClasspath
+    filter {
+        includeTestsMatching 'com.hoolihome.common.provider.AttachmentTraceProviderTest'
+        includeTestsMatching 'com.hoolihome.erp.vo.RentalManualAttachmentTraceTest'
+        includeTestsMatching 'com.hoolihome.erp.service.PromotionAttachmentTraceTest'
+        includeTestsMatching 'com.hoolihome.erp.service.CommissionArrivalLedgerServiceTest'
+        includeTestsMatching 'com.hoolihome.erp.service.HouseV2LandlordRelationsTest'
+    }
+    systemProperty 'user.timezone', 'Asia/Shanghai'
+}

125. fix(mdy): 工作微信号使用人改为单选平台用户 🐛 修复

  • 模块: PDF生成
  • 提交: 11ad14274e92(2026-10-09)
  • 涉及文件: docs/sql/new_media_account_assets.sql、docs/sql/new_media_wechat_single_user.sql、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/service/mdy/dto/MdyNewMediaWechat.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/service/mdy/executor/impl/MdyNewMediaWechatExecutor.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/test/java/com/hoolihome/data/service/mdy/NewMediaAccountAssetsTest.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/entity/home/NewMediaWechat.java
  • 改动量: +80行 / -12行
  • 功能说明: 工作微信号的使用人改为从平台用户中选择单个用户,并保存该用户的平台用户编号;工具的使用人仍支持多个用户并以去重后的用户列表保存。系统同时兼容已有工作微信号数据,部署时自动增加字段并回填历史使用人。
+-- 工作微信号使用人user_id为单选,保存INT平台用户ID;工具使用人仍保存去重后的用户ID JSON数组。
+-- 若已创建旧版工作微信号表,部署前执行new_media_wechat_single_user.sql增加user_id并回填历史单选使用人。

126. feat(mdy): 同步新媒体邮箱、手机号、工作微信和付费工具 ⭐ 新增

  • 模块: PDF生成
  • 提交: afaf3db59404(2026-10-09)
  • 涉及文件: docs/sql/new_media_account_assets.sql、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/build.gradle、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/mdy/MdyAppManger.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/mdy/jo/BaseMdyObj.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/service/mdy/MdyGenerator.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/service/mdy/MdyObjInitService.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/service/mdy/dto/MdyNewMediaEmail.java、hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/service/mdy/dto/MdyNewMediaMobile.java…等44个文件
  • 改动量: +3006行 / -1行
  • 功能说明: 该功能将明道云中的新媒体邮箱、手机号、工作微信和付费工具资产同步到 HooliHome,并按确认的字段规则落库。同步时会统一转换部门、运营商及人员关联信息,发现真实成员无法匹配、关联对象缺失或单选关联异常时终止同步,避免写入不完整或错误数据。
+-- 新媒体账号资产:仅明道云 -> HooliHome,按2026-10-09确认的字段清单落库。
+-- 本DDL替换尚未上线的初版建表脚本;若已执行初版,需单独迁移表结构及历史关联后部署。
+-- 不包含APP应用商店、产研账号、可见部门/成员、自动编号、微信实名归属人、工具关联新媒体平台。
+-- rowid仅用于本记录的同步定位;人员、关联对象列及关联表均只保存Hooli ID。
+-- 创建人/修改人通过明道云accountId映射平台用户。空成员及系统API/工作流操作者无人员ID。
+-- 非空真实成员无法匹配、关联对象未同步、单选关联返回多个值时抛错,不回写同步成功。
+-- 手机号使用人user_id、身份证归属人identity_owner_id为单选,保存INT平台用户ID。
+-- 微信使用人、工具使用人保存去重后的用户ID JSON数组。
+-- 邮箱/手机号使用部门统一枚举NewMediaAssetDepartmentEnum:1产研,2新媒体,3运营;字段department为INT。
+-- 手机号运营商枚举NewMediaMobileCarrierEnum:1移动,2联通,3电信;字段carrier为INT。
+-- 邮箱负责人单选responsible_id;邮箱/微信/工具的手机号单选mobile_id。
+-- 邮箱-账号、手机号-账号使用独立关联表;手机号-工具为一对多,由工具mobile_id反查。
+-- 手机号mobile保存号码、mobile_prefix保存带+的国家区号;无显式区号时区号为空,保留号码前导零。
+-- 原手机号-工具关联表不再使用,避免与工具mobile_id重复存储及双向同步依赖。
+-- 主表与关联表在同一事务中更新,源表空值清空对应字段及关联。

127. refactor(auth): 角色权限由菜单改为perms管理 ♻️ 重构

  • 模块: 系统管理
  • 提交: 13b521a10de0(2026-10-08)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/admin/service/AdminRolePermsTest.java
  • 改动量: +155行 / -0行
  • 功能说明: 角色权限的绑定与校验逻辑改为通过权限标识(perms)管理,不再依赖菜单。新增测试验证角色权限及用户角色关系的保存结果。
+package com.hoolihome.admin.service;
+
+import com.baomidou.mybatisplus.core.conditions.Wrapper;
+import com.hoolihome.admin.params.RoleParam;
+import com.hoolihome.entity.platform.PlatformRole;
+import com.hoolihome.entity.platform.PlatformRolePerm;
+import com.hoolihome.entity.platform.PlatformUserRole;
+import com.hoolihome.platform.service.*;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+
+import java.util.List;
+import java.util.Set;
+

128. refactor(auth): 角色权限由菜单改为perms管理 ♻️ 重构

  • 模块: 系统管理
  • 提交: f4e959b5afd4(2026-10-08)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/controller/AdminMenuController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/controller/AdminRoleController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/params/MenuParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/params/MenuSortParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/params/RoleParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/service/AdminMenuService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/service/AdminRoleService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/vo/MenuVo.java…等24个文件
  • 改动量: +411行 / -48行
  • 功能说明: 角色授权不再依赖菜单配置,而是改为按权限标识(perms)进行管理;菜单由前端维护,用户权限通过 /admin/role/user-perms 获取。
+ * @deprecated 菜单由前端维护;角色授权改用 perms,用户权限使用 /admin/role/user-perms。
+ */
+@Deprecated

129. feat(house): 支持公寓佣金、政策及活动的关联管理 ⭐ 新增

  • 模块: 房源/房型
  • 提交: 65290bfa5a25(2026-10-08)
  • 涉及文件: docs/sql/commission_invoice.sql、docs/sql/commission_invoice_rel_order.sql、docs/sql/crm_leads_payment_group_fields.sql、docs/sql/crm_qywx_todo_relation_migrate.sql、docs/sql/house_image_floor_building.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/todo/TodoVo.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseV2Controller.java…等13个文件
  • 改动量: +159行 / -94行
  • 功能说明: 新增公寓佣金、政策与活动之间的关联管理能力,便于统一维护相关业务信息和对应关系。配套数据库脚本包含历史迁移内容,上线前需根据现有表结构逐项审核执行。
+-- 历史累积脚本,禁止作为本轮上线入口整文件执行或使用 --force 跳过错误。
+-- 全新库使用 release_dev_v2_filter/01_invoice_fresh_schema.sql;已有表须逐项审核差异。

130. refactor(home): 优化群主名称查询及群信息展示 ♻️ 重构

  • 模块: 其他
  • 提交: bb31587e45bb(2026-10-05)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/home/HomeUserBizService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/home/HomeUserInfoVo.java
  • 改动量: +58行 / -6行
  • 功能说明: 优化群主名称的查询逻辑,提升群主信息获取效率;同时调整群信息的展示与转换处理,使相关群信息能够更准确、清晰地呈现。
+import cn.hutool.core.date.DateUtil;
+import cn.hutool.json.JSONUtil;

131. feat(home): 批量填充企业微信客户及群列表,优化查询避免N+1问题 ⭐ 新增

  • 模块: CRM/销售
  • 提交: 80516cd85c62(2026-10-05)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/home/HomeUserBizService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/home/HomeUserItemVo.java
  • 改动量: +149行 / -3行
  • 功能说明: 首页现在可以批量填充企业微信客户和群列表,避免逐条查询带来的性能问题。
    这样能减少页面加载时的重复数据访问,提升客户及群列表的展示效率。
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.Set;

132. fix(sql): 楼层图迁移加固——关联表非空时兜底回填 floor_name/display_sort 🐛 修复

  • 模块: 其他
  • 提交: e216cf751da6(2026-10-04)
  • 涉及文件: docs/sql/house_image_floor_building.sql
  • 改动量: +29行 / -1行
  • 功能说明: 楼层图迁移时,若关联表已有数据,将自动从楼层主表补全楼层名称和展示排序,避免出现“未命名楼层”或排序为 0 的异常数据。关联表为空时该处理不会产生影响。
+-- ============ 阶段二.0:兜底回填(关联表非空的环境,如测试库;生产库关联表为空则为无副作用空操作)============
+-- 背景:若关联表在本脚本前已由早期版本写入过 (floor_id, building_id) 行(当时无 floor_name/display_sort 列),
+-- 则阶段一 ALTER ADD 会把既有行 floor_name 置 ''、display_sort 置 0,而上面的 INSERT IGNORE 因唯一键冲突跳过这些行,
+-- 导致既有行 floor_name 空(前端显示「未命名楼层」)、display_sort=0。以下两步从主表兜底回填。
+-- 0a. 回填空楼层名(主表 floor_name 为权威来源;主表本身为空的行保持空,属正常)
+UPDATE `house_image_floor_building` b
+JOIN `house_image_floor` f ON f.`id` = b.`floor_id`
+SET b.`floor_name` = f.`floor_name`
+WHERE (b.`floor_name` = '' OR b.`floor_name` IS NULL)
+  AND f.`floor_name` IS NOT NULL AND f.`floor_name` <> '';
+
+-- 0b. 重播 display_sort=0 的行(此时归一化尚未执行,主表 floor_sort 仍为原值,按其排序可保留原楼内顺序)
+UPDATE `house_image_floor_building` b
+JOIN (
+    SELECT bb.`id`,

133. refactor(house-building): relation/delete 改为 relationId(Long)+type(1/2) 删除模式 ♻️ 重构

  • 模块: 房源/房型
  • 提交: 8f256ee529cc(2026-10-04)
  • 涉及文件: 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/params/RelationDeleteParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseBuildingService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseBuildingServiceTest.java
  • 改动量: +73行 / -96行
  • 功能说明: 解除楼栋与楼层图的关联时,支持两种方式:仅移除当前楼栋的关联,或删除整张楼层图在当前公寓下所有楼栋的关联。关联清空后,系统会自动删除对应的楼层图及主表图片记录。
-     * 解除关联(批量 + 范围):scope=current 只移除传入关联(各自对应楼栋,不影响其他楼栋);
-     * scope=all 移除这些关联所属楼层图的全部楼栋关联(删整图)。关联清空的图级联删除。
+     * 解除关联:type=1 仅移除当前楼栋关联(不影响其他楼栋,关联清空则级联删图);
+     * type=2 删除整图所有关联(该图在当前公寓下所有楼栋,级联删主表图片行)。
-     * @param param relationIds、scope(current/all,默认 current)
+     * @param param relationId、type(1=仅当前楼栋;2=整图所有关联)
-        houseBuildingService.deleteFloorRelations(param.getRelationIds(), param.isAllScope());
+        houseBuildingService.deleteFloorRelation(param.getRelationId(), param.getType());

134. feat(house-building): relation/delete 支持批量 relationIds + scope(current/all) ⭐ 新增

  • 模块: 房源/房型
  • 提交: 2ec61e5d3e15(2026-10-04)
  • 涉及文件: 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/params/RelationDeleteParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseBuildingService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseBuildingServiceTest.java
  • 改动量: +130行 / -40行
  • 功能说明: 房屋建造模块的关联删除功能现在支持一次批量删除多个关联关系,并可选择仅删除当前关联,或删除全部相关关联。
+import com.hoolihome.erp.params.RelationDeleteParam;

135. fix(image): 解决 avif 格式图像处理兼容性问题 🐛 修复

  • 模块: 其他
  • 提交: ced239a7b006(2026-10-04)
  • 涉及文件: hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/common/controller/MediaPreviewController.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/pub/vo/ImageVo.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/utils/file/FileVoFactory.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/utils/file/ImageProcessAction.java
  • 改动量: +124行 / -13行
  • 功能说明: 完善了 AVIF 图片的预览与处理兼容能力,用户可正常查看并获取相关图片信息,避免因格式不受支持而出现处理失败。
+import com.hoolihome.utils.file.ImageProcessAction;

136. fix(house-building): 迁移归一化 floor_sort + 排序/关联入参完整性校验 🐛 修复

  • 模块: 房源/房型
  • 提交: 7efdc333caed(2026-10-04)
  • 涉及文件: docs/sql/house_image_floor_building.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseBuildingService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/HouseBuildingServiceTest.java
  • 改动量: +66行 / -7行
  • 功能说明: 统一并清洗楼层排序数据,将楼层展示顺序迁移至统一的标准尺度,避免异常排序值影响展示。通过幂等方式补全楼层与楼盘的关联关系,并对排序及关联参数进行完整性校验,确保重复执行不会产生脏数据或重复关联。
+-- ============ 阶段二:回填关联表(全量 8597 行)============
+-- 幂等:INSERT IGNORE 依赖 uk_building_floor,误重跑时既有行被跳过(display_sort 由 ROW_NUMBER 确定性生成,重跑值一致)。
-INSERT INTO `house_image_floor_building` (`floor_id`, `building_id`, `floor_name`, `display_sort`)
+INSERT IGNORE INTO `house_image_floor_building` (`floor_id`, `building_id`, `floor_name`, `display_sort`)
+-- ============ 阶段二.1:归一化主表 floor_sort 到 display_sort 同标度(关键)============
+-- 生产实测 floor_sort 为脏值(min=-2、max=1234567890、79 行非整数);display_sort 已按 (floor_sort,id) 重播为 1..N,
+-- 二者相对顺序一致。此处把主表 floor_sort 对齐到 display_sort,使「未改动的客户端 listClientHouseImage 按 floor_sort 排序」
+-- 与关联表 display_sort 同源;否则迁移后真实楼栋首次 /add 追加(max+10)时,新图在客户端会被插到既有图中间。
+-- 迁移时每张图仅一条关联(1:1),JOIN 无歧义。
+UPDATE `house_image_floor` f
+JOIN `house_image_floor_building` b ON b.`floor_id` = f.`id`
+SET f.`floor_sort` = b.`display_sort`;
+
+-- 期望:floor_cnt = rel_cnt = rel_distinct_floor = 8597;sentinel=4056;real=4541;mismatch=0
-       (SELECT SUM(building_id <> 0) FROM house_image_floor_building)    AS real_cnt;

137. feat(house-building): 楼层图多楼栋共享模型(关联表承载 floor_name/display_sort + 双写 legacy) ⭐ 新增

  • 模块: 房源/房型
  • 提交: 093b7d3f2410(2026-10-04)
  • 涉及文件: 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/params/AddFloorParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/BuildingFloorItem.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/FloorSortItemParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/RelationUpdateParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/SortFloorParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/UpdateFloorImageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseBuildingService.java…等11个文件
  • 改动量: +659行 / -239行
  • 功能说明: 支持同一楼层图模型被多个楼栋共用,并允许各楼栋单独设置楼层名称和展示顺序。调整楼层信息时会同步更新旧版数据,确保新旧功能数据一致。
-import cn.hutool.core.util.StrUtil;
-import com.alibaba.fastjson.JSON;
+import com.hoolihome.erp.params.RelationUpdateParam;
+import com.hoolihome.erp.params.UpdateFloorImageParam;
-import com.hoolihome.pub.dto.ImageFileDTO;

138. refactor(house): 移除公寓模块动态查询与导出功能,切换至普通查询参数 ♻️ 重构

  • 模块: 房源/房型
  • 提交: e17b1e82dd11(2026-10-03)
  • 涉及文件: "docs/\345\212\250\346\200\201\346\237\245\350\257\242\347\263\273\347\273\237API\346\226\207\346\241\243.md"、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/HouseV2Controller.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/export/HouseExportRow.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/export/HouseExportService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/HousePageListV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/query/provider/HouseQueryConfigProvider.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/HouseV2Service.java
  • 改动量: +252行 / -452行
  • 功能说明: 公寓模块不再支持动态条件查询和导出,相关查询与导出改用常规请求参数处理。系统可查询的模块数量由 20 个调整为 19 个。
-所有 `QueryConfigProvider` 实现由 Spring 自动收集并按 `getModuleKey()` 注册。截至当前共 **20 个模块**:
+所有 `QueryConfigProvider` 实现由 Spring 自动收集并按 `getModuleKey()` 注册。截至当前共 **19 个模块**:

139. feat(distributor): 新增合作状态分布统计接口与参数对象 ⭐ 新增

  • 模块: 合作方
  • 提交: f46c2e1fac5e(2026-10-02)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/DistributorCompanyController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/DistributorUserController.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/main/java/com/hoolihome/crm/vo/DistributorStatisticsVo.java
  • 改动量: +193行 / -0行
  • 功能说明: 新增合作状态分布统计功能,支持按指定条件查询各合作状态的分布情况,并返回对应的统计结果。
+import com.hoolihome.crm.params.DistributorStatisticsParam;

140. feat(landlord): 支持供应商合同统计范围scope控制 ⭐ 新增

  • 模块: 房东管理
  • 提交: 961a1a2c6110(2026-10-01)
  • 涉及文件: hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/LandlordController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/LandlordContractExpireStatisticsParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/LandlordPageListParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/LandlordService.java
  • 改动量: +50行 / -10行
  • 功能说明: 供应商合同统计新增 scope 范围控制:传入 1 时仅统计当前用户负责的供应商,未传或传入 2 时按数据权限统计本人及下级数据,超管可查看全部。未传 scope 时仍沿用原有按业务负责人列表过滤的行为。
+    /**
+     * 供应商分页列表。scope 控制统计范围(与 Invoice 一致):1=仅本人(bd_id=当前用户),
+     * 2/未传=数据权限(本人+下级,超管全部);未传 scope 时维持原有行为(仅按 bdIdList 过滤)。
+     */

📊 本月工作总结

【核心成果】本月完成140次功能提交,重点推进房源租期、CRM线索、佣金到账与企微协同能力升级。同步完善搜索筛选、新媒体账号、PDF及数据导出等模块,并落地到账通知、合作方业务量统计、佣金批量调整等经营功能。

【技术亮点】重构租期规则与旧版App兼容逻辑,通过数据库规则和测试覆盖保障一致性;优化申请表与商机同步防死锁、线索池批量关联降查询次数。强化企微拆分分配、到账账单筛选、素材模糊搜索及视频水印画质保持,并补充关键单元测试。

【业务价值】打通“线索—申请—订单—收款—开票”链路,提升销售协同、线索转化和财务对账效率。增强渠道运营分析及多维检索能力,为规模化获客和精细化经营提供支撑。

报告生成时间:2026-11-01 08:03