Fase 0 · Backend operativoEstado del sistema
Modelo de datos disponible
35 entidades con aislamiento por empresa, historial de estados inmutable y auditoría.
Empresas y accesos
- organizations
- organization_users
- profiles
- user_roles
- audit_logs
Talleres e infraestructura
- workshops
- workshop_schedules
- workshop_zones
- service_bays
- cameras
- edge_devices
Flota y kilometraje
- vehicles
- vehicle_odometer_readings
- vehicle_locations
Mantenimiento y predicción
- maintenance_plans
- maintenance_intervals
- maintenance_tasks
- vehicle_maintenance_plans
- maintenance_predictions
Operación del taller
- appointments
- workshop_visits
- visit_state_history
- service_orders
- service_order_tasks
- service_order_status_history
- technicians
- technician_assignments
Evidencias, repuestos y alertas
- reception_checklists
- checklist_items
- parts
- service_order_parts
- evidence_files
- edge_events
- vehicle_zone_sessions
- alerts
- notifications
Máquina de estados de la visita
Cada transición registra fecha, actor, fuente, taller, zona, evidencia y confianza.
- 1Mantenimiento previsto
- 2Agendado
- 3En camino
- 4Llegada geográfica
- 5Ingreso detectado
- 6Recepción
- 7En espera
- 8En bahía
- 9En mantenimiento
- 10Control de calidad
- 11Lavado
- 12Listo para entrega
- 13Entregado
Integración con el PC Linux
Eventos idempotentes, tolerantes a cortes de red y procesados en orden por dispositivo.
POST /api/v1/edge/events
Authorization: Bearer <EDGE_DEVICE_TOKEN>
Idempotency-Key: <event_id>
Content-Type: application/json
- El reenvío del mismo event_id nunca duplica información.
- occurred_at se conserva aunque el evento llegue horas después.
- Un evento inválido se marca como rechazado sin bloquear la cola.
- Los eventos corregidos nunca se eliminan: quedan enlazados en auditoría.
Siguiente fase
Dashboard operativo, agenda por capacidad, recepción con checklist, orden de servicio, tablet del técnico y portal del cliente.