Skip to content

ProCoders-ISPC/ProfeSort

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

474 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

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.

Resources

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors