Skip to content

README.md

Latest commit

 

History

History
211 lines (153 loc) · 6.66 KB

README.md

File metadata and controls

211 lines (153 loc) · 6.66 KB
Raw

ProfeSort

Descripción del proyecto:

ProfeSort es un sistema de gestión digital integral diseñado para el Plan de Finalización de Estudios (FinEs). Su objetivo principal es optimizar los procesos administrativos y académicos, mejorando la eficiencia en la gestión de estudiantes, docentes y materias, y facilitando la toma de decisiones a partir de datos confiables. Este sistema busca elevar la calidad del servicio educativo ofrecido y modernizar la administración del plan.

Funcionalidades Principales (Primera Etapa)

El sistema está siendo desarrollado por etapas. En esta primera fase se busca implementar funcionalidades esenciales, entre ellas:

  • Visualización pública de un sitio web responsive con secciones de inicio, login/registro y sobre nosotros.

  • Gestión de materias: registro de materias y su asociación.

  • Asignación de materias a los docentes correspondientes.

  • Visualización de métricas básicas desde un panel de administración-/li><
  • Acceso para docentes, quienes podrán registrarse y visualizar sus materias a cargo.

Estado del Proyecto:

Maqueta estática:

html5 logo css3 logo

Frontend:

typescript logo angularjs logo

Backend:

python logo django logo

Base de Datos:

python logo

Instrucciones para probar el proyecto

Para ejecutar ProfeSort se detallan los pasos de instalación y ejecución:

Instalación y Ejecución Local

Sigue estos pasos para configurar y levantar el servidor backend en tu entorno de desarrollo.

1. Preparación del Entorno

  1. Navega al directorio del proyecto backend:

    cd backend

  2. Crea y activa un entorno virtual (recomendado para aislar dependencias):

    python -m venv venv
    venv\Scripts\activate

  3. Instala las dependencias de Python:

    pip install -r requirements.txt

2. Configuración de la Base de Datos

  1. Crea el archivo de variables de entorno .env en el directorio backend/ y configúralo con tus credenciales de PostgreSQL.

    DB_NAME=profesort_db
DB_USER=postgres
DB_PASSWORD=tu_password  # Coloca tu contraseña real de PostgreSQL
DB_HOST=localhost
DB_PORT=5432

SECRET_KEY=tu_secret_key # Generás una clave segura
DEBUG=True

  2. Crea la base de datos PostgreSQL (ejecuta esto en tu cliente de base de datos, como pgAdmin o psql):

    CREATE DATABASE profesort_db;

3. Inicialización del Sistema

  1. Ejecuta las migraciones de Django para crear las tablas:

    python manage.py makemigrations
python manage.py migrate

  2. Inicializa los datos base (roles y un usuario administrador):

    python init_data.py

4. Ejecutar el Servidor

Inicia el servidor de desarrollo de Django:

python manage.py runserver

2. Frontend (Angular)

El frontend es la aplicación web que interactúa con la API.

2 Instalación y Ejecución

  1. Abre una nueva terminal y navega al directorio frontend: 
    cd frontend
  2. Instala las dependencias de Node.js (asegúrate de tener Node.js y npm instalados): 
    npm install
  3. Inicia el servidor de desarrollo y abre la aplicación: 
    ng serve -o

    La aplicación se abrirá automáticamente (usualmente en http://localhost:4200), y ya podrás ver la interfaz visual.

🏃 Flujo de Trabajo (Demostración)

Una vez que ambos servidores (Backend y Frontend) están corriendo, puedes simular el flujo de trabajo inicial del sistema:

  1. Inicio de Sesión como Administrador:
    • Ingresa a la aplicación web (Frontend) e inicia sesión con las credenciales:

      User: admin@profesort.com

      Contraseña: Admin123456


    • Desde el panel, navega a la sección de Materias y Crea una nueva Materia (ej. "Historia").
  2. Registro de un Nuevo Docente:
    • Cierra la sesión del administrador.
    • Utiliza la opción de Registro en la interfaz para crear una cuenta nueva. Esta cuenta representará a un nuevo Docente.
  3. Asignación de Materia (Administrador):
    • Vuelve a iniciar sesión como administrador.
    • Desde el panel, navega a la sección de Asignación Docente-Materia y Asigna la Materia que creaste (ej. "Historia") al Docente que acabas de registrar.
  4. Verificación Docente:
    • Cierra la sesión del administrador.
    • Inicia sesión como el Docente recién registrado.
    • El docente podrá ver la Materia Asignada ("Historia") en su panel materias.