SuperAPI AI 工具集

portal-backend-app

编程与开发

查看项目

更新于 10-16 08:09

技能介绍

用途:指导在门户 monorepo 内新增或修改「独立后端 App」——采用 apps/-server + apps/-app 双包模式,独立进程加独立 DB,消费 Portal 签发的 TDT。若服务端在其他仓库,应改用 portal-external-app skill。

主要能力:给出新建后端 App 的全链 checklist:建双包(Bun + Elysia,dev 端口取空闲 4xxx,DB 命名 xgent-<key>);整抄 spms-server 的 gate.ts 与 identity.ts 并改 listingKey/scope;完成 ACL Manifest、listing、服务账号、交换等布线;写非破坏性独立种子;把 server+app 挂进根 package.json 的 concurrently;一次做全部署接线(Caddy 白名单、compose profile、DEPLOYABLE_APP_SERVICES、Dockerfile COPY 新 workspace、build:apps 串行)。还规定每个受保护端点必须过自省与四道闸:listingKey/aud 匹配、scope 命中、结构性管理操作要求 role 为 admin、细粒度 bypass 或 permissions 命中 PID;平台级跨租户操作另加 claims.isPlatformAdmin。

使用方式与规范:自省走 POST /api/tokens/introspect(服务账号 Basic),响应统一信封、claims 取 body.data ?? body,active:false 属成功自省,缓存不超过 60s;租户隔离一律用 claims.tenant_id。业务状态不占 HTTP 状态码,统一 200 + {ok, data|error},数据不存在为 data:null;列表服务端分页;迁移手写 SQL;审计走 POST /api/v1/audit。

限制:具体契约以门户仓库 docs/ 为准,冲突时以门户仓库为准;缺 verify 脚本不算交付,需该 server 的 verify-*.ts 全绿且 bun run verify:all 不回归。其他未在资料中说明的细节暂未提供。