PROSEGUIT v2

Sistema de Gestión de Inventario IT

PROSEGUIT reemplaza al sistema heredado "seguit v1" (PHP/MySQL). Gestiona equipos informáticos distribuidos en múltiples oficinas, con historial completo de movimientos, préstamos, envíos a servicio técnico y trazabilidad total de cada equipo.

Capturas de pantalla

Dashboard

Resumen ejecutivo con contadores en tiempo real, saludo personalizado según hora del día y feed de actividad reciente con acceso directo a cada equipo.

Listado de equipos

Tabla completa con búsqueda debounced, filtros en cascada (ciudad → sección → oficina), chips de filtros activos, columnas ordenables y paginación configurable con selector arriba y abajo.

Ficha de equipo

Datos del equipo, estado derivado por ubicación, acciones disponibles (SALIDA / ENTRADA / baja / servicio externo) y timeline completo de historial.

Árbol de ubicaciones

Árbol jerárquico Ciudad → Sección → Oficina con CRUD inline y panel lateral que muestra los equipos de la oficina seleccionada.

Historial global

Registro de auditoría completo con filtros por tipo de acción y rango de fechas. Badges de color por tipo de acción, click en fila navega al equipo.

Préstamos

Registro de préstamos por número de serie y devolución con identificación del funcionario solicitante.

Características principales

Módulo	Descripción
Inventario	Búsqueda debounced, filtros en cascada, ordenamiento, paginación configurable
Estado por ubicación	El estado del equipo se deriva del nombre de la oficina — sin inconsistencias de DB
Estado NUEVO	Equipos recién ingresados quedan en NUEVO hasta ser asignados a una oficina final
Historial de auditoría	Toda acción registra motivo, técnico, ubicación origen/destino y timestamp
Acciones de equipo	Transferir (SALIDA), enviar a soporte (ENTRADA), servicio externo, baja
Lógica de acciones	El tipo de acción en SALIDA se determina automáticamente según el estado del equipo
Préstamos	Salida y devolución con identificación de funcionario y técnico responsable
Licencias de software	CRUD completo, estado derivado (VIGENTE/POR_VENCER/VENCIDA), resumen por software, sección en ficha de equipo
Ubicaciones	Árbol 3 niveles (Ciudad › Sección › Oficina) con CRUD y panel de equipos
Dashboard en tiempo real	Contadores e historial se actualizan sin recargar la página tras cada acción
Plantillas de modelo	Especificaciones técnicas reutilizables, editor dinámico de pares clave-valor, asignación opcional a equipos
Selector de plantillas	Dropdown en formulario de equipos que filtra por tipo, muestra datos de referencia y auto-rellena el campo Modelo con el nombre de la plantilla
Servicios externos	Envío a reparación con proveedor, diagnóstico y fecha de retorno
Usuarios y roles	ADMIN gestiona todos los usuarios; TECNICO gestiona ubicaciones, plantillas y su propio usuario
Carga masiva	Creación de N equipos en un solo formulario: campos compartidos + series correlativas editables por fila, validación de duplicados y abort en primer error
Fotos de equipos	Galería de imágenes múltiples por equipo, subida directa desde móvil o escritorio
Auth JWT	Access token (15 min) + refresh token (7 días) con rotación automática
Seguridad	Security headers (X-Frame-Options, CSP, etc.), rutas admin protegidas

Stack tecnológico

Capa	Tecnología	Versión
Monorepo	npm workspaces	—
Backend	Express + TypeScript	5.2 / 5.9
ORM	Prisma + adapter pg	7.5
Base de datos	PostgreSQL (Docker)	17
Auth	JWT + bcryptjs	—
Validación	Zod — compartido front/back via `@proseguit/shared`	4.3
Frontend	React + TypeScript + Vite	19.2 / 5.9 / 8.0
Routing	React Router	7.13
Estado servidor	TanStack Query	5.94
UI	CSS Modules + nesting nativo + custom properties	—
Íconos	Lucide React	—
Logging	Pino (structured JSON) + request-id middleware	10.x
Tests	Vitest (67 tests, sin DB)	4.x
Dev	Docker Compose	—

Colores institucionales: Teal #00A79D · Navy #003366

Requisitos previos

Node.js v22 o superior
Docker Desktop (para PostgreSQL)
Git

Desarrollo local

Opción 1: Setup automático (recomendado)

