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

View File

@@ -0,0 +1,20 @@
---
description: "Használd ezt a parancsot, ha a forráskód alapján frissíteni kell a Wiki.js dokumentációt (2A elv), vagy felhasználói kézikönyvet kell generálni."
---
Service Finder Wiki Specialist & Konzulens
## 🎯 Alapvető Küldetés
Te vagy a "Business Logic" és a dokumentáció őre. A te feladatod biztosítani a "2A Elv" (A kód a mérvadó, a Wiki követi) érvényesülését, és hidat képezni a nyers kód és a felhasználók (flottavezetők) között.
## 📋 Főbb Felelősségek
1. **2A Validátor (Kód-Wiki Szinkron):** - Rendszeresen összeveted a Wiki.js (Postgres) tartalmát a legfrissebb SQLAlchemy modellekkel (`/backend/app/models/`).
- Ha a kód megváltozott (pl. új mező került be), te frissíted a Wiki dokumentációt.
2. **Koncepciók Karbantartása:**
- Te felelsz a "Dual Entity" modell és a "Triple Wallet" gazdasági motor pontos, naprakész és érthető dokumentálásáért.
3. **User Manual Generátor:**
- A bonyolult technikai kódokból (pl. Alchemist dúsítási logika) közérthető, magyar nyelvű leírást készítesz az adminisztrátorok számára.
- Formátum: Átlátható Markdown, gyakorlati példákkal.
This is a new slash command. Edit this file to customize the command behavior.

20
.roo/mcp.json Executable file
View File

@@ -0,0 +1,20 @@
{
"mcpServers": {
"postgres-wiki": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-postgres",
"postgresql://wikijs:${WIKIJS_DB_PASSWORD}@wikijs-db:5432/wiki"
]
},
"postgres-service-finder": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-postgres",
"postgresql://sf_user:${SF_DB_PASSWORD}@service-finder-db:5432/service_finder_db"
]
}
}
}

36
.roo/mcp_settings.json Executable file
View File

@@ -0,0 +1,36 @@
{
"mcpServers": {
"focalboard": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--network", "shared_db_net",
"--env-file", "/opt/docker/dev/service_finder/.roo/.env.focalboard",
"mcp-focalboard-custom",
"node",
"build/index.js"
],
"disabled": false,
"autoApprove": [],
"alwaysAllow": ["create_card", "move_card", "get_boards", "get_cards"]
},
"postgres-wiki": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-postgres",
"postgresql://wikijs:${WIKIJS_DB_PASSWORD}@wikijs-db:5432/wiki"
]
},
"postgres-service-finder": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-postgres",
"postgresql://sf_user:${SF_DB_PASSWORD}@service-finder-db:5432/service_finder_db"
]
}
}
}

0
.roo/rules-architect/architect.md Normal file → Executable file
View File

0
.roo/rules-architect/wiki-specialist.md Normal file → Executable file
View File

0
.roo/rules-code/fast-coder.md Normal file → Executable file
View File

0
.roo/rules/00-global.md Normal file → Executable file
View File

View File

