Corp/README.de.md
2026-06-17 16:54:08 +03:00

3.0 KiB

Sprache: English | Русский | Deutsch | Español

EUSRR

EUSRR ist ein internes Enterprise-Service-Portal, entwickelt mit Django, Django REST Framework, Next.js, PostgreSQL, Redis, Celery, WebSockets, LDAP-Integration, Benachrichtigungen, Dokumenten-Workflows, Beschaffungsprozessen, Planung und Employee-Self-Service-Modulen.

Das Projekt zeigt Full-Stack-Produktentwicklung: Backend-Architektur, REST APIs, rollenbasierte Zugriffskontrolle, asynchrone Aufgaben, Echtzeit-Updates, Frontend-Struktur, Tests, deployment-orientierte Konfiguration und produktionsnahe Betriebsdokumentation.

Kernmodule

  • Mitarbeiterverzeichnis, Profile, Abteilungen, Rollen und LDAP-Synchronisierung.
  • Anträge und Freigabe-Workflows mit Statusverfolgung und Benachrichtigungen.
  • Beschaffungsprozesse, Freigaberouten, Artikelverwaltung und Lieferstatus.
  • Dokumente, Dateien, Kommentare und interne Zusammenarbeit.
  • Kalender- und Planungsfunktionen mit gemeinsamen Ereignissen.
  • Echtzeitkommunikation, WebSocket-Benachrichtigungen und Chat-Workflows.
  • LogStorm-Integration für operative Anwesenheitsanalysen.

Tech Stack

  • Backend: Python, Django, Django REST Framework, Channels, Celery, Redis, PostgreSQL.
  • Frontend: Next.js, React, TypeScript, Tailwind CSS, Recharts, React Table.
  • Integrationen: LDAP, Web Push, Telegram/Synology-style notification adapters, LogStorm API.
  • Testing: pytest für Backend-Tests, Node test runner und ESLint für Frontend-Checks.
  • Deployment: Docker-orientierte Einstellungen, umgebungsbasierte Konfiguration, Nginx-ready service layout.

Repository-Struktur

backend/   Django backend, APIs, Celery tasks, migrations, tests, docs
frontend/  Next.js frontend application
docs/      Architecture notes, implementation reports, guides, diagnostics

Lokales Setup

Backend:

cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp ../.env.example ../.env
python manage.py migrate
python manage.py runserver

Frontend:

cd frontend
npm install
cp .env.example .env.local
npm run dev

Das Frontend ist unter http://localhost:3000 erreichbar. NEXT_PUBLIC_BACKEND_URL muss auf das Backend zeigen.

Tests

Backend:

cd backend
pytest

Frontend:

cd frontend
npm test
npm run lint
npm run build

Security Notes

Diese öffentliche Version ist als Portfolio-Snapshot vorbereitet. Environment-Dateien, lokale Datenbanken, Media Uploads, Zertifikate, private keys, generierte Builds und deployment-spezifische Artefakte sind aus der Versionskontrolle ausgeschlossen.

Alle Zugangsdaten müssen über Environment Variables bereitgestellt werden. Beispiel-Dateien enthalten nur Platzhalter und dürfen nicht als Production Secrets verwendet werden.

Demo Data

Das Repository enthält keine Produktionsdaten. Unternehmensspezifische Werte sollten vor dem Betrieb außerhalb der ursprünglichen Umgebung durch lokale Demo-Daten ersetzt werden.