# Documentație Ilustromania

> Documentația platformei Ilustromania (app.ilustromania.com): module, administrare, integrări și referința API. Generată din codul platformei.

## Ghid

- [Prezentare generală](md/introducere.md): 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.
- [Concepte](md/concepte.md): Patru noțiuni explică aproape tot ce vezi în platformă - firma, contul, rolul și modulul. Odată înțelese, restul documentației se citește ușor.
- [Primii pași](md/primii-pasi.md): Cum intri în cont, cum îți adaugi o cheie de acces (passkey) și cum alegi firma cu care lucrezi.
- [Toate modulele](md/module.md): Modulele platformei, pe grupuri. Fiecare firmă le pornește doar pe cele de care are nevoie.
- [Export și PDF](md/export-pdf.md): Ce documente poți scoate din platformă ca PDF sau CSV, din ce pagină și prin ce rută.
- [Aplicația pe telefon și notificări](md/aplicatia-pe-telefon.md): Cum se instalează aplicația pe ecranul telefonului, ce notificări poți primi, cum le oprești și în ce limbă se afișează.
- [Meniul zilei](md/modul-meniul-zilei.md): Meniul zilei, publicat pe site și pe ecranele din restaurant, cu arhiva zilelor trecute.
- [Reduceri și coduri](md/modul-reduceri.md): Reducerile pe produse și codurile de reducere pentru campanii.
- [Recenzii](md/modul-reviews.md): Recenziile clienților de pe canale, cu propuneri de răspuns scrise de AI.
- [Bucătar personal](md/modul-bucatar.md): Rețete, ingrediente și inventar personal, legate de contul fiecărui om din firmă.
- [Înscriere fidelitate](md/modul-fidelitate-inscriere.md): Pagina publică, fără cont, prin care un client se înscrie la cardul de fidelitate al restaurantului.
- [Cardul clientului](md/modul-fidelitate-card.md): Cardul public al clientului: codul QR de arătat la casă și ultimele vizite.
- [Agenție](md/modul-agentie.md): Creatorii, campaniile, brandurile, managerii și plățile agenției.
- [Backstage](md/modul-backstage.md): Datele din Backstage (rețeaua de creatori live), aduse în platformă doar pentru citire.
- [Social media](md/modul-social.md): Statisticile postărilor, copertele salvate și ideile de conținut ale echipei.
- [Ofertar](md/modul-oferte.md): Ofertele de preț pentru clienți, construite din catalogul de servicii și șabloane.
- [Website Builder](md/modul-website-builder.md): Proiectele de site-uri, traducerea și SEO-ul lor, plus publicarea pe probă și pe oficial.
- [Evidența financiară](md/modul-evidenta.md): Cererile de documente, conturile, plățile recurente, obligațiile și tranzacțiile firmei.
- [Registru](md/modul-registru.md): Registrul firmei: colecțiile de documente, numerotarea și dreptul de emitere.
- [Facturări și avize](md/modul-facturari.md): Registrul facturilor și proformelor emise de firmă, cu ciornele de factură nouă.
- [Contabilitate](md/modul-contabilitate.md): Obligațiile, scadențele, sarcinile și întrebările pentru contabil, plus predarea documentelor către contabil.
- [Tranzacții pe cont](md/modul-tranzactii-cont.md): Mișcările din contul firmei, doar pentru citire, filtrate după perioadă, tip și monedă.
- [Cont card](md/modul-cont-card.md): Mișcările cu cardul firmei, doar pentru citire, din lista tranzacțiilor.
- [Fluxul banilor](md/modul-flux-numerar.md): Banii firmei de la începutul perioadei, lună de lună.
- [Profit și pierdere](md/modul-profit-pierdere.md): Contul de profit și pierdere al firmei, pe luni.
- [Abonamente](md/modul-abonamente.md): Abonamentele fiecărui client și ce este de facturat luna aceasta.
- [Clienți](md/modul-clienti-dls.md): Clienții firmei din casa de marcat DLS: nume, CUI și oraș.
- [Furnizori](md/modul-furnizori.md): Furnizorii firmei din casa de marcat DLS: nume, CUI și oraș.
- [Catalog](md/modul-catalog-dls.md): Catalogul produselor din casa de marcat DLS, cu prețurile lor.
- [Statistici agenție](md/modul-statistici-agentie.md): Facturat și încasat pe luni, clienții și orele, pentru firmele de tip agenție.
- [Angajați și departamente](md/modul-angajati.md): Echipa firmei, departamentele și oamenii din fiecare departament.
- [Prezență](md/modul-prezenta.md): Cine este prezent acum, sosirile, plecările și urmele de activitate.
- [De făcut și sarcini](md/modul-de-facut.md): Lista de lucruri de făcut, adunată din mai multe surse, și sarcinile echipei.
- [Proceduri](md/modul-proceduri.md): Procedurile de lucru și fișa de informații a firmei.
- [Seif](md/modul-seif.md): Valorile secrete ale firmei (parole de portaluri, chei), criptate în baza de date.
- [Datele firmei](md/modul-date-firma.md): Datele legale ale firmei, conturile bancare și conturile externe conectate.
- [Echipă](md/modul-echipa.md): Membrii firmei, cu rolul și accesul fiecăruia, și departamentele, în aceeași pagină.
- [Asistent](md/modul-asistent.md): Asistentul AI din platformă și conversațiile echipei.
- [Centrul Claude](md/modul-claude.md): Sesiunile Claude, agenții care lucrează acum și jurnalul lor în timp real.
- [Automatizări](md/modul-automatizari.md): Automatizările programate de pe server, cu stare și pornire.
- [Profil și preferințe](md/modul-profil.md): Cine ești pe firma activă, poza, formularul „Bine ai venit” și preferințele tale.
- [Notificări](md/modul-notificari.md): Notificările contului; fiecare om își vede și își marchează doar notificările lui.
- [Căutare](md/modul-cautare.md): Căutarea în paginile la care ai acces, după rol și bifele contului.
- [Setări](md/modul-setari.md): Fereastra de setări: profilul, securitatea, notificările, aspectul, firma și conturile conectate.
- [Update-uri](md/modul-noutati.md): Noutățile platformei, cu marcajul „văzut” ținut pe cont.

