Weft demo 0.2.0-SNAPSHOT · REQ-LWS-010 合并版 · nginx :80 → DemoApp :8080 · H2 内存库（重启清空）

用户 CRUD（公开）前缀 /api/users

方法路径说明
GET/api/users/hello心跳文本
GET/api/users列表
GET/api/users/search?name=按名查询
POST/api/users新建：{"name":"alice","email":"a@x.io","age":30}
GET / PUT / DELETE/api/users/{id}单个读 / 改 / 删；POST /api/users/{id}/disable 停用

鉴权 前缀 /api/auth（JWT）

方法路径说明
POST/api/auth/login{"username":"admin","password":"admin-secret"} → token；账号 admin / user(user-secret) / ops(ops-secret)
GET/api/auth/meAuthorization: Bearer <token>
GET/api/auth/admin需 admin 角色
POST/api/auth/grant授权演示
—API key头 X-Api-Key: demo-api-key-0123456789

SSE 实时 前缀 /sse

路径说明
/sse/clock每秒一条 tick
/sse/progress进度事件流
/sse/burst突发推送
/sse/idle只发心跳的空闲流

校验 前缀 /api/validation

方法路径说明
POST/api/validation/signup · /booking · /multi · /adminBean 校验演示（必填 / 长度 / 范围 / 分组），错误体统一 {code,message,traceId}
GET/api/validation/item/{id}路径参数校验

门户（OIDC 会话）前缀 /portal

路径说明
/portal/home · /portal/me · /portal/admin · POST /portal/notes需 OIDC 登录（本部署未接 IdP，会跳转登录）

运维端点

404 是 Weft 自己的响应体：{"code":404,"message":"No route for ...","traceId":"..."}，traceId 可在日志里追。

路径说明
/weft/health健康
/weft/metrics指标（JSON；?format=prom 为 Prometheus 文本）