4c46d673fb
Replaces the M5.1-skeleton handler set with the M4.2 spec from
IMPLEMENTATION_PLAN.md:
Endpoints (authoritative shape in openapi.yaml):
POST /v1/tenants
GET /v1/tenants/{id}
GET /v1/tenants/by-slug/{slug}
POST /v1/tenants/{id}/activate
POST /v1/tenants/{id}/cancel
GET /v1/entitlements?tenant_id=...
GET /v1/catalog
POST /v1/catalog/request
POST /v1/catalog/trial-request
POST /v1/api-keys returns plaintext ONCE
GET /v1/api-keys?tenant_id=...
DELETE /v1/api-keys/{id}
POST /v1/internal/api-keys/verify always 200; valid: bool
POST /v1/audit
GET /v1/audit?{tenant_id,product,actor_id,action,since,until,limit,cursor}
Architecture:
internal/store/store.go Store interface (CRUD + audit + ping)
internal/store/memory.go in-process impl, used when DATABASE_URL
is empty (seed acme tenant, no migrations)
internal/store/postgres.go pgxpool impl against the M4.1 schema
internal/server/server.go router + healthz/readyz
internal/server/{tenants,catalog,apikeys,audit}.go
per-concern handlers (≤250 LoC each)
internal/server/helpers.go writeJSON/writeError/error mapping/log mw
openapi.yaml 3.1 spec; openapi_test.go is the contract gate
API keys:
Plaintext format 'bp_<22-char base64>'. Prefix bp_<8> stored for UI.
Hash is argon2id(salt, time=1, mem=64MB, threads=4, len=32) encoded as
'argon2id|<salt-b64>|<hash-b64>'. Format-tagged so we can rotate
parameters without re-keying. Verify is constant-time.
Store selection:
cmd/server picks Postgres when DATABASE_URL is set, otherwise Memory.
Both implementations are exercised by the same eachStore test harness —
parity is enforced.
Audit:
Every state-changing endpoint emits via s.emitAudit() (fire-and-forget).
audit_log uses ON DELETE SET NULL on tenant_id so forensic history
outlives tenant deletes (per M4.1 schema).
Routing constraint:
Go 1.22 ServeMux can't disambiguate /v1/tenants/{id}/products from
/v1/tenants/by-slug/{slug=products}. Per-tenant subresources moved to
query-param top-level paths: /v1/entitlements?tenant_id=… and
/v1/api-keys?tenant_id=….
Tests:
Every endpoint exercised against both Memory and Postgres via the
eachStore harness. Includes happy paths, validation errors, conflicts,
404s, auto-audit-emit assertion. testcontainers-go for the postgres
harness; gated by -short.
TestOpenAPISpec is the contract gate: every documented operation must
resolve against the router. (kin-openapi v0.138.0.)
Refs: M4.2
146 lines
4.1 KiB
Go
146 lines
4.1 KiB
Go
package server
|
|
|
|
import (
|
|
"context"
|
|
"net/http"
|
|
"time"
|
|
|
|
"gitea.meghsakha.com/platform/tenant-registry/internal/store"
|
|
)
|
|
|
|
// catalog is hard-coded for now. PRODUCT_INTEGRATION_SPEC.md §10 has products
|
|
// publish a manifest to `cdn.breakpilot.com`; this list will be sourced
|
|
// from those manifests once M6.3 / M7.2 wire it up.
|
|
var catalog = []store.CatalogEntry{
|
|
{
|
|
Key: "certifai", Name: "CERTifAI",
|
|
Description: "Self-hosted GDPR-compliant AI dashboard.",
|
|
PlansRequired: []string{"professional", "enterprise"},
|
|
SupportsTrial: true,
|
|
},
|
|
{
|
|
Key: "compliance", Name: "Compliance",
|
|
Description: "DSFA / TOM / VVT generation; evidence capture.",
|
|
PlansRequired: []string{"starter", "professional", "enterprise"},
|
|
SupportsTrial: true,
|
|
},
|
|
}
|
|
|
|
func (s *Server) getCatalog(w http.ResponseWriter, _ *http.Request) {
|
|
writeJSON(w, http.StatusOK, map[string]any{"items": catalog})
|
|
}
|
|
|
|
type catalogRequestReq struct {
|
|
TenantID string `json:"tenant_id"`
|
|
Product string `json:"product"`
|
|
}
|
|
|
|
// catalogRequest — customer requests a non-subscribed product. Today this
|
|
// just emits an audit event tagged so the eventual ERPNext-Lead step
|
|
// (M11.1) can pick it up.
|
|
func (s *Server) catalogRequest(w http.ResponseWriter, r *http.Request) {
|
|
var in catalogRequestReq
|
|
if !decodeJSON(w, r, &in) {
|
|
return
|
|
}
|
|
if in.TenantID == "" || in.Product == "" {
|
|
writeError(w, http.StatusBadRequest, "invalid_input", "tenant_id and product are required")
|
|
return
|
|
}
|
|
if !isKnownProduct(in.Product) {
|
|
writeError(w, http.StatusBadRequest, "unknown_product", "product is not in the catalog")
|
|
return
|
|
}
|
|
|
|
ctx, cancel := context.WithTimeout(r.Context(), 5*time.Second)
|
|
defer cancel()
|
|
|
|
if _, err := s.Store.GetTenant(ctx, in.TenantID); err != nil {
|
|
if mapStoreError(w, err) {
|
|
return
|
|
}
|
|
writeError(w, http.StatusInternalServerError, "internal", err.Error())
|
|
return
|
|
}
|
|
|
|
s.emitAudit(ctx, r, store.AuditEvent{
|
|
TenantID: in.TenantID, Action: "catalog.requested",
|
|
TargetID: in.Product, TargetType: "product",
|
|
Metadata: map[string]interface{}{"product": in.Product},
|
|
})
|
|
|
|
writeJSON(w, http.StatusAccepted, map[string]string{
|
|
"status": "accepted",
|
|
"message": "request recorded; sales will be in touch",
|
|
})
|
|
}
|
|
|
|
// catalogTrialRequest — customer self-serves a 14-day trial of a product
|
|
// that supports trial. Provisions the entitlement immediately so the
|
|
// product can be used right away.
|
|
func (s *Server) catalogTrialRequest(w http.ResponseWriter, r *http.Request) {
|
|
var in catalogRequestReq
|
|
if !decodeJSON(w, r, &in) {
|
|
return
|
|
}
|
|
if in.TenantID == "" || in.Product == "" {
|
|
writeError(w, http.StatusBadRequest, "invalid_input", "tenant_id and product are required")
|
|
return
|
|
}
|
|
entry, ok := lookupCatalogEntry(in.Product)
|
|
if !ok {
|
|
writeError(w, http.StatusBadRequest, "unknown_product", "product is not in the catalog")
|
|
return
|
|
}
|
|
if !entry.SupportsTrial {
|
|
writeError(w, http.StatusBadRequest, "trial_unavailable", "product does not support self-serve trial")
|
|
return
|
|
}
|
|
|
|
ctx, cancel := context.WithTimeout(r.Context(), 5*time.Second)
|
|
defer cancel()
|
|
|
|
if _, err := s.Store.GetTenant(ctx, in.TenantID); err != nil {
|
|
if mapStoreError(w, err) {
|
|
return
|
|
}
|
|
writeError(w, http.StatusInternalServerError, "internal", err.Error())
|
|
return
|
|
}
|
|
|
|
expiresAt := time.Now().UTC().Add(14 * 24 * time.Hour)
|
|
tp, err := s.Store.UpsertTenantProduct(ctx, store.TenantProduct{
|
|
TenantID: in.TenantID, Product: in.Product, Enabled: true,
|
|
Config: map[string]interface{}{"source": "trial"}, ExpiresAt: &expiresAt,
|
|
})
|
|
if err != nil {
|
|
if mapStoreError(w, err) {
|
|
return
|
|
}
|
|
writeError(w, http.StatusInternalServerError, "internal", err.Error())
|
|
return
|
|
}
|
|
|
|
s.emitAudit(ctx, r, store.AuditEvent{
|
|
TenantID: in.TenantID, Action: "catalog.trial_started",
|
|
TargetID: in.Product, TargetType: "product",
|
|
Metadata: map[string]interface{}{"product": in.Product, "expires_at": expiresAt.Format(time.RFC3339)},
|
|
})
|
|
|
|
writeJSON(w, http.StatusCreated, tp)
|
|
}
|
|
|
|
func isKnownProduct(key string) bool {
|
|
_, ok := lookupCatalogEntry(key)
|
|
return ok
|
|
}
|
|
|
|
func lookupCatalogEntry(key string) (store.CatalogEntry, bool) {
|
|
for _, e := range catalog {
|
|
if e.Key == key {
|
|
return e, true
|
|
}
|
|
}
|
|
return store.CatalogEntry{}, false
|
|
}
|