chengkai3
23db30d0f0
将模糊的 409 错误消息 "User id/email/username already exists or default role missing" 拆分为三种具体的异常类型： 1. UserDuplicateError (409) - 用户ID/邮箱/用户名已存在 2. UserRoleAssignmentError (500) - 默认角色未配置或角色分配失败 3. UserCreateError (500) - 其他用户创建失败 改动内容： - 在 user_service.py 中定义三个异常类 - 将 create_user 返回类型从 UserPublic | None 改为 UserPublic（抛出异常） - 在 API 层捕获具体异常并返回对应的 HTTP 状态码和明确错误消息 - 更新和新增测试以验证错误消息准确性 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Co-authored-by: multica-agent <github@multica.ai>
API Service
FastAPI 后端服务，包含用户认证和 RBAC 权限控制。
核心能力
- JWT Access Token（默认 8 小时）
- Refresh Session（HttpOnly Cookie，默认 30 天，刷新轮换）
- RBAC（用户-角色-权限）
- 用户管理接口（需
user.manage）
本地开发
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r api/requirements.txt
python -m uvicorn api.app.main:app --reload --host 0.0.0.0 --port 8000
主要接口
GET /healthGET /api/v1/pingPOST /api/v1/auth/registerPOST /api/v1/auth/loginPOST /api/v1/auth/refreshPOST /api/v1/auth/logoutGET /api/v1/auth/meGET /api/v1/users