feat(frontend):优化前端页面设计

kilostar/utils/check_user/role_check.py

@@ -19,10 +19,7 @@ from kilostar.utils.ray_hook import ray_actor_hook
 
 
 async def get_authority(user_id: str) -> UserAuthority:
-    """检索并获取特定的 authority 数据集合或实例对象。
-    根据提供的查询条件或上下文凭证，从数据库、缓存或第三方服务中读取对应的资源状态。
-    Args:        user_id (str): 目标对象的唯一全局标识符 (UUID/ULID)，用于在数据库表或缓存结构中精准匹配该 user 实例。
-    Returns:         (UserAuthority): 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
+    """通过 PostgresDatabase Actor 查出指定用户的 ``UserAuthority``；用户不存在时抛 401。"""
     from kilostar.utils.error import UserNotExistError
 
     postgres_database = ray_actor_hook("postgres_database").postgres_database
@@ -43,8 +40,10 @@ async def get_authority(user_id: str) -> UserAuthority:
 
 
 class RoleChecker:
-    """RoleChecker 核心组件类。
-    这是一个领域数据模型或功能封装类，承载了 RoleChecker 相关的内聚属性定义与状态维护。它的存在隔离了局部的业务复杂性，并对外提供了类型安全的访问接口。"""
+    """FastAPI 依赖：在路由级别按 ``UserAuthority`` 做最低权限校验。
+
+    例：``Depends(RoleChecker(allowed_roles=UserAuthority.ADMINISTRATOR))``。
+    """
 
     def __init__(self, **kwargs):
         self.allowed_roles = kwargs.get(
@@ -54,10 +53,7 @@ class RoleChecker:
     async def __call__(
         self, token_data: Annotated[TokenData, Depends(Accessor.get_current_user)]
     ):
-        """执行与   call   相关的核心业务流转操作。
-        该方法封装了具体的算法策略或状态控制逻辑，确保操作能够在事务上下文中被原子且一致地执行。
-        Args:        token_data (Annotated[TokenData, Depends(Accessor.get_current_user)]): 从客户端传递过来或由上游组件生成的核心业务数据体，通常需要进一步的清洗和结构化解析。
-        Returns:        : 经由当前业务模型加工处理后所输出的具体数据实例或领域模型对象。"""
+        """对当前请求执行权限比较，权限不足抛 403，否则把 ``TokenData`` 透传给路由。"""
         user_authority = await get_authority(token_data.user_id)
         if user_authority < self.allowed_roles:
             raise HTTPException(