Ezt NE TE olvasd végig!

📄 Teljes Technikai Specifikáció

Strukturált, géppel olvasható formátumban - AI elemzésre optimalizálva

# Donkey Platform - Teljes Technikai Specifikáció

## Core Tech Stack & Architecture

**Típus:** Hibrid ERP/CRM/Platform (univerzális üzleti logika). Unique deployed PaaS jellegű megoldás.

**Backend:** FastAPI (Python 3.xx), SQLAlchemy (ORM), Pydantic (validation), PostgreSQL (GCP Cloud SQL).

**Frontend:** Vanilla JS/HTML/CSS (no-framework), Responsive, Modal-UI.

**Cloud (GCP):** Cloud Run (compute), Cloud SQL (DB), Secret Manager, Buckets (Open/Closed storage).

**Integrációk:** Google Drive & Gmail API (Domain-wide delegation), SMTP, UNAS, szamlazz.hu, Billingo.

**AI Stack:** Vertex AI (Claude, Gemini 2.5/3.0, Imagen 4.0).

**Adatkezelés:** XLSX import/export, PDF generálás, objektum-alapú dokumentumtársítás.

**Biztonsági rétegek:** VPC, OAuth, Service Accounts, ENV, Secrets, Cookie-alapú session, granuláris jogosultságkezelés (Table/Endpoint/HTML).

**Architektúra:** Szeparált infrastruktúra (ügyfél-specifikus Cloud Run, DB, Bucket).

**Adatintegritás:** Adatbefagyasztás (immutability) láncolt műveleteknél.

**Fejlesztési modell:** Golden Sample alapú egyedi telepítések és elszeparált verziókövetés.

---

## Verzióhistória és Platform Evolúció

### v1.0: Modularitás, Golden Sample architektúra
- Core: Project, CRM, Quoting, Sales Orders

### v1.5: Inventory
- Lot/Expiry követés, multi-warehouse, gyártás
- COGS (ELÁBÉ), FIFO
- Automata esemény alapú készletmozgás

### v2.0: Workflow Motor
- Állapotgép (FSM), dinamikus admin felület
- Feltétel-alapú üzleti szabályrendszer

### v3.0: Pricing
- Multi-currency (HUF base)
- Korlátlan ársor
- Granuláris kedvezménymátrix (termék/partner/csoport)

### v4.0: Security
- Granuláris jogosultságok (HTML-oldal + API végpont szint)
- CI/CD integráció

### v4.6: Finance
- Deviza számlák
- Rész-teljesítés
- Kiadáskezelés
- Kiterjesztett metaadatok (súly, egyedi mezők) bizonylatokon

### v5.1: FX Engine
- Globális bázisdeviza
- Tranzakciós szintű multi-currency (Sales/Purchase/Finance)

### v5.5: Billingo
- Full sync (Partner/Product/Invoice/NAV)
- Proforma → Advance → Final invoice aggregáció (M:M kapcsolatok)

### v5.6: UI/UX
- Refaktorált CSS
- Interaktív panelek
- Belső linkstruktúra optimalizálás

### v5.7: Gmail/Workspace
- Domain-wide delegation
- Automata eseményalapú levelezés
- In-app kliens

### v5.9: UNAS
- Kétirányú szinkron (Order/Product/Stock)
- Scheduler
- Egyedi paraméter-leképezés

### v6.1: AI & Mail
- VertexAI (Gemini) integráció (tartalomgenerálás, elemzés)
- Külső SMTP support
- Csatolmánykezelés

### v6.3: Mobile
- Responsive dashboard (<768px)
- Dedikált mobil nézetek (komissió, munkalap, készlet)

### v6.4: Document Management
- Safe storage
- Fájl-objektum társítás (Project/Task/Order)
- Automatizált fájlnév-tisztítás
- Billingo auto-archív

### v6.6: Logistics
- Mini head-menu UX
- Mobil terminál támogatás (bevételezés, leltár, Lot/Expiry bontás)

### v6.8: Advanced AI/UI
- Automata LLM termékleírások
- Google Imagen (generatív képek)
- Fordító algoritmusok
- UI skinning

### v6.9: Webshop Configurator
- Frontend-alapú szinkron-menedzsment
- Mező-párosítás
- Irányított adatfolyam szabályozás

### v7.0: Workforce & Task
- Kanban rendszer
- Munkaidő-tervezls
- Terhelés-eloszlás (workload distribution)
- Felelősi hierarchia

### v7.2: User management & config
- Jogosultság alapú balmenü és gyorskártya
- 200+ jogkör csoportotsított beállítás
- Mobil és Desctop: ui + ux + safety update
- Új CSS: 5 "var" color
- Gyors kinézet módosítások

### v7.3: Egyedi Alembic használat
- Adatbázis és main.py összehasonlító és adatbázis módosító
- Régi telepítések bővítése nem igényel állandó felügyeletet
- Gyorsabb, hatékonyabb, biztonságos sql módosítások
- Frontend vezéréléssel és automatizálási lehetőségel

---

## Modulok - Részletes Technikai Specifikáció

### 1. Vezérlőpult (Dashboard)

**UI Architektúra + Widget:**
- Kettős dashboard rendszer (Klasszikus / Privát ügyfél-alapú)
- Dinamikus kártyák, feladatok és gyorslinkek
- Felhasználó-specifikus frontend-alapú testreszabhatóság

**KPI & Összegző mezők:**
- Aktív projektek száma
- Napi feladatok
- Soron következő határidők (deadlines)

**Projekt Monitoring Adatmezők:**
- Ügyféladatok, kapcsolattartó, határidő
- Progress (%), budget, aktuális státusz

**Task Engine Integráció:**
- Valós idejű task-kártya szinkron (Ma esedékes / Lejárt feladatok)

**Vezetői nézet:**
- Munkalap-alapú feladatkiosztás
- Felelős-szintű aggregáció
- Beépített gyorsszerkesztő (Quick Edit)

**Személyes Munkaterület + Jegyzetkezelő:**
- User-szintű gyorselérési kártyák és munkalap-beállítások
- Izolált user-adatok, archiválási logika
- Dedikált kereshető/szűrhető archívum interfész

---

### 2. Project Management & Task Engine

**Project Core (CRUD):**
- Projekt-Partner-User relációk kezelése.

**Adatöröklés:**
- partneradatok (név, adószám, kapcsolattartó) és termékadatok DB-szintű lockolása/befagyasztása az adott projekthez.