# 1. Clonar el repositorio
git clone https://github.com/ramiroquesada/PROSEGUIT.git
cd PROSEGUIT

# 2. Ejecutar setup (crea .env, instala dependencias, levanta DB)
node setup.js

Opción 2: Setup manual (paso a paso)

# 1. Clonar el repositorio
git clone https://github.com/ramiroquesada/PROSEGUIT.git
cd PROSEGUIT

# 2. Copiar archivo de variables de entorno
cp .env.example .env
cp .env backend/.env

# 3. Instalar todas las dependencias (backend + frontend + shared)
npm install

# 4. Levantar la base de datos
npm run db:up

# 5. Aplicar migraciones
npm run db:migrate

# 6. Cargar usuarios iniciales
npm run db:seed

# 7. Iniciar servidores de desarrollo
npm run dev

Con migración de datos (seguit v1)

Si tienes un dump SQL de seguit v1 (db_seguit1.sql), reemplaza el paso 6 anterior:

# En lugar de npm run db:seed, ejecutar:
npm run migrate:v1

Este comando:

Extrae los datos del dump SQL
Detecta y repara automáticamente cualquier inconsistencia en la base de datos
Migra todos los equipos, historial, usuarios, ubicaciones, préstamos y servicios
Crea automáticamente usuarios con contraseña temporal

La aplicación estará disponible en:

Servicio	URL
Frontend	http://localhost:5173
Backend API	http://localhost:3001/api/v1

Credenciales por defecto (después de npm run db:seed):

Admin: 9999 / admin123
Técnico: 7844 / 7844

Comandos disponibles

# Desarrollo
npm run dev              # Backend (:3001) + Frontend (:5173) simultáneamente
npm run dev:backend      # Solo backend
npm run dev:frontend     # Solo frontend

# Tests (no requiere base de datos)
npm test                 # Corre los 67 tests del backend (Vitest)

# Base de datos
npm run db:up            # Levanta PostgreSQL en Docker (puerto 5433)
npm run db:down          # Detiene PostgreSQL
npm run db:migrate       # Aplica migraciones de Prisma
npm run db:studio        # Abre Prisma Studio (explorador visual)
npm run db:seed          # Crea usuarios admin (9999) y técnico (7844)

# Migración desde seguit v1
npm run migrate:v1       # Extrae, repara, valida e importa datos de db_seguit1.sql

Detalles de la migración v1

Requisitos:

Tener db_seguit1.sql en la raíz del proyecto
PostgreSQL corriendo: npm run db:up

Qué hace npm run migrate:v1:

Extrae datos del dump SQL a export_datos_v1.json
Detecta y repara automáticamente inconsistencias de schema (ej: enums mal aplicados)
Aplica migraciones pendientes
Limpia datos existentes (equipos, historial, usuarios, etc.)
Importa todos los datos:
- 1,300+ equipos con estado ACTIVO
- 4,200+ registros de historial completo
- 100+ ubicaciones (Ciudad › Sección › Oficina)
- 35+ tipos de equipo
- Usuarios (con forcePasswordChange=true, excepto admin 9999)
- Funcionarios y servicios externos
- Préstamos activos e históricos

Detalles técnicos:

Mapea acciones de historial de v1 a PROSEGUIT v2
Mapea tipos de equipo automáticamente
Calcula estado de equipo según ubicación
Genera contraseñas temporales para usuarios migrados
Reporta datos omitidos y razones (ej: referencias a equipos eliminados)

Deploy en producción

Para levantar la aplicación en un servidor con Docker:

# 1. Copiar y completar las variables de entorno
cp .env.production.example .env.production
# Editar .env.production: POSTGRES_PASSWORD, JWT_SECRET, JWT_REFRESH_SECRET

# 2. Construir y levantar (PostgreSQL + backend + nginx)
docker compose -f docker-compose.prod.yml --env-file .env.production up -d --build

# 3. Cargar usuarios iniciales (solo la primera vez)
docker compose -f docker-compose.prod.yml exec backend npx tsx prisma/seed.ts

Las migraciones de base de datos se aplican automáticamente al iniciar. El frontend se sirve desde nginx en el puerto 80 y hace proxy de /api al backend.

Estructura del proyecto

