# Prezentare generală

Platforma Ilustromania este o aplicație SaaS cu mai multe firme pe același cont. Fiecare firmă își alege modulele, oamenii și drepturile, iar datele ei rămân izolate de celelalte.

## Ce este platforma

Platforma rulează la `app.ilustromania.com` și adună într-un singur loc lucrurile pe care o firmă le face zilnic: meniul și canalele de livrare pentru un restaurant, creatorii și campaniile pentru o agenție, facturile, documentele, echipa și automatizările pentru oricare dintre ele.

Firma ta și modulele ei:

| Firmă | Tip | Ce folosește în principal |
| --- | --- | --- |
| Ilustromania | `agentie` | agenție de creatori, Backstage, social media, oferte, Website Builder |

Aceeași platformă poate primi oricâte firme noi. O firmă nouă pornește goală, își activează doar modulele de care are nevoie și își invită oamenii.

## Cum este organizată documentația

| Secțiune | Pentru cine | Ce găsești |
| --- | --- | --- |
| [Ghid](#concepte) | oricine folosește aplicația | conceptele de bază, primii pași și fiecare modul pe rând |
| [Administrare](#firme-si-module) | administratorul firmei | firme, module, conturi, roluri, securitate, limite |
| [Integrări](#mcp) | echipe tehnice | MCP, OAuth, evenimente, canalele de livrare, DLS, FGO, SPV |
| [Referință API](#api-prezentare) | dezvoltatori | toate cele 398 de rute, cu metoda, calea și nivelul de acces |
| [Resurse](#standarde) | toată lumea | comparația cu standardele din industrie, foaia de parcurs, glosarul |

> [!NOTE]
> Referința API este generată direct din codul platformei (harta de acces a rutelor), nu scrisă de mână. Dacă o rută apare aici, ea există și are accesul declarat.

## Principiile platformei

- **Firma este granița.** Orice rând de date aparține unei firme, iar baza de date refuză singură citirile din altă firmă (Row Level Security).
- **Refuz implicit.** O rută care nu își declară accesul nu răspunde deloc: primește `401 ruta_nedeclarata` înainte să ajungă la cod.
- **O singură margine.** Datele din afară (cereri, fișiere, servicii externe) intră printr-un singur loc și sunt validate cu scheme înainte de folosire.
- **Fără zerouri false.** Când o sursă lipsește, răspunsul este `503` cu motivul, niciodată o listă goală care ar putea fi citită ca „nu există nimic”.
- **Fără ștergeri pe nevăzute.** Produsele, codurile de reducere, joburile și facturile emise se dezactivează sau se anulează, nu dispar.

## Următorii pași

1. Citește [Concepte](#concepte) ca să înțelegi firmele, conturile, rolurile și modulele.
2. Urmează [Primii pași](#primii-pasi) pentru intrarea în cont și alegerea firmei.
3. Deschide modulul cu care lucrezi din meniul din stânga.