weekly-2026-W15

周报 · 2026年第15周（04月06日-04月12日）

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

📋 本周工作汇总

按日期统计

日期 提交数 主要内容
04/06 周一 0 —
04/07 周二 0 —
04/08 周三 3 公寓新增联系方式/房源备注/补充申请信息/附件 4 个字段
04/09 周四 4 公寓同步明道云逻辑、CrmLogin 微调、供应商手册明道云微调
04/10 周五 3 新增 MDY 通用 PDF 生成接口（含文件名参数）
04/11 周六 0 —
04/12 周日 0 —

按模块统计

模块 提交数
明道云通用 PDF 生成 2
公寓新增字段 4
供应商手册明道云 1
其他（修改） 3

🛠 详细工作内容

1. feat(data-api): 新增MDY通用PDF生成接口 ⭐ 新增

  • 提交： 115f45825（2026-04-10）
  • 涉及文件： build.gradle、MdyPdfController.java（新增）、PdfGenerateParam.java（新增）、PdfGenerateLog.java（新增）、PdfGenerateLogMapper.java（新增）、PdfGenerateService.java（新增）、fonts/NotoSansSC-Regular.ttf（新增，10.5MB）
  • 改动量： +654行（含字体二进制文件）
  • 功能说明：
  • 搭建 PDF 生成微服务的完整基础设施，新增接口 /mdy/pdf/generate（POST）
  • 请求头校验：HAP-Appkey 和 HAP-Sign（明道云 HAP 认证）
  • 必填参数：worksheetId、rowId、fieldId、fileUrl、data、templateType
  • templateType 支持两种模式：
    • acroform：按表单字段名替换（data 格式 [{"fieldName":"值"}]）
    • coordinates：按坐标位置替换（data 格式 [{"key":"name","x":100,"y":700,"value":"张三","page":0,"fontSize":12}]）
  • PdfGenerateService.generateAndUpload 流程：下载模板 PDF → 按模板类型填充 → 上传 OSS（bj-files-hoolihome 桶 dds/pdf/{worksheetId}/{rowId}/{fileName}.pdf）→ 返回 OSS URL
  • 新增 PdfGenerateLog 实体（101行）记录每次生成操作的完整审计日志（请求参数、响应结果、操作人等）
  • 新增 PdfGenerateLogMapper（14行）MyBatis Mapper
  • build.gradle 新增依赖 org.apache.pdfbox:pdfbox:2.0.32（PDF 处理核心库）
  • 内嵌中文字体 NotoSansSC-Regular.ttf（10.5MB）支持中文文本填充
  • 提交： 8246a7e56（2026-04-10）
  • 涉及文件： MdyPdfController.java、PdfGenerateParam.java、PdfGenerateService.java
  • 改动量： +7行 / -2行
  • 功能说明：
  • PdfGenerateParam 新增 fileName（生成的 PDF 文件名）字段
  • PdfGenerateService 中 OSS 路径由 {timestamp}.pdf 改为 {fileName}.pdf（若为空则用时间戳），使生成的 PDF 文件名更可控

