weekly-2026-W02

周报 · 2026年第2周（01月05日-01月12日）

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

📋 本周工作汇总

按日期统计

日期 提交数 主要内容
01/05 周一 2 修改账号列表/更新接口、Merge分支
01/06 周二 14 商机池新增分组商机池、商机分配分组池逻辑、商机指定销售、币种空兼容、商机绑定链接、Merge分支
01/07 周三 14 供应商活动下架定时任务、申请表同步明道云字段、商机同步明道云字段、建群销售通知、学校下拉列表国家城市、供应商类型、Merge分支
01/08 周四 6 订单强制更新接口、邮件详情模版ID、人员职位字段、商机详情指定销售、学校查询
01/09 周五 13 合作方邮箱/指定销售字段、企业同步字段、商机详情指定销售、Merge分支
01/10 周六 0 —
01/11 周日 0 —
01/12 周一 3 Merge dev_crm_group分支、修改

按模块统计

模块 提交数
商机/CRM 17
明道云同步 8
订单管理 7
企业/合作方 6
申请/钱包 4
Merge 分支合并 7
其他（修改/配置） 3

🛠 详细工作内容

1. feat(leads): 商机池新增分组商机池 ⭐ 新增

  • 提交： cb9e88b462056177（2026-01-06）
  • 涉及文件： AllocationConfigController.java、PoolParam.java、AllocationConfigService.java、ICrmLeadsAllocationPoolBdService.java、CrmLeadsAllocationPoolBd.java、CrmLeadsAllocationPoolBdMapper.java、CrmLeadsAllocationPoolBdServiceImpl.java、CommonCodeGen.java
  • 改动量： +166行，修改34行
  • 功能说明：
  • 新增商机池类型枚举：1=企业商机池、2=城市商机池、3=分组商机池
  • PoolParam 增加 poolType 字段标识商机池类型
  • 新增 CrmLeadsAllocationPoolBd 实体类、Mapper、Service 全套基础设施
  • 新增 ICrmLeadsAllocationPoolBdService 接口提供关联对接同事（BD）的增删改查
  • AllocationConfigService 新增方法 handlePoolBd，处理商机池与对接同事的关联绑定
  • AllocationConfigController 接口返回 bdList（关联对接同事列表）和 typeText（类型中文名）
  • 为后续的分组商机池分配逻辑提供数据支撑

2. feat(allocation): 商机分配新增分组商机池分配逻辑 ⭐ 新增

  • 提交： 8b82de7c3b528931（2026-01-06）
  • 涉及文件： AllocateAgentForCrmLeadsConsumer.java、LeadAllocateAgentService.java、ICrmLeadsAllocationLogService.java
  • 改动量： +55行，修改4行
  • 功能说明：
  • 在商机分配链路中增加优先级4：分组商机池分配
  • 当商机已指定对接同事（bdId 不为空）时，查询 poolType=3 的分组商机池
  • 通过 EXISTS 子查询匹配对接同事 ID 与商机池关联的城市 ID
  • 若匹配到分组商机池，调用 pickSalesFromGroupPool 从分组池中挑选销售
  • 若匹配到分组池但未匹配到销售，记录失败日志（StrategyTypeEnum.GROUP_POOL）并创建挂起分配
  • 构建 matchConditions（bdId、poolAcceptTypes、leadSourceId）作为分配上下文的匹配条件

3. feat(leads): 商机新增创建指定销售逻辑 ⭐ 重构

  • 提交： 0f4d7567418392b（2026-01-06）
  • 涉及文件： LeadsController.java、CrmLeadsParam.java、AllocationConfigService.java、CommonService.java、CrmLeadsService.java、ICrmLeadsAllocationLogService.java
  • 改动量： +81行，删除345行
  • 功能说明：
  • 重构商机分配相关代码：删除约345行旧逻辑（多个 @Deprecated 方法）
  • 新增 getGroupPoolSalesList 接口对应 specify-sales-list 接口（可指定销售列表）
  • 整合 AllocationConfigService 处理分组商机池可分配销售列表
  • 简化 CrmLeadsService 内部依赖关系，移除冗余注入（IHomeSchoolService、IHomeUserApplicantService 等）
  • 优化商机创建/分配调用链路，提升代码可读性和可维护性

