sharang
80181855bc
PLATFORM_ARCHITECTURE.md §5c schema, end-to-end:
enums: tenant_status (demo/trial/active/frozen/archived),
tenant_kind (customer/demo), idp_kind (oidc/saml),
tenant_project_status (active/archived)
tables: tenants id/slug/name/status/kind/plan/erp_id/
stripe_id/trial_ends_at/contract_dates/
sales_owner
tenant_projects sub-tenancy (GCP-Project style); opt-in via
product manifest.supports_projects=true
tenant_products tenant ↔ product matrix + JSONB config
tenant_idp_config enterprise SSO (OIDC/SAML metadata + verified)
api_keys argon2 hash + prefix + scopes + revoked_at;
single source of truth across all products
audit_log Retraced-compatible: actor/action/target/
product/metadata; indexed for cross-product
filtering (PRODUCT_INTEGRATION_SPEC.md §8.4)
triggers: updated_at auto-bump on every mutable table.
fks: ON DELETE CASCADE for owned rows; SET NULL for audit_log so
forensic history outlives the tenant delete.
cmd/migrate (new binary):
golang-migrate as a library with the migrations embedded via
migrations/embed.go → embed.FS. Sub-commands: up / down / version /
force. Ships as a self-contained binary; in prod it's the Orca init
container per IMPLEMENTATION_PLAN.md §1.7.
Dockerfile builds both binaries; the migrate one is invoked separately
as the init step.
Tests (require Docker; gated by -short):
TestMigrate_upDownRoundTrip schema → 6 tables + 4 enums; down→empty;
up-after-down succeeds (round-trip clean)
TestSeed_canInsertAndQuery insert across every table; FK cascade
works; audit_log SET-NULL keeps the row
TestSlugConstraint tenant.slug regex rejects too-short /
leading dash / trailing dash / uppercase /
underscore
Makefile:
make migrate-up / down / down-all / version / create NAME=...
make test-short → skip integration when Docker isn't around
make build-migrate → just the migrator binary
The handler-layer in-memory store is unchanged; M4.2 swaps it for the
pgx-backed implementation against this schema.
Refs: M4.1
88 lines
2.7 KiB
Makefile
88 lines
2.7 KiB
Makefile
# tenant-registry — Go service for tenant glue, audit, API keys.
|
|
|
|
.PHONY: help dev test test-short build build-migrate fmt vet lint docker clean \
|
|
migrate-up migrate-down migrate-down-all migrate-version migrate-create
|
|
|
|
ADDR ?= :8090
|
|
APP_ENV ?= dev
|
|
DATABASE_URL ?= postgres://platform:platform-dev-pass@localhost:5432/platform?sslmode=disable
|
|
|
|
help:
|
|
@echo "tenant-registry targets:"
|
|
@echo ""
|
|
@echo " Server:"
|
|
@echo " make dev go run ./cmd/server (foreground, APP_ENV=dev)"
|
|
@echo " make build compile to ./bin/tenant-registry"
|
|
@echo " make build-migrate compile to ./bin/migrate"
|
|
@echo " make docker build local image (tenant-registry:dev)"
|
|
@echo ""
|
|
@echo " Schema:"
|
|
@echo " make migrate-up apply all pending migrations (uses DATABASE_URL)"
|
|
@echo " make migrate-down roll back the most recent migration"
|
|
@echo " make migrate-down-all roll back EVERY migration (DESTRUCTIVE)"
|
|
@echo " make migrate-version print current schema version"
|
|
@echo " make migrate-create NAME=add_foo"
|
|
@echo " create a new pair of empty migration files"
|
|
@echo ""
|
|
@echo " CI:"
|
|
@echo " make test go test -race ./... (includes testcontainers)"
|
|
@echo " make test-short go test -race -short ./... (skips integration)"
|
|
@echo " make fmt | vet | lint"
|
|
|
|
dev:
|
|
@APP_ENV=$(APP_ENV) ADDR=$(ADDR) go run ./cmd/server
|
|
|
|
test:
|
|
@go test -race ./...
|
|
|
|
test-short:
|
|
@go test -race -short ./...
|
|
|
|
build:
|
|
@mkdir -p bin
|
|
@CGO_ENABLED=0 go build -o bin/tenant-registry ./cmd/server
|
|
@echo "built ./bin/tenant-registry"
|
|
|
|
build-migrate:
|
|
@mkdir -p bin
|
|
@CGO_ENABLED=0 go build -o bin/migrate ./cmd/migrate
|
|
@echo "built ./bin/migrate"
|
|
|
|
fmt:
|
|
@gofmt -w .
|
|
@test -z "$$(gofmt -l .)"
|
|
|
|
vet:
|
|
@go vet ./...
|
|
|
|
lint: fmt vet
|
|
|
|
docker:
|
|
@docker build -t tenant-registry:dev .
|
|
|
|
clean:
|
|
@rm -rf bin
|
|
|
|
# ─── migrations ────────────────────────────────────────────────────────────
|
|
|
|
migrate-up:
|
|
@DATABASE_URL=$(DATABASE_URL) go run ./cmd/migrate up
|
|
|
|
migrate-down:
|
|
@DATABASE_URL=$(DATABASE_URL) go run ./cmd/migrate down
|
|
|
|
migrate-down-all:
|
|
@DATABASE_URL=$(DATABASE_URL) go run ./cmd/migrate -all down
|
|
|
|
migrate-version:
|
|
@DATABASE_URL=$(DATABASE_URL) go run ./cmd/migrate version
|
|
|
|
migrate-create:
|
|
ifndef NAME
|
|
$(error usage: make migrate-create NAME=add_something)
|
|
endif
|
|
@n=$$(ls migrations/*.up.sql 2>/dev/null | wc -l); \
|
|
next=$$(printf "%04d" $$((n + 1))); \
|
|
touch migrations/$${next}_$(NAME).up.sql migrations/$${next}_$(NAME).down.sql; \
|
|
echo "created migrations/$${next}_$(NAME).{up,down}.sql"
|