feat: add administrator repository (#11803)

Introduces the `administrators` relational table and repository layer
for the v3 backend, unifying instance, organization, project, and
project-grant membership into a single scoped model.

Closes #10220

## Changes

- **Domain**: `Administrator` struct, `AdministratorScope` enum,
`AdministratorRepository` interface with typed CRUD, column, condition,
and change helpers. Generated enumer and GoMock.
- **Migration** (`016`): `zitadel.administrators` table with a generated
`id`, scope-alignment check constraint, cascading foreign keys, and a
child `administrator_roles` table.
- **Repository**: CTE-based role mutations (`AddRole`, `RemoveRole`,
`SetRoles`) for atomicity. Roles aggregated via `ARRAY_AGG`.
- **Projection**: Event reducers for
`member.added/changed/removed/cascade_removed` across all four admin
scopes.
- **Fixes**: `Rows.Close()` error wrapping; `TextArray` nil-safe scan +
full `pgtype` array interface; `authorization` and `projectGrant` scan
helpers fixed for `ARRAY_AGG` under `database/sql`; removed unused `ctx`
parameter from `callReduce`.

---------

Co-authored-by: Marco Ardizzone <[email protected]>
This commit is contained in:
Silvan
2026-03-18 10:24:09 +01:00
committed by GitHub
co-authored by Marco Ardizzone
parent 6d90a120a6
commit f138082b64
21 changed files with 3513 additions and 46 deletions
@@ -377,6 +377,24 @@ func (p *relationalTablesProjection) Reducers() []handler.AggregateReducer {
Event: instance.IDPRemovedEventType,
Reduce: p.reduceIDPRemoved,
},
// Administrators
{
Event: instance.MemberAddedEventType,
Reduce: p.reduceInstanceAdminAdded,
},
{
Event: instance.MemberChangedEventType,
Reduce: p.reduceInstanceAdminChanged,
},
{
Event: instance.MemberRemovedEventType,
Reduce: p.reduceInstanceAdminRemoved,
},
{
Event: instance.MemberCascadeRemovedEventType,
Reduce: p.reduceInstanceAdminRemoved,
},
},
},
{
@@ -750,6 +768,24 @@ func (p *relationalTablesProjection) Reducers() []handler.AggregateReducer {
Event: org.IDPRemovedEventType,
Reduce: p.reduceIDPRemoved,
},
// Administrators
{
Event: org.MemberAddedEventType,
Reduce: p.reduceOrganizationAdminAdded,
},
{
Event: org.MemberChangedEventType,
Reduce: p.reduceOrganizationAdminChanged,
},
{
Event: org.MemberRemovedEventType,
Reduce: p.reduceOrganizationAdminRemoved,
},
{
Event: org.MemberCascadeRemovedEventType,
Reduce: p.reduceOrganizationAdminRemoved,
},
},
},
{
@@ -828,6 +864,40 @@ func (p *relationalTablesProjection) Reducers() []handler.AggregateReducer {
Event: project.RoleRemovedType,
Reduce: p.reduceProjectRoleRemoved,
},
// Administrators
{
Event: project.MemberAddedEventType,
Reduce: p.reduceProjectAdminAdded,
},
{
Event: project.MemberChangedEventType,
Reduce: p.reduceProjectAdminChanged,
},
{
Event: project.MemberRemovedEventType,
Reduce: p.reduceProjectAdminRemoved,
},
{
Event: project.MemberCascadeRemovedEventType,
Reduce: p.reduceProjectAdminRemoved,
},
{
Event: project.GrantMemberAddedType,
Reduce: p.reduceProjectGrantAdminAdded,
},
{
Event: project.GrantMemberChangedType,
Reduce: p.reduceProjectGrantAdminChanged,
},
{
Event: project.GrantMemberRemovedType,
Reduce: p.reduceProjectGrantAdminRemoved,
},
{
Event: project.GrantMemberCascadeRemovedType,
Reduce: p.reduceProjectGrantAdminRemoved,
},
},
},
{