4. feat(leads): 商机新增 增加指定销售逻辑 ⭐ 优化

  • 提交： 0cc3ae1888cc873（2026-01-06）
  • 涉及文件： CrmLeadsService.java、MobileController.java、MobileUtils.java
  • 改动量： +17行，删除21行
  • 功能说明：
  • 当传入参数 specifySaleId（指定销售ID）时，直接将 firstAllocateUserId 设置为指定销售
  • 创建商机分配日志（CrmLeadsAllocationLog）记录此次指定销售行为
  • 简化 MobileController 中的手机号区号查询逻辑
  • 通过排序的 ArrayList<Integer> 优化手机号区号列表返回
  • 返回的 VO 包含 id、mobilePrefix、name、enName 四个字段

5. feat(leads): 修改商机绑定链接逻辑 ⭐ 优化

  • 提交： 13a77713bb129d1（2026-01-06）
  • 涉及文件： CrmLeadsService.java
  • 改动量： +16行，删除28行
  • 功能说明：
  • 使用 WeappService 生成微信小程序 URL（绑定链接）
  • 固定使用 WxMiniAppEnum.HOOLI_HOME_APP.getAppId() 作为 AppID
  • 路径为 /pages/leadBind/leadBind
  • 生成后保存到 crmLeads.weappBindUrl 字段
  • 返回 VO 包含 appId、path（带 query 参数）、url（短链）

6. feat(application): 申请表、订单兼容币种为空的情况 ⭐ 优化

  • 提交： 182ff75bd14e7d9（2026-01-06）、8121742018752b4b（2026-01-06）
  • 涉及文件： ApplicationFormService.java、OrderService.java、CrmLeadsService.java
  • 改动量： +14行（+后续8行）
  • 功能说明：
  • 当申请表的 moneyUnit（币种）为0或空时，自动从 countryId 查询对应国家的 moneyUnit
  • 订单同步该兜底逻辑
  • 避免币种字段为空导致下游金融计算错误

7. feat(crm): 商机池、销售增加日志 ⭐ 新增

  • 提交： 17a80bb5f6775fac（2026-01-13）
  • 涉及文件： AllocationConfigController.java、AssignableSalesLog.java、AssignableSalesLogBuilder.java、LeadsPoolLog.java、LeadsPoolLogBuilder.java
  • 改动量： +291行
  • 功能说明：
  • 新增 AssignableSalesLog、LeadsPoolLog 两个日志DTO类
  • 对应的 LogBuilder 类提供日志字段构建能力
  • 在 AllocationConfigController 中为可分配销售、商机池的新增/更新/删除操作添加日志记录

8. feat(order): 新增订单强制更新接口 ⭐ 新增

  • 提交： c27915fe18a4b068（2026-01-08）、1f3adaeececd6d9e（2026-01-08）
  • 涉及文件： OrderController.java、OrderLog.java、OrderLogBuilder.java、ForcedUpdateOrderParam.java、OrderFinancialAuditParam.java、OrderFinancialClosingParam.java、OrderPageParam.java、OrderParam.java、OrderSubmitSupervisorParam.java、OrderService.java
  • 改动量： +290行（含后续修复5行）
  • 功能说明：
  • 新增 /order/forced-update 接口（forcedUpdate 方法）
  • 接收 ForcedUpdateOrderParam 参数（含 type 字段，合法值1/2/3）
  • 移除原 update 接口的"待提交审核/待审核状态"限制（注释掉的旧校验被替换为新逻辑）
  • 使用 LogRecorder.on 记录操作日志（ObjectDataTypeEnum.Order）
  • 调用 orderService.forcedUpdate(param) 执行强制更新
  • 更新完成后自动 commonService.updateToMdy 同步到明道云
  • 同时整理 order 相关 Param 类，统一移至 order 子包

