wanglei/EchoChat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
2eeb8484fa193320007dca27a1429598c2b39aee
EchoChat/docs/api/admin/online.md
bujinyuan a508a4cfbc feat(phase2a): 前台联系人页面 + 管理端在线监控/好友管理 + API 文档 
前台联系人模块（ui-ux-pro-max 规范）：
- contact/index.vue: 好友列表（搜索/在线状态/骨架屏）
- contact/request.vue: 好友申请列表（接受/拒绝/防重复提交）
- contact/detail.vue: 好友详情（备注/分组/拉黑/删除）
- contact/search.vue: 搜索添加好友 + 好友推荐
- contact/groups.vue: 好友分组管理（CRUD）
- contact/blacklist.vue: 黑名单管理

管理端前端：
- views/monitor/online.vue: 在线监控（统计卡片/用户表格/30s 自动刷新）
- views/contact/list.vue: 好友关系管理（分页表格/强制删除）
- api/monitor.js + api/contact.js: 管理端 API 封装
- 路由 + 侧边栏导航更新

API 文档（4 份）：
- docs/api/frontend/contact.md: 17 个接口完整文档
- docs/api/frontend/websocket.md: 前端 WS 事件协议
- docs/api/admin/online.md: 在线监控 API
- docs/api/admin/contact.md: 好友管理 API

进度文档更新至 Phase 2a 全部完成

Made-with: Cursor
2026-03-02 17:32:52 +08:00

1.0 KiB
Raw Blame History

管理端在线监控 API

通用规范（认证方式、响应格式、错误码）见 README.md 所有接口需要 JWT + admin/super_admin 角色权限

接口列表

方法 路径 权限 说明
GET /api/v1/admin/online/users admin 获取在线用户列表
GET /api/v1/admin/online/count admin 获取在线用户数量

1. 获取在线用户列表

GET /api/v1/admin/online/users

说明： 返回当前所有在线用户的基本信息。数据来源于 Redis SET echo:user:online。

成功响应：

{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "user_id": 1,
            "username": "super_admin"
        },
        {
            "user_id": 2,
            "username": "lisi"
        }
    ]
}

2. 获取在线用户数量

GET /api/v1/admin/online/count

成功响应：

{
    "code": 0,
    "message": "ok",
    "data": {
        "count": 25
    }
}