# CLAUDE.md - Flying Pumas / Creativa Coffee District

> Centro de Control y Automatizaciones para finca de cafe Geisha en Panama
> Version 4.0 | 6 Abril 2026
> Ruta: `~/Desktop/EL GREEN HUB/FLYING PUMAS/AI STRATEGY/`

---

## AL INICIAR SESION - LEE ESTO PRIMERO

### Estado Actual del Proyecto (6 Abril 2026)

| Aspecto | Estado |
|---------|--------|
| **Fase actual** | Ecosistema Completo Identificado |
| **Fichas Tecnicas** | 7 generadas (incluye FPNLG25018) |
| **Sistemas CRM** | 3 identificados (Notion, HubSpot, Excel) |
| **Presupuesto 2026** | Documentado ($843K objetivo) |
| **N8N Cloud** | coffeegeek.app.n8n.cloud (operativo) |
| **Google Sheets** | Documentado + Nuevo sheet identificado |
| **Workflows** | 0 activos (preparados para integracion) |
| **Sesiones** | 4 |

---

## SOBRE EL PROYECTO

### Datos de la Empresa ACTUALIZADOS (6 Abril 2026)

| Campo | Valor |
|-------|-------|
| **Nombre Finca** | Flying Pumas |
| **Marcas Comerciales** | Flying Pumas (Premium) + Creativa Coffee District (Volumen) |
| **Pais** | Panama |
| **Especialidad** | Geisha y variedades orientales |
| **Tipo** | Cafe de especialidad - Dos marcas complementarias |
| **Propietario** | Felipe Sardi |
| **Objetivo 2026** | $843,000 / $34.50 precio promedio ponderado |

### ANÁLISIS REAL CONSOLIDADO (Datos Corregidos)

| Métrica | Flying Pumas | Creativa CCD | Total/Global |
|---------|--------------|--------------|--------------|
| **Ventas Históricas** | $527,885 (33.4%) | $1,051,185 (66.6%) | $1,579,070 |
| **Precio Promedio** | $67.58/lb | $7.99/lb | $11.33/lb |
| **Gap vs Meta $34.50** | +95.9% | -76.8% | -67.2% |
| **Órdenes** | 133 | 194 | 327 |
| **Clientes Únicos** | 51 FP | 67 CCD | 118 consolidados |

### MIX ÓPTIMO IDENTIFICADO

**Para alcanzar $34.50/lb promedio ponderado:**
- **Flying Pumas**: 44.5% del volumen (actualmente 33.4%)
- **Creativa CCD**: 55.5% del volumen (actualmente 66.6%)

**ESTRATEGIA DUAL:**
1. **Flying Pumas**: Marca premium, reducir precios promedio de $67.58 a ~$50/lb
2. **Creativa CCD**: Marca volumen, aumentar precios de $7.99 a ~$12-15/lb

### Vision del Ecosistema Completo

Ecosistema integrado de produccion, comercializacion y automatizacion que conecta:
1. **Produccion e Inventario** - Trazabilidad desde nanolote hasta cliente
2. **Planificacion Comercial** - Presupuesto y estrategia CRM 2026
3. **Gestion de Clientes** - Multiple CRMs sincronizados
4. **Automatizaciones** - Workflows N8N entre todos los sistemas
5. **Trazabilidad Premium** - Fichas tecnicas estilo Libertario v2.0

---

## ECOSISTEMA FLYING PUMAS - ARQUITECTURA COMPLETA

