fix: 废弃接口返回410及补充@Deprecated注解（Family/Butler/Notice）

Ultraworked with Sisyphus

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

cfc-backend/src/main/java/com/etotem/cfc/controller/butler/ButlerController.java

@@ -83,27 +83,27 @@ public class ButlerController {
         return Result.success(data);
     }
 
-/**
- * 获取服务记录
- * POST /api/butler/service-records
- */
-@Deprecated
-@Operation(summary = "获取服务记录", deprecated = true)
-@PostMapping("/service-records")
-public Result<Map<String, Object>> getServiceRecords(@RequestBody Map<String, Object> params,
-@RequestAttribute("userId") Long userId) {
-throw new UnsupportedOperationException("管家服务记录功能暂未开放");
-}
+    /**
+     * 获取服务记录（已废弃）
+     * POST /api/butler/service-records
+     */
+    @Deprecated
+    @Operation(summary = "获取服务记录", deprecated = true)
+    @PostMapping("/service-records")
+    public Result<Map<String, Object>> getServiceRecords(@RequestBody Map<String, Object> params,
+    @RequestAttribute("userId") Long userId) {
+    return Result.error(410, "该接口已废弃，无替代方案");
+    }
 
-/**
- * 获取佣金记录
- * POST /api/butler/commissions
- */
-@Deprecated
-@Operation(summary = "获取佣金记录", deprecated = true)
-@PostMapping("/commissions")
-public Result<Map<String, Object>> getCommissions(@RequestBody Map<String, Object> params,
-@RequestAttribute("userId") Long userId) {
-throw new UnsupportedOperationException("管家佣金功能暂未开放");
-}
+    /**
+     * 获取佣金记录（已废弃）
+     * POST /api/butler/commissions
+     */
+    @Deprecated
+    @Operation(summary = "获取佣金记录", deprecated = true)
+    @PostMapping("/commissions")
+    public Result<Map<String, Object>> getCommissions(@RequestBody Map<String, Object> params,
+    @RequestAttribute("userId") Long userId) {
+    return Result.error(410, "该接口已废弃，无替代方案");
+    }
 }

cfc-backend/src/main/java/com/etotem/cfc/controller/family/FamilyController.java

@@ -36,6 +36,7 @@ public class FamilyController {
      * 获取当前家庭的邀请码（已废弃，请使用邀请令牌系统）
      */
     @Operation(summary = "获取邀请码（已废弃）")
+    @Deprecated
     @PostMapping("/invite-code")
     public Result<String> getInviteCode() {
         return Result.error(410, "该接口已废弃，请使用 /api/family/invite/generate 生成邀请令牌");
@@ -45,6 +46,7 @@ public class FamilyController {
      * 生成/重置邀请码（已废弃，请使用邀请令牌系统）
      */
     @Operation(summary = "生成邀请码（已废弃）")
+    @Deprecated
     @PostMapping("/invite-code/generate")
     public Result<String> generateInviteCode() {
         return Result.error(410, "该接口已废弃，请使用 /api/family/invite/generate 生成邀请令牌");

cfc-backend/src/main/java/com/etotem/cfc/controller/family/FamilyUserController.java

@@ -90,11 +90,12 @@ public class FamilyUserController {
     }
 
     @Operation(summary = "切换家长/孩子模式（已废弃，使用 /api/family/member/switch）")
+    @Deprecated
     @PostMapping("/switch-mode")
     public Result<String> switchMode(@RequestAttribute("userId") Long userId,
-        @RequestBody Map<String, String> body) {
+        @RequestBody Map<String, String> body) {
         return Result.error(410, "该接口已废弃，请使用 /api/family/member/switch");
-    }
+    }
 
     @Operation(summary = "切换用户角色 (支持 parent/child/teacher)")
     @PostMapping("/switch-role")
@@ -116,36 +117,27 @@ public class FamilyUserController {
     }
 
     @Operation(summary = "家长切换到指定孩子身份（已废弃，使用 /api/family/member/switch）")
+    @Deprecated
     @PostMapping("/switch-to-child")
     public Result<Long> switchToFamilyMember(@RequestAttribute("userId") Long userId,
         @RequestBody Map<String, Long> body) {
         return Result.error(410, "该接口已废弃，请使用 /api/family/member/switch");
     }
 
-    @Operation(summary = "孩子切换回家长身份")
+    @Operation(summary = "孩子切换回家长身份（已废弃，使用 /api/family/member/switch）")
+    @Deprecated
     @PostMapping("/switch-back-to-parent")
     public Result<Boolean> switchBackToParent(@RequestAttribute("userId") Long userId) {
-        boolean result = userService.switchBackToParent(userId);
-        return Result.success(result);
+        return Result.error(410, "该接口已废弃，请使用 /api/family/member/switch");
     }
 
-    @Operation(summary = "带密码校验切换回家长视角")
+    @Operation(summary = "带密码校验切换回家长视角（已废弃，使用 /api/family/member/switch）")
+    @Deprecated
     @PostMapping("/switch-back-verify")
     public Result<Boolean> switchBackVerify(@RequestAttribute("userId") Long userId,
-        @RequestBody Map<String, String> body) {
-        if (userId == null) {
-            return Result.error("请先登录");
-        }
-        String password = body.get("password");
-        if (password == null || password.isEmpty()) {
-            return Result.error("请输入密码");
-        }
-        boolean verified = userService.verifySwitchBack(userId, password);
-        if (!verified) {
-            return Result.error("密码错误");
-        }
-        return Result.success(true);
-    }
+        @RequestBody Map<String, String> body) {
+        return Result.error(410, "该接口已废弃，请使用 /api/family/member/switch");
+    }
 
     @Operation(summary = "创建孩子")
     @PostMapping("/children")

cfc-backend/src/main/java/com/etotem/cfc/controller/notice/NoticeController.java

@@ -20,13 +20,10 @@ public class NoticeController {
     @Resource
     private NoticeMapper noticeMapper;
 
-    @Operation(summary = "获取已发布公告列表")
+    @Operation(summary = "获取已发布公告列表（已废弃，请使用 /api/admin/notices/list）")
+    @Deprecated
     @PostMapping("/list")
     public Result<List<Notice>> list() {
-        LambdaQueryWrapper<Notice> q = new LambdaQueryWrapper<>();
-        q.eq(Notice::getStatus, "active");
-        q.orderByDesc(Notice::getCreatedAt);
-        q.last("LIMIT 10");
-        return Result.success(noticeMapper.selectList(q));
+        return Result.error(410, "该接口已废弃（违反统一POST规范），请使用 /api/admin/notices/list");
     }
 }