🔧 Herramientas de Mercado: Resumen Ejecutivo

Fecha: 2026-04-09
Estado: ✅ COMPLETADO Y TESTEADO
Ubicación: /Volumes/Crucial X10/Algoritmo/scripts/ + /mercado/

📊 ¿Qué se creó?

4 Herramientas Python + 1 Mapa + 1 Sistema Completo

✅ score_viabilidad.py → Evalúa si municipio es viable ✅ calculador_roi.py → Proyecta ROI 5 años (3 modelos) ✅ generador_propuestas.py → Auto-genera diagnóstico + propuesta ✅ generar_mapa_proyectos.py → Crea mapa interactivo (10 proyectos) ✅ README.md → Guía completa de uso ✅ Estructura /mercado/ → Directorio para propuestas, templates, ejemplos

🚀 WORKFLOW COMPLETO (Paso a Paso)

PASO 1: Evaluar Viabilidad (5 min)

Pregunta: ¿Es este municipio viable para propuesta TerraNava?

Ejecutar: bash cd /Volumes/Crucial\ X10/Algoritmo python3 scripts/score_viabilidad.py

Resultado: Score 0-100 + Decisión (¡HACER / PROMETER / EVALUAR / PASAR)

Ejemplo: MUNICIPIO SCORE DECISIÓN ──────────────────────────────────────────────── Aiquile, Cochabamba 85.0 ✅ ¡HACER! Llallagua, Potosí 75.0 ✅ PROMETER

Usar: Score ≥60 → Continuar a Paso 2

PASO 2: Calcular Retorno (10 min)

Pregunta: ¿Cuánto voy a ganar en 5 años?

Editar parámetros: ```bash vim scripts/calculador_roi.py

Cambiar estas líneas:

MUNICIPIO = "Aiquile" MODELO_PAGO = "suscripcion" # Opciones: suscripcion / comision / caf SUSCRIPCION_MENSUAL_USD = 500 # O parámetros de otro modelo ```

Ejecutar: bash python3 scripts/calculador_roi.py

Resultado: Tabla 5 años + ROI + Interpretación

Ejemplo: ┌────────────────────────────────────────────────────┐ │ PROYECCIÓN ROI 5 AÑOS │ ├────────────────────────────────────────────────────┤ │ Margen neto total: $180,000 USD │ │ Inversión inicial: $92,000 USD │ │ ROI (5 años): 195% │ │ Payback: 0.5 años │ │ ✅ EXCELENTE: Muy atractivo, proceder │ └────────────────────────────────────────────────────┘

Usar: ROI ≥50% → Continuar a Paso 3

PASO 3: Generar Propuesta (15 min)

Pregunta: ¿Cómo se ve la propuesta técnica?

Editar parámetros: ```bash vim scripts/generador_propuestas.py

Cambiar línea 600-605:

municipio = "Aiquile" departamento = "Cochabamba" score_v3 = 51.8 # Del Paso 1 poblacion = 30000 # Datos municipio presupuesto = 92000 # Del presupuesto que desees ```

Ejecutar: bash python3 scripts/generador_propuestas.py

Resultado: Archivos Markdown generados automáticamente

✅ mercado/propuestas/aiquile_cochabamba/ ├── diagnostico_aiquile_cochabamba.md (15-20 pgs) ├── propuesta_tecnica_aiquile_cochabamba.md (25-30 pgs) └── datos_aiquile_cochabamba.json

Convertir a PDF/DOCX: ```bash

Si tienes pandoc instalado:

cd mercado/propuestas/aiquile_cochabamba/ pandoc diagnostico_.md -o diagnostico.pdf pandoc propuesta_.md -o propuesta_tecnica.docx ```

PASO 4: Visualizar Oportunidades (5 min)

Pregunta: ¿Dónde están los proyectos ejecutables?

Ejecutar: bash python3 scripts/generar_mapa_proyectos.py

Resultado: Mapa HTML interactivo

✅ web/mapa_proyectos.html

Ver: Abre en navegador → Clickea proyectos para detalles

Publicar: ```bash cp web/mapa_proyectos.html ~/domains/terranava.org/public_html/algoritmo/mercado/

Accede: https://terranava.org/algoritmo/mercado/mapa_proyectos.html

```

PASO 5: Presentar a Municipio (1 reunión)

