service-finder/.roo/rules/02-architecture.md

Tech Stack: FastAPI (v2, aszinkron), SQLAlchemy (Async), PostgreSQL (Izolált hálózaton), Docker Compose V2.

AI & OCR: Hibrid AI Gateway (Helyi Ollama: 14B Qwen szövegre, Llama Vision képekre. Fallback: Gemini/Groq).

Identity & Auth: "Dual Entity" modell (Person = hús-vér ember, User = technikai fiók). Triple Wallet gazdasági motor.

Deduplikáció (MDM): Csak akkor van merge, ha a make, a technical_code és a hengerűrtartalom egyezik. N/A és UNKNOWN fallback kódok generálása az SQL kényszerek miatt.

5. SQL és Adatbázis Hibakezelés (Error Handling)

• Unique Constraint hibák: Ha a PostgreSQL InvalidColumnReferenceError vagy UniqueViolation hibát dob az ON CONFLICT miatt, TILOS találgatni a mezőket!
• A kötelező megoldás: Használd az ON CONFLICT ON CONSTRAINT [korlát_neve] DO NOTHING vagy DO UPDATE szintaxist.
• A pontos korlát (constraint) nevét mindig a pgAdmin-ból vagy a \d+ táblanév lekérdezéssel kell kideríteni módosítás előtt.