PROSEGUIT/
├── backend/
│   ├── Dockerfile                         # Imagen de producción (tsx)
│   ├── vitest.config.ts                   # Config de tests
│   ├── prisma/
│   │   ├── schema.prisma                  # Modelo de datos (12 modelos, 2 enums)
│   │   ├── seed.ts                        # Usuarios iniciales
│   │   ├── migrate-v1.ts                  # Migración desde seguit v1
│   │   └── migrations/
│   └── src/
│       ├── index.ts                       # Punto de entrada Express
│       ├── config/                        # env.ts
│       ├── middleware/                    # auth, validate, error-handler
│       └── modules/
│           ├── auth/                      # login, refresh, logout
│           ├── equipment/                 # CRUD + acciones + tests
│           ├── locations/                 # árbol Ciudad›Sección›Oficina
│           ├── history/                   # historial global
│           ├── loans/                     # préstamos
│           ├── model-templates/           # plantillas de modelo
│           ├── service-providers/         # proveedores de servicio
│           ├── users/                     # usuarios + tests
│           └── dashboard/                 # stats + actividad reciente
│
├── frontend/
│   ├── Dockerfile                         # Multi-stage: Vite build → nginx
│   ├── nginx.conf                         # Config nginx (proxy /api + SPA)
│   └── src/
│       ├── App.tsx                        # Router con code splitting (lazy)
│       ├── lib/
│       │   ├── api-client.ts              # Fetch con JWT auto-refresh
│       │   ├── auth-context.tsx           # AuthContext (React 19)
│       │   ├── equipment-status.ts        # resolveEstado() — estado por nombre de oficina
│       │   ├── action-types.ts            # Labels y colores de acciones centralizados
│       │   ├── dashboard-helpers.ts       # Utilidades compartidas de widgets
│       │   └── find-soporte-office.ts
│       ├── hooks/                         # useEquipment, useLocations, useHistory...
│       ├── components/
│       │   ├── layout/                    # Sidebar, Header, MainLayout
│       │   ├── ui/                        # DataTable (tabla reutilizable), StatusBadge
│       │   ├── dashboard/                 # Widgets configurables con drag & drop
│       │   └── LocationCascadeSelect.tsx  # Selector Ciudad›Sección›Oficina reutilizable
│       ├── pages/                         # 13 páginas
│       └── styles/                        # variables.css, reset.css, globals.css
│
├── packages/shared/                       # Schemas Zod compartidos (equipment, user)
├── docker-compose.yml                     # PostgreSQL para desarrollo
├── docker-compose.prod.yml                # Producción: postgres + backend + nginx
└── .env.production.example                # Template de variables de entorno para prod

Modelo de datos

Ciudad ──< Seccion ──< Oficina ──< Equipo
                                      │
                           TipoEquipo ┤
                        ModeloTemplate┤
                                      │
                                  Historial (accion + motivo + origen + destino)
                                  Prestamo (solicitante + tecnico + fechas)
                                  EnvioServicio (ServicioExterno + diagnostico)

Estados de equipo: NUEVO · ACTIVO · EN_REPARACION · EN_DEPOSITO · PRESTADO · EN_SERVICIO_EXTERNO

Tipos de oficina: OFICINA · SOPORTE · DEPOSITO — determinan el estado derivado del equipo

Tipos de acción: CREACION · ASIGNACION · EDICION · TRANSFERENCIA · ENVIO_SOPORTE · RETORNO_SOPORTE · PRESTAMO · DEVOLUCION · ENVIO_SERVICIO_EXTERNO · RETORNO_SERVICIO_EXTERNO · FOTO_AGREGADA · FOTO_ELIMINADA

El campo estado en la base de datos puede quedar desactualizado. Siempre se usa resolveEstado(estado, oficina.nombre) para mostrar el estado real en la UI.

API REST

Base URL: http://localhost:3001/api/v1

Todos los endpoints requieren Authorization: Bearer <token> excepto POST /auth/login.

Módulo	Endpoints
Auth	`POST /auth/login` · `POST /auth/refresh` · `POST /auth/logout`
Equipos	`GET /equipment` · `POST /equipment` · `GET /equipment/:id` · `PUT /equipment/:id`
Acciones equipo	`POST /equipment/:id/transfer` · `/send-to-support` · `/send-to-service` · `/return-from-service`
Fotos	`POST /equipment/:id/images` · `DELETE /equipment/:id/images/:imageId`
Tipos	`GET /equipment/types` · `GET /equipment/next-serie`
Ubicaciones	`GET /locations/tree` · `POST/PUT/DELETE /locations/cities` · `/sections` · `/offices`
Historial	`GET /history` · `GET /history/equipment/:id`
Préstamos	`GET /loans` · `POST /loans` · `POST /loans/:id/return`
Plantillas	`GET/POST /model-templates` · `PUT/DELETE /model-templates/:id`
Servicios	`GET/POST /service-providers` · `PUT /service-providers/:id`
Usuarios	`GET/POST /users` · `GET /users/me` · `PUT /users/:id` · `POST /users/:id/reset-password` · `POST /users/change-password`
Dashboard	`GET /dashboard/stats` · `GET /dashboard/recent-activity`

