Infrastructure documentation - Initial commit

- Added comprehensive infrastructure overview
- Server documentation: ARCHITECT, DECK, CORP, HST
- Service documentation: Odoo, Directus, Context Manager
- Includes configuration, monitoring, and backup procedures
This commit is contained in:
ARCHITECT
2025-12-30 15:58:37 +00:00
parent 7a4e826432
commit e47274c408
8 changed files with 1348 additions and 2 deletions

124
servers/ARCHITECT.md Normal file
View File

@@ -0,0 +1,124 @@
# Servidor ARCHITECT (69.62.126.110)
## Overview
ARCHITECT es el servidor central del sistema TZZR. Coordina todos los servicios, gestiona la base de datos centralizada, y aloja Gitea para control de versiones.
**IP**: 69.62.126.110
**Usuario**: architect
**Acceso SSH**: ssh root@69.62.126.110 -i ~/.ssh/tzzr
## Servicios Principales
### 1. Gitea (Puerto 3000)
- **URL Local**: http://localhost:3000
- **URL Remota**: https://git.tzzrarchitect.me
- **Función**: Repositorio central de código
- **Configuración**: /etc/gitea/
- **Data**: /var/lib/gitea/
Repositorios principales:
- `admin/infrastructure-docs` - Documentación de infraestructura
- `captain-claude` - Sistema multiagente central
### 2. PostgreSQL
- **Host**: localhost
- **Puerto**: 5432
- **Rol Principal**: architect
- **Base de datos**: tzzr_db
Bases de datos:
- `tzzr_db` - Base de datos principal del sistema
- Backups en: `s3://architect/backups/`
### 3. Context Manager
- **Ubicación**: /home/architect/captain-claude/context-manager/
- **Función**: Gestión de contexto para agentes IA
- **Tecnología**: Python + PostgreSQL
- **Configuración**: src/database.py
## Directorios Importantes
```
/home/architect/
├── captain-claude/ # Sistema multiagente principal
│ ├── context-manager/ # Gestor de contexto
│ └── agents/ # Agentes IA
├── .ssh/ # Claves SSH
├── .gitea-token # Token de autenticación Gitea
└── .git-credentials # Credenciales de Git
```
## Backup y Recuperación
### Backup Gitea
```bash
gitea dump -o /tmp/gitea-backup-$(date +%Y%m%d).zip
aws s3 cp /tmp/gitea-backup-*.zip s3://architect/backups/ \
--endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
```
### Backup PostgreSQL
```bash
pg_dump -U architect tzzr_db > /tmp/tzzr_db.sql
aws s3 cp /tmp/tzzr_db.sql s3://architect/backups/ \
--endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
```
## Conexiones a Servidores Remotos
ARCHITECT se conecta a:
- **DECK**: ssh root@72.62.1.113 -i ~/.ssh/tzzr
- **CORP**: ssh root@92.112.181.188 -i ~/.ssh/tzzr
- **HST**: ssh root@72.62.2.84 -i ~/.ssh/tzzr
## Almacenamiento R2
### Credenciales R2
- Endpoint: https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
- Access Key: Almacenada en ~/.aws/credentials
### Buckets
- **architect**: Almacenamiento principal
- `documentos adjuntos/` - Documentos para usuarios
- `system/` - Archivos internos
- `backups/` - Backups del sistema
- `auditorias/` - Logs de auditoría
## Monitoreo y Logs
```bash
# Estado de servicios
systemctl status gitea
systemctl status postgresql
# Logs Gitea
tail -f /var/log/gitea/gitea.log
# Logs PostgreSQL
tail -f /var/log/postgresql/postgresql-*.log
# Logs del sistema
journalctl -xe
```
## Tareas Administrativas
### Crear Repositorio en Gitea
```bash
TOKEN=$(cat ~/.gitea-token)
curl -X POST "http://localhost:3000/api/v1/user/repos" \
-H "Authorization: token $TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "repo-name", "description": "Description", "private": false, "auto_init": true}'
```
### Conectar a PostgreSQL
```bash
psql -U architect -d tzzr_db
```
## Últimas Actualizaciones
- 2025-12-30: Documentación inicial
- 2025-12-18: Instalación inicial de ARCHITECT

143
servers/CORP.md Normal file
View File

