weekly-2026-W03

周报 · 2026年第3周（01月12日-01月19日）

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

📋 本周工作汇总

按日期统计

日期 提交数 主要内容
01/12 周一 0 —
01/13 周二 9 商机池/销售日志、订单搜索新增字段、申请表新增offer查询、修改
01/14 周三 7 新增供应商活动订单下架定时任务、修改供应商同步字段、修改
01/15 周四 9 体现申请按规则生成到账金额、佣金表截止日期筛选、体现操作同步明道云、Merge分支
01/16 周五 10 商机查询/列表新增字段、返现/申请表/供应商/佣金表等多处新增查询条件、线索列表创建人、注册用户对接同事、Merge分支
01/17 周六 0 —
01/18 周日 0 —
01/19 周一 4 供应商活动/hooli补贴/退订政策新增数据同步逻辑、修改搜索

按模块统计

模块 提交数
CRM/商机 12
明道云同步 6
订单/钱包 5
ERP/供应商/活动 5
Merge 分支合并 5
查询/筛选 4
其他（修改/配置） 2

🛠 详细工作内容

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

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

2. feat(order): 商机订单搜索新增字段 ⭐ 增强

  • 提交： c246aa1a55db035（2026-01-13）
  • 涉及文件： CrmLeadsPageParam.java、OrderPageParam.java、CrmLeadsService.java、OrderService.java、ParamUtils.java
  • 改动量： +67行
  • 功能说明：
  • CrmLeadsPageParam 新增搜索字段：customerName（客户名）、mobile（手机号）、wechatId（微信号）、keyword（关键字）
  • OrderPageParam 同步新增相同搜索字段
  • 在 CrmLeadsService 通过 ParamUtils.strToList 将字符串转为列表，使用 qw.in 实现 IN 查询
  • 在 OrderService 通过 like 实现关键字模糊查询（订单号、客户名、手机号、用户名）
  • 新增 ParamUtils 工具类提供 strToList 通用方法

3. feat(application): 申请表新增offer查询 ⭐ 增强

  • 提交： 9599bf8eadcbc7d（2026-01-13）
  • 涉及文件： ApplicationFormService.java
  • 改动量： +2行
  • 功能说明：
  • 申请表查询支持 offer_student_id（Offer 学生ID）作为关键字查询

4. feat(leads): 商机详情新增无效信息字段 ⭐ 增强

  • 提交： b1c60e339c33e2ea（2026-01-16）
  • 涉及文件： LeadsLog.java、LeadsLogBuilder.java、CrmLeadsService.java
  • 改动量： +11行
  • 功能说明：
  • LeadsLog 新增日志字段：
    • invalidType（无效类型）
    • voucher（无效凭证）
  • 使用 ICrmLeadsService.LeadsEnum.getByCode(crmLeads.getInvalidType(), "INVALID_TYPE") 转换枚举
  • 在商机详情 operationRecord 中输出 replenish（补充说明）和 voucher（凭证）字段

5. feat(leads): 注册用户详情增加对接同事字段 ⭐ 增强

  • 提交： a7a8b1aaf78933e4（2026-01-16）
  • 涉及文件： HomeUserController.java、HomeUserInfoVo.java
  • 改动量： +8行
  • 功能说明：
  • HomeUserInfoVo 新增 bdUser（对接员工）字段，类型为 AdviserVo
  • 通过 commonService.getAdviserById(user.getBdId()) 关联查询
  • 当 bdId 不为空时填充该字段，便于前端展示

6. feat(erp): 供应商/hooli活动列表增加截止日期筛选 ⭐ 增强

  • 提交： d00a5edb940be59f（2026-01-16）
  • 涉及文件： HooliPromotionPageParam.java、LandlordPromotionPageParam.java、HooliPromotionService.java、HouseCommissionService.java、LandlordPromotionService.java
  • 改动量： +19行，修改5行
  • 功能说明：
  • HooliPromotionPageParam 和 LandlordPromotionPageParam 新增 cancleDateStart、cancleDateEnd 字段
  • 活动服务使用 queryWrapper.ge/le(CANCLE_DATE, ...) 实现截止日期范围筛选
  • 佣金表（HouseCommissionService）关键字查询支持同时模糊匹配 公寓名称/供应商名称
  • 统一活动下架截止日期字段筛选逻辑

