411 lines
12 KiB
Markdown
411 lines
12 KiB
Markdown
|
|
# Portfolio de Desarrollo: La Plataforma Completa
|
||
|
|
|
||
|
|
## El Desafío del Desarrollo Moderno
|
||
|
|
|
||
|
|
Los equipos de desarrollo enfrentan una fragmentación creciente:
|
||
|
|
|
||
|
|
- **10+ herramientas** para gestionar un proyecto típico
|
||
|
|
- **Conocimiento disperso** en wikis, Slack, docs, cabezas
|
||
|
|
- **Configuración manual** repetida proyecto tras proyecto
|
||
|
|
- **Infraestructura compleja** sin validación ni rollback
|
||
|
|
- **IA desconectada** de las convenciones del equipo
|
||
|
|
|
||
|
|
## La Solución: Un Ecosistema Integrado
|
||
|
|
|
||
|
|
Cinco proyectos diseñados para trabajar juntos, cada uno resolviendo un dominio específico.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Vapora: Tu Centro de Desarrollo
|
||
|
|
|
||
|
|
### Una Plataforma, Todo el Flujo
|
||
|
|
|
||
|
|
Vapora unifica la gestión de proyectos, coordinación de equipos y agentes IA en una sola plataforma.
|
||
|
|
|
||
|
|
**Gestión de Proyectos**
|
||
|
|
|
||
|
|
- **Kanban visual**: Drag-and-drop intuitivo con columnas personalizables
|
||
|
|
- **Colaboración real-time**: Updates instantáneos, sin refresh
|
||
|
|
- **Jerarquía clara**: Workspaces → Projects → Tasks con aislamiento
|
||
|
|
- **Tracking completo**: Historial de cambios con context
|
||
|
|
|
||
|
|
**Orquestación Inteligente**
|
||
|
|
|
||
|
|
- **12 roles de agente**: Architect, Developer, Reviewer, Tester, Documenter...
|
||
|
|
- **Aprendizaje continuo**: Los agentes mejoran con cada ejecución
|
||
|
|
- **Pipelines automatizados**: Secuencias con approval gates
|
||
|
|
- **Control de costos**: Presupuestos por rol con fallback automático
|
||
|
|
|
||
|
|
**Multi-Tenant Nativo**
|
||
|
|
|
||
|
|
- **Aislamiento por diseño**: Cada tenant en su scope
|
||
|
|
- **RBAC fine-grained**: Políticas declarativas con Cedar
|
||
|
|
- **Audit trail**: Todo queda registrado
|
||
|
|
|
||
|
|
**Para quién es**:
|
||
|
|
|
||
|
|
- Equipos de desarrollo que quieren unificar herramientas
|
||
|
|
- Organizaciones que usan agentes IA y necesitan visibilidad
|
||
|
|
- Plataformas multi-tenant que sirven a múltiples equipos
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Kogral: Tu Memoria de Equipo
|
||
|
|
|
||
|
|
### El Conocimiento que No se Pierde
|
||
|
|
|
||
|
|
Kogral captura las decisiones, patterns y guidelines de tu equipo en un formato que perdura.
|
||
|
|
|
||
|
|
**6 Tipos de Conocimiento**
|
||
|
|
|
||
|
|
| Tipo | Propósito |
|
||
|
|
| ------ | ----------- |
|
||
|
|
| **Notes** | Observaciones y notas generales |
|
||
|
|
| **Decisions** | ADRs con contexto, decisión y consecuencias |
|
||
|
|
| **Guidelines** | Estándares del equipo y organización |
|
||
|
|
| **Patterns** | Soluciones probadas y documentadas |
|
||
|
|
| **Journals** | Diario de desarrollo día a día |
|
||
|
|
| **Executions** | Registros de agentes IA |
|
||
|
|
|
||
|
|
**Git-Native**
|
||
|
|
|
||
|
|
- Todo en markdown versionado
|
||
|
|
- Sin dependencia de SaaS externos
|
||
|
|
- Backup y restore triviales
|
||
|
|
- Code review de conocimiento
|
||
|
|
|
||
|
|
**Herencia de Guidelines**
|
||
|
|
|
||
|
|
```text
|
||
|
|
Organización define estándares base
|
||
|
|
↓
|
||
|
|
Proyecto especializa para su contexto
|
||
|
|
↓
|
||
|
|
Desarrollador ve guidelines efectivos
|
||
|
|
```
|
||
|
|
|
||
|
|
**Integración con Claude Code**
|
||
|
|
|
||
|
|
- 7 herramientas MCP nativas
|
||
|
|
- Consulta guidelines antes de generar código
|
||
|
|
- Busca patterns relevantes automáticamente
|
||
|
|
- Registra decisiones durante el desarrollo
|
||
|
|
|
||
|
|
**Para quién es**:
|
||
|
|
|
||
|
|
- Equipos que pierden conocimiento con rotación
|
||
|
|
- Organizaciones con múltiples proyectos
|
||
|
|
- Desarrolladores que usan Claude Code
|
||
|
|
- Equipos con requisitos de compliance/audit
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## TypeDialog: Tu Interfaz Universal
|
||
|
|
|
||
|
|
### Una Definición, Todas las Plataformas
|
||
|
|
|
||
|
|
TypeDialog te permite definir formularios una vez y ejecutarlos en CLI, TUI, Web o con agentes IA.
|
||
|
|
|
||
|
|
**6 Backends de Ejecución**
|
||
|
|
|
||
|
|
| Backend | Uso Típico |
|
||
|
|
| --------- | ----------- |
|
||
|
|
| **CLI** | Scripts de automatización, CI/CD |
|
||
|
|
| **TUI** | Herramientas de administración |
|
||
|
|
| **Web** | Aplicaciones SaaS, formularios públicos |
|
||
|
|
| **AI** | Búsqueda semántica, RAG |
|
||
|
|
| **Agent** | Ejecución de agentes LLM |
|
||
|
|
| **Prov-gen** | Generación de infraestructura |
|
||
|
|
|
||
|
|
**Validación Type-Safe**
|
||
|
|
|
||
|
|
- Contratos Nickel para validación pre-runtime
|
||
|
|
- Errores detectados antes de ejecutar
|
||
|
|
- Schemas reutilizables entre proyectos
|
||
|
|
|
||
|
|
**Formularios Avanzados**
|
||
|
|
|
||
|
|
- 8 tipos de campo (text, select, multi-select, date, password...)
|
||
|
|
- Campos condicionales y dinámicos
|
||
|
|
- Grupos repetibles
|
||
|
|
- Fragments reutilizables con herencia
|
||
|
|
- Internacionalización con Fluent
|
||
|
|
|
||
|
|
**Agentes desde Markdown**
|
||
|
|
|
||
|
|
Define agentes en archivos `.agent.mdx`:
|
||
|
|
- 4 proveedores LLM (Claude, OpenAI, Gemini, Ollama)
|
||
|
|
- Templates con variables
|
||
|
|
- Validación de output
|
||
|
|
- Streaming en tiempo real
|
||
|
|
|
||
|
|
**Generación de Infraestructura**
|
||
|
|
|
||
|
|
- 6 clouds soportados (AWS, GCP, Azure, Hetzner, UpCloud, LXD)
|
||
|
|
- Formularios → Configuración validada → IaC listo
|
||
|
|
- 7 capas de validación
|
||
|
|
|
||
|
|
**Para quién es**:
|
||
|
|
|
||
|
|
- Equipos que mantienen CLI y Web en paralelo
|
||
|
|
- DevOps que necesitan wizards de configuración
|
||
|
|
- Organizaciones con requisitos multi-idioma
|
||
|
|
- Equipos que quieren automatizar con agentes
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Provisioning: Tu Infraestructura Controlada
|
||
|
|
|
||
|
|
### IaC Declarativo + Seguridad Enterprise
|
||
|
|
|
||
|
|
Provisioning combina configuración tipada, orquestación avanzada y seguridad completa.
|
||
|
|
|
||
|
|
**Nickel IaC**
|
||
|
|
|
||
|
|
- Lenguaje tipado con lazy evaluation
|
||
|
|
- Validación en compilación, no en runtime
|
||
|
|
- Schemas componibles y reutilizables
|
||
|
|
- Mejor que YAML/HCL para configuración compleja
|
||
|
|
|
||
|
|
**Multi-Cloud Real**
|
||
|
|
|
||
|
|
| Provider | Capacidades |
|
||
|
|
| ---------- | ------------- |
|
||
|
|
| **AWS** | EC2, EKS, RDS, S3, IAM, VPC |
|
||
|
|
| **UpCloud** | Servers, networking, storage |
|
||
|
|
| **Local** | LXD containers, VMs |
|
||
|
|
|
||
|
|
**Orchestrator Avanzado**
|
||
|
|
|
||
|
|
- Resolución automática de dependencias
|
||
|
|
- Checkpoints con recovery
|
||
|
|
- Rollback automático ante fallos
|
||
|
|
- Ejecución paralela con balanceo
|
||
|
|
- Retry con exponential backoff
|
||
|
|
|
||
|
|
**Seguridad Enterprise**
|
||
|
|
|
||
|
|
| Componente | Capacidad |
|
||
|
|
| ------------ | ----------- |
|
||
|
|
| **Autenticación** | JWT + Argon2id + MFA (TOTP + WebAuthn) |
|
||
|
|
| **Autorización** | Cedar policies (RBAC fine-grained) |
|
||
|
|
| **Secrets** | Dynamic secrets con TTL |
|
||
|
|
| **KMS** | 5 backends (RustyVault, Age, AWS, Vault, Cosmian) |
|
||
|
|
| **Audit** | 7 años retención, 5 formatos export |
|
||
|
|
| **Break-glass** | Multi-party approval |
|
||
|
|
|
||
|
|
**39,699 líneas de código de seguridad** en 12 componentes.
|
||
|
|
|
||
|
|
**IA Integrada**
|
||
|
|
|
||
|
|
- MCP Server nativo (1000x más rápido que Python)
|
||
|
|
- RAG con 1,200+ documentos de dominio
|
||
|
|
- Consultas en lenguaje natural
|
||
|
|
- Generación de Nickel validado
|
||
|
|
|
||
|
|
**Developer Experience**
|
||
|
|
|
||
|
|
- CLI de 211 líneas (84% reducción)
|
||
|
|
- 80+ shortcuts (`s` → server, `t` → taskserv)
|
||
|
|
- Guías interactivas integradas
|
||
|
|
- Sistema de configuración con 476+ accessors
|
||
|
|
|
||
|
|
**Para quién es**:
|
||
|
|
|
||
|
|
- Equipos DevOps que quieren IaC tipado
|
||
|
|
- Organizaciones multi-cloud
|
||
|
|
- Equipos con requisitos de compliance
|
||
|
|
- Organizaciones que necesitan audit completo
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## SecretumVault: Tu Bóveda Post-Cuántica
|
||
|
|
|
||
|
|
### Criptografía del Futuro, Hoy
|
||
|
|
|
||
|
|
SecretumVault es el primer vault Rust con criptografía post-cuántica lista para producción.
|
||
|
|
|
||
|
|
**Criptografía Agnóstica**
|
||
|
|
|
||
|
|
| Backend | Algoritmos | Estado |
|
||
|
|
| --------- | ------------ | -------- |
|
||
|
|
| **OpenSSL** | RSA, ECDSA, AES-256-GCM | Producción |
|
||
|
|
| **OQS** | ML-KEM-768, ML-DSA-65 | **Producción (PQC)** |
|
||
|
|
| **AWS-LC** | RSA, ECDSA | Experimental |
|
||
|
|
| **RustCrypto** | AES-GCM, ChaCha20 | Testing |
|
||
|
|
|
||
|
|
**Motores de Secretos**
|
||
|
|
|
||
|
|
- **KV Engine**: Almacenamiento versionado con metadata
|
||
|
|
- **Transit Engine**: Encryption-as-a-service con rotación
|
||
|
|
- **PKI Engine**: Certificados X.509 y gestión de CA
|
||
|
|
- **Database Engine**: Credenciales dinámicas con TTL
|
||
|
|
|
||
|
|
**Storage Multi-Backend**
|
||
|
|
|
||
|
|
| Backend | Uso |
|
||
|
|
| --------- | ----- |
|
||
|
|
| **Filesystem** | Desarrollo, single-node |
|
||
|
|
| **etcd** | Kubernetes, alta disponibilidad |
|
||
|
|
| **SurrealDB** | Queries complejas, time-series |
|
||
|
|
| **PostgreSQL** | Enterprise, ACID |
|
||
|
|
|
||
|
|
**Seguridad Enterprise**
|
||
|
|
|
||
|
|
- **Shamir Secret Sharing**: Unsealing distribuido (K de N)
|
||
|
|
- **Cedar ABAC**: Políticas AWS-compatible
|
||
|
|
- **TLS/mTLS**: Cifrado en tránsito con verificación cliente
|
||
|
|
- **Audit Logging**: Todos los eventos registrados
|
||
|
|
|
||
|
|
**Para quién es**:
|
||
|
|
|
||
|
|
- Equipos preparándose para amenazas cuánticas
|
||
|
|
- Organizaciones con requisitos de agilidad criptográfica
|
||
|
|
- Plataformas que necesitan vault Rust-native
|
||
|
|
- Equipos multi-cloud con self-hosting
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## El Ecosistema en Acción
|
||
|
|
|
||
|
|
### Escenario 1: Desarrollo de Feature
|
||
|
|
|
||
|
|
```text
|
||
|
|
1. Kogral proporciona guidelines y patterns al equipo
|
||
|
|
2. TypeDialog captura requisitos con formularios validados
|
||
|
|
3. SecretumVault gestiona credenciales y API keys
|
||
|
|
4. Vapora coordina agentes (Architect → Developer → Reviewer)
|
||
|
|
5. Kogral registra decisiones tomadas
|
||
|
|
6. Provisioning despliega cambios de infra necesarios
|
||
|
|
```
|
||
|
|
|
||
|
|
### Escenario 2: Onboarding de Equipo
|
||
|
|
|
||
|
|
```text
|
||
|
|
1. Kogral exporta knowledge graph del proyecto
|
||
|
|
2. TypeDialog presenta quizzes interactivos
|
||
|
|
3. Vapora asigna tareas de onboarding progresivas
|
||
|
|
4. Provisioning configura entornos de desarrollo
|
||
|
|
```
|
||
|
|
|
||
|
|
### Escenario 3: Migración de Infraestructura
|
||
|
|
|
||
|
|
```text
|
||
|
|
1. Kogral documenta ADRs de la migración
|
||
|
|
2. TypeDialog valida parámetros de configuración
|
||
|
|
3. Provisioning ejecuta con checkpoints y rollback
|
||
|
|
4. Vapora orquesta monitoreo y reportes
|
||
|
|
```
|
||
|
|
|
||
|
|
### Escenario 4: Nuevo Proyecto
|
||
|
|
|
||
|
|
```text
|
||
|
|
1. TypeDialog wizard para configuración inicial
|
||
|
|
2. Provisioning genera infraestructura
|
||
|
|
3. Kogral crea knowledge graph inicial
|
||
|
|
4. Vapora configura pipelines de desarrollo
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Por Qué Este Ecosistema
|
||
|
|
|
||
|
|
### Frente a Fragmentación
|
||
|
|
|
||
|
|
| Problema | Solución Típica | Nuestra Solución |
|
||
|
|
| ---------- | ----------------- | ------------------ |
|
||
|
|
| Gestión proyectos | Jira + Notion + ... | Vapora (todo en uno) |
|
||
|
|
| Conocimiento | Wiki + Docs + Slack | Kogral (git-native) |
|
||
|
|
| Configuración | Scripts + YAML | TypeDialog (type-safe) |
|
||
|
|
| Secretos | HashiCorp Vault / SaaS | SecretumVault (PQC) |
|
||
|
|
| Infraestructura | Terraform + Ansible | Provisioning (Nickel) |
|
||
|
|
| IA | Herramientas separadas | Integrada en todo |
|
||
|
|
|
||
|
|
### Ventajas Técnicas
|
||
|
|
|
||
|
|
| Aspecto | Nosotros | Alternativas |
|
||
|
|
| --------- | ---------- | -------------- |
|
||
|
|
| **Stack** | Rust end-to-end | Python/JS/Go mix |
|
||
|
|
| **Config** | Nickel (typed) | YAML/JSON (runtime errors) |
|
||
|
|
| **Multi-tenant** | SurrealDB scopes | DIY isolation |
|
||
|
|
| **IA** | Nativa en todos | Retrofitted |
|
||
|
|
| **Self-hosted** | Completo | SaaS lock-in |
|
||
|
|
|
||
|
|
### Métricas de Confianza
|
||
|
|
|
||
|
|
| Métrica | Valor |
|
||
|
|
| --------- | ------- |
|
||
|
|
| Crates Rust | 40+ |
|
||
|
|
| Tests | 4,360+ |
|
||
|
|
| Líneas de código | ~206K |
|
||
|
|
| Líneas de seguridad | 39K |
|
||
|
|
| Proveedores LLM | 4 |
|
||
|
|
| Clouds soportados | 6 |
|
||
|
|
| Backends crypto | 4 (incl. PQC) |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Comenzar
|
||
|
|
|
||
|
|
### Adopción Flexible
|
||
|
|
|
||
|
|
Cada proyecto funciona de forma independiente:
|
||
|
|
|
||
|
|
1. **Solo necesitas knowledge management?** → Kogral
|
||
|
|
2. **Solo necesitas forms multi-backend?** → TypeDialog
|
||
|
|
3. **Solo necesitas vault post-cuántico?** → SecretumVault
|
||
|
|
4. **Solo necesitas orquestación de desarrollo?** → Vapora
|
||
|
|
5. **Solo necesitas IaC enterprise?** → Provisioning
|
||
|
|
|
||
|
|
### Adopción Progresiva
|
||
|
|
|
||
|
|
Para máximo beneficio:
|
||
|
|
|
||
|
|
```text
|
||
|
|
1. Kogral → Establece base de conocimiento
|
||
|
|
2. TypeDialog → Habilita inputs estructurados
|
||
|
|
3. SecretumVault → Gestión segura de secretos
|
||
|
|
4. Vapora → Orquesta desarrollo
|
||
|
|
5. Provisioning → Infraestructura completa
|
||
|
|
```
|
||
|
|
|
||
|
|
### Integración Natural
|
||
|
|
|
||
|
|
Los proyectos se conectan automáticamente:
|
||
|
|
|
||
|
|
- Comparten SurrealDB para estado
|
||
|
|
- Usan Nickel para configuración
|
||
|
|
- Hablan el mismo protocolo MCP
|
||
|
|
- Comparten patterns de Axum/Leptos
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Stack Tecnológico
|
||
|
|
|
||
|
|
Todo el ecosistema construido sobre:
|
||
|
|
|
||
|
|
| Tecnología | Propósito |
|
||
|
|
| ------------ | ----------- |
|
||
|
|
| **Rust** | Performance, type-safety, zero-cost abstractions |
|
||
|
|
| **Nickel** | Configuration language con validación |
|
||
|
|
| **SurrealDB** | Multi-model database con scopes |
|
||
|
|
| **Axum** | Web framework async composable |
|
||
|
|
| **Leptos** | Frontend WASM reactivo |
|
||
|
|
| **Ratatui** | Terminal UI |
|
||
|
|
| **NATS** | Messaging con JetStream |
|
||
|
|
| **rig-core** | LLM abstraction multi-provider |
|
||
|
|
| **OQS** | Post-quantum cryptography (ML-KEM, ML-DSA) |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Contacto
|
||
|
|
|
||
|
|
- **Repositorios**: GitHub (proyectos privados)
|
||
|
|
- **Licencia**: Propietaria / Por definir
|
||
|
|
- **Stack**: 100% Rust
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
*Un ecosistema. Cinco proyectos. Integración real.*
|
||
|
|
*Desarrollo moderno sin fragmentación.*
|