```
ECOSISTEMA FLYING PUMAS 2026
|
|-- 1. PRODUCCION & INVENTARIO -------------------- ✅ OPERATIVO
|   |-- Google Sheets Principal (11 pestanas)
|   |   |-- ID: 1tvxw3UGRMJyLkxPZQX4JKZSvaNjPRFtXqrO5eQd5BlA
|   |   |-- CCF, MX, Evaluaciones SCAA, Inventarios FP/CCD
|   |-- Google Sheets Nuevo (identificado)
|   |   |-- ID: 1xgiiQPcdv9sPcBdEhnxpE2FXRn5Bvl8c
|   |   |-- Posible actualizacion/datos 2026
|   |-- Nanolotes: FPNLG25XXX, CDNLG25XXX
|   |-- Scores SCA: 88-100 puntos
|   |-- Variedades: Geisha (principal), SL28, Pacas, etc.
|
|-- 2. PLANIFICACION COMERCIAL -------------------- 📋 DOCUMENTADO
|   |-- Presupuesto 2026 (Excel)
|   |   |-- Objetivo: $843,000
|   |   |-- Volumen: 450 cajas
|   |   |-- Precio promedio: $34/libra
|   |   |-- Flying Pumas: 160 cajas
|   |   |-- Creativa: 290 cajas
|   |-- CRM Plan 2026 (Excel)
|       |-- Base actual: 49 clientes
|       |-- Estrategia expansion
|       |-- Tiers por potencial compra
|
|-- 3. GESTION DE CLIENTES ----------------------- 🔄 MULTI-CRM
|   |-- CRM Notion (Hub Central)
|   |   |-- URL: striped-heliotrope-621.notion.site
|   |   |-- Cuentas (de Salida de Trillas)
|   |   |-- Contactos
|   |   |-- Interacciones/Actividades
|   |   |-- Pipeline de Ventas
|   |   |-- Calendario de Visitas
|   |   |-- Agenda China
|   |-- HubSpot CRM
|   |   |-- 123 empresas globales
|   |   |-- Contactos: XLSX
|   |   |-- Empresas: CSV
|   |   |-- Prospectos internacionales
|   |-- Salida de Trillas (Excel)
|       |-- Historial 2022-presente
|       |-- Base: Tronco Gris
|       |-- Pestana dinamica: analisis decisiones
|
|-- 4. TRAZABILIDAD PREMIUM ---------------------- ✅ ACTIVO
|   |-- Fichas Tecnicas Libertario v2.0
|   |-- 7 fichas generadas
|   |-- Integracion con Google Sheets
|   |-- Exportacion HTML profesional
|
|-- 5. AUTOMATIZACIONES -------------------------- ⚙️ PREPARADO
    |-- N8N Cloud (coffeegeek.app.n8n.cloud)
    |-- MCP configurado
    |-- Templates disponibles: 2,709
    |-- Preparado para integracion total
```

---

## INTEGRACIONES Y SISTEMAS

### Google Sheets - Sistema Principal

#### Sheet 1: Inventario Principal (OPERATIVO)
| Campo | Valor |
|-------|-------|
| **Sheet ID** | `1tvxw3UGRMJyLkxPZQX4JKZSvaNjPRFtXqrO5eQd5BlA` |
| **Pestanas** | 11 documentadas |
| **Documentacion** | `docs/GOOGLE_SHEETS_ESTRUCTURA.md` |
| **Estado** | Operativo y documentado |

**URLs de exportacion CSV principales:**
```bash
# CCF (Entrada lotes)
https://docs.google.com/spreadsheets/d/1tvxw3UGRMJyLkxPZQX4JKZSvaNjPRFtXqrO5eQd5BlA/export?format=csv&gid=0

# MX (Composicion lotes)
https://docs.google.com/spreadsheets/d/1tvxw3UGRMJyLkxPZQX4JKZSvaNjPRFtXqrO5eQd5BlA/export?format=csv&gid=1460966979

# Evaluaciones SCAA
https://docs.google.com/spreadsheets/d/1tvxw3UGRMJyLkxPZQX4JKZSvaNjPRFtXqrO5eQd5BlA/export?format=csv&gid=535231030
```

#### Sheet 2: Nuevo Sistema (IDENTIFICADO)
| Campo | Valor |
|-------|-------|
| **Sheet ID** | `1xgiiQPcdv9sPcBdEhnxpE2FXRn5Bvl8c` |
| **Estado** | Pendiente acceso y analisis |
| **Potencial** | Datos 2026, nanolotes FPNLG26XXX |

### CRM Ecosistema (Triple Integracion)

#### 1. CRM Notion - Hub Central Metodologico
| Campo | Valor |
|-------|-------|
| **URL** | https://striped-heliotrope-621.notion.site/CRM-Flying-Pumas-CCD-Hub-Central-31643237e4b881f08211fe81b3f76849 |
| **Funcion** | Metodologia y gestion relaciones |
| **Origen datos** | Migrado de "Salida de Trillas" Excel |

