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

kilostar/api/auth.py

@@ -26,8 +26,7 @@ auth_router = APIRouter(prefix="/api/v1/auth", tags=["auth"])
 
 
 class UserRegister(BaseModel):
-    """UserRegister 核心组件类。
-    这是一个领域数据模型或功能封装类，承载了 UserRegister 相关的内聚属性定义与状态维护。它的存在隔离了局部的业务复杂性，并对外提供了类型安全的访问接口。"""
+    """``POST /register`` 入参：用户名 + 明文密码。"""
 
     user_name: str
     password: str
@@ -35,10 +34,7 @@ class UserRegister(BaseModel):
 
 @auth_router.post("/register")
 async def create_user(user_register: UserRegister):
-    """处理针对 create user 相关的 HTTP API 请求。
-    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
-    Args:        user_register (UserRegister): 参与 create user 逻辑运算或数据构建的上下文依赖对象。
-    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    """注册新用户：异步线程池里做 argon2 哈希，再交由 PostgresDatabase Actor 落库。"""
     postgres_database = ray_actor_hook("postgres_database").postgres_database
     hashed_password = await run_in_threadpool(
         Accessor.hash_password, user_register.password
@@ -50,8 +46,7 @@ async def create_user(user_register: UserRegister):
 
 
 class UserLogin(BaseModel):
-    """UserLogin 核心组件类。
-    这是一个领域数据模型或功能封装类，承载了 UserLogin 相关的内聚属性定义与状态维护。它的存在隔离了局部的业务复杂性，并对外提供了类型安全的访问接口。"""
+    """``POST /login`` 入参：用户名 + 明文密码。"""
 
     user_name: str
     password: str
@@ -59,10 +54,7 @@ class UserLogin(BaseModel):
 
 @auth_router.post("/login")
 async def login_user(user_login: UserLogin):
-    """处理针对 login user 相关的 HTTP API 请求。
-    该接口负责解析前端传入的载荷数据，调用底层核心业务逻辑进行处理，并组装标准化的 JSON 响应。
-    Args:        user_login (UserLogin): 参与 login user 逻辑运算或数据构建的上下文依赖对象。
-    Returns:        : 序列化后的标准网络响应模型（如包含业务状态码、成功标志及对应的数据载荷 Data）。"""
+    """用户登录：查询用户后在线程池中校验口令，校验成功则签发 JWT。"""
     postgres_database = ray_actor_hook("postgres_database").postgres_database
     user = await postgres_database.login_user.remote(user_login.user_name)
     if not user:
@@ -74,8 +66,7 @@ async def login_user(user_login: UserLogin):
 
 
 class ChangeAuthorityRequest(BaseModel):
-    """ChangeAuthorityRequest 核心组件类。
-    这是一个领域数据模型或功能封装类，承载了 ChangeAuthorityRequest 相关的内聚属性定义与状态维护。它的存在隔离了局部的业务复杂性，并对外提供了类型安全的访问接口。"""
+    """``PUT /authority`` 入参：目标用户 ID 及新的权限枚举。"""
 
     user_id: str
     new_authority: UserAuthority