@@ -0,0 +1,143 @@
# Servidor CORP (92.112.181.188)
## Overview
CORP es el servidor empresarial que aloja sistemas de gestión empresarial y contenidos. Incluye Odoo para ERP y Directus para gestión de contenidos.
**IP**: 92.112.181.188
**Usuario**: root
**Acceso SSH**: ssh root@92.112.181.188 -i ~/.ssh/tzzr
## Servicios Principales
### 1. Odoo (Puerto 8069)
- **Función**: Sistema ERP empresarial
- **URL Local**: http://localhost:8069
- **Ubicación**: /opt/odoo/
- **Tecnología**: Python/Odoo Framework
**Módulos Disponibles**:
- Contabilidad y finanzas
- Ventas y CRM
- Inventario
- Recursos humanos
- Proyectos
- Nómina
**Base de datos**: PostgreSQL
- Host: 69.62.126.110 (ARCHITECT)
- Database: odoo_db
**Configuración**: /etc/odoo/odoo.conf
### 2. Directus (Puerto 8055)
- **Función**: CMS y gestor de contenidos
- **URL Local**: http://localhost:8055
- **Ubicación**: /opt/directus/
- **Tecnología**: Node.js/Vue.js
**Funcionalidades**:
- Gestión de contenidos
- API REST automática
- Control de acceso granular
- Versionamiento de contenidos
- Flujos de trabajo
**Base de datos**: PostgreSQL
- Host: 69.62.126.110 (ARCHITECT)
- Database: directus_db
## Directorios Importantes
```
/opt/
├── odoo/ # Instalación de Odoo
│ ├── addons/ # Módulos customizados
│ └── config/ # Configuración
├── directus/ # Instalación de Directus
│ ├── uploads/ # Archivos subidos
│ └── config/ # Configuración
└── nginx/ # Servidor web (reverse proxy)
/home/
└── backups/ # Backups locales
```
## Monitoreo y Administración
### Odoo
```bash
# Estado del servicio
systemctl status odoo
# Logs
tail -f /var/log/odoo/odoo.log
# Acceso a la interfaz
# Admin: http://localhost:8069
```
### Directus
```bash
# Estado del servicio
systemctl status directus
# Logs
tail -f /var/log/directus/directus.log
# API Directus
# http://localhost:8055/admin
```
## Backup de Datos
### Odoo
```bash
# Backup de la base de datos
pg_dump -h 69.62.126.110 -U architect odoo_db > /home/backups/odoo_db_$(date +%Y%m%d).sql
# Backup de archivos
tar -czf /home/backups/odoo_$(date +%Y%m%d).tar.gz /opt/odoo/
# Subir a R2
aws s3 cp /home/backups/ s3://architect/backups/ --recursive \
--endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
```
### Directus
```bash
# Backup de la base de datos
pg_dump -h 69.62.126.110 -U architect directus_db > /home/backups/directus_db_$(date +%Y%m%d).sql
# Backup de uploads
tar -czf /home/backups/directus_uploads_$(date +%Y%m%d).tar.gz /opt/directus/uploads/
# Subir a R2
aws s3 cp /home/backups/ s3://architect/backups/ --recursive \
--endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
```
## Nginx (Reverse Proxy)
```bash
# Configuración
cat /etc/nginx/sites-enabled/odoo
cat /etc/nginx/sites-enabled/directus
# Recargar configuración
systemctl reload nginx
# Verificar sintaxis
nginx -t
```
## Conexión a Base de Datos Central
Ambos servicios se conectan a la PostgreSQL centralizada:
- **Host**: 69.62.126.110
- **Puerto**: 5432
- **Usuario**: architect
## Últimas Actualizaciones
- 2025-12-30: Documentación inicial

114
servers/DECK.md Normal file
View File

@@ -0,0 +1,114 @@
# Servidor DECK (72.62.1.113)
## Overview
DECK es un servidor de procesamiento de alto rendimiento con capacidades GPU. Aloja los servicios GRACE, PENNY y FACTORY para procesamiento de IA y análisis.
**IP**: 72.62.1.113
**Usuario**: root
**Acceso SSH**: ssh root@72.62.1.113 -i ~/.ssh/tzzr
## Servicios Principales
### 1. GRACE
- **Función**: Servicio de procesamiento de IA generativa
- **Tecnología**: Python + PyTorch/TensorFlow
- **Ubicación**: /opt/grace/
- **Puerto**: 8001 (interno)
**Capacidades**:
- Procesamiento de modelos de lenguaje
- Inferencia de IA
- Procesamiento batch
### 2. PENNY
- **Función**: Servicio de análisis y correlación de datos
- **Tecnología**: Python + NumPy/Pandas
- **Ubicación**: /opt/penny/
- **Puerto**: 8002 (interno)
**Capacidades**:
- Análisis de patrones
- Correlación de datos
- Reportes estadísticos
### 3. FACTORY
- **Función**: Servicio de síntesis y generación de datos
- **Tecnología**: Python + generación de datos
- **Ubicación**: /opt/factory/
- **Puerto**: 8003 (interno)
**Capacidades**:
- Generación de datos sintéticos
- Transformación de datos
- Enriquecimiento de datasets
## Hardware
- **GPU**: NVIDIA (modelo a verificar)
- **CPU**: Multi-core
- **RAM**: Suficiente para procesamiento GPU
- **Almacenamiento**: SSD para caché local
## Directorios Importantes
```
/opt/
├── grace/ # Servicio GRACE
├── penny/ # Servicio PENNY
├── factory/ # Servicio FACTORY
└── shared/ # Datos compartidos
/home/
├── logs/ # Logs de servicios
└── data/ # Datos de trabajo
```
## Monitoreo
```bash
# Ver estado de servicios
systemctl status grace
systemctl status penny
systemctl status factory
# Ver uso de GPU
nvidia-smi
# Logs de servicios
tail -f /home/logs/grace.log
tail -f /home/logs/penny.log
tail -f /home/logs/factory.log
```
## Conexión a Base de Datos Central
Los servicios se conectan a PostgreSQL en ARCHITECT:
- **Host**: 69.62.126.110
- **Base de datos**: tzzr_db
- **Puerto**: 5432
## Almacenamiento
- **Local**: /home/data/ para cache y trabajo temporal
- **R2**: Transferencia de resultados a `s3://architect/gpu-services/`
## Actualización de Servicios
```bash
# Detener servicio
systemctl stop grace
# Actualizar código
cd /opt/grace && git pull
# Reiniciar
systemctl start grace
# Verificar logs
tail -f /home/logs/grace.log
```
## Últimas Actualizaciones
- 2025-12-30: Documentación inicial