**Bases de datos:**
- **Cuentas** - Empresas categorized
- **Contactos** - Personas clave por empresa
- **Interacciones** - Conversaciones registradas
- **Pipeline Ventas** - Ventas 2025 + proyecciones 2026
- **Calendario Visitas** - Oportunidades + feedback
- **Agenda China** - Actividades captacion especifica

#### 2. HubSpot CRM - Prospeccion Global
| Campo | Valor |
|-------|-------|
| **Empresas** | 123 registradas |
| **Cobertura** | Global (Europa, Asia, Americas, Medio Oriente) |
| **Archivos** | hubspot-crm-exports-todos-contactos/empresas-2026-04-06 |

**Clientes destacados identificados:**
| Empresa | Pais | Ingresos | Empleados | Estado |
|---------|------|----------|-----------|---------|
| Terres De Cafe | Francia | $1M-$10M | 11-50 | Cliente |
| SUMO Coffee | Irlanda | $10M-$50M | 51-250 | Lead |
| Definitive Coffee | Japon | - | - | Cliente ($15,736) |
| The QC Academy | UAE | - | - | Cliente ($1,653) |

#### 3. Salida de Trillas - Base Historica
| Campo | Valor |
|-------|-------|
| **Periodo** | 2022-presente |
| **Productor base** | Tronco Gris |
| **Pestana clave** | Dinamica Panama |
| **Funcion** | Analisis tendencias, clientes estrella |

### Presupuesto y Planificacion 2026

#### Presupuesto 2026 (Excel)
| Categoria | Objetivo |
|-----------|----------|
| **Ventas totales** | $843,000 |
| **Volumen total** | 450 cajas |
| **Precio promedio** | $34/libra |
| **Flying Pumas** | 160 cajas |
| **Creativa** | 290 cajas |

**Pestanas del presupuesto:**
- **Variables** - Total produccion y libras venta
- **Distribucion** - Categorias, precios, descuentos por tier
- **Historial 2025** - Referencia crecimiento
- **Comparativo 2025 vs 2026** - Incrementos objetivos
- **Escenarios** - Distribucion detallada por cliente

#### CRM Plan 2026 (Excel)
| Aspecto | Detalle |
|---------|---------|
| **Base actual** | 49 clientes |
| **Estrategia** | Expansion mediante tiers |
| **Metodologia** | Volumen + descuentos → aumentar capacidad |

**Segmentacion clientes:**
- **Repeticion 2025** - Ventas garantizadas
- **Recuperacion** - Reactivacion con ofertas
- **Nuevos** - Captacion para cumplir meta

### N8N Cloud - Automatizaciones

| Campo | Valor |
|-------|-------|
| **URL** | https://coffeegeek.app.n8n.cloud |
| **Proyecto ID** | 3DnzIaj94ZRngQFf |
| **Estado** | ✅ Operativo (HTTP 200, 0.217s) |
| **MCP** | Configurado (.mcp.json) |
| **Templates** | 2,709 disponibles |

**Herramientas disponibles:**
| Herramienta | Uso |
|-------------|-----|
| `n8n_health_check` | Verificar conexion |
| `n8n_list_workflows` | Ver workflows |
| `n8n_create_workflow` | Crear nuevos |
| `search_templates` | Buscar en 2,709 templates |
| `validate_workflow` | Validar antes deploy |

---

## SISTEMA DE FICHAS TECNICAS

### Fichas Generadas (7 total)

| Nanolote/Lote | Variedad | Proceso | Score SCA | Peso KG | Estilo | Archivo |
|---------------|----------|---------|-----------|---------|--------|---------|
| **FPNLG25018** | Geisha | Natural | 89.08 | 91.5 | **Libertario v2.0** | FPNLG25018_FichaTecnica.html |
| Lote 02 | Geisha | Natural Anaerobic | - | - | Clasico | Lote02_FichaTecnica.html |
| Lote 04 | Geisha | Natural Anaerobic | 88.65 | 242.9 | Clasico | Lote04_FichaTecnica.html |
| Lote 08 | Geisha | Natural Anaerobic | 89.17 | 113.4 | **Libertario v2.0** | Lote08_FichaTecnica.html |
| Lote 50 | Geisha | Natural Anaerobic | - | - | Clasico | Lote50_FichaTecnica.html |
| Lote 64 | Geisha | Washed+Honey | 97.37 | 472.1 | Clasico | Lote64_FichaTecnica.html |
| Lote 72 | Geisha | Natural Anaerobic | - | - | Clasico | Lote72_FichaTecnica.html |

