{"id":50607552,"url":"https://github.com/frantastico-rgb/vendor2","last_synced_at":"2026-06-06T00:30:23.034Z","repository":{"id":324499385,"uuid":"1072673257","full_name":"frantastico-rgb/vendor2","owner":"frantastico-rgb","description":"AgTech Traceability Platform - Passion Fruit Supply Chain Management for Real Client (PasionVertice). 4-Stakeholder System.sistema de gestion de proyectos passio vertice","archived":false,"fork":false,"pushed_at":"2025-11-16T07:06:35.000Z","size":181,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-16T09:08:43.416Z","etag":null,"topics":["agriculture","agtech","blockchain-ready","mongodb","nodejs","passion-fruit","react","supply-chain","traceability"],"latest_commit_sha":null,"homepage":"https://frantastico-rgb.github.io/vendor2/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frantastico-rgb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-09T04:02:46.000Z","updated_at":"2025-11-16T07:06:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/frantastico-rgb/vendor2","commit_stats":null,"previous_names":["frantastico-rgb/vendor2"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/frantastico-rgb/vendor2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frantastico-rgb%2Fvendor2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frantastico-rgb%2Fvendor2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frantastico-rgb%2Fvendor2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frantastico-rgb%2Fvendor2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frantastico-rgb","download_url":"https://codeload.github.com/frantastico-rgb/vendor2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frantastico-rgb%2Fvendor2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33965591,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-05T02:00:06.157Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agriculture","agtech","blockchain-ready","mongodb","nodejs","passion-fruit","react","supply-chain","traceability"],"created_at":"2026-06-06T00:30:22.284Z","updated_at":"2026-06-06T00:30:23.017Z","avatar_url":"https://github.com/frantastico-rgb.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 PASSIO VÉRTICE - ROI CALCULATOR SYSTEM\r\n\r\n## 📋 Descripción General\r\nSistema completo de calculadora ROI interactiva para la presentación Passio Vértice, con capacidades de actualización automática de datos de mercado y fuentes documentadas para mantenimiento continuo.\r\n\r\n---\r\n\r\n## 📁 Estructura de Archivos\r\n\r\n```\r\n📂 vendor 2/\r\n├── 📄 presentacion.html          # Presentación principal con calculadora ROI\r\n├── 📄 index.html                 # Portal de acceso\r\n├── 📄 admin.html                 # Panel administrativo\r\n├── 📄 objetivos.html             # Objetivos del proyecto\r\n├── 📄 ROI_Sources_Documentation.md    # 📚 Documentación completa de fuentes\r\n├── 📄 ROI_Data_Template.csv      # 📊 Template datos históricos\r\n├── 📄 roi_updater.py             # 🔧 Script automatización (opcional)\r\n├── 📄 README.md                  # Este archivo\r\n└── 🖼️ log_passio_vertice.png    # Logo del proyecto\r\n```\r\n\r\n---\r\n\r\n## 🧮 Calculadora ROI - Características\r\n\r\n### ✨ **Funcionalidades Principales**\r\n- **Cálculo interactivo** de ROI para 3 productos (Aceite Esencial, Nutraceúticos, Pulpa)\r\n- **3 modelos de negocio** (Maquila, Planta Propia, Híbrido)\r\n- **Controles dinámicos** de volumen mensual (50-2000 kg)\r\n- **Métricas en tiempo real** (ingresos, costos, utilidad, margen)\r\n- **Análisis detallado** por producto con especificaciones técnicas\r\n- **Comparación de inversiones** con tiempos de recuperación\r\n\r\n### 📊 **Productos Analizados**\r\n\r\n#### 🏆 **Aceite Esencial Premium**\r\n- **ROI Potencial:** 65-95% según modelo\r\n- **Rendimiento:** 0.8-1.2 kg por 100kg fruta\r\n- **Precio Mercado:** $180-500/kg\r\n- **Personal:** 3-5 técnicos especializados\r\n\r\n#### 🌿 **Extractos Nutraceúticos**\r\n- **ROI Potencial:** 45-80% según modelo\r\n- **Rendimiento:** 8-12 kg por 100kg fruta\r\n- **Precio Mercado:** $85-280/kg\r\n- **Personal:** 2-4 técnicos\r\n\r\n#### 🥤 **Pulpa Procesada Premium**\r\n- **ROI Potencial:** 25-55% según modelo\r\n- **Rendimiento:** 35-45 kg por 100kg fruta\r\n- **Precio Mercado:** $12-45/kg\r\n- **Personal:** 4-8 operarios\r\n\r\n---\r\n\r\n## 🚀 Instrucciones de Uso\r\n\r\n### **1. Acceso a la Presentación**\r\n```bash\r\n# Opción A: Servidor local\r\ncd \"ruta/al/proyecto\"\r\npython -m http.server 8080\r\n# Abrir: http://localhost:8080/presentacion.html\r\n\r\n# Opción B: Abrir directamente en navegador\r\n# Abrir: presentacion.html en navegador web\r\n```\r\n\r\n### **2. Navegación**\r\n- Usar botones de navegación superiores\r\n- Ir directamente a \"💰 ROI Calculator\"\r\n- Controles interactivos para personalizar cálculos\r\n\r\n### **3. Personalización de Cálculos**\r\n1. **Seleccionar Modelo:** Maquila / Planta Propia / Híbrido\r\n2. **Elegir Producto:** Aceite / Nutraceúticos / Pulpa\r\n3. **Ajustar Volumen:** Slider 50-2000 kg/mes\r\n4. **Ver Resultados:** Automático en tiempo real\r\n\r\n---\r\n\r\n## 🔄 Sistema de Actualización de Datos\r\n\r\n### **Archivos de Mantenimiento**\r\n\r\n#### 📚 `ROI_Sources_Documentation.md`\r\n- **Fuentes completas** por categoría\r\n- **URLs específicas** para cada tipo de dato\r\n- **Frecuencias de actualización** recomendadas\r\n- **Metodología de validación** de datos\r\n- **Contactos clave** y responsables\r\n\r\n#### 📊 `ROI_Data_Template.csv`\r\n- **Historial de precios** por producto/modelo\r\n- **Datos de validación** y fuentes\r\n- **Template para nuevos datos**\r\n- **Control de calidad** integrado\r\n\r\n#### 🔧 `roi_updater.py` (Opcional)\r\n- **Automatización** de recopilación de datos\r\n- **Validación automática** vs históricos\r\n- **Integración** con fuentes API\r\n- **Reportes automáticos** de actualizaciones\r\n\r\n---\r\n\r\n## 📈 Proceso de Actualización\r\n\r\n### **🔄 Actualización Manual (Recomendado)**\r\n\r\n#### **Paso 1: Recopilar Datos**\r\n```bash\r\n# Consultar fuentes documentadas en ROI_Sources_Documentation.md\r\n# Frecuencias:\r\n# - Semanal: Precios locales (MADR, Bolsa Mercantil)\r\n# - Mensual: Costos operacionales (DANE, XM)\r\n# - Trimestral: Precios internacionales (Alibaba, Market Research)\r\n# - Semestral: Análisis tendencias (Grand View, Statista)\r\n```\r\n\r\n#### **Paso 2: Validar Información**\r\n- ✅ Comparar 3+ fuentes diferentes\r\n- ✅ Verificar variación \u003c30% vs histórico\r\n- ✅ Documentar en `ROI_Data_Template.csv`\r\n- ✅ Marcar como validado\r\n\r\n#### **Paso 3: Actualizar Código**\r\n```javascript\r\n// Localizar en presentacion.html (línea ~4380)\r\nfunction getProductData() {\r\n    return {\r\n        aceite: {\r\n            prices: {\r\n                maquila: { min: NUEVO_MIN, max: NUEVO_MAX }, // ← ACTUALIZAR\r\n                planta: { min: NUEVO_MIN, max: NUEVO_MAX },\r\n                hibrido: { min: NUEVO_MIN, max: NUEVO_MAX }\r\n            },\r\n            costs: { min: NUEVO_MIN, max: NUEVO_MAX }, // ← ACTUALIZAR\r\n            // ... resto de datos\r\n        }\r\n    };\r\n}\r\n```\r\n\r\n#### **Paso 4: Probar Cambios**\r\n```bash\r\n# Abrir presentación y verificar:\r\n# 1. Calculadora funciona correctamente\r\n# 2. Valores ROI son coherentes\r\n# 3. No hay errores JavaScript\r\n# 4. Datos se actualizan dinámicamente\r\n```\r\n\r\n### **🤖 Actualización Automática (Avanzado)**\r\n\r\n#### **Configuración Inicial**\r\n```bash\r\n# Instalar dependencias\r\npip install requests pandas beautifulsoup4\r\n\r\n# Configurar APIs y endpoints\r\n# Editar roi_updater.py con credenciales\r\n\r\n# Programar ejecución\r\n# Windows: Task Scheduler\r\n# Linux/Mac: Cron job\r\n```\r\n\r\n#### **Ejecución**\r\n```bash\r\npython roi_updater.py\r\n# Genera reportes automáticos\r\n# Actualiza CSV con nuevos datos\r\n# Requiere validación manual antes de aplicar\r\n```\r\n\r\n---\r\n\r\n## 🎯 Mejores Prácticas\r\n\r\n### **✅ Hacer Siempre**\r\n- Respaldar `presentacion.html` antes de cambios\r\n- Validar datos con múltiples fuentes\r\n- Probar calculadora después de actualizaciones\r\n- Documentar cambios significativos\r\n- Notificar stakeholders de actualizaciones\r\n\r\n### **❌ Evitar**\r\n- Actualizar con una sola fuente\r\n- Cambios \u003e30% sin validación extra\r\n- Modificar código sin backup\r\n- Datos sin timestamp/fuente\r\n- Actualizaciones en horarios de presentación\r\n\r\n### **📊 Monitoreo de Calidad**\r\n- **Precisión:** \u003c10% desviación vs precios reales\r\n- **Actualidad:** Datos \u003c30 días antigüedad\r\n- **Cobertura:** \u003e80% mercado representado\r\n- **Consistencia:** Variaciones lógicas mes a mes\r\n\r\n---\r\n\r\n## 🔧 Troubleshooting\r\n\r\n### **Problema: Calculadora no actualiza valores**\r\n```javascript\r\n// Verificar en consola del navegador (F12)\r\nconsole.log(\"calculateROI function exists:\", typeof calculateROI);\r\n\r\n// Revisar errores JavaScript\r\n// Verificar IDs de elementos HTML\r\n```\r\n\r\n### **Problema: Datos parecen incorrectos**\r\n```bash\r\n# Verificar fuentes en ROI_Sources_Documentation.md\r\n# Comparar con datos históricos en CSV\r\n# Validar cálculos manualmente\r\n```\r\n\r\n### **Problema: Presentación no carga**\r\n```bash\r\n# Verificar servidor local está corriendo\r\n# Confirmar ruta de archivos\r\n# Revisar permisos de archivos\r\n# Probar en diferentes navegadores\r\n```\r\n\r\n---\r\n\r\n## 📊 Métricas y KPIs\r\n\r\n### **Indicadores de Performance**\r\n- **Uso de calculadora:** Tiempo promedio de sesión\r\n- **Precisión de datos:** % exactitud vs mercado real\r\n- **Actualidad:** Días desde última actualización\r\n- **Satisfacción:** Feedback usuarios de presentación\r\n\r\n### **Alertas Automáticas**\r\n- 🚨 Variación \u003e30% en precios\r\n- 🚨 ROI \u003c50% en cualquier modelo\r\n- 🚨 Datos \u003e45 días antigüedad\r\n- 🚨 Fuentes no accesibles\r\n\r\n---\r\n\r\n## 👥 Responsabilidades\r\n\r\n| Rol | Frecuencia | Responsabilidad |\r\n|-----|------------|----------------|\r\n| **Analista Junior** | Semanal | Precios locales, datos MADR |\r\n| **Analista Senior** | Mensual | Costos operacionales, validación |\r\n| **Especialista Mercados** | Trimestral | Precios internacionales |\r\n| **Director Comercial** | Semestral | Análisis tendencias, estrategia |\r\n| **Gerente Técnico** | Anual | Costos equipos, certificaciones |\r\n\r\n---\r\n\r\n## 📞 Soporte y Contacto\r\n\r\n### **Documentación Técnica**\r\n- **Fuentes de datos:** Ver `ROI_Sources_Documentation.md`\r\n- **Historial cambios:** Ver `ROI_Data_Template.csv`\r\n- **Código automatización:** Ver `roi_updater.py`\r\n\r\n### **Escalación de Problemas**\r\n1. **Nivel 1:** Consultar este README\r\n2. **Nivel 2:** Revisar documentación técnica\r\n3. **Nivel 3:** Contactar equipo desarrollo\r\n4. **Nivel 4:** Validar con expertos sectoriales\r\n\r\n---\r\n\r\n## 🔄 Historial de Versiones\r\n\r\n| Versión | Fecha | Cambios |\r\n|---------|-------|---------|\r\n| **1.0** | 2025-10-08 | Implementación inicial con calculadora ROI |\r\n| **1.1** | TBD | Próximas mejoras basadas en feedback |\r\n\r\n---\r\n\r\n## 🚀 Próximas Mejoras\r\n\r\n### **Funcionalidades Planificadas**\r\n- [ ] **Dashboard admin** para gestión de datos\r\n- [ ] **API REST** para integración externa\r\n- [ ] **Alertas email** automáticas\r\n- [ ] **Exportación PDF** de cálculos\r\n- [ ] **Modo comparación** múltiples escenarios\r\n- [ ] **Integración CRM** para seguimiento leads\r\n\r\n### **Optimizaciones Técnicas**\r\n- [ ] **PWA** (Progressive Web App)\r\n- [ ] **Offline functionality**\r\n- [ ] **Mobile responsive** mejorado\r\n- [ ] **Performance optimization**\r\n- [ ] **A/B testing** components\r\n\r\n---\r\n\r\n**¡Sistema Passio Vértice ROI Calculator listo para usar!** 🎉\r\n\r\n\r\n\r\n\r\n*Para cualquier duda o sugerencia, consultar la documentación técnica o contactar al equipo de desarrollo.*\r\n\r\n\r\n---\r\n\r\n## 📋 Para Reclutadores y Portfolio\r\n\r\nEste README contiene documentación técnica del proyecto. \r\n\r\n**Para análisis completo de impacto AgTech y caso de éxito:**  \r\n👉 **[Ver README-PORTFOLIO.md](README-PORTFOLIO.md)**\r\n\r\n- ✅ Cliente real: PasionVertice\r\n- ✅ Impacto sectorial AgTech  \r\n- ✅ Arquitectura multi-stakeholder\r\n- ✅ Métricas de trazabilidad\r\n\r\n---\r\n\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrantastico-rgb%2Fvendor2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrantastico-rgb%2Fvendor2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrantastico-rgb%2Fvendor2/lists"}