2026.06.04 frontend építés közben

This commit is contained in:
Roo
2026-06-04 07:26:22 +00:00
parent 7adf6cc3e3
commit 59a30ac428
3302 changed files with 24091 additions and 1771 deletions

View File

@@ -15,20 +15,31 @@
- **Project:** Master Book 2.0
. ELÉRHETŐ GITEA PARANCSOK:
- LISTÁZÁS: 'docker exec sf_api python3 /scripts/gitea_manager.py list'
- RÉSZLETEK: 'docker exec sf_api python3 /scripts/gitea_manager.py get <issue_id>'
- INDÍTÁS: 'docker exec sf_api python3 /scripts/gitea_manager.py start <issue_id>'
- LEZÁRÁS: 'docker exec sf_api python3 /scripts/gitea_manager.py finish <issue_id>'
- FRISSÍTÉS (ÚJ!): 'docker exec sf_api python3 /scripts/gitea_manager.py update <issue_id> --title "Új cím" --body "Új leírás"'
- 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)
1. **Helyi környezet korlátja:** A helyi terminálban NINCS Python, NINCS adatbázis elérés. SOHA ne futtass közvetlen parancsokat (pl. `python ...`, `pip ...`, `pytest ...`).
2. **Kötelező prefix:** Minden végrehajtandó parancsot a `docker compose exec sf_api` előtaggal kell futtatnod.
3. **Munkakönyvtár kezelése:** Ha a parancsot egy alkönyvtárban kell futtatni, azt a konténeren belül tedd meg.
- **Hibás:** `cd backend && python -m app.scripts...`
- **Helyes:** `docker compose exec sf_api /bin/sh -c "cd /app/backend && python3 -m app.scripts.unified_db_audit"`
🛠️ 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: