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

1009 B
Executable File

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.