Operaciones
Auditoría de documentación de user flows
Mapeo de cada flujo de la plataforma contra las guías existentes en docs.relo.mx y gaps por cerrar.
Auditoría de documentación de user flows
Última revisión: 2026-07-09.
Esta página compara cada ruta/funcionalidad de la plataforma contra la guía de docs.relo.mx que la documenta. El objetivo es mantener docs-first: antes de cambiar un flujo, actualiza su guía; después de deployar, verifica que la doc sigue al día.
Leyenda
| Símbolo | Significado |
|---|---|
| ✅ | Guía existe y tiene diagrama |
| 🟡 | Guía existe pero sin diagrama, incompleta o desactualizada |
| 🔴 | No hay guía que cubra el flujo |
| ➡️ | Legacy / redirigido a otra pantalla (documentar en la guía destino) |
1. Auth / Entry points (todos los roles)
| Ruta / Flujo | Estado | Guía actual | Gap / acción |
|---|---|---|---|
Login (/auth/login) | ✅ | Auth y acceso | — |
Signup por invitación (/auth/signup) | ✅ | Auth y acceso | — |
| Forgot / reset password | ✅ | Auth y acceso | — |
Primer setup de admin (/auth/setup) | ✅ | Auth y acceso | — |
Aceptar invitación de cliente (/client/invite) | ✅ | Aceptar invitación de cliente | — |
2. Admin V2 — Global
| Ruta / Flujo | Estado | Guía actual | Gap / acción |
|---|---|---|---|
Home /v2 (P&L global, marcas, SLA) | ✅ | Admin Home | — |
Directorio de clientes /v2/clients | ✅ | Directorio de clientes | — |
Onboarding de cliente /v2/clients/new | ✅ | Admin Onboarding | — |
Directorio de partners /v2/partners | ✅ | Directorio de partners | — |
Onboarding de partner /v2/partners/onboarding | ✅ | Alta de partners | — |
Perfil de partner /v2/partners/:id | ✅ | Perfil de partner | — |
Impersonar portal de partner /v2/partner-portal/:id | ✅ | Ver portal como partner | — |
Pagos globales /v2/payments | ✅ | Admin Payments | — |
Librería de assets /v2/assets | ✅ | Asset library | — |
AI Copilot /v2/ai | ✅ | AI Assistant | — |
Link generator /v2/link-generator | ✅ | Link Generator | — |
Tickets de soporte /v2/tickets | ✅ | Tickets de soporte | — |
Users & access /v2/users | ✅ | Users & Access | — |
Org settings /v2/settings | ✅ | Organization Settings | — |
System health /v2/system | ✅ | System health | — |
Admin fraud dashboard /v2/admin-fraud | ✅ | Admin Fraud Quality | — |
| Control center (legacy) | ➡️ | System health | Consolidado |
| Data pipelines (legacy) | ➡️ | System health | Consolidado |
| Commission parity (legacy) | ➡️ | System health | Consolidado |
| Budget engine runs (legacy) | ➡️ | System health | Consolidado |
3. Admin V2 — Client-scoped (/v2/c/:slug/*)
| Ruta / Flujo | Estado | Guía actual | Gap / acción |
|---|---|---|---|
Client overview (Hoy) /v2/c/:slug | ✅ | Client overview | — |
Portal client-facing /v2/c/:slug/portal | ✅ | Client Portal | — |
Listado de campañas /v2/c/:slug/campaigns | ✅ | Admin Campaigns | — |
Lanzar campaña /v2/c/:slug/campaigns/launch | ✅ | Admin Campaigns | — |
Detalle de campaña /v2/c/:slug/campaigns/:id | ✅ | Detalle de campaña | — |
Partners del cliente /v2/c/:slug/partners | ✅ | Partners del cliente | — |
Rules Engine /v2/c/:slug/rules | ✅ | Admin Rules + Admin Attribution | — |
Editor de reglas /v2/c/:slug/rules/new | ✅ | Admin Rules | — |
Integraciones /v2/c/:slug/integrations | ✅ | Admin Data | — |
| Tracking sources | ✅ | Admin Data | — |
| Media sources (PIDs AppsFlyer) | ✅ | Admin Data | — |
| Pixel analytics | ✅ | Pixel Setup + Pixel | — |
Reconciliación /v2/c/:slug/reconciliation | ✅ | Reconciliación y SLA | — |
Órdenes /v2/c/:slug/orders | ✅ | Validación de órdenes | — |
Fraude review /v2/c/:slug/fraud-review | ✅ | Admin Fraud Quality | — |
Leads /v2/c/:slug/leads | ✅ | Client leads | — |
Funnels /v2/c/:slug/funnels | ✅ | Funnels & Events | — |
Audiencias /v2/c/:slug/audiences | ✅ | Client audiences | — |
Usuarios del cliente /v2/c/:slug/users | ✅ | Users del cliente | — |
Settings del cliente /v2/c/:slug/settings | ✅ | Settings del cliente | — |
Setup-edit wizard /v2/c/:slug/setup-edit | ✅ | Admin Onboarding | — |
Quality (RQI) /v2/c/:slug/quality | ✅ | Admin Fraud Quality | — |
SLA dashboard /v2/c/:slug/sla | ✅ | Reconciliación y SLA | Consolidado en guía de reconciliación |
Monthly planner /v2/c/:slug/planner | ✅ | Monthly Planner | — |
4. Partner Portal
| Ruta / Flujo | Estado | Guía actual | Gap / acción |
|---|---|---|---|
| Overview de partner | ✅ | Partner Portal | — |
| Dashboard de campaña | ✅ | Partner Portal | — |
| Analytics MMP / Pixel | ✅ | Partner Portal | — |
| Órdenes del partner | ✅ | Partner Portal | — |
| Leads del partner | ✅ | Partner Portal | — |
| Links & creatives | ✅ | Partner Portal + Partner Tracking Links | — |
| Link builder | ✅ | Partner Portal | — |
| Postbacks S2S | ✅ | Partner Postbacks | — |
| Pagos del partner | ✅ | Partner Portal | — |
| Mensajes / notificaciones | ✅ | Partner Portal | — |
| Settings del partner | ✅ | Partner Portal | — |
5. Client Portal
| Ruta / Flujo | Estado | Guía actual | Gap / acción |
|---|---|---|---|
Login / redirect /client | ✅ | Client Portal | — |
| Overview MMP | ✅ | Client Portal | — |
| Performance | ✅ | Client Portal | — |
| Segments | ✅ | Client Portal | — |
| Trends | ✅ | Client Portal | — |
| Behavior | ✅ | Client Portal | — |
| Products | ✅ | Client Portal | — |
| Geographic | ✅ | Client Portal | — |
| Hour & Day | ✅ | Client Portal | — |
| Funnel MMP | ✅ | Client Portal | — |
| Campaigns | ✅ | Client Portal | — |
| Orders | ✅ | Client Portal | — |
Portal pixel (ClientPixelPortal) | ✅ | Portal de cliente para pixel | — |
6. Integraciones y API
| Ruta / Flujo | Estado | Guía actual | Gap / acción |
|---|---|---|---|
| Arquitectura general | ✅ | Arquitectura | — |
| API REST | ✅ | API Reference + API Guide | — |
| AppsFlyer Pull + S2S | ✅ | AppsFlyer | — |
| Fuentes externas (Everflow/GA4/webhook) | ✅ | External Sources | — |
| Stripe webhooks | ✅ | Stripe | — |
| Pipeline / HA / monitoring | ✅ | Pipeline + Monitoring | — |
| Recovery / ops | ✅ | Operations Recovery | — |
| S2S go-live | ✅ | S2S Go-live | — |
| Lead-gen case study | ✅ | Lead-gen Case Study | — |
Resumen de gaps por severidad
🔴 Alta — sin guía o sin diagrama crítico
Ninguno. Todos los user flows principales de la plataforma tienen guía activa.
🟡 Media — guía existe pero puede enriquecerse
- API Reference — agregar diagramas de arquitectura de endpoints y flujos de autenticación.
- External Sources — diagramas de integración (Everflow, GA4, webhooks genéricos).
- Pipeline / HA / Monitoring — más diagramas de failover y componentes.
- Admin Data — asegurar que la pestaña de Data pipelines quede documentada.
➡️ Legacy / redirigido (ya documentado en destino)
- Control center, commission parity, budget engine → System health.
- Data pipelines → Admin Data.
- SLA dashboard → Reconciliación y SLA.
Próximos pasos recomendados
- Mejorar home de docs.relo.mx — agregar "Cómo hacer X" rápidos para los flujos más comunes (crear partner, conectar S2S, subir billing, etc.).
- Login con Supabase en docs.relo.mx — para mostrar contenido personalizado según rol (admin, partner, client user).
- Visual redesign — mejorar look & feel: más espacio para contenido, menos widgets, tipografía y componentes más pulidos.
- Diagramas en cada proceso — asegurar que toda guía de flujo tenga al menos un diagrama Mermaid.
- Revisar esta auditoría cada 2 semanas o después de cada release mayor.