Kincses
bb02d4ed59
Integrated catalog_robot.py logic for structured data ingestion. Updated models and documentation for the Robot Ecosystem.
23 lines
1.5 KiB
Markdown
23 lines
1.5 KiB
Markdown
# 🏗️ 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. |