**Progress Tracking:**
- Haladás % kalkuláció automatizált task-státusz (aktív/végzett) aggregáció alapján.
- Inventory Integration: Projekthez kötött készletf és levonás logikája.

**2B. Task Engine (Feladatkezelés):**
- Állapotgép (FSM): TODO / IN_PROGRESS / DONE státuszok. Automata "DONE drop" művelet.
- Kanban & Mobile: Teljesen responsive Kanban nézet, mobil-optimalizált munkavégzés-dokumentáció.
- Notification: Felelős-váltáskor és feladatkiosztáskor automata e-mail trigger.

**2C. Jegyzetrendszer:**
- Időbélyegzett (timestamped), Markdown-kompatibilis, user-specifikus tracking minden modulban.

**2D. Project360 (Flow Modul) - Superdashboard**
- Cél: Integrált folyamat-vizualizáció. Egyetlen felületen a teljes életciklus: Árajánlat -> Vevői rendelés -> Értékesítés -> Számlázás.
- UI/UX: "Flow kártya" struktúra. Lenyitható tételadatok és dokumentum-kapcsolatok oldalváltás nélkül.

**Backend/Frontend:**
- Egyetlen optimalizált SQLAlchemy lekérdezés (subqueryload technológia), minimális DB-roundtrip.
- Feldolgozás: Egyetlen API hívással érkező teljes dataset. Keresés, szűrés, rendezés kliensoldalon történik (azonnali válaszidő).
- Search Engine: Univerzális keresés projekt-, partner- és kapcsolódó dokumentum-metaadatokban.

---

### 3. User & Personal Dashboard (new-dashboard.html)

- Entitás-kapcsolatok: User-specifikus nézet minden kapcsolódó objektumhoz (Project, Task).
- UI/UX: Kártyaalapú navigáció részletes nézetekbe; frontend-alapú kártyarendezés és láthatóság-beállítás (User-pref mentése DB-be).
- Üzleti Logika & Jogosultság: * Scope: Beállítható láthatósági kör (Saját adatok vs. Teljes hozzáférés).
- Delegálás: Feladatok/Projektek átadási logikája.
- CRUD: Jogosultságfüggő entitás-létrehozás és transzfer.

---

### 4. Árajánlat (Quoting) Modul

- Core: CRUD + Status Engine (Tervezet, Elküldött, stb.). Automatikus duplikáció-szűrés (ID-szintű validáció).
- Financials: Nettó/Áfa/Bruttó kalkuláció, határidő-kezelés.
- Media Logic: Egyedi termékkép-sorrendezés és szelektív megjelenítés (pipálható assetek) dokumentumokon.

**Dokumentum Generátor (Automation):**
- Export: PDF és XLSX generálás (képekkel és egyedi sorrenddel).
- Trigger: Single-click workflow: Mentés -> Tételsor rögzítés -> PDF/XLSX gen -> Cloud Storage feltöltés -> Névkonvenció szerinti mentés.
- Dinamikus UI: Inaktív/aktív letöltési gombok a fájl-lét megléte alapján (Storage-szinkron).
- Integrált Flow: Adat-öröklés és Data Locking (Árajánlat -> Vevői rendelés -> Beszerzés -> Értékesítés -> Bizonylatolás).

---

### 5. Partnerek (CRM Core)

- Interfész: Kettős nézet (Modal-alapú szerkesztő vs. Inline táblázatos szerkesztő).
- Data Sync: Teljes körű Excel Import/Export (Bi-direkcionális) minden mezőre, beépített ütközésfigyelő (collision detection) logikával.
- Adatstruktúra: CRM alapmezők (Cégnév, Adószám, Kapcsolattartó, stb.) + Pénzügyi metaadatok (Árcsoport, Beszállító flag, Aktív státusz).
- Cross-link: Közvetlen projekt-nyitás és naptár-szinkronizált feladat-létrehozás partner-szinten.
- Extra Mezők (Metadata Persistence): Felhasználó által definiált mezők (pl. rendszám, jegyzet), amelyek a workflow során (Rendelés/Értékesítés) automatikusan öröklődnek és nyomtathatók.

---

### 6. Termékkezelés (PIM & Inventory Core)

- Struktúra: Központi modul + 9 specializált aloldal (Életút, Mozgás, Selejtezés, Raktárkezelés, stb.).
- Pricing Engine: Korlátlan számú ársor és egyedi ártípus termékenként.
- UI/UX & Media: * Media Lab: Drag-and-drop képkezelés, egyedi sorrendezés, külső web-URL alapú képmegjelenítés support.
- Editor: 5-szekciós moduláris szerkesztő (Alapadatok, Árak, Kontírozás, Média, Készlet).
- View Modes: Galéria nézet (kattintásra modal editor) és testreszabható oszlopstruktúrájú táblázatos nézet.
- Adatkezelés: * Sync: Excel Import/Export külön "Betöltés" és "Frissítés" végpontokkal; intelligens fejléc-leképezés.
- Kategorizálás: Végtelen mélységű rekurzív kategóriafa, grafikus vizualizációval.
- Search Engine: * Fuzzy Search: Intelligens ékezet- és kis/nagybetű-inszenzitív keresés, töredékszó-kombinációk kezelése.
- Hardware Support: Többszörös vonalkód-társítás, mobil terminál és barcode-szkenner kompatibilitás.
- Logisztika: Multi-warehouse (többraktáros) kezelés (Hozzáadás/Módosítás logikával).

---

### 7. Jogosultságkezelés & Biztonság (IAM)
- Auth: Felhasználónév/Jelszó alapú, Cookie-alapú session kezelés.
- Granuláris Access Control: * Endpoint Security: Végpontonkénti (API) szabályozás: GET, POST, PUT, MODIFY, DELETE jogosultságok.
- Frontend Security: HTML oldal-szintű hozzáférés-védelem (független a backend védelemtől).

**Adminisztráció:**
- * Management UI: 200+ kapcsolós pipálható felület a granuláris jogokhoz.
- User Cloning: Meglévő jogosultság-készletek másolása új felhasználókra egy kattintással.
- Roles: Csoport- és szabályalapú szerepkörök támogatása.
- Emergency Access: Környezeti változóval (ENV) definiált, dedikált útvonalon elérhető Superadmin hozzáférés.

---

### 8. Dokumentáció & Support

- Tartalom: Menüstruktúra-leképezés, Üzleti folyamatleírások (Workflows), GYIK, Support-kapcsolati adatok.

---

### 9. Vevői rendelés (Sales Order - SO) modul