2. feat(erp): 公寓新增字段,新增明道同步逻辑 ⭐ 新增

  • 提交： 210a80187（2026-04-08）
  • 涉及文件： UpdateHouseInfoParam.java、HouseInfoPlatformInfoVo.java、HouseLogVo.java、HouseLogVoBuilder.java、HouseInfo.java
  • 改动量： +88行
  • 功能说明：
  • house_info 表新增 4 个字段：
    • contact_info（公寓联系方式）
    • house_remark（房源信息备注）
    • supplementary_application_info（补充申请信息）
    • attachments（附件，JSON 数组格式存储）
  • 同步在 UpdateHouseInfoParam、HouseInfoPlatformInfoVo 中增加对应字段
  • HouseLogVo 通过 @LogFieldMate 注解支持 4 个新字段的变更日志记录
  • HouseLogVoBuilder.buildVo 中将 4 个新字段写入日志对象
  • 提交： 1ccf23a39（2026-04-08）
  • 涉及文件： HouseController.java、PlatformHouseService.java
  • 改动量： +37行
  • 功能说明：
  • 新增 /house/update/other-info 接口，支持 POST JSON body 修改公寓其他信息（contactInfo、houseRemark、supplementaryApplicationInfo、attachments）
  • 通过 LogRecorder 记录"修改其他信息"操作日志
  • 调用 PlatformHouseService.updateOtherInfo 更新数据后，根据 rowid 是否存在决定调用 MdyOption.ADD_ACTION 或 UPDATE_ACTION
  • 提交： 3fc4c7ea9（2026-04-08）
  • 涉及文件： DistributorUserController.java、DistributorService.java、HouseController.java
  • 改动量： +22行 / -6行
  • 功能说明：
  • DistributorUserController 中将 lastFollowRecordTime 从硬编码 "" 改为调用 distributorService.getLastFollowRecordTime(user.getDId())
  • DistributorService 新增 getLastFollowRecordTime(Integer dId) 方法：查询 crm_leads_follow_record 表中 data_type = distributor 且 data_id = dId 的最新跟进记录，按 create_time desc 取 1 条
  • 同时修正 DistributorService 中创建时间和最后跟进时间的起止查询条件（ge/le 互换，使用 crm_leads_follow_record.data_type = 15）
  • HouseController.updateOtherInfo 接口的 consumes 注解从 MediaType.APPLICATION_JSON_VALUE 改为空（兼容表单提交）
  • 提交： 117fee50d（2026-04-09）
  • 涉及文件： MdyHouse.java、MdyHouseExecutor.java
  • 改动量： +65行 / -24行
  • 功能说明：
  • MdyHouse DTO 字段重排/重命名：
    • hooliId 改名"公寓ID"（原"ID"）
    • countryId、cityId 字段顺序调整
    • 新增 contactInfo（公寓联系方式）、attachments（附件，MDY File 类型）、supplementaryApplicationInfo、houseRemark
    • houseStatus 改名"客户端上下架状态"
    • labelList 标记"（废弃）"
  • 新增 MdyHouseOption 枚举值：type_xueshenggongyu_opt（学生公寓）、type_shehuigongyu_opt（社会公寓）、type_minzhai_opt（民宅）、type_jiudianshigongyu_opt（酒店式公寓）
  • MdyHouseExecutor 实现新增字段的同步逻辑：
    • contactInfo / houseRemark / supplementaryApplicationInfo 直接 set
    • attachments JSON 解析为 DocFileDTO 列表，转为 MdyFile 后写入

3. refactor(mdy): 修改供应商手册明道云同步 ⭐ 优化

  • 提交： 01b259cc2（2026-04-09）
  • 涉及文件： MdyLandlordManualExecutor.java
  • 改动量： +21行 / -8行
  • 功能说明：
  • MdyLandlordManualExecutor 内补充同步逻辑（21 行新增，8 行调整）

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

日期 提交 说明
04/09 0dde64e8b CrmLoginController 微调（1行）
04/09 1e74a9ac7 CrmLoginService 微调（1行）
04/10 3a80d61c1 MdyDistributorExecutor 微调（1行）

📊 本周工作总结

【核心成果】本周主要完成两项重量级功能：data-api服务新增通用PDF生成微服务，提供/mdy/pdf/generate接口，支持acroform和coordinates两种模板填充模式，实现模板下载→内容填充→OSS上传全流程自动化，并配套完整的审计日志记录；erp服务完成公寓模块4个新字段（联系方式、房源备注、补充申请信息、附件）开发及明道云双向同步，同时优化分销商跟进记录的查询逻辑。

【技术亮点】PDF生成采用Apache PDFBox 2.0.32实现，支持中文字体渲染（NotoSansSC 10.5MB）；明道云同步集成HAP标准认证体系，通过ADD_ACTION/UPDATE_ACTION区分新增与更新操作；利用JSON解析实现附件字段的DTO转换，支持结构化数据流转。

【业务价值】PDF生成接口具备高度复用性，后续可快速支撑合同、证明等文档自动生成场景；公寓信息扩展强化了房源精细化管理能力，为后续业务运营提供更丰富的数据支撑。

报告生成时间：2026-07-07

← 返回列表