Dev Hub
Qué hay en cada carpeta
El mapa completo del monorepo. Cada carpeta tiene un propósito claro y un estado real. Úsalo para orientarte antes de tocar nada.
Vista aérea
| Carpeta | Qué es | Tamaño | Estado |
|---|---|---|---|
| android/ | Launcher Kotlin para los Moto G de BLANK. | 77 archivos | Andamio + TODOs |
| backend/ | 8 microservicios FastAPI + gateway Traefik. | 238 archivos | Andamio + TODOs |
| apps/ | 4 frontends (padres, admin, web pública, intranet). | 176 archivos | Intranet parcial, resto andamios |
| agents/ | Flota de 7 agentes autónomos + runtime. | 165 archivos | Runtime parcial, specialists andamios |
| brand/ | Tokens, logos, guidelines y copy. | 26 archivos | Tokens listos, guidelines borrador |
| infra/ | Docker, Terraform, monitorización, CI/CD. | 80 archivos | docker-compose funcional |
| packages/ | Código TS compartido entre las apps. | 28 archivos | Preset de Tailwind en uso |
| docs/ | ADRs, guías y borradores legales. | 21 archivos | Borradores |
| scripts/ | Setup, seed, health check, provisioning. | 7 archivos | Borradores |
Por qué esta estructura
BLANK es un monorepo: un solo repositorio con varios proyectos que comparten código y convenciones. Lo orquestamos con Turborepo y pnpm workspaces, así que todas las apps de TypeScript usan los mismos paquetes (ui,types,api-client).
La separación en carpetas de primer nivel no es caprichosa. Cada una representa un dominio con su propio ciclo de vida: el teléfono, los servicios, los frontends, los agentes, la marca, la infraestructura, los paquetes y los documentos. Así, cuando tocas una cosa, no mueves las demás.
En particular, brand/ es la fuente única de verdad para colores y tipografía. Si cambias un token ahí, se propaga a los 4 frontends y al launcher sin tocar ningún archivo más.
Navegación rápida
Android
El launcher de BLANK para los Moto G. Es el producto que toca el cliente.
Backend
8 microservicios en Python/FastAPI que gobiernan teléfonos, familias y pagos.
Apps
Los 3 frontends: panel de padres, web pública e intranet (incluye ops console).
Agents
Agentes autónomos que automatizan marketing, soporte, finanzas y más.
Brand
Identidad visual y verbal de BLANK: colores, tipografía, tono, logos.
Infra
Docker, Terraform, monitorización y pipelines de CI/CD.
Packages
Código TypeScript compartido entre las 4 apps: UI, tipos, cliente API, configs.
Docs
Decisiones técnicas, guías internas y borradores legales.