管理员使用注释

app/api/cards.py

@@ -93,7 +93,7 @@ def get_card_details(card_id: int, db_conn: PooledMySQLConnection = db_dependenc
     return CardDetailResponse.model_validate(card_data)
 
 
-@router.get("/query_next", response_model=CardDetailResponse, summary="获取指定卡牌id的下一个卡的详细信息")
+@router.get("/query_next", response_model=CardDetailResponse, summary="获取指定卡牌id的下一个卡的详细信息 [用户调用]")
 def get_next_card_details(card_id: int, db_conn: PooledMySQLConnection = db_dependency):  # Renamed function
     """获取指定ID的下一张卡牌的元数据以及所有与之关联的图片信息。"""
     try:

app/api/config_proxy.py

@@ -15,7 +15,7 @@ router = APIRouter()
 http_client = httpx.AsyncClient(timeout=10.0, limits=httpx.Limits(max_keepalive_connections=20, max_connections=100))
 
 
-@router.get("/scoring_config", summary="[代理] 获取评分配置 [用户调用]")
+@router.get("/scoring_config", summary="(管理员) 获取评分配置 [用户调用]")
 async def proxy_get_scoring_config(current_user: dict = Depends(require_admin_user)):
     target_url = settings.SCORE_SERVER_CONFIG_URL
 
@@ -36,7 +36,7 @@ async def proxy_get_scoring_config(current_user: dict = Depends(require_admin_us
         raise HTTPException(status_code=503, detail=str(exc))
 
 
-@router.put("/scoring_config", summary="[代理] 更新评分配置 [用户调用]")
+@router.put("/scoring_config", summary="(管理员) 更新评分配置 [用户调用]")
 async def proxy_update_scoring_config(
         config_data: dict = Body(...),
         current_user: dict = Depends(require_admin_user)

app/api/users.py

@@ -89,7 +89,7 @@ def check_card_permission(db_conn: PooledMySQLConnection, current_user: dict, ca
     raise HTTPException(status_code=403, detail="没有该卡片权限")
 
 
-@router.post("/bind_card", status_code=200, summary="给外部用户绑定卡片ID [用户调用]")
+@router.post("/bind_card", status_code=200, summary="(管理员)给外部用户绑定卡片ID [用户调用]")
 def bind_card_to_user(
         data: BindCardRequest,
         current_user: dict = Depends(require_admin_user),