周报 · 2026年第10周（03月02日-03月08日）

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

📋 本周工作汇总

按日期统计

按模块统计

🛠 详细工作内容

1. feat: 平台用户表字段清理 + 账号体系全面重构 ⭐ 新增

• 提交： 988e7e79a（2026-03-03）
• 涉及文件： PlatformUserController.java、CreatePlatformUserParam.java、PlatformUserParam.java、UpdatePlatformUserParam.java、AdminRoleService.java、DepartmentService.java、PlatformUserService.java、ReportRelationVo.java、CommonService.java、QywxContactService.java、PlatformLoginController.java、QyWxCustomerController.java、QywxService.java、PlatformUser.java、PlatformUserMapper.java、CommonCodeGen.java 等 16 个文件
• 改动量： +665行 / -194行
• 功能说明：
• 平台用户（platform_user）表结构与相关字段大幅重构，从企微绑定字段改为多部门 JSON 字段 department_id_list、main_department_id、account_type（员工/二级代理）、employment_status（在职/离职）、agency_id（所属代理）等业务字段
• 新增 createAccount 方法实现完整的账号创建流程：手机号/邮箱排重 → 构建实体（含中文名→拼音自动转换）→ 设置账号类型、在职状态、所属代理 → 保存并生成 token
• 列表查询从单部门 ID 改为 JSON_CONTAINS 查询 department_id_list，支持多部门匹配
• 详情 VO 中从 departmentList 字段读取部门列表，主部门排在最前

2. feat(crm): 新增投诉建议接口 ⭐ 新增

• 提交： 03399d4d1（2026-03-06）
• 涉及文件： FeedbackController.java、FeedbackPageParam.java、FeedbackService.java
• 改动量： +159行
• 功能说明：
• 新增 /feedback/list（分页查询投诉建议）和 /feedback/info（详情）接口
• FeedbackPageParam 支持关键词搜索（投诉内容/手机号）和投诉类型筛选（1=客户投诉，2=合作方投诉）
• FeedbackService.getPageList 支持按内容/手机号模糊匹配，按类型精确过滤，按创建时间倒序
• parseDetail 方法丰富详情展示：投诉人、合作方用户名、合作方公司名、投诉时间（格式化）等

3. feat(admin): 账号新增别名字段 ⭐ 新增

• 提交： 5f86ebfc2（2026-03-06）
• 涉及文件： CreatePlatformUserParam.java、UpdatePlatformUserParam.java、PlatformUserService.java、PlatformUser.java、PlatformUserMapper.java
• 改动量： +17行 / -2行
• 功能说明：
• 平台用户表新增 alias 别名字段（数据库列 alias），并补充对应常量 PlatformUser.ALIAS = "alias"
• 创建参数 CreatePlatformUserParam 和更新参数 UpdatePlatformUserParam 增加 alias 字段
• 服务层 parseList VO 中返回 alias，createAccount 与 updateUserInfo 中分别读取并保存 alias

4. feat(admin): 新增二级代理机构维护逻辑 ⭐ 新增

• 提交： e8daea8df（2026-03-04）
• 涉及文件： PlatformUserAgencyController.java、PlatformUserAgencyParam.java、PlatformUserAgencyService.java、PlatformUserService.java、PlatformUser.java、PlatformUserAgency.java、PlatformUserAgencyMapper.java、PlatformUserMapper.java、IPlatformUserAgencyService.java、PlatformUserAgencyServiceImpl.java 等 10 个文件
• 改动量： +254行 / -10行
• 功能说明：
• 新建 platform_user_agency 表（机构名、ID 自增）以及 MyBatis Mapper / Service / IService / ServiceImpl 完整四层结构
• 新增 /platform-user-agency/list、/platform-user-agency/create、/platform-user-agency/update 三个管理接口
• 服务层提供 create 和 update 方法实现名称排重（新增全局唯一，编辑时排除自身）
• 平台用户详情 VO 中将 agencyId 改为返回完整 agency 对象（从 IPlatformUserAgencyService 读取）
• 时间戳字段类型由 Integer（秒级）改为 Long（毫秒级），新增时间戳自动按毫秒存储；VO 层对毫秒/秒时间戳做兼容解析

5. refactor(qywx): 修改企业微信数据同步绑定平台用户逻辑 ⭐ 重构

