weekly-2026-W43
周报 · 2026年第43周(10月19日-10月25日)
姓名: 邓星星(dengxingxing)
项目: hoolihome-project
分支: production
提交数: 45个(含42个功能提交、2个Merge提交)
统计周期: 2026-10-19 ~ 2026-10-23(合并自 dev_v2_filter 分支发布 + production 直提)
📋 本周工作汇总
按日期统计
| 日期 | 提交数 | 主要内容 |
|---|---|---|
| 10/19 周日 | 2 | 收款单迁移上线前只读检查脚本;订单佣金口径统一与详情展示逻辑 |
| 10/20 周一 | 6 | 订单评价体系重构(独立页面/匿名提交/加密链接/附件上传);供应商 API 租期同步优化;商机列表企微客户展示 |
| 10/21 周二 | 15 | 动态查询与导出框架下线(-8218行);增量接口显式 null 支持;供应商金额 null 化;房型批量编辑;企微 AI 概率回写商机;提现日期限制临时放开与恢复 |
| 10/22 周三 | 11 | 商机与企微客户/群绑定解绑;AI 预填多客户需求识别;供应商代码唯一性校验与发票编号优化;发票文件路径防覆盖;二代公寓国家限制暂缓 |
| 10/23 周四 | 11 | 到账通知功能;直播水印新规则与原分辨率转码;新媒体账号搜索增强;企微消息星标;房源 API 同步状态字段;权限判断修正 |
按模块统计
| 模块 | 提交数 |
|---|---|
| 订单评价体系 | 8 |
| 商机与 CRM | 6 |
| 订单财务与收款单 | 4 |
| 房源与房型 | 4 |
| 新媒体账号 | 4 |
| 企微消息与 AI | 3 |
| 发票与供应商 | 3 |
| 上线迁移与文档 | 3 |
| 数据同步与增量接口 | 2 |
| 直播水印视频 | 2 |
| 钱包提现 | 2 |
| 权限与账号解析 | 2 |
| 查询框架重构(下线) | 1 |
| 到账通知 | 1 |
🛠 详细工作内容
一、订单评价体系重构(8 个提交)⭐ 本周主线
1. feat(order-comment): 新增客户公寓评价邀请及链接生成功能 ⭐ 新增
- 提交:
c864ff9f46(2026-10-20) - 改动量: +434行 / -3行,涉及 9 个文件
- 涉及文件:
OrderController.java、OrderHouseCommentShareParam.java、OrderHouseCommentService.java、OrderHouseCommentInfoVo.java、OrderHouseCommentFlowTest.java、ApiSupplierHttp.java、UnilodgeSyncService.java - 功能说明: 在 CRM 订单控制器新增
house-comment/share-url接口,顾问可对指定订单生成邀请客户填写公寓评价的小程序链接。接口不另设编辑权限或财务状态门槛,而是复用订单列表的ordinaryQueryService.filters(query)数据可见范围查询,确保只有对该订单有可见权的顾问才能拿到链接;platformUserId与订单 ID 均做非空/正值校验,异常统一返回ResVo.resErr。同时同步改造供应商 HTTP 客户端(ApiSupplierHttp、UnilodgeSyncService),使评价邀请链路与供应商数据获取共用同一套传输层。
// OrderController.java
@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("订单不存在或无权访问");
2. feat(order-comment): 新增独立订单评价页面及匿名提交功能 ⭐ 新增
- 提交:
e420a8ab56(2026-10-20) - 改动量: +706行 / -367行,涉及 15 个文件
- 涉及文件:
OrderCommentService.java(+240)、OrderCommentFlowTest.java(+233)、OrderCommentPublicController.java(+32)、OrderCommentPresentationService.java(+35)、OrderCommentInfoVo.java(+26)、OrderCommentPublicParam.java(+24)、UserApiConfiguration.java - 功能说明: 将原先寄生在 CRM 模块内的评价能力(
OrderHouseCommentService/OrderHouseCommentInfoVo,共 98 行)整体下沉到hoolihome-crm-common-service的biz.order领域层,新增 240 行OrderCommentService承载评价核心逻辑;在hoolihome-user-api新增OrderCommentPublicController开放匿名评价接口(+32 行),使评价页可免登录访问。VO 字段由houseCommentInfo重命名为统一的commentInfo,并补充application.yml中评价页地址配置项。Gradle 侧新增隔离测试任务testOrderComment,只跑评价相关用例并固定Asia/Shanghai时区,避免污染其他模块的构建。
3. refactor(order-comment): 使用加密订单标识替换明文ID实现评价链接安全访问 ♻️ 重构
- 提交:
a706f86013(2026-10-20) - 改动量: +140行 / -78行,涉及 12 个文件
- 涉及文件:
OrderCommentCode.java(+45,新建)、OrderCommentPublicParam.java、OrderCommentService.java、application-dev.yml/application-pro.yml/application.yml - 功能说明: 引入
OrderCommentCode加密工具类,评价链接不再明文携带订单 ID,改为携带加密后的code,从根源上避免链接被遍历或猜解导致的信息泄露。同时删除 CRM 侧基于明文 ID 的分享入口(OrderController.houseCommentShareUrl移除 20 行、OrderHouseCommentShareParam删除 12 行),将链接生成职责收拢到公共领域层;各环境配置文件(dev/pro/application)统一补充评价页page-url与加密开关配置。
// OrderCommentCode.java(新增)
public final class OrderCommentCode {
// 加密订单标识,评价链接只携带 code,不暴露明文订单ID
}
4. refactor(order-comment): 按评价类型拆分公寓和服务评价逻辑 ♻️ 重构
- 提交:
c8a9e446a5(2026-10-20) - 改动量: +182行 / -126行,涉及 7 个文件
- 涉及文件:
OrderCommentService.java、OrderCommentInfoVo.java、OrderCommentPresentationService.java、OrderCommentPublicParam.java - 功能说明: 评价体系从"单链接单评价"升级为"单链接双评价"——公寓评价与服务评价拆分为两个独立 URL,VO 由单一
url字段扩展为houseCommentUrl/serviceCommentUrl/houseRequired三个字段,并新增isHouseRequired()判定逻辑区分服务评价是否强制包含公寓评价。URL 生成方法签名由url(Long orderId)改为url(Long orderId, int commentType),在加密 code 后追加commentType参数,前端据此路由到对应评价表单。
// OrderCommentPresentationService.java
- 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=" + commentType;
5. feat(order-comment): 重构订单评价接口以支持多媒体与匿名功能 ⭐ 新增
- 提交:
8643dc7d25(2026-10-21) - 改动量: +252行 / -45行,涉及 7 个文件
- 涉及文件:
OrderCommentService.java(+100)、OrderCommentFlowTest.java(+101)、OrderCommentInfoVo.java(+21)、OrderCommentPublicParam.java(+22) - 功能说明: 评价数据结构由通用
Evaluation拆分为HouseEvaluation/ServiceEvaluation两个专用内部类:公寓评价新增commentLevel评分维度与服务评价新增serviceScore评分维度,字段命名与业务语义对齐;公共参数对象扩展以支持多媒体附件、匿名提交、评分项与评语分离,并引入IRoomInfoService/IPlatformUserService以在评价接口内补齐房型与平台用户信息。
6. feat(order-comment): 实现订单评价附件独立上传签名及验证功能 ⭐ 新增
- 提交:
dfee7b4143(2026-10-21) - 改动量: +536行 / -43行,涉及 10 个文件
- 涉及文件:
OrderCommentUploadStorage.java(+110)、OrderCommentUploadService.java(+103)、OrderCommentUploadStore.java(+35,新建)、OrderCommentUploadParam.java(+15)、OrderCommentPublicController.java - 功能说明: 新增
upload-policy接口,采用"服务端签发上传授权 + 客户端直传 + 服务端验签"的安全上传模式:OrderCommentUploadService负责生成带有效期的上传凭证(Grant),OrderCommentUploadStorage负责构造对象存储路径与访问 URL(order-comment/{uuid}.{ext}),OrderCommentUploadStore抽象凭证持久化以支持后续落库。附件不经过应用服务器中转,既降低带宽压力也避免评价正文被劫持。
// OrderCommentPublicController.java
@PostMapping(value = "upload-policy", consumes = MediaType.APPLICATION_JSON_VALUE)
public ResVo uploadPolicy(@RequestBody OrderCommentUploadParam request) {
return execute(() -> comments.uploadPolicy(request));
}
7. feat(order-comment): 增强附件实际格式校验和配置管理 ⭐ 新增
- 提交:
a901e90738(2026-10-21) - 改动量: +127行 / -22行,涉及 8 个文件
- 涉及文件:
OrderCommentUploadStorage.java、OrderCommentUploadService.java、application-beta.yml、application-test.yml、OrderCommentUploadTest.java(+38) - 功能说明: 附件校验从"看扩展名"升级为"校验真实文件格式"——上传时读取文件头魔数判断实际类型,防止把可执行文件伪装成图片/视频;同时把评价页地址从硬编码默认值改为各环境显式配置(beta 用
betawww.hoolihome.com,test 用testwww.hoolihome.com,生产由application-pro.yml覆盖),并同步收紧测试断言为精确 URL 比对。
order:
comment:
# 默认使用测试站点;生产环境由application-pro.yml覆盖。
page-url: http://betawww.hoolihome.com/order-comment
8. test(order-comment): 完善订单评论相关单元测试并修正销售用户信息显示 🧪 测试
- 提交:
fa5346c5e9(2026-10-22) - 改动量: +18行 / -4行,涉及 2 个文件
- 涉及文件:
OrderCommentFlowTest.java、OrderCommentService.java - 功能说明: 修复隐私泄露隐患——评价页对外展示顾问信息时原先直接输出
user.getUserName()(真实姓名),改为只输出别名getAlias(),并新增断言"别名缺失时不得回退到真实姓名",防止在匿名评价页泄露员工真实姓名;订单号展示口径同步修正为使用申请单 ID。
- var adviserInfo = adviser == null ? null : Dict.create().set("userName", adviser.getUserName())
+ var adviserInfo = adviser == null ? null : Dict.create().set("userName", adviser.getAlias())
- var orderInfo = Dict.create().set("orderCode", c.order.getOrderCode())
+ var orderInfo = Dict.create().set("orderCode", c.form.getId().toString())
二、商机与 CRM(6 个提交)
9. feat(crm): 增加商机与企业微信群及客户绑定解绑功能 ⭐ 新增
- 提交:
6a6f4e1799(2026-10-22) - 改动量: +1552行 / -132行,涉及 28 个文件
- 涉及文件:
CrmLeadsService.java(+158)、QywxMsgSyncStore.java(+108,新建)、QywxMsgSyncService.java(+77,新建)、QywxMsgContentRetry.java(+74,新建)、QywxMsgHandler.java、QywxMsgService.java、LeadsController.java(+33)、LeadsQywxBindingParam.java(+14,新建)、qywx_message_sync_state.sql(+39,新建)、LeadsQywxBindingTest.java(+462,新建) - 功能说明: 本周最大体量提交。在商机侧增加与企微客户、企业微信群的绑定与解绑能力(
LeadsController新增绑定接口、CrmLeadsService增加 158 行绑定逻辑)。更关键的是重构了企微消息拉取链路:原先依赖 RedismsgMaxSeq维护增量游标,本次改为落库到qywx_msg_sync_state表(记录last_seq、run_id、lease_until、status、分页/拉取/保存/重复/忽略计数等),引入数据库租约机制防止多实例并发拉取,同时新增QywxMsgContentRetry处理内容解析失败重试、QywxMsgSyncStore抽象状态存储。表结构注释明确要求"发布新拉取代码前先建表、切换时停用旧版入口,避免旧版绕过数据库租约"。
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',
...
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
10. feat(crm): 补齐申请订单企微客户展示和商机绑定筛选 ⭐ 新增
- 提交:
bd69093113(2026-10-22) - 改动量: +172行 / -11行,涉及 11 个文件
- 涉及文件:
ApplicationFormService.java、OrderService.java、LeadsPageQueryService.java(+11,新建)、LeadsPageQuery.java(+2)、LeadsQywxCustomerTest.java(+65) - 功能说明: 在申请单列表、订单列表、订单详情中补充"企微客户"字段展示——通过新增的
LeadsQywxCustomerService.getMapByLeadsIds(leadsIds)批量按商机 ID 装配企微客户信息,避免逐条查询造成的 N+1。同时在商机列表新增customerBinding筛选参数(1已绑定有效客户 / 2未绑定有效客户),并把逐条parseList改为parseListBatch批量装配,降低列表接口的查询次数。
/** 企微客户绑定状态:1已绑定有效客户,2未绑定有效客户;不传/null不筛选 */
private Integer customerBinding;
11. feat(leads): 支持创建商机时绑定企业微信客户和微信群 ⭐ 新增
- 提交:
24af9c3f08(2026-10-22) - 改动量: +446行 / -2行,涉及 10 个文件
- 涉及文件:
HouseListCountryScope.java(+55)、CrmLeadsService.java(+33)、CrmLeadsParam.java(+7)、LeadsCreateQywxBindingTest.java(+170,新建) - 功能说明: 商机创建参数扩展
externalUserId(企微客户ID)与qywxGroupId(企微群ID),创建商机时即可完成绑定。绑定前校验操作人必须是企微员工——若当前操作人未关联企微员工则直接抛出IllegalArgumentException("当前操作人未关联企业微信员工,无法绑定企微客户!"),再通过IQywxFollowUserService.getByUserId(contactId, externalUserId)查找客户跟进关系,确保绑定的客户必须属于该员工。
if (StrUtil.isNotBlank(param.getExternalUserId())) {
if (createUser == null || StrUtil.isBlank(createUser.getQywxContactId())) {
throw new IllegalArgumentException("当前操作人未关联企业微信员工,无法绑定企微客户!");
}
customerFollow = qywxFollowUserService.getByUserId(createUser.getQywxContactId(), param.getExternalUserId());
}
12. feat(leads): 优化商机列表增加企微客户显示及测试支持 ⭐ 新增
- 提交:
62f7f4dc5f(2026-10-20) - 改动量: +192行 / -4行,涉及 3 个文件
- 涉及文件:
LeadsQywxCustomerService.java(+58,新建)、CrmLeadsService.java(+14)、LeadsQywxCustomerTest.java(+120,新建) - 功能说明: 新建
LeadsQywxCustomerService统一封装商机→企微客户的映射装配,商机列表与详情统一挂载qywxCustomer节点。由于本周(10/20)AI 概率回写链路尚未就绪,先用固定联调数据占位(DEBUG_CLOSING_PROBABILITY = 80),并在代码注释中明确标注"前端联调临时测试数据;后续由 AI 群消息总结维护商机预估后,恢复读取持久化字段",10/21 的16a50cbf5d完成真实回写后随即改回读取持久化字段。
// 前端联调临时测试数据;后续由 AI 群消息总结维护商机预估后,恢复读取持久化字段。
private static final int DEBUG_CLOSING_PROBABILITY = 80;
13. feat(crm-ai): 优化多客户需求识别与字段提取逻辑 ⭐ 新增
- 提交:
2cb8619fb6(2026-10-22) - 改动量: +317行 / -28行,涉及 11 个文件
- 涉及文件:
LeadsAiPrefillEvidence.java(+56)、LeadsAiPrefillService.java(+42)、LeadsAiPrefillClient.java(+11)、LeadsAiPrefillEvidenceTest.java(+24) - 功能说明: 优化商机 AI 预填的证据提取层:从单客户需求假设改为支持同一会话中多个潜在客户的识别,扩展
LeadsAiPrefillEvidence以承载多候选客户及其各自的字段证据,并新增LeadsAiPrefillAssociations负责把提取结果关联回具体客户/房源记录。同时更新发布核对文档,记录"167 张订单补申请与 2 张佣金类型限制"的梳理结论,明确"补不上申请不阻塞"的用户决策。
14. 修改:商机 AI 预填关联逻辑调整 + 发布资料整理
- 提交:
80a6e64a77(2026-10-22) - 改动量: +1115行 / -255行,涉及 14 个文件
- 涉及文件:
LeadsAiPrefillAssociations.java(+63/-34)、LeadsAiPrefillService.java(+30/-9)、上线清单.md(+133/-204)、SQL执行计划.json(+330,新建)、历史规则复核.sql(+118,新建)、发布核对/20261022/*(多份新建) - 功能说明: 延续 AI 预填工作,把关联解析逻辑抽出为独立类
LeadsAiPrefillAssociations并补充 61 行单测;同时大面积整理发布资料,新增《SQL执行计划.json》《历史规则与用户决定复核.md》《生产只读核对.md》等发布核对文档,并把《上线清单》重写为"上线执行清单",明确标注"已于 2026-10-22 16:54~17:04 完成生产只读核对,未执行任何生产 DDL/DML、未部署"。
三、订单财务与收款单(4 个提交)
15. feat(order-commission): 统一订单佣金口径及详情展示逻辑 ⭐ 新增
- 提交:
87aff86fc2(2026-10-19) - 改动量: +260行 / -114行,涉及 8 个文件
- 涉及文件:
OrderCommissionService.java(+66)、OrderController.java(+40)、FeeOrderController.java(+12)、OrderInfoMapper.java(+8)、OrderReceiptAssociationTest.java(+105/-69) - 功能说明: 统一全链路佣金口径:有效佣金收款单取汇总,否则历史订单回退原账面数据、新订单显示无佣金;金额仅在新订单提交主管审核时计算落库,所有历史订单(含已关联状态3)保留账面金额不变。新旧订单判定不再依赖"关联枚举",而是读取迁移控制记录的
completed_at首次切换时间点与订单create_time比较——创建时间缺失或早于切换点的一律按历史订单处理,同秒边界用备份表order_info_receipt_backup是否存在该 ID 兜底核对。同时把收款单回显抽为可复用的toFeeOrderItems(records),订单详情直接复用已用于佣金汇总的记录,避免二次查询产生前后不一致。
/** 共用收款单回显;订单详情直接传入已用于佣金汇总的记录,避免再次查询产生不一致。 */
public List<FeeOrderItemVo> toFeeOrderItems(List<HomeFeeOrder> records) {
16. feat(order): 实现供应商金额显式null支持及相关接口改造 ⭐ 新增
- 提交:
5787695910(2026-10-21) - 改动量: +557行 / -30行,涉及 15 个文件
- 涉及文件:
SupplierCommissionAmountDeserializer.java(+46,新建)、OrderLandlordCommissionVo.java(+33,新建)、ForcedUpdateOrderParam.java(+28)、OrderFinancialClosingParam.java、OrderSubmitSupervisorParam.java、OrderService.java、ParamFilter.java(网关)、order_supplier_commission_nullable.sql(+36,新建) - 功能说明: 解决"供应商应收/实收佣金无法被清零"的问题——数据库层把
order_info.landlord_receivable_commission与landlord_actual_commission两列改为可空(DDL 脚本从 information_schema 读取真实类型与注释并原样保留,检查不通过则 PREPARE 报错停止);应用层新增SupplierCommissionAmountDeserializer自定义反序列化器,把 JSON 中显式传入的null与"字段未传"区分开,从而支持把金额主动清空而不被误判为"不修改"。网关ParamFilter同步改造以保留 null 语义。
17. feat(order): 支持收款单展示关联正常订单简要信息 ⭐ 新增
- 提交:
3f960a83a2(2026-10-21) - 改动量: +97行 / -23行,涉及 6 个文件
- 涉及文件:
SimpleOrderVo.java(+30,新建)、BaseFeeOrderVo.java、FeeOrderVoMapper.java、CrmFeeOrderService.java - 功能说明: 收款单 VO 原先只平铺
orderId/orderCode两个字段,本次改为嵌套SimpleOrderVo orderInfo结构,携带订单状态;orderInfo显式标注@JsonInclude(JsonInclude.Include.ALWAYS)保证无关联订单时也返回 null 而非被序列化器省略,前端无需区分"字段缺失"与"值为空"。查询侧补充OrderInfo.ORDER_STATUS字段,并继续排除已取消订单。
18. refactor(feeOrder): 重构商机相关字段,优化订单信息关联 ♻️ 重构
- 提交:
b987302f07(2026-10-21) - 改动量: +18行 / -21行,涉及 3 个文件
- 涉及文件:
FeeOrderController.java、BaseFeeOrderVo.java、FeeOrderRelationsTest.java - 功能说明: 收款单 VO 中的
leadId/leadCustomerName两个平铺字段收拢进leadInfo子对象,方法fillBriefRelations更名为fillOrderInfo明确职责,同时删除与订单信息重复的字段,保持收款单展示结构与"订单信息"语义一致。
四、房源与房型(4 个提交)
19. refactor(house): 优化供应商关联更新逻辑,支持切换供应商时清除旧关联 ♻️ 重构
- 提交:
b29533b202(2026-10-21) - 改动量: +311行 / -19行,涉及 6 个文件
- 涉及文件:
HouseV2Service.java(+51)、UpdateHouseLandlordRelationsParam.java、HouseV2Controller.java、HouseSupplierChangeTest.java(+242,新建) - 功能说明: 修复房源切换供应商时旧关联残留的缺陷。新逻辑:供应商发生变化时,先清除原佣金、退订政策、供应商活动三类旧关联,再保存本次选中的新供应商关联,且要求本次非空列表必须属于新供应商;供应商未变化时,保持原有语义——非空列表全量替换,未传/null/空列表表示不修改该项。三类 ID 列表参数由 JSON 数组字符串改为真正的 JSON 数组类型。
* 供应商变化时先清除三类旧关联,本次非空列表必须属于新供应商,再保存为新关联。
* 供应商未变化时,三个可选 ID 列表非空则全量替换;未传、null 或空列表表示不修改。
20. feat(room): 实现房型批量编辑及空值映射支持 ⭐ 新增
- 提交:
a8be46a7f8(2026-10-21) - 改动量: +265行 / -23行,涉及 6 个文件
- 涉及文件:
RoomV2Service.java(+54)、RoomV2Controller.java(+3/-18)、RoomInfoV2Vo.java、room_api_mapping_name_nullable.sql(+34,新建)、RoomNullBatchTransactionTest.java(+156,新建) - 功能说明: 为房型管理新增批量编辑能力,并支持
api_mapping_name供应商映射名称的显式 NULL(原先空字符串无法表达"清空映射")。数据库层通过 information_schema 读取真实 VARCHAR 长度/字符集/排序规则/注释后原样保留,只调整可空性与默认值,列不存在或元数据不完整时 PREPARE 直接报错停止。新增 156 行事务测试覆盖"批量编辑中显式 null 的落库"场景。
21. feat(house): 增加API同步状态和映射名称字段支持 ⭐ 新增
- 提交:
1cc18b6398(2026-10-23) - 改动量: +227行 / -1行,涉及 8 个文件
- 涉及文件:
UpdateHouseInfoV2Param.java(+16)、HouseV2Service.java(+13)、house_api_mapping_name_nullable.sql(+34,新建)、HouseApiSyncUpdateTest.java(+71,新建) - 功能说明: 公寓层面同步落地"API 同步状态 + 映射名称可置空"两项能力,与房型侧(
a8be46a7f8)形成一致的字段语义:新增house_info.api_mapping_name的可空 DDL(明确"不修改房型字段,也不清洗历史空字符串"),并在公寓更新接口中开放相关字段;同时补充tools/lease_cleanup_release.py及其 58 行测试的发布流程校验。
22. fix(house): 暂缓二代公寓业务国家限制功能 🐛 修复
- 提交:
9282d34f8f(2026-10-22) - 改动量: +128行 / -60行,涉及 10 个文件
- 涉及文件:
HouseListCountryScope.java(+1/-32)、HouseListCountryScopeTest.java、QywxScheduleService.java、HouseController.java、HouseV2Controller.java、CrmSendMessageService.java、ClientFeedbackController.java - 功能说明: 二代公寓业务的国家限制功能上线后引发线上问题,本次整体暂缓:
HouseListCountryScope移除 32 行国家过滤逻辑,同时在HouseController/HouseV2Controller/ClientFeedbackController/CrmSendMessageService/QywxScheduleService五个入口同步撤下相关调用,避免部分链路残留过滤行为。并在《线上服务依赖检查.md》中详细记录了当晚 21:02–22:02 的线上复核结论:House API 两实例共 80 次接口 ERROR(其中 73 次 NullPointerException,分布于详情/房型/附近房源三个入口),并通过匿名查询抽查验证"正常 ID 抽查通过、无效入口返回业务 code=1",明确"HTTP 200 掩盖了业务 code=1,网关无 5xx 不是无业务错误的证明"。
五、企微消息与 AI(3 个提交)
23. feat(qywx): 将AI聊天总结概率及理由同步到商机 ⭐ 新增
- 提交:
16a50cbf5d(2026-10-21) - 改动量: +300行 / -7行,涉及 8 个文件
- 涉及文件:
QywxChatSummaryProbability.java(+66,新建)、QywxChatSummaryTest.java(+120,新建)、CrmLeads.java(+12)、CrmLeadsService.java、QywxChatSummaryService.java - 功能说明: 把 AI 对企微聊天记录生成的"成交/成单概率预估"自动回写到商机表
crm_leads的closing_probability(0-100)与probability_reason两个字段。新增QywxChatSummaryProbability解析器用正则从总结文本的"成交概率预估"章节提取概率值与理由,格式不确定时不回写;CrmLeadsService相应改为读取真实持久化字段,替换 10/20 联调时的固定测试数据(DEBUG_CLOSING_PROBABILITY),实现"AI 群消息总结 → 商机成单概率"的完整闭环。
24. feat(qywx-message): 增加消息星标功能及相关接口 ⭐ 新增
- 提交:
1f452b4990(2026-10-23) - 改动量: +401行 / -25行,涉及 8 个文件
- 涉及文件:
QywxMessageService.java(+78/-17)、DataFavoriteController.java(+29/-3)、MessagePageParam.java(+3)、CrmQywxMessage.java(+6)、crm_message_favorite_state.sql(+6,新建)、MessageFavoriteTest.java(+225,新建) - 功能说明: 企微消息新增星标能力,
crm_qywx_message增加favorite_state字段(0未标星/1已标星)并建复合索引(user_id, favorite_state, create_time, id)支撑按星标过滤的分页查询。星标按消息接收人记录,与已读/删除状态完全独立,历史消息默认未标星,不做回填。
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);
25. chore(qywx): 保留历史总结概率回填预览及校验工具 🔧 工具
- 提交:
d7db5b3048(2026-10-21) - 改动量: +367行 / -0行,涉及 5 个文件
- 涉及文件:
qywx_chat_summary_backfill.py(+203,新建)、QywxChatSummaryProbabilityCli.java(+20,新建)、test_qywx_chat_summary_backfill.py(+66,新建)、qywx_chat_summary_probability_columns.sql(+12,新建) - 功能说明: 为 AI 概率回写功能补充运维工具链:Python 回填脚本用于预览历史聊天总结中可解析出的概率条目,Java CLI 用于解析器单点验证,并配套 66 行 Python 单测。SQL 脚本注明"生产库已于 2026-10-21 补齐这两列,本文件供其他环境差异核对,执行前必须重新查列,禁止重复 ADD COLUMN"。
六、新媒体账号(4 个提交)
26. feat(new-media): 账号关键词支持搜索主运营名称 ⭐ 新增
- 提交:
331e1decf5(2026-10-23) - 改动量: +107行 / -2行,涉及 3 个文件
- 涉及文件:
NewMediaAccountController.java(+4/-1)、NewMediaAccountPageParam.java、NewMediaAccountKeywordTest.java(+102,新建) - 功能说明: 新媒体账号列表的关键词搜索从"账号名称 / 账号编号"扩展为"账号名称 / 账号编号 / 主运营名称",通过
main_operation_id IN (SELECT id FROM platform_user WHERE user_name LIKE ...)子查询实现。同时新建基于 H2 内存库的NewMediaAccountKeywordTest,用真实 SQL 执行验证关键词检索行为。
27. feat(new-media): 账号关键词支持ID精确匹配 ⭐ 新增
- 提交:
29ddcbe0c9(2026-10-23) - 改动量: +23行 / -2行,涉及 3 个文件
- 涉及文件:
NewMediaAccountController.java(+6/-1)、NewMediaAccountPageParam.java - 功能说明: 纯数字关键词在模糊匹配之外,额外精确匹配账号 ID。实现上用
keyword.matches("[0-9]{1,10}")限定数字形态并校验不超过Integer.MAX_VALUE,避免超大数字或非整数引发转换异常;测试覆盖2147483648、999999999999999999999999999、2.0、2abc等边界输入均不报错也不误匹配。
28. feat(new-media): 对齐公共账号选择器关键词搜索 ⭐ 新增
- 提交:
91447520c2(2026-10-23) - 改动量: +41行 / -2行,涉及 2 个文件
- 涉及文件:
DataDictService.java(+9/-2)、NewMediaAccountKeywordTest.java - 功能说明: 公共字典服务中的账号选择器接口(
DataDictService)与NewMediaAccountController的列表接口保持关键词搜索口径一致,避免同一账号在不同入口搜索结果不同。
29. feat(new-media): 补齐公共账号选择器返回字段 ⭐ 新增
- 提交:
35eda85888(2026-10-23) - 改动量: +53行 / -0行,涉及 2 个文件
- 涉及文件:
CommonController.java(+9)、NewMediaAccountKeywordTest.java - 功能说明: 账号选择器接口补齐前端所需返回字段:
nickName(账号名称)、platform(平台信息,封装为SimpleNewMediaPlatformVo)、mainOperationUserName(主运营姓名,通过mapAdviserById批量装配避免 N+1),同时保留原有字段与分页结构不变。
七、发票与供应商(3 个提交)
30. feat(invoice): 新增供应商代码支持优化发票编号生成 ⭐ 新增
- 提交:
5a7138e1ef(2026-10-22) - 改动量: +2157行 / -17行,涉及 22 个文件
- 涉及文件:
LeadsAiPrefillService.java(+435,新建)、LeadsAiPrefillAssociations.java(+329,新建)、LeadsAiPrefillEvidence.java(+254,新建)、LeadsAiPrefillClient.java(+90,新建)、LeadsAiPrefillTest.java(+349,新建)、SupplierCodeTest.java(+128)、InvoiceSupplierCodeTest.java(+91)、landlord_supplier_code.sql(+24,新建) - 功能说明: 本周单文件体量最大的提交。新增供应商可选代码字段
landlord_info.supplier_code(VARCHAR(32) 可空),发票编号生成改为优先使用供应商代码、未维护时回退供应商 ID,使发票编号更具业务可读性且不再依赖自增 ID。SQL 采用"先查 information_schema,列已存在则不重复添加"的幂等写法。此外该提交完整落地了商机 AI 预填的核心服务链路(LeadsAiPrefillService/Associations/Evidence/Client)与 349 行主流程测试。
31. fix(landlord): 优化供应商代码唯一性校验并提高并发处理能力 🐛 修复
- 提交:
3397b124db(2026-10-22) - 改动量: +252行 / -6行,涉及 4 个文件
- 涉及文件:
LandlordService.java(+34/-5)、landlord_supplier_code_unique.sql(+33,新建)、SupplierCodeConflictTest.java(+145,新建) - 功能说明: 为
supplier_code增加全表唯一约束(含下架、禁用、已删除供应商),避免发票编号冲突。索引采用函数索引NULLIF(supplier_code,'')——NULL/空串不占用代码允许多条,其他字符串按原值参与判重,沿用现有排序规则且不 trim、不改写任何历史值。应用层LandlordService补充并发场景下的唯一性校验(145 行冲突测试)。
32. refactor(invoice): 优化发票文件生成路径避免文件覆盖 ♻️ 重构
- 提交:
aae1a19972(2026-10-22) - 改动量: +22行 / -3行,涉及 2 个文件
- 涉及文件:
InvoiceFileGenerateService.java(+7/-3)、InvoiceFileGenerateServiceTest.java(+15,新建) - 功能说明: 原发票文件名使用
发票编号 + 毫秒时间戳,高并发或同毫秒重复生成时会覆盖旧文件。改为按 UUID 独立目录隔离:crm/invoice/generated/{uuid}/{发票编号}.docx,文件名仅保留发票编号,便于人工识别。新增 1000 次并发生成测试断言路径全部唯一。
/** 文件名仅保留 Invoice 编号,独立目录隔离每次生成,避免重复或并发生成覆盖旧文件。 */
static String buildObjectPath(String invoiceCode) {
return OSS_PATH_PREFIX + UUID.randomUUID() + "/" + invoiceCode + ".docx";
}
八、数据同步与增量接口(2 个提交)
33. feat(api-sync): 优化多个供应商API租期同步逻辑并增强错误处理与邮件通知 ⭐ 新增
- 提交:
758fd82f70(2026-10-20) - 改动量: +3112行 / -261行,涉及 29 个文件(本周改动量最大的提交)
- 涉及文件:
ApiLeaseMapping.java(+156,新建)、ApiRoomRentSyncService.java(+121,新建)、ApiSyncReport.java(+124,新建)、UnilodgeLeaseMapping.java(+83,新建)、ApiLeaseDiff.java(+63,新建)、ApiLeaseSyncResult.java(+65,新建)、ApiSupplierHttp.java(+51)、ApiSyncBatch.java(+47,新建)、UnilodgeSyncService.java(+98/-113)、SturentsSyncService.java(+83/-63)、UniteSyncService.java(+45/-49)、IQSyncService.java(+36/-13)、HouseSync.java(+24/-20)、HouseApiSyncResponseExcel.java - 功能说明: 对 Unite / Unilodge / Sturents / IQ 四家供应商的租期同步做统一重构:新增
ApiLeaseMapping负责租期字段映射、ApiRoomRentSyncService负责房型租金同步、ApiLeaseDiff负责差异比对、ApiSyncReport负责生成同步结果报告、ApiSyncBatch负责批次编排,并新增ApiSupplierHttp的错误处理与邮件通知能力,供应商接口异常时自动发邮件告警而非静默失败。配套新增 7 个测试类(含 3 个真实供应商 JSON 样本:sturents-20261012、unilodge-20261013、unite-20261012)共约 800 行测试代码。
34. feat(api): 支持增量更新接口的JSON请求体和null值处理 ⭐ 新增
- 提交:
d6bd22a864(2026-10-21) - 改动量: +601行 / -21行,涉及 23 个文件
- 涉及文件:
RentalManualUpdateParam.java(+184)、IncrementalNullEndToEndTest.java(+135,新建)、IncrementalJsonBindingTest.java(+68,新建)、RentalManualNullTest.java(+53,新建)、ParamFilter.java(网关)、AbstractRewriteRestParamFilter.java、CrmLeadsService.java(+19) - 功能说明: 增量更新接口此前只能表达"字段缺省",无法表达"显式清空"。本次打通"真实网关 → FastJSON → MVC → MyBatis"全链路的 null 语义保留:网关层
ParamFilter与AbstractRewriteRestParamFilter改写逻辑不再把显式 null 丢弃;业务层RentalManualUpdateParam扩展 184 行以区分 null 与未传;测试层新增端到端IncrementalNullEndToEndTest(135 行)真实重放网关过滤器后进入 MVC 与 MyBatis 验证清空生效。
九、直播水印视频(2 个提交)
35. feat(watermark): 固定使用单张透明水印PNG及新版配置规则 ⭐ 新增
- 提交:
be3c238939(2026-10-23) - 改动量: +218行 / -111行,涉及 23 个文件
- 涉及文件:
assets/v3/logo.png(新增 516KB)、assets/v3/source.png(新增 588KB)、assets/v3/manifest.json(+11)、LiveShotWatermarkProperties.java(+14/-19)、LiveShotWatermarkTranscoder.java、LiveShotMaterialPageParam.java(+8)、LiveShotPageQueryTest.java(+52)、各服务application-pro.yml - 功能说明: 水印素材由多张规则组合简化为固定单张透明 PNG(v3 版本),并同步更新 CRM / data-cron / hzf-api / user-api / house-api 五个服务的生产配置(
LiveShotWatermarkProperties重构配置规则)。素材清单写入manifest.json便于核对校验和。
36. feat(data-cron): 调整水印转码以保留原视频分辨率与画质 ⭐ 新增
- 提交:
ae2811ee63(2026-10-23) - 改动量: +106行 / -2行,涉及 4 个文件
- 涉及文件:
LiveShotWatermarkTranscoder.java(+7/-1)、LiveShotWatermarkWorkerTest.java(+82,新建)、application-pro.yml、README.md(+16) - 功能说明: 水印转码策略从"缩放到长边1280 + 固定2000Kbps"改为"保留原视频分辨率 + CRF18 画质优先":不再设置 Width/Height/LongShortMode,不再限制码率,改用
TransConfig.TransMode=fixCRF与Video.Crf=18,由画面内容决定实际码率。worker 生产规则版本升级到 v5,并新增竖屏水印比例自适应——对宽高比小于 1 的竖屏,水印宽度按0.34 × min(1, (9/16) ÷ 视频显示宽高比)计算,9:16 保持原样、3:4 时宽度降到 25.5%(宽高均缩 25%)、更细长竖屏不放大,横屏与方形保持旧规则。文档明确说明"叠加水印需重新编码,此策略尽量保留画质,不承诺无损或 HDR 色彩保真",且无需 SQL 与历史回填。
// Wider portrait frames keep the approved 9:16 watermark height instead of enlarging the logo.
if (videoAspect < 1) width *= Math.min(1, (9d / 16d) / videoAspect);
十、钱包提现(2 个提交)
37. fix(wallet): 临时放开提现日期限制 🐛 修复
- 提交:
1c0f4f149e(2026-10-21) - 改动量: +3行 / -1行,涉及 1 个文件
- 涉及文件:
WithdrawalRequestController.java - 功能说明: 客户提现操作受阻时临时放开"每月 1-10 号支持提现"的时间窗限制,用注释块保留原校验代码以便随时恢复。
- //每月1-10号支持提现
+ // TODO 2026-10-21:临时放开提现日期限制,客户操作完成后恢复以下校验。
+ /* 每月1-10号支持提现
+ */
38. fix(wallet): 恢复提现日期限制校验 🐛 修复
- 提交:
a5d7e9440b(2026-10-21) - 改动量: +1行 / -3行,涉及 1 个文件
- 涉及文件:
WithdrawalRequestController.java - 功能说明: 客户操作完成,当天即恢复提现日期限制校验,撤销临时放开逻辑,形成"临时放开 → 完成操作 → 立即恢复"的完整闭环,避免限制长期敞开的资金风险。
十一、上线迁移与文档(3 个提交)
39. feat(sql): 添加上线前只读检查及完善迁移脚本说明 ⭐ 新增
- 提交:
bb688b018f(2026-10-19) - 改动量: +112行 / -4行,涉及 4 个文件
- 涉及文件:
order_receipt_preflight.sql(+87,新建)、order_receipt_audit.sql(+21/-2)、order_receipt_migration.sql、order_receipt_fee_type_backfill.sql - 功能说明: 新增收款单迁移的上线前只读检查脚本
order_receipt_preflight.sql(87 行),在不写库的前提下核对:迁移控制记录version='20261010'的completed_at是否存在且保持首次时间、三张备份表行数、以及"停写窗口内迁移后历史佣金账面字段是否被清洗覆盖"(对比order_info与order_info_receipt_backup的 6 个佣金字段,要求差异计数为 0)。同时完善迁移脚本注释,明确"显式设置 @apply_order_receipts=1 后重新执行迁移"、"回退先停写并确认是否已有新支付/退款"、"本次不要求修改/发布前端"。
40. chore(build): 补充测试依赖并调整Spring Boot自动配置 🔧 构建
- 提交:
1b635b7120(2026-10-22) - 改动量: +896行 / -123行,涉及 23 个文件
- 涉及文件:
order_application_backfill.sql(+126,新建)、landlord_contact_owner_role.sql(+23/-20)、SQL执行计划.json(+167/-90)、QywxAuthUserInfoTest.java(+92,新建)、DataApiJdbcStartupTest.java(+78,新建)、lease_cleanup_release.py(+145,新建)、release-startup-tests.init.gradle(+12,新建) - 功能说明: 修复 Data API 启动时 JdbcTemplate 自动配置丢失问题(
DataApiStart移除 2 行 +DataApiJdbcStartupTest78 行启动测试);企微登录改为"用户解析成功后才创建令牌",对空用户返回明确错误(CrmLoginService+ 92 行测试);新增订单补申请回填 SQL(126 行)与租期数据清理发布脚本(145 行 Python),并补充大量发布核对文档。
41. 修改:线上服务依赖与学校数据导入核对记录
- 提交:
dcb0a8023b(2026-10-23) - 改动量: +25行 / -1行,涉及 1 个文件
- 涉及文件:
线上服务依赖检查.md - 功能说明: 记录生产转储 SQL 导入测试库的坐标异常专项排查结论:生产 MySQL 8.0.28、测试 8.0.25,双方学校表 location 均为 POINT SRID 4326;从 mysqldump 备份中提取学校表段落后,629 条全部导入成功、非法空间值 0、约 3.3 秒,原测试 home_school 保持 417 条未动,隔离表插入事务已回滚并删除,全程无生产写入。同时记录了 Navicat 导出文件的轴序陷阱——文件按"经度 纬度"输出却调用未指定轴序的
ST_GeomFromText(...,4326),MySQL 按"纬度 经度"解释,导致 217 条导入失败、412 条被接受但其中 397 条经纬度被交换,修正方案是统一加'axis-order=long-lat'。
十二、查询框架重构(1 个提交)
42. refactor(applicationForm): 移除废弃导出相关代码及查询配置 ♻️ 重构
- 提交:
2e91096272(2026-10-21) - 改动量: +262行 / -8218行,涉及 96 个文件(本周删除量最大的提交)
- 涉及文件:
DynamicQueryBuilder.java(-641)、LeadsExportService.java(-338)、CashBackQueryConfigProvider.java(-297)、QueryFieldConfig.java(-270)、OrderExportService.java等 - 功能说明: 移除未正式上线的"动态查询 + 动态导出 + 个人常用筛选(saved-filter)"整套子系统:删除动态查询构建器(-641 行)、13 个业务模块的 QueryConfigProvider(-1500 行以上)、10 个导出 Row/Service(含
LeadsExportService-338、ApplicationFormExportService-312 等)以及全部crm_user_saved_filter相关实体与 Mapper(-91/-47)。普通查询、数据权限过滤与订单固定查询导出继续保留,接口合同以 Apifox 为准;配套提供drop_crm_user_saved_filter.sql删除脚本(明确"测试库按本次授权执行,生产库需在清理代码发布后按目标环境授权另行执行"),并把《动态查询接口.md》标记为历史归档。
十三、权限与账号解析(2 个提交)
43. refactor(user-resolve): 重构顾问账号信息加载及缓存逻辑 ♻️ 重构
- 提交:
e5d2c4646b(2026-10-21) - 改动量: +235行 / -9行,涉及 10 个文件
- 涉及文件:
UserResolveService.java(+36/-3)、AdviserVo.java(+12)、HomeUserBehaviorController.java(+8)、CrmFeeOrderService.java、PlatformUserService.java、AdviserAccountInfoTest.java(+140,新建) - 功能说明: 重构顾问账号信息的加载与缓存:
AdviserVo扩展accountType(1员工/2二级代理)、status(1启用/2禁用)、agency(二级代理所属机构)三个字段,把原来分散多次查询的账号属性收敛为一次装配;缓存 key 由crm:adviser:id-mp:升级为crm:adviser:v2:id-mp:实现缓存版本隔离,避免旧缓存结构导致字段缺失。新增 140 行测试覆盖顾问账号信息装配。
44. fix(homeuser): 修正权限判断逻辑并新增测试覆盖 🐛 修复
- 提交:
2bad2c3a41(2026-10-23) - 改动量: +83行 / -1行,涉及 2 个文件
- 涉及文件:
HomeUserController.java(+5/-1)、HomeUserPermissionTest.java(+78,新建) - 功能说明: 修正客户档案的越权访问隐患——原判断用
user.getAgentId().equals(param.getPlatformUserId()),当getAgentId()为 null 时会抛 NPE,且遗漏了bdId(业务发展人员)这一合法访问角色。改为使用Objects.equals做空安全比较,并补充 bdId 维度,同时前置校验operatorId != null && operatorId > 0;新增 78 行参数化测试覆盖管理员/代理/BD/无关人员的四种权限组合。
var operatorId = param.getPlatformUserId();
if (operatorId != null && operatorId > 0 && (adminRoleService.checkAdmin(operatorId)
|| Objects.equals(user.getAgentId(), operatorId)
|| Objects.equals(user.getBdId(), operatorId))) {
十四、到账通知(1 个提交)
45. feat(notification): 新增到账通知功能及相关接口优化 ⭐ 新增
- 提交:
ac49b3462f(2026-10-23) - 改动量: +446行 / -15行,涉及 16 个文件
- 涉及文件:
InvoiceNotificationTest.java(+192,新建)、InvoiceNotificationTransactionTest.java(+142,新建)、CommissionPaymentReceiverService.java(+28)、CommissionArrivalLedgerService.java(+22)、NotificationProvider.java(+10,新建)、CommissionPaymentReceiver.java(+5)、commission_payment_receiver_arrival_notify_users.sql(+4,新建) - 功能说明: 新增佣金到账通知:收款账户新增
arrival_notify_user_ids字段(JSON 整数数组,NULL 表示未配置,历史账户不触发补发),到账流水登记成功后向配置的成员推送通知。为避免 ERP 模块直接依赖 CRM 业务包,抽出NotificationProvider接口(由QywxMessageService实现),提供"落库 + 提交后推送"的统一能力;同时订单标记到账改为按主键顺序加锁(ORDER BY id ... FOR UPDATE),确保并发重复标记只通知一次,且避免交叉批次反向加锁造成死锁。
// 同批按主键顺序加锁,确保并发重复标记只通知一次,并避免交叉批次反向加锁。
var orders = orderInfoService.list(new QueryWrapper<OrderInfo>()
.in(OrderInfo.ID, orderIds).orderByAsc(OrderInfo.ID).last("FOR UPDATE"));
📊 本周工作总结
【核心成果】本周重点完成订单评价体系升级,拆分公寓评价与服务评价,支持加密链接、匿名提交、附件独立直传验签及客户邀请权限校验;统一订单佣金口径,新订单在主管审核后计算落库,历史订单回退原账面金额。同步推进企微商机、收款单、供应商发票、新媒体及直播水印等链路优化,共上线45个提交。
【技术亮点】 • 新增OrderCommentCode替代明文订单ID,并强化附件文件头魔数校验,兼顾隐私与内容安全。 • 统一供应商租期同步框架,覆盖Unite、Unilodge、Sturents、IQ,配套约800行测试及错误邮件告警。 • 增量接口打通网关、FastJSON、MVC与MyBatis链路,保留null语义,可区分显式清空与字段未传。 • CRM批量装配商机与企微客户映射,AI解析成交概率并回写crm_leads,消息游标改为数据库租约控制。 • 收款到账通知引入NotificationProvider与FOR UPDATE锁,供应商代码、发票路径及权限判断同步增强。
【业务价值】订单评价从内部功能升级为可安全分享的客户触点,降低暴露订单信息的风险,并提升评价提交效率。佣金、收款、发票及租期同步的一致性增强,减少财务差错和重复通知;企微AI与客户绑定能力则推动商机跟进闭环,提升成单转化与运营效率。
报告生成时间:2026-10-23