monthly-2026-06
月报 · 2026年6月
姓名： 邓星星（dengxingxing） 项目： hoolihome-project 分支： production 提交数： 74个（其中29个feat，45个日常修改）
📋 本月工作汇总
按周统计
| 周次 | 日期范围 | 提交数 | 主要工作 |
|---|---|---|---|
| 第23周 | 06/01-06/07 | 12 | 公寓V2接口、PDF升级、房源推荐筛选 |
| 第24周 | 06/08-06/14 | 29 | 企微AI总结、渠道自开发、房型V2、实拍分组 |
| 第25周 | 06/15-06/21 | 17 | 推荐话术模块、小程序分享、精选图优化 |
| 第26周 | 06/22-06/28 | 15 | 批量转移合作方、多封面图预加载、易思汇标签 |
| 第27周 | 06/29-07/05 | 1 | 删除联系人功能 |
按模块统计
| 模块 | 提交数 |
|---|---|
| 房源/房型 | 8 |
| CRM/销售 | 7 |
| 企业微信 | 4 |
| 合作方 | 3 |
| 推荐系统 | 3 |
| 房东/联系人 | 1 |
| 订单/财务 | 1 |
| PDF生成 | 2 |
🛠 详细工作内容
🏠 房源/房型V2
feat(house-v2): 增加公寓信息增量更新接口及实现
- 提交：d08a14cc14b0（2026-06-01）
- +845行，HouseV2Controller、UpdateHouseInfoV2Param(469行)、HouseV2Service(345行)
- 文件变更：
- .../erp/controller/HouseRecommendController.java | 6 -
- .../erp/controller/HouseV2Controller.java | 31 ++
- .../erp/params/UpdateHouseInfoV2Param.java | 469 +++++++++++++++++++++
- .../com/hoolihome/erp/service/HouseV2Service.java | 345 +++++++++++++++
feat(room): 新增V2房型相关接口和功能支持
- 提交：99c60c25d85e（2026-06-09）
- +975行，RoomV2Controller、AddRoomInfoV2Param(194行)、RoomV2Service(505行)、RoomInfoV2Vo、RoomRentAttrVo
- 文件变更：
- .../hoolihome/erp/controller/RoomV2Controller.java | 71 +++
- .../hoolihome/erp/params/AddRoomInfoV2Param.java | 194 ++++++++
- .../com/hoolihome/erp/service/RoomV2Service.java | 505 ++++++++++++++++++++-
- .../java/com/hoolihome/erp/vo/RoomInfoV2Vo.java | 136 ++++++
- .../com/hoolihome/erp/vo/RoomListItemV2Vo.java | 35 ++
- .../java/com/hoolihome/erp/vo/RoomRentAttrVo.java | 43 ++
feat(room): 实现房型增量更新V2接口及服务逻辑
- 提交：2845ae4777bc（2026-06-09）
- +741行，UpdateRoomInfoV2Param(386行)、RoomV2Service(304行)
- 文件变更：
- .../hoolihome/erp/controller/RoomV2Controller.java | 46 +++
- .../erp/params/UpdateRoomInfoV2Param.java | 386 +++++++++++++++++++++
- .../com/hoolihome/erp/service/HouseV2Service.java | 11 +-
- .../com/hoolihome/erp/service/RoomV2Service.java | 304 ++++++++++++++++
feat(service): 新增供应商手册ID字段及关联查询
- 提交：b10b0807b639（2026-06-09）
- +13行，HouseV2Service、LandlordManualService、HouseInfoPlatformInfoV2Vo
- 文件变更：
- .../src/main/java/com/hoolihome/erp/service/HouseV2Service.java | 4 ++++
- .../main/java/com/hoolihome/erp/service/LandlordManualService.java | 4 ++++
- .../main/java/com/hoolihome/erp/vo/HouseInfoPlatformInfoV2Vo.java | 5 +++++
feat(HouseLiveShotMaterial): 新增根据houseId获取实拍素材分组列表接口
- 提交：7702862db93c（2026-06-10）
- +117行，HouseLiveShotMaterialService(65行)、LiveShotMaterialGroupVo(47行)
- 文件变更：
- .../HouseLiveShotMaterialController.java | 5 ++
- .../erp/service/HouseLiveShotMaterialService.java | 65 ++++++++++++++++++++++
- .../hoolihome/erp/vo/LiveShotMaterialGroupVo.java | 47 ++++++++++++++++
feat(house): 优化精选图更新逻辑，支持手动指定精选图
- 提交：0a74da2844f8（2026-06-09）
- +19行，UpdateHouseInfoV2Param、HouseV2Service
- 文件变更：
- .../com/hoolihome/erp/params/UpdateHouseInfoV2Param.java | 10 ++++++++++
- .../main/java/com/hoolihome/erp/service/HouseV2Service.java | 12 +++++++++---
feat(platform): 支持手动指定精选图优先于自动生成
- 提交：b4f41ddba2da（2026-06-24）
- +16行，UpdateHouseInfoParam、PlatformHouseService
- 文件变更：
- .../com/hoolihome/erp/params/UpdateHouseInfoParam.java | 5 +++++
- .../com/hoolihome/erp/service/PlatformHouseService.java | 15 +++++++++++----
feat(house-recommend): 批量预加载多封面图及视频数量
- 提交：f8ee1b563845（2026-06-24）
- +94行，HouseInfoImageBizService(72行)、HouseRecommendService、HouseRecommendVo
- 文件变更：
- .../erp/service/HouseInfoImageBizService.java | 72 ++++++++++++++++++++++
- .../erp/service/HouseRecommendService.java | 18 ++++++
- .../erp/vo/recommend/HouseRecommendVo.java | 4 ++
💼 CRM/销售
feat(qywx): 添加企微群聊天记录AI自动总结功能
- 提交：0d720df22dd5（2026-06-11）
- +919行，QywxChatSummaryAiService(DashScope AI，200行)、QywxChatSummaryService(642行)、QywxChatSummaryJob定时任务、CrmLeadsFollowRecord新增createType字段
- 文件变更：
- .../hoolihome/crm/controller/FollowController.java | 2 +
- .../com/hoolihome/crm/service/CrmLeadsService.java | 14 +
- .../com/hoolihome/crm/service/FollowService.java | 2 +-
- .../data/cron/jobs/qywx/QywxChatSummaryJob.java | 38 ++
- .../src/main/resources/application-pro.yml | 5 +
- .../src/main/resources/application.yml | 10 +-
feat(crm): 新增渠道自开发来源判定及映射
- 提交：bd0f668cda47（2026-06-08）
- +39行，CrmLeadsService、MdySourceOption新增Qudaozikaifa枚举、MdySourceOptionHelper
- 文件变更：
- .../com/hoolihome/crm/service/CrmLeadsService.java | 32 ++++++++++++++++++----
- .../data/mdy/options/MdySourceOption.java | 5 ++++
- .../data/mdy/options/MdySourceOptionHelper.java | 4 +++
- .../data/service/mdy/dto/MdyApplicationForm.java | 1 +
- .../hoolihome/data/service/mdy/dto/MdyLeads.java | 1 +
- .../hoolihome/data/service/mdy/dto/MdyOrder.java | 1 +
feat(filter): 增加多维度筛选条件支持
- 提交：89f3ea3e28b1（2026-06-08）
- +182行，ApplicationFormPageParam、OrderPageParam(82行)、ApplicationFormService、OrderService
- 文件变更：
- .../crm/params/ApplicationFormPageParam.java | 20 ++++++
- .../hoolihome/crm/params/order/OrderPageParam.java | 82 ++++++++++++++++++++++
- .../crm/service/ApplicationFormService.java | 15 ++++
- .../com/hoolihome/crm/service/OrderService.java | 65 +++++++++++++++++
feat(crm): 新增房源推荐话术模块及相关管理功能
- 提交：f7ed666c9b88（2026-06-15）
- +338行，RecommendScriptBizService(338行)、RecommendScriptController(120行)、RecommendScriptVo(79行)、多个Param
- 文件变更：
- .../erp/controller/RecommendScriptController.java | 120 ++++++++
- .../erp/params/RecommendScriptAddParam.java | 38 +++
- .../erp/params/RecommendScriptPageParam.java | 41 +++
- .../erp/params/RecommendScriptTagAddParam.java | 25 ++
- .../erp/params/RecommendScriptUpdateParam.java | 41 +++
- .../erp/service/RecommendScriptBizService.java | 338 +++++++++++++++++++++
feat(recommendScript): 批量保存自定义标签支持新增、更新和删除
- 提交：14a837869b02（2026-06-17）
- +186行，RecommendScriptBizService(181行)、RecommendScriptTagBatchSaveParam(59行)
- 文件变更：
- .../erp/controller/RecommendScriptController.java | 50 ++----
- .../params/RecommendScriptTagBatchSaveParam.java | 59 +++++++
- .../erp/service/RecommendScriptBizService.java | 181 ++++++++++++---------
- .../entity/crm/CrmRecommendScriptTag.java | 8 +
feat(recommend): 添加自定义标签修改接口，仅允许修改自身标签
- 提交：e1fb285f7987（2026-06-17）
- +48行，RecommendScriptController、RecommendScriptBizService
- 文件变更：
- .../erp/controller/RecommendScriptController.java | 16 +++++++++++
- .../erp/service/RecommendScriptBizService.java | 32 ++++++++++++++++++++++
feat(leads): 批量转移合作方接口实现
- 提交：d84cc12decba（2026-06-24）
- +34行，LeadsController
- 文件变更：
- .../hoolihome/crm/controller/LeadsController.java | 34 ++++++++++++++++++++++
🔗 合作方
feat(distributor): 实现合作方企业批量字段更新功能
- 提交：eed7b931dc38（2026-06-10）
- +134行，DistributorCompanyController、DistributorService(96行)
- 文件变更：
- .../controller/DistributorCompanyController.java | 52 ++++++++----
- .../hoolihome/crm/service/DistributorService.java | 96 ++++++++++++++++++++++
feat(distributor): 增加合作方用户指定字段批量增量更新功能
- 提交：7f35877104a8（2026-06-10）
- +103行，DistributorUserController、DistributorUserParam、DistributorService(49行)
- 文件变更：
- .../crm/controller/DistributorUserController.java | 48 +++++++++++++++++++++
- .../hoolihome/crm/params/DistributorUserParam.java | 6 +++
- .../hoolihome/crm/service/DistributorService.java | 49 ++++++++++++++++++++++
feat(distributor): 添加手机号重复检查功能
- 提交：908ad868baf6（2026-06-08）
- +32行，DistributorUserController、DistributorService
- 文件变更：
- .../crm/controller/DistributorUserController.java | 6 +++++
- .../hoolihome/crm/service/DistributorService.java | 26 ++++++++++++++++++++++
📊 推荐系统
feat(recommendation): 添加销售推荐筛选及排序功能
- 提交：5249da010589（2026-06-04）
- +48行，HouseRecommendParam、HouseRecommendService(49行)
- 文件变更：
- .../hoolihome/erp/params/HouseRecommendParam.java | 8 +++-
- .../erp/service/HouseRecommendService.java | 49 ++++++++++++++++++----
feat(recommendation): 增加基于成单数的房源推荐功能
- 提交：1fd51b21ae6d（2026-06-05）
- +96行，HouseRecommendParam、HouseRecommendService(81行)、HouseRecommendVo
- 文件变更：
- .../erp/controller/HouseRecommendController.java | 2 +-
- .../hoolihome/erp/params/HouseRecommendParam.java | 7 ++
- .../erp/service/HouseRecommendService.java | 81 +++++++++++++++++++++-
- .../erp/vo/recommend/HouseRecommendVo.java | 9 +++
feat(house-recommend): 新增小程序分享链接生成接口
- 提交：77a178fc2606（2026-06-12）
- +62行，HouseRecommendController、HouseRecommendShareParam(25行)、HouseRecommendService(30行)
- 文件变更：
- .../erp/controller/HouseRecommendController.java | 8 ++++++
- .../erp/params/HouseRecommendShareParam.java | 25 ++++++++++++++++++
- .../erp/service/HouseRecommendService.java | 30 +++++++++++++++++++++-
💬 企业微信
feat(qywx): 添加易思汇标签自动绑定功能
- 提交：6a560a463fe9（2026-06-25）
- +296行，YiSiHuiLeadsLabelService(208行)、YiSiHuiLeadsLabelJob定时任务、QywxGroupsService、application-pro.yml配置
- 文件变更：
- .../crm/service/group/QywxGroupsService.java | 44 +++++
- .../data/cron/jobs/qywx/YiSiHuiLeadsLabelJob.java | 33 ++++
- .../src/main/resources/application-pro.yml | 5 +
- .../src/main/resources/application-test.yml | 7 +-
- .../service/qywx/YiSiHuiLeadsLabelService.java | 208 +++++++++++++++++++++
fix(qywx): 优化聊天摘要AI服务的输出格式和内容要求
- 提交：c4ab29147db9（2026-06-15）
- +9行，QywxChatSummaryAiService，改进AI输出格式
- 文件变更：
- .../data/service/qywx/QywxChatSummaryAiService.java | 14 +++++++++-----
fix(qywx): 更新成交概率预估格式说明
- 提交：7b34a5484e7f（2026-06-17）
- +1行，修改成交概率为百分比格式 1%-100%
- 文件变更：
- .../java/com/hoolihome/data/service/qywx/QywxChatSummaryAiService.java | 2 +-
📄 PDF生成
chore(pdf): 升级 PDFBox 至 3.0.2 并优化字体加载兼容性
- 提交：ec3f6d658c6a（2026-06-04）
- +26行/-40行，PdfGenerateService，Loader.loadPDF替换PDDocument.load
- 文件变更：
- .../hoolihome-data-api/build.gradle | 2 +-
- .../data/api/service/PdfGenerateService.java | 64 +++++++++-------------
refactor(pdf): 优化坐标替换批量渲染流程并启用字体子集化
- 提交：76a477e10431（2026-06-04）
- +94行/-73行，PdfGenerateService，引入ParsedTextItem内部类
- 文件变更：
- .../data/api/service/PdfGenerateService.java | 167 ++++++++++++---------
💰 订单/财务
fix(order): 取消订单时自动取消关联的返现推荐费和礼赠服务记录
- 提交：14f6da75ca5a（2026-06-10）
- +67行，OrderController，cancelRelatedRecords()方法
- 文件变更：
- .../hoolihome/crm/controller/OrderController.java | 67 ++++++++++++++++++++++
🏠 房东/联系人
feat(landlord): 添加删除联系人功能
- 提交：5f84d13e78d9（2026-06-30）
- +19行，LandlordController、LandlordService
- 文件变更：
- .../java/com/hoolihome/erp/controller/LandlordController.java | 9 +++++++++
- .../main/java/com/hoolihome/erp/service/LandlordService.java | 10 ++++++++++
📊 本月工作总结
【核心成果】本月完成了房源/房型V2体系的核心建设，实现了公寓信息与房型数据的增量更新V2接口，支持手动指定精选图并优先于自动生成；同时搭建了企微群聊AI自动总结能力（集成DashScope AI），并通过定时任务实现易思汇标签自动绑定。在CRM侧，新增渠道自开发来源判定、多维度筛选条件及房源推荐话术全生命周期管理；合作方模块支持企业及用户的批量字段增量更新。推荐系统新增基于成单数的房源推荐与小程序的分享链接生成功能。
【技术亮点】V2接口采用参数对象封装增量字段，共新增约2561行代码；AI摘要服务优化输出格式并支持1%-100%成交概率预估；PDF生成模块升级至PDFBox 3.0.2，引入坐标替换批量渲染及字体子集化，净增70行；通过定时任务（YiSiHuiLeadsLabelJob、QywxChatSummaryJob）实现异步标签绑定与聊天总结。
【业务价值】房源V2体系支撑公寓与房型数据独立运营，推荐话术模块赋能销售高效转化，企微AI摘要降低人工跟进成本，批量更新能力显著提升合作方运营效率，整体为房源管理-获客-转化全链路提供系统化支撑。
报告生成时间：2026-07-14