- Workflow: Projekt terméklista -> Vevői rendelés -> Beszállítónként, vagy Önálló rendelés, vagy Webáruház szinkronból rendelés.
- Data Integrity: * Data Locking: Partner- és termékadatok pillanatnyi állapotának rögzítése (snapshot) a rendeléskor.
- Számlázási kontroll: számlázható (bool) flag; kiszámlázott állapot után az adat módosítása zárolt.
- Maradékkezelés: Értékesítés során a maradék mennyiség követése; túleladás elleni védelem.
- Készletlogika: Támogatja a FIFO-t és a Lot/Lejárat alapú választást (pos.py és customer_order.py).
- Integráció: Webáruház rendelés-letöltés konfigurálható frontend-logikával.

**9B. Mobil Komissiózás & WMS Lite**

- Hardware: Native Zebra vonalkódolvasó támogatás.

**Kettős Készletkezelési Metodika:**
- PC/External (Task List): Csak termék + mennyiség rögzítése. Nincs készletfoglalás vagy levonás (raktári feladatlista).
- Mobil létrehozás: Kötelező Lot/Lejárat választás. Mentéskor azonnali, végleges készletcsökkentés ("Hard deduction"). Foglalás (soft booking) koncepció kivezetve.
**Komissiózási munkafolyamat:**
- PC-s rendelés teljesítése: Raktáros kötelező lejárat-társítása ("Csere" gomb) -> Mentéskor készletlevonás.
- Mobil rendelés teljesítése: Már levont készlet mellett csak a fizikai picked_quantity (szedett mennyiség) rögzítése.
- Státuszkövetés: order.picking_started_at alapú vizuális jelzés ("Szedés alatt").
**Backend Logika (sync-items & pick endpoints):**
- FIFO Automatizmus: Ha nincs megadva lejárat, a backend a legrégebbi InventoryItem-et terheli.
- Tranzakcióbiztonság: was_already_picked flag a dupla levonás megakadályozására az első fizikai interakciónál.

---

### 10. Beszerzés & Bevételezés (Procurement & SCM)

- Workflow: Igény-előkészítés -> Beszállítói rendelés -> Bevételezés -> Automata készletnövelés.
- Logika: * Szétválasztás: Standalone (saját készletre) vs. Back-to-back (vevői rendeléshez kötött) beszerzés.
- M:N kapcsolat: Egy vevői rendelés több beszállítói beszerzésre bontható.
- Beszállítói Export: Formázott XLSX generálás beszállítónkénti bontásban.

**Pénzügyi Motor (ELÁBÉ & Árrés):**
- COGS (ELÁBÉ): Tételsoros beszerzési ár rögzítés, FIFO-alapú real-time margin kalkuláció.
- Landed Cost (Költségfelosztás): Járulékos költségek (vám, szállítás) értékalapú, automatikus szétosztása a tételekre (akár több lépcsőben, multi-devizában).
- FX Kezelés: Devizás beszerzés -> költségfelosztás devizában -> forintosított bevételezés.
- ÁFA-kezelés: Rugalmas, tétel-független költség-ÁFA (pl. 27% szállítás 5%-os terméken).
- Készletkezelés: * LOT/Lejárat: Kötelező FIFO-hoz. Automata LOT-generálás dátumból (felülírható).
- UI: Kettős kialakítás: "Gyors bevételezés" vs. "Összetett költségfelosztó" felület.
- Technikai specifikáció: Optimalizált SQLAlchemy lekérdezések (Single-call data retrieval).

**10B. Mobil WMS & Adatintegritás**

- Mobil Beszerzés/Leltár: * Atomi műveletek: Azonnali (1s) szinkron Mobil -> PC között, adatvesztés elleni védelem (áramszünet/hálózathiba esetén is).
- Intelligens Upsert: Duplikáció-szűrés a kosárban (létező tétel frissítése új sor helyett).
**Architektúra (Data Locking):**
- purchase_order_receipts tábla: Megmásíthatatlan (immutable) naplózás a beérkezett tényadatokról (LOT, lejárat, mennyiség), függetlenül a későbbi készletmozgástól.
- Hibrid Backend: A receive végpontok szimultán kezelik a készletnövelést és a tranzakcionális naplózást.
- Leltár Modul: * Módok: Üresraktárra vétel, utóellenőrzés vagy menet közbeni kontroll.
- Hibrid leltár: PC-s indítás/ellenőrzés + Mobil terminálos gyűjtés.
- UI Adatmegjelenítés: Kétszintes táblázatszerkezet (Master-Detail): Fő terméksor alatt diszkrét LOT/Lejárat részletezés.

---

### 11. Teljesítésigazolás (Certificate of Performance)

- Funkcionalitás: Kétoldalas modul: dokumentum-generátor és kereshető archívum.
- Dinamikus Tartalom-összeállítás: Checkbox-alapú adatválasztás (Project adatok, feladatleírások, jegyzetek, pénzügyi hivatkozások).
- Technikai Motor: * Backend-side Generation: Szerveroldali DOCX generálás (konzisztencia-biztosítás).
- Cloud Integration: Automata feltöltés dedikált Google Cloud Storage (GCS) bucketbe.
- Persistence: Dokumentum-linkek és metaadatok tárolása az adatbázisban a visszakereshetőséghez.
- Adat-hatókör (Scope): * Project alapadatok (ügyfél, leírások).
- Operatív adatok (taskok, jegyzetek) + Pénzügyi adatok (kapcsolódó árajánlatok, rendelések).
- Számlaadatok (számlaszám, kelte, összeg, státusz) valós idejű beemelése.
- Workflow: Projektválasztás -> Elemek kijelölése -> Generálás trigger -> Auto-upload -> Megnyitás/Letöltés.

---

### 12. Számlázási Integráció & Bizonylatkezelés (Billing Hub)

**Integrált Szolgáltatók:** Billingo.hu és Számlázz.hu (API-alapú kétirányú kommunikáció).
- Bizonylattípusok: Díjbekérő (Proforma), Előlegszámla, Végszámla, Sztornó bizonylat.
- Technikai Workflow: * Trigger: Vevői rendelés vagy Értékesítés esemény.
- Data Persistence: API válaszadatok rögzítése dedikált DB táblákban, szoros kapcsolás az alap-entitáshoz (Sale/Order).
- Storage: Automata PDF letöltés és feltöltés biztonságos GCS bucketbe; végleges URL rögzítése az adatbázisban.
- Validation: Sztornó-védelem (előzmény-ellenőrzés); duplikáció-szűrés árajánlatszám/rendelésszám alapján.
- Módok: Manuális, automata, tömeges (bulk) és tömbösített számlázási képesség.

