Informe Técnico y Manual de Usuario

Documentación sobre el diseño, funcionalidades, tecnología y guía de uso de la Bitácora de Seguimiento.

Parte I: Informe Técnico

1. Introducción

1.1. Objetivo

El objetivo principal de esta aplicación es centralizar y estandarizar el registro de datos de campo (bitácoras) para el proyecto de agricultura regenerativa. La herramienta está diseñada para facilitar el seguimiento sistemático, agilizar el análisis de información cuantitativa y cualitativa, y potenciar la generación de informes de avance, garantizando la calidad y consistencia de los datos a lo largo de todo el ciclo de vida del proyecto.

1.2. Justificación

Esta herramienta surge como una necesidad técnica identificada desde el inicio del proyecto para sistematizar, analizar y hacer un seguimiento riguroso de los resultados. Fue concebida para superar las limitaciones inherentes a la recolección manual de datos, proporcionando una plataforma centralizada y estandarizada que garantiza la calidad y consistencia de la información. Una aplicación de esta naturaleza no solo asegura la integridad de los datos, sino que, fundamentalmente, potencia la capacidad analítica del equipo de investigación al transformar los registros de campo en conocimiento accionable para la toma de decisiones informada.

1.3. Alcance y disponibilidad

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.

La herramienta estará disponible y operativa durante toda la vigencia del proyecto, sirviendo como el repositorio central y único para todos los registros de bitácora, asegurando así la continuidad y la integridad del acervo de datos.

2. Arquitectura tecnológica y seguridad

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 que asegura 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 que permite una sincronización en tiempo real.
Firebase Authentication: Aunque no requiere un inicio de sesión con usuario y contraseña, utiliza la "autenticación anónima" para asignar un identificador único a cada sesión, un requisito técnico para registrar datos de forma segura.
Google AI Platform (Genkit): Es el motor de las funcionalidades de inteligencia artificial. La aplicación utiliza los modelos de lenguaje avanzados de Google (familia Gemini) a través del framework Genkit para procesar el texto y generar análisis.

Control de acceso y costos: Para un uso responsable de los recursos, las funcionalidades de solo lectura que consultan toda la base de datos (como el panel de análisis y las herramientas avanzadas) están protegidas por contraseña. Esto controla los costos operativos asociados a la lectura de datos y al uso de la inteligencia artificial, optimizando el presupuesto del proyecto.

3. Gestión de datos: del registro al análisis

La aplicación está estructurada para guiar al usuario en un flujo lógico, desde la entrada de datos hasta su análisis y exportación.

A. Formulario de registro inteligente

Es el corazón de la app. Un formulario detallado y estructurado que captura la información de manera estandarizada. Su diseño inteligente agiliza el diligenciamiento y minimiza errores, asegurando la calidad y coherencia de la información desde su origen.

Filtros dinámicos y guiados: El formulario utiliza menús desplegables interconectados que guían al investigador. Por ejemplo, al seleccionar un "Objetivo Específico", el campo "Actividad del proyecto" se filtra automáticamente para mostrar solo las actividades correspondientes. Lo mismo ocurre entre actividades y resultados. Esto no solo es más rápido, sino que previene errores de asociación y garantiza que la data siempre sea coherente con la estructura del proyecto.
Autocompletado de información: Para evitar errores de digitación y ahorrar tiempo, al seleccionar el predio, el nombre del productor principal se carga automáticamente en los campos correspondientes.
Asistencia por Inteligencia Artificial (IA): Para los campos de análisis cualitativo (el corazón de la metacosecha), se integran tres herramientas de IA que se activan al completar el contexto del proyecto, ayudando a crear registros más ricos y profesionales:
- Dictar: Convierte la voz del investigador a texto, ideal para documentar rápidamente en campo sin teclear.
- Mejorar: Refina el texto ingresado, corrigiendo gramática y mejorando el estilo sin alterar el significado.
- Sugerir: Analiza el contexto y registros previos para proponer un texto relevante, superando el "bloqueo del escritor" y aportando ideas.

B. Seguimiento de metas y cumplimiento

Esta sección, visible al cargar los datos, es crucial para los coordinadores del proyecto, ya que permite un seguimiento cuantitativo y en tiempo real del avance.

