Files
moyi-model-intelligence-hub/control-plane/README.md
T

53 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# MOYI Control Plane
D3 的身份与权限服务,负责邀请码注册、登录会话、用户角色、管理员接口和认证审计。它与 Otari 分离,前端不直接持有 Otari Master Key 或供应商密钥。
## 本地开发
### 内存联调
如果暂时只验证登录、邀请码和权限,可以使用内存仓库,不需要 PostgreSQL:
```powershell
cd control-plane
Copy-Item .env.memory.example .env
# 在 .env 中设置 ADMIN_PASSWORD,且不要设置 DATABASE_URL
pnpm install
pnpm dev
```
内存仓库重启后会清空用户、邀请码和会话,只适合开发联调。
### PostgreSQL 持久化
```powershell
cd control-plane
Copy-Item .env.example .env
pnpm install
pnpm migrate
pnpm seed:admin
pnpm dev
```
默认监听 `http://127.0.0.1:8787`。没有设置 `DATABASE_URL` 时,服务可以使用内存仓库启动,用于接口联调;正式开发和测试应使用 PostgreSQL。
## 接口
- `POST /api/auth/register`:邀请码注册,账号支持邮箱或手机号。
- `POST /api/auth/login`:账号密码登录,返回 HttpOnly 会话 Cookie。
- `GET /api/auth/me`:读取当前会话用户。
- `POST /api/auth/logout`:撤销当前会话。
- `GET /api/admin/users`:管理员用户列表。
- `GET|POST /api/admin/invitations`:管理员查看或生成邀请码。
- `POST /api/admin/invitations/:id/revoke`:停用邀请码。
- `GET /api/admin/audit`:管理员查看认证审计。
第一版暂不实现短信/邮件真实验证码;注册页面保留验证码入口但不以它作为后端注册条件,邀请码、邮箱/手机号和账号密码是当前有效的注册条件。
## 安全约束
- 数据库仅保存密码哈希、邀请码摘要和会话摘要,不保存明文密码、明文邀请码或会话 Token。
- 生产环境必须设置随机的 `AUTH_PASSWORD_PEPPER`、强管理员密码和 HTTPS。
- 管理员接口由 Control Plane 服务端角色校验保护,隐藏前端菜单不构成权限控制。
- 迁移文件只创建认证相关表,额度、模型和 Key 表在后续 D4 节点加入。