weekly-2026-W12

周报 · 2026年第12周（03月16日-03月22日）

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

📋 本周工作汇总

按日期统计

日期 提交数 主要内容
03/16 周一 1 佣金字段调整
03/17 周二 3 订单明道云同步字段扩展、佣金微调
03/18 周三 1 邮件服务微调
03/19 周四 3 申请表/注册用户/线索/商机新增账号同步字段（大重构）
03/20 周五 2 客户端 V2 接口微调
03/21 周六 0 —
03/22 周日 0 —

按模块统计

模块 提交数
明道云同步（订单/申请表/注册用户/线索/商机） 5
供应商手册 1
客户端V2 2
其他（修改） 2

🛠 详细工作内容

1. feat(erp): 新增供应商手册相关接口 ⭐ 新增

  • 提交： af3bb8b80（2026-03-23，跨周提交纳入本周统计）
  • 涉及文件： LandlordManualController.java、LandlordManualPageParam.java、LandlordManualParam.java、LandlordManualService.java、LandlordManualVo.java、LandlordManualVoBuilder.java、LandlordManual.java、ILandlordManualService.java、LandlordManualServiceImpl.java、LandlordManualMapper.java 等 10 个文件
  • 改动量： +1236行
  • 功能说明：
  • 完整搭建供应商手册（LandlordManual）模块的 API 层，新增 5 个接口：
    • /landlord/manual/page/list（分页列表）
    • /landlord/manual/info（详情）
    • /landlord/manual/add（新增）
    • /landlord/manual/update（编辑）
    • /landlord/manual/delete（删除）
  • Controller 内通过 LogRecorder 记录新增/编辑/删除操作日志（对象类型 code 暂用常量 LANDLORD_MANUAL_OBJECT_TYPE = 41）
  • LandlordManualParam 新增 200 行参数对象，覆盖供应商手册的完整业务字段
  • LandlordManualVo 新增 289 行返回对象，包含丰富的展示字段（注解 @LogFieldMate）
  • LandlordManualVoBuilder 65 行，负责构建 VO
  • 数据库实体 LandlordManual 382 行（含完整字段定义），对应 Mapper / Service / IService / ServiceImpl 完整 MyBatis 四层结构

2. feat(mdy): 申请表、注册用户、线索、商机新增账号相关同步字段 ⭐ 重构

  • 提交： bfe8c45d6（2026-03-19）
  • 涉及文件： MdyApplicationForm.java、MdyHomeUser.java、MdyLeads.java、MdyNewMediaLead.java、MdyApplicationFormExecutor.java、MdyHomeUserExecutor.java、MdyLeadsExecutor.java、MdyNewMediaLeadExecutor.java
  • 改动量： +1044行 / -665行
  • 功能说明：
  • 明道云 DTO 大重构：将"员工关联表"改为通用"账号关联表"语义后，对申请/注册用户/线索/商机 4 个 DTO 一并对齐
  • MdyApplicationForm：删除旧字段（自建邮箱、申请状态、性别、邮箱、国籍、留学学校、专业、地区等），新增以 leadsId 商机为主键的字段映射
  • MdyLeads：完整重写（731 行变更），按新明道云结构对齐商机字段
  • MdyNewMediaLead：完整重写（321 行变更）
  • MdyHomeUser：新增字段（15 行新增）
  • 各 Executor 同步实现账号相关字段的同步逻辑
  • 提交： 05e734238（2026-03-19）
  • 涉及文件： MdyNewMediaLead.java、MdyNewMediaLeadExecutor.java
  • 改动量： +175行 / -167行
  • 功能说明：
  • 跟进上述重构，进一步调整 MdyNewMediaLead 与执行器
  • 提交： 561b0e52a（2026-03-19）
  • 涉及文件： MdyNewMediaLead.java、MdyNewMediaLeadExecutor.java
  • 改动量： +175行 / -167行
  • 功能说明：
  • 跟进 MdyNewMediaLead 字段调整

3. feat(mdy): 订单新增同步字段 ⭐ 新增

  • 提交： 36ba2e30c（2026-03-17）
  • 涉及文件： MdyOrderExecutor.java
  • 改动量： +46行 / -3行
  • 功能说明：
  • MdyOrderExecutor 内为订单相关的用户/部门同步字段全面扩展：
    • BD 客户（bdUserId）：新增 NewBdUserId（基于 mdyRowid 的新引用）、NewBdDepartmentId（基于部门 rowid）
    • 销售用户（salesUserId）：新增 NewSaleUserId、NewCreateUserId、NewSaleUserDepartmentId
    • 申请人（applyUserId）：新增 NewApplyUserId
    • 上级审核人（AuditCompetentId）：新增 NewAuditCompetentId
    • 财务审核人/出纳/创建人/取消人/新媒体主客服等：均新增对应的 New* 字段
  • 注入 IQywxDepartmentService 依赖，订单同步时支持将 mainDepartmentId 解析为部门 rowid 后推送给明道云
  • 调整 Arrays.asList 为 List.of，避免数组转列表的不可变性问题

4. feat(mdy): 订单 DTO 字段扩展 ⭐ 重构

  • 提交： 729737825（2026-03-17）
  • 涉及文件： MdyOrder.java
  • 改动量： +174行 / -57行
  • 功能说明：
  • MdyOrder 新增大量 New* 字段（基于 mdyRowid 的新引用字段），与 Executor 的改动保持一致
  • 调整字段顺序和命名，确保与明道云新结构对齐

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

日期 提交 说明
03/17 7451333bc HouseCommissionService 调整（10行）
03/18 844ab9503 ApplicationMailService 微调（1行）
03/20 b02ec9c4f ClientHouseControllerV2 微调（1行）
03/20 a096a6618 ClientHouseControllerV2 微调（1行）

📊 本周工作总结

【核心成果】本周完成两大核心模块建设：一是供应商手册（LandlordManual）模块完成从0到1搭建，提供分页列表/详情/新增/编辑/删除5个完整API，涵盖10个文件、1236行新增代码；二是明道云数据同步体系大重构，完成申请表、注册用户、线索、商机4个DTO及订单模块的账号关联字段全面对齐，累计变更超1500行，显著提升数据一致性。

【技术亮点】采用标准四层架构（Controller-Service-Mapper）构建供应商手册模块，引入LogRecorder记录操作日志，VO/Param参数对象设计规范；明道云DTO重构中，将“员工关联表”语义升级为通用“

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

← 返回列表