Informe técnico de la aplicación

Objetivo: Centralizar y estandarizar el registro de datos de campo (bitácoras) para el proyecto de agricultura regenerativa, facilitando el seguimiento sistemático, el análisis de información y la generación de informes de avance.

Justificación: Previo a esta herramienta, los datos se recolectaban en formatos dispersos (documentos, hojas de cálculo, etc.), lo que dificultaba consolidar la información, identificar patrones y tomar decisiones informadas. Una aplicación web a medida no solo soluciona este problema, sino que también minimiza errores de transcripción, ahorra tiempo y potencia la capacidad analítica del equipo de investigación.

Alcance: La aplicación está diseñada para ser utilizada por el equipo de Coinvestigadores y Jóvenes Investigadores del proyecto. Su alcance funcional cubre desde el registro detallado de actividades en campo hasta la visualización, análisis y exportación de los datos consolidados, incorporando herramientas de inteligencia artificial como apoyo clave en el proceso.

La aplicación presenta una interfaz unificada que guía al usuario a través del proceso de registro y análisis, dividida en las siguientes secciones lógicas:

• Formulario de Nuevo Registro: Es el corazón de la app. Un formulario detallado y estructurado que permite capturar toda la información relevante de una actividad. Cuenta con menús desplegables dinámicos que se adaptan a la selección del usuario, y requiere de manera obligatoria un enlace de evidencia para cada registro.
• Seguimiento de Avance por Resultado (Protegido): Ofrece una vista rápida del progreso general del proyecto y un desglose detallado del número de registros ingresados frente a los objetivos esperados para cada resultado.
• Panel de Análisis (Protegido): Una vez que se cargan los datos, esta sección muestra métricas clave y gráficos interactivos (cada uno con una breve descripción de su contenido) sobre la distribución de registros, avance por objetivos, actividad por ubicación y más.
• Tabla de Registros (Protegido): Permite visualizar todos los registros ingresados en un formato tabular. Las funciones de edición y eliminación han sido desactivadas para garantizar la integridad de los datos.
• Herramientas Avanzadas (Protegido): Incluye el generador de informes por IA y las opciones de exportación de datos, accesibles tras una segunda capa de autenticación para controlar el consumo de recursos.

• Carga de Registros: El formulario está diseñado con menús desplegables interconectados que filtran las opciones según la selección anterior (ej. al elegir un objetivo, solo se muestran sus actividades correspondientes), minimizando errores y agilizando el proceso. La subida de una evidencia a través de un enlace es obligatoria.
• Seguimiento de Metas: La sección "Seguimiento de Avance" compara en tiempo real el número de registros ingresados con las metas predefinidas para cada resultado del proyecto, ofreciendo barras de progreso para una fácil visualización del cumplimiento.
• Visualización de Datos: El "Análisis de bitácora" ofrece gráficos de barras, líneas y torta (con descripciones explicativas) que permiten interpretar visualmente la información recolectada. Los gráficos son dinámicos y se actualizan en tiempo real con los datos cargados.
• Gestión de Datos Segura: Las funciones de edición y eliminación de registros están deshabilitadas para el usuario final, protegiendo la integridad y consistencia de la base de datos.
• Gestión de Acceso por Contraseña: Para controlar los costos asociados a la lectura de datos y el uso de IA, las funcionalidades de análisis y exportación están protegidas por contraseñas, asegurando un uso consciente de los recursos.

La aplicación ofrece múltiples formatos de exportación para adaptarse a las necesidades del equipo:

• PDF del Registro Individual: Después de guardar un registro, se habilita el botón "Guardar como PDF", que genera una copia fiel del formulario diligenciado, ideal como evidencia individual de una actividad.
• Exportación masiva a CSV: En la sección de herramientas avanzadas, el botón "Exportar a CSV" descarga todos los registros cargados en un archivo compatible con Excel, listo para análisis externos o como copia de seguridad.
• Exportación de Informes de IA (PDF y Word): Tras generar y revisar el informe analítico de la IA en pantalla, este puede ser exportado tanto a formato PDF como a Microsoft Word (.docx), facilitando su edición, archivo y distribución.

La aplicación se construye sobre la robusta infraestructura de Google, garantizando escalabilidad, seguridad y un alto rendimiento:

• Firebase App Hosting: Es el servicio principal donde se publica y ejecuta la aplicación. Proporciona un entorno gestionado, despliegues continuos desde el código fuente y certificados SSL automáticos, asegurando que la app esté siempre disponible y segura.
• Cloud Firestore (Base de Datos): Todos los registros de la bitácora se almacenan en Firestore, una base de datos NoSQL altamente escalable y en tiempo real. Su modelo de datos flexible y sus potentes reglas de seguridad son ideales para este tipo de aplicación.
• Firebase Authentication: Gestiona la autenticación de usuarios. En este caso, se utiliza la "autenticación anónima" para asignar un identificador único a cada sesión sin requerir que los usuarios creen una cuenta, simplificando el acceso.
• Google AI Platform (Genkit): La potencia detrás de las funcionalidades de IA. La aplicación utiliza los modelos de lenguaje avanzados de Google (familia Gemini) a través del framework Genkit para procesar el texto, generar sugerencias y analizar los datos.