租户
空集群首租户走 POST /tenants/register + 密钥头。已有租户丢 Key：管理密钥补发或粘贴 QO_API_KEY（本机，不写仓库）。空表不是加载成功。
/health 与 /metrics 可匿名访问。已有租户丢 Key：有管理密钥到设置补发；否则只粘贴 QO_API_KEY（本机，不写仓库）。空集群才 bootstrap。
- 在仓库根目录启动 API：make docker-up && make db-init && make dev（监听 8230）
- 浏览器打开 Swagger：https://qo.aitoall.cc/docs，确认 /health 为 ok
- 在「租户向导」或「设置 → API Key」注册租户（可选 industry 模板），或 POST /api/v1/tenants/register
- 已有租户丢 Key：设置页用管理密钥补发，或粘贴 QO_API_KEY 到本机（localStorage）；不要把 Key 写入仓库
- Admin 默认：http://127.0.0.1:3230（改 .env.local 后需重启）
首租户（空集群）
公开注册默认关闭。空集群请 POST /tenants/register，并附 X-QO-Bootstrap-Key / X-QO-Admin-Key / Bearer。无密钥 403；已有租户 409。不要把 /tenants/bootstrap 当唯一入口（中间件可能未豁免）。
若集群已有租户：有管理密钥可补发；否则只粘贴 QO_API_KEY（本机，不写仓库）。不要卡在 bootstrap。
当前租户
尚未加载
请先在设置或 .env.local 配置 API Key。
行业模板
| 名称 | 命名空间 | 实体 | 关系 | 动作 | 模板错误 | 应用到当前租户 |
|---|---|---|---|---|---|---|
| 尚未加载 | ||||||
租户向导
三步注册租户：填写基本信息 → 选择行业模板 → 确认创建（对接 `/tenants/register` + industry provision）。
基本信息
行业模板
确认创建
完成