myCRM/docs/GITEA_QUICKSTART.md

Gitea-Lizenzierung: 5-Minuten Quickstart

Schritt 1: Repository in Gitea erstellen (1 Min)

# In Gitea UI:
1. Klicke auf "+" → "New Repository"
2. Repository Name: mycrm-billing-module
3. Owner: mycrm (oder dein User)
4. ✅ Make Repository Private
5. Klicke "Create Repository"

Repository-URL: https://git.mycrm.local/mycrm/mycrm-billing-module

---

Schritt 2: Gitea Access Token generieren (1 Min)

# In Gitea UI:
1. Klicke auf dein Avatar → "Settings"
2. Linke Sidebar → "Applications"
3. Section "Generate New Token"
   - Token Name: "myCRM License - Billing Module"
   - ✅ Select scopes: repo
4. Klicke "Generate Token"
5. 📋 Kopiere den Token (wird nur einmal angezeigt!)

Beispiel-Token: abc123def456ghi789jkl012mno345

---

Schritt 3: myCRM konfigurieren (1 Min)

# .env.local erstellen/bearbeiten
cp .env.plugin.example .env.local
nano .env.local

Konfiguration:

###> Plugin-System ###
LICENSE_BACKEND=GiteaLicenseValidator
GITEA_BASE_URL=https://git.mycrm.local
GITEA_ORGANIZATION=mycrm
INSTANCE_ID=meine-crm-instance-1

###> Modul-Lizenzen ###
GITEA_TOKEN_BILLING=abc123def456ghi789jkl012mno345

Speichern: Ctrl+O → Enter → Ctrl+X

---

Schritt 4: Modul installieren (1 Min)

# Composer Repository konfigurieren
composer config repositories.mycrm-billing vcs https://git.mycrm.local/mycrm/mycrm-billing-module

# Composer Auth konfigurieren (gleicher Token!)
composer config http-basic.git.mycrm.local dein-username abc123def456ghi789jkl012mno345

# Modul installieren
composer require mycrm/billing-module

# Migration ausführen
php bin/console doctrine:migrations:migrate -n

---

Schritt 5: Verifizieren (1 Min)

# Cache leeren
php bin/console cache:clear

# Module auflisten
php bin/console app:module:list

Erwartete Ausgabe:

┌──────────┬─────────┬────────────────────────────────────────────┐
│ Modul    │ Status  │ Lizenz-Info                                │
├──────────┼─────────┼────────────────────────────────────────────┤
│ billing  │ ✓ Aktiv │ Gitea Repository-Zugriff bestätigt         │
│          │         │ (mycrm/mycrm-billing-module)               │
└──────────┴─────────┴────────────────────────────────────────────┘

---

✅ Fertig!

Dein Modul ist jetzt lizenziert und einsatzbereit.

Testen:

1. Gehe zu https://mycrm.local/billing
2. Das Modul sollte geladen sein
3. Bei Problemen: Logs prüfen in var/log/dev.log

---

Weitere Benutzer lizenzieren

Variante A: Gitea Collaborator hinzufügen

# In Gitea UI:
1. Gehe zu Repository: mycrm-billing-module
2. Settings → Collaboration
3. Klicke "Add Collaborator"
4. User suchen und auswählen
5. Permission: Read
6. Klicke "Add Collaborator"

Der neue User kann jetzt:

1. Eigenen Token generieren
2. In seiner myCRM-Instanz den Token eintragen
3. Modul nutzen

Variante B: Gitea Team erstellen (für mehrere User)

# In Gitea UI:
1. Gehe zu Organisation "mycrm"
2. Teams → "Create Team"
3. Team Name: "Premium Customers"
4. Permissions: Read
5. Klicke "Create Team"

# Dann: Team-Mitglieder hinzufügen
1. Team → Members
2. "Add Team Member"
3. User auswählen

# Dann: Repository dem Team zuweisen
1. Gehe zu Repository: mycrm-billing-module
2. Settings → Collaboration
3. "Add Team"
4. Team: Premium Customers
5. Permission: Read

Alle Team-Mitglieder haben automatisch Zugriff!

---

Troubleshooting

❌ "Kein Zugriff auf Modul-Repository"

Test:

curl -H "Authorization: token abc123def456..." \
  https://git.mycrm.local/api/v1/repos/mycrm/mycrm-billing-module

Sollte zurückgeben: Status 200 + JSON

Falls Status 404:

• Repository existiert nicht oder ist falsch benannt
• Prüfe: https://git.mycrm.local/mycrm/mycrm-billing-module

Falls Status 401:

• Token ist ungültig oder hat keine repo Berechtigung
• Generiere neuen Token mit korrekten Scopes

❌ Modul erscheint nicht in Liste

# Cache leeren
php bin/console cache:clear

# Plugin-System neu laden
php bin/console cache:warmup

# Prüfen ob .env.local geladen wird
php bin/console debug:container --env-vars | grep GITEA

❌ Composer kann nicht installieren

# Auth prüfen
cat auth.json

# Sollte enthalten:
{
    "http-basic": {
        "git.mycrm.local": {
            "username": "dein-username",
            "password": "dein-token"
        }
    }
}

# Neu versuchen
composer install -vvv

---

Nächste Schritte

• Weitere Module lizenzieren: Wiederhole Schritte 1-5
• Admin-UI nutzen: Gehe zu /admin/modules für grafische Verwaltung
• Lizenz-Metadaten: Lies GITEA_LICENSE_SYSTEM.md für Features & Ablaufdatum
• Vollständige Doku: Siehe PLUGIN_SYSTEM.md

---

Cheat Sheet

# Token registrieren
php bin/console app:module:license billing YOUR_TOKEN

# Status prüfen
php bin/console app:module:list

# Lizenz widerrufen
php bin/console app:module:revoke billing

# Cache leeren
php bin/console cache:clear

# Gitea API testen
curl -H "Authorization: token YOUR_TOKEN" \
  https://git.mycrm.local/api/v1/user