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:
ARCHITECT
383
05_OPERACIONES/infraestructura.md
Normal file
383
05_OPERACIONES/infraestructura.md
Normal file
@@ -0,0 +1,383 @@
|
||||
# Infraestructura TZZR
|
||||
|
||||
**Versión:** 5.0
|
||||
**Fecha:** 2024-12-24
|
||||
|
||||
---
|
||||
|
||||
## Resumen de Servidores
|
||||
|
||||
| Servidor | IP Pública | Rol | Proveedor |
|
||||
|----------|------------|-----|-----------|
|
||||
| ARCHITECT | 69.62.126.110 | Coordinador central | VPS |
|
||||
| DECK | 72.62.1.113 | Personal | VPS |
|
||||
| CORP | 92.112.181.188 | Empresarial | VPS |
|
||||
| HST | 72.62.2.84 | API Tags | VPS |
|
||||
| LOCKER | R2 | Almacenamiento | Cloudflare |
|
||||
|
||||
---
|
||||
|
||||
## ARCHITECT (69.62.126.110)
|
||||
|
||||
### Especificaciones
|
||||
- **OS:** Ubuntu 22.04 LTS
|
||||
- **Usuario:** orchestrator
|
||||
- **Servicios:** PostgreSQL, Gitea, Orchestrator, Infisical
|
||||
|
||||
### Puertos
|
||||
|
||||
| Puerto | Servicio | Estado |
|
||||
|--------|----------|--------|
|
||||
| 22 | SSH | Abierto |
|
||||
| 2222 | Gitea SSH | Abierto |
|
||||
| 3000 | Gitea HTTP | Abierto |
|
||||
| 5050 | Orchestrator | Abierto |
|
||||
| 5432 | PostgreSQL | **CRÍTICO: 0.0.0.0** |
|
||||
| 8082 | Infisical | Abierto |
|
||||
|
||||
### Acceso
|
||||
|
||||
```bash
|
||||
ssh orchestrator@69.62.126.110
|
||||
```
|
||||
|
||||
### PostgreSQL
|
||||
|
||||
```bash
|
||||
sudo -u postgres psql -d architect
|
||||
```
|
||||
|
||||
### Gitea
|
||||
|
||||
```
|
||||
URL: http://localhost:3000
|
||||
Token lectura: 5ca10e5b71d41f9b22f12d0f96bfc2e6de5c2c7f
|
||||
Token escritura: ac5a604b9aac5cee81192a656fc918f9efa3834b
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## DECK (72.62.1.113)
|
||||
|
||||
### Especificaciones
|
||||
- **OS:** Ubuntu 22.04 LTS
|
||||
- **Usuario:** root
|
||||
- **Servicios:** CLARA, ALFRED, Mailcow, Directus, etc.
|
||||
|
||||
### Puertos
|
||||
|
||||
| Puerto | Servicio | Estado |
|
||||
|--------|----------|--------|
|
||||
| 22 | SSH | Abierto |
|
||||
| 25 | SMTP | Abierto |
|
||||
| 143 | IMAP | Abierto |
|
||||
| 465 | SMTPS | Abierto |
|
||||
| 587 | Submission | Abierto |
|
||||
| 993 | IMAPS | Abierto |
|
||||
| 5051 | CLARA | Abierto |
|
||||
| 5052 | ALFRED | Abierto |
|
||||
| 8055 | Directus | Abierto |
|
||||
| 8080 | ntfy | Abierto |
|
||||
| 8082 | FileBrowser | Abierto |
|
||||
| 8083 | Shlink | Abierto |
|
||||
| 8085 | Vaultwarden | Abierto |
|
||||
|
||||
### Acceso
|
||||
|
||||
```bash
|
||||
ssh -i ~/.ssh/tzzr root@72.62.1.113
|
||||
```
|
||||
|
||||
### Docker Containers
|
||||
|
||||
```bash
|
||||
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## CORP (92.112.181.188)
|
||||
|
||||
### Especificaciones
|
||||
- **OS:** Ubuntu 22.04 LTS
|
||||
- **Usuario:** root
|
||||
- **Servicios:** MARGARET, JARED, MASON, FELDMAN, Odoo, Nextcloud
|
||||
|
||||
### Puertos
|
||||
|
||||
| Puerto | Servicio | Estado |
|
||||
|--------|----------|--------|
|
||||
| 22 | SSH | Abierto |
|
||||
| 80 | Caddy HTTP | Abierto |
|
||||
| 443 | Caddy HTTPS | Abierto |
|
||||
| 5051 | MARGARET | Abierto |
|
||||
| 5052 | JARED | Abierto |
|
||||
| 5053 | MASON | Abierto |
|
||||
| 5054 | FELDMAN | Abierto |
|
||||
| 5432 | PostgreSQL | Local |
|
||||
| 8055 | Directus | Abierto |
|
||||
| 8069 | Odoo | Abierto |
|
||||
| 8080 | Nextcloud | Abierto |
|
||||
| 8081 | Vaultwarden | Abierto |
|
||||
|
||||
### Acceso
|
||||
|
||||
```bash
|
||||
ssh -i ~/.ssh/tzzr root@92.112.181.188
|
||||
```
|
||||
|
||||
### Firewall
|
||||
|
||||
**ALERTA CRÍTICA: UFW INACTIVO**
|
||||
|
||||
```bash
|
||||
# Verificar estado
|
||||
ufw status
|
||||
|
||||
# Activar (cuando se autorice)
|
||||
ufw default deny incoming
|
||||
ufw allow 22/tcp
|
||||
ufw allow 80/tcp
|
||||
ufw allow 443/tcp
|
||||
ufw enable
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## HST (72.62.2.84)
|
||||
|
||||
### Especificaciones
|
||||
- **OS:** Ubuntu 22.04 LTS
|
||||
- **Usuario:** root
|
||||
- **Servicios:** Nginx, Directus, PostgreSQL
|
||||
|
||||
### Puertos
|
||||
|
||||
| Puerto | Servicio | Estado |
|
||||
|--------|----------|--------|
|
||||
| 22 | SSH | Abierto |
|
||||
| 80 | Nginx HTTP | Abierto |
|
||||
| 443 | Nginx HTTPS | Abierto |
|
||||
| 5432 | PostgreSQL | Local |
|
||||
| 8055 | Directus | Abierto |
|
||||
|
||||
### Acceso
|
||||
|
||||
```bash
|
||||
ssh -i ~/.ssh/tzzr root@72.62.2.84
|
||||
```
|
||||
|
||||
### API Pública
|
||||
|
||||
```
|
||||
https://tzrtech.org/{h_maestro}.png
|
||||
```
|
||||
|
||||
### Estadísticas HST
|
||||
|
||||
| Grupo | Cantidad |
|
||||
|-------|----------|
|
||||
| hst | 639 |
|
||||
| spe | 145 |
|
||||
| vsn | 84 |
|
||||
| flg | 65 |
|
||||
| vue | 21 |
|
||||
| **Total** | **973** |
|
||||
|
||||
---
|
||||
|
||||
## LOCKER (Cloudflare R2)
|
||||
|
||||
### Endpoint
|
||||
|
||||
```
|
||||
https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
|
||||
```
|
||||
|
||||
### Buckets
|
||||
|
||||
| Bucket | Uso | Tamaño Aprox |
|
||||
|--------|-----|--------------|
|
||||
| architect | Backups, configs, GPU services | ~500 MB |
|
||||
| deck | Archivos personales (CLARA) | Variable |
|
||||
| corp | Archivos empresariales (MARGARET) | Variable |
|
||||
| hst | Imágenes de tags | ~100 MB |
|
||||
| locker | Almacenamiento general | Variable |
|
||||
|
||||
### Acceso
|
||||
|
||||
```bash
|
||||
source /home/orchestrator/orchestrator/.env
|
||||
export AWS_ACCESS_KEY_ID="$R2_ACCESS_KEY"
|
||||
export AWS_SECRET_ACCESS_KEY="$R2_SECRET_KEY"
|
||||
|
||||
aws s3 ls s3://architect/ \
|
||||
--endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## SSH Keys
|
||||
|
||||
### Ubicación
|
||||
|
||||
```
|
||||
/home/orchestrator/.ssh/tzzr # Private key
|
||||
/home/orchestrator/.ssh/tzzr.pub # Public key
|
||||
```
|
||||
|
||||
### Permisos
|
||||
|
||||
```bash
|
||||
chmod 600 ~/.ssh/tzzr
|
||||
chmod 644 ~/.ssh/tzzr.pub
|
||||
```
|
||||
|
||||
### Configuración SSH
|
||||
|
||||
```bash
|
||||
# ~/.ssh/config
|
||||
Host deck
|
||||
HostName 72.62.1.113
|
||||
User root
|
||||
IdentityFile ~/.ssh/tzzr
|
||||
|
||||
Host corp
|
||||
HostName 92.112.181.188
|
||||
User root
|
||||
IdentityFile ~/.ssh/tzzr
|
||||
|
||||
Host hst
|
||||
HostName 72.62.2.84
|
||||
User root
|
||||
IdentityFile ~/.ssh/tzzr
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Bases de Datos
|
||||
|
||||
### architect (ARCHITECT)
|
||||
|
||||
```
|
||||
Host: localhost
|
||||
Port: 5432
|
||||
Database: architect
|
||||
User: postgres
|
||||
```
|
||||
|
||||
Tablas principales:
|
||||
- context_blocks
|
||||
- agents
|
||||
- creds_*
|
||||
|
||||
### tzzr (DECK)
|
||||
|
||||
```
|
||||
Host: localhost
|
||||
Port: 5432
|
||||
Database: tzzr
|
||||
```
|
||||
|
||||
Tablas principales:
|
||||
- clara_log
|
||||
- deck_visiones
|
||||
- deck_milestones
|
||||
|
||||
### corp (CORP)
|
||||
|
||||
```
|
||||
Host: localhost
|
||||
Port: 5432
|
||||
Database: corp
|
||||
```
|
||||
|
||||
Tablas principales:
|
||||
- margaret_log
|
||||
- mason_workspace
|
||||
- feldman_cola
|
||||
- milestones
|
||||
- bloques
|
||||
|
||||
### hst_images (HST)
|
||||
|
||||
```
|
||||
Host: localhost
|
||||
Port: 5432
|
||||
Database: hst_images
|
||||
```
|
||||
|
||||
Tablas principales:
|
||||
- hst_tags
|
||||
- hst_trees
|
||||
|
||||
---
|
||||
|
||||
## Monitoreo
|
||||
|
||||
### Comandos de Estado
|
||||
|
||||
```bash
|
||||
# Verificar servicios ARCHITECT
|
||||
systemctl status postgresql
|
||||
docker ps
|
||||
|
||||
# Verificar servicios DECK
|
||||
ssh deck 'docker ps'
|
||||
ssh deck 'systemctl status fail2ban'
|
||||
|
||||
# Verificar servicios CORP
|
||||
ssh corp 'docker ps'
|
||||
ssh corp 'ufw status'
|
||||
|
||||
# Verificar servicios HST
|
||||
ssh hst 'systemctl status nginx'
|
||||
ssh hst 'systemctl status postgresql'
|
||||
```
|
||||
|
||||
### Logs Importantes
|
||||
|
||||
```bash
|
||||
# PostgreSQL
|
||||
journalctl -u postgresql -f
|
||||
|
||||
# Docker containers
|
||||
docker logs <container> -f
|
||||
|
||||
# Nginx (HST)
|
||||
tail -f /var/log/nginx/access.log
|
||||
tail -f /var/log/nginx/error.log
|
||||
|
||||
# SSH auth
|
||||
tail -f /var/log/auth.log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Diagrama de Red
|
||||
|
||||
```
|
||||
Internet
|
||||
│
|
||||
┌──────────────────────────┼──────────────────────────┐
|
||||
│ │ │
|
||||
▼ ▼ ▼
|
||||
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
|
||||
│ ARCHITECT │ │ DECK │ │ CORP │
|
||||
│ 69.62.126.110 │◄────────│ 72.62.1.113 │────────►│92.112.181.188 │
|
||||
└───────────────┘ SSH └───────────────┘ SSH └───────────────┘
|
||||
│ │ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌───────────────┐ │
|
||||
│ │ HST │ │
|
||||
└────────────────►│ 72.62.2.84 │◄──────────────────┘
|
||||
SSH └───────────────┘
|
||||
│
|
||||
│ HTTPS
|
||||
▼
|
||||
┌───────────────┐
|
||||
│ Cloudflare │
|
||||
│ R2 │
|
||||
└───────────────┘
|
||||
```
|
||||
Reference in New Issue
Block a user