Vai al contenuto
Logo Aurabase
aurabase

Accordi

Denominazione di schemi, colonne, policy RLS, helper di autenticazione, indici. Convenzioni stabili e documentate in modo che il tuo team abbia un solo modo per dare un nome alle cose.

Riferimento6 min lettoLivello principianteRevisionato il 15 apr 2026

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Un prefisso per dominio#

Ogni progetto riceve quattro sottoschemi con il prefisso project_{uuid}. Le tue tabelle aziendali entrano nello schema principale; non creare mai oggetti negli schemi di sistema.

SchemaProprietarioUtilizzare
project_{uuid}tuTabelle, viste e funzioni aziendali. Questo è lo schema in cui arriva il tuo SQL non qualificato (create table posts …); è denominato public solo sull'SQL esportato con aura db backup download e schema/dump, che sono portatili.
project_{uuid}_authaura-authUtenti, sessioni e MFA. Non modificare.
project_{uuid}_storageaura-storageBucket, oggetti e policy di storage
project_{uuid}_platformpiattaformaFunzioni, job, cron e segreti

serpente_case, plurale, id uuid#

  • Plurale tabelle: posts, comments, invoices
  • Colonne in snake_case: created_at, user_id, last_seen_at
  • Chiavi primarie id uuid primary key default gen_random_uuid() — no uuid_generate_v4(). Preferisci uuid rispetto a bigint generated always as identity quando gli ID sono esposti ai client (non indovinabile, nessun problema di precisione 2 ^ 53 in JavaScript); funziona anche una colonna di identità e i backup e i ripristini la gestiscono.
  • Timestamp timestamptz, mai timestamp nudo
  • FK suffisso _id: author_id, tenant_id
  • Booleani con prefisso is_ o has_
  • Nessuna colonna project_id — lo schema è già l'isolante
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()
);
Attenzione

Non aggiungere mai una colonna project_id. L'isolamento deriva già dallo schema e una colonna di questo tipo aggiungerebbe indici senza aggiungere sicurezza.

Tre funzioni inserite in ogni sessione#

Il gateway apre connessioni Postgres con request.jwt.claims specificato. I tre aiutanti di seguito leggono queste affermazioni e possono essere utilizzati ovunque nelle tue polizze.

  • auth.uid() — uuid dell'utente corrente, NULL se anon
  • auth.role() — testo · anon / authenticated / service_role
  • auth.tenant() — uuid del tenant corrente (RBAC multi-tenant)
  • auth.has_role(name) — booleano · vero se l'utente ha questo ruolo dell'applicazione
  • auth.email() — testo · email dell'utente, letto da JWT
  • auth.claim(key) — jsonb · accesso non elaborato a un'attestazione personalizzata

Un nome prevedibile, un'operazione, un ruolo#

Convenzione: <table>_<scope>_<operation>. Esempio: posts_own_read, orders_admin_delete. Specificare sempre to aura_authenticated o to aura_anon.

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

-- ✗ Da evitare
create policy "allow_stuff"    -- troppo vago
create policy "new_policy_42" -- non descrittivo

Denominazione e quando indicizzare#

  • Nome: idx_<table>_<colonnes> o uq_<table>_<colonnes> (unico)
  • Indicizza sempre: FK, colonne filter/order_by frequenti, where di policy RLS
  • Non indicizzare: colonne booleane con cardinalità elevata bassa (usa indice parziale), tabelle < 1000 righe
  • pgvector: using hnsw per > 100k vettori, ivfflat altrimenti

Per andare oltre#