Integrated catalog_robot.py logic for structured data ingestion. Updated models and documentation for the Robot Ecosystem.
1.5 KiB
1.5 KiB
🏗️ ARCHITECTURE & SYSTEM CONTEXT
🧩 Komponensek
- Frontend: Vue 3 + Tailwind CSS + Pinia (State) + Vite. "Dumb Frontend" elv: Csak megjelenít, nem dönt.
- Backend API: Python 3.12 + FastAPI. Minden üzleti logika itt fut. Pydantic validáció.
- Database: PostgreSQL 15. Külön
data(üzleti) éspublic(rendszer) sémák. - Storage: MinIO (S3 kompatibilis). Képek, számlák titkosított tárolása.
- Proxy: Nginx Proxy Manager. SSL terminálás (
dev.profibot.hu).
🛡️ Hálózati Határok
- Internal Net (
shared_db_net): A Backend és az Adatbázis közötti dedikált, zárt csatorna. - Public Net: Csak a 80/443 (NPM) nyitott a világ felé. A DB port (5432) és Admin portok (5050, 8888) csak VPN-en vagy localhoston érhetők el.
02. Architecture & System Context
Rendszerarchitektúra v2.0
A rendszer egy eseményvezérelt, mikroszolgáltatás-alapú architektúrára épül, ahol az n8n tölti be a központi idegrendszer (Orchestrator) szerepét.
Adatáramlási Folyamat
- Discovery Layer: n8n által vezérelt robotok (Robot A) pásztázzák a hálót (OSM, DDG, FB, e-Cégközlöny).
- Staging Layer: A nyers adatok egy átmeneti (Stage) táblába kerülnek további elemzésre.
- Audit Layer: A validátor robot (Robot B) ellenőrzi az adószámokat, TEAOR kódokat és a digitális lábnyomot.
- Core Database: Csak a Trust Engine által hitelesített adatok kerülnek az éles jármű- és szervizkatalógusba.