# Sponsoren-Verwaltungssystem - Konzept

## 1. Übersicht
Ein PHP-basiertes System zur zentralen Verwaltung von Sponsoren mit drei Hauptmodulen:
- **Sponsoren-Management**: Firmen, Kontakte, Anfrage-Status
- **Verträge**: Sponsoring-Beträge, Bearbeiter, Statusprotokolle
- **Leistungen**: Sponsoring-Kategorien, erbrachte Leistungen, Social-Media-Status

## 2. Datenspeicherung - JSON-Format
Das System speichert alle Daten **unverschlüsselt als JSON** in `/data/` Ordner:

### Dateistruktur:
```
/data/
├── sponsoren.json           # Alle Sponsoren mit Kontaktdaten
├── vertraege.json           # Verträge und finanzielle Details
├── leistungen.json          # Erbrachte Leistungen und Status
└── anfragen.json            # Anfrage-Status und Historie
```

## 3. Datenstruktur

### 3.1 Sponsoren (sponsoren.json)
```json
{
  "sponsoren": [
    {
      "id": 1,
      "firmenname": "3M Deutschland GmbH",
      "ansprechpartner": "Max Mustermann",
      "email": "Innovation.de@3M.com",
      "telefon": "02131 / 14 - 0",
      "berufsbezeichnung": "Manager",
      "status": "angefragt",
      "kategorie": "Silber",
      "bearbeiter_intern": "Finn",
      "bearbeiter_extern": "Name",
      "erstellt": "2025-10-09",
      "aktualisiert": "2026-02-16",
      "notizen": "Weitere Informationen..."
    }
  ]
}
```

### 3.2 Verträge (vertraege.json)
```json
{
  "vertraege": [
    {
      "sponsor_id": 1,
      "betrag_2025": 2000,
      "betrag_2026": 2000,
      "bearbeiter_intern": "Martin",
      "bearbeiter_extern": "Lukas Badura",
      "statusprotokoll": [
        {
          "datum": "2026-01-16",
          "eintrag": "Besuch bei TI, neuer Ansprechpartner Patrick Schmid"
        }
      ],
      "allgemeine_bemerkungen": "Gold-Sticker auf Nase gewünscht"
    }
  ]
}
```

### 3.3 Leistungen (leistungen.json)
```json
{
  "leistungen": [
    {
      "sponsor_id": 1,
      "kategorie": "Silber",
      "erhaltene_leistung": "Finanzielle Unterstützung + Bauteile",
      "verwendetes_bild": "auto.jpg",
      "social_media": {
        "post": true,
        "story": true,
        "newsletter": true
      },
      "fehlende_leistung": "Website-Erwähnung",
      "bearbeiter": "Alyssa",
      "zu_erledigen_bis": "2026-03-31",
      "status": "offen",
      "sonstiges": "Logo im Newsletter verwenden"
    }
  ]
}
```

## 4. Funktionalitäten

### 4.1 Sponsoren-Verwaltung
- ✅ Sponsoren hinzufügen/bearbeiten/löschen
- ✅ Kontaktdaten verwalten
- ✅ Status und Kategorie setzen
- ✅ Bearbeiter zuordnen
- ✅ Suchfunktion

### 4.2 Verträge-Verwaltung
- ✅ Sponsoring-Beträge erfassen (2025/2026)
- ✅ Statusprotokolle mit Datum (Chronologie)
- ✅ Bearbeiter intern/extern
- ✅ Automatische JSON-Speicherung

### 4.3 Leistungen-Übersicht
- ✅ Sponsoring-Kategorien (Gold, Silber, Bronze, Unterstützer)
- ✅ Erbrachte Leistungen dokumentieren
- ✅ Social-Media-Status (Post, Story, Newsletter)
- ✅ Offene Aufgaben mit Fristen
- ✅ Berichterstattung

### 4.4 Dashboard
- ✅ Übersicht: Aktive Sponsoren nach Kategorie
- ✅ Finanzielle Übersicht (Summen 2025/2026)
- ✅ Offene Aufgaben nach Fälligkeitsdatum
- ✅ Bearbeiter-Statistiken

## 5. Benutzeroberfläche

### Navigations-Struktur:
```
📊 Dashboard
├── 💰 Finanzelle Übersicht
├── 📋 Offene Aufgaben
└── 👥 Bearbeiter-Statistiken

📝 Sponsoren
├── Alle Sponsoren (Tabelle)
├── Neuer Sponsor
└── Sponsor bearbeiten

🤝 Verträge
├── Verträge übersicht
├── Vertrag bearbeiten
└── Statusprotokoll

📦 Leistungen
├── Leistungen übersicht
├── Leistung erfassen
└── Social-Media-Status

⚙️ Einstellungen
├── JSON-Daten exportieren
└── JSON-Daten importieren
```

## 6. Technische Details

### Stack:
- **Backend**: PHP 7.4+
- **Frontend**: HTML5, CSS3, Bootstrap 5
- **Datenspeicherung**: JSON-Dateien
- **Datenformat**: UTF-8 ohne Verschlüsselung

### Wichtige Funktionen:
- JSON-Validierung beim Speichern
- Automatisches Backup beim Ändern
- Fehlerbehandlung und Logging
- Responsive Design für Mobile/Desktop

### API-Endpoints:
```
GET  /api/sponsoren/         - Alle Sponsoren abrufen
POST /api/sponsoren/         - Neuen Sponsor erstellen
PUT  /api/sponsoren/{id}     - Sponsor aktualisieren
DEL  /api/sponsoren/{id}     - Sponsor löschen

GET  /api/vertraege/         - Alle Verträge abrufen
POST /api/vertraege/         - Neuen Vertrag erstellen
PUT  /api/vertraege/{id}     - Vertrag aktualisieren

GET  /api/leistungen/        - Alle Leistungen abrufen
POST /api/leistungen/        - Neue Leistung erfassen
```

## 7. Sicherheit & Datenschutz
⚠️ **WICHTIG**: Da Daten unverschlüsselt gespeichert werden:
- JSON-Dateien sollten NICHT öffentlich zugänglich sein
- `.htaccess` blockiert direkten Zugriff auf `/data/` Ordner
- PHP-Backend validiert alle Eingaben
- Dateirechte: `600` für JSON-Dateien (nur Besitzer)

## 8. Implementierung
Siehe `/public/` für HTML-Interface und `/src/` für PHP-Logik.