Concepts

AI Starter is organized around a few core ideas. Read these before changing code.

Diátaxis map

Section	Purpose
Getting started	Tutorials — run the stack
Concepts (here)	Explanations — why things are shaped this way
Generation	Domain + pipeline
Billing	Credits & payments
Security	Production hardening
Operations	Stack & workflow

Contracts over implementations — ports in libs/ports, adapters in libs/data-access-supabase / libs/adapters-mock.
Backend is authority — RLS + Edge service role; Angular guards are UX only.
Provider ignorance in UI — logical model ids; fal/Stripe/YooKassa live at the edge or in config.
Progressive productization — mock path works without API keys; real providers behind env flags.