weekly-2026-W46
周报 · 2026年第46周(11月09日 - 11月15日)
姓名: 邓星星(dengxingxing) 项目: hoolihome-project 分支: production 提交数: 13 个(含 12 个功能提交)
📋 本周工作汇总
按日期统计
| 日期 | 提交数 | 主要内容 |
|---|---|---|
| 11/09 周一 | 2 | 支持视频完整源地址及安全下载链接;新增新媒体日报提交通知功能 |
| 11/10 周二 | 4 | 增加新媒体线索对接同事和主运营归属字段及权限同步;支持视频文件ID的准确序列化和反序列化;废弃用户运营功能,调整新媒体主运营权限逻辑 … |
| 11/11 周三 | 2 | 优化手机号列表接口,批量查询关联平台及平台头像;新增新媒体主运营员工ID筛选功能 |
| 11/12 周四 | 5 | 新增新媒体账号审计字段及相关功能支持;新增及完善账号绑定主账号等关联字段功能;优化房间排序逻辑及增量更新行为 … |
| 11/13 周五 | 0 | — |
| 11/14 周六 | 0 | — |
| 11/15 周日 | 0 | — |
按模块统计
| 模块 | 提交数 |
|---|---|
| 新媒体运营 | 4 |
| 订单中心 | 3 |
| 视频/内容 | 2 |
| CRM/销售 | 2 |
| 移动端 | 1 |
| 房源/房型 | 1 |
🛠 详细工作内容
1. feat(video): 支持视频完整源地址及安全下载链接 ⭐ 新增
- 提交:
0ccf9723cc78(2026-11-09) - 模块: 视频/内容
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/RoomController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/LiveShotAdminVideoPreview.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/LiveShotWatermarkAdminPreviewTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/vo/VideoDownloadResponseTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/vo/VideoSourceWriteTest.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/common/controller/MdyFileController.java、hoolihome-api-pom/hoolihome-user-api/src/main/java/com/hoolihome/platform/controller/PlatformCommentController.java、hoolihome-api-pom/hoolihome-user-api/src/test/java/com/hoolihome/user/controller/open/OrderCommentVideoReadTest.java等 21 个文件 - 改动量: +460 行 / -35 行
- 功能说明: 房间视频展示改为从 OSS 文件服务按房间数据 ID 批量映射,视频播放列表不再直接使用房间记录中的旧
videoUrl字段,避免把播放地址误当作完整文件地址。管理员视频预览仅在地址属于完整视频源时提供下载或静音下载链接,HLS 播放列表等非完整文件地址会被过滤,并保留现有完整源地址回退逻辑。相关测试补充了旧版 m3u8 地址不可作为完整文件下载的校验,以及下载与播放地址分离的响应验证。
@@ -228,4 +228,7 @@ public class RoomController {
dataRoomIdList.add(it.getId());
});
+ var currentVideos = iHomeOssFilesService.mapVideoByDataId(
+ dataRoomIdList.stream().map(String::valueOf).collect(Collectors.toSet()),
+ IHomeOssFilesService.DataType.DATA_TYPE_ROOM_HOME);
var roomAttrMap = roomService.mapAllRoomAttrByRoomId(dataRoomIdList);
var roomFacilityMap = houseRelTagService.mapHouseFacilityTagByRelationId(dataRoomIdList, HouseEnum.REL_TYPE_ROOM.getCode());
@@ -239,4 +242,5 @@ public class RoomController {
vo.setRentStatusText(RoomEnum.getByAttrStatus(vo.getRentStatus()).map(RoomEnum::getDescription).orElse(StrUtil.EMPTY));
vo.setImageNum(vo.getImgUrlList().size());
+ vo.setVideoUrlList(currentVideos.getOrDefault(room.getId().toString(), Collections.emptyList()));
vo.setVideoNum(vo.getVideoUrlList().size());
vo.setFacilityTagCount(roomFacilityMap.getOrDefault(room.getId(), Collections.EMPTY_LIST).size());
2. feat(new-media-daily): 新增新媒体日报提交通知功能 ⭐ 新增
- 提交:
d507025a3594(2026-11-09) - 模块: 新媒体运营
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/newmediadaily/NewMediaDailyService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/query/ApplicationFormPageQueryService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/query/OrdinaryQueryHttpTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/newmediadaily/NewMediaDailyNotificationTest.java - 改动量: +99 行 / -5 行
- 功能说明: 新媒体日报保存失败或未生成 ID 时立即抛出异常,避免返回无效记录;生产环境下保存成功后复用企业微信通知机制,向指定用户(15882)推送包含日报日期和编号的提交通知,提醒相关人员及时查看。
同时,申请单列表查询新增按关联客户名称匹配关键词的能力,并通过参数化EXISTS查询避免 SQL 注入,保留原有权限范围和状态筛选条件。
补充测试覆盖中文关键词查询及新媒体日报通知相关逻辑,保证筛选结果和通知流程符合预期。
@@ -11,4 +11,5 @@ import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.hoolihome.common.constants.DeviceType;
+import com.hoolihome.common.provider.NotificationProvider;
import com.hoolihome.common.query.permission.DataPermissionProvider;
import com.hoolihome.common.query.permission.ReportRelationProvider;
@@ -31,4 +32,6 @@ import com.hoolihome.jo.page.PageBean;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
+import org.springframework.core.env.Environment;
+import org.springframework.core.env.Profiles;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
@@ -55,4 +58,6 @@ import java.util.stream.Collectors;
3. feat(crm): 增加新媒体线索对接同事和主运营归属字段及权限同步 ⭐ 新增
- 提交:
2360594b61e6(2026-11-10) - 模块: CRM/销售
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/log/dto/MediaLeadLog.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/medialead/IncrementalUpdateMediaLeadParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/medialead/MediaLeadService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/medialead/MediaLeadUpdateService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/medialead/MediaLeadUpdateTest.java - 改动量: +231 行 / -40 行
- 功能说明: 新增新媒体线索的“对接同事”和“账号主运营”字段,并在增量更新时通过自定义反序列化校验员工 ID 必须为整数,同时记录字段变更以支持增量更新。对接同事可获得线索读写权限,主运营可获得线索只读权限;当主运营与对接同事为同一人时,不重复授予主运营权限。线索归属信息发生变更时,会同步迁移或清理原有角色权限,确保数据权限与最新归属保持一致。
@@ -112,4 +112,10 @@ public class MediaLeadLog {
private Integer newMediaId;
+ @LogFieldMate(fieldName = "对接同事", fieldType = LogFieldType.OBJECT, service = PlatformUserServiceImpl.class, dataControl = "userName")
+ private Integer bdId;
+
+ @LogFieldMate(fieldName = "账号主运营", fieldType = LogFieldType.OBJECT, service = PlatformUserServiceImpl.class, dataControl = "userName")
+ private Integer newMediaMainServiceId;
+
@LogFieldMate(fieldName = "负责人", fieldType = LogFieldType.OBJECT, service = PlatformUserServiceImpl.class, dataControl = "userName")
private Integer agentId;
@@ -2,5 +2,9 @@ package com.hoolihome.crm.params.medialead;
import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.alibaba.fastjson.JSONException;
import com.alibaba.fastjson.annotation.JSONField;
4. feat(contentplan): 支持视频文件ID的准确序列化和反序列化 ⭐ 新增
- 提交:
25c3d08508c0(2026-11-10) - 模块: 视频/内容
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/contentplan/ContentPlanService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/contentplan/ContentPlanInfoVo.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/LiveShotAdminVideoPreview.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/vo/VideoDownloadResponseTest.java - 改动量: +64 行 / -5 行
- 功能说明: 本次提交针对视频文件 ID 为超出 JavaScript 安全整数范围的长整型时,可能在 JSON 传输中丢失精度的问题进行了修复。内容计划视频列表改为使用专用
Video类型,并通过 Fastjson 和 Jackson 将fileId序列化为字符串;直播素材预览响应也在fileId存在时统一转为字符串。新增测试验证内容计划和直播素材视频经过 JSON 序列化、反序列化后仍能准确还原文件 ID,并兼容旧格式的数字类型 ID。
@@ -1,4 +1,5 @@
package com.hoolihome.crm.service.contentplan;
+import cn.hutool.core.bean.BeanUtil;
import cn.hutool.core.collection.CollectionUtil;
import cn.hutool.core.date.DateUtil;
@@ -338,5 +339,7 @@ public class ContentPlanService {
.map(houseNameMap::get).filter(Objects::nonNull).collect(Collectors.toList()));
vo.setImages(ossFilesService.listImageByDataId(dataId, dt));
- vo.setVideos(ossFilesService.listVideoByDataId(dataId, dt));
+ vo.setVideos(ossFilesService.listVideoByDataId(dataId, dt).stream()
+ .map(video -> BeanUtil.copyProperties(video, ContentPlanInfoVo.Video.class))
+ .collect(Collectors.toList()));
vo.setDocs(ossFilesService.listFileByDataId(dataId, dt));
vo.setPermission(getPermission(id, platformUserId));
5. refactor(media-lead): 废弃用户运营功能,调整新媒体主运营权限逻辑 ♻️ 重构
- 提交:
2fc3db977146(2026-11-10) - 模块: 新媒体运营
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/MediaLeadController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/CrmLeadsPageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/CrmLeadsParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/LeadsPageQuery.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/medialead/IncrementalUpdateMediaLeadParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/medialead/NewMediaPageQuery.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/CrmLeadsService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/leads/LeadsAiPrefillAssociations.java等 19 个文件 - 改动量: +429 行 / -227 行
- 功能说明: 重构新媒体线索的创建与更新流程:创建时校验当前登录用户及新媒体账号状态,并将账号对象交给业务服务统一处理线索归属信息;更新时改为调用
mediaLeadUpdateService.updateDetails,集中维护线索基本信息。详情接口通过mediaLeadService.canWrite统一判断读写权限,并补充新媒体主运营人员姓名展示,同时停用线索负责人更新接口、明确提示已废弃。
@@ -5,5 +5,4 @@ import cn.hutool.core.util.NumberUtil;
import cn.hutool.core.util.StrUtil;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
-import com.hoolihome.common.query.permission.DataPermissionProvider;
import com.hoolihome.common.constants.ObjectDataTypeEnum;
import com.hoolihome.common.constants.SourceEnum;
@@ -43,4 +42,5 @@ import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
+import java.util.Objects;
import java.util.stream.Collectors;
@@ -69,6 +69,4 @@ public class MediaLeadController {
private final ICrmMediaLeadDuplicateSetService iCrmMediaLeadDuplicateSetService;
- private final DataPermissionProvider adminRoleService;
6. feat(mobile): 优化手机号列表接口,批量查询关联平台及平台头像 ⭐ 新增
- 提交:
0e4745bb86be(2026-11-11) - 模块: 移动端
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/newmediaasset/NewMediaMobileService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/newmediaasset/NewMediaAccountRefVo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/newmediaasset/NewMediaAccountAssetsTest.java - 改动量: +71 行 / -3 行
- 功能说明: 手机号列表接口在查询关联新媒体账号时,先按账号 ID 集合批量获取账号,再根据账号的平台 ID 批量查询平台信息,避免为每个账号单独查询平台。返回的账号引用新增平台名称、头像等平台信息,并将平台信息与账号昵称一并组装到手机号列表响应中,便于移动端展示账号归属平台及头像。同步补充测试覆盖批量查询并验证平台信息随账号返回。
@@ -9,4 +9,5 @@ import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.hoolihome.crm.params.newmediaasset.*;
import com.hoolihome.crm.vo.newmediaasset.*;
+import com.hoolihome.crm.vo.newmedia.SimpleNewMediaPlatformVo;
import com.hoolihome.entity.home.*;
import com.hoolihome.home.service.*;
@@ -29,4 +30,6 @@ public class NewMediaMobileService {
private final INewMediaWechatService wechats;
private final NewMediaAssetSupport support;
+ private final INewMediaAccountService accountService;
+ private final INewMediaPlatformService platformService;
public PageBean<NewMediaMobileItemVo> list(NewMediaMobilePageQuery param) {
@@ -57,5 +60,15 @@ public class NewMediaMobileService {
.collect(Collectors.groupingBy(NewMediaMobileAccountRel::getMobileId,
7. feat(order): 新增新媒体主运营员工ID筛选功能 ⭐ 新增
- 提交:
518808d2bee0(2026-11-11) - 模块: 订单中心
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/OrderPageQuery.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/query/OrderPageQueryService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/query/OrdinaryPageQueryTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/common/query/OrdinaryQueryHttpTest.java - 改动量: +58 行 / -0 行
- 功能说明: 订单分页查询参数新增
newMediaMainServiceIdList,支持按订单保存的新媒体主运营员工 ID 进行多选筛选,并在查询条件中生成对应的IN条件。该筛选与订单状态、数据权限等其他条件共同生效,空列表表示不限制主运营员工归属,同时拒绝包含空 ID 的参数。分页查询与全量选择接口共用相同的筛选逻辑,并补充测试验证多选、无匹配及未分配订单等场景。
@@ -138,4 +138,7 @@ public class OrderPageQuery extends OrdinaryPageQuery {
private List<Long> newMediaIdList;
+ /** 新媒体主运营员工ID多选,按订单保存的归属筛选;空数组表示不筛选 */
+ private List<Long> newMediaMainServiceIdList;
+
/** 新媒体平台多选;空数组表示不筛选 */
private List<Long> newMediaPlatformList;
@@ -101,4 +101,5 @@ public class OrderPageQueryService {
in(q, OrderInfo.SOURCE_USER_ID, p.getSourceUserIdList());
in(q, OrderInfo.NEW_MEDIA_ID, p.getNewMediaIdList());
+ in(q, OrderInfo.NEW_MEDIA_MAIN_SERVICE_ID, p.getNewMediaMainServiceIdList());
in(q, OrderInfo.NEW_MEDIA_PLATFORM, p.getNewMediaPlatformList());
in(q, OrderInfo.COUNTRY_ID, p.getCountryIdList());
@@ -144,4 +144,30 @@ class OrdinaryPageQueryTest {
8. feat(crm): 新增新媒体账号审计字段及相关功能支持 ⭐ 新增
- 提交:
8a02244a0d6a(2026-11-12) - 模块: CRM/销售
- 涉及文件:
docs/dev_v2_filter/sql/new_media_account_audit_fields.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/NewMediaAccountController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/newmedia/NewMediaAccountVo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/newmediaasset/NewMediaAccountAssetsTest.java、hoolihome-mybatis-facade-pom/hoolihome-mybatis-facade-common/src/main/java/com/hoolihome/entity/home/NewMediaAccount.java - 改动量: +154 行 / -1 行
- 功能说明: 为新媒体账号补充创建人、更新人及创建/更新时间等审计字段,并提供可重复执行的数据库变更脚本,历史数据保留为空。账号新增时记录当前操作用户和时间,更新时刷新更新人及更新时间,以支持操作来源追踪。列表/详情返回中新增审计字段对应的用户信息,并将创建人和更新人纳入顾问信息批量解析,便于前端展示账号操作记录。
--- /dev/null
@@ -0,0 +1,41 @@
+-- 新媒体账号审计字段。部署新版API前,在明确授权的目标库执行。
+-- 历史值留NULL;历史回补须依据账号原记录明确核对,详情读取账号主表。
+SET SESSION lock_wait_timeout = 5;
+SET SESSION innodb_lock_wait_timeout = 5;
+
+SET @new_media_audit_column_exists = (SELECT COUNT(*) FROM information_schema.COLUMNS
+ WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'new_media_account' AND COLUMN_NAME = 'create_user_id');
+SET @new_media_audit_column_sql = IF(@new_media_audit_column_exists = 0,
+ 'ALTER TABLE `new_media_account` ADD COLUMN `create_user_id` INT DEFAULT NULL COMMENT ''创建人Hooli用户ID''',
+ 'SELECT 1');
+PREPARE new_media_audit_column_stmt FROM @new_media_audit_column_sql;
+EXECUTE new_media_audit_column_stmt;
9. feat(newMediaAccount): 新增及完善账号绑定主账号等关联字段功能 ⭐ 新增
- 提交:
bfb6dbfd2a7b(2026-11-12) - 模块: 新媒体运营
- 涉及文件:
docs/dev_v2_filter/sql/new_media_account_profile_fields.sql、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/controller/NewMediaAccountController.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/log/dto/NewMediaAccountLog.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/log/dto/NewMediaAccountLogBuilder.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/newmedia/NewMediaAccountPageParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/newmedia/NewMediaAccountParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/params/newmedia/NewMediaAccountStatisticsParam.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/newmedia/NewMediaAccountVo.java等 11 个文件 - 改动量: +549 行 / -37 行
- 功能说明: 为新媒体账号表新增绑定主账号、运营国家、原账号、实名人及身份证号等字段,迁移脚本仅补充缺失列且不改写历史数据,以支持账号关联和实名信息存储。新增、编辑接口明确使用 JSON 请求体,并将资产关系校验调整为账号关系校验。新媒体账号详情不再查询并组装关联手机号信息,也不再因历史账号关联多个手机号而直接报错,避免异常关联数据阻断详情查询。
--- /dev/null
@@ -0,0 +1,52 @@
+-- 新媒体账号字段扩展。部署新版API前,在明确授权的目标库执行。
+-- 仅添加缺失字段,不修改存量账号值;手机号归属人实时从关联手机号带出。
+-- 与既有协助运营字段一致,运营国家按JSON数组文本保存,历史NULL按空数组展示。
+-- DDL会隐式提交,执行失败时先核对实际结构再处理剩余字段。
+SET SESSION lock_wait_timeout = 5;
+SET SESSION innodb_lock_wait_timeout = 5;
+
+SET @new_media_column_exists = (SELECT COUNT(*) FROM information_schema.COLUMNS
+ WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'new_media_account' AND COLUMN_NAME = 'main_account_id');
+SET @new_media_column_sql = IF(@new_media_column_exists = 0,
+ 'ALTER TABLE `new_media_account` ADD COLUMN `main_account_id` INT DEFAULT NULL COMMENT ''绑定主账号Hooli ID''',
+ 'SELECT 1');
10. feat(room): 优化房间排序逻辑及增量更新行为 ⭐ 新增
- 提交:
c87be90550df(2026-11-12) - 模块: 房源/房型
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/controller/RoomV2Controller.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/AddRoomInfoV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/RoomListV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/params/UpdateRoomInfoV2Param.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomSortBizService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/erp/service/RoomV2Service.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/erp/service/RoomListSortTest.java等 10 个文件 - 改动量: +161 行 / -20 行
- 功能说明: 优化房间列表默认排序规则:未指定排序方式时按
sort_level升序排列,空值置后,再以创建时间升序和 ID 倒序兜底;显式按排序值查询时仍支持升降序切换。存量排序自愈逻辑同步采用该顺序补全无效的sort_level,从而保留已有人工排序的相对关系并稳定列表展示。新增房型未指定排序值时自动追加到公寓末尾,增量更新中省略或传入null则保留原有排序,避免误清空历史排序。
@@ -49,5 +49,5 @@ public class RoomV2Controller {
* </p>
* <p>
- * 除 houseId 外全部可选,不传排序参数时行为与改造前一致(update_time DESC, id DESC)。
+ * 除 houseId 外全部可选,不传排序参数时按排序值升序,空值排末尾,再按创建时间升序、ID倒序兜底。
* </p>
*
@@ -142,4 +142,5 @@ public class RoomV2Controller {
* 只更新请求中显式传递的字段,未传递的字段保持原值不变。
* 传递空字符串或 null 时,将对应字段设置为空值。
+ * sortLevel 为例外,省略或传 null 均保留原排序。
* </p>
*
@@ -193,5 +193,5 @@ public class AddRoomInfoV2Param extends CommonReqDTO {
11. refactor(newmediaasset): 优化账号平台信息批量查询和显示 ♻️ 重构
- 提交:
e2a51b551381(2026-11-12) - 模块: 新媒体运营
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/newmediaasset/NewMediaAssetSupport.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/newmediaasset/NewMediaEmailService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/vo/newmediaasset/NewMediaAccountRefVo.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/newmediaasset/NewMediaAccountAssetsTest.java - 改动量: +68 行 / -7 行
- 功能说明: 在批量查询新媒体账号时,新增按账号关联的平台 ID 批量获取平台信息,并将平台名称、头像等展示数据组装到账号引用对象中,避免逐个账号查询平台。邮箱列表接口调用该批量查询能力并传入设备类型,使邮箱关联账号能够返回对应平台的展示信息。同步补充了平台查询逻辑的单元测试,验证同一平台下多个账号可复用一次批量查询并正确显示平台名称和 Logo。
@@ -9,4 +9,5 @@ import com.hoolihome.common.vo.AdviserVo;
import com.hoolihome.crm.params.newmediaasset.NewMediaAssetPageQuery;
import com.hoolihome.crm.service.CommonService;
+import com.hoolihome.crm.vo.newmedia.SimpleNewMediaPlatformVo;
import com.hoolihome.crm.vo.newmediaasset.*;
import com.hoolihome.entity.home.*;
@@ -41,4 +42,5 @@ public class NewMediaAssetSupport {
private final INewMediaPaidToolService toolService;
private final CommonService commonService;
+ private final INewMediaPlatformService platformService;
/** 公共请求对象的未登录操作人默认值为0,仅作为空审计值处理。 */
@@ -147,9 +149,17 @@ public class NewMediaAssetSupport {
}
- public Map<Integer, NewMediaAccountRefVo> accountsFor(Collection<Integer> ids) {
12. feat(order): 优化订单成本计算与客户佣金导出逻辑 ⭐ 新增
- 提交:
fdbee578cead(2026-11-12) - 模块: 订单中心
- 涉及文件:
hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/export/OrderExportRow.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/export/OrderExportService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/GiftService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/ReferralService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/CashBackService.java、hoolihome-api-pom/hoolihome-crm-api/src/main/java/com/hoolihome/crm/service/order/OrderCostCalculationService.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/export/OrderExportCommissionDisplayTest.java、hoolihome-api-pom/hoolihome-crm-api/src/test/java/com/hoolihome/crm/service/order/OrderCostCalculationTest.java等 9 个文件 - 改动量: +491 行 / -80 行
- 功能说明: 订单导出在需要客户佣金相关字段时,改用佣金详情数据填充币种、应收/实收佣金、交易单号及备注,使导出结果与订单详情保持一致,并继续保留历史订单来源值。导出字段注释同步明确了数据来源、去重及无佣金时的处理规则,同时扩大了触发佣金详情查询的字段范围。为避免赠品新增或取消过程中部分操作成功导致数据不一致,
GiftService的新增和取消方法增加事务并在异常时回滚。
@@ -125,11 +125,11 @@ public class OrderExportRow {
private String roomNumber;
- @ExcelColumn(value = "客户佣金币种", order = 43)
+ @ExcelColumn(value = "客户佣金币种", order = 43, description = "与订单详情一致,关联收款单取有效佣金收款单币种,历史来源保留订单币种")
private String customerMoneyDesc;
- @ExcelColumn(value = "应收客户佣金", order = 44)
+ @ExcelColumn(value = "应收客户佣金", order = 44, description = "与订单详情一致,关联收款单汇总有效服务费及中介费本金,历史来源保留订单应收")
private String customerReceivableCommission;
- @ExcelColumn(value = "实收客户佣金", order = 45)
+ @ExcelColumn(value = "实收客户佣金", order = 45, description = "与订单详情一致,关联收款单汇总已支付佣金本金扣除退款,历史来源保留订单实收")
private String customerActualCommission;
@@ -219,5 +219,5 @@ public class OrderExportRow {
private String cashBackAmount;
- @ExcelColumn(value = "客户佣金备注", order = 48, source = "customerActualCommissionRemark", description = "源记录字段,保留已保存的业务值")
📊 本周工作总结
【核心成果】本周完成第46周共13项功能迭代:新媒体运营新增日报提交通知与企微提醒,线索增加对接同事、账号主运营及动态权限;视频模块支持完整源地址与安全下载,分离播放和文件地址;内容计划修复长整型文件ID精度丢失;移动端手机号列表补充平台名称与头像;订单中心支持主运营员工筛选,优化佣金导出;CRM新增账号审计、绑定主账号、运营国家、实名等字段;房源模块完善房型排序及增量更新规则。
【技术亮点】重构媒体线索创建、更新与权限判定流程,将归属、角色迁移和清理统一到业务服务;订单分页与全量选择复用筛选逻辑,拒绝非法空ID;视频ID通过专用类型统一字符串序列化,并兼容旧数据。手机号、账号平台信息改为批量查询,消除逐条访问。日报保存失败或未生成ID立即抛错,赠品新增、取消纳入事务回滚;数据库脚本仅补充缺失列,保留历史数据,增强一致性与可追溯性。
【业务价值】统一了新媒体线索、账号、订单的归属和操作记录,降低协作与审计成本;日报通知和视频安全下载提升运营执行效率;订单筛选及佣金导出口径与详情一致,减少人工核对;平台信息批量展示、移动端头像展示及稳定房型排序,分别改善使用体验、信息查找效率和房源列表稳定性。
报告生成时间:2026-11-13 18:02