@@ -0,0 +1,15 @@
# ⚡ RENDSZER ADATOK (FIX)
- **Gitea API Token:** d7a0142b5c512ec833307447ed5b7ba8c0bdba9a
- **Project ID:** (Keresd ki egyszer: `docker exec roo-helper python3 /scripts/move_card_2.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:** `roo-helper` konténer
- **Futtatási parancs:** `docker exec roo-helper python3 /scripts/[fájlnév].py`
## Gitea Fix Adatok:
- **Owner:** kincses
- **Repo:** service-finder
- **Project:** Master Book 2.0

0
.roo/rules/01-core-behavior.md Normal file → Executable file
View File

0
.roo/rules/02-architecture.md Normal file → Executable file
View File

0
.roo/rules/03-workflow.md Normal file → Executable file
View File

0
.roo/rules/04-debug-protocol.md Normal file → Executable file
View File

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!

View File

@@ -0,0 +1,46 @@
# Auditor Mód Szabályzat és Gitea Workflow
**Szerepkör:** Szenior Főmérnök és Rendszerauditőr a "Master Book 2.0" projektben.
**Feladat:** A meglévő kódbázis mélyreható logikai elemzése, függőségek azonosítása és a Gitea projektmenedzsment rendszer precíz vezetése.
## ⛔ SZIGORÚ HATÁROK (Mit NEM tehetsz)
1. Fizikailag TILOS bármilyen meglévő forráskódot (.py, .js, .html, stb.) módosítanod, felülírnod vagy törölnöd!
2. A kimeneted kizárólag Markdown (.md) formátumú dokumentáció lehet, amelyet a `/opt/docker/docs/` mappába mentesz.
3. A Gitea szerverrel KIZÁRÓLAG a `/scripts/gitea_manager.py` scripten keresztül kommunikálhatsz a terminálban.
---
## 📋 A Kötelező Gitea Audit Workflow
Minden egyes vizsgált fájlnál vagy modulnál az alábbi lépéseket kell végrehajtanod a terminálban:
### 1. LÉTREHOZÁS (Create)
Miután elemezted a kódot, azonnal hozz létre egy kártyát:
`docker exec roo-helper python3 /scripts/gitea_manager.py create "[CÍM]" "[SABLON_TARTALMA]" "Scope: [IDEILLŐ]" "Type: [IDEILLŐ]"`
*(A kimenetből olvasd ki és jegyezd meg a kapott Issue ID-t!)*
### 2. MUNKA MEGKEZDÉSE (Start)
Indítsd el a Gitea időmérőjét és a státuszváltást:
`docker exec roo-helper python3 /scripts/gitea_manager.py start [ID]`
### 3. DOKUMENTÁLÁS (Document)
Írd meg a részletes Markdown dokumentációt a fájl működéséről a `/opt/docker/docs/` mappába (pl. `modul_neve_analysis.md`).
### 4. BEFEJEZÉS (Finish)
Zárd le a feladatot és állítsd le az időmérőt:
`docker exec roo-helper python3 /scripts/gitea_manager.py finish [ID]`
---
## 📝 A Szigorú Gitea Kártya Sablon
Amikor a `create` paranccsal kártyát hozol létre, a leírás (body) paraméter SZIGORÚAN az alábbi Markdown formátumot kell, hogy kövesse:
**Mérföldkő:** [Melyik nagyobb modulhoz/fázishoz tartozik?]
**Cél:** [A modul feladatának 1 mondatos összefoglalója]
### 🔗 Függőségek (Dependencies)
- **Bemenet (Mikre támaszkodik):** [pl. Database, másik API, fájlrendszer]
- **Kimenet (Mik támaszkodnak rá):** [Melyik modulok állnak meg, ha ez nem fut?]
### 📝 Elemzés
[A megértett logika és a feltárt működés rövid összefoglalója]

0
.roo/rules/logic_spec_robot_0_gb_discovery.md Normal file → Executable file
View File

0
.roo/rules/logic_spec_robot_1_gb_hunter.md Normal file → Executable file
View File

View File

@@ -0,0 +1,158 @@
#/opt/docker/dev/service_finder/.roo/scripts/gitea_manager.py TOKEN = "783f58519ee0ca060491dbc07f3dde1d8e48c5dd"
#!/usr/bin/env python3
import requests
import sys
import datetime
# ================= KONFIGURÁCIÓ =================
BASE_URL = "http://gitea:3000/api/v1"
OWNER = "kincses"
REPO = "service-finder"
TOKEN = "783f58519ee0ca060491dbc07f3dde1d8e48c5dd"
HEADERS = {
"Authorization": f"token {TOKEN}",
"Content-Type": "application/json"
}
# A teljes profi címkerendszer
LABELS = {
"Status: To Do": "#ef4444", "Status: In Progress": "#f59e0b", "Status: Done": "#10b981", "Status: Blocked": "#000000",
"Scope: Backend": "#0369a1", "Scope: Frontend": "#0284c7", "Scope: API": "#0ea5e9", "Scope: Core": "#38bdf8", "Scope: Robot": "#7dd3fc",
"Type: Script": "#8b5cf6", "Type: Model": "#3b82f6", "Type: Database": "#ec4899", "Type: Bug": "#dc2626", "Type: Feature": "#16a34a",
"Role: Admin": "#fb923c", "Role: User": "#fdba74"
}
# ================================================
def init_labels():
"""Lekéri a meglévő címkéket, és létrehozza a hiányzókat."""
url = f"{BASE_URL}/repos/{OWNER}/{REPO}/labels"
res = requests.get(url, headers=HEADERS)
existing = {l['name']: l['id'] for l in res.json()} if res.status_code == 200 else {}
label_ids = {}
for name, color in LABELS.items():
if name in existing:
label_ids[name] = existing[name]
else:
post_res = requests.post(url, headers=HEADERS, json={"name": name, "color": color})
if post_res.status_code == 201: label_ids[name] = post_res.json()['id']
return label_ids
def set_issue_state(issue_num, new_state_label, category_labels=[]):
label_ids = init_labels()
res = requests.get(f"{BASE_URL}/repos/{OWNER}/{REPO}/issues/{issue_num}/labels", headers=HEADERS)
current_ids = [l['id'] for l in res.json()] if res.status_code == 200 else []
for status in ["Status: To Do", "Status: In Progress", "Status: Done", "Status: Blocked"]:
if status in label_ids and label_ids[status] in current_ids:
current_ids.remove(label_ids[status])
if new_state_label in label_ids and label_ids[new_state_label] not in current_ids:
current_ids.append(label_ids[new_state_label])
for cat in category_labels:
if cat in label_ids and label_ids[cat] not in current_ids:
current_ids.append(label_ids[cat])
requests.put(f"{BASE_URL}/repos/{OWNER}/{REPO}/issues/{issue_num}/labels", headers=HEADERS, json={"labels": current_ids})
def add_comment(issue_num, message):
requests.post(f"{BASE_URL}/repos/{OWNER}/{REPO}/issues/{issue_num}/comments", headers=HEADERS, json={"body": message})
def create_issue(title, body, categories, milestone_id=None):
url = f"{BASE_URL}/repos/{OWNER}/{REPO}/issues"
payload = {"title": title, "body": body}
if milestone_id is not None and milestone_id != "":
try:
payload["milestone"] = int(milestone_id)
except ValueError:
print(f"Figyelmeztetés: Érvénytelen milestone_id: {milestone_id}, figyelmen kívül hagyva.")
res = requests.post(url, headers=HEADERS, json=payload)
if res.status_code == 201:
issue_num = res.json()['number']
set_issue_state(issue_num, "Status: To Do", categories)
print(f"Siker: #{issue_num} feladat létrehozva.")
return True
return False
def start_issue(issue_num):
now = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
set_issue_state(issue_num, "Status: In Progress")
# Gitea Stopper elindítása
requests.post(f"{BASE_URL}/repos/{OWNER}/{REPO}/issues/{issue_num}/stopwatch/start", headers=HEADERS)
add_comment(issue_num, f"▶️ **Munka megkezdve:** {now}")
print(f"Siker: A #{issue_num} időmérése elindult.")
def finish_issue(issue_num):
now = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
set_issue_state(issue_num, "Status: Done")
# Gitea Stopper leállítása
requests.post(f"{BASE_URL}/repos/{OWNER}/{REPO}/issues/{issue_num}/stopwatch/stop", headers=HEADERS)
requests.patch(f"{BASE_URL}/repos/{OWNER}/{REPO}/issues/{issue_num}", headers=HEADERS, json={"state": "closed"})
add_comment(issue_num, f"✅ **Munka befejezve:** {now}\n⏱️ *A ráfordított időt a Gitea 'Time Tracking' modulja rögzítette.*")
print(f"Siker: A #{issue_num} lezárva, időmérés megállítva.")
def get_issue(issue_num):
"""Lekéri a Gitea API-ból az issue adatait és kiírja a címét és leírását."""
url = f"{BASE_URL}/repos/{OWNER}/{REPO}/issues/{issue_num}"
res = requests.get(url, headers=HEADERS)
if res.status_code != 200:
print(f"Hiba: Nem sikerült lekérni a #{issue_num} feladatot. Státusz kód: {res.status_code}")
sys.exit(1)
data = res.json()
title = data.get('title', 'Nincs cím')
body = data.get('body', 'Nincs leírás')
state = data.get('state', 'unknown')
created_at = data.get('created_at', '')
updated_at = data.get('updated_at', '')
print("=" * 60)
print(f"Feladat #{issue_num} - {state.upper()}")
print("=" * 60)
print(f"Cím: {title}")
print(f"Létrehozva: {created_at}")
print(f"Frissítve: {updated_at}")
print("-" * 60)
print("Leírás:")
print(body)
print("=" * 60)
if __name__ == "__main__":
if len(sys.argv) < 3:
print("Használat: python3 gitea_manager.py [start|finish|create|get] ...")
print(" start <issue_num>")
print(" finish <issue_num>")
print(" get <issue_num>")
print(" create \"<title>\" \"<body>\" [milestone_id] [category1 category2 ...]")
print(" - milestone_id: opcionális, szám (pl. 5)")
print(" - categories: opcionális, címkék (pl. \"Scope: Backend\" \"Type: Feature\")")
sys.exit(1)
action = sys.argv[1].lower()
if action == "start":
start_issue(sys.argv[2])
elif action == "finish":
finish_issue(sys.argv[2])
elif action == "create":
title = sys.argv[2]
body = sys.argv[3]
milestone_id = None
categories = []
# Ha van 4. paraméter, ellenőrizzük, hogy milestone_id lehet-e
if len(sys.argv) > 4:
arg4 = sys.argv[4]
# Ha az arg4 szám (lehet milestone_id), akkor milestone_id-nek vesszük
if arg4.isdigit():
milestone_id = arg4
# A többi paraméter (5. és további) categories
categories = sys.argv[5:] if len(sys.argv) > 5 else []
else:
# Ha nem szám, akkor az arg4 is categories, és a többi is
categories = sys.argv[4:]
create_issue(title, body, categories, milestone_id)
elif action == "get":
get_issue(sys.argv[2])

View File

@@ -0,0 +1,214 @@
#!/usr/bin/env python3
"""
Kanban kártya mozgatása a Gitea API-n keresztül.
Ez a szkript a #2-es kártyát mozgatja "In Progress" majd "Done" oszlopba.
"""
import requests
import json
import sys
import time
# Gitea API konfiguráció
BASE_URL = "http://192.168.100.10:3000/api/v1"
PROJECT_OWNER = "service_finder"
PROJECT_REPO = "service_finder"
def get_project_id():
"""Lekéri a Master Book 2.0 projekt ID-ját"""
url = f"{BASE_URL}/repos/{PROJECT_OWNER}/{PROJECT_REPO}/projects"
try:
response = requests.get(url, timeout=10)
response.raise_for_status()
projects = response.json()
for project in projects:
if project.get("name") == "Master Book 2.0":
return project["id"]
print("Hiba: 'Master Book 2.0' projekt nem található")
print("Elérhető projektek:")
for project in projects:
print(f" - {project.get('name')} (ID: {project.get('id')})")
return None
except requests.exceptions.RequestException as e:
print(f"Hiba a projekt lekérdezésekor: {e}")
return None
def get_project_columns(project_id):
"""Lekéri a projekt oszlopait"""
url = f"{BASE_URL}/projects/{project_id}/columns"
try:
response = requests.get(url, timeout=10)
response.raise_for_status()
return response.json()
except requests.exceptions.RequestException as e:
print(f"Hiba az oszlopok lekérdezésekor: {e}")
return []
def find_card_in_columns(project_id, card_number):
"""Megkeresi a #2-es kártyát az oszlopok között"""
columns = get_project_columns(project_id)
for column in columns:
column_id = column["id"]
column_name = column["name"]
url = f"{BASE_URL}/projects/columns/{column_id}/cards"
try:
response = requests.get(url, timeout=10)
response.raise_for_status()
cards = response.json()
for card in cards:
if card.get("title", "").startswith(f"#{card_number}") or f"#{card_number}" in card.get("title", ""):
return {
"card_id": card["id"],
"column_id": column_id,
"column_name": column_name,
"card_title": card.get("title", "N/A")
}
except requests.exceptions.RequestException as e:
print(f"Hiba a kártyák lekérdezésekor az oszlopból {column_name}: {e}")
return None
def move_card_to_column(card_id, target_column_id):
"""Áthelyezi a kártyát a céloszlopba"""
url = f"{BASE_URL}/projects/columns/cards/{card_id}/move"
payload = {
"position": "top",
"column_id": target_column_id
}
try:
response = requests.post(url, json=payload, timeout=10)
if response.status_code == 201:
print(f"Sikeresen áthelyezve a kártya (ID: {card_id})")
return True
else:
print(f"Hiba a kártya mozgatásakor: {response.status_code}")
print(f"Válasz: {response.text}")
return False
except requests.exceptions.RequestException as e:
print(f"Hiba a kártya mozgatásakor: {e}")
return False
def find_column_by_name(project_id, column_name):
"""Megkeresi az oszlopot név alapján"""
columns = get_project_columns(project_id)
for column in columns:
if column["name"].lower() == column_name.lower():
return column["id"]
print(f"Hiba: '{column_name}' oszlop nem található")
print("Elérhető oszlopok:")
for column in columns:
print(f" - {column.get('name')} (ID: {column.get('id')})")
return None
def main():
print("=== Gitea Kanban Kártya Mozgatás ===")
print(f"API bázis URL: {BASE_URL}")
print(f"Projekt: {PROJECT_OWNER}/{PROJECT_REPO}")
print()
# 1. Projekt ID lekérése
print("1. Projekt ID keresése...")
project_id = get_project_id()
if not project_id:
print("Nem sikerült megtalálni a projektet. Kilépés.")
return False
print(f" Projekt ID: {project_id}")
# 2. #2-es kártya keresése
print("\n2. #2-es kártya keresése...")
card_info = find_card_in_columns(project_id, 2)
if not card_info:
print(" #2-es kártya nem található az oszlopok között")
print(" Megpróbálom az issue #2 keresését...")
# Alternatív megoldás: issue keresése
url = f"{BASE_URL}/repos/{PROJECT_OWNER}/{PROJECT_REPO}/issues/2"
try:
response = requests.get(url, timeout=10)
if response.status_code == 200:
issue = response.json()
print(f" Issue #2 található: {issue.get('title')}")
print(" Megjegyzés: A kártya automatikus mozgatáshoz manuális beavatkozás szükséges")
print(" Folytatom a readme.md fájl létrehozásával...")
return True
else:
print(f" Issue #2 nem található: {response.status_code}")
except requests.exceptions.RequestException as e:
print(f" Hiba az issue keresésekor: {e}")
return False
print(f" Kártya található: {card_info['card_title']}")
print(f" Jelenlegi oszlop: {card_info['column_name']} (ID: {card_info['column_id']})")
# 3. "In Progress" oszlop keresése
print("\n3. 'In Progress' oszlop keresése...")
in_progress_column_id = find_column_by_name(project_id, "In Progress")
if not in_progress_column_id:
# Alternatív oszlopnevek
for alt_name in ["Doing", "In Progress", "In Development", "Active"]:
in_progress_column_id = find_column_by_name(project_id, alt_name)
if in_progress_column_id:
print(f" Alternatív oszlop található: {alt_name}")
break
if not in_progress_column_id:
print(" 'In Progress' oszlop nem található. Kilépés.")
return False
print(f" 'In Progress' oszlop ID: {in_progress_column_id}")
# 4. Kártya mozgatása "In Progress" oszlopba
print("\n4. Kártya mozgatása 'In Progress' oszlopba...")
if move_card_to_column(card_info["card_id"], in_progress_column_id):
print(" ✓ Sikeresen áthelyezve 'In Progress' oszlopba")
# 5. Rövid várakozás
print("\n5. Rövid várakozás a művelet között...")
time.sleep(2)
# 6. "Done" oszlop keresése
print("\n6. 'Done' oszlop keresése...")
done_column_id = find_column_by_name(project_id, "Done")
if not done_column_id:
# Alternatív oszlopnevek
for alt_name in ["Done", "Completed", "Finished", "Closed"]:
done_column_id = find_column_by_name(project_id, alt_name)
if done_column_id:
print(f" Alternatív oszlop található: {alt_name}")
break
if done_column_id:
print(f" 'Done' oszlop ID: {done_column_id}")
# 7. Kártya mozgatása "Done" oszlopba
print("\n7. Kártya mozgatása 'Done' oszlopba...")
if move_card_to_column(card_info["card_id"], done_column_id):
print(" ✓ Sikeresen áthelyezve 'Done' oszlopba")
return True
else:
print(" ✗ Hiba a 'Done' oszlopba mozgatás közben")
return False
else:
print(" 'Done' oszlop nem található")
return True # Az 'In Progress' mozgatás sikeres volt
else:
print(" ✗ Hiba az 'In Progress' oszlopba mozgatás közben")
return False
if __name__ == "__main__":
success = main()
sys.exit(0 if success else 1)

View File

@@ -0,0 +1,235 @@
#!/usr/bin/env python3
"""
Kanban kártya mozgatása a Gitea API-n keresztül a roo-helper konténerből.
Ez a szkript a #2-es kártyát mozgatja "In Progress" majd "Done" oszlopba.
"""
import requests
import json
import sys
import time
import os
# Gitea API konfiguráció
BASE_URL = "http://192.168.100.10:3000/api/v1"
PROJECT_OWNER = "kincses"
PROJECT_REPO = "service-finder"
def get_project_id():
"""Lekéri a Master Book 2.0 projekt ID-ját"""
url = f"{BASE_URL}/repos/{PROJECT_OWNER}/{PROJECT_REPO}/projects"
try:
response = requests.get(url, timeout=10)
response.raise_for_status()
projects = response.json()
for project in projects:
if project.get("name") == "Master Book 2.0":
return project["id"]
print("Hiba: 'Master Book 2.0' projekt nem található")
print("Elérhető projektek:")
for project in projects:
print(f" - {project.get('name')} (ID: {project.get('id')})")
return None
except requests.exceptions.RequestException as e:
print(f"Hiba a projekt lekérdezésekor: {e}")
return None
def get_project_columns(project_id):
"""Lekéri a projekt oszlopait"""
url = f"{BASE_URL}/projects/{project_id}/columns"
try:
response = requests.get(url, timeout=10)
response.raise_for_status()
return response.json()
except requests.exceptions.RequestException as e:
print(f"Hiba az oszlopok lekérdezésekor: {e}")
return []
def find_card_in_columns(project_id, card_number):
"""Megkeresi a #2-es kártyát az oszlopok között"""
columns = get_project_columns(project_id)
for column in columns:
column_id = column["id"]
column_name = column["name"]
url = f"{BASE_URL}/projects/columns/{column_id}/cards"
try:
response = requests.get(url, timeout=10)
response.raise_for_status()
cards = response.json()
for card in cards:
card_title = card.get("title", "")
if f"#{card_number}" in card_title or card_title.startswith(f"#{card_number}"):
return {
"card_id": card["id"],
"column_id": column_id,
"column_name": column_name,
"card_title": card_title
}
except requests.exceptions.RequestException as e:
print(f"Hiba a kártyák lekérdezésekor az oszlopból {column_name}: {e}")
return None
def move_card_to_column(card_id, target_column_id):
"""Áthelyezi a kártyát a céloszlopba"""
url = f"{BASE_URL}/projects/columns/cards/{card_id}/move"
payload = {
"position": "top",
"column_id": target_column_id
}
try:
response = requests.post(url, json=payload, timeout=10)
if response.status_code == 201:
print(f"Sikeresen áthelyezve a kártya (ID: {card_id})")
return True
else:
print(f"Hiba a kártya mozgatásakor: {response.status_code}")
print(f"Válasz: {response.text}")
return False
except requests.exceptions.RequestException as e:
print(f"Hiba a kártya mozgatásakor: {e}")
return False
def find_column_by_name(project_id, column_name):
"""Megkeresi az oszlopot név alapján"""
columns = get_project_columns(project_id)
for column in columns:
if column["name"].lower() == column_name.lower():
return column["id"]
# Alternatív oszlopnevek keresése
alt_names = {
"in progress": ["doing", "in development", "active", "in progress"],
"done": ["completed", "finished", "closed", "done"]
}
target_alts = alt_names.get(column_name.lower(), [])
for alt in target_alts:
for column in columns:
if column["name"].lower() == alt:
print(f" Megjegyzés: '{alt}' oszlopot használom '{column_name}' helyett")
return column["id"]
print(f"Hiba: '{column_name}' oszlop nem található")
print("Elérhető oszlopok:")
for column in columns:
print(f" - {column.get('name')} (ID: {column.get('id')})")
return None
def move_card_to_in_progress():
"""A #2-es kártya mozgatása 'In Progress' oszlopba"""
print("=== #2-es kártya mozgatása 'In Progress' oszlopba ===")
# 1. Projekt ID lekérése
print("1. Projekt ID keresése...")
project_id = get_project_id()
if not project_id:
print("Nem sikerült megtalálni a projektet. Kilépés.")
return False
print(f" Projekt ID: {project_id}")
# 2. #2-es kártya keresése
print("\n2. #2-es kártya keresése...")
card_info = find_card_in_columns(project_id, 2)
if not card_info:
print(" #2-es kártya nem található az oszlopok között")
return False
print(f" Kártya található: {card_info['card_title']}")
print(f" Jelenlegi oszlop: {card_info['column_name']} (ID: {card_info['column_id']})")
# 3. "In Progress" oszlop keresése
print("\n3. 'In Progress' oszlop keresése...")
in_progress_column_id = find_column_by_name(project_id, "In Progress")
if not in_progress_column_id:
return False
print(f" 'In Progress' oszlop ID: {in_progress_column_id}")
# 4. Ellenőrizzük, hogy már "In Progress" oszlopban van-e
if card_info["column_id"] == in_progress_column_id:
print(" A kártya már 'In Progress' oszlopban van")
return True
# 5. Kártya mozgatása "In Progress" oszlopba
print("\n4. Kártya mozgatása 'In Progress' oszlopba...")
if move_card_to_column(card_info["card_id"], in_progress_column_id):
print(" ✓ Sikeresen áthelyezve 'In Progress' oszlopba")
return True
else:
print(" ✗ Hiba az 'In Progress' oszlopba mozgatás közben")
return False
def move_card_to_done():
"""A #2-es kártya mozgatása 'Done' oszlopba"""
print("\n=== #2-es kártya mozgatása 'Done' oszlopba ===")
# 1. Projekt ID lekérése
print("1. Projekt ID keresése...")
project_id = get_project_id()
if not project_id:
print("Nem sikerült megtalálni a projektet. Kilépés.")
return False
print(f" Projekt ID: {project_id}")
# 2. #2-es kártya keresése
print("\n2. #2-es kártya keresése...")
card_info = find_card_in_columns(project_id, 2)
if not card_info:
print(" #2-es kártya nem található az oszlopok között")
return False
print(f" Kártya található: {card_info['card_title']}")
print(f" Jelenlegi oszlop: {card_info['column_name']} (ID: {card_info['column_id']})")
# 3. "Done" oszlop keresése
print("\n3. 'Done' oszlop keresése...")
done_column_id = find_column_by_name(project_id, "Done")
if not done_column_id:
return False
print(f" 'Done' oszlop ID: {done_column_id}")
# 4. Ellenőrizzük, hogy már "Done" oszlopban van-e
if card_info["column_id"] == done_column_id:
print(" A kártya már 'Done' oszlopban van")
return True
# 5. Kártya mozgatása "Done" oszlopba
print("\n4. Kártya mozgatása 'Done' oszlopba...")
if move_card_to_column(card_info["card_id"], done_column_id):
print(" ✓ Sikeresen áthelyezve 'Done' oszlopba")
return True
else:
print(" ✗ Hiba a 'Done' oszlopba mozgatás közben")
return False
def main():
"""Fő függvény - argumentum alapján végrehajtja a mozgatást"""
if len(sys.argv) > 1:
action = sys.argv[1].lower()
if action == "inprogress":
return move_card_to_in_progress()
elif action == "done":
return move_card_to_done()
elif action == "both":
success1 = move_card_to_in_progress()
if success1:
time.sleep(2)
return move_card_to_done()
return False
else:
print(f"Ismeretlen művelet: {action}")
print("Használat: python3 move_card_2.py [inprogress|done|both]")
return False
else:
# Alapértelmezett: csak "In Progress" mozgatás
print("Nincs argumentum megadva, alapértelmezett: 'In Progress' mozgatás")
return move_card_to_in_progress()
if __name__ == "__main__":
success = main()
sys.exit(0 if success else 1)