weekly-2026-W13

周报 · 2026年第13周（03月23日-03月29日）

姓名： 邓星星（dengxingxing） 项目： hoolihome-project 分支： production 提交数： 21个（无Merge）

📋 本周工作汇总

按日期统计

日期 提交数 主要内容
03/23 周一 1 供应商手册明道云同步逻辑改造
03/24 周二 6 供应商手册明道云同步、Vo/Service 微调
03/25 周三 1 申请表查询列表新增字段
03/26 周四 8 供应商手册查询条件、合作方批量改归属员工、报表关系、Controller 调整
03/27 周五 4 平台用户/公寓政策/供应商手册日志 微调
03/28 周六 0 —
03/29 周日 0 —

按模块统计

模块 提交数
供应商手册 11
合作方企业 2
申请表/线索 2
报表关系 2
其他（修改） 4

🛠 详细工作内容

1. refactor(mdy): 修改供应商手册明道云同步逻辑 ⭐ 重构

  • 提交： af1d15641（2026-03-23）
  • 涉及文件： LandlordManualController.java、MdyAppManger.java、MdyExecutorService.java、MdyObjInitService.java、MdyLandlordGuide.java（删除）、MdyLandlordManual.java（新建）、MdyLandlordGuideExecutor.java（删除）、MdyLandlordManualExecutor.java（新建）、LandlordManual.java 等 9 个文件
  • 改动量： +621行 / -577行
  • 功能说明：
  • 将原 MdyLandlordGuide（供应商指南）改为新的 MdyLandlordManual（供应商手册），完成明道云 DTO 的重命名/重建
  • LandlordManualController 中将原 LANDLORD_MANUAL_OBJECT_TYPE = 41 常量改为引用 ObjectDataTypeEnum.landlordManual.getCode()，统一对象类型管理
  • MdyAppManger.APP_MAP 中将 MdyLandlordGuide.WORK_SHEET_ID 注册改为 MdyLandlordManual.WORK_SHEET_ID
  • MdyExecutorService 注入新的 MdyLandlordManualExecutor
  • MdyObjInitService 注册 MdyLandlordManual
  • 删除 MdyLandlordGuide.java（303 行删除）和 MdyLandlordGuideExecutor.java（268 行删除），新增 MdyLandlordManual.java（303 行新增）和 MdyLandlordManualExecutor.java（296 行新增）

  • LandlordManual 实体新增 15 行字段

  • 提交： 24efee0fa（2026-03-24）

  • 涉及文件： LandlordManualParam.java、LandlordManualService.java、LandlordManualVo.java、LandlordManualVoBuilder.java、MdyFileUploadHelper.java、MdyLandlordManualExecutor.java、OssFilePath.java、LandlordManual.java、LandlordManualMapper.java
  • 改动量： +270行 / -21行
  • 功能说明：
  • LandlordManualParam.houseId 改为 houseIdList（JSON 数组），支持多公寓
  • LandlordManualService.getPageList 中将单公寓 houseId 等值查询改为 JSON_CONTAINS(house_id_list, ...) 查询
  • LandlordManualVo 改造：删除单个 houseId 字段，新增 houseList（公寓 JSON 列表）和 houseNameList（公寓名列表），并通过 @LogFieldMate(fieldType = LogFieldType.LIST) 标记日志记录
  • LandlordManualVoBuilder 中注入 IHouseInfoService，新增公寓名列表的查询与映射
  • MdyLandlordManualExecutor 增强同步逻辑（244 行新增）
  • OssFilePath 新增 8 行 OSS 路径常量

2. feat(erp): 供应商手册新增查询条件 ⭐ 新增

  • 提交： 5e1f04e69（2026-03-26）
  • 涉及文件： LandlordManualPageParam.java、LandlordManualService.java
  • 改动量： +52行 / -5行
  • 功能说明：
  • LandlordManualPageParam 新增多项查询条件：
    • landlordIdList（供应商 ID 列表，JSON 数组）
    • houseIdList（公寓 ID 列表，JSON 数组）
    • hasBlockBooking（是否包房）
    • status（状态）
    • createTimeStart / createTimeEnd（创建时间区间）
    • updateTimeStart / updateTimeEnd（更新时间区间）
  • LandlordManualService.getPageList 同步实现所有查询条件：
    • 关键词：若为数字按 ID 精确匹配，否则模糊匹配 landlord_info.name
    • 供应商 ID 列表：用 in 子句
    • 公寓 ID 列表：根据数量走单 JSON_CONTAINS 或 or 拼接
    • 创建/更新时间区间

