Vista General
Componentes
1. CLI (Go) — Motor Core
El motor que ejecuta los switches. Arquitectura hexagonal con 0 dependencias en el core:La arquitectura hexagonal permite añadir nuevos CLI tools sin tocar la lógica de negocio.
Solo implementas la interface
CLIProfiler.2. Backend API (FastAPI) — Cerebro
API REST con 20+ endpoints, autenticación JWT, y validación Pydantic v2:3. Dashboard (Next.js) — Interfaz
Dashboard web premium con dark mode, conectado al API en tiempo real:Flujo de un Context Switch
Flujo de Autenticación (Dashboard)
Modelo de Datos
Decisiones de Diseño
¿Por qué Go para el CLI?
¿Por qué Go para el CLI?
- Binarios estáticos sin runtime dependencies
- Cross-compilation trivial (Windows, Mac, Linux)
- Cobra CLI es el estándar de la industria (kubectl, gh, docker)
- Rendimiento cercano a C sin la complejidad de Rust
¿Por qué FastAPI para el API?
¿Por qué FastAPI para el API?
- Pydantic v2 con validación automática a nivel de schema
- Swagger UI auto-generado sin código adicional
- Async nativo para concurrencia alta con SQLAlchemy 2.0
- Ecosystem Python amplio para ML/AI features futuros
¿Por qué SQLite primero?
¿Por qué SQLite primero?
- 0 dependencias externas para desarrollo local
- Migración a PostgreSQL = cambiar 1 línea en
.env - Los modelos SQLAlchemy son agnósticos al motor
¿Por qué JWT local en vez de Supabase Auth?
¿Por qué JWT local en vez de Supabase Auth?
- Desarrollo offline sin depender de servicios externos
- La interfaz es idéntica:
Authorization: Bearer {token} - Swap a Supabase Auth = cambiar solo el middleware de validación
Seguridad Zero-Knowledge
Seguridad Zero-Knowledge
Los secretos del usuario se encriptan localmente con AES-256-GCM, derivando la clave con Argon2id de la master password. El servidor nunca ve la master password ni los secretos en claro.