- Zielgruppe: Für Entwicklungs-, Produkt- und Projektteams, die Gitea-Issues in ERPNext-Projekte integrieren möchten, ohne die Führung der Quellinformationen zu verwischen.
- Kernfunktionen: Repository-Mapping, Issue-zu-Task-Synchronisation, Status- und Benutzerzuordnung, Signierte Webhooks, Hintergrund- und Kontrollabgleich, Projektübersicht und Logs
- Integrationen: Gitea, ERPNext v15, Frappe v15, ERPNext Projects, ERPNext Tasks, HMAC-SHA256 Webhooks
- Typische Datenfelder: Repository-Zuordnung: Gitea-Owner oder Organisation, Repository, Eindeutiger Repository-Name, ERPNext-Projekt, Aktivierungsstatus | Issue-Daten aus Gitea: Issue-ID, Issue-Nummer, Titel, Beschreibung, Status, Labels, Frist, Quellen-Zeitstempel, Issue-URL | ERPNext-Zielobjekte: Project, Task, Task-Status, Fortschrittswert, ToDo-Zuweisung, Gitea-Referenzfelder | Betrieb und Nachweis: Synchronisationszeit, Erfolgs- oder Fehlerstatus, Anzahl angelegter Tasks, Anzahl aktualisierter Tasks, Sync-Log
- Ergebnis: Ein kontrollierter, einseitiger Weg von ausgewählten Gitea-Issues in die ERPNext-Projektarbeit – mit klarer Zuordnung, Sicherheitsprüfungen und nachvollziehbarem Betrieb.
Welche Daten werden zwischen Gitea und ERPNext verbunden?
Die Integration verarbeitet nur die Repositorys und Felder, die in ERPNext ausdrücklich freigegeben wurden. Sie liest Gitea-Issues und schreibt daraus ERPNext-Projekte, Tasks und bei passenden Benutzerzuordnungen app-eigene ToDos.
- Konfigurieren: Gitea-Verbindung, Repository-Zuordnungen und Benutzer-Mappings werden explizit in ERPNext gepflegt. Wichtige Punkte: Read-only API-Token, Repository-Mapping, Benutzer-Mapping, Integration aktivieren.
- Synchronisieren: Die App liest aktuelle Gitea-Issues und erzeugt oder aktualisiert daraus passende ERPNext-Tasks. Wichtige Punkte: Dubletten vermeiden, Fristen übernehmen, Labels auswerten, Task-Status setzen.
- Absichern: Eingehende Webhooks werden vor der Verarbeitung geprüft; Zugänge werden nicht in Klartext-Fehlern ausgegeben. Wichtige Punkte: HMAC-SHA256, HTTPS-Vorgabe, Keine Redirect-Folge, Frappe-Passwortfelder.
- Nachvollziehen: Hintergrundjobs und Protokolle machen sichtbar, ob ein Repository erfolgreich verarbeitet wurde. Wichtige Punkte: Manueller Lauf, Regelmäßiger Abgleich, Sync-Log, Berechtigte Projektübersicht.
- Repository-Zuordnung: Die Einstellungen legen fest, welches Gitea-Repository in welches ERPNext-Projekt synchronisiert wird. Typische Felder: Gitea-Owner oder Organisation, Repository, Eindeutiger Repository-Name, ERPNext-Projekt, Aktivierungsstatus.
- Issue-Daten aus Gitea: Diese Informationen werden für die Anlage und Aktualisierung der ERPNext-Tasks verwendet. Typische Felder: Issue-ID, Issue-Nummer, Titel, Beschreibung, Status, Labels, Frist, Quellen-Zeitstempel, Issue-URL.
- ERPNext-Zielobjekte: Die erzeugten oder aktualisierten ERPNext-Objekte bleiben im bestehenden Projekt- und Rechtekontext. Typische Felder: Project, Task, Task-Status, Fortschrittswert, ToDo-Zuweisung, Gitea-Referenzfelder.
- Betrieb und Nachweis: Technische Informationen unterstützen den kontrollierten Betrieb und die Fehlersuche. Typische Felder: Synchronisationszeit, Erfolgs- oder Fehlerstatus, Anzahl angelegter Tasks, Anzahl aktualisierter Tasks, Sync-Log.
- Nicht Bestandteil der Synchronisation sind Pull Requests, Kommentare, Anhänge, CI-Daten, Repository-Erkennung und die Rückübertragung von ERPNext nach Gitea.
Häufige Fragen
Was ist Gitea ERPNext Sync?
Gitea ERPNext Sync ist eine Frappe- und ERPNext-v15-App, die Issues aus ausdrücklich zugeordneten Gitea-Repositories in ERPNext-Projekte und -Tasks überführt und aktualisiert.
Synchronisiert die App in beide Richtungen?
Nein. Die Synchronisation ist bewusst einseitig von Gitea nach ERPNext angelegt. Gitea bleibt das führende System für die von der App synchronisierten Task-Felder.
Welche Gitea-Daten werden nach ERPNext übertragen?
Je nach Repository-Zuordnung verarbeitet die App Issue-ID und -Nummer, Titel, Beschreibung, Status, Labels, Fristen, Quellen-Zeitstempel, URL und zugeordnete Personen. Pull Requests, Kommentare, Anhänge, CI-Daten und Milestone-Details sind nicht Bestandteil der Synchronisation.
Wie werden Status und Zuweisungen abgebildet?
Geschlossene Issues werden als Completed übertragen. Konfigurierbare Gitea-Labels können unter anderem Working oder Pending Review setzen. Gitea-Benutzern lassen sich aktivierte ERPNext-Benutzer zuordnen; manuelle ERPNext-Zuweisungen bleiben dabei erhalten.
Welche Voraussetzungen gelten?
Die App ist für Frappe und ERPNext v15 mit Python 3.10 oder neuer vorgesehen. Für die Gitea-Verbindung wird ein dediziertes Token mit ausschließlich benötigten Leserechten eingerichtet.