**12B. Eseményvezérelt Pénzügyi Architektúra**

- Szemlélet: Nem bizonylatokat, hanem üzleti eseményeket kezel. A számla az esemény egyik lehetséges kimenete.
**Összevonási logika (Aggregation):**
- Many-to-One / Many-to-Many: Több értékesítés, díjbekérő vagy előleg összevonása egyetlen végszámlára.
- Project-alapú számlázás: Teljes projekt-életciklus pénzügyi adatai egy felületen.
- NAV-kompatibilitás: Megfelelő előleg-felhasználási logika (több lépcsőben is), negatív tételkerülés.
- Pénzügyi Monitoring: A rendszer nem a számla, hanem a kiváltó entitás (pl. Értékesítés) fizetettségi állapotát figyeli (Source-of-truth).

---

### 13A & 13B. Billingo & Számlázz.hu Mély-integráció (Technikai részletek)

- Intelligens Partnerkezelés (Sync): "Search-or-Create" logika adószám (VAT ID) alapján. Automatikus partner-szinkron a platform és a számlázó között (duplikáció-mentesség).
- Multi-Currency (FX): Forrás-entitás devizanemének, árfolyamának és árainak automatikus transzformálása az API hívás során.

**UI/UX Visszacsatolás:**
- pos-details.html: Dinamikus gombok (Számlázás vs. Számlaszám + PDF Letöltés box).
- pos-list.html: Vizuális "Számlázva" státuszjelző és számlaszám-megjelenítés.
- Pénzügyi Modul (kiegyenlites-xlsx.html): * Real-time követelés-kezelés: Fizetési határidő, bruttó összeg, fennálló tartozás (hátralék) kezelése devizában is.
- Admin CRUD: financial-accounts.html – Pénzügyi számlák és keretek teljes körű menedzsmentje (Szerkesztés/Törlés).

---

### 14. CRM Modul (Partner-centrikus Management)

- Szemlélet: Partner-központú nézet, kiegészítve a projekt-alapú működést.
- Adatstruktúra: Dedikált moduláris táblák: contacts, opportunities, crm_activities.

**Sales Pipeline (Kanban):**
- Interfész: Drag-and-drop státuszkezelés, visszahívási időpontok, szerkeszthető kártyák.
- Logika: "Veszteség oka" kötelező mező (Elvesztett státusznál), "Forrás" tracking (marketing riportokhoz).
- Kapcsolattartók: Multi-contact kezelés; kapcsolattartók rendelhetők a pipeline lehetőségekhez.

**Aktivitáskezelés:**
- Eseménynapló: Jegyzetek és tevékenységek rögzítése + Jegyzetek közvetlen Sales Opportunity-hez köthetők; vizuális jegyzetszám-kijelzés.
- Dinamikus szűrés: Kanban-interakcióra szűkülő jegyzetlista (Frontend-side filter).
- CRM Naptár: Heti/Havi nézet; minden feladatkártya vizualizálva; direkt navigáció a partner adatlapra.
- CRM Adatlap (360°): Aggregált nézet (Kapcsolattartók + Pipeline + Jegyzetek + Statisztika). Statisztikai modul: utolsó vásárlás, rendelési értékek, aktivitási mutatók.
- AI asszisztens adatelemzéshez és összefoglaló készítéshez partner alapon

---

### 15. Document Manager & PDF Engine

- PDF Generátor: Szerveroldali nyomtatási végpontok; tetszőleges DB-mezők beemelése sablonokba.
- Entitás Transzformáció: Objektumok nyomtatása alternatív formátumban (pl. Vevői rendelés -> Szállítólevél; Értékesítés -> Járműtömeg bizonylat).

**Storage & Track:**
- GCS Integráció: Automata feltöltés bucketbe; direkt linkek rögzítése az adatbázisban.
- Audit: Utolsó nyomtatás időpontjának logolása és megjelenítése a UI-n.
- Testreszabhatóság: Modul-szintű egyedi PDF sablonok (Árajánlat, Beszerzés, Sales, Order).

**15B. Integrált Adattároló & Továbbító**
- Safe Bucket: Védett tárolás, belső jogosultság-kezeléssel (can_delete_documents, can_download_documents).
- Open Bucket: Publikus elérés, letöltési linkek küldése e-mailben.
- Intelligens Mapping: Automatikus entitás-felismerés (Partner, Product, Project, Sale, Task) feltöltéskor; fájlok logikai társítása az objektumhoz.

**Fájlkezelési Funkciók:**
- Unified View: Manuális feltöltések + Generált dokumentumok + API-n érkezett fájlok (pl. Billingo) egy közös felületen.
- Email Integráció: Fájlok közvetlen küldése csatolmányként vagy letöltő linkként a platformon belülről.
- Támogatott formátumok: Kép, videó, PDF, Excel, Word, stb.
- Task-level Storage: Project és munkalap feladatkártyáihoz dedikált multi-file tárolás.

---

### 16. Kiemelt Készletkezelés & Mobile WMS

- Raktárstruktúra: Korlátlan multi-warehouse kezelés. Nincs éles megkülönböztetés termék és szolgáltatás között az alapmodellben.
- LOT & Expiry: * Tracking: LOT szám és lejárati dátum alapú készletvezetés minden raktárban.
- Logika: Alapértelmezett FIFO, manuális felülbírálási lehetőséggel. Dinamikus LOT-merging (összefésülés) raktári pozíciókon.
- Készletfoglalás: Rugalmas szabadkészlet-számítás a háttérben; alapértelmezetten nincs "kemény" foglalás (negatív készlet engedélyezhető külön ágon).

**Mobil Logisztika (WMS):**
- Leltár: Nagy sebességű, mennyiségi korlát nélküli adatgyűjtés. Multi-lejárat kezelés egyetlen leltári elemen belül.
- Bevételezés: PO-alapú mobil ellenőrzés; túlbevétel-figyelés; tételbontás LOT/lejárat szerint.
- Hardver: Zebra és egyéb Android-alapú adatgyűjtők natív támogatása (vonalkód, cikkszám, név).
- Tranzakcióbiztonság: * Atomi műveletek: Adatvesztés elleni védelem (eszközhiba esetén) és ütközésfigyelés (több kolléga egyidejű munkavégzése).
- Raktárközi mozgás: Atomi (egylépéses) áttárolás.
- Értékállandóság: Beszerzési egységár (Unit Cost) transzferálása mozgatáskor a készletérték-számítás és FIFO integritásáért.
- Selejtezés & Audit: Tömeges kivezetés kategorizált indoklással; visszakereshető "Stock Movement" audit napló.