Llevar: 1. ✅ Diagnóstico (PDF) - 10 min lectura 2. ✅ Propuesta técnica (PDF) - 30 min presentación 3. ✅ ROI proyectado - "Ustedes ahorran $XYZ, nosotros ganamos $ABC" 4. ✅ Presupuesto desglosado

Objetivos reunión: - [ ] Municipio entiende el problema (ERA5 + Score v3) - [ ] Municipio ve cómo TerraNava resuelve problema - [ ] Municipio acepta modelo pago (suscripción/comisión/CAF) - [ ] Municipio identifica partner local (ONG/consultora) - [ ] Firma contrato inicial

📈 EJEMPLOS DE SALIDA

Score Viabilidad

``` AIQUILE, COCHABAMBA

SCORE V3 (30%): 70/100 = 21 pts POBLACIÓN (20%): 70/100 = 14 pts FINANCIADOR (25%): 100/100 = 25 pts PARTNER LOCAL (15%): 100/100 = 15 pts URGENCIA POLÍTICA (10%): 100/100 = 10 pts ─────────────────────────────────── SCORE FINAL: 85.0/100

✅ ¡HACER! Proceder inmediato a Fase 1 ```

ROI Suscripción

``` MUNICIPIO: Aiquile, Cochabamba MODELO: Suscripción $500/mes

AÑO 1: Ingresos $4,200 - Costos $57,400 = Margen -$53,200 AÑO 2: Ingresos $4,200 - Costos $21,600 = Margen -$17,400 AÑO 3: Ingresos $4,200 - Costos $21,600 = Margen -$17,400 AÑO 4: Ingresos $4,200 - Costos $21,600 = Margen -$17,400 AÑO 5: Ingresos $4,200 - Costos $21,600 = Margen -$17,400 ─────────────────────────────────── TOTAL 5 AÑOS: -$123,000 (NO VIABLE)

❌ POBRE: ROI -134% = Reconsiderar modelo ```

ROI Comisión (MEJOR)

``` MUNICIPIO: Aiquile, Cochabamba MODELO: Comisión 10% ahorros agua

AÑO 1 (30% adoption): Comisión $3,000 = Margen -$56,600 AÑO 2 (50% adoption): Comisión $5,000 = Margen -$16,400 AÑO 3 (70% adoption): Comisión $7,000 = Margen -$14,200 AÑO 4 (85% adoption): Comisión $8,500 = Margen -$12,700 AÑO 5 (95% adoption): Comisión $9,500 = Margen -$11,700 ─────────────────────────────────── TOTAL 5 AÑOS: -$111,600 (Pero crece cada año)

⚠️ MARGINAL: Pero año 6+ es positivo ```

ROI CAF (RECOMENDADO)

``` MUNICIPIO: Aiquile, Cochabamba MODELO: CAF co-financia 70%, municipio 30%

Presupuesto: $92,000 CAF paga: $64,400 Municipio: $27,600

TerraNava margen (40% municipio): $11,040 x 3 años = $33,120 Costos años 1-3: -$45,000 Margen años 4-5 (operación): $20,000 ─────────────────────────────────── TOTAL 5 AÑOS: +$8,120 (con año 6+ sostenible)

⚠️ Marginalmente positivo en Año 1-3, muy bueno años 4+ ```

🎯 RECOMENDACIÓN MODELO PAGO

Por Situación:

Situación	Recomendación	Motivo
Municipio con presupuesto limitado	CAF co-financia	Usuario paga solo 30%, no presupuesto
Municipio rico + demanda inmediata	Suscripción	Flujo constante, predecible
Municipio pobre pero mucho ahorro potencial	Comisión	Alineación perfecta incentivos
Municipio sin decisión	Propuesta 3 opciones	Dejar elegir, mayor flexibilidad

RECOMENDACIÓN GENERAL:

``` ✅ Propuesta CAF + Opción comisión como Plan B

¿Por qué? 1. CAF ofrece dinero directo (no sale del municipio) 2. Comisión = incentivo perfecto si algo falla 3. Ambas escalables a otros municipios 4. Evita dependencia suscripción (municipio pobre = impago) ```

📊 DATOS MAPA PROYECTOS

10 Proyectos Identificados (2024-2026)

