Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Bryacg/Adutem/llms.txt

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

ADUTEM requiere Node.js, PostgreSQL y npm para funcionar. Esta guía cubre la instalación completa del entorno: desde los prerrequisitos hasta tener la aplicación lista tanto en modo desarrollo como en producción.

​
Prerrequisitos

Antes de comenzar, asegúrate de tener instalado lo siguiente en tu máquina:
  • Node.js 18 o superior — el proyecto usa Next.js 15 que requiere Node.js 18+
  • PostgreSQL — base de datos relacional utilizada por Prisma
  • npm — gestor de paquetes incluido con Node.js
Verifica que tienes las versiones correctas ejecutando: 
node --version
psql --version
npm --version
1

Clonar el repositorio

Clona el repositorio de ADUTEM y accede al directorio del proyecto:
git clone https://github.com/Bryacg/Adutem.git
cd Adutem
2

Instalar dependencias

Instala todas las dependencias del proyecto. Puedes usar npm, yarn o pnpm:
npm install
Esto instalará Next.js 15, Prisma Client, React 19, MUI, react-hook-form, bcrypt, Tailwind CSS y el resto de las dependencias definidas en package.json.
3

Configurar las variables de entorno

Crea el archivo .env en la raíz del proyecto. El único valor requerido para arrancar es DATABASE_URL:
DATABASE_URL="postgresql://usuario:contraseña@localhost:5432/adutem"
Debes definir DATABASE_URL correctamente antes de ejecutar cualquier migración de Prisma. Si este valor no está configurado o apunta a una base de datos inaccesible, el comando npx prisma migrate dev fallará.
Ajusta el host, el puerto, el nombre de la base de datos y las credenciales según tu instalación de PostgreSQL.
4

Configurar la base de datos con Prisma

Aplica las migraciones para crear el esquema completo de la base de datos:
npx prisma migrate dev
Este comando crea las tablas: persona, usuario, convenios, horario, cursos, areas_recreativas, pagos, reservas e inscripciones.Si necesitas regenerar el cliente de Prisma sin ejecutar migraciones:
npx prisma generate
5

Ejecutar la aplicación

Usa los siguientes comandos según el entorno:Desarrollo
npm run dev
El comando npm run dev utiliza Turbopack (next dev --turbopack), el nuevo bundler de Next.js que ofrece compilaciones incrementales más rápidas durante el desarrollo.
ProducciónPrimero compila la aplicación y luego iníciala:
npm run build
npm start
La aplicación queda disponible en http://localhost:3000.

​
Scripts disponibles

Los siguientes scripts están definidos en package.json:
ComandoDescripción
npm run devInicia el servidor de desarrollo con Turbopack en http://localhost:3000
npm run buildCompila la aplicación para producción
npm startInicia el servidor en modo producción (requiere ejecutar build primero)
npm run lintEjecuta ESLint sobre el código fuente

Build docs developers (and LLMs) love

Get started for freeTalk to us