# ⚡ 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.