0ee01d07a3
Updates to ensure DECK/CORP are documented as autonomous instances: - overview.md: Clarify ARCHITECT is for build/deploy only, not runtime - filosofia.md: Mark shared services (GRACE, etc.) as optional - backup-recovery.md: Each instance does its own local backup to its own R2 bucket Key principle: Instances never depend on ARCHITECT at runtime. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
168 lines
11 KiB
Markdown
168 lines
11 KiB
Markdown
# Arquitectura Overview
|
|
|
|
**Versión:** 5.0
|
|
**Fecha:** 2024-12-24
|
|
|
|
---
|
|
|
|
## Principio Fundamental
|
|
|
|
> **ARCHITECT es el constructor. DECK y CORP son instancias autónomas.**
|
|
|
|
- **ARCHITECT**: Construye, despliega, coordina. NO es dependencia runtime.
|
|
- **DECK/CORP**: Operan independientemente. Funcionan si ARCHITECT está caído.
|
|
|
|
---
|
|
|
|
## Diagrama General
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────┐
|
|
│ CAPA DE CONSTRUCCIÓN (solo deploy/dev) │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
|
│ │ ARCHITECT (69.62.126.110) │ │
|
|
│ │ ┌──────────┐ ┌──────────┐ ┌────────────┐ ┌───────────────┐ │ │
|
|
│ │ │PostgreSQL│ │ Gitea │ │Orchestrator│ │ Infisical │ │ │
|
|
│ │ │ contexto │ │ 25 repos │ │ v5 │ │ (master) │ │ │
|
|
│ │ └──────────┘ └──────────┘ └────────────┘ └───────────────┘ │ │
|
|
│ └─────────────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ Rol: Construcción, deployment, gestión central de secretos │
|
|
│ NO es dependencia runtime de las instancias │
|
|
└─────────────────────────────────────────────────────────────────────────┘
|
|
│ │ │
|
|
deploy │ │ │ deploy
|
|
▼ ▼ ▼
|
|
┌─────────────────────────────────────────────────────────────────────────┐
|
|
│ CAPA DE INSTANCIAS (autónomas) │
|
|
│ │
|
|
│ ┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐ │
|
|
│ │ DECK │ │ CORP │ │ HST │ │
|
|
│ │ 72.62.1.113 │ │ 92.112.181.188 │ │ 72.62.2.84 │ │
|
|
│ │ │ │ │ │ │ │
|
|
│ │ CLARA :5051 │ │ MARGARET :5051 │ │ 973 tags │ │
|
|
│ │ ALFRED :5052 │ │ JARED :5052 │ │ API pública │ │
|
|
│ │ │ │ MASON :5053 │ │ Directus :8055 │ │
|
|
│ │ Mailcow │ │ FELDMAN :5054 │ │ │ │
|
|
│ │ Vaultwarden │ │ │ │ │ │
|
|
│ │ Directus │ │ Odoo │ │ │ │
|
|
│ └───────────────────┘ │ Nextcloud │ └───────────────────┘ │
|
|
│ │ └───────────────────┘ │ │
|
|
│ │ │ │ │
|
|
│ └─────────────────────────┼──────────────────────┘ │
|
|
│ │ │
|
|
└───────────────────────────────────┼─────────────────────────────────────┘
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────┐
|
|
│ CAPA DE ALMACENAMIENTO │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────────────┐ │
|
|
│ │ Cloudflare R2 │ │
|
|
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐ │ │
|
|
│ │ │architect │ │ deck │ │ corp │ │ hst │ │ locker │ │ │
|
|
│ │ │ backups │ │ archivos │ │ archivos │ │ imágenes │ │ general│ │ │
|
|
│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └────────┘ │ │
|
|
│ └─────────────────────────────────────────────────────────────────┘ │
|
|
└─────────────────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────────────────┐
|
|
│ CAPA GPU (RunPod) │
|
|
│ Estado: BLOQUEADO - Workers no inician │
|
|
│ │
|
|
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
|
│ │ GRACE │ │ PENNY │ │ FACTORY │ │
|
|
│ │ 18 módulos│ │ texto │ │generación│ │
|
|
│ └──────────┘ └──────────┘ └──────────┘ │
|
|
└─────────────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Flujo de Datos
|
|
|
|
```
|
|
PACKET (App móvil)
|
|
│
|
|
│ POST /ingest
|
|
│ Content-Type: multipart/form-data
|
|
│ X-Auth-Key: {h_instancia}
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────┐
|
|
│ CLARA (DECK) / MARGARET (CORP) │
|
|
│ │
|
|
│ 1. Validar h_instancia │
|
|
│ 2. Calcular h_entrada (SHA-256) │
|
|
│ 3. Subir archivos a R2 │
|
|
│ 4. Insertar en clara_log/margaret_log │
|
|
│ 5. Estado: 'recibido' (inmutable) │
|
|
└─────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────┐
|
|
│ ALFRED (DECK) / JARED (CORP) │
|
|
│ │
|
|
│ 1. Aplicar flujos predefinidos │
|
|
│ 2. Ejecutar reglas automáticas │
|
|
│ 3. Enviar a MASON si requiere mejora │
|
|
└─────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────┐
|
|
│ MASON │
|
|
│ │
|
|
│ 1. Recibir de ALFRED/JARED │
|
|
│ 2. Ventana flotante 24h │
|
|
│ 3. Usuario enriquece datos │
|
|
│ 4. [Futuro] GRACE extrae información │
|
|
│ 5. Enviar a FELDMAN cuando listo │
|
|
└─────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────┐
|
|
│ FELDMAN │
|
|
│ │
|
|
│ 1. Recibir en feldman_cola │
|
|
│ 2. Validar reglas (M-001, M-002, M-003)│
|
|
│ 3. Crear milestone o bloque │
|
|
│ 4. Calcular hash_contenido │
|
|
│ 5. Encadenar (hash_previo) │
|
|
│ 6. [Futuro] Merkle tree, blockchain │
|
|
└─────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────┐
|
|
│ SENTINEL (planificado) │
|
|
│ │
|
|
│ LIGHT: Cada 5 min, reglas automáticas │
|
|
│ DEEP: Cada 1 hora, muestreo con LLM │
|
|
└─────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Comunicación Entre Servidores
|
|
|
|
| Origen | Destino | Protocolo | Puerto | Propósito |
|
|
|--------|---------|-----------|--------|-----------|
|
|
| DECK | ARCHITECT | SSH/Git | 2222 | Push repos |
|
|
| DECK | R2 | HTTPS | 443 | Almacenamiento |
|
|
| CORP | ARCHITECT | SSH/Git | 2222 | Push repos |
|
|
| CORP | R2 | HTTPS | 443 | Almacenamiento |
|
|
| HST | ARCHITECT | SSH | 22 | Administración |
|
|
| ARCHITECT | DECK | SSH | 22 | Deploy |
|
|
| ARCHITECT | CORP | SSH | 22 | Deploy |
|
|
|
|
---
|
|
|
|
## Bases de Datos
|
|
|
|
| Servidor | Database | Tablas Principales |
|
|
|----------|----------|--------------------|
|
|
| ARCHITECT | architect | context_blocks, agents, creds_* |
|
|
| DECK | tzzr | clara_log, alfred_executions |
|
|
| CORP | corp | margaret_log, mason_workspace, feldman_* |
|
|
| HST | hst_images | hst_tags, hst_trees |
|