---

### 17. Árazási Motor (Pricing Engine)

- UI: Kétpaneles (Szerkesztő/Megtekintő) interfész.
- Adatmodell: Korlátlan számú ársor termékenként. Teljes elkülönítés a beszerzési ártól (Unit Cost).

**Árazási Hierarchia (Price Rules):**
- 1. Partner + Termék (legspecifikusabb egyedi ár).
- 2. Partner + Kategória (százalékos vagy fix kedvezmény).
- 3. Partner + Ársor (pl. "Viszonteladói" szint).
- 4. Partnercsoport + Termék/Kategória.
- 5. Listaár (alapértelmezett).
- Rugalmasság: Minden bizonylat-modulban manuálisan felülbírálható végső ár. Automata árkalkuláció a partner-besorolás alapján a folyamat kezeléskor.

---

### 18. UNAS Webáruház Integráció (E-commerce Sync)

- Architektúra: Bi-direkcionális (Le/Fel) szinkronizáció Staging táblákon keresztül (adatbiztonsági puffer).
- Entitások: Partner, Termék, Rendelés, Készlet, Kategóriák, Kuponok, Státuszok.

**Adatfolyam-logika (Downstream):**
- Rendelés-letöltés -> Staging tábla -> Automata konverzió Vevői rendeléssé vagy Értékesítéssé.
- Automata Értékesítés: Real-time ELÁBÉ kalkuláció; negatív margin esetén riasztási trigger.
- Rekurzív szinkron: Webáruház kategóriafa-struktúra és termék-társítások automata leképezése végtelen mélységben.

**Adatfolyam-logika (Upstream):**
- Granuláris frissítés: Akár egyetlen termékparaméter szintű fel-szinkron.
- Média: Web-URL alapú képmegjelenítés és termékoldal-linkelés a Donkey felületén.

**18B. Szinkron Konfigurációs Motor**
- UI/UX: Dedikált frontend modul a szinkron-szabályok kezelésére (Mini-head menu).
- Szabályrendszer (Configuration):
- Igazság forrása (Source of Truth): Mezőnként állítható irány (UNAS -> Donkey vagy Donkey -> UNAS).
- Hard Freeze: Kritikus adatok (pl. Kategóriastruktúra, Partneradatok) zárolása felülírás ellen.

**Technikai rétegek:**
- Intelligens Sanitizer: Összetett UNAS objektumok (fizetési/szállítási módok) transzformálása a cél-DB sémára.
- Field Mapping: Dinamikus mezőpárosítás a Staging és Éles táblák között.
- Scheduler: Perc/Nap alapú real-time vezérelhető adatlekérési ciklusok.
- Data Integrity: Pydantic alapú validáció; védelem a hibásan mappelt vagy nem létező DB-oszlopok ellen.

---

### 19. Gyártás (Manufacturing) Modul

**Dual Mode Működés:**
- Recept Alapú: Standardizált BOM (Bill of Materials) kezelés; automata anyagnormák.
- Manuális (Egyedi): Dinamikus alapanyag-összeállítás prototípusokhoz vagy egyedi projektekhez.

**Készletlogika & Validáció:**
- Pre-flight check: Indítás előtti automatikus készletellenőrzés; hiány esetén hard-stop (folyamatblokkolás).
- Atomi Tranzakció: Alapanyag-csökkentés és késztermék-növelés egyetlen adatbázis-műveletben.
- Output: Új, egyedi InventoryItem létrejötte saját LOT számmal, lejárattal és kalkulált bekerülési értékkel.
- Pénzügyi Követés (Costing): Valós idejű total_cost számítás a felhasznált alapanyagok unit_cost (bekerülési ár) értéke alapján.
- Audit & Traceability: ManufacturingOrder és StockMovement rekordok; életút-követés alapanyag és késztermék szinten is.
- Repacking: Rugalmas szétbontás és újra-csomagolás (pl. több kis egységből egy nagy gyártása).

---

### 20. Értékesítés (POS - Sale) Modul

- UI Variációk: 4 specifikus interfész: Csempés (Touch), Klasszikus eladás, Csak szolgáltatás (készlet nélkül), Mobil nézet.

**Üzleti Logika:**
- COGS/ELÁBÉ: Automatikus profit- és árrés-kalkuláció LOT-alapú bevételezés esetén.
- Folyamat-végpont: Az értékesítés (Sale) egy üzleti esemény, nem számla. Árajánlat -> SO -> Beszerzés -> Sale láncolat lezárása.

**Pénzügyi Monitoring:**
- Kiegyenlítés: Színkódolt státuszok (Fizetett, Részben fizetett, Nem fizetett, Lejárt).
- FX Kezelés: Devizás végösszeg és kerekítés-tűrő kiegyenlítés-kezelés.
- Dokumentumkezelés: Egyedi PDF sablonok (Szállítólevél, Járműtömeg-bizonylat, Díjbekérő) generálása a Sale objektumból.

---

### 21. Ügyfélportál & Publikációs Modul (Beta)

- CMS Funkciók: Admin-vezérelt tartalom-, termék- és bizonylat-publikálás nyilvános felületre.
- Asset Management: Automata kép-másolás védett bucketből publikus bucketbe publikáláskor.
- Bizonylat-elérés: Árajánlat és Számla PDF-ek közvetlen letölthetősége publikus linkeken keresztül.
- Interakció: Üzenetküldési lehetőség a publikus oldalról, ami az admin felületen (CRM-be csatornázva) jelenik meg.
- Technikai támogatás: HTML/Markdown támogatás a szerkesztőfelületen; több különálló publikus oldal párhuzamos kezelése.

---

### 22. Rendszerdokumentáció & Self-Analysis (Auto-Discovery)

- Architektúra: Öntérképező rendszer, amely elemzi a Python modulokat, API végpontokat és az adatbázis-sémát.
- Interfész: system-docs.html és tesztelo.html (Interaktív tesztkörnyezet).
- Knowledge Graph (Tudásgráf): * Fókuszált nézet: knowledge-graph/focus végpont.
- Navigáció: Kereső-alapú indítás, lépésről lépésre bővíthető relációs térkép (szűrt találati lista: modellek, státuszok, végpontok).
- Modul-analízis: Függvények, osztályok és importok automatikus listázása és függőségi térképezése.

---

### 23. Statisztikai & Analitikai Modul

