Providentia Network
Python

Providentia Network

Providentia Network: Ein Django-betriebenes Backend mit einer persistenten Datenbank, das gleichzeitig Discord- und Telegram-Bots betreibt. Integriert externe Dienste wie Google und universitäre akademische Systeme für erweiterte Überlegungen und Aktionen.

Providentia Network ist ein Django + Frontend-Projekt, das das „Providentia“-Reasoning-/Automatisierungssystem hostet.

Dieses Repository enthält ein Django-Backend (in providentia/ und manage.py) und ein mit Vite + React erstelltes Frontend (in src/ und package.json).

Schnellstart

  1. Erstellen und aktivieren Sie eine Python-Virtual-Umgebung:

    python -m venv .venv
    source .venv/bin/activate
    
  2. Installieren Sie die Python-Abhängigkeiten:

    pip install -r requirements.txt
    
  3. Installieren Sie die Frontend-Abhängigkeiten:

    npm install
    
  4. Starten Sie den Django-Entwicklungsserver:

    python manage.py migrate
    python manage.py runserver
    
  5. (Optional) Starten Sie den Frontend-Entwicklungsserver:

    npm run dev
    

Repository-Struktur (Überblick)

  • providentia/ - Django-Projektmodul (Einstellungen, URLs, WSGI/ASGI)
  • manage.py - Django-Verwaltungswrapper
  • outdated/ - Legacy-Skripte (archiviert). Siehe archive/ für Kopien
  • Data/, Modules/, Assets/ - Projektmodule und statische Assets
  • src/ - Frontend-Quellcode (React + Vite)

Hinweise

  • Einige Legacy-Dateien befinden sich unter outdated/. Eine Kopie wurde zu Referenzzwecken in archive/ abgelegt.
  • Halten Sie Geheimnisse aus dem Repository fern. Verwenden Sie eine .env-Datei (bereits vorhanden) und stellen Sie sicher, dass .env in .gitignore eingetragen ist.

Nächste Schritte

  • Projektspezifische Entwicklerdokumentation hinzufügen (Endpunkte, Umgebungsvariablen)
  • Tests für Kernmodule und einen CI-Job hinzufügen