service-finder/.roo/rules/00_system_manifest.md

⚡ RENDSZER ADATOK (FIX)

• Gitea API Token: d7a0142b5c512ec833307447ed5b7ba8c0bdba9a
• Project ID: (Keresd ki egyszer: docker exec roo-helper python3 /scripts/gitea_manager.py parancsal, ha kiírja, írd ide fixen!)
• Szabály: TILOS a műveletek szimulálása. Ha az API hibaüzenetet ad, a feladat SIKERTELEN, és jelentened kell a pontos hibaüzenetet.

🗺️ ROO CODE NAVIGÁCIÓS TÉRKÉP

• Munkaterületed (Workspace): /opt/docker/dev/service_finder
• Saját scriptjeid helye: .roo/scripts/
• Futtató környezet: sf_api konténer
• Futtatási parancs: docker exec sf_api python3 /scripts/[fájlnév].py

Gitea Fix Adatok:

• Owner: kincses
• Repo: service-finder
• Project: Master Book 2.0

CRITICAL SYSTEM RULES FOR ROO

1. GITEA MANAGER EXECUTION: You MUST ALWAYS run the Gitea Manager script inside the roo-helper container. NEVER run it in the sf_api container. Exact command to use: docker exec -it roo-helper python3 path/to/gitea_manager.py (adjust path as needed).

. ELÉRHETŐ GITEA PARANCSOK:

• LISTÁZÁS: 'docker exec roo-helper python3 /scripts/gitea_manager.py list'
• RÉSZLETEK: 'docker exec roo-helper python3 /scripts/gitea_manager.py get <issue_id>'
• INDÍTÁS: 'docker exec roo-helper python3 /scripts/gitea_manager.py start <issue_id>'
• LEZÁRÁS: 'docker exec roo-helper python3 /scripts/gitea_manager.py finish <issue_id>'
• FRISSÍTÉS (ÚJ!): 'docker exec roo-helper python3 /scripts/gitea_manager.py update <issue_id> --title "Új cím" --body "Új leírás"'

🛠️ TERMINÁL HASZNÁLATI SZABÁLYOK (KRITIKUS)

A projekt hibrid architektúrával működik. Szigorúan különbséget kell tenned a Backend és a Frontend parancsok futtatási helye között!

1. BACKEND Parancsok (Python, Adatbázis, Robotok):

   • A helyi gép termináljában NINCS Python környezet beállítva ezekhez.
   • Minden backend parancsot KÖTELEZŐ a konténeren belül futtatni a docker compose exec sf_api előtaggal!
   • Helyes: docker compose exec sf_api python3 -m app.scripts.sync_engine

2. FRONTEND Parancsok (Vue, Vite, Playwright):

   • Ezeket a helyi gép termináljában kell futtatni, a /opt/docker/dev/service_finder/frontend mappában!
   • Kódolás/tesztelés előtt mindig lépj be a mappába: cd frontend
   • konténer neve: sf_public_frontend
   • Helyes teszt indítás: npm run dev -- --host 0.0.0.0 majd új terminálban npx playwright test

3. Munkakönyvtár kezelése konténerben: Ha a parancsot egy alkönyvtárban kell futtatni a konténeren belül, használd a /bin/sh -c szintaxist:

   • Helyes: docker compose exec sf_api /bin/sh -c "cd /app/backend && python3 ..."

CRITICAL DATABASE SYNC RULE:

NEVER use alembic upgrade head or try to resolve Alembic migration conflicts manually unless explicitly instructed. The Masterbook 2.0.1 architecture uses a custom synchronization engine. To apply database schema changes based on SQLAlchemy models, ALWAYS use: docker exec -it sf_api python -m app.scripts.sync_engine Treat the sync_engine as the primary source of truth for schema generation.