Manual Funcional — Toyota Conmigo¶
Bienvenido al manual centralizado del negocio de Toyota Conmigo y Lexus Connect.
Este manual existe para que cualquier miembro del equipo — sea analista, desarrollador, soporte o producto — pueda entender cómo funciona el negocio sin depender de personas individuales ni tener que leer el código fuente.
Por dónde empezar¶
Si eres nuevo en el equipo
Empieza por Overview del negocio, después lee el Glosario, y termina con Arquitectura multi-brand. Eso te da el lenguaje y el modelo mental en ~30 minutos.
Si vienes a resolver algo específico
- ¿Tienes una entidad en mente (Cliente, Vehículo, Contrato…)? Ve a Entidades.
- ¿Te interesa un proceso (Alta, Renovación, Agendamiento…)? Ve a Flujos.
- ¿Quieres detalles técnicos (BD, endpoints, specs históricas)? Ve a Referencia.
Estructura del manual¶
| Sección | Para qué sirve |
|---|---|
| Intro | Visión general del negocio, arquitectura multi-brand, cómo leer este manual |
| Glosario | ~30 términos del dominio. Auto-link en todas las páginas |
| Entidades | Qué objetos viven en el negocio (Cliente, Vehículo, Contrato, GPS, etc.) |
| Flujos | Cómo se mueven esas entidades en procesos del negocio |
| Plataformas | Cómo cada app/servicio del ecosistema usa entidades y flujos |
| Casos frecuentes | 🔥 Lo que vas a enfrentar día a día — tickets reales con causa raíz y playbook SQL |
| Referencia | Schema de BD, endpoints, specs históricas, decisiones de arquitectura |
Cómo contribuir¶
Cualquier miembro del equipo puede abrir un PR para mejorar el manual. El proceso editorial está descrito en Cómo leer este manual.
Si encuentras un gotcha sin documentar
No lo dejes pasar. Abre un PR aunque sea un párrafo de 3 líneas. El conocimiento tribal es justamente lo que este manual quiere capturar.