Files
member-console/internal/identity/querier.go
T
cgalo5758 12f1d3fc00 Fix the four Slice 3 walk findings and page every operator list
Archives openspec change slice3-walk-fixes and syncs its five delta
specs (fedwiki-sites, entitlements, operator-panel-navigation,
operator-list-scale, ui-quality-gate).

- FedWiki site usage is read from active site rows in both quota
  readers; the reservation counter converges on the rows: raise-only
  after farm sync and inside the create quota check, exact at boot.
  The understated production counters repair on the first boot.
- The People tile caption excludes the reserved system person through
  the same query parameter the directory uses.
- The operator Domains live-claims list is a governed list: pages of
  50, true total, search over root name and organization, a
  pending/active facet.
- New lint rule table-without-list-controls refuses an unpaged
  page-body table unless it carries a list-scale exempt marker with a
  reason; six curated or detail tables carry one. Its first run caught
  the operator FedWiki sites list, which is now governed the same way.
- Entitlement-set rule copy: "Per unit", "Multiplied by the quantity
  purchased or granted."
2026-09-12 01:16:17 -05:00

70 lines
3.5 KiB
Go

// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
// SPDX-FileCopyrightText: 2025-2026 Christian Galo
// Code generated by sqlc. DO NOT EDIT.
// versions:
// sqlc v1.29.0
package identity
import (
"context"
"github.com/google/uuid"
)
type Querier interface {
// Operator overview tile: how many people the deployment currently serves.
// Mirrors LookupPersons' status='active' filter so the headline number and
// the lookup affordance above it are counting the same population.
CountActivePersons(ctx context.Context) (int64, error)
// The People tile's caption: velocity rather than a restatement of the
// census. Same status filter as CountActivePersons so both numbers
// describe the same population.
// sqlc.narg(exclude_person_id): the reserved system person, in the shape
// ListPersonsPage uses, so the caption cannot drift from the headline and
// the directory total by counting it differently. NULL excludes nothing.
CountPersonsJoinedLast30Days(ctx context.Context, excludePersonID uuid.NullUUID) (int64, error)
CreatePerson(ctx context.Context, arg CreatePersonParams) (Person, error)
CreateUser(ctx context.Context, oidcSubject string) (User, error)
// Idempotently insert the reserved system person that owns the System tenant
// (keyed on the unique user_id). Read back with GetPersonByUserID.
EnsureSystemPerson(ctx context.Context, arg EnsureSystemPersonParams) error
// Idempotently insert the reserved, non-loginable system user (keyed on the
// unique oidc_subject sentinel). Safe under concurrent boots; read back with
// GetUserByOIDCSubject.
EnsureSystemUser(ctx context.Context, oidcSubject string) error
GetPersonByID(ctx context.Context, personID string) (Person, error)
GetPersonByUserID(ctx context.Context, userID string) (Person, error)
GetUserByOIDCSubject(ctx context.Context, oidcSubject string) (User, error)
ListPersons(ctx context.Context) ([]Person, error)
// People directory operator surface (operator-list-scale UX-4 /
// operator-people-directory D6): the paged, searched query feeding
// GET /operator/persons. Ordered newest-joined first so "who joined this
// week?" is answered by page one.
//
// sqlc.narg(q): NULL matches every row; set, a case-insensitive substring
// match against display_name or primary_email (operator-list-scale:
// "carries a scoped server-side search" -- "people: display name and
// email").
// sqlc.narg(exclude_person_id): the reserved system person (maintainer
// decision 2026-08-23: infrastructure, never "joined", excluded from the
// directory and its totals; it stays visible as the System tenant's owner
// in the organizations context). NULL excludes nothing.
// count(*) OVER() carries the true total for the filtered set alongside
// the page's rows (design D2), so the stated total never reflects only
// the page.
ListPersonsPage(ctx context.Context, arg ListPersonsPageParams) ([]ListPersonsPageRow, error)
// Resolves a lookup term to one or more active persons for the operator
// landing-surface lookup affordance. Exact email match wins (deterministic
// — operators using email expect precision); otherwise falls through to
// case-insensitive substring match against display_name. Status='active'
// filters out removed accounts. LIMIT 20 caps the disambiguation list
// without paging.
LookupPersons(ctx context.Context, primaryEmail string) ([]LookupPersonsRow, error)
UpdatePerson(ctx context.Context, arg UpdatePersonParams) (Person, error)
UpdateUserLogin(ctx context.Context, arg UpdateUserLoginParams) (User, error)
}
var _ Querier = (*Queries)(nil)