feat(jd): 京东数据库写权限放宽到管理员级+分组筛选收超管档(2026-11-17 用户口径「超管+管理员都可以,只有普通员工不能操作」「超管可以有分组筛选,管理员及以下则没有」)——后端 requirePlatformSuperAdminWrite 改 requireJdProductWrite:平台超管/公司超管/admin 三档放行、普通账号(resolveRole=null)403「仅超级管理员或管理员可以编辑或删除京东数据库数据」(四条商品行写路由同闸;批量归类 V203 requireWritableGroup 不动);前端 canWriteProducts(isAdminRole)管操作列/批量删除/勾选列/只读提示,canFilterGroup(平台+公司超管)管筛选行「分组」控件整块显隐(管理员及以下连单组锁定芯片都不渲染,分类面静默落默认组)。判据:后端 29 例(普通账号四写 403 不触服务+admin 四写放行+公司超管放行+结构钉三档谓词与 403 文案);前端挂载 42 例(普通员工 5 列只读+无分组控件、admin 7 列全写+多组也无下拉、公司超管齐写+多组可切组、超管照旧);vue-tsc rc=0;ops fast 闸门 overall=pass

This commit is contained in:
2026-11-17 22:42:15 +08:00
parent 8b0cde4a51
commit 0c4354fc1e
4 changed files with 226 additions and 78 deletions
@@ -61,16 +61,18 @@ import java.util.List;
* <p>鉴权照外观专利只读页私有 {@code requireXxxAccess} 形状:JWT → 内部令牌回退 → 超管放行 →
* 非超管菜单权限(column_key/route_path 双匹配)。菜单行由 V196 只插 columns 不预授权
* ⇒ 默认仅 super_admin 可见可访问,其余角色由超管在权限页手工勾授后才放行。
* <b>2026-11-16 起读/写分档</b>:读(列表/类目/详情)按上面的菜单口径放行;写(编辑/上传图片/
* 删除/批量删除/批量归类)在菜单口径之上再要求平台超管,非超管一律 403(前端同窗隐藏写入口)。</p>
* <b>2026-11-16 起读/写分档(2026-11-17 口径放宽)</b>:读(列表/类目/详情)按上面的菜单
* 口径放行;商品行写(编辑/上传图片/删除/批量删除)在菜单口径之上再走管理员级写闸
* (平台超管+公司超管+admin 档放行,普通账号 403,见 {@code requireJdProductWrite});
* 批量归类走 V203 的按组判(requireWritableGroup)。</p>
*
* <p><b>公司口径(2026-11-16 用户定案「删除掉公司 tab,参考品牌数据库」)</b>:读侧零公司
* 维度——company_id 请求参数与 {@code superAdminScopedCompanyId} 谓词已随公共化收尾整批
* 摘除(2026-11-15 定案「京东数据库不区分公司、属于公共的」的最后一截),行上的 company_id
* 只剩「哪家公司客户端同步的」来源标记,不构成可见性边界;每个拿到本页菜单权限的管理员
* (含站点超管)看到同一份全量公共库。详情与写侧(编辑/删除)同样没有公司维度:
* 对全部公共行可编辑可删除,但<b>写动作只对平台超管开放</b>(2026-11-16 用户口径
* 「京东数据库只有超管有编辑删除权限」,见 {@code requirePlatformSuperAdminWrite}),
* 对全部公共行可编辑可删除,但<b>写动作只对管理员级开放</b>(2026-11-17 用户口径
* 「超管+管理员都可以,只有普通员工不能」,见 {@code requireJdProductWrite}),
* 写侧端点的 company_id 传参已随 2026-11-15 公共化摘除。</p>
*
* <p>导出端点已随 2026-11-15 客户口径「导出也不用」整段下线(控制器/服务/mapper 参数一起删);
@@ -172,7 +174,7 @@ public class AdminJdProductController {
@Parameter(description = "商品行 id") @PathVariable("id") Long id,
@Valid @RequestBody JdProductUpdateRequest body,
HttpServletRequest request) {
RequestOperator operator = requirePlatformSuperAdminWrite(request);
RequestOperator operator = requireJdProductWrite(request);
Long updatedId = jdProductUpdateService.update(id, body);
log.info("[jd-product] 编辑商品 operatorId={} id={} title={}",
operator.id(), updatedId, body.getTitle());
@@ -196,7 +198,7 @@ public class AdminJdProductController {
@Parameter(description = "替换目标图片登记行 id(缺省=新增)")
@RequestParam(value = "replace_image_id", required = false) Long replaceImageId,
HttpServletRequest request) {
RequestOperator operator = requirePlatformSuperAdminWrite(request);
RequestOperator operator = requireJdProductWrite(request);
Long updatedId = jdProductUpdateService.uploadImage(id, file, imageType, attrName, replaceImageId);
log.info("[jd-product] 上传图片 operatorId={} id={} replaceImageId={} imageType={}",
operator.id(), updatedId, replaceImageId, imageType);
@@ -211,7 +213,7 @@ public class AdminJdProductController {
public ApiResponse<JdProductDeleteVo> delete(
@Parameter(description = "商品行 id") @PathVariable("id") Long id,
HttpServletRequest request) {
RequestOperator operator = requirePlatformSuperAdminWrite(request);
RequestOperator operator = requireJdProductWrite(request);
JdProductDeleteVo vo = jdProductDeleteService.delete(List.of(id));
// 管理端破坏性动作必须留痕:谁、删了哪些行、桶里清了几个对象(同分组删除口径)。
log.info("[jd-product] 删除商品 operatorId={} id={} deleted={} objectsDeleted={}",
@@ -246,7 +248,7 @@ public class AdminJdProductController {
public ApiResponse<JdProductDeleteVo> batchDelete(
@Valid @RequestBody JdProductBatchDeleteRequest body,
HttpServletRequest request) {
RequestOperator operator = requirePlatformSuperAdminWrite(request);
RequestOperator operator = requireJdProductWrite(request);
JdProductDeleteVo vo = jdProductDeleteService.delete(body.getIds());
log.info("[jd-product] 批量删除商品 operatorId={} requested={} deleted={} objectsDeleted={} kept={}",
operator.id(), body.getIds().size(), vo.getDeleted(),
@@ -267,23 +269,27 @@ public class AdminJdProductController {
}
/**
* 写端点的越权闸(2026-11-16 用户口径「京东数据库只有超管有编辑删除权限」)。
* 写端点的越权闸(2026-11-17 用户口径「超管+管理员都可以,只有普通员工不能操作」,
* 推翻 2026-11-16「只有超管有编辑删除权限」的单档)。
*
* <p>读保持菜单权限口径(拿到 {@code admin_jd_database} 列权限的管理员可见同一份公共库),
* 写(编辑 / 上传图片 / 单行删除 / 批量删除 / 批量归类)收窄到<b>平台超级管理员</b>:
* 与 {@code BrandGatingController#requirePlatformSuperAdmin}、
* {@code AdminDeviceLogController#requireSuperAdmin} 同一判据(
* {@code DeviceSessionPolicy#isSuper} 只认站点 super_admin,公司超管不在内)。</p>
* <p>读保持菜单权限口径(拿到 {@code admin_jd_database} 列权限的管理员可见同一份公共库);
* 商品行写(编辑 / 上传图片 / 单行删除 / 批量删除)放宽到<b>管理员级</b>:平台超级管理员、
* 公司超级管理员、admin 角色三档放行,普通账号(role 归不出档)403。分类写不在此闸——
* {@code batch-assign-group} 沿用 V203 的 {@code requireWritableGroup}(本组管理员/
* 公司超管/平台超管,按组判)。</p>
*
* <p>写动作会置人工编辑锁({@code manual_locked=1})并物理删除桶内图片,属影响全平台公共
* 数据的动作,故不随读权限下放;非超管拿到 403 时前端已不渲染这些入口,本闸是兜底。</p>
* <p>写动作会置人工编辑锁({@code manual_locked=1})并物理删除桶内图片;普通账号拿到 403
* 时前端已不渲染这些入口,本闸是兜底。</p>
*/
private RequestOperator requirePlatformSuperAdminWrite(HttpServletRequest request) {
private RequestOperator requireJdProductWrite(HttpServletRequest request) {
RequestOperator operator = requireJdAccess(request);
if (!operator.superAdmin()) {
log.warn("[jd-product] 非平台超管写操作被拒 operatorId={} role={}",
operator.id(), adminAuthSupport.currentRole(operator.user()));
throw new BusinessException(403, "仅平台超级管理员可以编辑或删除京东数据库数据");
String role = adminAuthSupport.currentRole(operator.user());
boolean adminTier = operator.superAdmin()
|| DeviceSessionPolicy.isCompanySuperAdmin(role)
|| "admin".equals(role);
if (!adminTier) {
log.warn("[jd-product] 普通账号写操作被拒 operatorId={} role={}", operator.id(), role);
throw new BusinessException(403, "仅超级管理员或管理员可以编辑或删除京东数据库数据");
}
return operator;
}
@@ -77,7 +77,8 @@ import static org.mockito.Mockito.when;
* <p><b>V203 分类按数据权限分组隔离(2026-11-16 用户口径)</b>:分类归属存
* {@code biz_jd_product_group_assign} 的 (product_id, owner_group_id) 一行,读面靠
* {@code owner_group_id} 取「当前分组」的分类(缺省=作用域默认分组),归类的写权限
* 由 {@link JdCategoryScopeService} 判「该组可写」——商品行编辑/删除仍只平台超管。
* 由 {@link JdCategoryScopeService} 判「该组可写」——商品行编辑/删除走管理员级写闸
* (2026-11-17 用户口径「超管+管理员都可以,只有普通员工不能」)。
* 本类把作用域服务整体 mock 掉(四档角色矩阵在 {@code JdCategoryScopeServiceTest} 里钉),
* 只钉控制器怎么用它、以及拒绝语义不被吞。</p>
*/
@@ -235,25 +236,29 @@ class AdminJdProductControllerTest {
assertTrue(source.contains("\"owner_group_id\""), "列表必须收 owner_group_id(当前分组)");
}
// ===================== 写权限分档(2026-11-16 / V203) =====================
// ===================== 写权限分档(2026-11-17:超管级+管理员可写,普通账号只读) =====================
/** 写端点越权闸的结构判据:商品行四条写路由走超管闸,读三条走菜单正门。 */
/** 写端点越权闸的结构判据:商品行四条写路由走管理员级写闸,读三条走菜单正门。 */
@Test
void 商品页读写权限分档_商品行写端点逐条走超管闸() throws IOException {
void 商品页读写权限分档_商品行写端点逐条走管理员级写闸() throws IOException {
String source = stripComments(Files.readString(CONTROLLER));
assertEquals(4, count(source, "requirePlatformSuperAdminWrite(request)"),
"编辑/上传图片/单行删除/批量删除四条商品行写路由必须逐条走超管写闸"
assertEquals(4, count(source, "requireJdProductWrite(request)"),
"编辑/上传图片/单行删除/批量删除四条商品行写路由必须逐条走管理员级写闸"
+ "(归类不在此列:V203 起归本组管理员可做)");
assertEquals(5, count(source, "requireJdAccess(request)"),
"列表/类目/详情/归类四条读+组内写路由,与超管写闸内部一处,共五处菜单权限正门");
assertTrue(source.contains("仅平台超级管理员可以编辑或删除京东数据库数据"),
"非超管写商品的 403 文案必须点名平台超管");
"列表/类目/详情/归类四条读+组内写路由,与写闸内部一处,共五处菜单权限正门");
assertTrue(source.contains("仅超级管理员或管理员可以编辑或删除京东数据库数据"),
"普通账号写商品的 403 文案必须点名超管与管理员(2026-11-17 口径)");
assertTrue(source.contains("operator.superAdmin()"),
"写闸必须在菜单口径之上再判 superAdmin(只放行站点超管,公司超管不在内)");
"写闸必须在菜单口径之上再判 superAdmin(平台超管直放)");
assertTrue(source.contains("DeviceSessionPolicy.isCompanySuperAdmin(role)"),
"写闸必须放行公司超级管理员(超管档,2026-11-17 口径「只有普通员工不能」)");
assertTrue(source.contains("\"admin\".equals(role)"),
"写闸必须放行 admin 角色(管理员档,2026-11-17 口径「超管+管理员都可以」)");
}
@Test
void 非超管有菜单权限时读放行_商品行写一律403且不触服务() {
void 普通账号有菜单权限时读放行_商品行写一律403且不触服务() {
JdProductQueryService queryService = mock(JdProductQueryService.class);
JdProductDeleteService deleteService = mock(JdProductDeleteService.class);
JdProductUpdateService updateService = mock(JdProductUpdateService.class);
@@ -267,11 +272,12 @@ class AdminJdProductControllerTest {
AdminUserEntity operator = new AdminUserEntity();
operator.setId(9L);
operator.setUsername("company-admin");
operator.setUsername("member");
HttpServletRequest request = mock(HttpServletRequest.class);
when(authSupport.requireUser(request)).thenReturn(operator);
// 非超管(管理员 / 公司超管同形):拿到 admin_jd_database 菜单权限后读可进、商品行写仍拒。
when(authSupport.currentRole(operator)).thenReturn("admin");
// 普通账号:resolveRole 归不出档返回 null(AdminAuthSupport.currentRole 真实形状);
// 拿到 admin_jd_database 菜单权限后读可进、商品行写仍拒(2026-11-17 口径「只有普通员工不能」)。
when(authSupport.currentRole(operator)).thenReturn(null);
PermissionMenuItemVo grant = new PermissionMenuItemVo();
grant.setColumnKey(COLUMN_KEY);
grant.setRoutePath(ROUTE_PATH);
@@ -285,28 +291,28 @@ class AdminJdProductControllerTest {
pageVo.setItems(List.of());
when(queryService.page(1L, 20L, null, null, null, null, null, null, null, GROUP_ID)).thenReturn(pageVo);
assertEquals(Boolean.TRUE, controller.page(1L, 20L, null, null, null, null, null, null, null, null, request)
.isSuccess(), "非超管有菜单权限时读必须放行(读写分档只收窄写)");
.isSuccess(), "普通账号有菜单权限时读必须放行(读写分档只收窄写)");
// 商品行写:四条写入口一律 403,且业务服务一次都没被调到(不能「先写再拒」)。
JdProductUpdateRequest updateBody = new JdProductUpdateRequest();
updateBody.setTitle("标题");
BusinessException updateEx = assertThrows(BusinessException.class,
() -> controller.update(11L, updateBody, request));
assertTrue(updateEx.getMessage().contains("仅平台超级管理员"), "编辑被拒文案点名平台超管");
assertTrue(updateEx.getMessage().contains("仅超级管理员或管理员"), "编辑被拒文案点名超管与管理员");
BusinessException deleteEx = assertThrows(BusinessException.class,
() -> controller.delete(11L, request));
assertTrue(deleteEx.getMessage().contains("仅平台超级管理员"));
assertTrue(deleteEx.getMessage().contains("仅超级管理员或管理员"));
JdProductBatchDeleteRequest batchBody = new JdProductBatchDeleteRequest();
batchBody.setIds(List.of(11L, 12L));
BusinessException batchEx = assertThrows(BusinessException.class,
() -> controller.batchDelete(batchBody, request));
assertTrue(batchEx.getMessage().contains("仅平台超级管理员"));
assertTrue(batchEx.getMessage().contains("仅超级管理员或管理员"));
BusinessException uploadEx = assertThrows(BusinessException.class,
() -> controller.uploadImage(11L, mock(MultipartFile.class), "MAIN", null, null, request));
assertTrue(uploadEx.getMessage().contains("仅平台超级管理员"),
assertTrue(uploadEx.getMessage().contains("仅超级管理员或管理员"),
"上传/替换图片改桶内对象=写动作,必须同闸");
verify(updateService, never()).update(any(), any());
@@ -315,6 +321,69 @@ class AdminJdProductControllerTest {
verify(deleteService, never()).delete(any());
}
/** 2026-11-17 口径「超管+管理员都可以」:admin 档四条写入口全放行、公司超管(超管档)同闸放行。 */
@Test
void 管理员与公司超管有菜单权限即可写商品_写入口放行且触服务() {
JdProductQueryService queryService = mock(JdProductQueryService.class);
JdProductDeleteService deleteService = mock(JdProductDeleteService.class);
JdProductUpdateService updateService = mock(JdProductUpdateService.class);
AdminAuthSupport authSupport = mock(AdminAuthSupport.class);
PermissionMenuService permissionMenuService = mock(PermissionMenuService.class);
AdminJdProductController controller = new AdminJdProductController(
queryService, deleteService, updateService, mock(JdProductGroupService.class),
mock(JdCategoryScopeService.class), authSupport, permissionMenuService);
AdminUserEntity operator = new AdminUserEntity();
operator.setId(9L);
HttpServletRequest request = mock(HttpServletRequest.class);
when(authSupport.requireUser(request)).thenReturn(operator);
// 管理员(admin 档,非任何超管):菜单权限命中后商品行写全放行。
when(authSupport.currentRole(operator)).thenReturn("admin");
PermissionMenuItemVo grant = new PermissionMenuItemVo();
grant.setColumnKey(COLUMN_KEY);
grant.setRoutePath(ROUTE_PATH);
when(permissionMenuService.getUserColumnPermissions(9L, "admin")).thenReturn(List.of(grant));
JdProductUpdateRequest updateBody = new JdProductUpdateRequest();
updateBody.setTitle("标题");
JdProductDetailVo detailVo = new JdProductDetailVo();
detailVo.setId(11L);
when(updateService.update(11L, updateBody)).thenReturn(11L);
when(queryService.detail(11L, null)).thenReturn(detailVo);
assertEquals(Boolean.TRUE, controller.update(11L, updateBody, request).isSuccess(),
"admin 档编辑放行必须是 success 信封(B80-03)");
verify(updateService).update(11L, updateBody);
when(updateService.uploadImage(11L, null, "MAIN", null, null)).thenReturn(11L);
assertEquals(Boolean.TRUE,
controller.uploadImage(11L, null, "MAIN", null, null, request).isSuccess(),
"admin 档上传图片同闸放行");
verify(updateService).uploadImage(11L, null, "MAIN", null, null);
JdProductDeleteVo receipt = new JdProductDeleteVo();
receipt.setDeleted(1);
when(deleteService.delete(List.of(11L))).thenReturn(receipt);
assertEquals(Boolean.TRUE, controller.delete(11L, request).isSuccess(), "admin 档单行删除放行");
JdProductBatchDeleteRequest batchBody = new JdProductBatchDeleteRequest();
batchBody.setIds(List.of(11L, 12L));
when(deleteService.delete(List.of(11L, 12L))).thenReturn(receipt);
assertEquals(Boolean.TRUE, controller.batchDelete(batchBody, request).isSuccess(), "admin 档批量删除放行");
verify(deleteService).delete(List.of(11L));
verify(deleteService).delete(List.of(11L, 12L));
// 公司超管=超管档:同一道闸放行(单条删除代表性钉住,防「只放平台超管」回潜)。
AdminUserEntity companySuper = new AdminUserEntity();
companySuper.setId(8L);
HttpServletRequest companyRequest = mock(HttpServletRequest.class);
when(authSupport.requireUser(companyRequest)).thenReturn(companySuper);
when(authSupport.currentRole(companySuper)).thenReturn("company_super_admin");
when(permissionMenuService.getUserColumnPermissions(8L, "admin")).thenReturn(List.of(grant));
when(deleteService.delete(List.of(21L))).thenReturn(receipt);
assertEquals(Boolean.TRUE, controller.delete(21L, companyRequest).isSuccess(),
"公司超级管理员属超管档,商品行写同闸放行(2026-11-17 口径)");
verify(deleteService).delete(List.of(21L));
}
@Test
void 不可写组的分组写一律403且不触服务() {
JdProductGroupService groupService = mock(JdProductGroupService.class);