# 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.*