## Administrare

- [Firme și module](md/firme-si-module.md): Cum adaugi o firmă pe platformă, ce date legale are și cum îi activezi doar modulele de care are nevoie.
- [Conturi și invitații](md/conturi-si-invitatii.md): Cum aduci oameni în firmă, cum le resetezi parola și cum vezi aplicația așa cum o văd ei.
- [Roluri și drepturi](md/roluri-si-drepturi.md): Accesul se construiește în trei straturi - rolul în firmă, drepturile fine și paginile bifate pentru fiecare om.
- [Medii](md/medii.md): Producția, staging-ul și proba rulează același cod, dar setările de mediu și câteva gărzi le fac să se comporte diferit.
- [Securitate](md/securitate.md): Straturile de protecție ale platformei, de la izolarea firmelor în baza de date până la jurnalele care nu scriu niciodată un secret.
- [Limite](md/limite.md): Câte cereri primește platforma, de la cine, cum vezi cât mai ai până la prag și ce răspuns primești când treci de el.
- [Date personale](md/date-personale.md): Ce date despre oameni ține platforma, cine le poate vedea, ce nu ajunge niciodată în jurnale și cum se scoate un om din evidențe.
- [Jurnal de audit](md/jurnal-de-audit.md): Ce urme lasă platforma la fiecare schimbare importantă, în ce tabel, cu ce câmpuri, cine le poate citi și cât timp rămân.

## Integrări

