Introducción
Lade es una plataforma SaaS para empresas de transporte/logística en México: gestión de flota (vehículos, choferes, rutas, viajes) con generación automática de CFDI. Esta wiki reúne la documentación técnica de todo el proyecto — no solo la referencia de la API.
| Repo | Qué es | Dónde vive el detalle |
|---|---|---|
lade-app |
Frontend (React 19 + Vite + Tailwind v4 + Zustand) | Frontend |
lade-infra |
Backend serverless en AWS (Terraform + Lambda + DynamoDB + Cognito) | Backend |
lade-admin-panel |
Panel interno (deployment tooling + golden paths) | Panel de administración |
lade_infra_docs |
Este sitio | — |
lade-templates |
Templates de scaffolding (golden paths) | Templates |
lade-factory |
Automation que scaffoldea proyectos nuevos | lade-factory |
lade-api |
API legacy en NestJS — deprecado, no usar | — |
Cómo navegar esta wiki
Sección titulada «Cómo navegar esta wiki»- Empezar aquí: entornos, autenticación, dominios — el contexto mínimo para entender cualquier parte del sistema.
- Backend / Frontend: estado real y pendientes de cada repo, sincronizado desde sus
docs/ESTADO_ACTUAL.md/PROXIMOS_PASOS.md(fuente de verdad técnica — esta wiki los refleja, no los reemplaza). - Golden Paths: cómo crear un proyecto nuevo (templates + factory + panel).
- Referencia de la API: OpenAPI completo, generado desde Terraform.
Fuente de verdad
Sección titulada «Fuente de verdad»El contenido de “Backend” y “Frontend” se sincroniza a mano desde los
docs/ de cada repo (scripts/sync-wiki.sh) — si algo no coincide con
el código, el repo fuente manda, no esta wiki. No hay trigger automático
todavía: si cambia algo en lade-infra/docs/ESTADO_ACTUAL.md y no se
corrió sync-wiki.sh desde entonces, esta página puede estar desactualizada.
Para historial narrativo, decisiones y kanban del equipo, ver Lade HQ en Notion — esta wiki es la capa técnica, Notion es la capa de gestión.