mirror of
https://github.com/hanzoai/service-template.git
synced 2026-10-30 18:22:53 +00:00
zeekay
0b2e3abe65
github.com/hanzoai/template existed only as loose files: no .git, no history, no remote. Sweeps that look for a .git directory could not see it, and an rm -rf would have destroyed it with nothing to recover from. Committed as-is; no source modified. NOTE: no remote. This is still one copy in one place.
1.4 KiB
1.4 KiB
hanzoai/template — canonical Go backend skeleton
This is the one-way shape for a Hanzo-stack Go backend. Copy the tree, rename
template everywhere, and wire your routes. Do not deviate from the
layout without a spec change in ~/work/hanzo/ARCHITECTURE.md.
The skeleton ships:
cmd/app/— operator CLI (migrate, seed, shell).cmd/appd/— long-running HTTP daemon.config/config.go— env-only configuration.api/— HTTP handlers (public + tenant-scoped).models/—orm.Typed[T]data models.migrations/— base TS migrations.store/— thin wrapper aroundhanzoai/base/store.MultiTenantStore.web/— optional embedded SPA.LLM.md— next-agent handoff.
The key invariants it enforces:
- Gateway-upstream assertion at boot (
claims.AssertGatewayUpstream). claims.Strip → claims.Inject → claims.RequireGatewayon every tenant-scoped route.- Per-(org, user) SQLite via
store.ForCtx(ctx). No direct file opens. - Public endpoints (
/healthz,/readyz,/metrics) mount BEFORE the tenant middleware chain. - Single multi-arch image built in CI — never locally.
To bootstrap a new service:
cp -R ~/work/hanzo/_template ~/work/hanzo/<service>
cd ~/work/hanzo/<service>
find . -type f -exec sed -i '' 's/template/<service>/g' {} +
go mod init github.com/hanzoai/<service>
go mod tidy
go test ./...
Then replace models/example.go and api/example.go with your domain.