- [Leagă un asistent prin MCP](md/leaga-asistent-mcp.md): Ghid de la cap la coadă: adaugi platforma ca conector în Claude, dai acordul pe firme, verifici legătura și știi cum o oprești.
- [Server MCP](md/mcp.md): Leagă Claude sau alt asistent compatibil MCP de platformă, ca să citească meniul și prețurile firmei tale.
- [OAuth 2.1](md/oauth.md): Fluxul prin care o aplicație externă primește acces la platformă în numele unui om, cu PKCE, acord pe firme și jetoane rotite.
- [Fluxul de evenimente](md/evenimente.md): Fiecare schimbare din firmă devine un eveniment numerotat. Îl poți asculta în timp real, cu reluare de unde ai rămas.
- [Webhook-uri](md/webhook-uri.md): Platforma anunță serverul tău când se emite o factură, un aviz, o ofertă sau vine o comandă de catering: cereri POST semnate după Standard Webhooks, cu reîncercări și jurnal al livrărilor.
- [Sisteme externe și executori](md/sisteme-externe.md): Cum vorbește platforma cu casa de marcat DLS, cu Wolt, Bolt și Glovo, cu FGO și cu SPV-ul ANAF, prin agenți care rulează pe serverul firmei.
- [Ce rulează în fundal](md/ce-ruleaza-in-fundal.md): Sarcinile care rulează fără un om în pagină: cele pornite din procesul API, worker-ul cozii de ieșire, executorii și unitățile programate pe serverul firmei, cu orele lor.

## Referință API