Conteo de registros por resultado: La herramienta compara el número de registros ingresados con las metas predefinidas para cada resultado del proyecto, mostrando barras de progreso para una fácil visualización del cumplimiento.
Vista general y detallada: Ofrece tanto un resumen del progreso total del proyecto como un desglose detallado por cada resultado individual. Esto permite a los coordinadores identificar rápidamente qué actividades requieren más atención o están rezagadas.
Herramienta de gestión activa: Esta funcionalidad transforma la bitácora de un simple repositorio a una herramienta de gestión para la toma de decisiones, facilitando el seguimiento del cumplimiento de actividades en las diferentes escalas (municipal, veredal, predio).

4. Herramientas avanzadas de análisis y exportación

Una vez cargados los datos, se habilitan las funcionalidades más potentes de la aplicación, también protegidas por contraseña para un uso responsable de los recursos.

A. Panel de control (Dashboard) interactivo

El panel de control ofrece una radiografía visual e instantánea del proyecto a través de una serie de gráficos interactivos, permitiendo a los coordinadores y al equipo entender el estado del proyecto de un solo vistazo.

Gráfico de tendencias: Visualiza la frecuencia de registros a lo largo del tiempo, permitiendo identificar periodos de alta y baja actividad en el proyecto.

Gráficos de distribución: Gráficos de torta que muestran la proporción de registros por equipo (Técnico vs. Social) y por escala (General, Municipal, Predio).

Gráficos de avance: Barras que detallan el número de registros por Objetivo, Actividad y Resultado, permitiendo comparar visualmente el esfuerzo dedicado a cada componente.

Gráficos de ubicación: Comparan la cantidad de actividad registrada entre los diferentes municipios, veredas y predios, ayudando a identificar geográficamente el foco de las intervenciones.

B. Generador de informes con IA

Esta potente herramienta utiliza la IA para sintetizar la información cualitativa de los registros y generar análisis profundos, transformando datos en conocimiento.

Análisis por escala: El usuario puede solicitar un informe a nivel de "Predio", "Municipal" o "General". La IA leerá, analizará y correlacionará todos los registros correspondientes a esa selección para su análisis.
Doble producto analítico: La herramienta genera dos documentos clave: un resumen ejecutivo conciso, ideal para directivos y tomadores de decisiones, y un informe analítico completo y estructurado que detalla hallazgos, patrones, retos y conclusiones, un insumo de gran valor para el equipo de investigación y la redacción de informes de avance.

C. Funcionalidades de exportación versátiles

La aplicación ofrece múltiples formatos de exportación para adaptarse a las distintas necesidades del equipo, asegurando que los datos puedan ser utilizados tanto dentro como fuera de la plataforma.

Exportación masiva a CSV: Permite descargar todos los registros cargados en un archivo de valores separados por comas (.csv), compatible con Excel y otros programas de análisis de datos, ideal para análisis externos o como copia de seguridad robusta.
Exportación de informes de IA (PDF y Word): El informe analítico completo generado por la IA puede ser descargado tanto en formato PDF, para compartirlo fácilmente, como en Microsoft Word (.docx), para facilitar su edición, incorporación a otros documentos y archivo para los informes de avance del proyecto.
PDF del registro individual: Tras guardar cada bitácora, se puede descargar una copia fiel del formulario diligenciado en formato PDF, sirviendo como evidencia individual de una actividad específica.

5. Conclusión

La Bitácora de Seguimiento trasciende la idea de un simple formulario digital. Es una plataforma integral de gestión del conocimiento diseñada para el contexto específico del proyecto. Al estandarizar la entrada de datos, facilitar el seguimiento de metas, potenciar el análisis con herramientas visuales e inteligencia artificial, y ofrecer opciones de exportación versátiles, la aplicación se convierte en un activo estratégico.

Su propósito final es empoderar a los coordinadores y al equipo de investigación, permitiéndoles pasar menos tiempo en la organización de datos y más tiempo en su interpretación, garantizando así una toma de decisiones más ágil e informada para el cumplimiento de los objetivos del proyecto.

Parte II: Manual de Usuario

Una guía paso a paso para el registro efectivo de actividades en la bitácora.

6. Introducción y objetivo

