jesus/stratumiops
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
stratumiops/docs/es/stratiumiops_position.md

911 lines
45 KiB
Markdown
Raw Permalink Normal View History

chore: Init repo, add docs
2026-01-22 22:15:19 +00:00
# Portfolio de Proyectos: Posicionamiento Estratégico Completo
## Resumen Ejecutivo
Portfolio de cinco proyectos Rust que conforman un ecosistema completo para desarrollo de software moderno:
| Proyecto | Dominio Principal | Capacidades Clave |
| ---------- | ------------------- | ------------------- |
| **Vapora** | Plataforma de Desarrollo | Orquestación, Kanban, multi-tenant, LLM routing, knowledge graph |
| **Kogral** | Gestión de Conocimiento | Knowledge graph, ADRs, patterns, guidelines, búsqueda semántica |
| **TypeDialog** | Interacción y Automatización | Forms multi-backend, agentes, IaC generation, i18n, validación |
| **Provisioning** | Infraestructura | IaC declarativo, multi-cloud, seguridad enterprise, orquestación |
| **SecretumVault** | Seguridad | Gestión de secretos, criptografía post-cuántica, multi-backend |
---
## 1. Vapora: Plataforma de Desarrollo Inteligente
### Visión General
Vapora es una **plataforma de orquestación de desarrollo** que unifica gestión de proyectos, coordinación de agentes IA, y visibilidad completa del ciclo de desarrollo.
### Capacidades Completas
#### Gestión de Proyectos
| Funcionalidad | Descripción |
| --------------- | ------------- |
| **Kanban Board** | Drag-and-drop con columnas Todo → Doing → Review → Done |
| **Real-time Collaboration** | Updates optimistas, WebSocket sync |
| **Task Tracking** | Prioridades, tags, asignaciones, ordenamiento |
| **Project Hierarchy** | Workspaces → Projects → Tasks con scopes aislados |
| **Change Tracking** | Historial de cambios con impact analysis |
#### Multi-Tenancy y Seguridad
| Funcionalidad | Descripción |
| --------------- | ------------- |
| **SurrealDB Scopes** | Aislamiento nativo por tenant |
| **Cedar RBAC** | Políticas fine-grained declarativas |
| **JWT Auth** | Tokens con refresh rotation |
| **Audit Trail** | Logging de cambios significativos |
#### Orquestación de Agentes
| Funcionalidad | Descripción |
| --------------- | ------------- |
| **12 Roles** | Architect, Developer, Reviewer, Tester, Documenter, etc. |
| **Learning Profiles** | Expertise por tipo de tarea con recency bias (3x últimos 7 días) |
| **Pipeline Execution** | Secuencias con approval gates |
| **NATS JetStream** | Coordinación async con delivery garantizado |
#### LLM Router
| Funcionalidad | Descripción |
| --------------- | ------------- |
| **4 Providers** | Claude, OpenAI, Gemini, Ollama |
| **Budget Control** | Límites por rol (mensual/semanal) |
| **Auto-Fallback** | Cambio a provider más barato cuando excede budget |
| **Cost Tracking** | Tokens y costos por request/rol/provider |
#### Knowledge Graph Temporal
| Funcionalidad | Descripción |
| --------------- | ------------- |
| **Execution History** | Nodos con relaciones causales |
| **Learning Curves** | Agregaciones diarias para tracking de mejora |
| **Similarity Search** | Recomendaciones basadas en tareas pasadas |
#### Frontend (Leptos WASM)
| Funcionalidad | Descripción |
| --------------- | ------------- |
| **Glassmorphism UI** | Estética vaporwave moderna |
| **Responsive** | Mobile a ultra-wide |
| **Optimistic Updates** | UX fluida sin esperar server |
| **UnoCSS** | Atomic CSS Tailwind-compatible |
#### Observabilidad
| Funcionalidad | Descripción |
| --------------- | ------------- |
| **Prometheus Metrics** | Request latency, agent duration, token usage |
| **OpenTelemetry** | Tracing distribuido |
| **Structured Logging** | JSON output con tracing |
### Arquitectura
```text
┌─────────────────────────────────────────────────────────────────┐
│ Vapora (13 crates, 218+ tests) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
│ │ Frontend │ │ Backend │ │ Agent System │ │
│ │ (Leptos) │──│ (Axum) │──│ (Coordinator + NATS) │ │
│ │ Kanban UI │ │ 40+ APIs │ │ Learning + Pipelines │ │
│ └─────────────┘ └──────┬──────┘ └───────────┬─────────────┘ │
│ │ │ │
│ ┌───────────────────────┴──────────────────────┴─────────────┐ │
│ │ LLM Router │ │
│ │ Claude │ OpenAI │ Gemini │ Ollama │ Budget │ Fallback │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌───────────────────────┴───────────────────────────────────┐ │
│ │ Persistence: SurrealDB (scopes) + NATS JetStream │ │
│ └───────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
---
## 2. Kogral: Sistema de Gestión de Conocimiento
### Visión General
Kogral es un **knowledge graph git-native** diseñado para capturar, conectar y consultar el conocimiento de equipos de desarrollo.
### Capacidades Completas
#### Modelo de Conocimiento
| Tipo de Nodo | Propósito |
| -------------- | ----------- |
| **Note** | Notas generales, observaciones |
| **Decision (ADR)** | Architectural Decision Records con context/decision/consequences |
| **Guideline** | Estándares de equipo/organización |
| **Pattern** | Soluciones reutilizables documentadas |
| **Journal** | Diario de desarrollo (progreso, blockers, learnings) |
| **Execution** | Registros de ejecución de agentes |
| Tipo de Relación | Propósito |
| ------------------ | ----------- |
| **relates_to** | Conexión general |
| **depends_on** | Dependencia |
| **implements** | Implementación de concepto |
| **extends** | Extensión/especialización |
| **supersedes** | Reemplaza versión anterior |
| **explains** | Documentación/explicación |
#### Storage Multi-Backend
| Backend | Características |
| --------- | ----------------- |
| **Filesystem** | Git-friendly, markdown + YAML frontmatter, `.kogral/` |
| **SurrealDB** | Escalable, queries de grafo, conocimiento compartido org |
| **Memory** | Testing con DashMap |
#### Búsqueda
| Capacidad | Descripción |
| ----------- | ------------- |
| **Text Search** | Búsqueda full-text sobre contenido |
| **Semantic Search** | Embeddings con fastembed (local) o cloud providers |
| **Graph Traversal** | Navegación por relaciones |
| **Filtering** | Por tipo, tags, fecha, metadata |
#### Herencia de Guidelines
```text
Org Guidelines (base)
│
▼ override
Project Guidelines (específicas)
│
▼ merge con prioridad
Effective Guidelines (aplicadas)
```
#### Logseq Compatibility
| Feature | Soporte |
| --------- | --------- |
| **Outliner Blocks** | Estructura jerárquica preservada |
| **Task Statuses** | TODO, DOING, DONE, LATER, NOW, WAITING, CANCELLED |
| **Wikilinks** | `[[referencias]]` bidireccionales |
| **Properties** | Metadata en frontmatter |
| **Tags** | #tags preservados |
#### MCP Server (Claude Code)
| Tool | Función |
| ------ | --------- |
| `search` | Búsqueda text/semántica |
| `add_note` | Crear nota |
| `add_decision` | Crear ADR guiado |
| `link` | Establecer relación |
| `get_guidelines` | Obtener guidelines aplicables |
| `list_graphs` | Listar grafos disponibles |
| `export` | Exportar a formato |
#### Export y Templates
| Formato | Soporte |
| --------- | --------- |
| **Markdown** | Con frontmatter YAML |
| **JSON** | Estructura completa |
| **YAML** | Human-readable |
| **Tera Templates** | Generación personalizada |
### Arquitectura
```text
┌─────────────────────────────────────────────────────────────────┐
│ Kogral (3 crates, 56 tests) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
│ │ CLI │ │ MCP Server │ │ Core Library │ │
│ │ 13 cmds │ │ Claude Code│ │ Models + Storage + │ │
│ │ clap │ │ 7 tools │ │ Query + Embeddings │ │
│ └──────┬──────┘ └──────┬──────┘ └────────────┬────────────┘ │
│ │ │ │ │
│ └────────────────┼──────────────────────┘ │
│ │ │
│ ┌───────────────────────┴───────────────────────────────────┐ │
│ │ Storage Backends │ │
│ │ Filesystem (.kogral/) │ SurrealDB │ Memory (test) │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌───────────────────────┴───────────────────────────────────┐ │
│ │ Embeddings: fastembed (local) │ rig-core (cloud) │ │
│ └───────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
---
## 3. TypeDialog: Plataforma de Interacción Unificada
### Visión General
TypeDialog es un **sistema de formularios y automatización** que unifica múltiples interfaces (CLI, TUI, Web) con ejecución de agentes y generación de infraestructura.
### Capacidades Completas
#### Backends de Ejecución
| Backend | Tecnología | Uso Típico |
| --------- | ------------ | ------------ |
| **CLI** | inquire | Scripts, CI/CD, automatización |
| **TUI** | ratatui | Dashboards terminal, admin tools |
| **Web** | axum + HTMX | SaaS, formularios públicos |
| **AI** | tantivy + petgraph | RAG, búsqueda semántica |
| **Agent** | Tera + Nickel | Ejecución LLM desde .agent.mdx |
| **Prov-gen** | Nickel + Templates | IaC multi-cloud |
#### Tipos de Campo
| Tipo | Características |
| ------ | ----------------- |
| **text** | Validación regex, longitud, patterns |
| **confirm** | Yes/No boolean |
| **select** | Single choice con filtrado |
| **multi-select** | Multiple choice (list/grid/dropdown) |
| **password** | Masked input |
| **custom** | Tipos definidos por usuario |
| **editor** | Multi-line con soporte editor externo |
| **date** | Date/time picker |
#### Validación y Contratos
| Capacidad | Descripción |
| ----------- | ------------- |
| **Regex Patterns** | Validación por expresión regular |
| **Length Constraints** | min/max length |
| **Cross-field Logic** | Validación entre campos |
| **Nickel Contracts** | Type-safe pre/post validación |
| **Custom Validators** | Funciones de validación personalizadas |
#### Forms Avanzados
| Feature | Descripción |
| --------- | ------------- |
| **Sections** | Agrupación lógica de campos |
| **Conditional Fields** | Visibilidad dinámica basada en valores |
| **Smart Defaults** | Valores por defecto computados |
| **Repeating Groups** | Campos repetibles dinámicamente |
| **Fragment Composition** | Templates reutilizables con herencia |
| **Includes** | Importación de fragmentos |
#### Internacionalización (i18n)
| Capacidad | Descripción |
| ----------- | ------------- |
| **Fluent Bundles** | Archivos .ftl para traducciones |
| **Auto-Locale** | Detección automática via sys-locale |
| **Form Translation** | Labels, hints, errors traducidos |
| **Extraction** | Auto-extracción de strings desde schemas |
#### Output Formats
| Formato | Soporte |
| --------- | --------- |
| **JSON** | Estándar, compatible universal |
| **YAML** | Human-readable |
| **TOML** | Configuración Rust-friendly |
| **Nickel** | Type-safe con contratos |
#### Agent System
| Capacidad | Descripción |
| ----------- | ------------- |
| **MDX Format** | Markdown extendido con frontmatter YAML |
| **4 LLM Providers** | Claude, OpenAI, Gemini, Ollama |
| **Tera Templates** | Variables, imports, shell commands |
| **Output Validation** | Format, content, length checks |
| **Streaming** | Real-time token streaming |
#### IaC Generation (Prov-gen)
| Capacidad | Descripción |
| ----------- | ------------- |
| **6 Cloud Providers** | AWS, GCP, Azure, Hetzner, UpCloud, LXD |
| **7-Layer Validation** | Pipeline de validación completo |
| **AI-Assisted** | Configuración opcional con Claude/Ollama |
| **Template Fragments** | Fragmentos específicos por provider |
#### Seguridad
| Capacidad | Descripción |
| ----------- | ------------- |
| **Field Encryption** | Cifrado a nivel de campo |
| **Password Masking** | En todos los backends |
| **Validation Contracts** | Prevención de datos inválidos |
### Arquitectura
```text
┌─────────────────────────────────────────────────────────────────┐
│ TypeDialog (8 crates, 3,818 tests) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Form Definition (TOML) │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────┐│
│ │ BackendFactory ││
│ └─────────────────────────────────────────────────────────────┘│
│ │ │
│ ┌──────┼──────┬──────┬──────┬──────┬──────┐ │
│ │ │ │ │ │ │ │ │
│ ▼ ▼ ▼ ▼ ▼ ▼ │ │
│ CLI TUI Web AI Agent Prov-gen │ │
│(inquire)(ratatui)(axum)(tantivy)(Tera)(Nickel) │
│ │ │ │ │ │ │ │ │
│ └──────┴──────┴──────┴──────┴──────┴──────┘ │
│ │ │
│ ┌───────────────────────┴───────────────────────────────────┐ │
│ │ Output: JSON │ YAML │ TOML │ Nickel │ │
│ │ Validation: Nickel Contracts │ │
│ └───────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
---
## 4. Provisioning: Plataforma de Infraestructura
### Visión General
Provisioning es una **plataforma IaC enterprise** que combina configuración declarativa (Nickel), orquestación avanzada, seguridad completa, y asistencia IA.
### Capacidades Completas
#### CLI Modular
| Aspecto | Detalle |
| --------- | --------- |
| **Tamaño** | 211 líneas (84% reducción desde 1,329) |
| **Shortcuts** | 80+ atajos (`s` → server, `t` → taskserv) |
| **Módulos** | 7 dominios (infra, orchestration, dev, workspace, config, utils, gen) |
| **Guías** | Interactivas con glow/bat/less |
#### Sistema de Configuración
| Capacidad | Descripción |
| ----------- | ------------- |
| **476+ Accessors** | Reemplazo de 200+ variables de entorno |
| **Hierarchical Loading** | defaults → user → project → infra → env → runtime |
| **Interpolation** | Variables expandidas dinámicamente |
| **Multi-format** | TOML, YAML, Nickel |
#### Multi-Cloud Support
| Provider | Capacidades |
| ---------- | ------------- |
| **AWS** | EC2, EKS, RDS, S3, IAM, VPC |
| **UpCloud** | Servers, networking, storage |
| **Local** | LXD containers, local VMs |
#### Batch Workflows
| Capacidad | Descripción |
| ----------- | ------------- |
| **Mixed Providers** | AWS + UpCloud + local en mismo workflow |
| **Schema Integration** | KCL/Nickel type-safe |
| **Dependency Resolution** | Topological sorting automático |
| **State Management** | Checkpoints con recovery |
| **Rollback** | Automático ante fallos |
| **Token Efficiency** | 85-90% |
#### Orchestrator Híbrido
| Capacidad | Descripción |
| ----------- | ------------- |
| **Rust + Nushell** | Combina rendimiento y flexibilidad |
| **File Persistence** | Estado persistido en filesystem |
| **Priority Processing** | Colas con prioridad |
| **Retry Logic** | Exponential backoff |
| **REST API** | Integración externa |
| **Parallel Execution** | Load balancing |
#### Workspace Management
| Capacidad | Descripción |
| ----------- | ------------- |
| **Single-command Switch** | Cambio instantáneo entre entornos |
| **Tracking** | Last-used timestamps |
| **Registry** | Registro centralizado |
| **Preferences** | Configuración por usuario |
#### Test Environment Service
| Tipo | Descripción |
| ------ | ------------- |
| **Single Taskserv** | Test de servicio individual |
| **Server Simulation** | Simulación de servidor completo |
| **Multi-node Clusters** | Clusters con topologías (K8s HA, etcd) |
#### Platform Installer
| Modo | Recursos |
| ------ | ---------- |
| **Solo** | 2 CPU, 4GB RAM |
| **MultiUser** | 4 CPU, 8GB RAM |
| **CICD** | 8 CPU, 16GB RAM |
| **Enterprise** | 16 CPU, 32GB RAM |
| Interface | Descripción |
| ----------- | ------------- |
| **TUI** | Ratatui interactivo |
| **CLI** | Headless automation |
| **Unattended** | Sin interacción |
#### Version Management
| Capacidad | Descripción |
| ----------- | ------------- |
| **Centralized** | Todas las versiones en Nickel |
| **Bash-compatible** | Generación de archivo sourceable |
| **Auto-discovery** | Detección de versiones de providers |
| **Shell Integration** | `source /provisioning/core/versions` |
#### Nushell Plugins
| Plugin | Función | Mejora |
| -------- | --------- | -------- |
| **auth** | Autenticación | 10-50x vs HTTP |
| **KMS** | Gestión de claves | Nativo OS keyring |
| **orchestrator** | Coordinación workflows | Performance |
#### Sistema de Seguridad Completo
| Componente | Capacidades |
| ------------ | ------------- |
| **Autenticación** | JWT + Argon2id hashing |
| **MFA** | TOTP + WebAuthn/FIDO2 |
| **Autorización** | Cedar policy engine (RBAC fine-grained) |
| **Secrets** | Dynamic secrets con TTL |
| **KMS** | 5 backends (RustyVault, Age, AWS KMS, Vault, Cosmian) |
| **Encryption** | Envelope encryption |
| **Audit** | 7 años retención, 5 formatos export |
| **Break-glass** | Multi-party approval |
**Métricas de Seguridad**: 39,699 líneas, 12 componentes
#### IA Integration
| Capacidad | Descripción |
| ----------- | ------------- |
| **MCP Server** | Rust-native (1000x vs Python) |
| **RAG System** | 1,200+ docs de dominio |
| **NLP** | Intent recognition, entity extraction |
| **Multi-provider** | OpenAI, Claude, Ollama |
| **Nickel Generation** | Con validación automática |
### Arquitectura
```text
┌─────────────────────────────────────────────────────────────────┐
│ Provisioning (v5.0.0-nickel, 218+ tests) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
│ │ CLI │ │ Control │ │ Platform │ │
│ │ 211 lines │ │ Center │ │ Orchestrator │ │
│ │ 80+ shorts │ │ (Axum) │ │ (Rust/Nu hybrid) │ │
│ └──────┬──────┘ └──────┬──────┘ └────────────┬────────────┘ │
│ │ │ │ │
│ ┌──────┴────────────────┴──────────────────────┴─────────────┐ │
│ │ Extensions │ │
│ │ Providers: AWS │ UpCloud │ Local │ │
│ │ Taskservs: 50+ infrastructure services │ │
│ │ Clusters: K8s, etcd, etc. templates │ │
│ │ Workflows: Automation definitions │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌───────────────────────┴───────────────────────────────────┐ │
│ │ Security Layer (39K lines, 12 components) │ │
│ │ JWT │ Cedar │ MFA │ KMS │ Audit │ Secrets │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌───────────────────────┴───────────────────────────────────┐ │
│ │ AI Layer: MCP Server │ RAG (1200+ docs) │ LLM Providers │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌───────────────────────┴───────────────────────────────────┐ │
│ │ State: SurrealDB │ Filesystem │ Nickel Schemas │ │
│ └───────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
---
## 5. SecretumVault: Gestión de Secretos Post-Cuántica
### Visión General
SecretumVault es un **sistema de gestión de secretos** escrito en Rust con **criptografía post-cuántica lista para producción** (ML-KEM-768, ML-DSA-65 según NIST FIPS 203/204).
### Capacidades Completas
#### Backends Criptográficos
| Backend | Algoritmos | Estado |
| --------- | ------------ | -------- |
| **OpenSSL** | RSA-2048/4096, ECDSA (P-256/384/521), AES-256-GCM | ✅ Producción |
| **OQS** | ML-KEM-768, ML-DSA-65 | ✅ **Producción (PQC)** |
| **AWS-LC** | RSA, ECDSA (PQC experimental) | ⚠️ Experimental |
| **RustCrypto** | AES-256-GCM, ChaCha20-Poly1305 | ⚠️ Testing |
#### Motores de Secretos
| Motor | Funcionalidad |
| ------- | --------------- |
| **KV Engine** | Almacenamiento versionado de secretos |
| **Transit Engine** | Encryption-as-a-service con rotación de claves |
| **PKI Engine** | Generación de certificados X.509, CA management |
| **Database Engine** | Credenciales dinámicas con TTL |
#### Backends de Storage
| Backend | Uso Típico |
| --------- | ------------ |
| **Filesystem** | Desarrollo, single-node |
| **etcd** | Kubernetes, alta disponibilidad |
| **SurrealDB** | Queries complejas, time-series |
| **PostgreSQL** | Enterprise, ACID garantizado |
#### Seguridad Enterprise
| Componente | Capacidades |
| ------------ | ------------- |
| **Seal/Unseal** | Shamir Secret Sharing (K de N threshold) |
| **Autenticación** | Token-based con TTL configurable |
| **Autorización** | Cedar ABAC (AWS-compatible policies) |
| **TLS/mTLS** | Cifrado en tránsito + verificación cliente |
| **Audit** | Logging estructurado de todos los eventos |
### Arquitectura
```text
┌─────────────────────────────────────────────────────────────────┐
│ SecretumVault (~11K LOC, 50+ tests) │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
│ │ CLI │ │ REST API │ │ Secrets Engines │ │
│ │ (clap) │ │ (Axum) │ │ KV/Transit/PKI/DB │ │
│ └──────┬──────┘ └──────┬──────┘ └────────────┬────────────┘ │
│ │ │ │ │
│ ┌──────┴────────────────┴──────────────────────┴─────────────┐ │
│ │ VaultCore │ │
│ │ Seal (Shamir) │ TokenManager │ Cedar ABAC │ Metrics │ │
│ └────────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌───────────────────────┴───────────────────────────────────┐ │
│ │ Crypto Backends │ │
│ │ OpenSSL │ OQS (PQC) │ AWS-LC │ RustCrypto │ │
│ └───────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌───────────────────────┴───────────────────────────────────┐ │
│ │ Storage Backends │ │
│ │ Filesystem │ etcd │ SurrealDB │ PostgreSQL │ │
│ └───────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
```
---
## 6. Matriz de Funcionalidades Completa
### Capacidades por Categoría
#### Gestión de Proyectos
| Capacidad | Vapora | Kogral | TypeDialog | Provisioning | SecretumVault |
| ----------- | -------- | -------- | ------------ | -------------- | --------------- |
| Kanban Board | ✅ Leptos | - | - | - | - |
| Task Management | ✅ Full | - | - | - | - |
| Project Hierarchy | ✅ Scopes | ✅ Graphs | - | ✅ Workspaces | - |
| Real-time Collab | ✅ WebSocket | - | - | - | - |
| Change Tracking | ✅ History | ✅ Git | - | ✅ Audit | ✅ Audit |
#### Conocimiento y Documentación
| Capacidad | Vapora | Kogral | TypeDialog | Provisioning | SecretumVault |
| ----------- | -------- | -------- | ------------ | -------------- | --------------- |
| Knowledge Graph | ✅ Temporal | ✅ 6 tipos | - | - | - |
| ADRs | - | ✅ Nativo | - | - | - |
| Patterns Library | - | ✅ Nativo | - | - | - |
| Guidelines | - | ✅ Herencia | - | ✅ Schemas | - |
| Semantic Search | ✅ KG | ✅ fastembed | ✅ Tantivy | ✅ RAG | - |
#### Interacción Usuario
| Capacidad | Vapora | Kogral | TypeDialog | Provisioning | SecretumVault |
| ----------- | -------- | -------- | ------------ | -------------- | --------------- |
| Web UI | ✅ Leptos | - | ✅ Axum | ✅ Leptos | - |
| CLI | - | ✅ 13 cmds | ✅ inquire | ✅ 80+ shorts | ✅ svault |
| TUI | - | - | ✅ ratatui | ✅ ratatui | - |
| Forms | - | - | ✅ 8 tipos | - | - |
| i18n | - | - | ✅ Fluent | - | - |
#### Automatización
| Capacidad | Vapora | Kogral | TypeDialog | Provisioning | SecretumVault |
| ----------- | -------- | -------- | ------------ | -------------- | --------------- |
| Pipelines | ✅ Agent | - | ✅ Agent MDX | ✅ Workflows | - |
| LLM Agents | ✅ 12 roles | - | ✅ Multi-prov | ✅ MCP | - |
| IaC Generation | - | - | ✅ 6 clouds | ✅ Nickel | - |
| CI/CD | - | - | ✅ Backend | ✅ Full | - |
| Orchestration | ✅ NATS | - | - | ✅ Hybrid | - |
#### Infraestructura
| Capacidad | Vapora | Kogral | TypeDialog | Provisioning | SecretumVault |
| ----------- | -------- | -------- | ------------ | -------------- | --------------- |
| Multi-cloud | - | - | ✅ Prov-gen | ✅ AWS/UpCloud/Local | - |
| Kubernetes | ✅ Deploy | - | - | ✅ Full | ✅ etcd backend |
| Secrets Mgmt | - | - | ✅ Encrypt | ✅ 5 KMS | ✅ **4 engines** |
| Networking | - | - | - | ✅ VPC/Subnet | - |
| State Mgmt | - | - | - | ✅ Checkpoints | ✅ 4 backends |
#### Seguridad
| Capacidad | Vapora | Kogral | TypeDialog | Provisioning | SecretumVault |
| ----------- | -------- | -------- | ------------ | -------------- | --------------- |
| Authentication | ✅ JWT | - | - | ✅ JWT+MFA | ✅ Token-based |
| Authorization | ✅ Cedar | - | - | ✅ Cedar | ✅ Cedar ABAC |
| Multi-tenant | ✅ Scopes | - | - | ✅ Full | - |
| Audit | ✅ Logging | - | - | ✅ 7 años | ✅ Full audit |
| Encryption | - | - | ✅ Field | ✅ Envelope | ✅ **PQC native** |
| Post-Quantum | - | - | - | - | ✅ ML-KEM/ML-DSA |
#### Observabilidad
| Capacidad | Vapora | Kogral | TypeDialog | Provisioning | SecretumVault |
| ----------- | -------- | -------- | ------------ | -------------- | --------------- |
| Metrics | ✅ Prometheus | - | - | ✅ Full | ✅ Prometheus |
| Logging | ✅ tracing | ✅ tracing | - | ✅ tracing | ✅ tracing |
| Tracing | ✅ OTEL | - | - | ✅ OTEL | - |
| Dashboards | ✅ Grafana | - | - | ✅ Control Center | - |
---
## 7. Stack Tecnológico
### Dependencias Compartidas
```text
┌─────────────────────────────────────────────────────────────────┐
│ STACK TECNOLÓGICO COMÚN │
├─────────────────────────────────────────────────────────────────┤
│ │
│ LENGUAJE │
│ └── Rust 2021/2024 edition (type-safe, zero-cost) │
│ │
│ CONFIGURACIÓN │
│ └── Nickel 1.15+ (schemas tipados, lazy eval, validación) │
│ │
│ BASE DE DATOS │
│ └── SurrealDB 2.3+ (multi-model, graph, scopes) │
│ │
│ WEB FRAMEWORK │
│ └── Axum 0.8+ (async, composable, tower middleware) │
│ │
│ FRONTEND │
│ └── Leptos 0.8+ (WASM, reactive, CSR) │
│ │
│ TUI │
│ └── Ratatui 0.30+ (terminal UI, crossterm) │
│ │
│ CLI │
│ └── clap 4+ (derive API, completions) │
│ │
│ LLM │
│ └── rig-core 0.15+ (multi-provider, tools, streaming) │
│ │
│ MENSAJERÍA │
│ └── async-nats 0.45+ (JetStream, delivery garantizado) │
│ │
│ SERIALIZACIÓN │
│ └── serde 1.0 (JSON, YAML, TOML) │
│ │
│ ASYNC │
│ └── Tokio 1.48+ (runtime, spawn, timeouts) │
│ │
│ LOGGING │
│ └── tracing 0.1 (structured, JSON, env-filter) │
│ │
│ ERRORES │
│ └── anyhow + thiserror (ergonomic error handling) │
│ │
└─────────────────────────────────────────────────────────────────┘
```
---
## 8. Posicionamiento vs Competencia
### Por Dominio
#### Plataformas de Desarrollo (Vapora)
| Aspecto | Vapora | Jira | Linear | Notion |
| --------- | -------- | ------ | -------- | -------- |
| **Self-hosted** | ✅ | ❌ | ❌ | ❌ |
| **Multi-tenant** | ✅ Native | ❌ | ❌ | Partial |
| **Agent Orchestration** | ✅ Learning | ❌ | ❌ | ❌ |
| **LLM Integration** | ✅ 4 providers | AI features | ❌ | AI features |
| **Real-time** | ✅ WebSocket | ✅ | ✅ | ✅ |
| **Customizable** | ✅ Full | Limited | Limited | ✅ |
#### Knowledge Management (Kogral)
| Aspecto | Kogral | Obsidian | Notion | Confluence |
| --------- | -------- | ---------- | -------- | ------------ |
| **Git-native** | ✅ | Plugins | ❌ | ❌ |
| **Developer-focused** | ✅ ADRs/Patterns | General | General | General |
| **MCP Integration** | ✅ Native | ❌ | ❌ | ❌ |
| **Semantic Search** | ✅ Local+Cloud | Plugins | Internal | Internal |
| **Guideline Inheritance** | ✅ | ❌ | ❌ | ❌ |
| **Offline** | ✅ | ✅ | ❌ | ❌ |
#### Forms y Automatización (TypeDialog)
| Aspecto | TypeDialog | Typeform | SurveyJS | Inquirer |
| --------- | ------------ | ---------- | ---------- | ---------- |
| **Multi-backend** | ✅ 6 | Web only | Web only | CLI only |
| **Type-safe** | ✅ Nickel | ❌ | Partial | ❌ |
| **Agent Execution** | ✅ Native | ❌ | ❌ | ❌ |
| **IaC Generation** | ✅ 6 clouds | ❌ | ❌ | ❌ |
| **i18n** | ✅ Fluent | ✅ | ✅ | ❌ |
| **Self-hosted** | ✅ | ❌ | ✅ | ✅ |
#### IaC (Provisioning)
| Aspecto | Provisioning | Terraform | Pulumi | Ansible |
| --------- | -------------- | ----------- | -------- | --------- |
| **Language** | Nickel (typed) | HCL | TS/Py | YAML |
| **AI-native** | ✅ MCP+RAG | ❌ | ❌ | ❌ |
| **Security** | ✅ 39K lines | Basic | Basic | Vault plugin |
| **Orchestration** | ✅ Hybrid | State file | State | Playbooks |
| **Multi-cloud** | ✅ | ✅ | ✅ | ✅ |
| **DX** | ✅ 80+ shortcuts | Verbose | Standard | Standard |
#### Secrets Management (SecretumVault)
| Aspecto | SecretumVault | HashiCorp Vault | AWS Secrets Manager | Azure Key Vault |
| --------- | --------------- | ----------------- | --------------------- | ----------------- |
| **Language** | Rust (memory-safe) | Go | SaaS | SaaS |
| **Post-Quantum** | ✅ ML-KEM/ML-DSA | ❌ | ❌ | ❌ |
| **Self-hosted** | ✅ Complete | ✅ | ❌ | ❌ |
| **Crypto backends** | 4 pluggable | 1 fixed | 1 fixed | 1 fixed |
| **Storage backends** | 4 (FS/etcd/Surreal/PG) | Multiple | Proprietary | Proprietary |
| **Authorization** | Cedar ABAC | ACL | IAM | RBAC |
| **Shamir unsealing** | ✅ Native | ✅ | ❌ | ❌ |
| **License** | Apache-2.0 | BSL/Enterprise | Proprietary | Proprietary |
---
## 9. Integración entre Proyectos
### Flujo de Datos
```text
┌──────────────────┐
│ Kogral │
│ (Conocimiento) │
└────────┬─────────┘
│
Guidelines, Patterns, ADRs, Decisions
│
┌────────────────────────┼────────────────────────┐
│ │ │
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌─────────────┐
│ Vapora │◄───────▶│TypeDialog │◄───────▶│Provisioning │
│(Desarrollo)│ │ (Forms) │ │ (IaC) │
└─────┬─────┘ └─────┬─────┘ └──────┬──────┘
│ │ │
│ ┌───────────────┴───────────────┐ │
│ │ │ │
│ ▼ ▼ │
│ ┌───────────────────────────────────┐ │
└──▶│ SecretumVault │◄───┘
│ (Secrets + PQC Crypto) │
└───────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ PRODUCTO FINAL │
│ Software desarrollado, documentado, configurado, desplegado │
│ con secretos protegidos (PQC) │
└─────────────────────────────────────────────────────────────┘
```
### Sinergias Específicas
| Integración | Beneficio |
| ------------- | ----------- |
| Kogral → Vapora | Agentes consultan guidelines antes de generar código |
| Kogral → TypeDialog | Forms para captura estructurada de ADRs |
| Kogral → Provisioning | ADRs de infraestructura automáticos |
| Vapora → TypeDialog | Formularios como input para pipelines |
| Vapora → Provisioning | Orquestación de deployments |
| TypeDialog → Provisioning | prov-gen backend genera IaC desde forms |
### Componentes Reutilizables
| Componente | Origen | Usado En |
| ------------ | -------- | ---------- |
| SurrealDB patterns | Vapora | Kogral, Provisioning |
| Nickel schemas | Provisioning | TypeDialog, Kogral |
| rig-core abstraction | Vapora | Todos |
| Axum patterns | Vapora | TypeDialog, Provisioning |
| tracing setup | Vapora | Todos |
| Cedar policies | Provisioning | Vapora |
| Leptos components | Vapora | Provisioning |
---
## 10. Métricas del Portfolio
| Métrica | Vapora | Kogral | TypeDialog | Provisioning | SecretumVault | **Total** |
| --------- | -------- | -------- | ------------ | -------------- | --------------- | ----------- |
| **Crates** | 13 | 3 | 8 | 15+ | 1 | **40+** |
| **Tests** | 218 | 56 | 3,818 | 218 | 50+ | **4,360+** |
| **LOC (aprox)** | ~50K | ~15K | ~90K | ~40K | ~11K | **~206K** |
| **Backends** | 1 (Leptos) | 3 | 6 | 3 | 4 storage | **17** |
| **LLM Providers** | 4 | 4 | 4 | 3 | - | **4 únicos** |
| **MCP Tools** | Gateway | 7 | - | 7 | - | **14+** |
| **Crypto backends** | - | - | - | 5 KMS | 4 | **4 únicos** |
---
## 11. Orden de Adopción Recomendado
### Secuencia Óptima
```text
Fase 1: Kogral
│ Establece base de conocimiento
│ Guidelines, patterns, ADRs
▼
Fase 2: TypeDialog
│ Habilita inputs estructurados
│ Validación con Nickel contracts
▼
Fase 3: SecretumVault
│ Gestión segura de secretos
│ Preparación criptográfica PQC
▼
Fase 4: Vapora
│ Orquesta desarrollo con agentes
│ Aprovecha knowledge graph
▼
Fase 5: Provisioning
│ Infraestructura informada
│ por todo el contexto previo
```
### Adopción Independiente
Cada proyecto funciona de forma standalone:
- **Kogral**: Knowledge management sin dependencias externas
- **TypeDialog**: Forms y agentes sin otros proyectos
- **SecretumVault**: Gestión de secretos Rust-native
- **Vapora**: Desarrollo y orquestación completa
- **Provisioning**: IaC enterprise independiente
Las sinergias emergen con adopción combinada, pero no son requisito.
---
*Documento generado: 2026-01-22*
*Tipo: info (posicionamiento estratégico completo)*
Reference in New Issue Copy Permalink