9. feat(crm): 创建商机指定销售给对接同事发送建群销售 ⭐ 新增

  • 提交： f1d1fdc42dc6014a（2026-01-07）
  • 涉及文件： DistributorUserLog.java、LeadsLog.java、OrderLog.java、CrmLeadsService.java、AllocateAgentForCrmLeadsConsumer.java、DistributorsCompanyInfo.java、DistributorsCompanyInfoMapper.java、CommonLeadService.java、DistributorsCompanyInfoServiceImpl.java、IDistributorsCompanyInfoService.java
  • 改动量： +96行，修改72行
  • 功能说明：
  • 新增 CommonLeadService.getCreateGroupMessage 方法构建"创建商机建群"消息内容
  • 在 CrmLeadsService 中通过 qywxMessageService.saveNotificationMessage 通知对接同事（leads.getBdId()）建群
  • 在 AllocateAgentForCrmLeadsConsumer 中通过 crmMessageService.createCrmLeadsAllocateMessage 通知对接销售
  • 整合 DistributorsCompanyInfo 实体相关依赖，统一接入合作方公司信息
  • 消息中包含客户名称、商机ID等信息，支持企微通知

10. feat(sync): 商机同步明道云新增同步字段 ⭐ 增强

  • 提交： 38f7af597fab5498（2026-01-07）
  • 涉及文件： OrderController.java、OrderService.java、MdyLeadsExecutor.java
  • 改动量： +30行，删除41行
  • 功能说明：
  • 订单提交时，若关联商机（leadsId），自动 commonService.updateToMdy 同步商机到明道云
  • 在 MdyLeadsExecutor 中新增字段：
    • sjcjr（商机创建人）- 从 leads.createUserId 关联查询 PlatformUser 的 mdyId
    • sjfpsj（商机分配时间）- leads.allocateTime
    • sjzhsj（商机转化时间）- leads.conversionTime（首次设置时为当前时间）
    • sj_gjz_czsj（商机跟进操作时间）
    • sj_gjz_czr（商机跟进操作人）- 从 leads.followUserId 关联查询
  • 优化 MdyLeadsExecutor 字段设置逻辑（删除冗余代码）

11. feat(sync): 申请表同步明道云新增同步字段 ⭐ 增强

  • 提交： 783b53e2ede167548（2026-01-07）、01910be79761b41（2026-01-07）、a1241f7ee519ff52（2026-01-07）
  • 涉及文件： MdyApplicationFormExecutor.java
  • 改动量： +40行（累计）
  • 功能说明：
  • 在 MdyApplicationFormExecutor 中新增以下字段映射：
    • submitUserId（提交人） + submitTime（提交时间）
    • xiof_czr（下发操作人） + xiof_sj（下发时间）
    • jsof_czr（接收操作人） + 接收时间
  • 操作人字段通过 platformUserService.getOptionalById 关联查询，获取 PlatformUser 的 mdyId 后包装为 MdyMember
  • 时间字段直接使用申请表实体的对应时间戳
  • 完善申请表→明道云的数据同步链路

12. feat(sync): 修改企业同步字段 ⭐ 增强

  • 提交： ce8b4400ae255d96（2026-01-09）、afa011cff0088be4（2026-01-09）
  • 涉及文件： MdyDistributorCompanyExecutor.java
  • 改动量： +113行，修改27行
  • 功能说明：
  • 完善合作方公司同步到明道云的字段映射
  • 新增 cooperativeState（合作状态）：1=正常，其他=停止合作，转换为中文
  • 新增 attributionType（归属类型）：1=渠道BD、2=新媒体、3=销售、其他=其他
  • 新增 rowid 回写机制（同步成功后保存明道云记录ID）
  • 文档化明道云无对应字段的字段列表（如 companyShortName、stopCooperationOperatior 等）

13. feat(distributor): 合作方新增邮箱字段，商机同步增加指定销售字段 ⭐ 新增

  • 提交： 64c305330deb304d（2026-01-09）
  • 涉及文件： DistributorUserController.java、DistributorUserLog.java、DistributorUserParam.java、MdyDistributor.java、MdyLeads.java、MdyDistributorExecutor.java、MdyLeadsExecutor.java、DistributorsUserInfo.java、DistributorsUserInfoMapper.java
  • 改动量： +435行，修改402行
  • 功能说明：
  • 合作方实体 DistributorsUserInfo 新增 email 邮箱字段
  • DistributorUserParam 同步增加 email 参数
  • DistributorUserLog 添加邮箱字段日志映射
  • MdyDistributor 新增 email 字段的明道云映射
  • MdyLeads（明道云商机 DTO）大规模重构，新增：
    • hooliId（商机ID）
    • homeUserId（注册用户，列表类型）
    • 商机等级（意向）字段
    • 多个 MdyFieldMeta 注解标注的明道云字段
  • MdyLeadsExecutor 新增 hooliId 等字段同步逻辑

