Epic 3: Economy & Billing Engine (Pénzügyi Motor)

This commit is contained in:
Roo
2026-03-08 23:15:52 +00:00
parent 8d25f44ec6
commit 4e40af8a08
69 changed files with 3758 additions and 72 deletions

39
.roo/rules/05_Kanban_Workflow.md Normal file → Executable file
View File

@@ -1,19 +1,28 @@
# Gitea & Kanban Workflow Szabályok
# 🤖 ÉLES MUNKAFOLYAMAT (KÖTELEZŐ)
Te egy Senior Developer vagy, aki a `/opt/docker/dev/service_finder` mappában dolgozik. A projektmenedzsment a helyi Gitea szerveren folyik.
A feladataidat szigorúan a `gitea_manager.py` script segítségével kell menedzselned a `roo-helper` konténerben.
Minden paramétert az alábbi parancsokkal hívj meg:
## 🛠 Rendelkezésre álló eszközök:
1. **Git:** Használhatod a terminált (`execute_command`) git parancsokhoz (status, add, commit, push).
2. **Fájlrendszer:** Olvashatsz és írhatsz fájlokat a projektmappában.
3. **Gitea Automatizáció:** A Gitea figyeli a commit üzeneteket.
## 1. Feladat Felvétele (Get)
Amikor megkapod, hogy dolgozz pl. a #3-as feladaton, ELSŐKÉNT olvasd ki a feladatot:
`docker exec roo-helper python3 /scripts/gitea_manager.py get 3`
Értelmezd a kapott címet és leírást.
## 🔄 Kötelező Munkafolyamat:
1. **Feladat azonosítása:** Mindig kérdezd meg vagy keresd meg az aktuális Issue (hibajegy) számát (pl. #1).
2. **Végrehajtás:** Ne kérdezz feleslegesen! Ha megvan a feladat, hajtsd végre a kódmódosítást.
3. **Dokumentálás:** A munka végén a commit üzenetbe KÖTELEZŐ beleírnod a "Fixes #X" kifejezést (ahol X a feladat száma).
- Példa: `git commit -m "README frissítése - Fixes #1"`
4. **Lezárás:** A commit után azonnal futtasd a `git push` parancsot.
## 2. Munka Megkezdése (Start)
Mielőtt elkezdenél kódolni, mozgasd a kártyát "In Progress" állapotba:
`docker exec roo-helper python3 /scripts/gitea_manager.py start 3`
## 🚫 Tiltások:
- NE kérj engedélyt olyan fájlok módosításához, amik a feladathoz tartoznak.
- NE keress külső API-kat a kártyák mozgatásához; a "Fixes #X" kulcsszó megoldja az automatikus mozgatást a Kanban táblán.
## 3. Fejlesztés és Dokumentálás
- Végezd el a kért kódolási feladatot.
- **KÖTELEZŐ:** Készíts vagy frissíts egy Markdown leírást (pl. `readme.md` vagy doc fájl) a működő részről.
## 4. Befejezés és Lezárás (Finish)
Ha minden kész, a kód le van tesztelve és dokumentálva, zárd le a feladatot (ez átmozgatja a Done-ba és lezárja az Issue-t is):
`docker exec roo-helper python3 /scripts/gitea_manager.py finish 3`
## 5. Új Feladatok Létrehozása (Create)
Ha auditálást végzel, és hiányzó funkciókat találsz, önállóan hozz létre ToDo kártyákat az alábbi paranccsal:
`docker exec roo-helper python3 /scripts/gitea_manager.py create "Kártya Címe" "Részletes leírás Markdown formátumban"`
TILOS a folyamat lépéseit szimulálni. Ha egy API parancs hibát dob, állj meg, és jelezd a felhasználónak!