Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Zapiony/PUCE_UZDI_2026/llms.txt

Use this file to discover all available pages before exploring further.

La plataforma UZDI es el sistema de gestión oficial para la Unidad de Sustentabilidad y Desarrollo Integral (UZDI) de la Pontificia Universidad Católica del Ecuador (PUCE). Centraliza el seguimiento de adolescentes con medidas socioeducativas a nivel nacional, desde el registro inicial hasta la generación de reportes estadísticos.

Quick Start

Levanta el frontend y backend en minutos con Node.js y PostgreSQL.

Architecture

Vue 3 + NestJS + PostgreSQL — cómo encajan las tres capas.

API Reference

Endpoints REST documentados con parámetros, respuestas y ejemplos cURL.

User Guide

Guías de uso de cada módulo para técnicos, coordinadores y administradores.

¿Qué cubre este sistema?

El sistema UZDI maneja el ciclo completo de atención a adolescentes infractores:

Adolescentes

Registro y CRUD completo de perfiles de adolescentes con datos demográficos, etnia, nacionalidad y asignación a técnicos.

Expedientes

Gestión de expedientes con numeración automática EXP-YYYY-NNNN, documentos adjuntos y seguimiento de estados.

Medidas

Creación y seguimiento de medidas socioeducativas con barras de progreso y alertas de revisión próxima.

Reportes

Cinco tipos de reporte con filtros por período, zona UZDI y exportación PDF/Excel.

Usuarios

Administración de cuentas con roles: Técnico, Coordinador, Administrador y Superadministrador.

Parámetros

Configuración institucional: organización, seguridad y notificaciones.

Primeros pasos

1

Instala las dependencias

Clona el repositorio e instala las dependencias del frontend y backend por separado.
cd UZDI_FRONT && npm install
cd ../UZDI_BACK && npm install
2

Configura la base de datos

Crea la base de datos PostgreSQL y ejecuta el DDL incluido en el repositorio.
psql -U postgres -c "CREATE DATABASE uzdi_db;"
psql -U postgres -d uzdi_db -f DDL_UZDI_FINAL.sql
3

Define las variables de entorno

Crea el archivo .env en UZDI_BACK/ con la cadena de conexión a PostgreSQL.
DATABASE_URL=postgresql://usuario:contraseña@localhost:5432/uzdi_db
PORT=3000
4

Levanta los servidores

Inicia backend y frontend en terminales separadas.
# Terminal 1 — Backend
cd UZDI_BACK && npm run start:dev

# Terminal 2 — Frontend
cd UZDI_FRONT && npm run dev
El frontend queda disponible en http://localhost:5174 y el backend en http://localhost:3000.
El backend utiliza synchronize: false en TypeORM — la estructura de la base de datos se crea exclusivamente mediante el archivo DDL_UZDI_FINAL.sql. No ejecutes synchronize: true en producción.

Build docs developers (and LLMs) love