Este manual está diseñado para guiarlo a través del proceso de registro de actividades en la Bitácora de Seguimiento del Proyecto. El objetivo principal de esta herramienta es estandarizar y centralizar la información de campo para facilitar su análisis y seguimiento.

Un registro correcto y detallado es crucial para la generación de informes precisos y para el éxito del análisis de datos posterior.

7. Diligenciamiento del formulario de registro

El formulario se divide en varias secciones para organizar la información de manera lógica.

Sección 1: Información general

1. Fecha de la actividad: Seleccione la fecha en que se realizó la actividad. Puede registrar actividades de días anteriores.
2. Modo del registro: Marque "Real" para los datos oficiales del proyecto. La opción "Prueba" está deshabilitada y era solo para fases de desarrollo.

Sección 2: Ubicación y contexto

3. Equipo responsable: Elija entre "Equipo Técnico" o "Equipo Social" según corresponda.
4. Escala del registro: Defina el alcance del registro: "General" (para todo el proyecto), "Municipal" (para un municipio específico) o "Predio" (para una finca concreta).
5-7. Ubicación (Municipio, Vereda, Predio): Estos campos son dependientes. Al seleccionar un municipio, se filtrarán las veredas disponibles, y al seleccionar una vereda, se filtrarán los predios. El nombre del productor se autocompletará al seleccionar el predio.
8. Persona que atendió la actividad: Si la persona que participó no es el productor principal, seleccione "No" e ingrese su nombre y rol. Si es el productor, seleccione "Sí".

Sección 3: Marco del proyecto

9-11. Objetivo, Actividad y Resultado: Estos campos son interdependientes. Al seleccionar un Objetivo Específico (OE), se filtrarán sus actividades asociadas. Al seleccionar una actividad, se mostrarán sus resultados correspondientes.
Módulos y Talleres: Si un resultado corresponde a un curso, diplomado o taller, se desplegará un menú adicional para que seleccione el módulo o taller específico. Esta selección es obligatoria.

Sección 4: Equipo de registro

12. Rol y Nombre de registro: Seleccione su rol ("Coinvestigador" o "Joven Investigador") y luego su nombre de la lista. Esto es fundamental para saber quién realizó el registro.

8. Descripción y análisis con asistencia de IA

Esta es la sección más importante para el análisis cualitativo. La IA está aquí para ayudarle a documentar la experiencia con detalle.

Herramientas de asistencia por IA

Para los campos del 13 al 17, dispone de tres herramientas de inteligencia artificial que se activan una vez que ha completado el contexto del proyecto (campos 1-11):

Dictar: Convierta su voz a texto en tiempo real. Ideal para documentar rápidamente en campo sin necesidad de teclear.
Mejorar: Refine su texto. La IA corregirá la gramática, mejorará la claridad y le dará un tono más profesional sin alterar el significado.
Sugerir: ¿No sabe qué escribir? La IA analizará el contexto de la actividad y registros anteriores para proponerle un texto relevante y bien redactado.

Guía de contenido para el análisis cualitativo

Para que la información sea rica y útil para el análisis, piense en cada campo desde dos perspectivas complementarias: la técnica (el "qué" y el "cómo" de la agronomía) y la de metacosecha (el "quiénes", "por qué" y "para qué" del proceso social). A continuación, una guía detallada:

