Home

RecyOps

RecyOps es el cliente web (SPA) para la gestión de una operación de reciclaje: ingresos de material, entregas, inventario y stock, convenios con proveedores, bodegas, trabajadores y tareas operativas.

Este repositorio contiene solo el frontend. El backend es un servicio Spring Boot independiente que vive en el repo recyops-backend.

Stack

• React 18 + TypeScript, empaquetado con Vite 6
• Bun como gestor de paquetes y runtime de desarrollo
• React Router 7 para el ruteo
• Tailwind CSS 4 + CSS Modules por vista
• Radix UI / shadcn como librería de componentes atómicos
• Zod para validación de formularios (espejo de las reglas del backend)
• Axios como capa HTTP única, con refresh automático de sesión

Mapa de la wiki

• Arquitectura — estructura de carpetas, entry point, layout, roles y rutas
• Modulos — inventario de los 15 módulos de negocio y qué hace cada uno
• Autenticacion y API — cómo funciona el cliente Axios, el JWT y el refresh de sesión
• Validacion y Schemas — la convención <modulo>Schema.ts y su relación con el backend
• Decisiones Tecnicas — log de decisiones de arquitectura relevantes para el frontend (ADRs)
• Guia de Desarrollo — cómo correr el proyecto localmente, variables de entorno, generación de documentos

Para las instrucciones que sigue Claude Code sobre este repo, ver CLAUDE.md en la raíz del proyecto.