EuGen - Zeugnis- und Beobachtungs-Generator

EuGen ist eine Flutter-App zur effizienten Erstellung individualisierter Schülerzeugnisse und Dokumentation von Beobachtungen für Pädagog:innen.

🎯 Überblick

EuGen unterstützt Erzieher:innen und Lehrer:innen bei der Erstellung aussagekräftiger, wertschätzender Zeugnisse und der systematischen Dokumentation von Beobachtungen. Die App kombiniert vorgefertigte Textbausteine mit individuellen Freitexten und ermöglicht eine strukturierte, zeitsparende Arbeitsweise.

✨ Hauptfunktionen

📋 Zeugnisverwaltung

• Textbausteine-System: 9 Kategorien mit anpassbaren Standardtexten
  • Adjektive & Eigenschaften
  • Nachmittag & Freizeitgestaltung
  • Interessen & Hobbys
  • Ateliers & Kurse
  • Freundschaften & Sozialverhalten
  • Aufgaben & Verantwortung
  • Kreisverhalten
  • Regelverständnis
  • Entwicklung & Fortschritt
• Individuelle Freitexte pro Kategorie
• Fortschrittsanzeige: Visuelle Übersicht über ausgefüllte Kategorien
• Status-Tracking: Markierung als "in Bearbeitung" oder "fertig"
• PDF & Text Export: Professionell formatierte Zeugnisse

📸 Beobachtungsdokumentation

• Foto-Integration: Beobachtungen mit Bildern dokumentieren
• Mehrfach-Zuordnung: Eine Beobachtung für mehrere Schüler:innen
• Kompetenz-Kategorien: Systematische Zuordnung zu Entwicklungsbereichen
• Datums-Verwaltung: Nachträgliches Ändern von Beobachtungsdaten
• Bearbeiten-Funktion: Vollständige Editierbarkeit aller Beobachtungen
• Schnelleingabe: FAB mit Langdruck-Menü für schnellen Zugriff

🎨 Klassenverwaltung

• Bunte Klassen-Logos: Farbige Kacheln mit Text oder Emoji (z.B. 🦁, 1A)
• 18 Farben zur Auswahl
• Standard-Klasse: Automatische Vorauswahl bei neuen Beobachtungen
• Schülerübersicht: Mit Fortschrittsanzeige und Bearbeitungsstatus

💾 Export & Backup

• Flexibler Export:
  • In App-Ordner (Schnellexport)
  • Benutzerdefinierten Ordner wählen
  • Standard-Ordner in Einstellungen festlegen
• Datenbank-Backup:
  • Manuelles Backup mit Zeitstempel
  • Backup in Standardordner oder frei wählbar
  • Wiederherstellen aus Backup-Datei
  • Konfigurierbarer Standard-Backup-Ordner

⚙️ Einstellungen

• Standard-Autor: Automatisch bei neuen Beobachtungen
• Foto-Größe: Klein, Mittel, Groß (Speicherplatz-Optimierung)
• Standard-Klasse: Vorauswahl für neue Beobachtungen
• Export-Ziele: Standard-Ordner für PDF/Text-Export
• Backup-Ordner: Standard-Speicherort für Backups
• Textbausteine-Manager: Eigene Textbausteine hinzufügen, bearbeiten, löschen

🛠️ Technische Details

• Framework: Flutter 3.x
• Plattformen: Android
• Datenbank: SQLite (local-first)
• Sprache: Dart
• Architektur: Stateful Widgets mit DatabaseHelper-Pattern

Hauptabhängigkeiten

dependencies:
  sqflite: ^2.4.1              # Lokale Datenbank
  path_provider: ^2.1.5        # Dateisystem-Zugriff
  pdf: ^3.11.1                 # PDF-Generierung
  image_picker: ^1.1.2         # Kamera & Galerie
  shared_preferences: ^2.3.3   # App-Einstellungen
  file_picker: ^10.3.10        # Ordner-Auswahl
  open_file: ^3.5.10           # Datei-Viewer
  share_plus: ^12.0.1          # Teilen-Funktion
  intl: ^0.19.0                # Datumsformatierung

📁 Projektstruktur

lib/
├── main.dart                   # App-Einstiegspunkt
├── app_wrapper.dart            # Navigation & FAB
├── models/                     # Datenmodelle
│   ├── schueler.dart
│   ├── klasse.dart
│   ├── beobachtung.dart
│   ├── kompetenz.dart
│   ├── zeugnis_eintrag.dart
│   └── freitext_eintrag.dart
├── database/                   # Datenbanklogik
│   └── database_helper.dart
├── services/                   # Business Logic
│   ├── pdf_service.dart
│   ├── text_service.dart
│   ├── backup_service.dart
│   └── app_settings.dart
├── screens/                    # UI-Screens
│   ├── klassen_liste_screen.dart
│   ├── schueler_liste_screen.dart
│   ├── zeugnis_editor_screen.dart
│   ├── beobachtungen_screen.dart
│   ├── neue_beobachtung_screen.dart
│   ├── beobachtung_detail_screen.dart
│   ├── einstellungen_screen.dart
│   └── textbausteine_manager.dart
├── widgets/                    # Wiederverwendbare Widgets
│   ├── logo_scaffold.dart
│   ├── klasse_dialog.dart
│   ├── export_dialog.dart
│   └── kategorien_fortschritt_widget.dart
└── constants/                  # Konstanten
    └── textbausteine.dart

🚀 Installation & Setup

Voraussetzungen

• Flutter SDK (3.0+)
• Dart SDK (3.0+)
• Android Studio / VS Code
• Android SDK für Android-Entwicklung

📱 Verwendung

Erste Schritte

1. Klasse erstellen: Auf der Startseite "+" drücken
2. Schüler hinzufügen: In der Klasse "+" drücken
3. Zeugnis erstellen: Schüler auswählen, Kategorien ausfüllen
4. Exportieren: Download-Button → Format wählen

Beobachtungen dokumentieren

1. ➕ kurz drücken → "Schnelle Beobachtung"
2. Foto aufnehmen (optional)
3. Klasse & Schüler wählen
4. Kompetenzen zuordnen
5. Text eingeben → Speichern

📄 Lizenz

Dieses Projekt steht unter CC-BY-SA-4.0.

---

Made with ❤️(and AI) for educators by educators