3. feat(crm): 新增批量修改合作方企业归属员工接口 ⭐ 新增

  • 提交： 2f1e84062（2026-03-26）
  • 涉及文件： DistributorCompanyController.java、DistributorCompanyParam.java、DistributorService.java
  • 改动量： +29行 / -5行
  • 功能说明：
  • 新增 /distributor-company/batch-change-bd 接口
  • 参数校验：companyIdList 必须为非空 JSON 数组；bdId 不能为空（接口逻辑看起来有点 bug：原本是 if (NumHelper.Int.checkNotZero(param.getBdId())) 提示错误，实测应改为 if (!NumHelper.Int.checkNotZero(param.getBdId()))，提交中未调整）
  • 遍历企业 ID 列表，对每个企业：
    • 调用 distributorService.changeCompanyBdId(param) 修改归属员工
    • 通过 LogRecorder 记录"批量修改归属员工"操作日志
    • 同步明道云 commonService.updateToMdy(ObjectDataTypeEnum.distributorCompany)
  • DistributorCompanyParam 新增 companyIdList（JSON 数组）字段
  • 清理 DistributorService 中已注释的明道云同步旧代码（5行删除）

4. feat(crm): 申请表查询列表新增查询字段 ⭐ 优化

  • 提交： 324b9db10（2026-03-25）
  • 涉及文件： ApplicationFormService.java
  • 改动量： +3行 / -1行
  • 功能说明：
  • ApplicationFormService.getPageList 关键词搜索范围扩展，新增 OFFER_EX_ID（Offer Exchange ID）和 OFFER_ROOM_ID（Offer Room ID）两个字段的模糊匹配

5. refactor(erp): 修改供应商手册 Vo 字段映射 ⭐ 优化

  • 提交： f79ea9a97（2026-03-24）
  • 涉及文件： LandlordManualVo.java、LandlordManualVoBuilder.java
  • 改动量： +16行 / -16行
  • 功能说明：
  • LandlordManualVo 中调整字段名/映射规则（16 行调整）
  • LandlordManualVoBuilder 同步调整字段拼装逻辑（8 行调整）

6. refactor(erp): 供应商手册 Param 调整 houseIdList ⭐ 优化

  • 提交： f0a8db1c7（2026-03-24）
  • 涉及文件： LandlordManualParam.java、LandlordManualService.java
  • 改动量： +8行
  • 功能说明：
  • LandlordManualParam.houseId 改为 houseIdList（JSON 数组）
  • LandlordManualService 中将查询改为 JSON_CONTAINS(house_id_list, ...)

7. refactor(erp): 供应商手册 Controller 调整 ⭐ 优化

  • 提交： ef3638db0（2026-03-24）
  • 涉及文件： CommonService.java、LandlordManualController.java
  • 改动量： +6行 / -1行
  • 功能说明：
  • LandlordManualController 内补充 4 行
  • CommonService 内调整 2 行

8. 其他提交（修改/维护）

日期 提交 说明
03/24 65172ff32 LandlordManualVo/Builder 微调（2行）
03/26 bff8b2bb1 ReportRelationService/CommonService 调整（10行）
03/26 a95cedfc2 DistributorCompanyController 微调（3行）
03/26 ed0ed33ed ReportRelationController/CommonController 调整（3行）
03/26 7f4d6949d CommonService 微调（1行）
03/27 f07d3ecab LandlordManualService 调整（8行）
03/27 25117d0b5 LandlordManualService 微调（1行）
03/27 b00dec19f LandlordManualService 删除冗余代码（4行）
03/27 84e6ab403 LandlordManualController/Service 调整（24行）
03/27 42435a111 LandlordManualPageParam/Service 调整（5行）
03/27 61d84ac77 CommonService 微调（2行）
03/27 822ee1058 PlatformUserService/ApplicationApplyUserService/LandlordManualService 微调（4行）

📊 本周工作总结

【核心成果】本周完成供应商手册模块全面重构，从"供应商指南"升级为"供应商手册"实体，同步完成明道云 DTO 重命名及多公寓支持改造；新增批量修改合作方企业归属员工接口；扩展申请表查询字段覆盖范围。

【技术亮点】采用 JSON_CONTAINS 实现多公寓 JSON 数组查询；统一对象类型管理（硬编码 41 → ObjectDataTypeEnum 枚举）；Executor 服务模式重构，职责更清晰；Vo/Builder 注入依赖服务实现关联数据自动映射；@LogFieldMate 注解标记列表字段日志。

【业务价值】多维度查询条件（供应商/公寓/时间区间/包房状态）大幅提升运营

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

← 返回列表