feat: Phase 1 完成 — 基础设施 + 用户认证 + 管理端 + 端到端验证

Phase 1 (基础设施与用户认证) 全部 11 个 Task 开发完成:

后端 (Go):
- Auth 模块: 注册/登录/JWT(有状态)/Profile/密码修改
- Admin 模块: 用户列表/详情/禁用/启用/角色分配/创建用户
- 中间件: JWT认证 + RBAC角色权限 + 请求日志 + CORS + Panic恢复
- Dockerfile 多阶段构建 + Docker Compose 全栈部署

前台 (uni-app):
- 登录/注册页面 + 自定义 TabBar + 个人中心
- 请求封装 + 状态管理 (Pinia)

管理端 (Vue 3 + Element Plus):
- 登录/仪表盘/用户列表/用户详情
- Axios 封装 + 路由守卫 + Pinia 状态管理

验证:
- 全流程 API 端到端测试通过
- Playwright 页面自动化验证通过
- code-reviewer 代码审查通过

Made-with: Cursor
This commit is contained in:
bujinyuan
2026-03-02 11:31:24 +08:00
parent e9bd4dd204
commit 4d03215fe4
63 changed files with 15908 additions and 102 deletions

35
admin/src/api/auth.js Normal file
View File

@@ -0,0 +1,35 @@
/**
* 管理后台认证 API
*
* 对应后端路由:/api/v1/auth/*
* 管理员登录使用与普通用户相同的登录接口,
* 权限区分由 JWT 中的 role 字段和 RequireRole 中间件控制
*/
import request from '@/utils/request'
/**
* 管理员登录
* POST /api/v1/auth/login
*
* @param {Object} data - { account, password }
* @returns {Promise<Object>} { token, refresh_token, expires_in, user }
*/
export const login = (data) => {
return request.post('/api/v1/auth/login', data)
}
/**
* 管理员登出
* POST /api/v1/auth/logout
*/
export const logout = () => {
return request.post('/api/v1/auth/logout')
}
/**
* 获取管理员个人信息
* GET /api/v1/auth/profile
*/
export const getProfile = () => {
return request.get('/api/v1/auth/profile')
}

89
admin/src/api/user.js Normal file
View File

@@ -0,0 +1,89 @@
/**
* 用户管理 API 模块
*
* 对应后端路由:/api/v1/admin/users
* 所有接口需要 JWT + admin 角色权限
*
* 接口列表:
* - GET /api/v1/admin/users 用户列表(分页 + 搜索 + 筛选)
* - GET /api/v1/admin/users/:id 用户详情
* - PUT /api/v1/admin/users/:id/status 更新用户状态
* - PUT /api/v1/admin/users/:id/role 分配角色
* - POST /api/v1/admin/users 管理员创建用户
*/
import request from '@/utils/request'
/**
* 获取用户列表
* @param {Object} params - 查询参数
* @param {number} params.page - 页码(从 1 开始)
* @param {number} params.page_size - 每页数量
* @param {string} [params.keyword] - 搜索关键词(用户名/邮箱)
* @param {number} [params.status] - 状态筛选1=正常, 2=禁用
* @returns {Promise<{data: {total: number, list: Array}}>}
*/
export function getUserList(params) {
return request({
url: '/api/v1/admin/users',
method: 'get',
params
})
}
/**
* 获取用户详情
* @param {number} id - 用户 ID
* @returns {Promise<{data: Object}>}
*/
export function getUserDetail(id) {
return request({
url: `/api/v1/admin/users/${id}`,
method: 'get'
})
}
/**
* 更新用户状态
* @param {number} id - 用户 ID
* @param {number} status - 目标状态1=正常, 2=禁用
* @returns {Promise}
*/
export function updateUserStatus(id, status) {
return request({
url: `/api/v1/admin/users/${id}/status`,
method: 'put',
data: { status }
})
}
/**
* 分配角色
* @param {number} id - 用户 ID
* @param {string} roleCode - 角色代码user/admin/super_admin
* @returns {Promise}
*/
export function assignUserRole(id, roleCode) {
return request({
url: `/api/v1/admin/users/${id}/role`,
method: 'put',
data: { role_code: roleCode }
})
}
/**
* 管理员创建用户
* @param {Object} data - 用户信息
* @param {string} data.username - 用户名
* @param {string} data.email - 邮箱
* @param {string} data.password - 初始密码
* @param {string} [data.nickname] - 昵称
* @param {string} [data.role_code] - 初始角色
* @returns {Promise<{data: Object}>}
*/
export function createUser(data) {
return request({
url: '/api/v1/admin/users',
method: 'post',
data
})
}