docs: Phase 1 完成 — 同步更新全部文档至最新进度

- system-architecture.md: 标注 Docker 部署架构实现状态
- phase1-foundation-and-auth.md: 添加 Phase 1 完成标记
- api/README.md: 添加各模块实现状态标注(Phase 1/2/3)
- api/admin/user.md: 修正角色分配权限、补充创建用户响应示例
- project-context.mdc: 更新当前进度为 Phase 1 完成

Made-with: Cursor
This commit is contained in:
bujinyuan
2026-03-02 11:42:45 +08:00
parent 4d03215fe4
commit 883598d5fa
4 changed files with 68 additions and 24 deletions

View File

@@ -10,28 +10,28 @@
### 前台用户端 (`frontend/`)
| 文档 | 模块 | 说明 |
|------|------|------|
| [frontend/auth.md](frontend/auth.md) | 用户认证 | 注册、登录、Token 刷新、个人信息管理 |
| [frontend/contact.md](frontend/contact.md) | 联系人 | 好友申请/管理、好友分组 |
| [frontend/im.md](frontend/im.md) | 即时通讯 | 会话列表、消息历史、群聊创建与管理 |
| [frontend/meeting.md](frontend/meeting.md) | 会议 | 即时会议、预约会议、加入/离开、会议列表 |
| [frontend/notify.md](frontend/notify.md) | 通知 | 通知列表、标记已读 |
| 文档 | 模块 | 状态 | 说明 |
|------|------|------|------|
| [frontend/auth.md](frontend/auth.md) | 用户认证 | ✅ Phase 1 | 注册、登录、Token 刷新、个人信息管理 |
| [frontend/contact.md](frontend/contact.md) | 联系人 | 📋 Phase 2 | 好友申请/管理、好友分组 |
| [frontend/im.md](frontend/im.md) | 即时通讯 | 📋 Phase 2 | 会话列表、消息历史、群聊创建与管理 |
| [frontend/meeting.md](frontend/meeting.md) | 会议 | 📋 Phase 3 | 即时会议、预约会议、加入/离开、会议列表 |
| [frontend/notify.md](frontend/notify.md) | 通知 | 📋 Phase 2 | 通知列表、标记已读 |
### 后台管理端 (`admin/`)
| 文档 | 模块 | 说明 |
|------|------|------|
| [admin/auth.md](admin/auth.md) | 管理员认证 | 管理员登录(验证 admin 角色) |
| [admin/user.md](admin/user.md) | 用户管理 | 用户列表/详情、状态管理、角色分配、创建用户 |
| [admin/meeting.md](admin/meeting.md) | 会议管理 | 会议列表/详情、强制结束、会议统计 |
| [admin/system.md](admin/system.md) | 系统管理 | 仪表盘数据、操作日志、系统配置 |
| 文档 | 模块 | 状态 | 说明 |
|------|------|------|------|
| [admin/auth.md](admin/auth.md) | 管理员认证 | ✅ Phase 1 | 管理员登录(验证 admin 角色) |
| [admin/user.md](admin/user.md) | 用户管理 | ✅ Phase 1 | 用户列表/详情、状态管理、角色分配、创建用户 |
| [admin/meeting.md](admin/meeting.md) | 会议管理 | 📋 Phase 3 | 会议列表/详情、强制结束、会议统计 |
| [admin/system.md](admin/system.md) | 系统管理 | 📋 待定 | 仪表盘数据、操作日志、系统配置 |
### 跨端通用
| 文档 | 说明 |
|------|------|
| [websocket.md](websocket.md) | WebSocket 实时事件协议IM 消息、会议信令、在线状态) |
| 文档 | 状态 | 说明 |
|------|------|------|
| [websocket.md](websocket.md) | 📋 Phase 2 | WebSocket 实时事件协议IM 消息、会议信令、在线状态) |
---

View File

@@ -12,9 +12,9 @@
| GET | /api/v1/admin/users | admin | 获取用户列表 |
| GET | /api/v1/admin/users/:id | admin | 获取用户详情 |
| PUT | /api/v1/admin/users/:id/status | admin | 更新用户状态 |
| PUT | /api/v1/admin/users/:id/role | super_admin | 分配用户角色 |
| PUT | /api/v1/admin/users/:id/role | admin / super_admin | 分配用户角色 |
| POST | /api/v1/admin/users | admin | 管理员创建用户 |
| GET | /api/v1/admin/users/:id/meetings | admin | 获取用户会议记录 |
| GET | /api/v1/admin/users/:id/meetings | admin | 获取用户会议记录Phase 3 实现) |
---
@@ -108,7 +108,20 @@
|------|------|------|------|
| status | int | 是 | 目标状态1=正常启用2=禁用 |
**说明:** 禁用用户后,该用户的所有活跃 Token 将被清除,正在进行的 WebSocket 连接将被断开。
**说明:**
- 禁用用户后,该用户的所有活跃 Token 将被清除
- 不能禁用自己的账号(返回 400
- 禁用后用户尝试登录将返回 403
**成功响应:**
```json
{
"code": 0,
"message": "success",
"trace_id": "...",
"time": "2026-03-02 11:12:44"
}
```
---
@@ -142,6 +155,29 @@
| nickname | string | 否 | 昵称(默认使用用户名) |
| role_code | string | 否 | 指定角色,默认为 user |
**成功响应:**
```json
{
"code": 0,
"message": "success",
"data": {
"id": 6,
"username": "created_by_admin",
"email": "admin_created@example.com",
"nickname": "管理员创建",
"avatar": "",
"gender": 0,
"status": 1,
"status_text": "正常",
"roles": ["user"],
"created_at": "2026-03-02 11:12:33",
"updated_at": "2026-03-02 11:12:33"
},
"trace_id": "...",
"time": "2026-03-02 11:12:33"
}
```
---
## 6. 获取用户会议记录