Sistema completo de gestión para talleres mecánicos (gratis y open source)

Qué incluye este sistema

Un panel de administración completo para talleres mecánicos, construido con tecnología moderna y listo para usar o personalizar.

Estos son los módulos que trae:

• Agenda — Vista diaria y semanal de todos los turnos con datos del vehículo (patente, modelo, año)
• Booking — Página pública de reservas para que los clientes agenden solos
• Conversaciones — Historial completo de chats con cada cliente
• Agente de IA — Asistente automatizado de WhatsApp que responde consultas y agenda turnos
• Métricas — Estadísticas del taller: servicios, ingresos, vehículos atendidos
• Pagos — Registro y control de cobros con métodos de pago

Acceder al repositorio

Todo el código está disponible de forma gratuita en GitHub:

github.com/jlucasacosta/sistema-taller-mecanico

Podés usarlo tal como está, adaptarlo a tu taller o tomarlo como base para construir algo propio.

Cómo instalar y correr el sistema

Requisitos previos

Necesitás tener instalado en tu computadora:

• Node.js 20 o superior — nodejs.org
• Git — git-scm.com

Para verificar que están instalados, abrí una terminal y ejecutá:

node --version
git --version

Instalación paso a paso

1. Clonar el repositorio

git clone https://github.com/jlucasacosta/sistema-taller-mecanico.git
cd sistema-taller-mecanico

2. Instalar las dependencias

npm install

3. Iniciar el sistema

npm run dev

Abrí tu navegador en http://localhost:5173 y el sistema va a estar funcionando.

Cómo usarlo en el día a día

Agenda y turnos

Desde el módulo de Agenda podés ver todos los turnos del día o la semana con la patente, el modelo y el servicio a realizar. Reprogramá, cancelá o creá turnos manualmente desde la misma vista.

Booking para clientes

El módulo de Booking expone una URL pública (/booking/:mecanicoId) que podés compartir con tus clientes para que reserven directamente sin llamadas ni mensajes. El turno aparece automáticamente en la agenda.

Catálogo de servicios

El catálogo (SERVICIOS_DISPONIBLES en src/types/index.ts) trae servicios automotrices comunes con duración y precio: cambio de aceite, frenos, alineación, balanceo, etc. Editalo para sumar o quitar lo que necesites.

Agente de IA por WhatsApp

El agente funciona como un empleado virtual conectado a WhatsApp. Recibe los mensajes de los clientes, entiende lo que necesitan (presupuesto, turno, consulta) y gestiona la reserva: consulta disponibilidad, confirma horario y registra el turno con los datos del vehículo.

Pagos y métricas

El módulo de Pagos registra cada cobro con el servicio, el monto, el método y el vehículo. Las Métricas cruzan esa información y muestran cómo evoluciona el taller semana a semana.

Personalizar el sistema con Claude Code

Si querés adaptar el sistema a tu taller específico, podés usar Claude Code para modificarlo sin necesidad de saber programar en profundidad.

Instalalo con:

npm install -g @anthropic-ai/claude-code

Luego, dentro de la carpeta del proyecto, ejecutá claude y describí lo que querés cambiar. Ejemplos:

• "Cambiá el nombre del taller en el panel y el color principal"
• "Agregá un servicio nuevo: 'Diagnóstico computarizado' con precio 8000 y duración 45 minutos"
• "Agregá un campo de kilometraje al crear un turno"
• "Conectá el agente de IA a WhatsApp Business"

Stack tecnológico

Para los que les interesa el detalle técnico:

• React 19 + TypeScript — interfaz y tipado
• Vite — build tool ultra rápido
• Tailwind CSS 4 — estilos (variables en src/index.css)
• Radix UI — componentes accesibles
• Zustand — estado global
• Recharts — gráficos de métricas
• React Router — navegación
• localStorage — persistencia sin backend

Licencia MIT — podés usarlo, modificarlo y hasta comercializarlo libremente.