### Nuevos Lotes Disponibles Identificados

**Top recomendaciones para nuevas fichas:**
| Lote | Variedad | Score SCA | KG | Perfil | Prioridad |
|------|----------|-----------|-----|--------|-----------|
| **Lote 16** | Geisha Washed | 89.21 | 160.4 | Dulce floral | 🥇 Alta |
| **Lote 07** | Geisha Natural | 89.09 | 96.6 | Tropical-lavanda | 🥈 Alta |
| **Lote 11** | Geisha Washed | 88.44 | 140.5 | Citrico | 🥉 Media |
| Lote 18 | Geisha Natural | 89.33 | 171.5 | - | Media |
| Lote 09 | Geisha Natural | 88.08 | 155.0 | Floral-aromatico | Media |

### Estilos de Ficha

#### Libertario v2.0 ⭐ RECOMENDADO
- **4 paginas** premium
- **CSS embebido**
- **Datos agregados** del lote (sin baches individuales)
- **Paleta Flying Pumas:** Verde bosque, coral, dorado

**Estructura:**
1. **Portada** - Badge "Terroir of Excellence", score prominente
2. **Terroir** - Ubicacion, altitud, composicion
3. **Proceso** - Flujo paso a paso
4. **Perfil Sensorial** - Rueda sabores, recomendaciones

#### Clasico v1.0
- **8 paginas** con detalles por bache
- **CSS externo**
- **Orientado datos tecnicos**

---

## ESTRUCTURA DE ARCHIVOS

### Ruta Completa del Proyecto
```
/Users/felipesardi/Desktop/EL GREEN HUB/FLYING PUMAS/AI STRATEGY/
```

### Estructura Actualizada
```
~/Desktop/EL GREEN HUB/FLYING PUMAS/AI STRATEGY/
|
|-- .claude/
|   |-- PROMPT_APERTURA.md    -> Protocolo inicio sesion
|   |-- PROMPT_CIERRE.md      -> Protocolo cierre
|   |-- PROGRESO.md           -> Estado actual proyecto
|   |-- SESSION_LOG.md        -> Historial sesiones
|
|-- .mcp.json                  -> Configuracion MCP N8N
|-- CLAUDE.md                  -> Este archivo (v4.0)
|
|-- fichas_tecnicas/           -> SISTEMA FICHAS TECNICAS
|   |-- CONFIG_MARCA.json     -> Config marca Flying Pumas
|   |-- GUIA_GENERACION_FICHAS.md -> Guia generacion
|   |-- assets/               -> Logos, fotos
|   |-- lotes_generados/      -> 7 fichas HTML generadas
|       |-- FPNLG25018_FichaTecnica.html ← NUEVO
|
|-- datos/                     -> Exports Sheets, CSVs, archivos HubSpot
|   |-- hubspot-crm-exports-todos-contactos-2026-04-06 (1).xlsx
|   |-- hubspot-crm-exports-todos-empresas-2026-04-06.csv
|
|-- docs/                      -> Documentacion
|   |-- GOOGLE_SHEETS_ESTRUCTURA.md -> Estructura 11 pestanas
|
|-- n8n/                       -> Workflows exportados (JSON)
|-- scripts/                   -> Scripts Python
|-- dashboard/                 -> Dashboards Streamlit (futuro)
```

---

## FLUJOS DE INTEGRACION RECOMENDADOS

### Flujo Principal de Datos
```
1. PRODUCCION (Google Sheets)
   └── Nanolotes, scores, inventario disponible

2. PLANIFICACION (Excel Presupuesto/CRM 2026)
   └── Objetivos, estrategia, segmentacion clientes

3. CRM ECOSISTEMA (Notion + HubSpot + Trillas)
   └── Gestion relaciones, pipeline, historial

4. AUTOMATIZACION (N8N)
   └── Sincronizacion automatica entre todos

5. TRAZABILIDAD (Fichas Tecnicas)
   └── Presentacion premium para clientes
```

