# XuqmGroup Web 访问与联调文档

> 最后更新：2026-04-24

## 线上访问地址

| 系统 | 地址 | 说明 |
|------|------|------|
| 租户开放平台 | `https://dev.xuqinmin.com/` | 主账号注册、登录、应用管理 |
| 运营管理平台 | `https://dev.xuqinmin.com/ops/` | 内部运营管理入口 |

## 初始化管理员账号

| 字段 | 值 |
|------|----|
| 用户名 | `admin` |
| 初始密码 | `Admin@123456` |

## 前端接口基地址

| 平台 | API Base |
|------|----------|
| tenant-platform | `https://dev.xuqinmin.com/api` |
| ops-platform | `https://dev.xuqinmin.com/api` |

## 主要页面

### tenant-platform

| 路径 | 说明 |
|------|------|
| `/login` | 登录 |
| `/register` | 注册 |
| `/forgot-password` | 忘记密码 |
| `/dashboard` | 控制台首页 |
| `/apps` | 应用列表 |
| `/apps/:id` | 应用详情 |
| `/accounts` | 子账号管理 |

### ops-platform

| 路径 | 说明 |
|------|------|
| `/ops/login` | 运营管理员登录 |
| `/ops/tenants` | 租户列表 |
| `/ops/statistics` | 统计面板 |

## 主要联调接口

| 方法 | 路径 | 页面 |
|------|------|------|
| GET | `/api/auth/captcha` | 租户登录 |
| POST | `/api/auth/send-email-code` | 注册、找回密码、子账号验证 |
| POST | `/api/auth/register` | 注册 |
| POST | `/api/auth/login` | 租户登录 |
| POST | `/api/auth/forgot-password` | 忘记密码 |
| POST | `/api/auth/reset-password` | 重置密码 |
| GET | `/api/apps` | 应用列表 |
| GET | `/api/apps/{id}` | 应用详情 |
| POST | `/api/apps` | 创建应用 |
| GET | `/api/sub-accounts` | 子账号列表 |
| POST | `/api/sub-accounts` | 创建子账号 |
| POST | `/api/auth/ops/login` | 运营平台登录 |
| GET | `/api/ops/tenants` | 运营租户管理 |
| GET | `/api/ops/statistics` | 运营统计 |

## 开发环境

| 系统 | 地址 |
|------|------|
| tenant-platform | `http://localhost:5173/` |
| ops-platform | `http://localhost:5174/` |

## 环境变量

```env
VITE_API_BASE_URL=https://dev.xuqinmin.com/api
```