go-omni/examples/platform/README.md

扩展模块组合示例

业务通过 storage.Store 写文件，身份接口和 Policy 控制权限，OpenAPI 与路由一起注册，链路追踪关联 HTTP 与文件操作。newApp 不依赖 Local/S3/OSS 类型；启动处本例选择 Local。可替换成 S3/R2/OSS 构造结果，业务路由不变。

export GO_OMNI_DEMO_TOKEN='use-a-private-development-token'
go run ./examples/platform --root /tmp/goOmniDemoFiles

接口：POST /api/files，JSON 为 {"name":"hello.txt","content":"hello"}，请求加 Authorization: Bearer <GO_OMNI_DEMO_TOKEN>；返回 201 和存储信息。GET /openapi.json 同样要求身份。

也可传 --config service.yaml，配置规则见 扩展模块。本例的静态身份只用于演示，实际应用注入 auth.JWT 或 auth.Sessions；trace provider 默认不外发，接入 collector 时注入 exporter/reader。

TestPlatformTLSAdapters 通过三个 Runner 的真实 TLS 请求验证 401/403/201、文件内容、非法 key、OpenAPI 和关闭。文件根目录必须是应用私有目录。示例不执行自动数据迁移，也不启动 Orbit。