Projekt‑Requirements für „Excuse Me“
Titel Excuse MeZiel Eine cross-platform App, die SchülerInnen (und ihre Eltern) erlaubt, Fehlstunden‑Entschuldigungen an ihre Klassenvorstände zu schicken. Für minderjährige SchülerInnen muss die Entschuldigung digital von den Eltern signiert werden. Statistiken und Graphen schaffen Übersicht für Schule und Schüler.
Technologie‑Stack
Backend: Django 4.2.1
Frontend: Flutter 3.10.4
Datenbank: PostgreSQL (PostgreSQL: Opensource, bessere Community, bessere Skalierbarkeit, unterstützt jsonb (json binary))
Auth: OAuth2 / JWT + Django‑Auth
Hosting: Heroku / DigitalOcean (zwei separate Services: API & Mobile)
.
├── ABA.md
├── backend # Server
│ ├── deployment
│ │ ├── Dockerfile
│ │ └── scripts
│ ├── docker-compose.prod.yml # Docker Compose (production)
│ ├── docker-compose.yml # Docker Compose (development)
│ ├── env.example # Template -> .env
│ ├── pyproject.toml # Package Manifest
│ ├── scripts/ # Helper (optional)
│ ├── src # Source Code
│ │ ├── api # API-related Code (Django-App)
│ │ │ ├── admin.py # Django Admin
│ │ │ ├── apps.py # Apps that belong to api
│ │ │ ├── __init__.py
│ │ │ ├── migrations
│ │ │ ├── models.py # DB Model
│ │ │ ├── permissions.py # Permission classes (admin, teacher, parent, student)
│ │ │ ├── serializer.py # Objects <---> JSON
│ │ │ ├── tasks.py # Django Tasks
│ │ │ ├── urls.py # API-Endpoints (routing)
│ │ │ └── views.py # Request/Response (controller)
│ │ ├── celerybeat-schedule
│ │ ├── excuseme # Django Main App
│ │ │ ├── asgi.py # Async Web Server Gateway Interface
│ │ │ ├── celery.py # Task Distribution
│ │ │ ├── __init__.py
│ │ │ ├── settings # Django Project Settings
│ │ │ │ ├── base.py
│ │ │ │ ├── dev.py
│ │ │ │ ├── __init__.py
│ │ │ │ ├── prod.py
│ │ │ │ └── test.py
│ │ │ ├── urls.py # Main App routing
│ │ │ └── wsgi.py # Web Server Gateway Interface
│ │ ├── manage.py # Django - Runs administrative tasks
│ │ ├── media/ # all assets
│ │ ├── requirements.dev.txt # Requirements (dev)
│ │ ├── requirements.txt # Requirements
│ │ ├── static/ # all static files
│ │ └── tests # all tests
│ │ ├── conftest.py
│ │ ├── __init__.py
│ │ └── models # Tests for Models
│ │ ├── __init__.py
│ │ └── test_models.py
│ └── uv.lock
.
.
├── excuseme # App
│ ├── analysis_options.yaml
│ ├── android/ # Android build
│ ├── assets # all assets
│ │ └── icon.png
│ ├── ios/ # IOS build
│ ├── lib # Source Code
│ │ ├── main.dart # Main, Entrypoint
│ │ ├── models # Dataclasses
│ │ │ ├── storage.dart
│ │ │ └── user.dart
│ │ └── pages # all pages
│ │ ├── home_page.dart
│ │ ├── login_page.dart
│ │ ├── settings_page.dart
│ │ ├── skeleton.dart # Responsive Layer (AppBar, BottomNavBar/NavigationRailing, Appstein)
│ │ └── statistics_page.dart
│ ├── linux/ # Linux build
│ ├── macos/ # MACOS build
│ ├── pubspec.lock
│ ├── pubspec.yaml # Package Manifest
│ ├── README.md
│ ├── test # all tests
│ │ └── widget_test.dart
│ ├── web/ # web build
│ └── windows/ # windows build
├── LICENSE
└── README.md
Name
Rolle
Hauptaufgabe
Eltern
Parent Anlegen/Signieren von Entschuldigungen, Benachrichtigungen
Schüler
Student Anzeigen eigener Entschuldigungen, Status
Lehrkraft
Teacher Genehmigung/Verweigerung, Status‑Update
Schulleiter
Admin System‑Konfiguration, Reports
Entwickler
Developer Backend‑ und Frontend‑Entwicklung, Tests
2. Funktionsbeschreibung (Brainstorming) 2.1 Authentifizierung & Rollen‑Management
Registrierung
Eltern & Lehrkräfte per E‑Mail, Bestätigung, Passwortrichtlinie
Schüler werden über Eltern registriert (Sicherheitscode oder Eltern‑Bestätigung)
Login
JWT‑Token‑Ausgabe, Refresh‑Token, 2FA optional
Roles
parent, student, teacher, admin, dev
Aktion
Eltern
Schüler
Lehrkraft
Admin
Create ✓
–
–
–
Read eigene, von Lehrer genehmigte
eigene
eigene und zugewiesene
alle
Update erst Signatur, danach keine
–
Statusänderung (approved/rejected)
–
Delete nur in Draft, Bestätigung erforderlich
–
–
–
Draft‑Status – Eltern können Entschuldigung anlegen, später signieren. Werden dabei auch nach gewisser Zeit auf die signierung hingewiesen.Signature – Digitale Signatur wird in DB gespeichert (ECDSA + SHA‑256).Status‑Übersicht – Ampelsystem (Green: Approved, Yellow: Pending, Red: Rejected).
Kalender‑Ansicht
Anzeige aller Entschuldigungen mit Status.
Filter
Nach Status, Datum, Klassenstufe.
Art
Auslöser
Empfänger
Inhalt
Push‑Notification (FCM)
Status‑Änderung
Eltern, Schüler
Kurzinfo
E‑Mail
Status‑Änderung, Signatur
Eltern, Schüler
Vollständige Entschuldigungs‑Daten
In‑App
Neue Entschuldigung
Eltern, Lehrer
Hinweis
2.5 Reporting & Analytics
Dashboard (Admin)
Anzahl Entschuldigungen pro Klasse, Statusverteilung, Spitzenzeiten.
Export
CSV/Excel für Schulleiter.
2.6 Sicherheit & Datenschutz
Datenschutz
DSGVO‑konforme Speicherung, Aufbewahrungsfrist 3 Jahre.
Sicherheit
HTTPS, OWASP‑Sicherheitsstandards (CSRF, XSS, SQL‑Injection).
Signatur‑Validierung auf Server‑Seite.
Audit‑Log
Änderungen an Entschuldigungen protokolliert (User, Timestamp, Action).
Parent → Create Excuse (Draft) → Sign Parent → View Status Teacher → View Pending Excuses → Approve/Reject Teacher → Add Comment Admin → Generate Report Student → View Own Excuses
Feature
Akzeptanzkriterium
Digital Signature Signatur wird im Backend validiert und mit der Entschuldigung verknüpft.
Role‑Based UI Eltern sehen nur ihre Entschuldigungen, Lehrer ihre Klassen.
Notifications Push‑Notification innerhalb von 5 s nach Status‑Änderung.
Data Persistence Alle Daten in SQL, Backup alle 24 h.
Test‑Coverage 90 % Unit/Integration‑Tests, 80 % E2E‑Tests (Flutter).
5. Projekt‑Timeline (360 h)
Phase
Dauer (h)
Deliverable
Anforderungsanalyse + Architektur
50
Requirements‑Doc, UML
Datenbank‑Design & Setup
40
ER‑Diagram, Migration scripts
Auth + RBAC
60
JWT‑Auth, Role‑Middleware
Excuse‑Module (CRUD, Sign)
80
REST API + Flutter UI
Notification‑System
30
FCM + Email
Dashboard & Reporting
30
Admin UI
Tests & QA
40
Test‑Suite, CI/CD
Deployment & Dokumentation
30
Docker, Heroku, Docs
Abschluss & Präsentation
10
PPT, Demo
dbDiagram
