Files
kandev/docs/plans/multi-tenancy/task-08-instance-templates-and-operator.md
T
João Salavisa 481359ddb2 feat(auth): organization units, tenancy, roles and scopes for team access (#2919)
Co-authored-by: Kandev Agent <agent@kandev.dev>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-05 13:40:43 +00:00

56 lines
2.1 KiB
Markdown

---
id: "08-instance-templates-and-operator"
title: "Instance template API and operator role"
status: todo
wave: 3
depends_on: ["07-two-tier-config-storage"]
plan: "plan.md"
spec: "../../specs/multi-tenancy/spec.md"
---
# Task 08: Instance Template API and Operator Role
## Acceptance
- The `operator` instance tier exists on `authn.Identity` and gates
`/api/v1/instance/*`. `RequireOperator()` follows the shape of
`RequireAdmin()` and composes with `RequireRealIdentity()`.
- An operator has **no** read access to any org's workspaces, tasks, sessions,
transcripts, or secrets. A test asserts 404 for each, so the tier cannot
quietly become a visibility role.
- `/api/v1/instance/templates/{kind}` supports list, create, update, delete for
the eight kinds and writes only `org_id = ''` rows.
- A template body carrying a secret value, a sensitive env-var value, or an
integration credential is rejected with
`400 template_may_not_carry_credentials`, and nothing is written.
- The credential-free invariant is a pinning test over the template DTO field
set, so adding a credential-bearing field to a templated kind fails the build
until it is classified.
- On a single-org instance the auth setup wizard's first admin also receives
`operator`.
## Verification
- `go test ./internal/org/... ./internal/auth/... -run 'TestOperator|TestTemplate'`
- `go test ./internal/... -run TestTemplateMayNotCarryCredentials`
## Files Likely Touched
- `apps/backend/internal/auth/authn/identity.go`
- `apps/backend/internal/org/controller_templates.go`, `service_templates.go`
- `apps/backend/internal/auth/service_setup.go`
- `apps/backend/internal/tenancy/effective.go`
## Inputs
- Spec: Permissions table, API surface, What (templates carry shape not
credentials).
- Patterns: `authn.RequireAdmin` / `RequireRealIdentity`; the sensitivity
classification in `internal/common/config/catalog.go`.
## Output Contract
Report the operator-cannot-read test matrix, the credential field pinning
test and the mutation used to prove it fails, RED/GREEN commands, and set this
task plus its plan checkbox to done.