139
servers/HST.md Normal file
View File

@@ -0,0 +1,139 @@
# Servidor HST (72.62.2.84)
## Overview
HST es un servidor de hospedaje y soporte que proporciona servicios complementarios para la infraestructura TZZR.
**IP**: 72.62.2.84
**Usuario**: root
**Acceso SSH**: ssh root@72.62.2.84 -i ~/.ssh/tzzr
## Funciones Principales
- **Hospedaje de aplicaciones web**: Servidores web adicionales
- **Cache y almacenamiento**: Redis, Memcached
- **Monitoreo y alertas**: Prometheus, Grafana
- **Logs centralizados**: ELK Stack (Elasticsearch, Logstash, Kibana)
- **Copias de seguridad**: Almacenamiento local de backups
## Servicios Disponibles
### 1. Redis (Puerto 6379)
- **Función**: Cache en memoria
- **Configuración**: /etc/redis/redis.conf
- **Datos**: Sesiones, cachés de aplicación
- **Persistencia**: RDB y AOF
### 2. Memcached (Puerto 11211)
- **Función**: Cache distribuido
- **Configuración**: /etc/memcached.conf
- **Casos de uso**: Cachés de sesión, objetos
### 3. Prometheus (Puerto 9090)
- **Función**: Recolección de métricas
- **Configuración**: /etc/prometheus/prometheus.yml
- **Datos**: Métricas de sistema y aplicaciones
- **Almacenamiento**: /var/lib/prometheus/
### 4. Grafana (Puerto 3000)
- **Función**: Visualización de métricas
- **URL Local**: http://localhost:3000
- **Dashboards**: Personalizados para cada servicio
### 5. ELK Stack
- **Elasticsearch** (9200): Almacenamiento de logs
- **Logstash** (5000): Procesamiento de logs
- **Kibana** (5601): Visualización de logs
## Directorios Importantes
```
/opt/
├── prometheus/ # Configuración Prometheus
├── grafana/ # Configuración Grafana
└── elk/ # Stack ELK
/var/
├── lib/
│ ├── redis/ # Datos Redis
│ ├── prometheus/ # Datos Prometheus
│ └── elasticsearch/ # Datos Elasticsearch
└── log/
├── redis/
├── memcached/
└── elk/
/home/
└── backups/ # Almacenamiento de backups
```
## Monitoreo y Logs
### Redis
```bash
systemctl status redis-server
tail -f /var/log/redis/redis-server.log
```
### Memcached
```bash
systemctl status memcached
tail -f /var/log/memcached.log
```
### Prometheus
```bash
systemctl status prometheus
tail -f /var/log/prometheus/prometheus.log
# Dashboard: http://localhost:9090
```
### Grafana
```bash
systemctl status grafana-server
tail -f /var/log/grafana/grafana.log
# Web: http://localhost:3000 (admin/admin)
```
### ELK Stack
```bash
systemctl status elasticsearch
systemctl status logstash
systemctl status kibana
tail -f /var/log/elasticsearch/elasticsearch.log
# Kibana: http://localhost:5601
```
## Almacenamiento de Backups
```bash
# Directorio de backups
ls -la /home/backups/
# Sincronizar con R2
aws s3 sync /home/backups/ s3://architect/backups/ \
--endpoint-url https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com
```
## Configuración de Clientes
### Redis
```bash
# Conexión local
redis-cli
127.0.0.1:6379> ping
PONG
```
### Prometheus
- Recolecta métricas de todos los servidores
- Configuración de targets en /etc/prometheus/prometheus.yml
### Grafana
- Paneles de control personalizados
- Alertas basadas en métricas
- Integración con Slack y otros servicios
## Últimas Actualizaciones
- 2025-12-30: Documentación inicial