周报 · 2026年第35周（08月24日-08月30日）

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

📋 本周工作汇总

按日期统计

按模块统计

🛠 详细工作内容

feat(utils): 优化拼音转换逻辑及集成测试覆盖

• 提交： a77fb3a86db6（2026-08-26）
• 改动概述： 新增 PinyinHelper 工具类，修复原有拼音工具的中英文混合字符串转换bug，支持中英文/Emoji/数字混合场景，添加完整单元测试
• 涉及文件：
• hoolihome-api-pom/hoolihome-crm-api/build.gradle (+2行)
• hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/service/PlatformUserService.java (±6行，两处调用替换)
• hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/admin/utils/PinyinHelper.java (+83行，新增)
• hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/admin/utils/PinyinHelperTest.java (+129行，新增)
• 详细改动：
• 新增 PinyinHelper 工具类，通过 Unicode 码点范围（\u4e00-\u9fa5）判断中文字符，仅对中文部分调用 PinyinUtil.getPinyin()，英文/数字/Emoji/符号等非中文内容原样保留
• 修复了原有 PinyinUtil 对 "Hooli租房小助手" 错误拆分为 "H o o l i zu fang xiao zhu shou ? ?" 的问题
• 在 PlatformUserService 的创建用户和更新用户两处拼音设置逻辑中，替换原有 PinyinUtil.getPinyin() 为 PinyinHelper.toPinyinName()
• 添加 pinyin4j:2.5.1 依赖
• 编写 PinyinHelperTest 单元测试，覆盖纯中文、纯英文、中英混合、数字、emoji、特殊符号、空值、全角空格、多音字等11种场景

feat(utils): 优化拼音转换逻辑及集成测试覆盖（集成测试）

• 提交： 8d5c315a591b（2026-08-26）
• 改动概述： 新增平台用户拼音批量同步集成测试
• 涉及文件： hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/test/PlatformUserPinyinTest.java (+31行)
• 详细改动：
• 新增 PlatformUserPinyinTest 集成测试类，用于对现有平台用户批量同步更新拼音名称
• 注入 IPlatformUserService，遍历所有用户名非空的平台用户，调用 PinyinHelper.toPinyinName() 重新计算拼音并更新

fix(referral): 修正推荐费相关服务调用及对象类型

• 提交： 74f2be14a46f（2026-08-25）
• 改动概述： 修正 ReferralController 中 MDY 数据同步的对象类型调用错误，添加 MdyReferralExecutor 空指针防护
• 涉及文件：
• hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/ReferralController.java (±6行，3处)
• hoolihome-api-pom/hoolihome-data-pom/hoolihome-mdy-service/src/main/java/com/hoolihome/data/service/mdy/executor/impl/MdyReferralExecutor.java (+4行)
• 详细改动：
• ReferralController.add() 中 commonService.addToMdy() 的对象类型从 CashBack 修正为 Referral
• ReferralController.review() 中 commonService.updateToMdy() 的对象类型从 CashBack 修正为 Referral
• ReferralController.cancel() 中 commonService.updateToMdy() 的对象类型从 CashBack 修正为 Referral
• MdyReferralExecutor.hooli2Mdy() 方法添加 null 检查：若 referralService.getById() 返回 null 则直接返回 null，避免空指针异常

fix(wallet): 更新提现描述的预计到账时间

• 提交： 764112409188（2026-08-28）
• 改动概述： 更新提现申请描述文本中的预计到账时间范围，使用户对资金到账周期有更清晰预期
• 涉及文件： hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/wallet/vo/WithdrawalRequestVo.java (±1行)
• 详细改动：
• withdrawalDesc 字段默认值从 "提现申请已提交，预计本月20号至月底期间打款，请您耐心等待" 修改为 "提现申请已提交，预计本月底至次月中到账，请您耐心等待"

📊 本周工作总结

【核心成果】本周完成拼音转换工具的重构优化，修复了原工具将英文字母逐字拆分的bug，同时修正了推荐费服务的对象类型错误并更新了提现文案描述。

【技术亮点】新增 PinyinHelper 工具类，通过 Unicode 字符范围判断实现中英文混合字符串的精准转换，仅对中文字符执行拼音转换，英文、数字、emoji 等符号原样保留，修复了原有 PinyinUtil 对 "ABC" 拆分为 "A B C" 的问题；该工具已在 PlatformUserService 两处调用点完成替换，并编写了覆盖 11 种场景的单元测试及集成测试；此外在 ReferralController 中将 addToMdy/updateToMdy 的对象类型从 CashBack 修正为 Referral，在数据同步链路中消除了潜在的运行时类型转换异常。

【业务价值】拼音转换能力已集成至平台用户服务，将在用户昵称、地址等字段的搜索优化中发挥作用，提升中文环境下模糊匹配准确性；提现描述调整为"本月底至次月中到账"，使用户对资金到账周期有更清晰的预期，降低客服咨询量；推荐费类型修正保障了 MDY 系统与主平台数据同步的准确性，确保推荐奖励计算链路的稳定性。

报告生成时间：2026-08-28 18:00