Providentia Network
Python

Providentia Network

Providentia Network: un backend basato su Django con un database persistente, che esegue simultaneamente bot Discord e Telegram. Si integra con servizi esterni come Google e sistemi accademici universitari per ragionamenti e azioni avanzate.

Rete Providentia è un progetto Django + frontend che ospita il sistema di ragionamento/automazione "Providentia".

Questo repository contiene un backend Django (in providentia/ e manage.py) e un frontend realizzato con Vite + React (in src/ e package.json).

Avvio rapido

  1. Creare e attivare un ambiente virtuale Python:

    python -m venv .venv
    source .venv/bin/activate
    
  2. Installare le dipendenze Python:

    pip install -r requirements.txt
    
  3. Installare le dipendenze del frontend:

    npm install
    
  4. Avviare il server di sviluppo Django:

    python manage.py migrate
    python manage.py runserver
    
  5. (Opzionale) Avviare il server di sviluppo del frontend:

    npm run dev
    

Struttura del repository (livello alto)

  • providentia/ - Modulo del progetto Django (impostazioni, url, wsgi/asgi)
  • manage.py - Wrapper di gestione Django
  • outdated/ - Script legacy (archiviati). Vedere archive/ per le copie
  • Data/, Modules/, Assets/ - Moduli del progetto e asset statici
  • src/ - Codice sorgente del frontend (React + Vite)

Note

  • Alcuni file legacy si trovano in outdated/. Una copia è stata inserita in archive/ come riferimento.
  • Mantenere i segreti fuori dal repository. Utilizzare un file .env (già presente) e assicurarsi che .env sia in .gitignore.

Prossimi passi

  • Aggiungere documentazione per sviluppatori specifica del progetto (endpoint, variabili d'ambiente)
  • Aggiungere test per i moduli principali e un job CI