feat: implement hybrid address system and premium search logic

- Added centralized, self-learning GeoService (ZIP, City, Street)
- Implemented Hybrid Address Management (Centralized table + Denormalized fields)
- Fixed Gamification logic (PointsLedger field names & filtering)
- Added address autocomplete and two-tier (Free/Premium) search API
- Synchronized UserStats and PointsLedger schemas

docs/V01_gemini/18_ASSET_AND_FLEET_SPECIFICATION.md

@@ -127,4 +127,50 @@ A rendszer háromlépcsős tárolási és feldolgozási logikát alkalmaz az opt
 
 3. **Vault (NAS - Hosszú távú tároló):**
    - A feldolgozott, nagyfelbontású (max 1600px) WebP állomány átkerül a NAS-ra: `/mnt/nas/app_data/organizations/{id}/vault/`.
-   - A NAS-hoz csak akkor fordul a rendszer, ha a felhasználó kifejezetten a dokumentum nagy változatát kéri.
+   - A NAS-hoz csak akkor fordul a rendszer, ha a felhasználó kifejezetten a dokumentum nagy változatát kéri.
+
+   ## 5. Discovery Bot Strategy
+
+### 5.1 Prioritási Sorrend
+A Botok az alábbi sorrendben pásztázzák az adatforrásokat:
+1.  **Land (Földi járművek):**
+    * Személyautók (Car), Motorok (Bike), Teherautók (Truck).
+    * Adatforrás: Márkakereskedői listák, Gyártói API-k.
+2.  **Infrastructure (Infrastruktúra):**
+    * Benzinkutak, Elektromos töltők (OpenChargeMap API).
+    * Ezek könnyen elérhető, statikus adatok.
+3.  **Services (Szervizek):**
+    * Google Maps API, Cégjegyzék adatok.
+    * Ezeket jelöli meg a rendszer "Unverified" (Bot-talált) státusszal.
+
+### 5.2 Adatgazdagítás
+A Bot nem csak a nevet keresi. Célzottan gyűjti:
+* Nyitvatartási idők.
+* Kapcsolattartói adatok (Email, Weboldal).
+* Közösségi média linkek.
+* *Szabály:* A Bot által hozott adat felülírható a "Service Hunt" során a felhasználó által (magasabb megbízhatóság).
+
+## 6. Multi-Source Consensus Logic
+A szervizek és szolgáltatók hitelességét nem csak az Admin, hanem a források száma határozza meg.
+
+### 6.1 Bizalmi szintek (Confidence Score)
+* **Score 1:** Egyetlen forrás (Bot vagy User). Státusz: `pending`.
+* **Score 2:** Két független forrás megerősítése.
+* **Score 3+:** Automatikus hitelesítés (`verified`). Nincs szükség emberi beavatkozásra.
+
+### 6.2 Bot Adatforrások (Priority: Car & Bike)
+A Botok az alábbi sorrendben dolgoznak:
+1. Hivatalos gyártói oldalak (Márkaszervizek).
+2. Szakmai adatbázisok (pl. Autóklub, Kamarák).
+3. Google/Social media API-k.
+
+## 4. Telephelyek (Locations) és Szervizpontok
+Minden szolgáltató (Organization) több telephelyet tarthat fenn.
+
+### 4.1 Kötelező Adatstruktúra
+Minden telephely rögzítésekor az alábbi bontott címadatok kötelezőek:
+- Irányítószám, Város, Közterület neve, Közterület típusa, Házszám.
+- Opcionális: Helyrajzi szám (parcel_id) külterületi vagy HRSZ alapú azonosításhoz.
+
+### 4.2 Validációs Folyamat
+A rögzített címek automatikusan bekerülnek a Master Geo adatbázisba, építve a rendszer globális címjegyzékét.