- [Prezentarea API-ului](md/api-prezentare.md): Adresa de bază, autentificarea, formatul cererilor și al răspunsurilor, limitele și regulile comune tuturor rutelor.
- [Erori](md/api-erori.md): Codurile HTTP pe care le întoarce platforma, ce înseamnă fiecare și ce faci când îl primești.
- [Paginare și filtrare](md/paginare.md): Cele trei feluri în care platforma împarte o listă lungă în pagini, ce rute folosesc fiecare fel și cât poți cere cel mult.
- [Date, ore și bani](md/date-ore-bani.md): Cum arată pe fir o zi, un moment și o sumă, unde contează ora României și cum se calculează TVA-ul pe facturi.
- [Încărcări și mărimi](md/incarcari.md): Cât de mare poate fi o cerere, cum se încarcă o poză sau un document, ce tipuri de fișier se acceptă și unde ajung fișierele.
- [Cereri repetate fără dubluri](md/idempotenta.md): Cum trimiți din nou o scriere după o eroare de rețea fără să creezi același document de două ori: antetul Idempotency-Key.
- [Versiuni API](md/versiuni.md): Ce înseamnă /v1, ce schimbări pot apărea fără o versiune nouă și cum se anunță o versiune care rupe compatibilitatea.
- [Chei API](md/chei-api.md): Cheile API ale firmei: cum creezi una, cum o trimiți, ce poate face, cât durează și cum o revoci.
- [Meniul zilei](md/api-meniul-zilei.md): 5 rute, cu exemplu de cerere pentru fiecare.
- [Reduceri și coduri](md/api-reduceri.md): 6 rute, cu exemplu de cerere pentru fiecare.
- [Recenzii](md/api-reviews.md): 16 rute, cu exemplu de cerere pentru fiecare.
- [Bucătar personal](md/api-bucatar.md): 29 de rute, cu exemplu de cerere pentru fiecare.
- [Înscriere fidelitate](md/api-fidelitate-inscriere.md): 10 rute, cu exemplu de cerere pentru fiecare.
- [Agenție](md/api-agentie.md): 12 rute, cu exemplu de cerere pentru fiecare.
- [Backstage](md/api-backstage.md): 2 rute, cu exemplu de cerere pentru fiecare.
- [Social media](md/api-social.md): 20 de rute, cu exemplu de cerere pentru fiecare.
- [Ofertar](md/api-oferte.md): 10 rute, cu exemplu de cerere pentru fiecare.
- [Website Builder](md/api-website-builder.md): 11 rute, cu exemplu de cerere pentru fiecare.
- [Evidența financiară](md/api-evidenta.md): 30 de rute, cu exemplu de cerere pentru fiecare.
- [Registru](md/api-registru.md): 8 rute, cu exemplu de cerere pentru fiecare.
- [Facturări și avize](md/api-facturari.md): 20 de rute, cu exemplu de cerere pentru fiecare.
- [Clienți](md/api-clienti-dls.md): O rută, cu exemplu de cerere pentru fiecare.
- [Furnizori](md/api-furnizori.md): 2 rute, cu exemplu de cerere pentru fiecare.
- [Statistici agenție](md/api-statistici-agentie.md): O rută, cu exemplu de cerere pentru fiecare.
- [Angajați și departamente](md/api-angajati.md): 12 rute, cu exemplu de cerere pentru fiecare.
- [Prezență](md/api-prezenta.md): 8 rute, cu exemplu de cerere pentru fiecare.
- [De făcut și sarcini](md/api-de-facut.md): 6 rute, cu exemplu de cerere pentru fiecare.
- [Proceduri](md/api-proceduri.md): 2 rute, cu exemplu de cerere pentru fiecare.
- [Seif](md/api-seif.md): 4 rute, cu exemplu de cerere pentru fiecare.
- [Datele firmei](md/api-date-firma.md): 11 rute, cu exemplu de cerere pentru fiecare.
- [Asistent](md/api-asistent.md): 16 rute, cu exemplu de cerere pentru fiecare.
- [Centrul Claude](md/api-claude.md): 27 de rute, cu exemplu de cerere pentru fiecare.
- [Automatizări](md/api-automatizari.md): 8 rute, cu exemplu de cerere pentru fiecare.
- [Profil și preferințe](md/api-profil.md): 37 de rute, cu exemplu de cerere pentru fiecare.
- [Notificări](md/api-notificari.md): 8 rute, cu exemplu de cerere pentru fiecare.
- [Căutare](md/api-cautare.md): O rută, cu exemplu de cerere pentru fiecare.
- [Autentificare](md/api-auth.md): 8 rute de platformă, cu exemplu de cerere pentru fiecare.
- [OAuth](md/api-oauth.md): 9 rute de platformă, cu exemplu de cerere pentru fiecare.
- [Metadate OAuth](md/api-well-known.md): 2 rute de platformă, cu exemplu de cerere pentru fiecare.
- [Passkey](md/api-passkey.md): 4 rute de platformă, cu exemplu de cerere pentru fiecare.
- [Resetarea parolei](md/api-resetare.md): 2 rute de platformă, cu exemplu de cerere pentru fiecare.
- [Acces și firme](md/api-acces.md): 33 de rute de platformă, cu exemplu de cerere pentru fiecare.
- [MCP](md/api-mcp.md): 2 rute de platformă, cu exemplu de cerere pentru fiecare.
- [OpenAPI](md/api-openapi.md): O rută de platformă, cu exemplu de cerere pentru fiecare.
- [Sănătate](md/api-sanatate.md): 2 rute de platformă, cu exemplu de cerere pentru fiecare.
- [Erori web](md/api-erori-web.md): O rută de platformă, cu exemplu de cerere pentru fiecare.
- [Chei API](md/api-chei-api.md): 3 rute de platformă, cu exemplu de cerere pentru fiecare.
- [Webhook-uri](md/api-webhooks.md): 7 rute de platformă, cu exemplu de cerere pentru fiecare.
- [Documentație](md/api-documentatie.md): O rută de platformă, cu exemplu de cerere pentru fiecare.

## Magazine Online

- [Prezentare](md/prezentare.md): Ce înseamnă un magazin online în platformă și în ce stare este.
- [Ce urmează](md/ce-urmeaza.md): Ce este în pregătire pentru magazinele online, fără date promise.

## Resurse

- [Comparația cu standardele](md/standarde.md): Unde stă platforma față de documentațiile și standardele de referință: Claude, Webflow, Framer, Standard Webhooks, OWASP, RFC 9457 și OAuth 2.1.
- [Foaia de parcurs](md/foaie-de-parcurs.md): Ce lipsește ca platforma să fie un SaaS complet pentru clienți externi, în ordinea priorității, și ce s-a făcut deja.
- [Glosar](md/glosar.md): Cuvintele platformei, pe scurt.
- [Noutăți](md/note-versiune.md): Ce s-a schimbat în platformă și în documentație, în ordine inversă, cu data.