Files
service-finder/docs/V01_gemini/02_Architecture_System_Context.md
Kincses bb02d4ed59 checkpoint: DB baseline reset (v10) with perfect column order for n8n.
Integrated catalog_robot.py logic for structured data ingestion.
Updated models and documentation for the Robot Ecosystem.
2026-02-14 15:31:56 +00:00

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) és public (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

  1. 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).
  2. Staging Layer: A nyers adatok egy átmeneti (Stage) táblába kerülnek további elemzésre.
  3. Audit Layer: A validátor robot (Robot B) ellenőrzi az adószámokat, TEAOR kódokat és a digitális lábnyomot.
  4. Core Database: Csak a Trust Engine által hitelesített adatok kerülnek az éles jármű- és szervizkatalógusba.