Naar de inhoud springen
Aurabase-logo
aurabasis

Overeenkomsten

Naamgeving van schema's, kolommen, RLS-beleid, auth-helpers, indexen. Stabiele, gedocumenteerde conventies, zodat uw team dingen op één manier kan benoemen.

Referentie6 min lezenNiveau beginnerHerzien op 15 apr 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

Eén voorvoegsel per domein#

Elk project ontvangt vier subschema's met het voorvoegsel project_{uuid}. Uw bedrijfstabellen worden in het hoofdschema opgenomen; Maak nooit objecten in systeemschema's.

SchemaEigenaarGebruik
project_{uuid}jijTabellen, weergaven en zakelijke functies. Dit is het schema waarin uw niet-gekwalificeerde SQL (create table posts …) terechtkomt; het heet alleen public op de SQL die u exporteert met aura db backup download en schema/dump, die overdraagbaar zijn.
project_{uuid}_authaura-authGebruikers, sessies en MFA. Niet wijzigen.
project_{uuid}_storageaura-storageEmmers, objecten en opslagbeleid
project_{uuid}_platformplatformFuncties, banen, cron en geheimen

snake_case, meervoud, id uuid#

  • Meervoud tabellen: posts, comments, invoices
  • Kolommen in snake_case: created_at, user_id, last_seen_at
  • Primaire sleutels id uuid primary key default gen_random_uuid() — nee uuid_generate_v4(). Geef de voorkeur aan uuid boven bigint generated always as identity wanneer ID's worden weergegeven aan clients (niet te raden, geen 2^53 precisieprobleem in JavaScript); een identiteitskolom werkt ook, en back-ups en herstelbewerkingen kunnen dit verwerken.
  • Tijdstempels timestamptz, nooit timestamp naakt
  • FK's met achtervoegsel _id: author_id, tenant_id
  • Booleans voorafgegaan door is_ of has_
  • Geen kolom project_id — het schema is al de isolator
exemplesql
create table posts (
  id            uuid primary key default gen_random_uuid(),
  author_id     uuid not null references users(id) on delete cascade,
  title         text not null,
  is_published  boolean not null default false,
  created_at    timestamptz not null default now()
);
Aandacht

Voeg nooit een kolom project_id toe. Isolatie komt al voort uit het schema, en zo'n kolom zou indexen toevoegen zonder beveiliging toe te voegen.

Drie functies geïnjecteerd in elke sessie#

De gateway opent Postgres-verbindingen waarbij request.jwt.claims is opgegeven. De drie onderstaande helpers lezen deze claims en kunnen overal in uw polis worden gebruikt.

  • auth.uid() — uuid van de huidige gebruiker, NULL indien anon
  • auth.role() — tekst · anoniem / geverifieerd / service_rol
  • auth.tenant() — uuid van de huidige tenant (RBAC met meerdere tenants)
  • auth.has_role(name) — boolean · waar als de gebruiker deze applicatierol heeft
  • auth.email() — tekst · e-mailadres van gebruiker, voorgelezen uit de JWT
  • auth.claim(key) — jsonb · onbewerkte toegang tot een aangepaste claim

Een voorspelbare naam, een operatie, een rol#

Conventie: <table>_<scope>_<operation>. Voorbeeld: posts_own_read, orders_admin_delete. Geef altijd to aura_authenticated of to aura_anon op.

namingsql
-- ✓ Goed: table_scope_op
create policy "posts_own_read"   on posts for select …
create policy "orders_admin_all" on orders for all …

-- ✗ Om te vermijden
create policy "allow_stuff"    -- te vaag
create policy "new_policy_42" -- niet beschrijvend

Naamgeving en wanneer indexeren#

  • Naam: idx_<table>_<colonnes> of uq_<table>_<colonnes> (uniek)
  • Indexeer altijd: FK's, frequente filter/order_by kolommen, where van RLS beleid
  • Niet indexeren: Booleaanse kolommen met hoge kardinaliteit laag (gebruik gedeeltelijke index), tabellen < 1000 rijen
  • pgvector: using hnsw voor > 100k vectoren, ivfflat anders

Om verder te gaan#