🌵
Punto Agave TPM
Acceso a la demostración integral. Escribe la clave de acceso.
powered by Grupo Veniu · VSolutions
Punto Agave · Mantenimiento Productivo Total
El sistema de flotilla, de punta a punta
Una sola ventana para navegar toda la solución: los portales de captura en campo, el cerebro que conecta, y el ERP donde se gestiona. Desde aquí entras a cada pieza de la demostración.
◆La idea en 30 segundos
Tres mundos conectados en doble vía: lo que se captura en campo sube al ERP, y lo que se resuelve en el ERP regresa como estado a quien lo reportó. Sin doble captura.
1 · Portales
Inspecciones N1/N2/N3 y levantamiento de tickets, desde el celular en campo.
HTML · captura→firmado
2 · Cerebro
Hoja + Apps Script: registra, valida y sincroniza los datos en ambos sentidos.
Google Sheet · GAS→puente
3 · Odoo (ERP)
Inspecciones como registro + tickets con pipeline, SLA y conformidad.
Staging · Odoo v19El estado del ticket regresa del ERP al tablero de campo automáticamente (rebote inverso).
▸Entra a cada pieza
Interno · Dirección
Estos accesos son de backend/operación. Compártelos solo con el equipo de dirección.
◆Qué ver en cada lado
- En los portales: llena una inspección N1 (semáforo 🟢🟡🔴) o levanta un ticket → sale un folio al instante.
- En Odoo → Inspecciones TPM: aparece la inspección completa con sus 63 puntos, profundidades y semáforo.
- En Odoo → Tickets / Órdenes (Soporte al cliente): cada hallazgo se vuelve un ticket con su pipeline de 8 etapas — de "Recepción" a "Cerrado / Conformidad".
- La doble vía: avanza el ticket en Odoo y el estado regresa al tablero de campo. Nadie captura dos veces.
Grupo Veniu · VSolutions — Integrador de Mundos. Presentación integral de la demostración Punto Agave TPM.
Guía de uso y demo
Manual del cliente
El registro de datos — guía de hojas y columnas
Avance del proyecto
🌵 Punto Agave · TPMGuía de uso y demo
Guía para el equipo · Sistema de Inspecciones TPM
Cómo probar y usar el sistema, paso a paso.
Esta guía es para todos — no necesitas saber Odoo. Te explica dónde entrar, qué portal usar para cada cosa, cómo se ve en Odoo y quién puede ver qué. Léela de arriba a abajo o salta a la sección que necesites.
Antes de empezar
Son dos mundos que se hablan solos
El sistema tiene dos partes que se conectan automáticamente. Entender esto hace que todo lo demás sea fácil:
📱
El equipo, en campo
Los Portales
Páginas web sencillas (funcionan en celular, tablet o compu). Aquí el operador, el técnico y el jefe llenan las inspecciones y levantan tickets. Es como llenar un formulario: eliges la unidad, marcas lo que revisaste, y envías.
No hay que instalar nada ni saber de sistemas.
🏢
La administración, en oficina
Odoo
El sistema de gestión (en computadora). Aquí llega automáticamente todo lo que capturó el campo: cada inspección se vuelve una orden de trabajo, con su unidad, su prioridad y su historial. El jefe da seguimiento y cierra las órdenes.
Es donde se ve el panorama completo y se toman decisiones.
🔗
La magia (la "doble vía"): cuando alguien envía una inspección en el Portal, aparece sola en Odoo segundos después. Y cuando en Odoo cambias el estado de una orden, ese estado regresa al sistema. Nadie recaptura nada, y todo queda con folio y rastro de quién lo hizo.
Parte 1 · Los Portales
Entrar y usar los portales (el equipo)
Cómo entrar
- Abre la liga de acceso en el navegador (Chrome, celular o compu):
https://puntoagave-staging-34527386.dev.odoo.com/mantenimiento/loginEs la ÚNICA liga que se reparte. Desde ahí se llega a todo lo demás. - Escribe tu usuario y contraseña.Usuarios de ejemplo: admin, aldo.luna (jefe), tecnico1 (técnico), felipe.gonzalez (operador). Contraseña de todos en la demo: agave2026.
- Entras al Hub (el menú principal).Solo verás los portales que te tocan por tu rol — así nadie se pierde.
📱
Tip: en el celular, agrega la página al inicio ("Añadir a pantalla de inicio") y queda como si fuera una app.
¿Qué portal se usa para cada cosa?
| Portal | ¿Para qué? | ¿Quién? | ¿Cuándo? |
|---|---|---|---|
| ☀️ N1 Diaria | Revisión rápida antes de operar (semáforo: bien / atender / detener) | Operador | Todos los días |
| 📅 N1 Semanal | Revisión un poco más a fondo, también con semáforo | Operador | Cada semana |
| 🔧 N2 Trimestral | Revisión técnica con mediciones (llantas, presiones, holguras): aprobado / valor | Técnico | Cada 3 meses |
| 📋 N3 Anual | Evaluación del estado general de la unidad, calificación 1–5 | Jefe | Una vez al año |
| 🎫 Ticket | Reportar una falla puntual cuando surge (fuera del calendario) | Operador · Técnico · Jefe · Administrativo | Cuando se necesite |
| ⛽ Carga de combustible | Registrar cada carga: litros y odómetro (+ costo opcional) — el sistema calcula solo el rendimiento (km por litro) de la unidad | Operador en adelante | En cada carga |
| 🚚 Catálogo de Flota | Consultar las 270 unidades y dar de alta una nueva | Técnico · Jefe | Al agregar unidades |
| 🗓️ Planificación | Tablero de qué toca revisar y cuándo (solo lectura) | Jefe | Para planear |
| 🔐 Accesos | Dar de alta usuarios, cambiar roles, resetear contraseñas | Admin | Al administrar el equipo |
Ejemplo: llenar una inspección diaria (N1)
- Entra a "N1 Diaria" desde el Hub.
- Busca tu unidad por número económico (ej. CC144) o descripción. El sistema ya sabe qué revisar según la familia de esa unidad.
- Anota la lectura (odómetro, horómetro o fecha, según la unidad).El nivel de combustible ya no se pide aquí — el combustible se registra al cargar, en su propio portal (ver abajo).
- Marca cada punto: casi todo queda en verde solo. Si algo está mal, lo pones en amarillo (atender pronto) o rojo (detener). Ahí te pide "¿qué viste?" y foto.
- Envía. Recibes un folio (ej. PA-N1-CC144-…-001) y listo.En ese momento la inspección ya viajó a Odoo y, si hubo amarillos/rojos, se creó la orden de trabajo.
✅
Los demás portales (N2, N3, Ticket) funcionan igual de sencillo: eliges la unidad, llenas, envías. Cambia solo la forma de evaluar (medición, calificación, o el reporte del ticket).
🛞 Llantas en la N1: "OK" o "Reportar"
El punto de llantas de la revisión diaria es de dos botones: si todo está bien, tocas LLANTAS OK y sigues. Si algo no te gusta, tocas REPORTAR y se abre el dibujo de tu unidad con sus llantas numeradas — tocas la(s) que tienen el problema.
- La numeración es la referencia de todos: se cuenta desde el piloto hacia atrás, de izquierda a derecha. La 1 es la delantera izquierda y la 2 la delantera derecha; en cada eje trasero se sigue el orden izquierda-exterior, izquierda-interior, derecha-interior, derecha-exterior (3, 4, 5, 6…), y los repuestos van al final.Ese número es el que viaja en el reporte — "la llanta 3" significa lo mismo para el operador, el técnico y la oficina.
- Por cada llanta que reportes eliges su condición: DAÑADA (tiene un daño) · REEMPLAZO (ya hay que cambiarla) · MEDIA VIDA (va a medio desgaste, para tenerla en la mira).
- Envías y listo: el reporte llega a la oficina con la unidad, el número de llanta y su condición. Las condiciones más serias entran con mayor prioridad de atención.
🛞 La revisión de llantas ahora es visual (N2 Trimestral)
En la inspección trimestral, las llantas ya no se llenan en una lista: aparece un dibujo de tu unidad vista desde arriba, con sus llantas reales (4, 6 o 10 según la unidad, y sus repuestos). Igual que el diagrama que ustedes usan.
- Toca una llanta del dibujo → se abre su captura: profundidad (mm) y presión (psi).
- El color te habla: contorno verde = en buen estado · naranja = profundidad mínima cerca · rojo = mínima alcanzada (atender). El valor en mm queda visible bajo cada llanta.
- Rotación automática: si la diferencia de desgaste entre llantas supera 2 mm, el sistema te lo dice con un aviso — cuáles intercambiar (▼ la más gastada ⇄ ▲ la menos gastada) — y las marca en el dibujo.
🎨
Las barras de color de los ejes siguen la convención de su diagrama: amarillo = eje direccional · verde = eje de tracción · gris = eje libre. Hay una leyenda de convenciones dentro del portal ("Ver convenciones").
🎫 El ticket, con los datos de tu operación
El levantamiento de ticket ahora pide los mismos datos de su formato, para que nada se pierda:
| Dato | Qué es |
|---|---|
| Responsable y Zona | El dueño de la unidad y su zona — se prellenan solos al elegir la unidad. |
| Tipo de falla | La clasificación del problema (motor, frenos, llantas, eléctrico…). |
| Estado operativo | Operativa / No operativa. Si la unidad NO está operativa, el ticket se marca URGENTE automáticamente. |
| ¿Es reincidencia? | Si el mismo tema ya se había reportado antes. |
| Fecha y lectura | Obligatorias: la fecha siempre, y el odómetro/horómetro según la unidad — así toda la historia queda medible. |
| Fotos | Botón "📷 Tomar fotografía" — desde el celular abres la cámara directo (hasta 3 evidencias). |
⚙️
Ya no eliges tipo ni prioridad — el sistema los pone solo: un ticket que levantas
directo entra como correctivo; un hallazgo que sale de una inspección entra como preventivo. Y la prioridad se deriva sola
(unidad No operativa ⇒ urgente; si no, media). Tú solo describes la falla — el sistema clasifica.
🛞
Si el tipo de falla es llantas, aparece el mismo dibujo numerado de la unidad:
tocas la(s) llanta(s) y eliges su condición (dañada / reemplazo / media vida). El número de llanta es la referencia del ticket.
🔁
El estatus del ticket sigue el camino que ya conocen: REPORTADO (al enviarlo del portal) → ASIGNADO → EN REPARACIÓN → FINALIZADO. Esas etapas se avanzan en el tablero de la oficina (Odoo), y el estado regresa solo al sistema del campo.
Parte 2 · Odoo (sin experiencia previa)
Entrar y navegar Odoo (la gestión)
Odoo es el sistema donde llega todo. No te asustes: solo usaremos un menú. Aquí va lo mínimo para moverte con confianza.
Cómo entrar a Odoo
- Abre la liga de Odoo en la computadora:
https://puntoagave-staging-34527386.dev.odoo.com/odoo - Inicia sesión con tu usuario y contraseña de Odoo (te los da el administrador; son distintos de los del portal).
- Verás la pantalla de Aplicaciones.Es una cuadrícula de íconos (o un menú arriba a la izquierda). Cada ícono es un módulo.
- Entra a la app "Punto Agave TPM".Si no la ves de inmediato, haz clic en el menú de arriba a la izquierda (☰ o el nombre del módulo actual) y elígela de la lista.
El menú "Punto Agave TPM" — qué hay en cada lado
Una vez dentro, arriba aparece la barra del módulo. Estas son las opciones y para qué sirven:
| Menú (arriba) | Qué ves ahí |
|---|---|
| Inspecciones | La lista de todas las inspecciones que capturó el campo (folio, unidad, nivel N1/N2/N3, resultado semáforo, fecha, quién la hizo). Haz clic en una para ver el detalle completo y las órdenes que generó. |
| Tickets / Órdenes | Las órdenes de trabajo de mantenimiento (lo que hay que reparar). Vienen de las inspecciones (siempre preventivas; el color solo marca la prioridad) y de los tickets directos (siempre correctivos). Se ven en tablero Kanban por etapas. |
| Presupuestos | Presupuestos de compra para reparar (el técnico arma, el jefe aprueba, se genera la orden de compra). Opcional. |
| Llantas | Control de llantas como activo (posición, desgaste, rotación, costo por km). |
| Flota | Las 270 unidades con su ficha (económico, placa, familia, responsable). |
| Configuración | Catálogos internos (puntos de inspección, familias, marcas de llanta). Casi no se toca. |
Así se ve Odoo (ilustrado)
Estas son ilustraciones de las pantallas reales para que reconozcas dónde estás. Los colores y el menú morado son los de Odoo.
puntoagave-staging-34527386.dev.odoo.com/odoo
Punto Agave TPM
InspeccionesTickets / ÓrdenesPresupuestosLlantasFlotaConfiguración
🌵
Punto Agave TPM🔧
Mantenimiento🚚
Flota📊
TableroPantalla 1 A La cuadrícula de Aplicaciones — entra a “Punto Agave TPM”. B Ya dentro, arriba aparece la barra morada del módulo con los menús.
…/odoo/action-… · Punto Agave TPM › Inspecciones
Punto Agave TPMInspeccionesTickets / ÓrdenesFlota
Inspecciones
| Folio | Unidad | Nivel | Resultado | Fecha | Capturó |
|---|---|---|---|---|---|
| PA-N1-0002 | CC144 · NAVISTAR | N1 | Amarillo | 06/07/2026 | admin |
| PA-N1-0001 | LG118 · NISSAN NP300 | N1 | Rojo | 06/07/2026 | admin |
Pantalla 2 A Menú Inspecciones: la lista de todo lo que capturó el campo. B Haz clic en una fila (ej. PA-N1-0002) para ver el detalle y sus órdenes.
…/odoo/action-… · Punto Agave TPM › Tickets / Órdenes
Punto Agave TPMInspeccionesTickets / ÓrdenesFlota
Órdenes de trabajo
Nueva solicitud 2
Aceite en nivelCC144 · preventivo
No enciendeTA5 · correctivo
En progreso 0
Reparado 0
Pantalla 3 A Menú Tickets / Órdenes: las órdenes en columnas por etapa. B Para avanzar una orden, arrastra la tarjeta a la siguiente columna (o ábrela y cambia la etapa) — eso es lo que regresa al sistema del campo.
Ver una inspección que llegó del campo
- Clic en Inspecciones. Aparece la lista; la más reciente arriba.
- Clic en la fila (ej. PA-N1-0002 · CC144). Se abre la ficha: nivel, unidad, resultado, y los puntos marcados con "¿qué viste?".
- Arriba (botones inteligentes) o en la ficha verás las órdenes de trabajo que generó esa inspección.
Ver y mover una orden de trabajo (el tablero Kanban)
- Clic en Tickets / Órdenes. Verás columnas (etapas): p.ej. Nueva solicitud → En progreso → Reparado.
- Cada tarjeta es una orden (dice la unidad y el problema). Haz clic para ver el detalle.
- Para avanzar una orden, arrastra la tarjeta a la siguiente columna (o abre la orden y cambia la etapa).Ese cambio de estado es justo lo que regresa al sistema del campo (la "vuelta").
🧭
Regla de oro para no perderte en Odoo: casi todo se hace con clics en listas y tarjetas. Si te pierdes, vuelve al menú "Punto Agave TPM" arriba y empieza de nuevo.
Parte 3 · La doble vía
El recorrido completo de una inspección
Esto es lo que hay que mostrar para que se entienda el valor: una inspección viaja sola del campo a la oficina y de regreso.
- Campo (Portal): el operador llena la N1 de una unidad y marca un amarillo → Enviar. Sale el folio.
- Viaje automático: el sistema guarda todo y lo empuja a Odoo (con firma de seguridad, sin que nadie recapture).
- Oficina (Odoo): segundos después, en Inspecciones aparece la inspección, y en Tickets / Órdenes aparece la orden preventiva con la unidad correcta.
- Seguimiento (Odoo): el jefe mueve la orden a "En progreso" / "Reparado".
- Regreso (la vuelta): ese estado regresa al sistema del campo, para que todos vean que ya se atendió.Trazabilidad completa: quién revisó, qué encontró, qué orden se generó y cómo terminó.
🎯
El mensaje para el cliente: "Tu equipo solo llena una pantalla sencilla en el celular. La administración ve todo ordenado en Odoo, con órdenes de trabajo automáticas y sin doble captura. Nada se pierde."
Roles y permisos
Quién ve qué — y cómo se asigna
| Rol | En los Portales | En Odoo |
|---|---|---|
| Operador | N1 Diaria/Semanal + Ticket | Ve inspecciones y órdenes (no borra) |
| Técnico | N2 + Catálogo + Ticket | + ejecuta mantenimiento, llantas, presupuestos |
| Jefe | N1/N2/N3 + Planificación + Catálogo | + aprueba presupuestos, control total de datos |
| Admin | Todo + Accesos | Control total, incluye borrado y configuración |
🔑
Importante (una sola vez, lo hace el administrador): para que un usuario vea el menú "Punto Agave TPM" en Odoo, hay que asignarle su grupo. En Odoo: Ajustes → Usuarios → (elegir usuario) → asignar el grupo "Punto Agave TPM / [rol]". Sin esto, el usuario entra a Odoo pero no ve el módulo.
Guión de demostración
Cómo presentarlo en 6 pasos
Guión sugerido para mostrar el sistema funcionando de punta a punta (10–15 min). Ten abiertas dos pestañas: el Portal y Odoo.
- Presenta los dos mundos. "Esto es lo que usa el equipo en campo (Portal, en el celular) y esto lo que ve la administración (Odoo)." Muestra el login del portal y el Hub.
- Llena una N1 en vivo. Elige una unidad (ej. CC144), marca un amarillo con "¿qué viste?", envía. Muestra el folio.
- Cambia a la pestaña de Odoo → Inspecciones → refresca. "Miren: ya llegó sola, sin recapturar." Abre la inspección.
- Muestra la orden generada en Tickets / Órdenes: la orden preventiva con la unidad correcta.
- Mueve la orden en el Kanban a "En progreso". "Este estado regresa al sistema — todos saben que ya se está atendiendo."
- Cierra con el panorama: muestra la Flota (270 unidades) y el Hub por rol. "Un solo enlace para el equipo, todo ordenado en Odoo, cero doble captura."
💡
Consejo: antes de la demo, ten a la mano 1–2 unidades y un usuario de cada rol. Y no reconstruyas el sistema de staging durante la presentación (las ligas podrían cambiar).
🛞
El momento "wow": abre N2 Trimestral con un camión agavero (ej. CC144) y muestra el mapa de llantas: toca dos llantas, captura profundidades distintas (ej. 2 y 8 mm) y deja que el sistema recomiende la rotación solo. Es la imagen que el cliente pidió, viva.
Ligas rápidas (staging)
🔑 Portal (equipo): …/mantenimiento/login · contraseña demo agave2026
🏢 Odoo (gestión): …/odoo · usuario y contraseña de Odoo
(Base: https://puntoagave-staging-34527386.dev.odoo.com)
Punto Agave · TPMInspecciones de flota
Sheet
GAS
Odoo
Mantenimiento Productivo Total · Flota Punto Agave
El mantenimiento que se adelanta a la falla.
Un sistema vivo que lleva tus 270 unidades del papel disperso a un pulso digital: inspecciones por niveles, semáforo en tiempo real y trazabilidad de quién revisó qué — conectado a Odoo.
270Unidades
9Familias
3+1Niveles + Ticket
10Portales
Desliza
Para qué sirve
De apagar incendios a prevenirlos
TPM (Mantenimiento Productivo Total) es una forma de cuidar la flota donde la falla se anticipa, no se persigue. El sistema pone esa filosofía en manos de tu equipo, todos los días, desde el celular.
◦ Antes — mantenimiento reactivo
- La unidad se revisa "cuando se acuerdan" o cuando ya falló.
- Los checklists viven en papel o en Excel sueltos, sin rastro.
- No se sabe quién revisó, cuándo, ni qué encontró.
- La orden de reparación se pierde entre WhatsApp y libretas.
➜
● Ahora — mantenimiento que previene
- Cada unidad tiene su ritmo: diario, semanal, trimestral, anual.
- Se captura en campo con semáforo — verde, amarillo, rojo.
- Cada inspección deja folio y responsable: trazabilidad total.
- Un hallazgo rojo levanta la alerta y la orden, y viaja a Odoo.
🎯
Una sola verdad
Los portales, la hoja de datos y Odoo hablan del mismo catálogo de 270 unidades. Nada se captura dos veces.
🛡️
Nada se cae
Si un hallazgo bloquea la unidad, el sistema lo marca y evita que salga a operar con un riesgo abierto.
📈
Decisiones con datos
Los jefes ven cumplimiento, índice de salud y plan de servicio en tableros, sin pedir reportes a mano.
Cómo llegamos aquí
El recorrido: del diagnóstico al sistema vivo
No empezamos por la pantalla bonita. Empezamos por entender la flota y terminamos con un sistema conectado que ya escribe en tu hoja real y deja rastro hacia Odoo.
1
Diagnóstico
Mapeamos la flota real
Levantamos las 270 unidades y las agrupamos en 9 familias, cada una con su forma de medir el uso (odómetro, horómetro o calendario). Esa es la base de todo: sin catálogo confiable no hay plan de servicio.
2
Metodología TPM
Digitalizamos los checklists por niveles
Convertimos las revisiones en 3 niveles con sus puntos exactos: N1 diaria/semanal (operador), N2 trimestral (técnico) y N3 anual (jefe). Cada punto sabe si es semáforo, medición o calificación.
3
Portales conectados
Interfaces por rol + backend real
Construimos 10 portales que se abren según el rol y que ya vienen conectados: cada envío se firma, escribe en tu Google Sheet y muestra el dato en vivo. Login obligatorio para saber quién hizo qué.
4
Trazabilidad a Odoo
Cerramos el círculo hacia el ERP
Las inspecciones y órdenes viajan a Odoo (Calidad · Mantenimiento · Flotilla) con folio y sincronización, para que el mantenimiento viva en el mismo sistema que el resto de la operación.
La flota · 270 unidades
9 familias, cada una con su ritmo
No todas las unidades se miden igual. Un camión cuenta kilómetros; una máquina, horas; un implemento, días. El sistema respeta esa diferencia para calcular cuándo toca servicio.
ImplementosIM · calendarioDías
146
LigeraLG · odómetroKms
41
Tractor agrícolaTA · horómetroHrs
29
PesadaPS · odómetroKms
18
PasajerosPA · odómetroKms
11
Maquinaria pesadaMP · horómetroHrs
9
AgaveroCC · odómetroKms
8
VolteoVO · calendarioDías
4
PipaPP · calendarioDías
4
Insight Por eso el catálogo importa: el "próximo servicio" de un tractor se dispara por horas de motor, no por kilómetros.
La metodología · 3 niveles + ticket
Cada revisión, en su nivel
Del vistazo diario del operador a la calificación anual del jefe. Toca una pestaña para ver quién la hace, con qué frecuencia y cómo se evalúa.
Nivel 1 · Operativo
El pulso diario de la unidad
El operador revisa lo esencial antes de arrancar: niveles, llantas, luces, fugas. Es rápido, visual y se resuelve con un semáforo. Su versión semanal profundiza un poco más.
QuiénOperador
FrecuenciaDiaria · Semanal
Puntos34 puntos de checklist
Cómo evalúaSemáforo Verde / Amarillo / Rojo
Verde — Todo bienLa unidad opera sin observaciones.
Amarillo — Atender prontoGenera una alerta preventiva; se programa.
Rojo — DetenteAlerta correctiva: la unidad se marca y no debe operar.
Nivel 2 · Técnico
La revisión a fondo del técnico
Cada trimestre el técnico verifica sistemas completos y toma mediciones reales (presiones, holguras, desgastes). No es solo "sí/no": es aprobado o valor medido contra referencia.
QuiénTécnico de mantenimiento
FrecuenciaTrimestral
Puntos60 puntos de checklist
Cómo evalúaAprobado / Medición vs referencia
🔧
Sistemas completos
Frenos, motor, dirección, suspensión — revisados por bloque.
📏
Con medición
Se anota el valor y el sistema lo compara con la referencia.
Nivel 3 · Gestión
La evaluación anual del jefe
Una vez al año el jefe de mantenimiento califica el estado integral de la unidad en una escala de 1 a 5. Es la mirada estratégica: qué unidades renovar, cuáles vigilar, cómo va la salud de la flota.
QuiénJefe de mantenimiento
FrecuenciaAnual
Puntos40 puntos de checklist
Cómo evalúaCalificación 1 – 5
1 → 5 · ESTADO INTEGRAL
Bajo demanda
El ticket: reportar cuando algo surge
Fuera del calendario, cualquiera puede levantar un ticket cuando detecta una falla: describe qué pasó, si la unidad puede operar y con qué prioridad. El sistema lo convierte en alerta y orden al instante.
QuiénOperador · Técnico · Supervisor
FrecuenciaCuando se necesite
ResultadoAlerta + orden (correctivo/preventivo)
DestinoOdoo Mantenimiento
FOLIO GENERADO
TK-PA-N1-LG118-…-1
🔴 No puede operar
Prioridad alta
→ Odoo
Cómo funciona
Del inicio de sesión a Odoo, en un flujo
Así se ve una inspección de principio a fin. Cada paso deja rastro; nadie captura en el aire.
PASO 1
🔑Inicia sesión
El usuario entra con su clave. Su rol define qué portales ve.
PASO 2
🏠Elige en el Hub
El lanzador muestra solo las inspecciones que le tocan.
PASO 3
📝Captura en campo
Selecciona la unidad, registra la lectura y marca cada punto.
PASO 4
🚦Semáforo + folio
El sistema arma el resultado, genera folio y levanta alertas.
PASO 5
🔄Sincroniza a Odoo
Inspección y órdenes viajan al ERP con trazabilidad.
🧾
Trazabilidad de quién hizo qué
El portal ya no pregunta "¿quién eres?": toma el responsable de tu sesión y lo guarda en cada inspección. Siempre se sabe quién revisó cada unidad y cuándo — auditable por folio.
📶
La interfaz responde en vivo
Arriba a la derecha, los chips Sheet · GAS · Odoo muestran el estado real de la conexión. Si algo se cae, el portal sigue funcionando en modo seguro y no pierdes la captura.
Roles y accesos
Cada quién ve lo que le toca
Menos ruido, menos errores. Elige un rol y mira qué portales se le abren.
🔑Accesologin
🏠Hublanzador
☀️N1 Diarian1-diaria
📅N1 Semanaln1-semanal
🎫Ticketticket
🔧N2 Trimestraln2-trimestral
🚚Catálogocatalogo-flota
📋N3 Anualn3-anual
🗓️Planificaciónplanificacion
🔐Accesosadmin
La interfaz ya viene conectada
Tres capas, un solo sistema
No es una maqueta. Lo que el equipo captura en el portal se firma, se guarda en tu hoja de datos y llega a Odoo — la misma información recorre las tres capas sin recapturar.
📱PortalEl operador captura en el celular. Firma cada envío.
→firma HMAC
📊Google Sheet · GASRecibe, valida, genera folio y guarda. Tu base de datos viva.
→sincroniza
🏢OdooCalidad · Mantenimiento · Flotilla. El ERP de la operación.
🔐
Envíos firmados
Cada captura viaja firmada para que solo entren datos legítimos a la hoja.
🧩
Embebible donde ya trabajan
Los portales se integran por iframe en el sitio, sin instalar nada en los teléfonos.
♻️
Una fuente, sin duplicar
Catálogo, familias y checklists viven una sola vez y alimentan a todos.
Cómo se usa · en 30 segundos
Fácil para quien está en el patio
La curva de aprendizaje es mínima. Tres ejemplos de los flujos más comunes.
Operador · N1
- Entra con tu clave y toca N1 Diaria.
- Elige tu unidad y anota el odómetro/horas.
- Marca cada punto en verde, amarillo o rojo.
- Envía: recibes tu folio y listo.
Técnico · N2
- Abre N2 Trimestral desde el Hub.
- Selecciona la unidad a revisar.
- Aprueba o anota la medición de cada sistema.
- Envía: las observaciones generan órdenes.
Cualquiera · Ticket
- Toca Levantar Ticket.
- Describe la falla y elige prioridad.
- Indica si la unidad puede operar.
- Envía: se crea la alerta y la orden.
Todo listo para operar
Tu flota, bajo control y con memoria
Un solo enlace para tu equipo. Cada quien entra, ve lo suyo y deja rastro. El resto — folios, alertas, tableros y la conexión a Odoo — el sistema lo hace por ti.
🔑 Punto de entrada del equipo: login.html
Punto Agave · Mantenimiento Productivo Total · 9-jul-2026
Estado del proyecto
En una frase: el sistema completo — ya con las mejoras que pidió el cliente (mapa visual de llantas,
formulario de ticket con sus datos, obligatorios y matriz de servicio) — está desplegado y funcionando en el
ambiente de pruebas (staging). Es la etapa de jugar y dar retroalimentación; el pase a producción
viene después, cuando el cliente valide.
✓
Mejoras del cliente aplicadas y en pruebas
3
Pasos para cerrar esta etapa
5
Pendientes / futuro (incluye producción)
Panorama por semáforo
✅ Ya funciona
verificado en vivo en staging
- Las mejoras que pidió el cliente — mapa visual de llantas (N2), ticket con sus datos (responsable, zona, estado operativo, reincidencia) y capturas obligatorias — ya están en el ambiente de pruebas. verificado en vivo 9-jul
- El ERP con el modelo nuevo — el ticket vive en Soporte al cliente (equipo Flotilla), pipeline de 8 etapas; unidad no operativa ⇒ urgente automático. puente verificado hoy
- 270 unidades con su matriz de servicio por familia y excepciones por unidad.
- Datos migrados al modelo nuevo y tablero con ejemplos por etapa.
- Checklists validados — los formularios del cliente coinciden 100% con el sistema (134 puntos).
- La presentación integral (Guía + Manual + este Avance) resubida al site.
🟡 Para cerrar la fase 1
listo, falta aplicar
- Un último enlace — el cerebro se publicó con liga nueva; los portales ya quedaron re-conectados y solo falta subir esa actualización al ambiente de pruebas. 1 push · todo lo demás validado
- Jugar y retroalimentar — el cliente prueba portales y tablero en staging y confirma 3 datos del inventario. retro → correcciones
- Limpieza ligera — borrar las filas de prueba etiquetadas "(borrar)" del registro. 2 min
🔴 Pendiente / futuro
no bloquea la fase 1
- Pase a producción — migrar toda la estrategia al Odoo productivo cuando el cliente valide en pruebas. lo grande que sigue · seguimos en staging
- Confirmaciones del cliente — 3 datos del inventario: intervalos de PA136 y TA30, y unidades sin responsable. al dar la retro
- Consolidar llantas y compras — limpieza interna, baja prioridad, no es core.
- KPIs económicos de inspección (N2/N3) — decidir alcance.
- Fotos reales del tablero para refrescar las ilustraciones de la Guía.
Ruta a producción
Construir
módulo + portales + GAS→
Desplegar a pruebas
staging ✓→
Retro del cliente
aplicada ✓→
Jugar en staging
estamos aquí→
Producción
pase en vivoPróximo paso inmediato
La validación de punta a punta ya pasó completa (9-jul): captura con datos obligatorios, ticket con la información del cliente, urgencia automática cuando la unidad no opera, y el estado de regreso al campo. Queda subir el último enlace de los portales al ambiente de pruebas y entregarle el juego al cliente. El pase a producción se hace después, con su visto bueno.
Grupo Veniu · VSolutions — Integrador de Mundos. Estado verificado en vivo en staging (puntoagave-staging) el 9-jul-2026 — puente y portales con la retro del cliente confirmados con pruebas reales. Detalle técnico →
BLUEPRINT_CONSOLIDACION_HIBRIDA.html · retro → RETRO_CLIENTE_SPEC_2026-07-07.md.
Punto Agave · Mantenimiento Productivo Total
El registro de datos — qué es cada hoja y cada columna
La hoja de cálculo (Google Sheets) es el registro central del sistema: todo lo que el equipo captura en los portales queda aquí, fila por fila, y de aquí viaja al sistema de gestión (Odoo). Esta guía explica para qué sirve cada pestaña, cada columna, y qué dato coincide con qué.
💡
La regla de oro: el Sheet no se llena a mano — lo llenan los portales y el propio
sistema. Se puede consultar y filtrar libremente, pero editar celdas a mano (o reordenar encabezados) puede romper el enlace.
Las columnas marcadas sistema son automáticas.
equipo la llena el equipo desde el portal
sistema la escribe el sistema automáticamente
admin carga inicial / administración
🗂️Mapa de pestañas (14)
🚚 Flota
El catálogo de las 270 unidades: quién es responsable, dónde opera y cada cuánto le toca servicio.
catálogo📋 Cat_N1 · Cat_N2 · Cat_N3
Los catálogos de puntos de inspección de cada nivel (los ~134 puntos y a qué familias aplican).
catálogo🏷️ Familias
Las 9 familias de equipo y su variable de control (kilómetros, horas o fecha).
catálogo☀️ Inspecciones
Una fila por cada inspección enviada (N1/N2/N3): quién, cuándo, resultado y su folio.
operación🔍 Insp_Items
El detalle punto por punto de cada inspección (semáforo, mediciones, llantas).
operación🚨 Alertas
Cada hallazgo (amarillo/rojo) o reporte se vuelve una alerta rastreable.
operación🎫 Tickets
Los levantamientos de ticket del equipo, con los datos de la operación (zona, responsable, estado operativo…).
operación🗓️ Plan_Servicio
El control del servicio preventivo por unidad: última lectura, próximo servicio y semáforo de cumplimiento.
operación⛽ Cargas_Combustible
Una fila por cada carga de combustible: litros, odómetro y el rendimiento (km por litro) que el sistema calcula solo.
operación👥 Usuarios · 🔑 Sesiones
Quién puede entrar a los portales, con qué rol; y las sesiones activas.
administración🧾 Log_Sync
La bitácora técnica de cada viaje de datos hacia el sistema de gestión (para diagnóstico).
técnica🔗Qué coincide con qué — la trazabilidad
Cada registro comparte un folio entre el Sheet y el sistema de gestión. Así se sigue la pista de punta a punta:
Portal → fila en el Sheet (folio) → ticket en Odoo (mismo folio) → el equipo lo avanza de etapa → estado_odoo regresa al Sheet
| Dato del Sheet | Con qué coincide | Qué te dice |
|---|---|---|
| folio | El campo "Folio" del ticket/inspección en Odoo | La llave de todo: mismo folio = mismo asunto en ambos lados |
| odoo_id / odoo_req_id | El número interno del registro en Odoo | Que el dato ya viajó y con qué identificador quedó allá |
| estado_sync | — | ok = ya está en Odoo · pendiente = por reintentar · local = es reflejo de un hallazgo (el ticket real en Odoo viaja con el folio de la inspección) |
| estado_odoo | La etapa actual del ticket en el tablero de Odoo | La VUELTA: el sistema la escribe cada hora — sin abrir Odoo sabes en qué va cada asunto |
🔁
Ejemplo vivo (9-jul-2026): la inspección
PA-N1-CC144-20260709-001 (1 amarillo + 1 rojo)
creó en Odoo la inspección PA-N1-0003 y 2 tickets preventivos (por venir de una inspección: aceite → prioridad media · frenos → URGENTE por el rojo). El ticket
PA-TK-LG118-20260709-001 ya avanzó a la etapa "2. Asignación y Programación" — cuando corra la sincronización horaria,
su columna estado_odoo lo dirá aquí en el Sheet. Y PA-TK-TA5-20260709-001 entró como URGENTE automático
porque la unidad se reportó No operativa.📗Hoja por hoja, columna por columna
🚚 Flota — el catálogo de unidades
| Columna | Quién | Qué es |
|---|---|---|
| eco | admin | Número económico — la llave de la unidad en TODO el sistema (ej. CC144) |
| familia · subtipo · tipo | admin | Familia (CC, LG, PS…), subtipo (MP-OR oruga…) y tipo descriptivo |
| placa · serie · anio · desc · marca · color | admin | Identificación del vehículo |
| empresa · responsable · chofer | admin | Empresa dueña, responsable de la unidad y operador asignado |
| lugar · zona · ceco | admin | Dónde opera y su centro de costos |
| captura · intervalo · medida | admin | Qué lectura se le pide (odómetro/horómetro/fecha) y cada cuánto le toca servicio (ej. 15,000 km) |
| estatus | admin | Activa / baja |
☀️ Inspecciones — una fila por inspección enviada
| Columna | Quién | Qué es |
|---|---|---|
| folio | sistema | Folio único (PA-N1-ECO-fecha-###) — coincide con Odoo |
| nivel · periodicidad | equipo | N1/N2/N3 y diaria/semanal/trimestral/anual |
| eco · familia | equipo | La unidad inspeccionada |
| fecha · lectura_tipo · lectura_valor · combustible | equipo | El encabezado obligatorio: fecha siempre + odómetro/horómetro según la unidad. Nota (retro 2): la columna combustible (nivel) ya no se usa — se conserva por compatibilidad y viaja vacía; el combustible ahora se controla en la pestaña ⛽ Cargas_Combustible |
| usuario · responsable · ubicacion | equipo | Quién capturó, quién responde por la unidad y dónde |
| resultado · indice_salud · n_amarillo · n_rojo · n_fallo | sistema | El semáforo general, el índice de salud y el conteo de hallazgos |
| decision | equipo | Solo N3: continuar / reparación mayor / reacondicionar / baja |
| odoo_id · estado_sync | sistema | El enlace con Odoo (ver trazabilidad) |
| ts | sistema | Fecha-hora exacta del registro |
🔍 Insp_Items — el detalle punto por punto
| Columna | Quién | Qué es |
|---|---|---|
| folio · n · seccion · punto | sistema | A qué inspección pertenece y qué punto del checklist es |
| tipo_control · valor · calificacion · medicion | equipo | Cómo se evaluó: semáforo (verde/amarillo/rojo), aprobado/fallo, medición o calificación 1-5 |
| que_viste · foto_url | equipo | La observación y la evidencia del hallazgo |
| accion · severidad | sistema | Qué disparó: todo hallazgo de inspección genera acción preventiva (regla de origen, retro 2); el color solo marca la severidad/prioridad (amarillo=media · rojo/fallo=urgente) |
| posicion · profundidad_mm · presion_psi | equipo | Solo llantas (N2): la posición del mapa visual con su profundidad y presión |
🎫 Tickets — los levantamientos del equipo
| Columna | Quién | Qué es |
|---|---|---|
| folio | sistema | PA-TK-ECO-fecha-### (directo) o TK-…-# (reflejo de un hallazgo de inspección) |
| eco · familia | equipo | La unidad del reporte |
| categoria · asunto · descripcion | equipo | Tipo de falla (motor, frenos, llantas…), título y el problema |
| prioridad · puede_operar · accion | equipo / sistema | Si la unidad puede operar la marca el equipo; la acción es automática por origen (ticket directo = correctivo · derivado de inspección = preventivo) y la prioridad la deriva el sistema (No operativa ⇒ urgente; si no, media) — nadie las elige |
| zona · responsable | equipo | La zona de la operación y el responsable de la unidad (se prellenan del catálogo) |
| estado_operativo · reincidencia | equipo | Operativa / No operativa (no operativa ⇒ URGENTE automático) · si ya se había reportado |
| ubicacion · reporta · lectura · foto · fecha | equipo | Dónde está la unidad, quién reporta, la lectura obligatoria (km/hrs) y evidencia |
| estado · odoo_req_id · estado_sync · estado_odoo · ts | sistema | El enlace y la VUELTA desde Odoo (ver trazabilidad) |
🚨 Alertas — cada hallazgo rastreable
| Columna | Quién | Qué es |
|---|---|---|
| id · folio | sistema | Id de la alerta y el folio de la inspección/ticket que la originó |
| eco · familia · tipo · punto · descripcion · prioridad | sistema | Qué unidad, qué punto falló y su tipo (automático por origen: inspección=preventivo · directo=correctivo) con su prioridad según el color |
| estado · odoo_req_id · estado_odoo · ts | sistema | Estado de la alerta y su enlace/etapa en Odoo |
🗓️ Plan_Servicio — el preventivo por unidad
| Columna | Quién | Qué es |
|---|---|---|
| eco · familia · intervalo · medida | admin | Cada cuánto le toca servicio a la unidad (km / hrs / días, con sus excepciones) |
| ultimo_serv · lectura_ultimo | sistema | Cuándo fue el último servicio y con qué lectura |
| proximo_serv · estado | sistema | Cuándo toca el siguiente y el semáforo: a tiempo / por cumplir / vencido (tolerancias ±500 km · ±50 hrs · ±15 días) |
⛽ Cargas_Combustible — cada carga, con su rendimiento
Pestaña nueva (retro 2): el nivel de combustible dejó de anotarse en las inspecciones; lo que sí se registra es cada carga desde el portal de Carga de combustible. Con dos cargas seguidas de la misma unidad, el sistema calcula solo cuántos kilómetros rindió cada litro.
| Columna | Quién | Qué es |
|---|---|---|
| id | sistema | Identificador único de la carga |
| eco · familia | equipo | La unidad que cargó combustible |
| fecha · litros · costo | equipo | Cuándo se cargó, cuántos litros y (opcional) cuánto costó |
| odometro | equipo | El odómetro al momento de la carga. Regla de oro: debe ser igual o mayor al de la carga anterior de esa unidad — el sistema rechaza lecturas que "retroceden" |
| odometro_anterior · km_recorridos | sistema | El odómetro de la carga anterior y la diferencia: los kilómetros recorridos entre carga y carga |
| rendimiento_km_l | sistema | km recorridos ÷ litros de la carga anterior — cuántos km rindió cada litro. Con esto se compara el rendimiento por unidad y por familia (se ve en Planificación) |
| usuario · ts | sistema | Quién registró la carga y la fecha-hora exacta |
⛽
Cómo leerla: la primera carga de una unidad no trae rendimiento (no hay carga anterior
con qué comparar). A partir de la segunda, cada fila dice cuántos km recorrió la unidad desde la carga pasada y qué rendimiento
dieron esos litros. Si el rendimiento de una unidad cae de golpe, es señal de revisión.
👥 Usuarios · 🔑 Sesiones · 🧾 Log_Sync (administración y técnica)
Usuarios (usuario · hash · rol · nombre · activo): quién entra a los portales y con qué rol
(operador / técnico / jefe / admin). La contraseña se guarda cifrada — nadie puede leerla.
Sesiones: los accesos activos (se limpian solos al expirar). Log_Sync: la bitácora técnica de cada
viaje de datos (fecha, entidad, folio, resultado) — útil para diagnóstico, no se edita.
⚠️
Tres cuidados: (1) no edites a mano las columnas del sistema (folios, odoo_id, estados);
(2) no reordenes ni renombres los encabezados de fila 1; (3) si necesitas corregir un dato capturado, corrige en el
portal/Odoo — el Sheet es el registro, no el editor.
Grupo Veniu · VSolutions — Integrador de Mundos. Guía del registro de datos · columnas reales del sistema (jul-2026).
Trazabilidad: mismo folio en el Sheet y en Odoo · la etapa regresa sola en estado_odoo.
🌵
Punto Agave TPM
Acceso a la demostración integral. Escribe la clave de acceso.
powered by Grupo Veniu · VSolutions
Punto Agave · Mantenimiento Productivo Total
El sistema de flotilla, de punta a punta
Una sola ventana para navegar toda la solución: los portales de captura en campo, el cerebro que conecta, y el ERP donde se gestiona. Desde aquí entras a cada pieza de la demostración.
◆La idea en 30 segundos
Tres mundos conectados en doble vía: lo que se captura en campo sube al ERP, y lo que se resuelve en el ERP regresa como estado a quien lo reportó. Sin doble captura.
1 · Portales
Inspecciones N1/N2/N3 y levantamiento de tickets, desde el celular en campo.
HTML · captura→firmado
2 · Cerebro
Hoja + Apps Script: registra, valida y sincroniza los datos en ambos sentidos.
Google Sheet · GAS→puente
3 · Odoo (ERP)
Inspecciones como registro + tickets con pipeline, SLA y conformidad.
Staging · Odoo v19El estado del ticket regresa del ERP al tablero de campo automáticamente (rebote inverso).
▸Entra a cada pieza
Interno · Dirección
Estos accesos son de backend/operación. Compártelos solo con el equipo de dirección.
◆Qué ver en cada lado
- En los portales: llena una inspección N1 (semáforo 🟢🟡🔴) o levanta un ticket → sale un folio al instante.
- En Odoo → Inspecciones TPM: aparece la inspección completa con sus 63 puntos, profundidades y semáforo.
- En Odoo → Tickets / Órdenes (Soporte al cliente): cada hallazgo se vuelve un ticket con su pipeline de 8 etapas — de "Recepción" a "Cerrado / Conformidad".
- La doble vía: avanza el ticket en Odoo y el estado regresa al tablero de campo. Nadie captura dos veces.
Grupo Veniu · VSolutions — Integrador de Mundos. Presentación integral de la demostración Punto Agave TPM.
Guía de uso y demo
Manual del cliente
El registro de datos — guía de hojas y columnas
Avance del proyecto
🌵 Punto Agave · TPMGuía de uso y demo
Guía para el equipo · Sistema de Inspecciones TPM
Cómo probar y usar el sistema, paso a paso.
Esta guía es para todos — no necesitas saber Odoo. Te explica dónde entrar, qué portal usar para cada cosa, cómo se ve en Odoo y quién puede ver qué. Léela de arriba a abajo o salta a la sección que necesites.
Antes de empezar
Son dos mundos que se hablan solos
El sistema tiene dos partes que se conectan automáticamente. Entender esto hace que todo lo demás sea fácil:
📱
El equipo, en campo
Los Portales
Páginas web sencillas (funcionan en celular, tablet o compu). Aquí el operador, el técnico y el jefe llenan las inspecciones y levantan tickets. Es como llenar un formulario: eliges la unidad, marcas lo que revisaste, y envías.
No hay que instalar nada ni saber de sistemas.
🏢
La administración, en oficina
Odoo
El sistema de gestión (en computadora). Aquí llega automáticamente todo lo que capturó el campo: cada inspección se vuelve una orden de trabajo, con su unidad, su prioridad y su historial. El jefe da seguimiento y cierra las órdenes.
Es donde se ve el panorama completo y se toman decisiones.
🔗
La magia (la "doble vía"): cuando alguien envía una inspección en el Portal, aparece sola en Odoo segundos después. Y cuando en Odoo cambias el estado de una orden, ese estado regresa al sistema. Nadie recaptura nada, y todo queda con folio y rastro de quién lo hizo.
Parte 1 · Los Portales
Entrar y usar los portales (el equipo)
Cómo entrar
- Abre la liga de acceso en el navegador (Chrome, celular o compu):
https://puntoagave-staging-34527386.dev.odoo.com/mantenimiento/loginEs la ÚNICA liga que se reparte. Desde ahí se llega a todo lo demás. - Escribe tu usuario y contraseña.Usuarios de ejemplo: admin, aldo.luna (jefe), tecnico1 (técnico), felipe.gonzalez (operador). Contraseña de todos en la demo: agave2026.
- Entras al Hub (el menú principal).Solo verás los portales que te tocan por tu rol — así nadie se pierde.
📱
Tip: en el celular, agrega la página al inicio ("Añadir a pantalla de inicio") y queda como si fuera una app.
¿Qué portal se usa para cada cosa?
| Portal | ¿Para qué? | ¿Quién? | ¿Cuándo? |
|---|---|---|---|
| ☀️ N1 Diaria | Revisión rápida antes de operar (semáforo: bien / atender / detener) | Operador | Todos los días |
| 📅 N1 Semanal | Revisión un poco más a fondo, también con semáforo | Operador | Cada semana |
| 🔧 N2 Trimestral | Revisión técnica con mediciones (llantas, presiones, holguras): aprobado / valor | Técnico | Cada 3 meses |
| 📋 N3 Anual | Evaluación del estado general de la unidad, calificación 1–5 | Jefe | Una vez al año |
| 🎫 Ticket | Reportar una falla puntual cuando surge (fuera del calendario) | Operador · Técnico · Jefe · Administrativo | Cuando se necesite |
| ⛽ Carga de combustible | Registrar cada carga: litros y odómetro (+ costo opcional) — el sistema calcula solo el rendimiento (km por litro) de la unidad | Operador en adelante | En cada carga |
| 🚚 Catálogo de Flota | Consultar las 270 unidades y dar de alta una nueva | Técnico · Jefe | Al agregar unidades |
| 🗓️ Planificación | Tablero de qué toca revisar y cuándo (solo lectura) | Jefe | Para planear |
| 🔐 Accesos | Dar de alta usuarios, cambiar roles, resetear contraseñas | Admin | Al administrar el equipo |
Ejemplo: llenar una inspección diaria (N1)
- Entra a "N1 Diaria" desde el Hub.
- Busca tu unidad por número económico (ej. CC144) o descripción. El sistema ya sabe qué revisar según la familia de esa unidad.
- Anota la lectura (odómetro, horómetro o fecha, según la unidad).El nivel de combustible ya no se pide aquí — el combustible se registra al cargar, en su propio portal (ver abajo).
- Marca cada punto: casi todo queda en verde solo. Si algo está mal, lo pones en amarillo (atender pronto) o rojo (detener). Ahí te pide "¿qué viste?" y foto.
- Envía. Recibes un folio (ej. PA-N1-CC144-…-001) y listo.En ese momento la inspección ya viajó a Odoo y, si hubo amarillos/rojos, se creó la orden de trabajo.
✅
Los demás portales (N2, N3, Ticket) funcionan igual de sencillo: eliges la unidad, llenas, envías. Cambia solo la forma de evaluar (medición, calificación, o el reporte del ticket).
🛞 Llantas en la N1: "OK" o "Reportar"
El punto de llantas de la revisión diaria es de dos botones: si todo está bien, tocas LLANTAS OK y sigues. Si algo no te gusta, tocas REPORTAR y se abre el dibujo de tu unidad con sus llantas numeradas — tocas la(s) que tienen el problema.
- La numeración es la referencia de todos: se cuenta desde el piloto hacia atrás, de izquierda a derecha. La 1 es la delantera izquierda y la 2 la delantera derecha; en cada eje trasero se sigue el orden izquierda-exterior, izquierda-interior, derecha-interior, derecha-exterior (3, 4, 5, 6…), y los repuestos van al final.Ese número es el que viaja en el reporte — "la llanta 3" significa lo mismo para el operador, el técnico y la oficina.
- Por cada llanta que reportes eliges su condición: DAÑADA (tiene un daño) · REEMPLAZO (ya hay que cambiarla) · MEDIA VIDA (va a medio desgaste, para tenerla en la mira).
- Envías y listo: el reporte llega a la oficina con la unidad, el número de llanta y su condición. Las condiciones más serias entran con mayor prioridad de atención.
🛞 La revisión de llantas ahora es visual (N2 Trimestral)
En la inspección trimestral, las llantas ya no se llenan en una lista: aparece un dibujo de tu unidad vista desde arriba, con sus llantas reales (4, 6 o 10 según la unidad, y sus repuestos). Igual que el diagrama que ustedes usan.
- Toca una llanta del dibujo → se abre su captura: profundidad (mm) y presión (psi).
- El color te habla: contorno verde = en buen estado · naranja = profundidad mínima cerca · rojo = mínima alcanzada (atender). El valor en mm queda visible bajo cada llanta.
- Rotación automática: si la diferencia de desgaste entre llantas supera 2 mm, el sistema te lo dice con un aviso — cuáles intercambiar (▼ la más gastada ⇄ ▲ la menos gastada) — y las marca en el dibujo.
🎨
Las barras de color de los ejes siguen la convención de su diagrama: amarillo = eje direccional · verde = eje de tracción · gris = eje libre. Hay una leyenda de convenciones dentro del portal ("Ver convenciones").
🎫 El ticket, con los datos de tu operación
El levantamiento de ticket ahora pide los mismos datos de su formato, para que nada se pierda:
| Dato | Qué es |
|---|---|
| Responsable y Zona | El dueño de la unidad y su zona — se prellenan solos al elegir la unidad. |
| Tipo de falla | La clasificación del problema (motor, frenos, llantas, eléctrico…). |
| Estado operativo | Operativa / No operativa. Si la unidad NO está operativa, el ticket se marca URGENTE automáticamente. |
| ¿Es reincidencia? | Si el mismo tema ya se había reportado antes. |
| Fecha y lectura | Obligatorias: la fecha siempre, y el odómetro/horómetro según la unidad — así toda la historia queda medible. |
| Fotos | Botón "📷 Tomar fotografía" — desde el celular abres la cámara directo (hasta 3 evidencias). |
⚙️
Ya no eliges tipo ni prioridad — el sistema los pone solo: un ticket que levantas
directo entra como correctivo; un hallazgo que sale de una inspección entra como preventivo. Y la prioridad se deriva sola
(unidad No operativa ⇒ urgente; si no, media). Tú solo describes la falla — el sistema clasifica.
🛞
Si el tipo de falla es llantas, aparece el mismo dibujo numerado de la unidad:
tocas la(s) llanta(s) y eliges su condición (dañada / reemplazo / media vida). El número de llanta es la referencia del ticket.
🔁
El estatus del ticket sigue el camino que ya conocen: REPORTADO (al enviarlo del portal) → ASIGNADO → EN REPARACIÓN → FINALIZADO. Esas etapas se avanzan en el tablero de la oficina (Odoo), y el estado regresa solo al sistema del campo.
Parte 2 · Odoo (sin experiencia previa)
Entrar y navegar Odoo (la gestión)
Odoo es el sistema donde llega todo. No te asustes: solo usaremos un menú. Aquí va lo mínimo para moverte con confianza.
Cómo entrar a Odoo
- Abre la liga de Odoo en la computadora:
https://puntoagave-staging-34527386.dev.odoo.com/odoo - Inicia sesión con tu usuario y contraseña de Odoo (te los da el administrador; son distintos de los del portal).
- Verás la pantalla de Aplicaciones.Es una cuadrícula de íconos (o un menú arriba a la izquierda). Cada ícono es un módulo.
- Entra a la app "Punto Agave TPM".Si no la ves de inmediato, haz clic en el menú de arriba a la izquierda (☰ o el nombre del módulo actual) y elígela de la lista.
El menú "Punto Agave TPM" — qué hay en cada lado
Una vez dentro, arriba aparece la barra del módulo. Estas son las opciones y para qué sirven:
| Menú (arriba) | Qué ves ahí |
|---|---|
| Inspecciones | La lista de todas las inspecciones que capturó el campo (folio, unidad, nivel N1/N2/N3, resultado semáforo, fecha, quién la hizo). Haz clic en una para ver el detalle completo y las órdenes que generó. |
| Tickets / Órdenes | Las órdenes de trabajo de mantenimiento (lo que hay que reparar). Vienen de las inspecciones (siempre preventivas; el color solo marca la prioridad) y de los tickets directos (siempre correctivos). Se ven en tablero Kanban por etapas. |
| Presupuestos | Presupuestos de compra para reparar (el técnico arma, el jefe aprueba, se genera la orden de compra). Opcional. |
| Llantas | Control de llantas como activo (posición, desgaste, rotación, costo por km). |
| Flota | Las 270 unidades con su ficha (económico, placa, familia, responsable). |
| Configuración | Catálogos internos (puntos de inspección, familias, marcas de llanta). Casi no se toca. |
Así se ve Odoo (ilustrado)
Estas son ilustraciones de las pantallas reales para que reconozcas dónde estás. Los colores y el menú morado son los de Odoo.
puntoagave-staging-34527386.dev.odoo.com/odoo
Punto Agave TPM
InspeccionesTickets / ÓrdenesPresupuestosLlantasFlotaConfiguración
🌵
Punto Agave TPM🔧
Mantenimiento🚚
Flota📊
TableroPantalla 1 A La cuadrícula de Aplicaciones — entra a “Punto Agave TPM”. B Ya dentro, arriba aparece la barra morada del módulo con los menús.
…/odoo/action-… · Punto Agave TPM › Inspecciones
Punto Agave TPMInspeccionesTickets / ÓrdenesFlota
Inspecciones
| Folio | Unidad | Nivel | Resultado | Fecha | Capturó |
|---|---|---|---|---|---|
| PA-N1-0002 | CC144 · NAVISTAR | N1 | Amarillo | 06/07/2026 | admin |
| PA-N1-0001 | LG118 · NISSAN NP300 | N1 | Rojo | 06/07/2026 | admin |
Pantalla 2 A Menú Inspecciones: la lista de todo lo que capturó el campo. B Haz clic en una fila (ej. PA-N1-0002) para ver el detalle y sus órdenes.
…/odoo/action-… · Punto Agave TPM › Tickets / Órdenes
Punto Agave TPMInspeccionesTickets / ÓrdenesFlota
Órdenes de trabajo
Nueva solicitud 2
Aceite en nivelCC144 · preventivo
No enciendeTA5 · correctivo
En progreso 0
Reparado 0
Pantalla 3 A Menú Tickets / Órdenes: las órdenes en columnas por etapa. B Para avanzar una orden, arrastra la tarjeta a la siguiente columna (o ábrela y cambia la etapa) — eso es lo que regresa al sistema del campo.
Ver una inspección que llegó del campo
- Clic en Inspecciones. Aparece la lista; la más reciente arriba.
- Clic en la fila (ej. PA-N1-0002 · CC144). Se abre la ficha: nivel, unidad, resultado, y los puntos marcados con "¿qué viste?".
- Arriba (botones inteligentes) o en la ficha verás las órdenes de trabajo que generó esa inspección.
Ver y mover una orden de trabajo (el tablero Kanban)
- Clic en Tickets / Órdenes. Verás columnas (etapas): p.ej. Nueva solicitud → En progreso → Reparado.
- Cada tarjeta es una orden (dice la unidad y el problema). Haz clic para ver el detalle.
- Para avanzar una orden, arrastra la tarjeta a la siguiente columna (o abre la orden y cambia la etapa).Ese cambio de estado es justo lo que regresa al sistema del campo (la "vuelta").
🧭
Regla de oro para no perderte en Odoo: casi todo se hace con clics en listas y tarjetas. Si te pierdes, vuelve al menú "Punto Agave TPM" arriba y empieza de nuevo.
Parte 3 · La doble vía
El recorrido completo de una inspección
Esto es lo que hay que mostrar para que se entienda el valor: una inspección viaja sola del campo a la oficina y de regreso.
- Campo (Portal): el operador llena la N1 de una unidad y marca un amarillo → Enviar. Sale el folio.
- Viaje automático: el sistema guarda todo y lo empuja a Odoo (con firma de seguridad, sin que nadie recapture).
- Oficina (Odoo): segundos después, en Inspecciones aparece la inspección, y en Tickets / Órdenes aparece la orden preventiva con la unidad correcta.
- Seguimiento (Odoo): el jefe mueve la orden a "En progreso" / "Reparado".
- Regreso (la vuelta): ese estado regresa al sistema del campo, para que todos vean que ya se atendió.Trazabilidad completa: quién revisó, qué encontró, qué orden se generó y cómo terminó.
🎯
El mensaje para el cliente: "Tu equipo solo llena una pantalla sencilla en el celular. La administración ve todo ordenado en Odoo, con órdenes de trabajo automáticas y sin doble captura. Nada se pierde."
Roles y permisos
Quién ve qué — y cómo se asigna
| Rol | En los Portales | En Odoo |
|---|---|---|
| Operador | N1 Diaria/Semanal + Ticket | Ve inspecciones y órdenes (no borra) |
| Técnico | N2 + Catálogo + Ticket | + ejecuta mantenimiento, llantas, presupuestos |
| Jefe | N1/N2/N3 + Planificación + Catálogo | + aprueba presupuestos, control total de datos |
| Admin | Todo + Accesos | Control total, incluye borrado y configuración |
🔑
Importante (una sola vez, lo hace el administrador): para que un usuario vea el menú "Punto Agave TPM" en Odoo, hay que asignarle su grupo. En Odoo: Ajustes → Usuarios → (elegir usuario) → asignar el grupo "Punto Agave TPM / [rol]". Sin esto, el usuario entra a Odoo pero no ve el módulo.
Guión de demostración
Cómo presentarlo en 6 pasos
Guión sugerido para mostrar el sistema funcionando de punta a punta (10–15 min). Ten abiertas dos pestañas: el Portal y Odoo.
- Presenta los dos mundos. "Esto es lo que usa el equipo en campo (Portal, en el celular) y esto lo que ve la administración (Odoo)." Muestra el login del portal y el Hub.
- Llena una N1 en vivo. Elige una unidad (ej. CC144), marca un amarillo con "¿qué viste?", envía. Muestra el folio.
- Cambia a la pestaña de Odoo → Inspecciones → refresca. "Miren: ya llegó sola, sin recapturar." Abre la inspección.
- Muestra la orden generada en Tickets / Órdenes: la orden preventiva con la unidad correcta.
- Mueve la orden en el Kanban a "En progreso". "Este estado regresa al sistema — todos saben que ya se está atendiendo."
- Cierra con el panorama: muestra la Flota (270 unidades) y el Hub por rol. "Un solo enlace para el equipo, todo ordenado en Odoo, cero doble captura."
💡
Consejo: antes de la demo, ten a la mano 1–2 unidades y un usuario de cada rol. Y no reconstruyas el sistema de staging durante la presentación (las ligas podrían cambiar).
🛞
El momento "wow": abre N2 Trimestral con un camión agavero (ej. CC144) y muestra el mapa de llantas: toca dos llantas, captura profundidades distintas (ej. 2 y 8 mm) y deja que el sistema recomiende la rotación solo. Es la imagen que el cliente pidió, viva.
Ligas rápidas (staging)
🔑 Portal (equipo): …/mantenimiento/login · contraseña demo agave2026
🏢 Odoo (gestión): …/odoo · usuario y contraseña de Odoo
(Base: https://puntoagave-staging-34527386.dev.odoo.com)
Punto Agave · TPMInspecciones de flota
Sheet
GAS
Odoo
Mantenimiento Productivo Total · Flota Punto Agave
El mantenimiento que se adelanta a la falla.
Un sistema vivo que lleva tus 270 unidades del papel disperso a un pulso digital: inspecciones por niveles, semáforo en tiempo real y trazabilidad de quién revisó qué — conectado a Odoo.
270Unidades
9Familias
3+1Niveles + Ticket
10Portales
Desliza
Para qué sirve
De apagar incendios a prevenirlos
TPM (Mantenimiento Productivo Total) es una forma de cuidar la flota donde la falla se anticipa, no se persigue. El sistema pone esa filosofía en manos de tu equipo, todos los días, desde el celular.
◦ Antes — mantenimiento reactivo
- La unidad se revisa "cuando se acuerdan" o cuando ya falló.
- Los checklists viven en papel o en Excel sueltos, sin rastro.
- No se sabe quién revisó, cuándo, ni qué encontró.
- La orden de reparación se pierde entre WhatsApp y libretas.
➜
● Ahora — mantenimiento que previene
- Cada unidad tiene su ritmo: diario, semanal, trimestral, anual.
- Se captura en campo con semáforo — verde, amarillo, rojo.
- Cada inspección deja folio y responsable: trazabilidad total.
- Un hallazgo rojo levanta la alerta y la orden, y viaja a Odoo.
🎯
Una sola verdad
Los portales, la hoja de datos y Odoo hablan del mismo catálogo de 270 unidades. Nada se captura dos veces.
🛡️
Nada se cae
Si un hallazgo bloquea la unidad, el sistema lo marca y evita que salga a operar con un riesgo abierto.
📈
Decisiones con datos
Los jefes ven cumplimiento, índice de salud y plan de servicio en tableros, sin pedir reportes a mano.
Cómo llegamos aquí
El recorrido: del diagnóstico al sistema vivo
No empezamos por la pantalla bonita. Empezamos por entender la flota y terminamos con un sistema conectado que ya escribe en tu hoja real y deja rastro hacia Odoo.
1
Diagnóstico
Mapeamos la flota real
Levantamos las 270 unidades y las agrupamos en 9 familias, cada una con su forma de medir el uso (odómetro, horómetro o calendario). Esa es la base de todo: sin catálogo confiable no hay plan de servicio.
2
Metodología TPM
Digitalizamos los checklists por niveles
Convertimos las revisiones en 3 niveles con sus puntos exactos: N1 diaria/semanal (operador), N2 trimestral (técnico) y N3 anual (jefe). Cada punto sabe si es semáforo, medición o calificación.
3
Portales conectados
Interfaces por rol + backend real
Construimos 10 portales que se abren según el rol y que ya vienen conectados: cada envío se firma, escribe en tu Google Sheet y muestra el dato en vivo. Login obligatorio para saber quién hizo qué.
4
Trazabilidad a Odoo
Cerramos el círculo hacia el ERP
Las inspecciones y órdenes viajan a Odoo (Calidad · Mantenimiento · Flotilla) con folio y sincronización, para que el mantenimiento viva en el mismo sistema que el resto de la operación.
La flota · 270 unidades
9 familias, cada una con su ritmo
No todas las unidades se miden igual. Un camión cuenta kilómetros; una máquina, horas; un implemento, días. El sistema respeta esa diferencia para calcular cuándo toca servicio.
ImplementosIM · calendarioDías
146
LigeraLG · odómetroKms
41
Tractor agrícolaTA · horómetroHrs
29
PesadaPS · odómetroKms
18
PasajerosPA · odómetroKms
11
Maquinaria pesadaMP · horómetroHrs
9
AgaveroCC · odómetroKms
8
VolteoVO · calendarioDías
4
PipaPP · calendarioDías
4
Insight Por eso el catálogo importa: el "próximo servicio" de un tractor se dispara por horas de motor, no por kilómetros.
La metodología · 3 niveles + ticket
Cada revisión, en su nivel
Del vistazo diario del operador a la calificación anual del jefe. Toca una pestaña para ver quién la hace, con qué frecuencia y cómo se evalúa.
Nivel 1 · Operativo
El pulso diario de la unidad
El operador revisa lo esencial antes de arrancar: niveles, llantas, luces, fugas. Es rápido, visual y se resuelve con un semáforo. Su versión semanal profundiza un poco más.
QuiénOperador
FrecuenciaDiaria · Semanal
Puntos34 puntos de checklist
Cómo evalúaSemáforo Verde / Amarillo / Rojo
Verde — Todo bienLa unidad opera sin observaciones.
Amarillo — Atender prontoGenera una alerta preventiva; se programa.
Rojo — DetenteAlerta correctiva: la unidad se marca y no debe operar.
Nivel 2 · Técnico
La revisión a fondo del técnico
Cada trimestre el técnico verifica sistemas completos y toma mediciones reales (presiones, holguras, desgastes). No es solo "sí/no": es aprobado o valor medido contra referencia.
QuiénTécnico de mantenimiento
FrecuenciaTrimestral
Puntos60 puntos de checklist
Cómo evalúaAprobado / Medición vs referencia
🔧
Sistemas completos
Frenos, motor, dirección, suspensión — revisados por bloque.
📏
Con medición
Se anota el valor y el sistema lo compara con la referencia.
Nivel 3 · Gestión
La evaluación anual del jefe
Una vez al año el jefe de mantenimiento califica el estado integral de la unidad en una escala de 1 a 5. Es la mirada estratégica: qué unidades renovar, cuáles vigilar, cómo va la salud de la flota.
QuiénJefe de mantenimiento
FrecuenciaAnual
Puntos40 puntos de checklist
Cómo evalúaCalificación 1 – 5
1 → 5 · ESTADO INTEGRAL
Bajo demanda
El ticket: reportar cuando algo surge
Fuera del calendario, cualquiera puede levantar un ticket cuando detecta una falla: describe qué pasó, si la unidad puede operar y con qué prioridad. El sistema lo convierte en alerta y orden al instante.
QuiénOperador · Técnico · Supervisor
FrecuenciaCuando se necesite
ResultadoAlerta + orden (correctivo/preventivo)
DestinoOdoo Mantenimiento
FOLIO GENERADO
TK-PA-N1-LG118-…-1
🔴 No puede operar
Prioridad alta
→ Odoo
Cómo funciona
Del inicio de sesión a Odoo, en un flujo
Así se ve una inspección de principio a fin. Cada paso deja rastro; nadie captura en el aire.
PASO 1
🔑Inicia sesión
El usuario entra con su clave. Su rol define qué portales ve.
PASO 2
🏠Elige en el Hub
El lanzador muestra solo las inspecciones que le tocan.
PASO 3
📝Captura en campo
Selecciona la unidad, registra la lectura y marca cada punto.
PASO 4
🚦Semáforo + folio
El sistema arma el resultado, genera folio y levanta alertas.
PASO 5
🔄Sincroniza a Odoo
Inspección y órdenes viajan al ERP con trazabilidad.
🧾
Trazabilidad de quién hizo qué
El portal ya no pregunta "¿quién eres?": toma el responsable de tu sesión y lo guarda en cada inspección. Siempre se sabe quién revisó cada unidad y cuándo — auditable por folio.
📶
La interfaz responde en vivo
Arriba a la derecha, los chips Sheet · GAS · Odoo muestran el estado real de la conexión. Si algo se cae, el portal sigue funcionando en modo seguro y no pierdes la captura.
Roles y accesos
Cada quién ve lo que le toca
Menos ruido, menos errores. Elige un rol y mira qué portales se le abren.
🔑Accesologin
🏠Hublanzador
☀️N1 Diarian1-diaria
📅N1 Semanaln1-semanal
🎫Ticketticket
🔧N2 Trimestraln2-trimestral
🚚Catálogocatalogo-flota
📋N3 Anualn3-anual
🗓️Planificaciónplanificacion
🔐Accesosadmin
La interfaz ya viene conectada
Tres capas, un solo sistema
No es una maqueta. Lo que el equipo captura en el portal se firma, se guarda en tu hoja de datos y llega a Odoo — la misma información recorre las tres capas sin recapturar.
📱PortalEl operador captura en el celular. Firma cada envío.
→firma HMAC
📊Google Sheet · GASRecibe, valida, genera folio y guarda. Tu base de datos viva.
→sincroniza
🏢OdooCalidad · Mantenimiento · Flotilla. El ERP de la operación.
🔐
Envíos firmados
Cada captura viaja firmada para que solo entren datos legítimos a la hoja.
🧩
Embebible donde ya trabajan
Los portales se integran por iframe en el sitio, sin instalar nada en los teléfonos.
♻️
Una fuente, sin duplicar
Catálogo, familias y checklists viven una sola vez y alimentan a todos.
Cómo se usa · en 30 segundos
Fácil para quien está en el patio
La curva de aprendizaje es mínima. Tres ejemplos de los flujos más comunes.
Operador · N1
- Entra con tu clave y toca N1 Diaria.
- Elige tu unidad y anota el odómetro/horas.
- Marca cada punto en verde, amarillo o rojo.
- Envía: recibes tu folio y listo.
Técnico · N2
- Abre N2 Trimestral desde el Hub.
- Selecciona la unidad a revisar.
- Aprueba o anota la medición de cada sistema.
- Envía: las observaciones generan órdenes.
Cualquiera · Ticket
- Toca Levantar Ticket.
- Describe la falla y elige prioridad.
- Indica si la unidad puede operar.
- Envía: se crea la alerta y la orden.
Todo listo para operar
Tu flota, bajo control y con memoria
Un solo enlace para tu equipo. Cada quien entra, ve lo suyo y deja rastro. El resto — folios, alertas, tableros y la conexión a Odoo — el sistema lo hace por ti.
🔑 Punto de entrada del equipo: login.html
Punto Agave · Mantenimiento Productivo Total · 9-jul-2026
Estado del proyecto
En una frase: el sistema completo — ya con las mejoras que pidió el cliente (mapa visual de llantas,
formulario de ticket con sus datos, obligatorios y matriz de servicio) — está desplegado y funcionando en el
ambiente de pruebas (staging). Es la etapa de jugar y dar retroalimentación; el pase a producción
viene después, cuando el cliente valide.
✓
Mejoras del cliente aplicadas y en pruebas
3
Pasos para cerrar esta etapa
5
Pendientes / futuro (incluye producción)
Panorama por semáforo
✅ Ya funciona
verificado en vivo en staging
- Las mejoras que pidió el cliente — mapa visual de llantas (N2), ticket con sus datos (responsable, zona, estado operativo, reincidencia) y capturas obligatorias — ya están en el ambiente de pruebas. verificado en vivo 9-jul
- El ERP con el modelo nuevo — el ticket vive en Soporte al cliente (equipo Flotilla), pipeline de 8 etapas; unidad no operativa ⇒ urgente automático. puente verificado hoy
- 270 unidades con su matriz de servicio por familia y excepciones por unidad.
- Datos migrados al modelo nuevo y tablero con ejemplos por etapa.
- Checklists validados — los formularios del cliente coinciden 100% con el sistema (134 puntos).
- La presentación integral (Guía + Manual + este Avance) resubida al site.
🟡 Para cerrar la fase 1
listo, falta aplicar
- Un último enlace — el cerebro se publicó con liga nueva; los portales ya quedaron re-conectados y solo falta subir esa actualización al ambiente de pruebas. 1 push · todo lo demás validado
- Jugar y retroalimentar — el cliente prueba portales y tablero en staging y confirma 3 datos del inventario. retro → correcciones
- Limpieza ligera — borrar las filas de prueba etiquetadas "(borrar)" del registro. 2 min
🔴 Pendiente / futuro
no bloquea la fase 1
- Pase a producción — migrar toda la estrategia al Odoo productivo cuando el cliente valide en pruebas. lo grande que sigue · seguimos en staging
- Confirmaciones del cliente — 3 datos del inventario: intervalos de PA136 y TA30, y unidades sin responsable. al dar la retro
- Consolidar llantas y compras — limpieza interna, baja prioridad, no es core.
- KPIs económicos de inspección (N2/N3) — decidir alcance.
- Fotos reales del tablero para refrescar las ilustraciones de la Guía.
Ruta a producción
Construir
módulo + portales + GAS→
Desplegar a pruebas
staging ✓→
Retro del cliente
aplicada ✓→
Jugar en staging
estamos aquí→
Producción
pase en vivoPróximo paso inmediato
La validación de punta a punta ya pasó completa (9-jul): captura con datos obligatorios, ticket con la información del cliente, urgencia automática cuando la unidad no opera, y el estado de regreso al campo. Queda subir el último enlace de los portales al ambiente de pruebas y entregarle el juego al cliente. El pase a producción se hace después, con su visto bueno.
Grupo Veniu · VSolutions — Integrador de Mundos. Estado verificado en vivo en staging (puntoagave-staging) el 9-jul-2026 — puente y portales con la retro del cliente confirmados con pruebas reales. Detalle técnico →
BLUEPRINT_CONSOLIDACION_HIBRIDA.html · retro → RETRO_CLIENTE_SPEC_2026-07-07.md.
Punto Agave · Mantenimiento Productivo Total
El registro de datos — qué es cada hoja y cada columna
La hoja de cálculo (Google Sheets) es el registro central del sistema: todo lo que el equipo captura en los portales queda aquí, fila por fila, y de aquí viaja al sistema de gestión (Odoo). Esta guía explica para qué sirve cada pestaña, cada columna, y qué dato coincide con qué.
💡
La regla de oro: el Sheet no se llena a mano — lo llenan los portales y el propio
sistema. Se puede consultar y filtrar libremente, pero editar celdas a mano (o reordenar encabezados) puede romper el enlace.
Las columnas marcadas sistema son automáticas.
equipo la llena el equipo desde el portal
sistema la escribe el sistema automáticamente
admin carga inicial / administración
🗂️Mapa de pestañas (14)
🚚 Flota
El catálogo de las 270 unidades: quién es responsable, dónde opera y cada cuánto le toca servicio.
catálogo📋 Cat_N1 · Cat_N2 · Cat_N3
Los catálogos de puntos de inspección de cada nivel (los ~134 puntos y a qué familias aplican).
catálogo🏷️ Familias
Las 9 familias de equipo y su variable de control (kilómetros, horas o fecha).
catálogo☀️ Inspecciones
Una fila por cada inspección enviada (N1/N2/N3): quién, cuándo, resultado y su folio.
operación🔍 Insp_Items
El detalle punto por punto de cada inspección (semáforo, mediciones, llantas).
operación🚨 Alertas
Cada hallazgo (amarillo/rojo) o reporte se vuelve una alerta rastreable.
operación🎫 Tickets
Los levantamientos de ticket del equipo, con los datos de la operación (zona, responsable, estado operativo…).
operación🗓️ Plan_Servicio
El control del servicio preventivo por unidad: última lectura, próximo servicio y semáforo de cumplimiento.
operación⛽ Cargas_Combustible
Una fila por cada carga de combustible: litros, odómetro y el rendimiento (km por litro) que el sistema calcula solo.
operación👥 Usuarios · 🔑 Sesiones
Quién puede entrar a los portales, con qué rol; y las sesiones activas.
administración🧾 Log_Sync
La bitácora técnica de cada viaje de datos hacia el sistema de gestión (para diagnóstico).
técnica🔗Qué coincide con qué — la trazabilidad
Cada registro comparte un folio entre el Sheet y el sistema de gestión. Así se sigue la pista de punta a punta:
Portal → fila en el Sheet (folio) → ticket en Odoo (mismo folio) → el equipo lo avanza de etapa → estado_odoo regresa al Sheet
| Dato del Sheet | Con qué coincide | Qué te dice |
|---|---|---|
| folio | El campo "Folio" del ticket/inspección en Odoo | La llave de todo: mismo folio = mismo asunto en ambos lados |
| odoo_id / odoo_req_id | El número interno del registro en Odoo | Que el dato ya viajó y con qué identificador quedó allá |
| estado_sync | — | ok = ya está en Odoo · pendiente = por reintentar · local = es reflejo de un hallazgo (el ticket real en Odoo viaja con el folio de la inspección) |
| estado_odoo | La etapa actual del ticket en el tablero de Odoo | La VUELTA: el sistema la escribe cada hora — sin abrir Odoo sabes en qué va cada asunto |
🔁
Ejemplo vivo (9-jul-2026): la inspección
PA-N1-CC144-20260709-001 (1 amarillo + 1 rojo)
creó en Odoo la inspección PA-N1-0003 y 2 tickets preventivos (por venir de una inspección: aceite → prioridad media · frenos → URGENTE por el rojo). El ticket
PA-TK-LG118-20260709-001 ya avanzó a la etapa "2. Asignación y Programación" — cuando corra la sincronización horaria,
su columna estado_odoo lo dirá aquí en el Sheet. Y PA-TK-TA5-20260709-001 entró como URGENTE automático
porque la unidad se reportó No operativa.📗Hoja por hoja, columna por columna
🚚 Flota — el catálogo de unidades
| Columna | Quién | Qué es |
|---|---|---|
| eco | admin | Número económico — la llave de la unidad en TODO el sistema (ej. CC144) |
| familia · subtipo · tipo | admin | Familia (CC, LG, PS…), subtipo (MP-OR oruga…) y tipo descriptivo |
| placa · serie · anio · desc · marca · color | admin | Identificación del vehículo |
| empresa · responsable · chofer | admin | Empresa dueña, responsable de la unidad y operador asignado |
| lugar · zona · ceco | admin | Dónde opera y su centro de costos |
| captura · intervalo · medida | admin | Qué lectura se le pide (odómetro/horómetro/fecha) y cada cuánto le toca servicio (ej. 15,000 km) |
| estatus | admin | Activa / baja |
☀️ Inspecciones — una fila por inspección enviada
| Columna | Quién | Qué es |
|---|---|---|
| folio | sistema | Folio único (PA-N1-ECO-fecha-###) — coincide con Odoo |
| nivel · periodicidad | equipo | N1/N2/N3 y diaria/semanal/trimestral/anual |
| eco · familia | equipo | La unidad inspeccionada |
| fecha · lectura_tipo · lectura_valor · combustible | equipo | El encabezado obligatorio: fecha siempre + odómetro/horómetro según la unidad. Nota (retro 2): la columna combustible (nivel) ya no se usa — se conserva por compatibilidad y viaja vacía; el combustible ahora se controla en la pestaña ⛽ Cargas_Combustible |
| usuario · responsable · ubicacion | equipo | Quién capturó, quién responde por la unidad y dónde |
| resultado · indice_salud · n_amarillo · n_rojo · n_fallo | sistema | El semáforo general, el índice de salud y el conteo de hallazgos |
| decision | equipo | Solo N3: continuar / reparación mayor / reacondicionar / baja |
| odoo_id · estado_sync | sistema | El enlace con Odoo (ver trazabilidad) |
| ts | sistema | Fecha-hora exacta del registro |
🔍 Insp_Items — el detalle punto por punto
| Columna | Quién | Qué es |
|---|---|---|
| folio · n · seccion · punto | sistema | A qué inspección pertenece y qué punto del checklist es |
| tipo_control · valor · calificacion · medicion | equipo | Cómo se evaluó: semáforo (verde/amarillo/rojo), aprobado/fallo, medición o calificación 1-5 |
| que_viste · foto_url | equipo | La observación y la evidencia del hallazgo |
| accion · severidad | sistema | Qué disparó: todo hallazgo de inspección genera acción preventiva (regla de origen, retro 2); el color solo marca la severidad/prioridad (amarillo=media · rojo/fallo=urgente) |
| posicion · profundidad_mm · presion_psi | equipo | Solo llantas (N2): la posición del mapa visual con su profundidad y presión |
🎫 Tickets — los levantamientos del equipo
| Columna | Quién | Qué es |
|---|---|---|
| folio | sistema | PA-TK-ECO-fecha-### (directo) o TK-…-# (reflejo de un hallazgo de inspección) |
| eco · familia | equipo | La unidad del reporte |
| categoria · asunto · descripcion | equipo | Tipo de falla (motor, frenos, llantas…), título y el problema |
| prioridad · puede_operar · accion | equipo / sistema | Si la unidad puede operar la marca el equipo; la acción es automática por origen (ticket directo = correctivo · derivado de inspección = preventivo) y la prioridad la deriva el sistema (No operativa ⇒ urgente; si no, media) — nadie las elige |
| zona · responsable | equipo | La zona de la operación y el responsable de la unidad (se prellenan del catálogo) |
| estado_operativo · reincidencia | equipo | Operativa / No operativa (no operativa ⇒ URGENTE automático) · si ya se había reportado |
| ubicacion · reporta · lectura · foto · fecha | equipo | Dónde está la unidad, quién reporta, la lectura obligatoria (km/hrs) y evidencia |
| estado · odoo_req_id · estado_sync · estado_odoo · ts | sistema | El enlace y la VUELTA desde Odoo (ver trazabilidad) |
🚨 Alertas — cada hallazgo rastreable
| Columna | Quién | Qué es |
|---|---|---|
| id · folio | sistema | Id de la alerta y el folio de la inspección/ticket que la originó |
| eco · familia · tipo · punto · descripcion · prioridad | sistema | Qué unidad, qué punto falló y su tipo (automático por origen: inspección=preventivo · directo=correctivo) con su prioridad según el color |
| estado · odoo_req_id · estado_odoo · ts | sistema | Estado de la alerta y su enlace/etapa en Odoo |
🗓️ Plan_Servicio — el preventivo por unidad
| Columna | Quién | Qué es |
|---|---|---|
| eco · familia · intervalo · medida | admin | Cada cuánto le toca servicio a la unidad (km / hrs / días, con sus excepciones) |
| ultimo_serv · lectura_ultimo | sistema | Cuándo fue el último servicio y con qué lectura |
| proximo_serv · estado | sistema | Cuándo toca el siguiente y el semáforo: a tiempo / por cumplir / vencido (tolerancias ±500 km · ±50 hrs · ±15 días) |
⛽ Cargas_Combustible — cada carga, con su rendimiento
Pestaña nueva (retro 2): el nivel de combustible dejó de anotarse en las inspecciones; lo que sí se registra es cada carga desde el portal de Carga de combustible. Con dos cargas seguidas de la misma unidad, el sistema calcula solo cuántos kilómetros rindió cada litro.
| Columna | Quién | Qué es |
|---|---|---|
| id | sistema | Identificador único de la carga |
| eco · familia | equipo | La unidad que cargó combustible |
| fecha · litros · costo | equipo | Cuándo se cargó, cuántos litros y (opcional) cuánto costó |
| odometro | equipo | El odómetro al momento de la carga. Regla de oro: debe ser igual o mayor al de la carga anterior de esa unidad — el sistema rechaza lecturas que "retroceden" |
| odometro_anterior · km_recorridos | sistema | El odómetro de la carga anterior y la diferencia: los kilómetros recorridos entre carga y carga |
| rendimiento_km_l | sistema | km recorridos ÷ litros de la carga anterior — cuántos km rindió cada litro. Con esto se compara el rendimiento por unidad y por familia (se ve en Planificación) |
| usuario · ts | sistema | Quién registró la carga y la fecha-hora exacta |
⛽
Cómo leerla: la primera carga de una unidad no trae rendimiento (no hay carga anterior
con qué comparar). A partir de la segunda, cada fila dice cuántos km recorrió la unidad desde la carga pasada y qué rendimiento
dieron esos litros. Si el rendimiento de una unidad cae de golpe, es señal de revisión.
👥 Usuarios · 🔑 Sesiones · 🧾 Log_Sync (administración y técnica)
Usuarios (usuario · hash · rol · nombre · activo): quién entra a los portales y con qué rol
(operador / técnico / jefe / admin). La contraseña se guarda cifrada — nadie puede leerla.
Sesiones: los accesos activos (se limpian solos al expirar). Log_Sync: la bitácora técnica de cada
viaje de datos (fecha, entidad, folio, resultado) — útil para diagnóstico, no se edita.
⚠️
Tres cuidados: (1) no edites a mano las columnas del sistema (folios, odoo_id, estados);
(2) no reordenes ni renombres los encabezados de fila 1; (3) si necesitas corregir un dato capturado, corrige en el
portal/Odoo — el Sheet es el registro, no el editor.
Grupo Veniu · VSolutions — Integrador de Mundos. Guía del registro de datos · columnas reales del sistema (jul-2026).
Trazabilidad: mismo folio en el Sheet y en Odoo · la etapa regresa sola en estado_odoo.