Bitfive (DevOps Project) 5.0.0v

Monorepo fullstack compuesto por un backend REST en Node.js + TypeScript + Express 5 + PostgreSQL y un frontend en Vite + React. El proyecto implementa un sistema completo de autenticación y autorización basado en roles y permisos, con una arquitectura modular en capas y un ORM personalizado construido desde cero.

Que se puede hacer hoy

• Registrar usuarios (wizard de 5 pasos con carga de imagen a Firebase).
• Iniciar y cerrar sesion (JWT + cookie HTTP-only).
• Administrar usuarios: listar, ver detalles, autorizar/desautorizar, asignar roles, eliminar.
• Administrar roles: crear, editar, activar/desactivar, asignar permisos, eliminar.
• Consultar permisos: listado con filtros por tipo.
• Proteger rutas del frontend por roles y permisos.
• Tema claro/oscuro.
• Crear y administrar eventos
• Inscribirse y desinscribirse a eventos
• Ver eventos inscritos
• Ver eventos creados
• Ver inscripciones

Equipo de trabajo

Integrante	Rol	Descripción
Wilman Cabana	Full-Stack Developer	Desarrolla e integra funcionalidades frontend y backend del sistema.
Cristian Peña	Backend Developer	Diseña e implementa servicios, APIs, lógica de negocio y gestión de datos.
Martín Pallares	Full-Stack Developer & DevOps Lead	Lidera la integración, despliegue, automatización e infraestructura DevOps, además de apoyar el desarrollo full-stack.
Cristian Barrera	Backend Developer & QA Engineer	Desarrolla componentes backend y realiza aseguramiento de calidad mediante pruebas y validación.

Requisitos previos

Herramienta	Version minima
Node.js	18 LTS
npm	9+
PostgreSQL	14+

Quick Start

# 1. Clonar e instalar
git clone <url-del-repo> && cd bitfive
npm install --prefix api
npm install --prefix app

# 2. Configurar backend
cp api/.env.example api/.env
# Edita api/.env con tus credenciales de PostgreSQL (ver api/README.md)

# 3. Crear la base de datos
createdb bitfive

# 4. Levantar (dos terminales)
npm run dev --prefix api   # http://localhost:3000/api/v1
npm run dev --prefix app   # http://localhost:5173

Verificar que funciona

• Backend: abre http://localhost:3000/api/v1/auth/health y espera un JSON con "status": "ok".
• Frontend: abre http://localhost:5173 y deberia cargar la pantalla de login.

Estructura del Monorepo

bitfive/
├── api/          # Backend — Express 5, TypeScript, ORM custom, PostgreSQL
│   └── src/
│       ├── core/     # Framework: ORM, router, decoradores, DI, middlewares
│       └── auth/     # Modulo de auth: controladores, servicios, entidades, repos
├── app/          # Frontend — React 18, Vite, React Router
│   └── src/
│       ├── core/     # Componentes, contextos, hooks, servicios y estilos compartidos
│       └── modules/  # auth (login/registro) y panel (dashboard, usuarios, roles)
└── README.md

La carpeta shared/ no existe aun; esta reservada para codigo compartido si el equipo decide crearla.

Scripts por proyecto

Backend (api/)

Comando	Descripcion
npm run dev	Desarrollo con hot-reload (tsx)
npm run build	Compila TypeScript a dist/
npm start	Ejecuta build de produccion

Frontend (app/)

Comando	Descripcion
npm run dev	Servidor de desarrollo con HMR
npm run build	Build de produccion
npm run preview	Preview del build
npm run lint	ESLint

Ejecucion simultanea

Sin herramientas extra (dos terminales):

# Terminal 1
npm run dev --prefix api

# Terminal 2
npm run dev --prefix app

Con una sola terminal:

npx concurrently "npm run dev --prefix api" "npm run dev --prefix app"

Documentacion detallada

• api/README.md — variables de entorno, base de datos, endpoints de auth.
• app/README.md — servidor de desarrollo, AuthContext, configuracion de API.