7. feat(erp): 佣金表增加截止日期筛选 ⭐ 增强

  • 提交： 1b935aff6baae941（2026-01-15）
  • 涉及文件： HouseCommissionPageParam.java、HouseCommissionService.java
  • 改动量： +5行
  • 功能说明：
  • HouseCommissionPageParam 新增 expirationDateStart、expirationDateEnd 字段
  • 服务层使用 queryWrapper.ge/le(EXPIRATION_DATE, DateUtil.parse(...)) 实现范围筛选

8. feat(cashback): 返现增加查询条件 ⭐ 增强

  • 提交： 956ed0b69d52cdf7（2026-01-16）、102a729a1281db9f（2026-01-16）
  • 涉及文件： CashBackPageParam.java、CashBackService.java
  • 改动量： +25行
  • 功能说明：
  • CashBackPageParam 新增 orderCode（订单号）字段
  • 通过 ParamUtils.strToList 将订单号转为列表，使用 qw.in(ORDER_CODE, ...) 过滤
  • 关键字查询同时模糊匹配：返现单号、订单号、客户名、手机号、用户名
  • 返回 VO 中新增 leadsInfo（关联商机信息）、leadsId、leadsCustomerName 等字段

9. feat(leads): 修改商机查询条件，商机列表新增数据字段 ⭐ 增强

  • 提交： f4b3e2feaa82ea32（2026-01-16）
  • 涉及文件： CashBackService.java、CrmLeadsService.java
  • 改动量： +23行
  • 功能说明：
  • 商机查询关键字支持：商机ID、客户名、手机号、邮箱、微信号
  • 商机列表 VO 新增 remark（备注）、type/typeText（商机分类，1注册2下单3新媒体4渠道5自开发）、createUser（创建人）、createTime（创建时间）字段
  • typeText 通过 switch 枚举映射为中文

10. feat(media): 线索列表增加创建人 ⭐ 增强

  • 提交： 5596bb380b6814b0（2026-01-16）
  • 涉及文件： MediaLeadItemVo.java
  • 改动量： +7行
  • 功能说明：
  • MediaLeadItemVo 新增 createUser（创建人）字段
  • 通过 commonService.getAdviserById(lead.getCreateUserId()) 关联查询

11. feat(application): 申请表新增查询条件 ⭐ 增强

  • 提交： bdcbdb6255e3ed4c（2026-01-16）
  • 涉及文件： ApplicationFormPageParam.java、ApplicationFormService.java、LandlordService.java
  • 改动量： +40行，修改15行
  • 功能说明：
  • ApplicationFormPageParam 新增字段：
    • landlordIdList（供应商ID列表）
    • leadCreateTimeStart/End（关联商机创建时间范围）
    • submitTimeStart/End（提交时间范围）
  • 关键字查询新增 OFFER_STUDENT_ID（Offer学生ID）字段
  • landlordIdList 通过 JSON 解析后使用 qw.in 过滤
  • leadCreateTimeStart/End 通过 EXISTS 子查询关联 crm_leads 表过滤

12. feat(erp): 供应商新增查询条件 ⭐ 增强

  • 提交： 30c64f05e6844944（2026-01-16）
  • 涉及文件： LandlordPageListParam.java、LandlordService.java
  • 改动量： +19行
  • 功能说明：
  • LandlordPageListParam 新增字段：
    • countryIdList（业务国家ID列表）
    • createTimeStart/End（创建时间范围）
    • bdIdList（BD ID列表）
  • countryIdList 通过 EXISTS 子查询关联 landlord_relation 表过滤
  • bdIdList 使用 qw.in 过滤
  • createTimeStart/End 通过 le/ge 实现范围筛选

13. feat(wallet): 体现申请创建时按规则生成到账金额 ⭐ 新增

  • 提交： b48ae11e58f66c04（2026-01-15）
  • 涉及文件： WithdrawalRequestService.java
  • 改动量： +14行
  • 功能说明：
  • 提现申请创建时自动计算到账金额：
    • 提现金额 ≤ 800：全额到账
    • 提现金额 > 800：800部分全额 + 超出部分 × 0.8（即扣20%税）
  • 计算结果保留两位小数（BigDecimal.ROUND_HALF_UP）
  • 设置到 wr.setReceivedAmount(...) 字段

14. feat(wallet): 体现操作同步明道云 ⭐ 增强

  • 提交： 9174cc1a08c1147c（2026-01-15）
  • 涉及文件： WithdrawalRequestController.java、CommonService.java、MdyWithdrawalRequestExecutor.java
  • 改动量： +5行
  • 功能说明：
  • 提现申请新增到明道云对象类型枚举：Withdrawal(objectDataType=withdrawal, controlId=...)
  • 提现申请新增时自动 commonService.addToMdy(Withdrawal, id)
  • MdyWithdrawalRequestExecutor 新增 receivedAmount（到账金额）字段同步

