Ship ticket-exchange and bind/policy for Z13, keep trial binds SMS-free, allow shared company bindings, and align SyncPage plus sync docs. Co-authored-by: Cursor <cursoragent@cursor.com>
Platform(go-zero)骨架
Publish(校验蓝图 → 分配 schema → 生成/执行 DDL → 注册元数据)+ 动态 CRUD + JWT。
目录
platform/
platform.go
docker-compose.yml # 本地 Postgres
etc/platform.yaml
internal/
authx/ # JWT 签发/校验 + Dev 头兜底
blueprint/
schema/ # Postgres DDL(数值 PK 用 IDENTITY)
meta/
crud/ # MemoryEngine + PostgresEngine
logic/applogic/
handler/
运行(内存 + JWT)
cd platform
go test ./...
go run . -f etc/platform.yaml
# 另开终端
go run ./scripts/smoke.go
冒烟会:签发 JWT → publish → create → list → 非法 token 应 401。
运行(Postgres 行级 Engine)
docker compose up -d
改 etc/platform.yaml:
DataSource: "postgres://platform:platform@127.0.0.1:5432/platform?sslmode=disable"
DevAuth: false
再启动服务。此时:
- publish 真实建 schema/表
- CRUD 走
PostgresEngine(参数化 SQL +tenant_id强制条件)
JWT
POST /api/v1/auth/token
{"tenant_id":1,"user_id":1,"secret":"dev-only-change-me"}
→ {"access_token":"...","token_type":"Bearer","expires_at":...}
业务请求:
Authorization: Bearer <access_token>
| 配置 | 行为 |
|---|---|
DevAuth: false |
必须带合法 JWT |
DevAuth: true |
无 JWT 时可用 X-Tenant-Id / X-User-Id(仅本地) |
| 带了错误 Bearer | 一律 401(即使 DevAuth=true) |
生产请更换 Auth.AccessSecret / IssueSecret,并关掉 DevAuth。
元数据落库
启用 DataSource 后自动迁移并使用 platform_meta.tenant_apps:
- 存 blueprint / ddl / endpoints / status
- 进程重启后仍可按 slug 解析动态 CRUD
- 无库时回退内存
MemoryStore