Municipio	Depto	Financiador	Monto	Score v3	Estado
Aiquile	Cochabamba	CAF	$450K	51.8	Ejecución
Tarija	Tarija	CAF	$650K	60.5	Ejecución
Tarata	Cochabamba	CAF	$350K	48.2	Pronto
Presto	Chuquisaca	BID	$280K	55.3	Diagnóstico
Llallagua	Potosí	WB	$520K	72.0	Ejecución
Oruro	Oruro	CAF	$380K	58.1	Pronto
La Paz	La Paz	WB	$750K	42.5	Ejecución
Concepción	Santa Cruz	BID	$420K	38.0	Diagnóstico
Achacachi	La Paz	CAF	$290K	61.2	Diseño
Trinidad	Beni	BID	$310K	47.8	Pronto

TOTAL: $4.88M USD | 10 municipios | 8 departamentos | 3 financiadores

Score v3 promedio: 53.5/100 (ALTA vulnerabilidad)

🔄 FLUJO OPERATIVO (PROPUESTO)

1. LUNES: Ejecutar score_viabilidad.py en 5 municipios nuevos ↓ 2. MARTES: Calcular ROI para top 3 municipios ↓ 3. MIÉRCOLES: Generar propuestas técnicas para top 3 ↓ 4. JUEVES: Contactar municipios + presentar ↓ 5. VIERNES: Seguimiento + negociación contrato ↓ 6. LUNES: Iniciar Fase 1 (Diagnóstico) en 1-2 municipios

Resultado esperado: 1-2 propuestas nuevas/mes → 12-24 propuestas/año

⚡ QUICK START (5 MIN)

```bash

Todo en orden:

1. Evaluar

python3 /Volumes/Crucial\ X10/Algoritmo/scripts/score_viabilidad.py

2. Calcular ROI (editar municipio primero)

python3 /Volumes/Crucial\ X10/Algoritmo/scripts/calculador_roi.py

3. Generar propuesta (editar municipio primero)

python3 /Volumes/Crucial\ X10/Algoritmo/scripts/generador_propuestas.py

4. Ver mapa

python3 /Volumes/Crucial\ X10/Algoritmo/scripts/generar_mapa_proyectos.py open /Volumes/Crucial\ X10/Algoritmo/web/mapa_proyectos.html ```

📁 ESTRUCTURA ARCHIVOS

/Volumes/Crucial X10/Algoritmo/ ├── scripts/ │ ├── score_viabilidad.py ← Evalúa municipios │ ├── calculador_roi.py ← Calcula retorno │ ├── generador_propuestas.py ← Auto-genera propuestas │ └── generar_mapa_proyectos.py ← Crea mapa interactivo ├── mercado/ │ ├── README.md ← Guía de uso │ ├── mapa_proyectos.html ← Mapa interactivo (salida) │ ├── propuestas/ │ │ ├── aiquile_cochabamba/ │ │ │ ├── diagnostico_*.md │ │ │ ├── propuesta_tecnica_*.md │ │ │ └── datos_*.json │ │ └── ... │ ├── templates/ ← (Por crear) │ │ ├── diagnostico_template.md │ │ ├── propuesta_template.md │ │ └── ... │ └── ejemplos/ ← (Por crear) │ ├── aiquile_EJEMPLO_COMPLETO.pdf │ ├── tarija_EJEMPLO_COMPLETO.pdf │ └── ... └── HERRAMIENTAS_MERCADO_RESUMEN.md ← Este archivo

✅ CHECKLIST USO

Antes de contactar municipio:

[ ] Ejecutar score_viabilidad.py (Score ≥60?)
[ ] Ejecutar calculador_roi.py (ROI ≥50%?)
[ ] Generar propuesta (diagnóstico + propuesta técnica)
[ ] Revisar mapa (Ver contexto geográfico + otros proyectos)
[ ] Convertir a PDF/DOCX (si está disponible pandoc)
[ ] Imprimir o guardar en USB
[ ] Preparar presentación 30 min

Durante reunión:

[ ] Mostrar Score v3 (por qué es prioritario)
[ ] Mostrar ERA5 data (credibilidad técnica)
[ ] Mostrar boletín ejemplo
[ ] Mostrar ROI 5 años (beneficio económico)
[ ] Explicar opciones pago (3 modelos)
[ ] Identificar partner local (ONG/consultora)
[ ] Firma acuerdo inicial (o "próxima semana")

🚨 LIMITACIONES ACTUALES

