Providentia Network
Python

Providentia Network

Providentia Network: Zaplecze oparte na Django z trwałą bazą danych, jednocześnie uruchamiające boty Discord i Telegram. Integruje się z zewnętrznymi usługami, takimi jak Google i uniwersyteckie systemy akademickie, w celu zaawansowanego rozumowania i działań.

GitHub

Sieć Providentia to projekt Django + frontend, który hostuje system rozumowania/automatyzacji "Providentia".

To repozytorium zawiera backend Django (w providentia/ i manage.py) oraz frontend zbudowany z Vite + React (w src/ i package.json).

Szybki start

  1. Utwórz i aktywuj wirtualne środowisko Pythona:

    python -m venv .venv
source .venv/bin/activate

  2. Zainstaluj zależności Pythona:

    pip install -r requirements.txt

  3. Zainstaluj zależności frontendu:

    npm install

  4. Uruchom serwer deweloperski Django:

    python manage.py migrate
python manage.py runserver

  5. (Opcjonalnie) Uruchom serwer deweloperski frontendu:

    npm run dev

Struktura repozytorium (ogólna)

  • providentia/ - moduł projektu Django (ustawienia, adresy URL, wsgi/asgi)
  • manage.py - wrapper zarządzania Django
  • outdated/ - przestarzałe skrypty (zarchiwizowane). Kopie znajdują się w archive/
  • Data/, Modules/, Assets/ - moduły projektu i zasoby statyczne
  • src/ - kod źródłowy frontendu (React + Vite)

Uwagi

  • Niektóre przestarzałe pliki znajdują się w outdated/. Ich kopie umieszczono w archive/ w celach referencyjnych.
  • Nie przechowuj sekretów w repozytorium. Użyj pliku .env (już istnieje) i upewnij się, że .env znajduje się w .gitignore.

Kolejne kroki

  • Dodaj dokumentację deweloperską specyficzną dla projektu (endpointy, zmienne środowiskowe)
  • Dodaj testy dla głównych modułów oraz zadanie CI