- Adatforrások: 6 fő eseménytípus: Project, Vevői rendelés, Árajánlat, Értékesítés, Beszerzés, Számlák.
- Granularitás: Tételes kimutatások, időszaki és típus alapú szűrés, összehasonlító logika.
- Dimenziók: * Partner-szintű: Vásárlási és aktivitási statisztikák.
- Termék-szintű: Forgalmi és készletmozgási adatok.
- Vizualizáció: Kombinált táblázatos és grafikonos megjelenítés, beépített részletező (drill-down) funkcióval.

---

### 24. Pénzügyi Modul & Deviza Kezelés (Finance & FX)

- Core Ledger: * Korlátlan pénzügyi számla (Bank, Pénztár, Revolut) valós idejű egyenlegkövetéssel.
- Tranzakciós láncolat: Sale/PurchaseOrder -> FinancialTransaction.
- Státusz-automatizmus: unpaid -> partially_paid -> paid.

**Multi-Currency (FX) Architektúra:**
- Dual-Layer Storage: Backend minden számítást alapdevizában (HUF) végez. Frontend az _fx végződésű mezőket használja (megjelenítés, árfolyam-számítás).
- FX Workflow: Teljes körű devizás folyamat (Rendelés -> Értékesítés) tetszőleges devizanemben.
- Toleráns Logika: Kerekítési anomáliák (filléres eltérések) automatikus kezelése a fizetési státuszváltáskor.
- Adatbázis sémabővítés: CustomerOrder, Sale, Item és FinancialTransaction táblák kiegészítve FX metaadatokkal (currency, exchange_rate, amount_paid_fx).

**Kiadáskezelés & NAV Szinkron:**
- Billingo/NAV Integráció: NAV-ba beérkező számlák (kiadások) automatikus betöltése és kiegyenlítése a Donkey-ban.
- Unified Expense Dashboard: Manuális, NAV-alapú és beszerzési kiadások összevont kezelése.
- Tömeges kiegyenlítés: Manuális "pipálós" vagy XLSX-alapú tömeges tranzakció-összepontozás (Matching).

**ÁFA & Adózási Logika:**
- NAV VAT Keys: Specifikus ÁFA-kulcsok támogatása (AAM, ATK, EAM, KBAET, TAM, stb.).
- Tételes bontás: Szabályalapú ÁFA-térképezés és százalékos bontás devizás tranzakciók esetén is.

---

### 25. Dinamikus, Feltétel-Alapú Workflow Motor (FSM Engine)

- Logikai alapvetés: Hardkódolt állapotgép helyett dinamikus, admin felületről vezérelt szabályrendszer.
- Technikai mag: Központi szabálymotor és állapotkezelő.
- validate_conditions: Dinamikus feltétel-ellenőrző algoritmus. Automatikus SQLAlchemy relationship felderítés.
- Adattárolás: workflow_rules tábla, JSONB alapú conditions oszlop a komplex logikának.

**Feltétel-ellenőrzési típusok:**
- Children (Gyermek-entitás függőség): Állapotváltás tiltása/engedése a kapcsolódó al-elemek státusza alapján (pl. Project lezárása csak lezárt Quote-okkal).
- Context (Létrehozási kontextus): Új entitás létrehozásakor a hivatkozott szülő-elem állapotának ellenőrzése (pl. Rendelés csak aktív Partnernek).

**Konfigurációs UI (Admin szekció 3 HTML):**
- Entitás-típusonkénti (entity_type) állapot-CRUD.
- Vizuális szabályépítő (From_Status + Action -> To_Status).
- Dinamikusan generált, élő szabálykönyv (tudásbázis).
- Rendszer-szótár: system_config.py – Egységesített ENTITY_DEFINITIONS és ACTION_DEFINITIONS leképezés.
- Alkalmazási kör (Scope): Project, Quote, CustomerOrder, Invoice, Sale (POS), Procurement (PurchaseOrder), Worksheet.

---

### 26. Munkalap (Worksheet) & Task Engine

- Core Logic: Munkalap-Partner-User relációk kezelése. Tartalmazza a Data Locking mechanizmust (partner- és termékadatok DB-szintű örökítése és zárolása a módosítások ellen).
- Progress Tracking: Automatikus haladás-számítás (%) a kapcsolt Task-kártyák állapota alapján.
- Integráció: * Inventory: Közvetlen készletlevonás vagy foglalás a munkalapról.
- Workflow: Egy kattintással konvertálható Árajánlattá vagy Vevői rendeléssé.

**Task Management:**
- FSM: TODO / IN_PROGRESS / DONE státuszok.
- UI: Kanban nézet (PC/Mobil), checkbox alapú teljesítés, határidő-menedzsment.
- Audit: Időbélyegzett, Markdown-kompatibilis jegyzetek user-trackinggel.
- Rugalmasság: Átalakítható gépnyilvántartóvá, szervizmodullá vagy üzemanyag-kalkulátorrá.

26B. Mobil Munkalap & Vezetői Kontroll / Mobile UI/UX

- Auto-Routing: Automatikus nézetváltás 768px alatt; "tisztított" felület a terepmunkához.
- Role-based view: A user csak a saját feladatait látja; funkcionális korlátozás (mobilon csak státusz és jegyzet, szerkesztés tiltva).
- Architecture: Moduláris JS-alapú menü-loader; unified.css standard.

**Vezetői Dashboard:**
- Aggregált API: Speciális végpont, amely összefűzi a Feladat + Munkalap + Partner adatokat egyetlen lekérdezésbe.
- Kontroll: Valós idejű, kliensoldali szűrés felelősre és státuszra.

**Automatizáció & Media:**
- Notification (SMTP): Automata mail feladatkiosztáskor, felelős-váltáskor és lezáráskor (visszacsatolás a létrehozónak).
- Attachments: Képi dokumentáció csatolása közvetlenül a feladatkártyákhoz.

---

### 27. Generatív AI (LLM) & Visual Engine

**Multi-Model Architektúra:**
- Google Vertex AI: Gemini 2.5 Flash/Pro, Gemini 3 Pro. Natív EU/US régió-kezelés és automata failover.
- Anthropic: Claude 3.5 / 4.5 Sonnet integráció.
- Prompt Management: llm-konfig.html admin felület; LlmConfig tábla. Sablon-alapú, modellenként és feladatonként konfigurálható promptok.