15. feat(erp): 新增供应商活动订单下架定时任务 ⭐ 新增

  • 提交： 32071562f804144b（2026-01-14）
  • 涉及文件： PromotionExpiredJob.java、application-pro.yml
  • 改动量： +236行
  • 功能说明：
  • 新增 PromotionExpiredJob 定时任务类（继承 BaseSimpleJob）
  • 每天9点：对距离结束还有 5 天和 1 天的供应商活动，通过企微给创建人发送提醒通知
  • 每天0点：将过期的供应商活动自动下架
  • 集成 CrmQywxMessageService 发送企微消息，ApplicationEventPublisher 发布 CrmMsgSendEvent 事件
  • 在 application-pro.yml 配置 ElasticJob 定时规则（Cron 表达式）

16. feat(sync): 供应商活动/hooli补贴活动/退订政策新增数据同步逻辑 ⭐ 增强

  • 提交： d0bd6fbcff551874（2026-01-19）
  • 涉及文件： CommonService.java、HooliPromotionController.java、HousePolicyController.java、LandlordPromotionController.java、MdyGenerator.java、MdyHousePromotionHooli.java、MdyHousePromotions.java、MdyHouseIntroductionExecutor.java、MdyHousePromotionHooliExecutor.java
  • 改动量： 多文件重构（MdyHouseIntroductionExecutor 重构382行）
  • 功能说明：
  • 新增明道云对象类型枚举：LandlordPromotion、HooliPromotion、HousePolicy
  • HooliPromotionController：所有操作（新增/更新/添加公寓/删除公寓）后自动 commonService.updateToMdy/addToMdy
  • HousePolicyController：退订政策所有操作同步明道云
  • LandlordPromotionController：供应商活动所有操作同步明道云
  • MdyHouseIntroductionExecutor 大规模重构，完善字段映射

17. feat(sync): 修改供应商同步字段 ⭐ 增强

  • 提交： cdcbc4a8f8c61c4a（2026-01-14）
  • 涉及文件： MdyLandlord.java、MdyLandlordExecutor.java
  • 改动量： +78行，修改57行
  • 功能说明：
  • 完善 MdyLandlord（明道云供应商DTO）字段映射，新增/调整：
    • name（供应商名称）、mobile（联系方式）
    • hooliId（Hooli ID）、mdySyncTime（同步时间）
    • bdName（BD负责人）、siteUrl（官网）
    • countryId（业务国家，列表类型）、introduct（备注）
    • type（供应商性质，BaseMdyOption类型）
    • bdId（BD账号，MdyMember列表类型）
  • MdyLandlordExecutor 新增上述字段的同步逻辑

18. feat(leads): 商机跟进中不限制状态 ⭐ 优化

  • 提交： ad5220ffce0c671e（2026-01-07）— 注：归入W02批次
  • 涉及文件： LeadsController.java
  • 改动量： +3行，修改7行
  • 功能说明：
  • 商机跟进（follow）操作不再限制状态（之前要求特定状态才能跟进）

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

日期 提交 说明
01/13 da56a0ab 修改
01/13 4f209ae3 修改
01/13 11ac759e 修改
01/13 7e62ad57 修改
01/13 d884eafa 修改
01/13 2025d942 Merge dev_crm_group into production
01/14 cff4f28e Merge origin/production
01/14 5c60df83 修改
01/14 87683394 修改
01/14 bff334a2 修改
01/14 0742be39 修改
01/14 f964d82a Merge dev_crm_group into production
01/15 f175d149 Merge origin/production
01/15 295821d8 Merge production into dev_crm_search
01/15 972328f2 修改
01/15 b973a654 修改
01/15 b0e7b32c 修改
01/15 ab8750bd Merge dev_crm_group into production
01/15 7a0dd2ef 修改
01/16 e4c2559f Merge dev_crm_search into production
01/16 0d4eead6 修改
01/16 2f914bc3 Merge dev_crm_search into production
01/19 587bfa3e 修改
01/19 4fe55fc0 修改
01/19 9b2e51e9 修改搜索
01/19 00bc668f 修改搜索
01/19 39dbfe9b 修改搜索

📊 本周工作总结

【核心成果】本周围绕CRM、ERP、钱包三大核心模块完成18项功能迭代。CRM侧新增商机池和销售操作日志体系，实现业务行为全链路追踪；钱包模块完成提现到账金额自动计算（分段税率）并打通明道云同步。ERP侧重点完善供应商活动管理

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

← 返回列表