system-docs/v4-archive/corp/README.md

CORP

Servidor Empresarial - Ecosistema TZZR

Servidor

• IP: 92.112.181.188
• Dominio: tzzrcorp.me
• SSH: Autenticación por key (no password)
• Acceso: ssh -i ~/.ssh/id_ed25519_server root@92.112.181.188

Servicios Activos (Actualizado 2025-12-23)

Servicio	URL	Puerto	Estado
Directus	https://directus.tzzrcorp.me	8055	OK
Nextcloud	https://nextcloud.tzzrcorp.me	8080	OK
Vaultwarden	https://vault.tzzrcorp.me	8081	OK
Shlink	https://shlink.tzzrcorp.me	8082	OK
Addy	https://addy.tzzrcorp.me	8083	OK
Odoo	https://erp.tzzrcorp.me	8069	OK
ntfy	https://ntfy.tzzrcorp.me	8880	OK
HSU API	https://hsu.tzzrcorp.me	5002	OK
Redis	(interno)	6379	OK
PostgreSQL	(interno)	5432	OK
Caddy	(proxy)	80/443	OK

Directus (Admin)

URL: https://directus.tzzrcorp.me
Admin: admin@tzzr.me
Pass: directus_corp_2024

Nextcloud

URL: https://nextcloud.tzzrcorp.me
Admin: admin
Pass: nextcloud_corp_2024

HSU API (Biblioteca Usuario)

URL: https://hsu.tzzrcorp.me/api/biblioteca
PIN: 123456

PostgreSQL

Host: localhost
Port: 5432
User: corp
Password: corp

Bases de datos

DB	Uso
corp	Principal, Directus
nextcloud	Nextcloud
shlink	Shlink
odoo	Odoo ERP

Tablas de Negocio

Tabla	Descripción
hst_mirror	Mirror de tags HST
hsu	Tags de usuario
flu	Tags de flujo
pju	Tags de proyecto
spu	Tags de sistema
vsu	Tags de vista
vuu	Tags de usuario vista

Migraciones Completadas

NocoDB → Directus (2025-12-23)

• NocoDB reemplazado por Directus
• Nextcloud instalado
• HSU API implementada
• Caddy como reverse proxy con SSL

DNS (tzzrcorp.me)

@           A   92.112.181.188
directus    A   92.112.181.188
nextcloud   A   92.112.181.188
vault       A   92.112.181.188
shlink      A   92.112.181.188
addy        A   92.112.181.188
erp         A   92.112.181.188
ntfy        A   92.112.181.188
hsu         A   92.112.181.188
db          A   92.112.181.188

Descripción

CORP es el servidor empresarial que gestiona la información de negocios. Cada empresa tiene sus propios datos aislados: clientes, productos, pedidos, facturas, y métricas.

Arquitectura

┌─────────────────────────────────────────────────────────────────┐
│                           CORP                                  │
│                   (Servidor Empresarial)                       │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   ┌─────────────┐  ┌─────────────┐  ┌─────────────┐            │
│   │    MIND     │  │   WINDMILL  │  │   ODOO      │            │
│   │    LINK     │  │  (Workflows)│  │   (ERP)     │            │
│   └──────┬──────┘  └──────┬──────┘  └──────┬──────┘            │
│          │                │                │                    │
│          └────────────────┼────────────────┘                    │
│                           │                                      │
│                    ┌──────┴──────┐                              │
│                    │   CLARA     │  ← Director Completo         │
│                    │ +MASON      │                              │
│                    │ +NOTARIO    │                              │
│                    │ +SENTINEL   │                              │
│                    └──────┬──────┘                              │
│                           │                                      │
│   ┌───────────────────────┼───────────────────────┐            │
│   │           PostgreSQL + Directus                  │            │
│   │  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │            │
│   │  │Clientes│ │Productos│ │Pedidos │ │Facturas│ │            │
│   │  └────────┘ └────────┘ └────────┘ └────────┘ │            │
│   └───────────────────────────────────────────────┘            │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Simulación: TZZR Tailoring

