Zum Inhalt springen
Aurabase-Logo
Aurabasis

Vereinbarungen

Benennung von Schemata, Spalten, RLS-Richtlinien, Authentifizierungshilfen, Indizes. Stabile, dokumentierte Konventionen, damit Ihr Team eine Möglichkeit hat, Dinge zu benennen.

Referenz6 Min. gelesenEbene AnfängerÜberarbeitet am 15.04.2026

Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.

Ein Präfix pro Domain#

Jedes Projekt erhält vier Unterschemata mit dem Präfix project_{uuid}. Ihre Geschäftstabellen gehen in das Hauptschema ein; Erstellen Sie niemals Objekte in Systemschemata.

SchemaBesitzerBenutzen
project_{uuid}DuTabellen, Ansichten und Geschäftsfunktionen. Dies ist das Schema, in dem Ihr unqualifiziertes SQL (create table posts …) landet; Es heißt public nur in der SQL, die Sie mit aura db backup download und schema/dump exportieren, die portierbar sind.
project_{uuid}_authaura-authBenutzer, Sitzungen und MFA. Nicht ändern.
project_{uuid}_storageaura-storageBuckets, Objekte und Speicherrichtlinien
project_{uuid}_platformPlattformFunktionen, Jobs, Cron und Geheimnisse

Snake_case, Plural, ID-UUID#

  • Plural Tabellen: posts, comments, invoices
  • Spalten in snake_case: created_at, user_id, last_seen_at
  • Primärschlüssel id uuid primary key default gen_random_uuid() – nein uuid_generate_v4(). Bevorzugen Sie uuid gegenüber bigint generated always as identity, wenn IDs für Clients verfügbar gemacht werden (nicht erraten, kein 2^53-Genauigkeitsproblem in JavaScript); Eine Identitätsspalte funktioniert ebenfalls und wird von Sicherungen und Wiederherstellungen übernommen.
  • Zeitstempel timestamptz, niemals timestamp nackt
  • FKs mit Suffix _id: author_id, tenant_id
  • Boolesche Werte mit Präfix is_ oder has_
  • Keine Spalte project_id – der Schaltplan ist bereits der 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()
);
Achtung

Fügen Sie niemals eine project_id-Spalte hinzu. Die Isolation ergibt sich bereits aus dem Schema, und eine solche Spalte würde Indizes hinzufügen, ohne die Sicherheit zu erhöhen.

In jede Sitzung werden drei Funktionen eingefügt#

Das Gateway öffnet Postgres-Verbindungen mit der angegebenen request.jwt.claims. Die drei folgenden Helfer lesen diese Ansprüche und können überall in Ihren Policen verwendet werden.

  • auth.uid() — uuid des aktuellen Benutzers, NULL, wenn anonym
  • auth.role() — Text · anonym / authentifiziert / service_role
  • auth.tenant() — uuid des aktuellen Mandanten (Multi-Tenant-RBAC)
  • auth.has_role(name) — boolean · true, wenn der Benutzer diese Anwendungsrolle hat
  • auth.email() — Text · Benutzer-E-Mail, gelesen aus JWT
  • auth.claim(key) — jsonb · Rohzugriff auf einen benutzerdefinierten Anspruch

Ein vorhersehbarer Name, eine Operation, eine Rolle#

Konvention: <table>_<scope>_<operation>. Beispiel: posts_own_read, orders_admin_delete. Geben Sie immer to aura_authenticated oder to aura_anon an.

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

-- ✗ Zu vermeiden
create policy "allow_stuff"    -- zu vage
create policy "new_policy_42" -- nicht beschreibend

Benennung und Zeitpunkt der Indizierung#

  • Name: idx_<table>_<colonnes> oder uq_<table>_<colonnes> (eindeutig)
  • Indizieren Sie immer: FKs, häufige filter/order_by-Spalten, where von RLS-Richtlinien
  • Nicht indizieren: Boolesche Spalten mit hoher Kardinalität niedrig (Teilindex verwenden), Tabellen < 1000 Zeilen
  • pgvector: using hnsw für > 100.000 Vektoren, andernfalls ivfflat

Um weiter zu gehen#