Forgejo Management Module

Webová aplikace pro vizualizaci a analýzu dat z Forgejo. Poskytuje manažerské přehledy založené na issue, milestones a labels. Potřebuje některá data, které nejsou nativně platformou podporovány (například start datum u milestone nebo odhad hodin u issue).

Požadavky

• Java 21 nebo novější
• Přístup k Forgejo API s tokenem
• Gradle 8.x (nebo použit přibalený gradlew)

Instalace

1. Naklonujte repozitář:

   git clone <repo-url>
   cd ForgejoManagementModule
   

2. Ujistěte se, že máte nainstalovanou Javu 21.

Konfigurace

Před prvním spuštěním je potřeba nakonfigurovat připojení k Forgejo v souboru src/main/resources/application.yaml:

forgejo:
  url: "https://your-forgejo-instance.com"  # URL vaší Forgejo instance
  owner: "nazev-organizace"                  # Vlastník repozitáře (org nebo user)
  repo: "nazev-repozitare"                   # Název repozitáře
  token: "vas-api-token"                     # API token s oprávněním pro čtení

Získání API tokenu: Ve Forgejo přejděte do Settings → Applications → Generate New Token. Token potřebuje oprávnění pro čtení issue a milníků.

Spuštění

Vývojářský režim (přes Gradle)

./gradlew run

Produkční režim (JAR)

./gradlew build
java -jar build/libs/ForgejoManagementModule-1.0-SNAPSHOT.jar

Aplikace bude dostupná na http://localhost:8080

Používání

Po spuštění jsou dostupné následující vizualizace:

Gantt Chart

Zobrazí časovou osu milníků s přiřazenými issue. Ideální pro přehled o harmonogramu projektu.

• Hlavní stránka: /gantt - zobrazí všechny milníky
• Detail milníku: /gantt/milestone/{id} - zobrazí pouze vybraný milník

Burndown Chart

Ukazuje progress práce na milníku a zbývající úkoly v čase.

• Detail milníku: /burndown/milestone/{id} - zobrazí burndown pro konkrétní milník

Port a další nastavení

Výchozí port aplikace je 8080. Pro změnu upravte ktor.deployment.port v application.yaml.

Licence

Tento projekt je licencován pod MIT licencí.