Mi Plante · Entregable Afluence

Auditoría técnica del marketplace de crédito Mi Plante validada documento por documento contra el código real, más el kit de onboarding pensado para que cualquier desarrollador nuevo entregue su primer PR antes del viernes.

51 documentos organizados en dos secciones: Auditoría (19 docs) y Onboarding (32 archivos). Todo accesible desde el sidebar izquierdo, desde la búsqueda (Ctrl/Cmd + K), o desde este índice.

Acceso rápido

Recomendación estratégica (10 min) La síntesis. Fix vs. rebuild, roadmap priorizado, escalabilidad 6-12-24 meses.

Hallazgos críticos (20 min) Bugs verificados con archivo y línea exacta. Lo más urgente.

Currículo Semana 1 para devs nuevos Plan hora por hora del Día 1 al Día 5. Lo que tienen que leer y hacer.

Glosario del dominio 130+ términos en español del código de Mi Plante.

Auditoría Técnica

18 documentos numerados (01–17, 19). Cada uno independiente, citable y validado contra el código fuente del repositorio.

Mapa del sistema (docs 01–15)

Cómo está construido Mi Plante hoy. La foto del sistema antes de cualquier opinión.

01 · Diagrama Entidad-Relación Esquema completo de la base de datos. 38 tablas, relaciones, caveats Eloquent vs. SQL.

02 · Inventario de rutas 139 rutas registradas, 135 endpoints de aplicación. Web, API, ally portal.

03 · Matriz de configuración 250+ variables de entorno mapeadas a sus claves de config y defaults.

04 · Catálogo de notificaciones Cada email que el sistema envía: trigger, plantilla, destinatario.

05 · Catálogo de jobs y colas Background jobs, scheduled tasks, colas, retries y modos de fallo.

06 · Diagrama de arquitectura Stack, capas, dependencias. La foto desde arriba con Mermaid.

07 · Auth y autorización Guards (web, app), roles, middleware chains, gaps de Spatie Permission.

08 · Máquina de estados de venta Cómo se mueve una Venta entre estados: PENDIENTE → PAGADA → ...

09 · Grafo eventos · jobs Qué dispara qué. Eventos → listeners → jobs → side effects.

10 · Integraciones externas TransUnion, Experian, DataCrédito, Certicámara, EMCALI, SHIVAM.

11 · Flujo de datos Cómo viaja la data desde request hasta DB y de vuelta al cliente.

12 · Workflow de aprobación de crédito El pipeline de 7 fases. El área de mayor riesgo del sistema.

13 · Mapa de páginas frontend 58 páginas Vue + Inertia mapeadas. Layout, props, llamadas API.

14 · Ciclo de vida de un request Del browser a la DB, paso por paso, con timing.

15 · Glosario del dominio 130+ términos en español usados en el código con referencias.

Hallazgos (docs 16–17)

Lo que la auditoría encontró al cruzar la documentación contra el código.

16 · Estudio profundo de validación Cruce documento-vs-código con todos los hallazgos numerados, con archivo y línea.

17 · Hallazgos críticos adicionales 154 hallazgos nuevos en una segunda pasada profunda. Severidad y ubicación exacta.

Recomendación (doc 19)

19 · Recomendación estratégica Fix vs. rebuild, stack a adoptar, organización por dominio, Q&A para la reunión, escalabilidad 6-12-24 meses.

Kit de Onboarding

Currículo de 5 días pensado para que un dev nuevo entregue su primer PR antes del viernes. Lo construyó la misma auditoría: cada landmine catalogado vive aquí también, traducido a “qué no tocar el Día 2”.

Por dónde empezar

README del kit El mapa completo. Orden de lectura, qué hay en cada carpeta, tracks por rol.

Currículo Semana 1 Plan hora por hora del Día 1 al Día 5. MILESTONES diarios.

Media (audio + video)

Onboarding para escuchar y ver, no solo leer. Generados con NotebookLM.

Podcasts · 5 episodios Deep dives estilo conversación entre dos voces. Para el commute, el café, el ejercicio. Escuchar antes de abrir el codebase.

Videos · 4 walkthroughs Tours visuales del codebase, del pipeline de crédito, del ciclo de venta, y del setup local.

Contexto de negocio

Qué es Mi Plante Modelo de negocio de punta a punta. Explicable en 3 oraciones.

Quiénes son los usuarios Las 3 audiencias y las 7 personas del sistema.

El flujo del dinero A dónde va cada peso desde el carrito hasta el pago de la cuota.

Recorrido del codebase

Desde 30,000 pies El mapa de arquitectura: stack, layers, file conventions.

Trazar un request Browser a DB, una sola request, paso a paso.

Trazar una venta Del carrito a las cuotas, ciclo completo de Venta.

Trazar una aprobación de crédito El pipeline de 7 fases en práctica: APIs externas, eventos, cache.

Setup de desarrollo

Entorno local composer dev, queue worker, Vite, SSR. Cero a localhost:8000.

Walkthrough de seed data Qué hay en la base de datos sembrada, usuarios de prueba, escenarios.

Trampas comunes Los errores de setup que les pasan a todos. Cómo evitarlos.

Landmines

Bugs conocidos 2,487 líneas de peligros catalogados. Skim primero, indexa después.

Arqueología del código Por qué existen esos landmines. La historia detrás de cada decisión.

Primeras contribuciones

Tareas Tier 1 (Día 4) Tu primer PR. Tareas reales, alcance acotado, riesgo controlado.

Tareas Tier 2 (Semana 2) Segunda ola. Más superficie, requiere haber leído los landmines.

Cómo entregar (ship) Branch, commit, PR, review, deploy. El workflow del equipo.

Pair programming con IA

Setup de Claude Code Instalación, configuración, primeros prompts con el codebase real.

Setup de Cursor Alternativa a Claude Code. .cursor/rules ya configurado.

Recetario de prompts Prompts probados para tareas comunes: tracing, refactor, debug.

Cuándo NO confiar en la IA Las zonas donde la IA alucina o se equivoca. Barreras de seguridad.

Diagramas UML

UML módulo Venta Modelo, servicios, jobs y DTOs del flujo de Venta.

UML módulo Aprobar Cupo Controllers, servicios e integraciones del pipeline de crédito.

Sobre este sitio

Este sitio se genera estáticamente desde los archivos Markdown en docs/audit/ y docs/onboarding/ del repositorio Mi Plante. Los archivos fuente son la verdad: editar uno actualiza este sitio en el próximo build. Más detalles técnicos en docs/site/README.md.

Construido por Afluence como parte del engagement de auditoría + kit de onboarding para los desarrolladores nuevos.