14. feat(common): 学校下拉列表增加国家城市及关联数据 ⭐ 增强

  • 提交： 15801ada92ebf383（2026-01-07）
  • 涉及文件： CommonController.java
  • 改动量： +18行
  • 功能说明：
  • 学校下拉列表接口（school dropdown）返回数据增强
  • 关联查询学校所属国家（countryId/countryName/countryEnName）
  • 关联查询学校所属城市（cityId/cityName/cityEnName）
  • 返回国家币种信息（moneyUnit/moneySymbol/moneyDesc）
  • 返回城市租期单位（rentTimeUnit/rentTimeUnitText）
  • 通过 addressService.getByIdFromCache 使用缓存优化查询性能

15. feat(school): 修改学校查询 ⭐ 优化

  • 提交： 54493cc54299d79（2026-01-08）
  • 涉及文件： CommonService.java
  • 改动量： +4行
  • 功能说明：
  • 优化学校查询服务逻辑（细节性调整）

16. feat(erp): 增加供应商类型 ⭐ 扩展

  • 提交： ca57b39bc2c15ac（2026-01-07）、3a66373e70169fa（2026-01-07）
  • 涉及文件： LandlordEnum.java
  • 改动量： +1行（×2）
  • 功能说明：
  • 在 LandlordEnum 枚举中新增供应商类型（thirdPartyProduct_wuliubaoguo_opt "物流包裹"）

17. feat(platform): 修改账号列表、更新接口 ⭐ 优化

  • 提交： 32d3b845464bd57（2026-01-05）
  • 涉及文件： PlatformUserController.java、PlatformUserService.java
  • 改动量： +29行，修改18行
  • 功能说明：
  • 优化账号管理接口（列表查询、更新）

18. feat(leads): 商机详情系统信息新增指定销售字段 ⭐ 增强

  • 提交： 7594590c0aa6881（2026-01-08）
  • 涉及文件： CrmLeadsService.java
  • 改动量： +5行
  • 功能说明：
  • 商机详情系统信息中新增 firstAllocateUserId（指定销售）字段

19. feat(adviser): 人员新增职位 ⭐ 增强

  • 提交： 672df6ff4402c57（2026-01-08）
  • 涉及文件： AdviserVo.java
  • 改动量： +4行
  • 功能说明：
  • AdviserVo（顾问VO）新增职位字段

20. feat(mail): 邮件详情新增模版ID ⭐ 增强

  • 提交： ceaa163fbc60f96（2026-01-08）
  • 涉及文件： ApplicationMailController.java
  • 改动量： +1行
  • 功能说明：
  • 邮件详情接口返回数据中新增 templateId（邮件模版ID）字段

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

日期 提交 说明
01/05 58e90278 Merge production of git.hoolihome.com
01/05 d2cb01a1 Merge dev_crm_group into production
01/05 b31a6c44 Merge production of git.hoolihome.com
01/06 4f8cbe7f 修改
01/06 b59008cb 修改商机同步
01/06 95aa4183 Merge origin/production
01/07 17329aee 修改
01/07 4e0eafde 修改
01/07 35eaa870 Merge origin/production
01/07 081610d7 Merge origin/production
01/07 ea91296f Merge origin/production
01/07 82839d7a 修改
01/07 13579959 修改
01/07 16869bf4 Merge dev_crm_group into production
01/07 b304c68e Merge origin/production
01/07 9e3970f1 Merge production into dev_apply
01/07 78583d9a Merge origin/dev_apply into dev_apply
01/09 6038b2e8 修改
01/09 340d730e 修改
01/09 0368a3c4 修改
01/09 4560872a 修改
01/09 55a904c6 修改
01/09 8c77934c 修改
01/09 53b32c0e Merge origin/production
01/12 90c418e8 修改
01/12 fd4bf44d 修改
01/12 edb3e570 Merge dev_crm_group into production

📊 本周工作总结

【核心成果】本周完成商机分配体系重大升级，分组商机池功能正式上线。新增 poolType=3 的分组商机池类型，实现按对接同事（BD）智能匹配分配的完整链路。同时对商机指定销售逻辑进行大规模重构，删除冗余代码345行，显著提升代码可维护性。

【技术亮点】① 采用 EXISTS 子查询优化分组商机

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

← 返回列表