13. Actividad realizada:
- Perspectiva técnica: Describa con precisión las tareas ejecutadas. Ej: "Se realizó la primera aplicación del compost de cama estática en el lote experimental de plátano (variedad Dominico Hartón), en una dosis de 2 kg por planta. Se documentó el estado inicial del cultivo (altura, grosor del tallo) y se tomaron muestras de suelo para análisis de laboratorio."
- Perspectiva de metacosecha: Narre las interacciones y el contexto social. Ej: "Durante la aplicación, se sostuvo un diálogo con la productora sobre sus expectativas. Expresó cierta preocupación por el tiempo que podría tomar ver resultados en comparación con los fertilizantes químicos. Se acordó realizar un seguimiento fotográfico semanal conjunto para observar los cambios en el suelo y la planta."
14. Aprendizajes:
- Perspectiva técnica: Conocimiento validado o adquirido. Ej: "Se aprendió que la temperatura de la pila de compost se estabilizó en 55°C tras el segundo volteo, indicando una correcta actividad microbiana. La relación carbono-nitrógeno inicial, ajustada con material de la finca, parece ser la adecuada."
- Perspectiva de metacosecha: Reflexiones sobre el proceso social y la apropiación. Ej: "El productor, al participar en la medición de temperatura de la pila, comprendió que el compostaje es un proceso biológico activo ('el abono se cocina', mencionó). Este aprendizaje práctico generó más valoración por el tiempo y el cuidado que requiere la práctica, en contraste con simplemente 'amontonar monte'."
15. Saberes emergentes:
- Perspectiva técnica: Nuevas hipótesis o ideas. Ej: "Durante la caracterización de materiales, se identificó la planta 'nacedero' (Trichanthera gigantea) en el predio. Surgió la hipótesis de que sus hojas, ricas en proteína, podrían enriquecer el compost y mejorar su calidad microbiológica. Se tomará una muestra para análisis."
- Perspectiva de metacosecha: Conocimiento local o co-creado. Ej: "El productor compartió que tradicionalmente usa el 'agua miel' del beneficio del café para 'activar' los suelos y mejorar la floración. Este saber local podría integrarse, sugiriendo la co-creación de un biofertilizante líquido que combine este conocimiento con los preparados técnicos del proyecto."
16. Retos y dificultades:
- Perspectiva técnica: Obstáculos en la ejecución. Ej: "Se encontró una alta presencia de hormiga arriera cerca del área de compostaje, lo que representa un riesgo para los materiales. Se instalaron barreras físicas (cal) como medida de control inmediato sin usar químicos, pero se debe monitorear su efectividad."
- Perspectiva de metacosecha: Barreras sociales o de comunicación. Ej: "Se notó que la productora tenía dificultades para levantar los bultos de material para la compostera debido a su peso. Esto evidencia un reto ergonómico y la necesidad de pensar en herramientas o métodos adaptados (ej. carretilla, bultos más pequeños) que faciliten la participación de todos los miembros de la familia."
17. Emociones y percepciones:
- Esta sección es principalmente de metacosecha. Concéntrese en el "clima" de la actividad. Ej: "Durante el taller de cromatografía de suelos, se percibió un ambiente de asombro y curiosidad. Los productores se mostraron muy interesados al ver los 'dibujos' que formaba su tierra. La productora principal expresó: 'Es como si la tierra nos estuviera hablando por primera vez', lo que refleja una conexión más profunda y una nueva percepción del suelo como un ente vivo y no solo como un sustrato inerte."

9. Evidencia, guardado y exportación del registro

18. Evidencia Disponible: Seleccione el tipo de evidencia que soporta su registro (fotografías, documentos, etc.). Este campo es obligatorio.
19. Enlace a la evidencia: Suba su archivo a un servicio en la nube (Google Drive, Dropbox, etc.) y pegue aquí el enlace para compartir. Es fundamental que el enlace sea de acceso público. Este campo es obligatorio.
Guardar Registro en Bitácora: Una vez completado el formulario, presione este botón. El formulario se bloqueará indicando que el guardado fue exitoso.
Guardar como PDF: Después de guardar, este botón se activará. Púlselo para descargar una copia en PDF de la bitácora que acaba de diligenciar, ideal como evidencia individual.
Crear Nuevo Registro / Cancelar Edición: Use este botón para limpiar el formulario y empezar uno nuevo, o para salir del modo de edición sin guardar cambios.

10. Análisis y gestión de datos

Funcionalidades avanzadas para la visualización y exportación de datos.

Cargar datos y análisis

Esta sección está protegida por contraseña para controlar costos. Al ingresar la contraseña, se cargarán todos los registros de la base de datos y se mostrará un panel con gráficos interactivos (Dashboard) y una tabla con todos los registros. Desde esta tabla puede editar o eliminar registros de prueba.

Herramientas avanzadas y exportación

También protegida por contraseña, esta sección se activa una vez cargados los datos. Aquí encontrará:

Generador de informes con IA: Seleccione una escala (predio, municipio, general) y la IA generará un informe analítico detallado y un resumen ejecutivo. Podrá exportar el informe completo a Word o PDF.
Exportar a CSV: Descargue todos los datos cargados en un archivo CSV, compatible con Excel, para análisis externos.