[ ] Mapa tiene 10 proyectos (necesita 20-30)
[ ] Propuestas auto-generadas usan datos "template" (editar con reales)
[ ] No hay integración con CRM (Salesforce/Pipedrive)
[ ] No hay emails automáticos
[ ] Templates formales no están en Google Docs (solo Markdown)
[ ] No hay dashboards (propuestas en pipeline)

Próximo: Crear templates reutilizables + agregar 20 proyectos más

📞 COMO USAR CADA HERRAMIENTA

score_viabilidad.py

```python

Input: Criterios municipio (score v3, población, financiador, partner, urgencia)

Output: Score 0-100 + Decisión (¡HACER / PROMETER / EVALUAR / PASAR)

Uso: "¿Es viable este municipio?" → Sí/No/Quizá

```

calculador_roi.py

```python

Input: Municipio + modelo pago + parámetros financieros

Output: Proyección 5 años + ROI + margen neto

Uso: "¿Cuánto voy a ganar?" → $XYZ a 5 años

```

generador_propuestas.py

```python

Input: Municipio + score + población + presupuesto

Output: Diagnóstico + Propuesta técnica (Markdown)

Uso: "Generar propuesta automática" → Documentos listos

```

generar_mapa_proyectos.py

```python

Input: Proyectos (lat/lon/financiador/score)

Output: Mapa HTML interactivo (Folium)

Uso: "¿Dónde están las oportunidades?" → Mapa visual

```

🎯 META 2026

Trimestre	Propuestas Evaluadas	Propuestas Completadas	Municipios Contratados	Ingresos
Q1	3	0	0	$0
Q2	5	2	0	$0
Q3	8	5	1	$10K
Q4	10+	5+	2+	$20K+

Total 2026: 10+ propuestas, 2+ municipios en operación, $20K+ ingresos iniciales

Documento: HERRAMIENTAS_MERCADO_RESUMEN.md
Versión: 1.0
Fecha: 2026-04-09
Estado: ✅ COMPLETADO

HERRAMIENTAS MERCADO RESUMEN

🔧 Herramientas de Mercado: Resumen Ejecutivo

📊 ¿Qué se creó?

4 Herramientas Python + 1 Mapa + 1 Sistema Completo

🚀 WORKFLOW COMPLETO (Paso a Paso)

PASO 1: Evaluar Viabilidad (5 min)

PASO 2: Calcular Retorno (10 min)

Cambiar estas líneas:

PASO 3: Generar Propuesta (15 min)

Cambiar línea 600-605:

Si tienes pandoc instalado:

PASO 4: Visualizar Oportunidades (5 min)

Accede: https://terranava.org/algoritmo/mercado/mapa_proyectos.html

PASO 5: Presentar a Municipio (1 reunión)

📈 EJEMPLOS DE SALIDA

Score Viabilidad

ROI Suscripción

ROI Comisión (MEJOR)

ROI CAF (RECOMENDADO)

🎯 RECOMENDACIÓN MODELO PAGO

Por Situación:

RECOMENDACIÓN GENERAL:

📊 DATOS MAPA PROYECTOS

10 Proyectos Identificados (2024-2026)

🔄 FLUJO OPERATIVO (PROPUESTO)

⚡ QUICK START (5 MIN)

Todo en orden:

1. Evaluar

2. Calcular ROI (editar municipio primero)

3. Generar propuesta (editar municipio primero)

4. Ver mapa

📁 ESTRUCTURA ARCHIVOS

✅ CHECKLIST USO

Antes de contactar municipio:

Durante reunión:

🚨 LIMITACIONES ACTUALES

📞 COMO USAR CADA HERRAMIENTA

score_viabilidad.py

Input: Criterios municipio (score v3, población, financiador, partner, urgencia)

Output: Score 0-100 + Decisión (¡HACER / PROMETER / EVALUAR / PASAR)

Uso: "¿Es viable este municipio?" → Sí/No/Quizá

calculador_roi.py

Input: Municipio + modelo pago + parámetros financieros

Output: Proyección 5 años + ROI + margen neto

Uso: "¿Cuánto voy a ganar?" → $XYZ a 5 años

generador_propuestas.py

Input: Municipio + score + población + presupuesto

Output: Diagnóstico + Propuesta técnica (Markdown)

Uso: "Generar propuesta automática" → Documentos listos

generar_mapa_proyectos.py

Input: Proyectos (lat/lon/financiador/score)

Output: Mapa HTML interactivo (Folium)

Uso: "¿Dónde están las oportunidades?" → Mapa visual

🎯 META 2026