Eine moderne, studentenzentrierte Plattform für die Nordakademie
- Über NORA
- Features
- Technologie-Stack
- Architektur
- API-Dokumentation
- Entwickler
- Contributing
- Lizenz
- Kontakt
NORA (Nordakademie Organizer & Room Assistant) ist eine umfassende Web-Plattform, die speziell für Studierende der Nordakademie entwickelt wurde. Die Anwendung vereint alle wichtigen organisatorischen Tools in einer intuitiven, modernen Oberfläche und macht das Studentenleben deutlich einfacher.
Unsere Vision ist es, den Studienalltag an der Nordakademie durch intelligente Digitalisierung zu vereinfachen. NORA bietet nicht nur Zugriff auf wichtige Informationen wie Stundenpläne und Raumbelegungen, sondern fördert auch die Vernetzung unter Studierenden und ermöglicht eine bessere Organisation des akademischen Lebens.
NORA entstand aus dem Bedürfnis heraus, die verschiedenen organisatorischen Aspekte des Studiums an der Nordakademie zu zentralisieren. Anstatt zwischen verschiedenen Systemen und Plattformen zu wechseln, bietet NORA eine einheitliche Lösung für:
- Stundenplanverwaltung: Übersichtliche Darstellung aller Veranstaltungen mit Zeitangaben, Räumen und Dozenten
- Raumplanung: Interaktive Gebäudepläne mit Echtzeitinformationen zur Raumbelegung
- Prüfungsorganisation: Verwaltung und Übersicht über anstehende Klausuren
- Soziale Vernetzung: Freundeslisten und gemeinsame Stundenplanansichten
- Kalenderintegration: Export und Synchronisation mit externen Kalendern
- Personalisierte Ansicht: Automatische Filterung nach Zenturie
- Zeitbereichsauswahl: Flexible Darstellung von 0-24 Uhr
- Freundschafts-Feature: Einsicht in Stundenpläne von Kommilitonen
- Custom Hours: Eigene Termine und Veranstaltungen hinzufügen
- Raumsuche: Schnelles Finden freier Räume für bestimmte Zeitslots
- Gebäudeübersicht: Detaillierte Pläne für alle Nordakademie-Gebäude
- Stockwerksnavigation: Etagenweise Ansicht mit Raumdetails
- Rauminformationen:
- Raumnummer und Name
- Aktuelle Belegung
- Nächste Veranstaltung
- Kapazität und Ausstattung
- Such- und Filterfunktion: Schnelles Auffinden spezifischer Räume
- Echtzeit-Belegungsstatus: Sofortige Übersicht über freie Räume
- Klausurübersicht: Chronologische Auflistung anstehender Prüfungen
- Intelligente Eingabe:
- Autocomplete für Modulnummern
- Autocomplete für Kursnamen
- Automatische Synchronisation beider Felder
- Prüfungsdetails:
- Datum und Uhrzeit
- Dauer
- Raum
- Kurs und Modulnummer
- Countdown: Anzeige der verbleibenden Zeit bis zur Klausur
- Freundesliste: Verwaltung von Kontakten innerhalb der Plattform
- Stundenplan-Sharing: Einsicht in die Zeitpläne von Freunden
- Zenturien-Anzeige: Übersicht über die Zenturien aller Freunde
- Validierung: Nur @nordakademie.de E-Mail-Adressen
- Webcal-Export: Automatischer Import in alle gängigen Kalender-Apps
- iCal-Download: Manuelle Kalender-Integration
- Plattform-Support:
- Apple Kalender (macOS, iOS)
- Google Kalender
- Microsoft Outlook
- Andere iCal-kompatible Anwendungen
- Automatische Updates: Änderungen werden in Echtzeit synchronisiert
- Schnellsuche: Strg+K / Cmd+K für sofortigen Zugriff
- Kategorien:
- Kurse
- Räume
- Zenturien
- Dozenten
- Live-Ergebnisse: Sofortige Anzeige während der Eingabe
- Keyboard-Navigation: Vollständige Tastatursteuerung
- Responsive Design: Optimiert für Desktop, Tablet und Mobile
- Glassmorphism: Moderne, transparente Designelemente
- Gradient Accents: Farbverläufe im Nordakademie-Branding
- Dark Mode Ready: Vorbereitet für zukünftige Dark-Mode-Integration
- Accessibility: Barrierefreie Bedienung
- Performance: Optimierte Ladezeiten und flüssige Animationen
- HTML5 - Strukturierung der Anwendung
- CSS3 - Modernes Styling mit Glassmorphism
- JavaScript ES6+ - Clientseitige Logik und Interaktivität
- TailwindCSS 3.x - Utility-First CSS Framework via CDN
- Capacitor 7.x - Native Mobile App Wrapper (iOS & Android)
- Fetch API - HTTP-Requests und API-Kommunikation
- LocalStorage API - Client-Side Session Persistence
- DOM API - Dynamische UI-Updates
- Native Modules - Zugriff auf Device-Features via Capacitor
- Go 1.21+ - Hochperformante Backend-Sprache
- Fiber v2 - Express-inspiriertes Web Framework
- GORM - ORM für Datenbankzugriff
- PostgreSQL 14+ - Relationale Datenbank
- CORS Middleware - Cross-Origin Resource Sharing
- Logger Middleware - Request Logging
- JWT (golang-jwt/jwt/v5) - Token-basierte Authentifizierung
- bcrypt - Passwort-Hashing
- Godotenv - Environment Configuration
- RESTful API Design - Standardisierte Endpunkte
- Session Management - UUID-basierte Sessions
- Email Service - Transaktionale E-Mails
- Calendar Service - iCal/Webcal Generation
- Nginx - Reverse Proxy und Static File Server
- SSL/TLS - HTTPS mit Let's Encrypt
- Systemd - Service Management
- Git - Version Control
┌─────────────────────────────────────────────────────────────┐
│ Client Layer │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Browser │ │ iOS App │ │ Android App │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ └──────────────────┴─────────────────┘ │
│ │ │
└────────────────────────────┼────────────────────────────────┘
│ HTTPS
▼
┌─────────────────────────────────────────────────────────────┐
│ Nginx Reverse Proxy │
│ • SSL Termination │
│ • Static File Serving │
│ • Load Balancing │
└────────────────────────────┬────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Frontend (HTML/JS/Capacitor) │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Dashboard │ │ Stundenplan │ │ Raumplan │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Navbar │ │ Modals │ │ Auth │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
└────────────────────────────┬────────────────────────────────┘
│ REST API
▼
┌─────────────────────────────────────────────────────────────┐
│ Backend (Go/Fiber) │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ API Services │ │
│ │ • Auth Service • Schedule Service │ │
│ │ • User Service • Room Service │ │
│ │ • Exam Service • Friend Service │ │
│ │ • Calendar Service • Search Service │ │
│ └──────────────────────────┬──────────────────────────┘ │
│ │ │
│ ┌──────────────────────────▼──────────────────────────┐ │
│ │ Middleware Layer │ │
│ │ • Authentication • Logging • CORS │ │
│ └──────────────────────────┬──────────────────────────┘ │
│ │ │
└─────────────────────────────┼───────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ PostgreSQL Database │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Users │ │ Sessions │ │ Events │ │ Rooms │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Exams │ │ Friends │ │ Zenturien│ │ Courses │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
└─────────────────────────────────────────────────────────────┘
-- Benutzer und Authentifizierung
Users
├─ id (PK)
├─ email
├─ password_hash
├─ first_name
├─ last_name
├─ zenturie_id (FK)
└─ subscription_uuid
Sessions
├─ id (PK)
├─ user_id (FK)
├─ session_id (UUID)
└─ expires_at
-- Akademische Daten
Zenturien
├─ id (PK)
├─ name
└─ year
Courses
├─ id (PK)
├─ module_number
└─ name
Events
├─ id (PK)
├─ zenturie_id (FK)
├─ course_id (FK)
├─ room_id (FK)
├─ start_time
├─ end_time
└─ professor
Exams
├─ id (PK)
├─ user_id (FK)
├─ course_id (FK)
├─ exam_date
├─ duration
└─ room_id (FK)
-- Gebäude und Räume
Buildings
├─ id (PK)
├─ name
└─ code
Rooms
├─ id (PK)
├─ building_id (FK)
├─ room_number
├─ room_name
├─ floor
└─ capacity
-- Soziale Features
Friends
├─ id (PK)
├─ user_id (FK)
└─ friend_user_id (FK)
CustomHours
├─ id (PK)
├─ user_id (FK)
├─ title
├─ start_time
├─ end_time
├─ location
└─ location_typePOST /v1/register - Benutzerregistrierung
POST /v1/login - Login und Session-Erstellung
POST /v1/logout - Session beenden
POST /v1/reset-request - Passwort-Reset anfordern
POST /v1/reset-confirm - Passwort zurücksetzen
GET /v1/verify - E-Mail-Verifizierung
GET /v1/user/profile - Benutzerprofil abrufen
PUT /v1/user/profile - Profil aktualisieren
PUT /v1/user/zenturie - Zenturie setzen
GET /v1/zenturien - Alle Zenturien abrufen
GET /v1/schedule - Eigene Events abrufen
GET /v1/schedule/friend - Friend-Schedule abrufen
POST /v1/custom-hours - Custom Hour erstellen
GET /v1/custom-hours - Custom Hours abrufen
DELETE /v1/custom-hours/:id - Custom Hour löschen
GET /v1/rooms - Alle Räume abrufen
GET /v1/rooms/:id - Raumdetails abrufen
GET /v1/rooms/free - Freie Räume finden
GET /v1/exams - Eigene Klausuren abrufen
POST /v1/exams - Klausur erstellen
DELETE /v1/exams/:id - Klausur löschen
GET /v1/friends - Freundesliste abrufen
POST /v1/friends - Freund hinzufügen
DELETE /v1/friends/:id - Freund entfernen
GET /v1/search - Globale Suche
GET /v1/courses - Alle Kurse abrufen
GET /v1/calendar/subscribe/:uuid - iCal-Feed abrufen
Alle geschützten Endpunkte erfordern eine gültige Session-ID, die als Query-Parameter session_id oder im Body übergeben wird.
- Login mit E-Mail und Passwort
- Backend generiert UUID-Session und speichert sie
- Client erhält Session-ID und speichert sie im LocalStorage
- Bei jedem Request wird Session-ID mitgesendet
- Backend validiert Session und prüft Ablaufdatum
Alle API-Antworten folgen einem einheitlichen Schema:
Erfolg (200 OK)
{
"data": { ... },
"message": "Success"
}Fehler (4xx, 5xx)
{
"error": "Error message",
"detail": "Detailed error description"
}Aktuell gibt es kein Rate Limiting, dies ist für zukünftige Versionen geplant.
NORA wurde entwickelt von einem engagierten Team von Nordakademie-Studierenden:
- @wielauritz - Frontend Development, UI/UX Design
- @FinnK04 - Backend Development, Database Design
- @aylinbmp - Design, Concept
- @V3rkz - Testing
Dieses Projekt entstand im Rahmen des NORDAKADEMIE Hackathon 2025 und wird seitdem kontinuierlich weiterentwickelt.
Wir freuen uns über Beiträge zur Verbesserung von NORA!
- Fork das Repository
- Erstelle einen Feature-Branch (
git checkout -b feature/AmazingFeature) - Commit deine Änderungen (
git commit -m 'Add some AmazingFeature') - Push zum Branch (
git push origin feature/AmazingFeature) - Erstelle einen Pull Request
- Klare Beschreibung: Erkläre ausführlich, was der PR macht und warum
- Kleine, fokussierte Änderungen: PRs sollten eine spezifische Funktion/Bugfix adressieren
- Code-Qualität: Halte dich an den bestehenden Code-Stil
- Tests: Stelle sicher, dass bestehende Funktionalität nicht beeinträchtigt wird
- Dokumentation: Aktualisiere die README, falls notwendig
Alle Pull Requests werden von den Core-Entwicklern intensiv geprüft:
- Code Review: Überprüfung auf Qualität und Best Practices
- Funktionstest: Validierung der implementierten Features
- Security Review: Prüfung auf potenzielle Sicherheitslücken
- Performance Check: Analyse der Performance-Auswirkungen
Wichtig: Pull Requests werden nur akzeptiert, wenn sie einen echten Mehrwert bieten und den Qualitätsstandards entsprechen. Die finale Entscheidung liegt bei den Core-Entwicklern.
- Nutze die GitHub Issues für Bug Reports und Feature Requests
- Bug Reports sollten enthalten:
- Beschreibung des Problems
- Schritte zur Reproduktion
- Erwartetes vs. tatsächliches Verhalten
- Screenshots (falls relevant)
- Browser/System-Informationen
- Feature Requests sollten enthalten:
- Use Case und Motivation
- Vorgeschlagene Implementierung
- Mögliche Alternativen
Copyright © 2025 NORA Development Team
Dieses Projekt ist unter einer proprietären Source-Available Lizenz veröffentlicht.
✅ Erlaubt:
- Einsehen des Quellcodes
- Eigene Kopien für persönliche, nicht-kommerzielle Zwecke
- Beiträge über Pull Requests
❌ Nicht erlaubt ohne schriftliche Genehmigung:
- Kommerzielle Nutzung
- Weiterverbreitung
- Modifikation für andere Projekte
- Verwendung in anderen Produkten oder Services
Für die vollständige Lizenz siehe LICENSE Datei.
Für Anfragen bezüglich kommerzieller Nutzung oder spezieller Lizenzen, kontaktiere bitte die Core-Entwickler.
Für Fragen, Anregungen oder Support:
- E-Mail Adresse: team@nora-nak.de
- GitHub Issues: @wielauritz/nora/issues
- Pull Requests: @wielauritz/nora/pulls
Entwickelt mit ❤️ für die NORDAKADEMIE
Website • GitHub • Report Bug