CORP simula una startup de sastrería a medida:

Modelo de Negocio

• Producto: Trajes MTM (Made-to-Measure) importados de China
• Precio: €299-499 (mercado: €800-1500)
• Margen: ~300%
• Canal: Online + cita previa

Datos Iniciales

Capital inicial: €5,000
Burn mensual: €600
Runway: 8.3 meses

Productos:
- Traje Negro Clásico: €299 (coste: €85)
- Traje Azul Marino: €349 (coste: €95)
- Traje Gris Medio: €329 (coste: €90)
- Traje Gris Oscuro: €379 (coste: €100)

Tablas Principales

corp_config          -- Configuración de empresa
corp_productos       -- Catálogo de productos
corp_clientes        -- Clientes con historial
corp_medidas         -- Medidas de clientes
corp_pedidos         -- Pedidos con estado
corp_pedido_lineas   -- Líneas de pedido
corp_facturas        -- Facturas certificadas
corp_transacciones   -- Ingresos y gastos
corp_metricas        -- Métricas diarias
corp_tareas          -- Workflow de tareas
corp_ia_solicitudes  -- Peticiones a FACTORY

Flujos de Negocio

Nuevo Pedido

1. Cliente solicita → crear cliente si nuevo
2. Tomar medidas → guardar en corp_medidas
3. Crear pedido → generar número ORD-YYYY-XXXX
4. Confirmar pago → registrar transacción
5. Enviar a fábrica → actualizar estado
6. Recibir producto → crear BCK (foto)
7. Entregar → generar factura

Generar Factura

1. Pedido completado
       │
       ▼
2. CLARA.handleDocumentGeneration()
       │
       ▼
3. MASON prepara datos (cliente, productos, totales)
       │
       ▼
4. FACTORY genera PDF iterativamente
       │
       ▼
5. NOTARIO certifica (hash + timestamp)
       │
       ▼
6. LOCKER almacena (locker://corp/facturas/FAC-2025-0001.pdf)
       │
       ▼
7. Enviar por email

Windmill Workflows

Workflow	Trigger	Acción
New Order	Webhook	Crea pedido → envía confirmación
Generate Invoice	Webhook	FACTORY genera → NOTARIO certifica
Daily Metrics	Cron	Calcula métricas del día
Low Stock Alert	Cron	Notifica productos bajo stock

Vistas Útiles

-- Dashboard financiero
v_corp_dashboard_financiero
  → capital_inicial, ingresos, gastos, caja_actual, runway_meses

-- Pedidos con detalle
v_corp_pedidos_detalle
  → numero, cliente, estado, total, num_lineas

-- Facturas pendientes
v_corp_facturas_pendientes
  → numero, cliente, total, dias_vencido

-- Stock bajo
v_corp_stock_bajo
  → sku, nombre, stock, stock_minimo

Template Clonable

CORP puede clonarse para un nuevo negocio:

# Usar template
psql -U tzzr -d nueva_empresa -f templates/corp-template.sql

# Reemplazar variables
sed -i 's/{{COMPANY_NAME}}/Mi Empresa/g' ...
sed -i 's/{{INITIAL_CAPITAL}}/10000/g' ...

Estructura

corp/
├── database/
│   ├── corp-schema.sql
│   └── corp-template.sql
├── docker/
│   └── docker-compose.yml
├── windmill/
│   ├── new-order.yaml
│   └── generate-invoice.yaml
├── docs/
└── README.md

Repositorios Relacionados

Repo	Rol
clara	Orquestador de CORP
deck	Equivalente personal
the-factory	Genera documentos
notario	Certifica facturas
locker	Almacena documentos
contable	Libros contables

Roadmap

• Schema PostgreSQL
• Template clonable
• CLARA orquestador
• Windmill workflows
• Integración Odoo
• Multi-empresa
• Reportes automáticos
• Facturación electrónica