From b207fe04226e921e2b834a8162ef38947de431b4 Mon Sep 17 00:00:00 2001
From: 刘帅 <rr.iii@qq.com>
Date: 星期一, 28 九月 2026 17:45:09 +0800
Subject: [PATCH] 注释优化
---
cloud-server-management/src/main/java/com/dsh/guns/modular/system/controller/system/SensitiveDataController.java | 47 +++++++++++++++++++++++++++++++++++++++++++++--
1 files changed, 45 insertions(+), 2 deletions(-)
diff --git a/cloud-server-management/src/main/java/com/dsh/guns/modular/system/controller/system/SensitiveDataController.java b/cloud-server-management/src/main/java/com/dsh/guns/modular/system/controller/system/SensitiveDataController.java
index 5bad8f0..c513495 100644
--- a/cloud-server-management/src/main/java/com/dsh/guns/modular/system/controller/system/SensitiveDataController.java
+++ b/cloud-server-management/src/main/java/com/dsh/guns/modular/system/controller/system/SensitiveDataController.java
@@ -28,7 +28,11 @@
import java.util.Map;
import java.util.UUID;
-/** Deliberately narrow, auditable unmasking capability for the admin account. */
+/**
+ * 超级管理员敏感信息查询接口。
+ *
+ * <p>仅提供范围明确、可审计的敏感信息明文查询能力。</p>
+ */
@RestController
@RequestMapping("/system/sensitive")
public class SensitiveDataController {
@@ -40,6 +44,12 @@
@Resource private RefereeClient refereeClient;
@Resource private TOperatorService operatorService;
+ /**
+ * 查询 APP 用户的敏感信息。
+ *
+ * @param id APP 用户 ID
+ * @return 用户基本信息及敏感字段；用户不存在时返回 {@code null}
+ */
@GetMapping("/app-user/{id}")
public Map<String, Object> appUser(@PathVariable Integer id) {
assertAdmin();
@@ -48,6 +58,12 @@
return result;
}
+ /**
+ * 查询后台员工的敏感信息。
+ *
+ * @param id 员工用户 ID
+ * @return 员工基本信息及敏感字段；员工不存在时返回 {@code null}
+ */
@GetMapping("/employee/{id}")
public Map<String, Object> employee(@PathVariable Integer id) {
assertAdmin();
@@ -64,6 +80,12 @@
return result;
}
+ /**
+ * 查询学员的敏感信息。
+ *
+ * @param id 学员 ID
+ * @return 学员基本信息及敏感字段；学员不存在时返回 {@code null}
+ */
@GetMapping("/student/{id}")
public Map<String, Object> student(@PathVariable Integer id) {
assertAdmin();
@@ -73,10 +95,13 @@
}
/**
- * 预约管理查看关联预约人的敏感信息。
+ * 根据预约记录查询关联预约人的敏感信息。
*
* <p>仅通过预约记录定位用户，避免前端以任意用户 ID 查询；该接口保留在
* /system/sensitive 路径下，以使用全局的脱敏豁免和网关放行策略。</p>
+ *
+ * @param bookingId 预约记录 ID
+ * @return 预约关联用户的基本信息及敏感字段；预约或用户不存在时返回 {@code null}
*/
@GetMapping("/booking/{bookingId}")
public Map<String, Object> booking(@PathVariable Integer bookingId) {
@@ -92,6 +117,12 @@
return result;
}
+ /**
+ * 查询教练的敏感信息。
+ *
+ * @param id 教练 ID
+ * @return 教练基本信息及敏感字段；教练不存在时返回 {@code null}
+ */
@GetMapping("/coach/{id}")
public Map<String, Object> coach(@PathVariable Integer id) {
assertAdmin();
@@ -112,6 +143,12 @@
return result;
}
+ /**
+ * 查询裁判的敏感信息。
+ *
+ * @param id 裁判 ID
+ * @return 裁判基本信息及敏感字段；裁判不存在时返回 {@code null}
+ */
@GetMapping("/referee/{id}")
public Map<String, Object> referee(@PathVariable Integer id) {
assertAdmin();
@@ -136,6 +173,12 @@
return result;
}
+ /**
+ * 查询运营商关联员工的敏感信息。
+ *
+ * @param id 运营商 ID
+ * @return 关联员工的基本信息及敏感字段；运营商或员工不存在时返回 {@code null}
+ */
@GetMapping("/operator/{id}")
public Map<String, Object> operator(@PathVariable Integer id) {
assertAdmin();
--
Gitblit v1.7.1