FEAT: Corporate onboarding implemented with Tax ID validation (HU) and isolated NAS storage

docs/V01_gemini/06_Database_Guide.md

@@ -96,4 +96,14 @@ A rendszer fel van készítve az EU-s piacra:
   - **Person:** Egyéni teljesítmény, megbízhatóság.
   - **Service (Szerviz):** Szolgáltatási minőség.
   - **Vehicle (Jármű):** Műszaki állapot és előélet.
-  - *Megjegyzés:* A Cég (mint flotta) nem kap önálló értékelést, a hírneve a tagjai és járművei minősítéséből adódik össze.
+  - *Megjegyzés:* A Cég (mint flotta) nem kap önálló értékelést, a hírneve a tagjai és járművei minősítéséből adódik össze.
+
+  ## 4. CRM és Szervezeti Kapcsolattartók
+A `data.organization_contacts` tábla felelős a flottákhoz tartozó humán kapcsolattartók kezeléséért.
+- **Dinamikus beállítások:** A `data.organizations` tábla `notification_settings` (JSONB) mezője szabályozza, ki és mikor kapjon értesítést.
+- **Külső szinkron:** Az `external_crm_id` biztosítja a kapcsolatot külső vállalatirányítási rendszerekkel (API-n keresztül).
+
+## 4.1 Szervezeti és CRM Adatmodell
+- **data.organizations**: Bővítve `tax_number`, `reg_number`, `headquarters_address` és `is_deleted` mezőkkel.
+- **data.organization_contacts**: Új tábla a Mini-CRM funkciókhoz (kapcsolattartók típus szerint: billing, primary, operational).
+- **Audit**: Minden státuszmódosítás és adatváltozás snapshot-olva az `audit_logs` táblába.

docs/V01_gemini/07_REGISTRATION_INVITATION_AND_API.md

@@ -158,4 +158,10 @@ PASSWORD_RESET_TOKEN_EXPIRE_HOURS=1
 EMAIL_PROVIDER=sendgrid
 EMAILS_FROM_EMAIL=info@profibot.hu
 EMAILS_FROM_NAME='Profibot Service Finder'
-SENDGRID_API_KEY=SG.xxxxxxxxxxxxxxxxxxxx
+SENDGRID_API_KEY=SG.xxxxxxxxxxxxxxxxxxxx
+
+## 4. Corporate Onboarding (Céges regisztráció)
+A folyamat célja, hogy egy már létező Person (vagy új User) saját szervezetet (Organization) alapítson.
+- **Többszintű validáció:** Kötelező adószám (VAT/Tax ID) ellenőrzés (HU esetén formátum + VIES API).
+- **Hierarchia:** A regisztráló automatikusan `owner` rangot kap.
+- **Izoláció:** Minden cég saját mappastruktúrát kap a NAS-on az okmányok izolált kezelése érdekében.

docs/V01_gemini/15_Changelog.md

@@ -145,4 +145,11 @@ A fejlesztések rendben tartásához javaslom a **`17_DEVELOPER_NOTES_AND_PITFAL
 ### ✨ Multi-Robot System
 - **Kategória Robotok:** Elkészült a Car, Bike és Truck harvester moduláris szerkezete.
 - **Robot Manager:** Központi vezérlő az ütemezett és sorrendi adatgyűjtéshez.
-- **Katalógus Kereső:** Üzembe helyezve a `/catalog/search` végpont a Swaggerben.
+- **Katalógus Kereső:** Üzembe helyezve a `/catalog/search` végpont a Swaggerben.
+
+## [0.4.5] - 2026-02-07
+### ✨ Asset Management & Infrastructure
+- **Asset Endpoint:** `POST /api/v1/assets/` élesítve VIN validációval.
+- **NAS Integration:** Automata mappastruktúra létrehozása az eszközöknek (`/assets/{uuid}`).
+- **Data Model:** `privacy_level` és `status` mezők hozzáadva az Asset modellhez.
+- **Bugfix:** SQLAlchemy `TypeError` javítva a modell és a séma szinkronizálásával.

docs/V01_gemini/19_ADMIN_AND_PERMISSIONS_SPEC.md

@@ -32,4 +32,35 @@ Minden módosítás előtt a rendszer menti az aktuális rekord állapotát (JSO
 
 ## 5. Adminisztrátori Meghívók
 - Adminisztrátort csak kézi meghívóval lehet felvenni.
-- **Lejárati idő:** Minden admin meghívó token 24 óráig érvényes.
+- **Lejárati idő:** Minden admin meghívó token 24 óráig érvényes.
+
+## 6. Értesítési Engine és Lejárati Figyelmeztetések
+
+A rendszer proaktív figyelmeztető rendszert alkalmaz minden előfizetői szinten (Individual és Corporate egyaránt).
+
+### A) Előfizetés és Pénzügyi Értesítések
+- **Hatókör:** Minden fizetős csomag (Lite+, VIP, VIP+, Corporate).
+- **Logika:** Automatikus értesítés küldése 30, 15, 7 és 1 nappal a csomag lejárta előtt.
+- **Csatornák:** Push notification, Email és a Mini-CRM kontakt személyek értesítése.
+
+### B) Jármű Okmányok és Technikai Lejáratok
+A rendszer figyeli az eszközökhöz rögzített metaadatokat:
+- **Forgalmi engedély:** Műszaki vizsga lejárata.
+- **Biztosítás:** Kötelező (KGFB) és CASCO fordulónapok.
+- **Lízing/Szerződés:** Szerződéses futamidő vége.
+- **Okmányok:** Hajólevél, lajstrom, emelőgép vizsga stb.
+
+### C) CRM Kontaktok és Kapcsolattartás
+Minden szervezet (Organization) esetében kötelező megadni legalább egy **Adminisztratív Kontaktot**.
+- **Több cég kezelése:** Egy Person több szervezetben is betölthet `owner` vagy `fleet_manager` szerepkört.
+- **CRM Mezők:** Név, beosztás, közvetlen elérhetőség (fizetésért felelős, operatív felelős).
+
+## 7. Corporate Onboarding és Validációs Szintek
+A cégek rögzítése háromlépcsős ellenőrzésen esik át:
+1. **Tier 1 (Automata):** Adószám alapú validáció (HU/VIES API).
+2. **Tier 2 (AI/OCR):** Feltöltött dokumentumok (Alapító okirat) intelligens elemzése.
+3. **Tier 3 (Human):** Adminisztrátori jóváhagyás (L2/L3 szint), ha az automata folyamat bizonytalan.
+
+## 8. B2B Jutalék és MLM Kivételek
+- **Direct Referral:** Cég által meghívott másik cég esetén csak 1. szintű (L1) jutalék jár.
+- **MLM Korlát:** Szervezetek nem építhetnek többszintű hálózatot, a kifizetés fix üzleti megállapodás alapú.