Browse Source

feat(workbench): 工作台聚合端点 + 鉴权契约

Xiaogang Liao 1 week ago
parent
commit
9b4288cf19

+ 31 - 0
cfc-backend/src/main/java/com/etotem/cfc/controller/admin/AdminFamilyWorkbenchController.java

@@ -0,0 +1,31 @@
+package com.etotem.cfc.controller.admin;
+
+import com.etotem.cfc.common.Result;
+import com.etotem.cfc.dto.FamilyWorkbenchDTO;
+import com.etotem.cfc.service.FamilyWorkbenchService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
+
+import javax.annotation.Resource;
+
+@Tag(name = "管理端-单家庭工作台", description = "家庭信息汇总中心:聚合卡片、消息、报告等(familyId 一律来自 URL)")
+@RestController
+@RequestMapping("/api/admin")
+public class AdminFamilyWorkbenchController {
+
+    @Resource
+    private FamilyWorkbenchService service;
+
+    @Operation(summary = "单家庭工作台聚合(6 卡:总额 + 近 30 天逐日序列)")
+    @PostMapping("/families/{id}/workbench")
+    @PreAuthorize("hasRole(admin)")
+    public Result<FamilyWorkbenchDTO> workbench(@PathVariable Long id) {
+        try {
+            return Result.success(service.aggregate(id));
+        } catch (RuntimeException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+}

+ 32 - 0
cfc-backend/src/test/java/com/etotem/cfc/controller/FamilyWorkbenchContractTest.java

@@ -0,0 +1,32 @@
+package com.etotem.cfc.controller;
+
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.test.web.servlet.MockMvc;
+
+/**
+ * 单家庭工作台-端到端鉴权契约(CI 跑,需 dev 库):
+ * 匿名访问 /api/admin/families/{id}/workbench 必须由 JwtInterceptor 返回 HTTP 401 + {"code":401}
+ * (/api/admin/** 在 LOGIN_REQUIRED_PATHS);非 admin 由 @PreAuthorize → GlobalExceptionHandler 回 200+{code:403},
+ * 由 AdminWorkbenchAuthContractTest 的 @PreAuthorize 断言覆盖(本类只断言匿名 401,仿 GrowthAuthContractTest)。
+ */
+@SpringBootTest
+@AutoConfigureMockMvc
+class FamilyWorkbenchContractTest {
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @Test
+    void 匿名访问家庭工作台_应401() throws Exception {
+        mockMvc.perform(post("/api/admin/families/1/workbench"))
+                .andExpect(status().isUnauthorized())
+                .andExpect(jsonPath("$.code").value(401));
+    }
+}

+ 36 - 0
cfc-backend/src/test/java/com/etotem/cfc/controller/admin/AdminWorkbenchAuthContractTest.java

@@ -0,0 +1,36 @@
+package com.etotem.cfc.controller.admin;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.PostMapping;
+
+import java.lang.reflect.Method;
+
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * 单家庭工作台-鉴权契约:AdminFamilyWorkbenchController 的每个 POST 端点必须
+ * @PreAuthorize("hasRole(admin)") 且路径挂在 /api/admin/families/ 下。
+ * 无 token 由 JwtInterceptor(LOGIN_REQUIRED_PATHS 含 /api/admin/**) 回 401;
+ * 非 admin 由 @PreAuthorize → GlobalExceptionHandler 回 200+{code:403}。
+ * 纯反射(无 Spring/DB),任何环境可跑。
+ */
+class AdminWorkbenchAuthContractTest {
+
+    @Test
+    void 工作台控制器每个POST端点必须admin鉴权且路径在apiAdminFamilies下() {
+        int found = 0;
+        for (Method m : AdminFamilyWorkbenchController.class.getDeclaredMethods()) {
+            PostMapping pm = m.getAnnotation(PostMapping.class);
+            if (pm == null) continue;
+            found++;
+            PreAuthorize pa = m.getAnnotation(PreAuthorize.class);
+            assertNotNull(pa, m.getName() + " 必须带 @PreAuthorize");
+            assertTrue(pa.value().contains("admin"), m.getName() + " 必须要求 admin 角色");
+            assertTrue(pm.value()[0].startsWith("/families/"),
+                    m.getName() + " 路径必须以 /families/ 开头(familyId 来自 URL): " + pm.value()[0]);
+        }
+        assertTrue(found > 0, "控制器必须至少有一个 POST 端点");
+    }
+}