22

app/api/v1/admin_users.py

@@ -0,0 +1,91 @@
+"""管理员用户 CRUD。"""
+
+from fastapi import APIRouter, Query
+
+from app.dependencies import AdminUser, DbSession
+from app.schemas.admin_user import AdminUserCreate, AdminUserOut, AdminUserUpdate
+from app.schemas.common import ApiResponse, PaginatedData
+from app.services import admin_user as admin_user_service
+
+router = APIRouter(prefix="/admin/users", tags=["管理-用户"])
+
+
+@router.get("", response_model=ApiResponse[PaginatedData[AdminUserOut]])
+async def list_users(
+    _admin: AdminUser,
+    db: DbSession,
+    page: int = Query(1, ge=1, description="页码，从 1 开始"),
+    page_size: int = Query(
+        admin_user_service.DEFAULT_PAGE_SIZE,
+        ge=1,
+        le=admin_user_service.MAX_PAGE_SIZE,
+        description="每页条数",
+    ),
+) -> ApiResponse[PaginatedData[AdminUserOut]]:
+    users, total = await admin_user_service.list_users(db, page=page, page_size=page_size)
+    return ApiResponse(
+        ok=True,
+        message="",
+        data=PaginatedData.build(
+            [AdminUserOut.model_validate(u) for u in users],
+            total=total,
+            page=page,
+            page_size=page_size,
+        ),
+    )
+
+
+@router.post("", response_model=ApiResponse[AdminUserOut])
+async def create_user(
+    body: AdminUserCreate,
+    admin: AdminUser,
+    db: DbSession,
+) -> ApiResponse[AdminUserOut]:
+    try:
+        user = await admin_user_service.create_user(db, body)
+    except admin_user_service.AdminUserError as exc:
+        return ApiResponse(ok=False, message=exc.message)
+
+    return ApiResponse(
+        ok=True,
+        message="用户已创建",
+        data=AdminUserOut.model_validate(user),
+    )
+
+
+@router.patch("/{user_id}", response_model=ApiResponse[AdminUserOut])
+async def update_user(
+    user_id: int,
+    body: AdminUserUpdate,
+    admin: AdminUser,
+    db: DbSession,
+) -> ApiResponse[AdminUserOut]:
+    try:
+        user = await admin_user_service.update_user(
+            db,
+            user_id,
+            body,
+            actor_id=admin.id,
+        )
+    except admin_user_service.AdminUserError as exc:
+        return ApiResponse(ok=False, message=exc.message)
+
+    return ApiResponse(
+        ok=True,
+        message="用户已更新",
+        data=AdminUserOut.model_validate(user),
+    )
+
+
+@router.delete("/{user_id}", response_model=ApiResponse[None])
+async def delete_user(
+    user_id: int,
+    admin: AdminUser,
+    db: DbSession,
+) -> ApiResponse[None]:
+    try:
+        await admin_user_service.delete_user(db, user_id, actor_id=admin.id)
+    except admin_user_service.AdminUserError as exc:
+        return ApiResponse(ok=False, message=exc.message)
+
+    return ApiResponse(ok=True, message="用户已删除")