Providentia Network
Python

Providentia Network

Providentia Network: Un backend impulsado por Django con una base de datos persistente, que ejecuta simultáneamente bots de Discord y Telegram. Se integra con servicios externos como Google y sistemas académicos universitarios para razonamiento y acciones avanzadas.

Red Providentia es un proyecto Django + frontend que aloja el sistema de razonamiento/automatización "Providentia".

Este repositorio contiene un backend Django (en providentia/ y manage.py) y un frontend construido con Vite + React (en src/ y package.json).

Inicio rápido

  1. Crea y activa un entorno virtual de Python:

    python -m venv .venv
    source .venv/bin/activate
    
  2. Instala las dependencias de Python:

    pip install -r requirements.txt
    
  3. Instala las dependencias del frontend:

    npm install
    
  4. Ejecuta el servidor de desarrollo de Django:

    python manage.py migrate
    python manage.py runserver
    
  5. (Opcional) Ejecuta el servidor de desarrollo del frontend:

    npm run dev
    

Estructura del repositorio (alto nivel)

  • providentia/ - Módulo del proyecto Django (configuraciones, urls, wsgi/asgi)
  • manage.py - Wrapper de administración de Django
  • outdated/ - Scripts heredados (archivados). Ver archive/ para copias
  • Data/, Modules/, Assets/ - Módulos del proyecto y activos estáticos
  • src/ - Código fuente del frontend (React + Vite)

Notas

  • Algunos archivos heredados se encuentran en outdated/. Se ha colocado una copia en archive/ como referencia.
  • Mantén los secretos fuera del repositorio. Usa un archivo .env (ya presente) y asegúrate de que .env esté en .gitignore.

Próximos pasos

  • Agregar documentación para desarrolladores específica del proyecto (endpoints, variables de entorno)
  • Agregar pruebas para los módulos principales y un trabajo de CI