Tenant Onboarding: Register to First Flag

Tenant Onboarding: Register to First Flag A workflow diagram generated by Archify. 01 / Operator 02 / API 03 / PostgreSQL 04 / Cache Identity Provision Finalize Register · POST /register · Operator › Identity · rate limited Register POST /register rate limited Create Org · create org · API › Identity · owner = caller Create Org create org owner = caller Create Project · create project · API › Provision · auto envs Create Project create project auto envs Create Flag · create flag · API › Provision · project scoped Create Flag create flag project scoped 201 Created · flag response · API › Finalize 201 Created flag response organizations · owner_id · PostgreSQL › Identity · unique name organizations owner_id unique name dev staging prod · version = 1 · PostgreSQL › Provision dev staging prod version = 1 flag × env states · seed states · PostgreSQL › Provision flag × env states seed states audit_logs · flag.created · PostgreSQL › Finalize · user attributed audit_logs flag.created user attributed bump + evict · all envs · Cache › Provision · SCAN + DEL bump + evict all envs SCAN + DEL commit bump all versions seed states org owned INSERT provision 3 project ready access token audit row Legend Agent logic Context / trace External system

Nothing is auto-provisioned

  • • There is no default organization or project. Both are explicitly created, and a user may own many organizations.
  • • Creating a project is the only place the standard dev, staging, and prod environments appear, and it happens in the same transaction as the project.

Tenancy is enforced, not assumed

  • • Organization.owner_id is the ownership boundary, and every project, environment, and flag lookup is filtered through it.
  • • A missing resource and an inaccessible one both answer 404, so IDs cannot be enumerated by probing.