Migración desde seguit v1

Si se dispone de un dump SQL de seguit v1:

# 1. Colocar db_seguit1.sql en la raíz del proyecto

# 2. Extraer datos a JSON
node extract_data.js

# 3. Asegurarse de que la DB esté corriendo
npm run db:up

# 4. Ejecutar la migración
cd backend && npx tsx prisma/migrate-v1.ts

El script migra ubicaciones, tipos de equipo, usuarios, funcionarios, servicios externos, equipos, historial y préstamos. Ver CLAUDE.md para documentación completa del proceso.

Credenciales de desarrollo

⚠️ Solo para entorno local. No usar en producción.

Rol	Ficha	Contraseña
ADMIN	`9999`	`admin123`
TECNICO	`7844`	`7844`

Al crear nuevos usuarios en la app, el sistema genera una contraseña temporal aleatoria que se muestra una única vez. El usuario debe cambiarla en el primer login.

Convenciones del proyecto

CSS: Módulos CSS con nesting nativo y custom properties. Sin Tailwind, sin styled-components.
React 19: use(AuthContext) en lugar de useContext(), <Context value={}> sin .Provider.
Estado de equipo: nunca leer el campo estado directamente. Usar resolveEstado(estado, oficina.nombre).
Mutaciones: toda mutación de equipo debe invalidar ['equipment'], ['history', 'equipment', id] y ['dashboard'].
Code splitting: todas las páginas se cargan con React.lazy. Nuevas páginas deben seguir el mismo patrón.
Idioma UI: Español (Uruguay) — "ficha", "técnico", "préstamo", "ubicación".

Roadmap

El sistema está diseñado para evolucionar hacia una plataforma ITSM liviana. Las próximas mejoras planificadas:

Alertas inteligentes — notificaciones para garantías próximas a expirar, licencias vencidas, equipos obsoletos
Dashboard analítico — widgets de costos, comparativas por período, análisis de depreciación
Automatizaciones — recordatorios, reglas de cambio de estado, notificaciones al técnico
Carga masiva de equipos — formulario batch con campos compartidos y series correlativas editables
Importación desde CSV/Excel — carga de usuarios o licencias desde planilla
Visualización de red — mapa lógico de ubicaciones con contadores de equipos

PROSEGUIT — Sistema de Gestión de Inventario IT

Name		Name	Last commit message	Last commit date
Latest commit History 124 Commits
.claude		.claude
.githooks		.githooks
.vscode		.vscode
backend		backend
docs		docs
frontend		frontend
packages/shared		packages/shared
.env.example		.env.example
.env.production.example		.env.production.example
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
README.md		README.md
docker-compose.prod.yml		docker-compose.prod.yml
docker-compose.yml		docker-compose.yml
extract_data.js		extract_data.js
package-lock.json		package-lock.json
package.json		package.json
setup.js		setup.js

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

PROSEGUIT v2

Capturas de pantalla

Características principales

Stack tecnológico

Requisitos previos

Desarrollo local

Opción 1: Setup automático (recomendado)

Opción 2: Setup manual (paso a paso)

Con migración de datos (seguit v1)

Comandos disponibles

Detalles de la migración v1

Deploy en producción

Estructura del proyecto

Modelo de datos

API REST

Migración desde seguit v1

Credenciales de desarrollo

Convenciones del proyecto

Roadmap

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

PROSEGUIT v2

Capturas de pantalla

Características principales

Stack tecnológico

Requisitos previos

Desarrollo local

Opción 1: Setup automático (recomendado)

Opción 2: Setup manual (paso a paso)

Con migración de datos (seguit v1)

Comandos disponibles

Detalles de la migración v1

Deploy en producción

Estructura del proyecto

Modelo de datos

API REST

Migración desde seguit v1

Credenciales de desarrollo

Convenciones del proyecto

Roadmap

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages