Avaluo Backend

Sistema de Gestion de Avaluo de Desempeno — Backend API

---

Descripcion

Avaluo es una plataforma de gestion academica orientada al avaluo de desempeno universitario. Facilita la evaluacion de competencias, Student Outcomes (SO) y Performance Indicators (PI) mediante rúbricas digitales, generacion automatica de informes en PDF y dashboards de seguimiento para coordinadores de carrera.

Este repositorio contiene el Backend API del sistema, desarrollado como parte de una tesis de grado en colaboracion con INTEC bajo los estandares de acreditacion ABET.

Repositorio original: Tejanin/AvaluoBackend
Frontend (privado): siriuzz/AvaluoUI
Prototipo de diseño: Figma

---

Caracteristicas principales

🔐 Auth JWT + Roles	Autenticacion y autorizacion con tokens JWT y permisos por roles.
📋 Rúbricas, SO y PI	Gestion completa de rúbricas, Student Outcomes y Performance Indicators.
📊 Dashboards	Resumenes de desempeno por carrera y periodo académico.
📄 Informes PDF	Generacion automatica de informes con IronPDF y vistas Razor.
🔗 Integracion INTEC	Sincronizacion de datos con sistemas externos de la institucion.
⚡ Cache Redis	Cache distribuido para optimizacion de lecturas frecuentes.
⏰ Jobs Quartz	Tareas programadas para procesos recurrentes y mantenimiento.
🏗️ Arquitectura DDD	Capas separadas (Presentation, Application, Domain, Infrastructure).

---

Stack tecnologico

Capa	Tecnologia
Framework	.NET 8 Web API
ORM / Micro-ORM	Entity Framework Core 9 + Dapper
Base de datos	Microsoft SQL Server
Cache	Redis (StackExchange.Redis)
Autenticacion	JWT Bearer + Cookies seguras
Documentacion API	Swagger + Swashbuckle
Generacion PDF	IronPDF
Mapeo	Mapster
Jobs	Quartz.NET
Contenedores	Docker Compose (Redis)

---

Arquitectura

flowchart TD
    Client["Cliente / Frontend"] -->|HTTP + JWT| Presentation["📡 Presentation Layer<br/>Controllers + ViewModels"]
    Presentation -->|DTOs + Requests| Application["⚙️ Application Layer<br/>Services + Middlewares"]
    Application -->|Entities + Commands| Domain["🧠 Domain Layer<br/>Entidades + Reglas de Negocio"]
    Application -->|Abstracciones| Infrastructure["💾 Infrastructure Layer<br/>EF Core / Dapper / Redis / Auth / Jobs"]
    Domain -.->|Implementa| Infrastructure

    style Presentation fill:#e1f5fe
    style Application fill:#fff3e0
    style Domain fill:#e8f5e9
    style Infrastructure fill:#fce4ec

Loading

• Presentation: Controladores REST, ViewModels y filtros de validacion.
• Application: Servicios de aplicacion, DTOs, middlewares de excepcion y autenticacion.
• Domain: Entidades, value objects y reglas de negocio puras.
• Infrastructure: Persistencia (EF Core + Dapper), cache Redis, autenticacion JWT, integraciones INTEC y jobs Quartz.

Para mas detalles, consulta la documentacion completa o el archivo CONTRIBUTING.md.

---

Contributors

---

Capturas y Demo

El backend expone una API REST documentada con Swagger. A continuacion, una demostracion del sistema en accion: Ver demo en YouTube

Screenshots

Documentacion interactiva de la API con Swagger UI

Interfaz del cliente conectado al backend

Generacion automatica de informes en PDF

• Swagger UI: https://localhost:8000 (al ejecutar localmente)
• Documentacion tecnica: GitHub Pages

---

Requisitos previos

• .NET 8 SDK
• Docker Desktop (para Redis)
• SQL Server (local o remoto)

---

Como ejecutar localmente

1. Clonar el repositorio

git clone https://github.com/RayfelO/AvaluoBackend.git
cd AvaluoBackend

2. Levantar Redis

docker-compose up -d

3. Configurar secrets

Copia el archivo de ejemplo y completa los valores necesarios:

cp AvaluoAPI/appsettings.example.json AvaluoAPI/appsettings.json

Ajusta las ConnectionStrings y las claves de Jwt, Email e IronPdf.

4. Ejecutar la API

cd AvaluoAPI
dotnet run

La API estara disponible en:

• API: https://localhost:8000
• Swagger UI: https://localhost:8000 (raiz)

---

Estructura del proyecto

AvaluoBackend/
├── AvaluoAPI/
│   ├── Presentation/
│   │   └── Controllers/
│   ├── Application/
│   │   ├── Services/
│   │   └── DTOs/
│   ├── Domain/
│   │   ├── Entities/
│   │   └── Services/
│   └── Infrastructure/
│       ├── Persistence/
│       ├── Integrations/
│       └── Data/
├── docker-compose.yml
├── docs/
└── assets/

---

Documentacion

La documentacion tecnica del proyecto esta disponible via GitHub Pages:

Ver documentacion →

Tambien puedes consultar:

• CONTRIBUTING.md — Estandares de codigo, flujo Git y estructura de carpetas.
• docs/ — Fuente de la documentacion en GitHub Pages.

---

Licencia

Este proyecto esta licenciado bajo la Licencia MIT.

---

Desarrollado como tesis de grado. Fork del proyecto original con mejoras y documentacion adicional.