**Context Engine (Adatgyűjtés):**
- Deep Integration: Egyetlen lekérdezéssel gyűjt adatokat a Task, Project, Partner, Note és User táblákból.
- Time-windowing: Konfigurálható időablak (+/- N nap) az elemzésekhez.
- Privacy: Cookie-alapú auth; a lekérdezések szigorúan a bejelentkezett User és a hozzá rendelt entitások hatókörére (scope) korlátozódnak.

**Üzleti Funkciók:**
- AI Analyst: "Reggeli Összefoglaló" és komplex projekt-auditok készítése.
- Marketing Automation: Termék rövid/hosszú leírás generálása (Név + Kategória + TAG alapján, max. 10.000 karakter). Automata webáruház-feltöltés.
- Sales Support: Árajánlat szövegezés (Partner + Web adatok összefésülése).

**Visual Engine (Imagen 4.0):**
- Pipeline: llm-visual-config.html. Láncolt munkafolyamat: Szöveg -> Visual Bridge (Magyar marketing szöveg -> Angol technikai vizuális prompt) -> Imagen motor.
- Paraméterezés: Képarányok (16:9, 1:1, 9:16, 4:3), stílus-suffixek, negatív promptok.
- Tárolás: GCS (Google Cloud Storage) UUID-alapú védett URL-ekkel.

27B. AI FinOps & Monitoring (Költségkontroll)

**Precíziós Árazás:**
- Token-alapú: Dinamikus $/1M token számítás (Input/Output külön).
- Fixáras: Egységáras elszámolás képalkotás esetén ($/kép).
- Adatintegritás: Decimal-alapú számítás a mikroköltségek (pl. $0.000001) kerekítési hibáinak elkerülésére.

**Dashboard & Audit:**
- Transzparens tranzakciós napló: Projekt/User/Partner szintű AI erőforrás-követés.
- Láncolt költségmutatás: Egy folyamaton belül külön látható a szöveggenerálás, a fordítás és a képalkotás díja.

---

### 28. Integrált & Automata Levelezés (Communication Engine)

**Kétcsatornás Transzmisszió:**
- Google Workspace (v5.7): Gmail API integráció (Service Account), automata küldés és fogadás (Inbound/Outbound).
- Külső SMTP: Rugalmas ENV-alapú konfiguráció (Host, Port, Auth) bármely külső szerverhez.

**Automatizációs Motor:**
- Triggerek: Eseményvezérelt küldés (pl. task_created, order_created).
- Dinamikus Címzettek: Fix listák vagy logikai változók (pl. task_felelose) használata.
- Dinamikus Csatolmányok: Automatikus fájlcsatolás a védett Safe Bucket-ből (pl. generált PDF bizonylatok, igazolások).

**Adminisztráció & Audit:**
- Konfiguráció: llm-konfig.html-szerű dedikált felület a sablonok és szabályok kezelésére.
- EmailLog: Minden kísérlet (siker/hiba) központi naplózása. email-naplo.html a visszakövetéshez.
- Operatív Értesítések: Automata értesítők feladatkiosztásról (leírás + határidő), felelős-váltásról és elvégzésről (visszajelzés a létrehozónak).

---

### 29. Államdó feladatok és munkarend szervező (Workforce Management)

- Struktúra: Dedikált Workforce táblák a Worksheet modulon belül.
- Feladat-hierarchia: Állandó feladatcsoportok -> Feladatok (Név, leírás, időkeret).

**Felelősi Mátrix:**
- Szerepkörök: Főfelelős, társfelelősök és helyettesítők kijelölése a User táblából.
- 
- Interfész: Kanban (drag-and-drop) és táblázatos nézet; egykattintásos felelős-váltás.

**Összetett Nézetek:**
- Dashboard: Ad-hoc (Project/Worksheet) és állandó feladatok szinkronizált megjelenítése user-szinten.
- User dashboard: Saját állandó feladatok összesítő nézete, minden adattal részletesen.
- Analitika: Terhelés-eloszlási diagramok és felelős-alapú kapacitás-nézet.
- Szervezeti Eredmény (Output): A felépített rendszer alkalmas automatizált SZMSZ (Szervezeti és Működési Szabályzat) generálására és belső publikálására.

---

### SPECIAL 1. Egyedi Parent-Child Projektvezérlés & Kalkulációs Motor

- Adatmodell: Rekurzív, önhivatkozó ProjectProduct struktúra (Szülő-Gyerek reláció).
- Workflow (4-lépcsős placeholder folyamat):
- Projekt létrehozás/szerkesztés.
- Operatív menedzsment (Kanban, Taskok, Jegyzetek).
- Árajánlat-összeállítás (verziózott).
- Utókalkuláció és cikkszámozás (frontend-first megközelítés).

**Adatkezelési logikák:**
- Snapshotting: Termékadatok befagyasztása a projektbe emeléskor (adatváltozás-védelem).
- Logikai Flag-ek: show_on_offer (láthatóság bizonylaton), needs_procurement (beszerzési igény jelölése).
- Excel-szerű kalkuláció: Tételszintű real-time számítások (kedvezmény, szállítás, termékdíj, árrés) frontend és backend szinkronnal.
- Verziókezelés: ProjectSpecification és ProjectGeneratedOffer táblák. Időbélyegzett XLSX/PDF exportok GCS tárolással.
- UI/UX: Vízszintes tab-navigáció, inline szerkeszthető táblázatok, dinamikus harmonika nézet (hierarchia-megjelenítés).

**SPECIAL 1B. Agregált Beszerzéskezelés (Project-Linked Procurement)**
- Cross-Project Logika: Több különböző projekt beszerzésre váró tételeinek összevonása egyetlen agregált listára.
- Visszacsatolás: A projekt-adatlapon valós időben látszik a kapcsolódó beszerzési státusz (ETA, tényleges ár, beérkezett mennyiség, raktárkészlet).
- Kommunikáció: In-app e-mail küldés (SMTP/Gmail) generált XLSX beszerzési listával; Safe Bucket alapú fájlhozzáférés (cookie/proxy védelemmel).

