周报 · 2026年第4周（01月19日-01月26日）

姓名： 邓星星（dengxingxing） 项目： hoolihome-project 分支： production 提交数： 26个（含3个Merge分支合并）

📋 本周工作汇总

按日期统计

按模块统计

🛠 详细工作内容

1. feat(qywx): 新增群聊天记录列表 ⭐ 新增

• 提交： e2d90f3a0513b468（2026-01-20）
• 涉及文件： ApplicationFormController.java、DistributorCompanyController.java、QywxGroupController.java、QywxLabelController.java、QywxTodoController.java、QwGroupCreateLogParam.java、QywxGroupPageParam.java、QywxGroupParam.java、QywxMessageContentParam.java 等
• 改动量： 多个文件重构，新增群消息接口
• 功能说明：
• 新增 /qywx-group/content/list 接口（list 方法）
• 入参：QywxMessageContentParam（含 groupId 群ID 和 maxSeq 最大序列号）
• 自动获取当前群最新消息序号（messageContentService.getNowMaxSeqByGroupId）
• 通过 QywxMessageContentService.getPageList 分页查询群消息
• 批量获取群成员用户名映射（getGroupMemberNameMap）和企微用户信息（getQywxUserMap）
• 返回 QywxMessageContentVO 列表（含 msgid、seq 等）

2. feat(qywx): 关闭群聊天记录超时回复统计逻辑 ⭐ 优化

• 提交： 38d548f6ad035b48（2026-01-20）
• 涉及文件： QywxMsgJob.java
• 改动量： +2行，修改2行
• 功能说明：
• 注释掉 qywxMsgReplyTimeService.computeQywxMsgReplyTime() 和 syncToMdy() 调用
• 关闭企微群聊天记录的超时回复统计功能（暂时禁用）

3. feat(qywx): 修改企业微信消息存档处理逻辑 ⭐ 增强

• 提交： 9611653d5330cf02（2026-01-23）
• 涉及文件： QywxMsgHistoryJob.java、application-pro.yml、QywxMsgHandler.java、QywxMsgService.java、QywxMsgUtils.java
• 改动量： +249行
• 功能说明：
• 新增 QywxMsgHistoryJob 定时任务类（每天凌晨1点执行）
• 通过 @EsJobConfig 注解配置 ElasticJob
• 调用 qywxMsgHandler.processHistoryMsgContent() 处理前一天未处理的消息
• 处理内容：超过 100M 的大文件、撤回消息的具体哪条消息
• 在 application-pro.yml 配置 Cron 表达式

4. feat(qywx): 修改企业微信回话内容存档大文件拉取oom问题 ⭐ 优化

• 提交： 42865f187d202a58（2026-01-23）
• 涉及文件： QywxMsgService.java、QywxMsgUtils.java
• 改动量： +72行
• 功能说明：
• 修复企微消息存档大文件拉取时的 OOM（内存溢出）问题
• 新增 QywxMsgUtils.pullMediaFileToTempFile(sdkFileId, fileSize) 将大文件先下载到临时文件
• 使用 BufferedInputStream + BufferedOutputStream 流式处理，避免一次性加载到内存
• 文件上传到 OSS（bj-files-hoolihome）后，删除临时文件
• 文件大小限制：100MB

5. feat(leads): 商机分配，商机重新指定销售，关联申请表同步到明道 ⭐ 增强

• 提交： 387d95dcc07e0104（2026-01-20）
• 涉及文件： LeadsController.java、AllocateAgentForCrmLeadsConsumer.java
• 改动量： +22行
• 功能说明：
• 商机分配或重新指定销售时，自动同步关联的申请表到明道云
• 在 LeadsController 通过 applicationFormService.query().eq(LEADS_ID, id).list() 查询关联申请表
• 若申请表已有 rowid 则 updateToMdy，否则 addToMdy
• 在 AllocateAgentForCrmLeadsConsumer 通过 mdyService.syncHooliToMdy 同步
• 实现商机→申请表的完整数据链路同步

6. feat(cashback): 返现，推荐费同步明道 ⭐ 新增

• 提交： c7fa9f19ec415235（2026-01-22）
• 涉及文件： CashBackController.java、ReferralController.java、CommonService.java
• 改动量： +13行
• 功能说明：
• 新增明道云对象类型枚举：CashBack、Referral
• CashBackController：新增返现时 addToMdy、更新/审核时 updateToMdy
• ReferralController：推荐费同步相同逻辑
• 实现返现/推荐费与明道云的数据同步

7. feat(wallet): 客户端钱包提现单次仅限一笔 ⭐ 优化

• 提交： 8a98da4f7ba526f4（2026-01-23）
• 涉及文件： WithdrawalRequestController.java
• 改动量： +3行
• 功能说明：
• 在提现申请接口中校验 incomeDetailIds.size() > 1 时返回错误"单次仅限提现一笔"
• 防止用户一次提现多笔账单

8. feat(wallet): 修改钱包提现规则 ⭐ 优化

• 提交： ee0e3f818dcef464（2026-01-23）
• 涉及文件： WalletController.java
• 改动量： +4行，修改4行
• 功能说明：
• 优化钱包提现规则提示文案：
  1. 返现奖励与推荐奖励将在对应公寓向我司支付佣金后安排发放（180个工作日内）
  2. 奖励金额将统一按固定汇率折算为人民币发放
  3. 根据税收法规，到账金额为代扣个人所得税后的净额
  4. 最终解释权归 HooliHome 平台所有

9. feat(erp): 佣金表、供应商活动新增批量修改 ⭐ 新增

• 提交： ae97eb357583a73a（2026-01-20）
• 涉及文件： HouseCommissionController.java、LandlordPromotionController.java、HouseCommissionParam.java、LandlordPromotionParam.java、HouseCommissionService.java、LandlordPromotionService.java
• 改动量： +65行
• 功能说明：
• 新增 /house-commission/batch-update 接口：
  • 入参 idList（JSON 数组）、academicYear（学年）、commissionProportion（佣金比例）
  • 调用 houseCommissionService.batchUpdate(param)
  • 循环 commonService.updateToMdy 同步每条记录到明道云
• 新增 /landlord-promotion/batch-update 接口：
  • 入参 idList（JSON 数组）、cancleDate（截止日期）
  • 批量更新供应商活动，同步明道云

10. 其他提交（修改/配置/维护）

📊 本周工作总结

【核心成果】 本周聚焦企微消息存档能力建设、CRM商机全链路同步、钱包提现规则优化及ERP批量操作四大模块，完成9项功能迭代（含5项新增、4项优化）。

【技术亮点】 - 流式处理防OOM：大文件拉取采用`BufferedInput

报告生成时间：2026-07-06 说明：本报告基于真实代码 diff 内容撰写，区分了新增功能（⭐新增）和逻辑优化（⭐优化/⭐重构/⭐增强/⭐扩展）