# 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 节点加入。