feat: add docker capacity benchmark mode

docs/refactor/architecture.md

@@ -62,6 +62,14 @@ npm run docker:api:up
 
 如果 Docker 拉取 `node:20-alpine` 超时，先配置 Docker Desktop 镜像源或代理，再重试 `npm run docker:api:build`。
 
+本地容量预演可以使用专门的 benchmark override：
+
+```bash
+npm run perf:api:docker-4c16g
+```
+
+该命令会使用 `docker-compose.api.yml` + `docker-compose.api.benchmark.yml` 启动受限 API 容器，默认限制 API 为 2 CPU/4G、`DB_POOL_MAX=10`，关闭 `ALLOW_LEGACY_AUTH_HEADERS`，并用 Bearer `tk_` 会话跑压测。它只用于本地模拟和跑分，不是生产 compose 文件。
+
 验证 API：
 
 ```bash
@@ -81,6 +89,7 @@ npm run pb:import:validate
 
 - Docker Desktop 可用。
 - Supabase 本地容器可启动。
+- API Dockerfile 已验证可构建；benchmark override 可启动受限 API 容器并通过短压测 smoke。
 - `supabase db reset` 可完整执行三份 migration 和 seed。
 - `supabase db reset` 可完整执行全部 migration 和 seed。
 - `npm run db:smoke-seed` 可恢复最小业务烟测数据。