*SPECIAL 1C. Pénzügyi Híd & Intelligens Számlázás**
- Pénzügyi Híd: Tranzakcionális kapcsolat a hierarchikus projekt-fa és a lineáris Sales modul között.
- Számlázási Védelem: ProjectSaleItemLink + billed_quantity logika. Double Billing Prevention: Backend validáció gátolja meg egy tétel többszöri kiszámlázását.
- Lump Sum (Összegszerű előleg): Nem csak tételes, hanem fix összegű előlegbekérés dedikált rendszer-cikkszámmal (kontír- és ÁFA-helyes matek).
- Pénzügyi Műszerfal (financial-summary): * Szerződött érték (Parent elemek alapján).
- Számlázott érték (Előleg + Végszámla aggregáció).
- Pénzügyi egyenleg (Fennmaradó keret).
- Many-to-One Számlázás: Több értékesítési tranzakció (pl. különálló előleg és tételes sale) összevonása egyetlen végszámlára.
- Automata Előleg-beszámítás: Backend szintű detekció: a végszámlán automatikusan generált negatív tételek az előlegszámlák alapján (ÁFA-helyes, emberi beavatkozás nélkül).
- NAV-Konformitás: Automatikus hivatkozási lánc (előlegszámla sorszámok) beégetése a végszámla megjegyzés rovatába.

---

### SPECIAL 2. Szoftver- és Telepítésnyilvántartó (Tech CMDB)

- Cél: Az ügyfél-specifikus telepítések (instancék) technikai felügyelete és verziókövetése.
- Technikai Stack: Önálló Router, SQL Models és Pydantic sémák.
- Adatmezők (GCP & DevOps): Deployment/Backend URL-ek, GCP Project ID, DB Connection Name, Public/Private Bucket azonosítók.
- Verziókezelés: Core app verzió és Python környezeti adatok (verziószám) nyilvántartása telepítésenként.

**Üzleti Logika:**
- Partner-kapcsolat: Automata keresővel társított Partner-fiókok.
- Workflow: FSM (Status Manager) által vezérelt életciklus (pl. New -> Active).
- Rugalmasság (5+5): 5 db "Egyedi funkció" és 5 db "Golden Sample Eltérés" mező a standardtól való technikai elhajlások dokumentálására.
- Operatív Eszközök: Beépített Kanban feladatkezelő, chat-szerű időbélyegzett jegyzetek és dinamikus szerkesztő modal.

---

### SPECIAL 3. UNAS Webhook-alapú Kupon & Ajánlói Rendszer

- Webhook Architektúra: /api/webshop/webhook végpont JSON payload fogadására és azonnali "Adathíd" alapú rendelés-mentésre.

**Automatizált Workflow:**
- Eligibility Check: Jogosultság ellenőrzése (Státusz: Számlázva, Vevőcsoport, "kupon_kiadva" flag).
- Kupon Generálás: Automata setCoupon hívás az UNAS API felé ajánlói paraméterek alapján.
- GDPR-Ready Biztonság: A generált kuponadatok SHA-256 hashelt email címekkel kerülnek publikálásra a GCS bucketbe (személyes adatok védelme).
- Frontend Injekció: Egyedi JavaScript az UNAS felületén, amely azonosítja a usert, és dinamikusan beilleszti a személyre szabott kupont az áruház UI-ba.
- Audit: UNASWebhookLog és CouponTransaction táblák a tranzakció-szintű visszakövethetőséghez.

---

### SPECIAL 4. Térképes Kertészeti Zóna Rendszer (Vertical Solution)

- Vizualizáció: Drónfotó alapú, nagyfelbontású ortofotó webapp. Valós idejű útvonaltervezés a termékhez (vevőknek és kollégáknak).
- Mobile WMS (Field Work): Terepi zóna-karbantartó app; készletszűrés és bruttó ármegjelenítés a termék mellett állva.
- Adatmodell & Admin: * Zóna Törzsadat: Dedikált modul a kódok és leírások kezelésére.
- Zone Supervisors: Many-to-many (M:N) reláció a zónák és a felelősök között.
- Adatintegritás: * DB Constraints: PostgreSQL szintű Foreign Key kényszerek (fk_products_zone_name) az elgépelések ellen.
- Audit Trail: Automatikus naplózás (módosító user + timestamp).
- Szinkron Logika: "Donkey-as-Master" elv. A webáruház import nem írhatja felül a Donkey-ban kézzel karbantartott zónaadatokat.

**SPECIAL 4B. Hierarchikus Kategorizációs Motor (Deep Dive)**
- Recursive Tree Model: Végtelen mélységű (SQLAlchemy parent_id) fa-struktúra; automatikus virtuális útvonal (full_path) generálás.
- Intelligens ETL: 95%-os pontosságú kulcsszó-alapú auto-kategorizálás; "Lazy" fa-építés (hiányzó ágak automatikus létrehozása import során).
- Safe Update Import: SKU-alapú szelektív frissítés. Csak a kategóriát és megjegyzést módosítja, védi az árakat, készletet és zónákat.
- Fuzzy Path Recognition: Backend oldali logika a szöveges útvonalak (pl. "A > B > C") feldolgozására ID-alapú bemenet helyett is.

**SPECIAL 4C. AI FinOps & MolinAI Ügyfél-asszisztens**
- AI Monitoring: Tranzakcionális szintű token- és költségmérés (Decimal-alapú fixpontos precizitással).
- MolinAI (Customer-Facing): * Knowledge Base: A Donkey platform zóna-, kategória- és termékadatainak natív ismerete.
- Szakmai tanácsadás: Iteratív válaszok fényigény, vízigény és egyéb paraméterek alapján.
- Lead Capture: Sikertelen segítségnyújtás esetén automatikus adatgyűjtés és CRM-továbbítás a kollégáknak.
- Személyiség Prompt: 10.000 karakteres vezérlő prompt az AI viselkedésének és aktuális üzleti céljainak (pl. akciók) beállításához.

---

### SPECIAL 5. Karácsonyi Jósgyár - Absztrakt AI Workflows

- Koncepció: A Donkey architektúra (FastAPI/DB/VertexAI) absztrakt felhasználása egyedi szórakoztató modulként.
- Adatbevitel & Fuzzy Logic: Publikus frontend, ahol a felhasználói nevet fuzzy kereséssel veti össze a DB-ben tárolt profilokkal.
**Multi-step AI Chaining (Láncolt munkafolyamat):**
- 1. Szöveges kontextus: Felhasználói profil + kategória tagek + manuális szövegbevitel (random könyv-generátor alapján) összefűzése.
- 2. VertexAI (Text): Személyre szabott jóslat generálása a DB-ben tárolt stílus-promptok alapján.
- 3. VertexAI (Prompt Engineer): A generált jóslatból technikai angol nyelvű vizuális prompt készítése.
- 4. Imagen 4.0: Képgenerálás a választott stílus és képarány alapján.
- Kimenet & Audit: Formázott HTML hírlevél küldése (SMTP/Workspace), token-használat és költség-naplózás (FinOps).
- Multilingual: Dinamikus nyelvi környezet (HU/UA tesztelve), független a platform alapnyelvétől.