Track (RamTrack)

Sistema de gestión de tracking con detección automática de cambios — Frontend PWA + Backend Nitro/H3 para gestión de expedientes de placas de motocicletas.

Quick Start

1. npm install (instala dependencias del workspace NX)
2. Copiar backend/.env.example a backend/.env y configurar conexión SQL Server
3. Copiar frontend/.env.example a frontend/.env y ajustar VITE_API_URL
4. npm run backend — inicia backend en http://localhost:3001
5. npm run frontend — inicia frontend en http://localhost:5173

Features

• Expedientes y Checklists: Flujo completo de gestión de expedientes de motocicletas con estados definidos (FACTURA_INGRESADA → CITA_PROGRAMADA → PROTOCOLO_FIRMADO → TRAMITE_EN_PROCESO → PLACAS_LISTAS → PLACAS_ENTREGADAS)
• Calendario de Citas: Agendamiento con historial de cambios, feriados y validación de días hábiles
• Chat Interno: Conversaciones entre usuarios del sistema con participantes y mensajes
• PWA (Progressive Web App): Soporte offline con IndexedDB (Dexie), service worker y diagnóstico de estado
• Perfiles de Usuario: Gestión de usuarios con roles (ADMIN, VENDEDOR, ABOGADO, SUPERVISOR, CLIENTE, CONSULTAS)
• OCR con IA: Extracción automática de datos de facturas usando modelos de visión vía OpenRouter
• Dashboard Kanban: Vista tipo tablero para supervisores con indicadores KPI
• Notificaciones Internas: Sistema de alertas por estado de expediente, cliente no localizado, etc.
• Branding Configurable: Logos y manifiesto PWA subidos dinámicamente por administradores
• Reportes y Exportación: Exportación de datos y reportes de facturación mensual

Estructura del Proyecto

track/
├── backend/           # Nitro/H3 API (puerto 3001)
│   ├── server/api/    # Rutas API (file-based routing)
│   ├── server/domains/# Lógica de negocio por dominio
│   ├── server/plugins/# Plugins de Nitro (Prisma, errores, logging)
│   ├── prisma/        # Schema Prisma + migraciones
│   └── Dockerfile
├── frontend/          # React + Vite + Tailwind CSS (puerto 5173)
│   ├── src/pages/     # Páginas principales
│   ├── src/components/# Componentes React
│   └── Dockerfile
├── scripts/           # start.js, run.ps1
├── docs/              # Documentación técnica
└── nx.json            # Configuración NX monorepo

Scripts Principales

Comando	Descripción
npm run start	Muestra instrucciones de arranque
npm run backend	Inicia backend en modo desarrollo
npm run frontend	Inicia frontend en modo desarrollo
npm run build	Build de frontend + backend
npm run test	Ejecuta tests de frontend y backend
npm run watch	Watcher de cambios automático
npm run push	Safe push (build + commit + push)
npm run lint	Lint de ambos proyectos
npm run format	Formateo con Prettier

Documentation

• 01 - Contexto del Proyecto
• 02 - Arquitectura
• 03 - Instalación
• 04 - Despliegue
• 05 - API e Interfaces
• 06 - Base de Datos
• 07 - Runbooks / Troubleshooting

Repositorios

• GitHub: https://github.com/cquiroscrc/track.git
• GitLab: http://100.108.224.72:8929/root/ramtrack.git