• 提交： b441c9500（2026-03-05）
• 涉及文件： CrmLoginController.java、PlatformUserService.java、MdyPlatformUser.java、MdyPlatformUserExecutor.java、QywxContactService.java
• 改动量： +142行 / -212行
• 功能说明：
• 调整 CRM 登录入口：CrmLoginController 校验用户时新增 isStaff == 1 判定，过滤二级代理账号
• 平台用户 createAccount 与 updateUserInfo 末尾分别调用 MdySyncProcessor.add/update 触发明道云数据同步（应用 ID 6078e459ab26615775825ed4）
• 重构明道云 DTO MdyPlatformUser：字段重命名/调整（userName 改为"姓名"、statusText 改名"在职状态"、新增 accountType 账号类型、state 启用状态、remark 备注、reportToUid 直属上级等）
• 同步修复"个人简介""服务客户""工作经验""主部门""企微账号"等标记为"（废弃）"，新增启用状态等业务字段
• 简化 QywxContactService 逻辑：删除企微联系人同步相关中间字段，直接复用 PlatformUser 表

6. feat(qywx): 修改Token生成方式 ⭐ 重构

• 提交： b57e13b0d（2026-03-05）
• 涉及文件： QywxAuthController.java、CreatePlatformUserParam.java、UpdatePlatformUserParam.java、CrmLoginService.java、PlatformUserService.java、ParamFilter.java、AdviserVo.java
• 改动量： +15行 / -46行
• 功能说明：
• 调整企微扫码登录 (QywxAuthController.callback) 的 Token 生成路径：弃用本地拼接 "wecom-" + randomString 方式，改为统一调用 crmLoginService.buildLoginResponse
• 移除 CreatePlatformUserParam / UpdatePlatformUserParam 中已废弃的 servedUsersText（服务客户）与 workExperience（工作经历）字段
• ParamFilter 中临时屏蔽通过企微入口刷新 token 过期时间的逻辑（注释一行，避免 token 过期被异常延长）
• AdviserVo 中临时屏蔽 workExperience 字段返回，后续按字段迭代再启用

7. feat(admin): 新增 updateUserInfo + 个人简介/服务客户/工作经历字段 ⭐ 新增

• 提交： 47ef9dfb8（2026-03-05）
• 涉及文件： PlatformUserController.java、CreatePlatformUserParam.java、UpdatePlatformUserParam.java、PlatformUserService.java
• 改动量： +54行 / -1行
• 功能说明：
• 新增 /platform-user/update-user-info 接口，允许通过当前登录者更新本人头像（仅头像字段）
• 创建/更新参数均新增 introduction（个人简介）、servedUsersText（服务用户）、workExperience（工作经历）字段
• 服务层 updateUserInfo 内同步更新 updateUid、updateTime、updateTimestamp
• createAccount 与 updateUserInfo 内将上述三字段一并写入用户实体

8. feat(admin): 新增查询条件（平台用户/二级代理 keyword 搜索） ⭐ 优化

• 提交： 3108c328b（2026-03-05）
• 涉及文件： PlatformUserAgencyParam.java、PlatformUserParam.java、PlatformUserAgencyService.java、PlatformUserService.java
• 改动量： +21行 / -1行
• 功能说明：
• 平台用户列表 keyword 搜索范围扩大：原本只匹配用户名/手机号/职位名，新增匹配邮箱（EMAIL）和备注（REMARK）
• PlatformUserParam 新增 agencyId 查询条件，服务层 getPageList 拼装 AGENCY_ID 等值过滤
• 二级代理列表 PlatformUserAgencyParam 新增 keyword，服务层支持纯数字按 ID 精确匹配、按名称模糊匹配

9. refactor(crm): 清理 LeadsController 旧接口 + ClientFeedbackController ⭐ 优化

• 提交： 1e0bff430（2026-03-09）
• 涉及文件： LeadsController.java、CrmLeadsService.java、ClientFeedbackController.java
• 改动量： +52行 / -248行
• 功能说明：
• LeadsController 中清理大量已注释的废弃方法（application/update、application/update-by-user、application-info、follow/add 等），减少 247 行历史遗留代码
• CrmLeadsService 与 ClientFeedbackController 内补全客户端反馈相关的辅助方法（11行新增）

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

📊 本周工作总结

【核心成果】本周完成平台账号体系全面重构，支撑多层级代理业务模式。新增投诉建议功能模块，完善二级代理机构维护后台，实现企微扫码登录与明道云数据同步流程统一优化。

【技术亮点】采用 JSON 数组字段存储多部门信息，通过 JSON_CONTAINS 实现灵活部门匹配查询；时间戳统一升级为毫秒级，VO 层做双精度兼容处理；账号创建流程集成中文名自动转拼音引擎；明道云同步采用 DTO 解耦重构，新增账号类型、在职状态等业务字段映射。

【业务价值】账号体系从企微绑定模式转向自主多层级管理，支持员工/二级代理分类及所属机构关联，为后续代理分润体系

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