### Workflows N8N Prioritarios

| Workflow | Trigger | Accion | Prioridad |
|----------|---------|---------|-----------|
| **Sync Sheets → Notion** | Nuevo nanolote | Crear registro CRM | 🔥 Alta |
| **HubSpot → Sheets** | Nuevo cliente | Actualizar inventario asignado | 🔥 Alta |
| **Ficha Auto-Gen** | Lote completado | Generar ficha tecnica | 🔥 Alta |
| **Progreso vs Objetivos** | Semanal | Reporte presupuesto 2026 | 🟡 Media |
| **China Pipeline** | Deal stage change | Actualizar agenda China | 🟡 Media |

---

## REGLAS Y PROTOCOLOS

### SIEMPRE AL INICIAR:
- Leer CLAUDE.md, PROGRESO.md y SESSION_LOG.md
- Verificar N8N con `n8n_health_check`
- Revisar todos los sistemas del ecosistema
- Usar `/cost` para monitorear gastos

### SIEMPRE AL TRABAJAR:
- **Google Sheets:** Usar URLs correctas y GIDs documentados
- **CRM:** Mantener sincronizacion entre los 3 sistemas
- **Fichas:** Preferir estilo Libertario v2.0
- **N8N:** Validar workflows antes de activar

### SIEMPRE AL CERRAR:
- Ejecutar protocolo de cierre
- Actualizar PROGRESO.md y SESSION_LOG.md
- Exportar workflows N8N a JSON
- Documentar cambios importantes

### NUNCA:
- Hardcodear credenciales
- Activar workflows sin validar
- Perder sincronia entre CRMs
- Ignorar errores de integracion

---

## ARCHIVOS CLAVE ACTUALIZADOS

| Necesitas... | Lee... |
|--------------|--------|
| **Estado proyecto** | `.claude/PROGRESO.md` |
| **Historial sesiones** | `.claude/SESSION_LOG.md` |
| **Este archivo** | `CLAUDE.md` (v4.0) |
| **Estructura Google Sheets** | `docs/GOOGLE_SHEETS_ESTRUCTURA.md` |
| **Config fichas** | `fichas_tecnicas/CONFIG_MARCA.json` |
| **Datos HubSpot** | `datos/hubspot-crm-exports-*` |
| **Protocolos** | `.claude/PROMPT_APERTURA.md` |

---

## PROXIMOS PASOS ESTRATEGICOS

### ALTA PRIORIDAD
- [ ] **Acceso MCP** a archivos CRM y presupuesto
- [ ] **Integracion automatizada** entre todos los CRMs
- [ ] **Workflows N8N** para sincronizacion
- [ ] **Dashboard unificado** del ecosistema
- [ ] **Aplicar Libertario v2.0** a fichas existentes

### MEDIA PRIORIDAD
- [ ] **Analisis sheet nuevo** (ID: 1xgiiQPcdv9sPcBdEhnxpE2FXRn5Bvl8c)
- [ ] **Fichas nuevos lotes** (16, 07, 11)
- [ ] **Reportes progreso** vs presupuesto 2026
- [ ] **Mobile CRM** para equipo ventas

### BAJA PRIORIDAD
- [ ] **Git configuracion** para control versiones
- [ ] **Slack integracion** para notificaciones
- [ ] **Dashboard Streamlit** avanzado

---

## COMANDOS UTILES

### Claude Code
```bash
/cost          # Verificar costos sesion
/compact       # Comprimir contexto
/mcp           # Gestionar MCP servers
```

### Iniciar en proyecto
```bash
cd ~/Desktop/"EL GREEN HUB"/"FLYING PUMAS"/"AI STRATEGY" && claude
```

### N8N Health Check
```bash
n8n_health_check
```

---

*Ultima actualizacion: 6 Abril 2026*
*Version 4.0 - Ecosistema Completo Identificado*
*Sistemas: Produccion + Planificacion + CRM Triple + Automatizacion + Trazabilidad*