docs(v5): Complete system documentation
Comprehensive documentation for TZZR system v5 including: - 00_VISION: Glossary and foundational philosophy - 01_ARQUITECTURA: System overview and server specs - 02_MODELO_DATOS: Entity definitions and data planes (T0, MST, BCK) - 03_COMPONENTES: Agent docs (CLARA, MARGARET, FELDMAN, GRACE) - 04_SEGURIDAD: Threat model and secrets management - 05_OPERACIONES: Infrastructure and backup/recovery - 06_INTEGRACIONES: GPU services (RunPod status: blocked) - 99_ANEXOS: Repository inventory (24 repos) Key findings documented: - CRITICAL: UFW inactive on CORP/HST - CRITICAL: PostgreSQL 5432 exposed - CRITICAL: .env files with 644 permissions - RunPod workers not starting (code ready in R2) - Infisical designated as single source of secrets (D-001) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
121
README.md
121
README.md
@@ -1,3 +1,120 @@
|
||||
# system-docs
|
||||
# TZZR System Documentation v5
|
||||
|
||||
Documentación oficial del sistema TZZR - System v5
|
||||
**Versión:** 5.0
|
||||
**Fecha:** 2024-12-24
|
||||
**Estado:** Consolidación completa
|
||||
|
||||
---
|
||||
|
||||
## Qué es TZZR
|
||||
|
||||
TZZR es un sistema de construcción de arquitecturas personales y empresariales mediante instancias Claude. Los agentes IA actúan como constructores que diseñan y edifican servidores clonables e independientes.
|
||||
|
||||
---
|
||||
|
||||
## Arquitectura General
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ ARCHITECT (69.62.126.110) │
|
||||
│ PostgreSQL central │ Gitea │ Orchestrator │ Infisical │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
│ │ │
|
||||
▼ ▼ ▼
|
||||
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
|
||||
│ DECK │ │ CORP │ │ HST │
|
||||
│ 72.62.1.113 │ │ 92.112.181.188 │ │ 72.62.2.84 │
|
||||
│ │ │ │ │ │
|
||||
│ CLARA, ALFRED │ │ MARGARET, JARED │ │ 973 tags │
|
||||
│ Servidor │ │ MASON, FELDMAN │ │ API pública │
|
||||
│ Personal │ │ Empresarial │ │ │
|
||||
└─────────────────┘ └─────────────────┘ └─────────────────┘
|
||||
│ │
|
||||
└────────┬───────────┘
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Cloudflare R2 (5 buckets) │
|
||||
│ architect │ deck │ corp │ hst │ locker │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Flujo de Datos Principal
|
||||
|
||||
```
|
||||
PACKET (móvil)
|
||||
↓
|
||||
CLARA (DECK) / MARGARET (CORP) ← Ingesta inmutable
|
||||
↓
|
||||
ALFRED / JARED ← Flujos predefinidos
|
||||
↓
|
||||
MASON ← Enriquecimiento (24h)
|
||||
↓
|
||||
FELDMAN ← Consolidación blockchain
|
||||
↓
|
||||
SENTINEL ← Auditoría (planificado)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Índice de Documentación
|
||||
|
||||
### 00_VISION
|
||||
- [Filosofía](00_VISION/filosofia.md) - 10 principios fundacionales
|
||||
- [Glosario](00_VISION/glosario.md) - Términos técnicos A-Z
|
||||
|
||||
### 01_ARQUITECTURA
|
||||
- [Overview](01_ARQUITECTURA/overview.md) - Vista general consolidada
|
||||
- [Servidores](01_ARQUITECTURA/servidores.md) - ARCHITECT, DECK, CORP, HST
|
||||
|
||||
### 02_MODELO_DATOS
|
||||
- [Entidades](02_MODELO_DATOS/entidades.md) - HST, ITM, PLY, LOC, FLG
|
||||
- [Planos](02_MODELO_DATOS/planos.md) - T0 (ITM), MST, BCK
|
||||
|
||||
### 03_COMPONENTES
|
||||
- [CLARA/MARGARET](03_COMPONENTES/agentes/clara-margaret.md) - Ingesta
|
||||
- [FELDMAN](03_COMPONENTES/agentes/feldman.md) - Consolidación
|
||||
- [GRACE](03_COMPONENTES/servicios/grace.md) - IA cognitiva
|
||||
|
||||
### 04_SEGURIDAD
|
||||
- [Modelo de Amenazas](04_SEGURIDAD/modelo-amenazas.md) - Riesgos
|
||||
- [Secretos](04_SEGURIDAD/secretos.md) - Gestión credenciales
|
||||
|
||||
### 05_OPERACIONES
|
||||
- [Infraestructura](05_OPERACIONES/infraestructura.md) - Servidores
|
||||
- [Backup/Recovery](05_OPERACIONES/backup-recovery.md) - DR plan
|
||||
|
||||
### 06_INTEGRACIONES
|
||||
- [GPU Services](06_INTEGRACIONES/gpu-services.md) - RunPod
|
||||
|
||||
### 99_ANEXOS
|
||||
- [Inventario Repos](99_ANEXOS/inventario-repos.md) - 24 repos
|
||||
|
||||
---
|
||||
|
||||
## Estado Actual
|
||||
|
||||
| Componente | Estado | Notas |
|
||||
|------------|--------|-------|
|
||||
| CLARA | Operativo | DECK:5051 |
|
||||
| MARGARET | Operativo | CORP:5051 |
|
||||
| ALFRED | Operativo | DECK:5052 |
|
||||
| JARED | Operativo | CORP:5052 |
|
||||
| MASON | Operativo | CORP:5053 |
|
||||
| FELDMAN | Operativo | CORP:5054 |
|
||||
| HST | Operativo | 973 tags |
|
||||
| SENTINEL | Planificado | Sin implementar |
|
||||
| GRACE | Bloqueado | RunPod no inicia |
|
||||
| NOTARIO | Planificado | Sin implementar |
|
||||
|
||||
---
|
||||
|
||||
## Generación
|
||||
|
||||
Documentación generada mediante proceso de auditoría colaborativa:
|
||||
- 3 auditores especializados (Arquitectura, Datos, Seguridad)
|
||||
- Cross-review y resolución de conflictos
|
||||
- Síntesis consolidada
|
||||
|
||||
**Fecha generación:** 2024-12-24
|
||||
|
||||
Reference in New Issue
Block a user