# MÓDULO DE ESCUCHA

## ¿Qué es?

El módulo de escucha es una aplicación web, que puede ser accedida desde cualquier parte del mundo, con altos niveles de seguridad, que permite resguardar todas las entrevistas realizadas por los compañeros de la Comisión de la Verdad a lo largo y ancho de Colombia, y alrededor del mundo.

## ¿Cuál es su historia?

Buscando darle un tratamiento de gestión documental al ejercicio de escucha de la Comisión de la Verdad, se pensó en un software que posibilitara su gestión, almacenamiento, consulta y visualización. Esta necesidad lleva a desarrollar un aplicativo web enfocado, principalmente, en el almacenamiento de los audios de las entrevistas y los diferentes archivos adjuntos asociados a cada una de ellas: fichas, consentimientos informados, anexos, etc. Según sus desarrolladores, al principio, el módulo era muy simple; permitía cargar entrevistas a víctimas, algunos metadatos y archivos adjuntos. Posteriormente, y de acuerdo con la evolución del trabajo de escucha de la Comisión, se identificaron otras posibilidades dentro del módulo.&#x20;

Así entonces, en un primer momento, el módulo estaba pensado solo para almacenar un tipo de entrevista; hoy en día, el módulo permite almacenar y visualizar ocho tipos diferentes de entrevistas: 1) víctimas, familiares o testigos; 2) actores armados; 3) terceros civiles; 4) entrevista colectiva; 5) entrevista a sujeto colectivo; 6) entrevista a profundidad; 7) diagnóstico comunitario; 8) historias de vida. Permite almacenar y trabajar colaborativamente en informes: módulo de casos e informes y casos transversales; y almacenar archivos que se encuentran en otras partes de mundo: archivos en el exilio. Con la labor de escucha adelantada por la Comisión, se contrató a todo el equipo de transcripción y etiquetado; en este punto, el módulo pasó de ser un simple repositorio, a manejar temas de gestión de entrevistas y temas de seguridad.&#x20;

Con el módulo de escucha se comienza a legitimar el Sistema de Información Misional de la Comisión de la Verdad como lo que es ahora: un sistema.&#x20;

*<mark style="color:orange;">En estos tiempos modernos cuando hablan de guardar información, se habla de sistema misional, y siempre le han dado mucha importancia al sistema misional. El SIM existe desde el inicio, desde que estaban conceptualizando. Que exista como una entidad que presta servicios, que se materialice en un sistema, inicia cuando publicamos el módulo de escucha, cuando cargan la primera entrevista…</mark>*


# Funcionalidad

## Usuarios

El módulo de escucha funciona para cuatro clases de perfiles:&#x20;

* **Administradores:** gestionan todas las funcionalidades del sistema.
* **Investigadores:** especializados en consulta y visualización de datos; consultan las transcripciones, el etiquetado y las fichas.
* **Entrevistadores:** quienes cargan las entrevistas, los metadatos y los adjuntos.
* **Analistas-Transcriptores:** realizan toda la gestión de transcripción, etiquetado y diligenciamiento de fichas.

## Tareas que el sistema proporciona

### **1) La recolección de entrevistas.**

Cargar entrevistas, metadatos (de identificación: fecha, lugar, duración, etc.; clasificación: núcleo, sector, etc.); y anexos (consentimientos informados, fichas, fotografías, recortes de prensa, etc.), todo lo cual consolida los datos cualitativos.

![Panel para la carga de entrevistas, metadatos y anexos](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-McPKYf7CXJvAk3numeL%2F-McPOHOoM-C6p833f3t0%2FCapturaEntrevistas.PNG?alt=media\&token=4cd31859-56c8-4ba3-83a0-033349eaf4c8)

Para navegar por las entrevistas, se recomienda visualizar el siguiente documento:

{% file src="/files/w6RWXopGI05Oqdg6qYqb" %}
Navegación por las entrevistas
{% endfile %}

### **2) Gestión transcripciones.**

Permite distribuir el trabajo para el equipo de transcripción y etiquetado (tiene toda una lógica para la asignación y el seguimiento).

![Asignación y gestión de transcripciones](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-MakC9Gva4npLwzA_QdP%2F-MakGgA2Y03CRd-tkvqI%2Fimagen_2021-05-27_190137.png?alt=media\&token=e283ac2f-1a7b-4861-b060-55b3c8b429c2)

Para profundizar sobre la navegación por las transcripciones y el etiquetado, se recomienda visualizar el siguiente documento:&#x20;

{% file src="/files/tLFRp2Urawl8JLvsFBkn" %}
La buscadora y las transcripciones
{% endfile %}

### **3)** **Ficha digital.**&#x20;

Permite diligenciar la ficha de víctimas. Este instrumento, creado desde el equipo de esclarecimiento, contiene diferentes datos de la entrevista a víctimas susceptibles de ser cuantificados. El diligenciamiento se realiza posterior al trabajo de creación de entrevista que realizan los entrevistadores; es decir, posterior a la carga de la entrevista, los adjuntos y los metadatos.

![Formato para el diligenciamiento de la ficha digital](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-McPKYf7CXJvAk3numeL%2F-McPPW8xycBWnvIOPGx3%2FFichaDigital.PNG?alt=media\&token=05618cdf-9e25-4946-98cf-eba0f5b1996d)

Para profundizar sobre las estadísticas y el procesamiento de los datos consignados en la ficha digital, se recomienda visualizar el siguiente documento:&#x20;

{% file src="/files/gQ5ZcRpGCy46oCeYHHg4" %}
Estadísticas y procesamiento de la ficha digital
{% endfile %}

### **4)** **Repositorio de casos e informes.**&#x20;

Repositorio que permite almacenar documentos que diferentes organizaciones han aportado a la Comisión de la Verdad para el proceso de esclarecimiento. Los casos e informes son otra cara en la labor de escucha: aquellas personas u organizaciones que no quieren una escucha directa a partir de entrevistas, recurren a esta figura para aportar su testimonio al proceso de investigación.

![Casos e informes](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-MakC9Gva4npLwzA_QdP%2F-MakHVtxezri49KB1bgB%2Fimagen_2021-05-27_190513.png?alt=media\&token=aeb79304-a51e-4c06-af21-9406aaee3815)

### **5) Casos transversales.**&#x20;

Construcción de espacios compartidos y colaborativos para unificar consultas y documentos relacionados con un caso especial. Es una herramienta para los investigadores, con el fin de generar un inventario de los casos que lleva la Comisión.&#x20;

![Casos transversales](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-MakC9Gva4npLwzA_QdP%2F-MakHoMHKIzEdrJzGX8j%2Fimagen_2021-05-27_190633.png?alt=media\&token=744346a2-70d4-4185-b992-de0212921d22)

Para profundizar en el manejo de los casos transversales, se recomienda visualizar el siguiente documento:

{% file src="/files/YYEiAIhq7Xz1Ex3Ryida" %}
Casos transversales
{% endfile %}

### **6)** **Los archivos en el exilio.**&#x20;

Inventario de los archivos que se encuentran por el resto del mundo, con el fin de saber en qué lugar se encuentran.

![Archivos en el exilio](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-MakC9Gva4npLwzA_QdP%2F-MakIA9-cygje205x1aV%2Fimagen_2021-05-27_190806.png?alt=media\&token=124df71e-202e-414c-95f9-0c04dec9918d)

## Manual de usuario

La Comisión de la Verdad pone a disposición el manual de usuario del módulo de escucha, con el fin de que se pueda profundizar en el uso y el paso a paso de la herramienta:

{% file src="/files/7hHJLSHMA2P4UgEiRVL0" %}
Manual de usuario
{% endfile %}


# Requerimientos

## Limitaciones y alcances

El sistema se ha especializado en la captura y el almacenamiento de entrevistas. La filosofía del módulo es centrarse en esta función; y dejar para un tercero (preferiblemente de software libre), funcionalidades adicionales. En este sentido, el módulo se conecta con dos soluciones: oTranscribe y Dataturks.&#x20;

{% content-ref url="/pages/-MajeZfdZfq0dPCzKYF7" %}
[Entornos y metodologías](/arquitectura-proyecto/entornos-metodologias-arquitectura)
{% endcontent-ref %}

La limitación del módulo viene dada por su nivel de especialización (el almacenamiento de entrevistas); valiéndose de otros aplicativos para la realización de otras tareas.

### Requerimientos para la óptima ejecución del aplicativo

* No requiere equipos sofisticados debido a que es un desarrollo muy liviano.
* Algunas funcionalidades, como la carga de entrevistas, requieren de un buen internet de carga.
* Al ser aplicativo web no requiere de un proceso de instalación.&#x20;

{% hint style="warning" %}
Se ha procurado que el módulo de escucha no crezca desmedidamente, sino que se enfoque en unas funciones principales. Funciona más como una pequeña aplicación especializada en hacer algo bien. Hay muchas cosas que pueden hacerse en torno a las entrevistas y los microdatos almacenados en el módulo; sin embargo, no se harían tan bien como las puede hacer un software especializado. Por ejemplo, las visualizaciones de datos de la herramienta nunca podrían compararse con las que se pueden hacer desde Tableau.
{% endhint %}


# Entornos y metodologías

## Desarrollo

El desarrollo es una solución completamente original, no hace parte de desarrollos previos. Tiene dos conexiones: una manual con oTranscribe (los transcriptores usan oTranscribe y la transcripción luego es cargada, de manera manual, en el módulo de escucha); y para la función de etiquetado se conecta, a través de un WebService, con Dataturks (solución que recibe las transcripciones y el árbol de etiquetas para la codificación del texto).&#x20;

### Tecnologías y arquitectura

* Lenguaje de programación PHP; versión 7.3
  * <https://www.php.net/manual/es/index.php>
* Framework Laravel; versión 5.5
  * <https://laravel.com/docs/5.5>
* jQuery (frontend); versión 3.5.1
  * <https://api.jquery.com/>
* PostgreSQL (backend); versión 11.12
  * <https://www.postgresql.org/docs/11/index.html>
* Bootstrap (librería CSS); versión 4.6
  * <https://getbootstrap.com/docs/4.6/getting-started/introduction/>

{% tabs %}
{% tab title="oTranscribe" %}
Desde el módulo de escucha se descarga el audio de la entrevista. Manualmente, se carga a la plataforma [oTranscribe](https://otranscribe.com/); se descarga la transcripción en formato OTR, y vuelve a cargarse al módulo de escucha.

![Página principal oTranscribe](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-MfE-n8-0JWMdK3Kd9z9%2F-MfE0IZ1agdFly5eAUb0%2FoTranscribe.PNG?alt=media\&token=e24a3ee3-fe7c-42f8-b5ea-a06e167a8716)
{% endtab %}

{% tab title="Dataturks" %}
El módulo de escucha se conecta a los WebService que tiene dispuesta la [Dataturks API](https://docs.dataturks.com/), para el envío y la recepción de información. En este sentido, desde el módulo se envía a Dataturks la transcripción y el árbol de etiquetado, para que se codifique el texto; y, una vez hecha la tarea, el módulo recoge nuevamente los resultados del etiquetado y los almacena. Se modificó la autenticación en Dataturks, para que este proceso se realice a través de usuarios con cuentas de correo electrónico de dominio comisiondelaverdad.co, y no con usuarios y claves propios de Dataturks.&#x20;

![Dataturks Document Annotations](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-MfE-n8-0JWMdK3Kd9z9%2F-MfE0biamJRb_KRaa40H%2FDataturks.png?alt=media\&token=b4bf4b5d-d79f-4aac-90cc-80b6697aa622)

En el modelo `entrevista_individual.php` contiene las interconexiones que deben hacerse para el intercambio de información con Dataturks, a partir de la línea 5528.

![entrevista\_individual.php](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-MgRNrmx6a-xZUKmEWFn%2F-MgRP7bauKl2icA_VVQf%2Fdataturks_conexi%C3%B3n.PNG?alt=media\&token=23ead61c-ec51-4974-b51b-4bad6426a49a)

El modelo `tesauro.php` contiene una serie de funciones básicas de interacción, a partir de la línea 452: crear proyecto en dataturks, eliminar proyecto, subir archivo, etc.&#x20;

![tesauro.php](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-MgRNrmx6a-xZUKmEWFn%2F-MgRSHst1l7ip_4-Vhtq%2Fdataturks_funciones2.PNG?alt=media\&token=c596ff00-3a4e-4263-b20e-3b112754490e)

Estas líneas se aprovechan en las entrevistas, particularmente en el modelo `entrevista_individual.php`.

![entrevista\_individual.php](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-MgRNrmx6a-xZUKmEWFn%2F-MgRTJTO6PJo0gl525uk%2Fdataturks_funciones.PNG?alt=media\&token=b507eb5a-6f89-4e80-bca6-10fa411af235)
{% endtab %}
{% endtabs %}

:heavy\_check\_mark: El modelo más importante y robusto del proyecto es `entrevista_individual.php`. Este modelo se reutiliza en los demás tipos de entrevista, aprovechando las lógicas que son comunes a todas ellas. Dentro de este modelo se encuentra también la lógica para las fichas, las estadísticas y la buscadora.&#x20;

:heavy\_check\_mark: Hay dos servidores de aplicaciones que se sincronizan, para que el aplicativo no deje de funcionar si algún servidor presenta fallas.

:heavy\_check\_mark: A nivel de base de datos se tiene un clúster configurado master-slave, en el motor PostgreSQL.&#x20;

:heavy\_check\_mark: Las búsquedas y consultas se resuelven a nivel de base de datos, usando el criterio técnico *full text search*.

:heavy\_check\_mark: **Arquitectura orientada al patrón Modelo Vista Controlador (MVC):** se desarrolló bajo esta arquitectura por tres motivos:

* **Simplicidad:** la herramienta se diseñó bajo el principio de simplicidad y es mucho más simple mantener y operar un aplicativo MVC que uno orientado a microservicios.  No existe la tarea extra de orquestación de servicios, y toda la funcionalidad se encuentra concentrada en un solo componente central. Por otra parte, el aplicativo es bastante simple y cuenta con pocas funcionalidades, por lo que no tiene mucho sentido descomponerlo en pequeños componentes (servicios).
* **Evolución:** además de MVC, se utilizaron herramientas como agile (y no waterfall) que son más apropiadas para patrones de diseño MVC.  Algo importante en este proyecto, es que nunca se tuvo claridad del alcance del mismo; es decir, no hubo una planeación inicial que permitiera intuir los alcances que hoy tiene. Al principio, se visualizó como una solución temporal ante los vacíos de la herramienta DataFile (que iba a cubrir la necesidad del resguardo de entrevistas).  No se habían visualizado los temas de gestión (transcripción, etiquetado, tesauro), de seguridad (R-2, R-3, R-4) y de Casos e informes, etc.  Todo el desarrollo de  módulo de escucha obedeció a un proceso de cubrir necesidades que se iban descubriendo.  Para utilizar arquitecturas como la de microservicios es necesario una comprensión amplia y mucho más exhaustiva de la herramienta a desarrollar.
* **Practicidad:** el módulo de captura es la primera herramienta del SIM y muchas cosas no estaban listas: aún no estaba definido el tema de infraestructura, y TIC no había prestado nunca algún servicio de crear máquinas virtuales, instalar servicios, temas de soporte, etc.  Adicionalmente, el módulo fue desarrollado por un solo programador, por lo que mantener un esquema de desarrollo monolítico es una ventaja.&#x20;

{% hint style="warning" %}
Si se hubiera tenido un equipo más grande de desarrollo, una planeación y un conocimiento más amplio de todas las funcionalidades que tiene actualmente el módulo, y unos servicios de infraestructura más maduros, el desarrollo se hubiera pensado bajo una arquitectura más adecuada.
{% endhint %}

Para profundizar en la infraestructura utilizada por el aplicativo, se recomienda visualizar el siguiente documento:

{% file src="/files/aoBrFd9tg1vfBdn6QFXU" %}
Configuración servidores
{% endfile %}

### Manual de instalación y configuración

Para profundizar en la instalación y la configuración del módulo de escucha, la Comisión de la Verdad pone a disposición el siguiente archivo:

{% file src="/files/91tj8qoyHYPxSdtq5cnD" %}
Manual de instalación y configuración
{% endfile %}

### Metodologías

* Programación ágil

* **Programación Sprint Scrum:**
  * Historias de usuario
  * Definición de tableros y actividades (sprints)
  * Planeación y seguimientos

## Buenas prácticas

**Programación Scrum:** se recomienda trabajar bajo la metodología de programación Sprint Scrum, dado que es una metodología que permite la articulación fácil y rápida de modelos simples y funcionales, los cuales pueden ir evolucionando con el feedback y las necesidades del cliente.&#x20;

Bajo esta metodología estaremos en función de un desarrollo iterativo o incremental, el cual consiste en dividir el trabajo en pequeñas partes o bloques temporales (sprint). Al final de cada etapa se entrega una funcionalidad completa. Para estructurar la evolución se recomienda crear el Mínimo Producto Viable (Minimum Viable Product, MVP): producto con suficientes características para satisfacer a los clientes y proporcionar retroalimentación para el desarrollo futuro.&#x20;

**MVP:** herramienta que permite aprender mientras se desarrolla. Gracias a la iteración, el producto evoluciona y se reduce el tiempo para la validación de nuevas ideas.&#x20;

**Estandarizar código:** definir unas reglas de trabajo; es decir, estandarizar la manera en que se van a crear y llamar las funciones, los métodos, las variables, los atributos, etc. La normalización del código es fundamental para el mantenimiento óptimo del desarrollo.

**Comentar el código:** es una buena práctica comentar el código a fin de que se convierta en un texto legible, autoexplicativo y facilite las modificaciones y el mantenimiento.

**Interacción con usuarios:** es una buena práctica tener entrevistas previas con los usuarios del sistema; dichos encuentros permiten entender los requerimientos puntuales y las funcionalidades concretas sobre las que debe basarse el desarrollo. Además, se recomienda encontrar un lenguaje común entre lo técnico del sistema y el requerimiento del usuario, a fin de no generar reprocesos y lograr comunicar fácilmente las funcionalidades del sistema.


# Entidades DB

## Arquitectura DataBase

#### 1. Entidades para la carga y consulta de información

![Arquitectura DB parte I](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-McoBCP6OigJJ4NvVlOM%2F-McoCpGlox6oG-HWRXe_%2FArquDB2.png?alt=media\&token=ae08ccd7-8ecc-4b1e-8cd0-eefcd26b8bb5)

La base de datos que soporta todo el módulo de escucha se estructura con base en seis entidades: Esclarecimiento, Fichas, Catálogos, Sim, Public y Analítica. Esclarecimiento, Fichas y Catálogos son las tres entidades que delimitan la totalidad del sistema y alimentan la entidad Analítica, la cual está compuesta por tablas calculadas a partir de procesos de ETL (Extraction, Transformation, Load). Esta entidad es la que le permite al equipo de Analítica, del Sistema de Información Misional, extraer datos para los análisis estadísticos.

#### 2. Entidades para la gestión de entrevistas y la trazabilidad del sistema

![Arquitectura DB parte II](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-McW0Js73Us_cuqm_REp%2F-McW6-DLvXoB5B6fH3Cg%2FArquitecturaBD_4\(3\).png?alt=media\&token=fe21c69d-acde-4901-9957-d7d3320628d6)

En la entidad Sim se almacenan las etiquetas, y existe una tabla (entrevista\_victima) que realiza el enlace con el metabuscador; es a partir de esta tabla (tabla calculada) que se incorpora información al metabuscador. Finalmente, tenemos la entidad Public, la cual soporta todo el tema de gestión de entrevistas (asignaciones para transcribir y etiquetar); la trazabilidad o registro de todos los eventos que ocurren en el sistema; y la autenticación de usuarios (validación de usuario y contraseña).

## Creación de entrevistas

![Flujograma para la carga y gestión de entrevistas](https://3167404138-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MajM4l1_QTM8o2Px95x%2F-McWBM5N-w6x7rlZk9Dl%2F-McWGvNQCIPaiOA5pNjD%2FFlujogramaEntrevistas.PNG?alt=media\&token=f1602865-2507-4030-b683-699b36a62e5c)

La creación de las entrevistas tiene dos momentos importantes: 1) la carga de la entrevista en el sistema, el diligenciamiento de los metadatos y la carga de los archivos adjuntos; proceso realizado por los entrevistadores. 2) la transcripción, el etiquetado y, si es una entrevista a víctimas, el diligenciamiento de la ficha digital; proceso realizado por transcripción y etiquetado. La validación se realiza por parte del equipo de monitoreo, con el fin de garantizar la integralidad entre la entrevista cargada, los archivos adjuntos y los datos de identificación y clasificación, para, posteriormente, ser procesada (transcrita y etiquetada); solo se puede avanzar en el proceso si la validación es exitosa.&#x20;


# Desarrolladores

## ¿Por qué se ha creado una buena herramienta?

La clave del éxito es la cercanía con los usuarios. La herramienta se ha ido desarrollando de la mano con los usuarios finales, quienes han sido los encargados de formular los requerimientos necesarios para acondicionar el módulo. *<mark style="color:orange;">Ha sido una herramienta muy versátil que ha evolucionado en función de las necesidades de los usuarios; eso ha sido clave: comprender las necesidades de los usuarios y atenderlas oportunamente...</mark>*

Adicionalmente, la especialización de la herramienta hace que las tareas que realiza las haga muy bien. La aplicación podría crecer aún más; no obstante, la idea es que se especialice y mejore en función de la captura y almacenamiento de entrevistas. Es un sistema de misión crítica que ha funcionado 24/7 sin problema alguno; ha sacado bien la tarea para la que fue construido. Podría optimizarse el código (por ejemplo, modular más el modelo `entrevista_individual.php`) o poner cosas más bonitas, pero la tarea, su especialidad, la hace muy bien.

Ahora bien, ya que son las entrevistas y toda la base de datos lo valioso del desarrollo, pueden mejorarse las visualizaciones de datos usando software o aplicaciones especializadas para ello; en este sentido, una dirección que puede tomar la aplicación es desarrollarse de manera horizontal: pegar un Tableau a la base de datos para implementar visualizaciones más sofisticadas. *<mark style="color:orange;">Buscar no que el aplicativo haga más cosas, sino hacer más cosas con el aplicativo...</mark>* Por otro lado, el aplicativo tiene una ventaja importante y es que, como herramienta de consulta, es muy práctico; adicionalmente, el hecho de ser web y estar basado en herramientas de código libre, lo hace funcionar sin necesidad de actualizaciones o modificaciones importantes.&#x20;

## Aprendizajes y experiencias

A nivel de desarrollo no es una herramienta difícil de programar. No hay una programación sofisticada; es un tema básico. El reto es hacerlo amigable al usuario final. La fortaleza del programador no es apoyarse en los compañeros de sistemas, sino apoyarse con los compañeros del área misional: la gente que hace las entrevistas, la gente que hace consultas, los usuarios del sistema. Es allí donde está el verdadero aprendizaje: alinear lenguajes y lograr una construcción colectiva. *<mark style="color:orange;">Imagínate que estés escribiendo una cosa en Word, una cosa es tener la destreza de escribir rápido a máquina, teclear sin errores, y otra es escribir el texto correcto. Cuando ya superas la parte de la mecanografía… es decir, si eres buen mecanógrafo, tu reto ya no está en eso, sino en escribir un bonito poema...</mark>*

A nivel de equipo, es importante contar con profesionales que estén al nivel del desarrollo; durante la producción del módulo de escucha, se tuvo algunos inconvenientes con el equipo de desarrolladores ya que, al no estar al nivel, generaron algunos reprocesos, pérdidas de datos y trabajo adicional (generar backups para respaldar la información almacenada y evitar pérdidas importantes). En consecuencia, las fichas para entrevistas a actores armados y las fichas para entrevistas a terceros civiles, quedaron sin ver la luz.&#x20;

El desarrollo ha sido el producto de una serie de necesidades específicas que no fueron posibles suplir de la mano del software de gestión documental dispuesto para el manejo y la gestión de archivos de la Comisión de la Verdad. El gestor documental planteó unas soluciones muy limitadas para el tratamiento integral de una entrevista (audios, adjuntos, metadatos, fichas, seguridad, flujos de información, etc.); la solución: un desarrollo *in house* a medid&#x61;*.* Es así como se crea una buena herramienta, en tanto da respuesta no solo a estas necesidades puntuales, sino que moldea y define la labor de escucha de la Comisión de la Verdad.  &#x20;

{% hint style="success" %}
El equipo de desarrollo trabajó de la mano del equipo de esclarecimiento, transcripción y etiquetado y monitoreo; es a partir de esta sincronía que se logra una herramienta importante para la gestión de la labor de escucha de la Comisión de la Verdad.&#x20;
{% endhint %}


# Usuarios

El equipo de transcripción y etiquetado ha sido uno de los equipos del Sistema de Información Misional de la Comisión de la Verdad que ha tenido una interacción importante con el módulo de escucha. La funcionalidad del módulo con respecto a la gestión de entrevistas, le ha permitido al equipo distribuir y asignar tareas de transcripción y etiquetado, realizar seguimiento a las labores y construir informes de gestión. En este sentido, y siendo el almacenamiento la función principal del módulo de escucha, la evolución del aplicativo ha estado ceñida a las necesidades de este grupo. Los primeros diálogos llevados a cabo entre el equipo y el desarrollador, estuvieron en función de cómo se imaginaban éstos la gestión de las entrevistas para procesarlas: cómo mover las entrevistas y garantizar seguridad, cómo realizar una trazabilidad (asignaciones, seguimiento y gestión), etc. A partir de ese desarrollo inicial (MVP), se fueron adaptando nuevas funcionalidades: transcripción, etiquetado, diligenciamiento de fichas y visualización.&#x20;

## Experiencias: aprendizajes, retos y oportunidades

### Lenguaje común

Uno de los retos más importantes tiene que ver con la diferencia entre lenguajes. Por un lado, existe un lenguaje técnico, asociado a la lógica de programación; por otro lado, existe un lenguaje propio de analistas y/o transcriptores, asociado al tratamiento y gestión de los datos recolectados en las entrevistas. En este sentido, el diligenciamiento de fichas implica retos y aprendizajes importantes, tanto para los desarrolladores como para las personas encargadas de la transcripción y el etiquetado. Un ejemplo particular es el tratamiento de las fechas: el sistema pide fechas exactas, mientras que los datos solo presentan fechas aproximadas. Ello implica una serie de dificultades a la hora de visualizar ciertos datos que aparecen, cronológicamente, incoherentes. No es un error en el diligenciamiento de fichas, pero tampoco es un error del sistema; es una dificultad que se ha ido fortaleciendo en la medida en que se encuentra ese lenguaje común: formalizar líneas de tiempo, por ejemplo.&#x20;

Otros ejemplos de lenguaje común tiene que ver con ciertas categorías analíticas. Los analistas tienen una conceptualización que permite entender los tipos de violencia, los hechos victimizantes, el rol de las víctimas, etc., que, en muchas ocasiones, no es tan clara para la formación de categorías dentro del sistema. Por ejemplo: en el sistema, en ningún lugar se encuentra las categorías "Ejecución extrajudicial" o "Falsos positivos". Lo mismo sucede con la concepción de víctima: para la Comisión (y para el sistema mismo), víctima es quien recibe la violencia, no sus familiares; no obstante, para analistas e investigadores (y la población en general), los familiares son víctimas en tanto reciben un daño colateral. En otras palabras, analistas e investigadores tienen una conceptualización de la violencia, las víctimas, etc., mientras que dentro del sistema opera un modelamiento distinto; hallar un lenguaje común que permita una estandarización en los modelos conceptuales es clave en el análisis y la construcción de herramientas para su gestión. &#x20;

#### ¿Qué es la ficha digital?

La ficha a víctimas (para los demás tipos de entrevista no existe este modelo) se constituye como una de las funcionalidades más complejas para aquellos usuarios del sistema. Se tiene una ficha digital, que, artificialmente, se ha dividido en ficha corta y ficha larga, con el fin de definir el momento de diligenciamiento: la corta, con datos de las personas entrevistadas, se puede diligenciar a modo de encuesta un vez terminada la conversación; y la larga, con muchos más campos, se diligencia posterior a la conversación, en el momento de la transcripción. La ficha digital, en sí misma, es el mecanismo por el cual se extrae información cuantitativa; la información cualitativa la aporta la transcripción y el etiquetado.&#x20;

Según el equipo de transcripción y etiquetado, el diligenciamiento de fichas implica una formación y un acompañamiento permanente en temas de Derechos Humanos y de Derecho Internacional Humanitario. ¿Cómo definir el reclutamiento de un menor de 18 años que no fue obligado a hacer parte de un grupo armado? ¿Cómo definir qué es una masacre (cuántas víctimas poner, por ejemplo)? Estos tecnicismos conllevan una precisión importante; de allí el reto que deja el procesamiento de entrevistas. La definición de estos parámetros y criterios ha sido una labor clave dentro del trabajo colaborativo entre desarrolladores y transcriptores, en aras de que se halle un punto en común entre aspectos que parecen incoherentes (a nivel de desarrollo), pero que en la vida real son fundamentales para comprender el conflicto.

### Curva de aprendizaje

El módulo de escucha es una herramienta intuitiva, amigable y sencilla. No obstante, requiere estar atentos a qué es lo que se quiere realizar dentro del módulo, ya que tiene unas funcionalidades muy específicas. Los cambios son fácilmente identificables, sobre todo para aquellos que interactúan con la herramienta de manera continua.

### Posibilidades de mejora

* Integrar el procesador de texto para evitar el cargue manual a la herramienta oTranscribe.
* Adicional a la posibilidad de realizar consultas, poder extraer información para realizar ejercicios de análisis, desarrollando parámetros más complejos para la seguridad y el resguardo de la información.
* Mejorar el modelo de asignación de entrevistas: en lugar de asignar una a una, estructurar el módulo para que permita las asignaciones en bloque o masivas.&#x20;

### Equipo de monitoreo

Si bien el equipo de transcripción y etiquetado tiene un papel importante en la co-creación de la herramienta, el equipo de monitoreo ha basado varias de sus tareas en las funcionalidades que ofrece el aplicativo, en particular el repositorio de casos e informes.&#x20;

De acuerdo con el equipo de monitoreo, lo primero que se creó en el módulo de escucha fueron las funcionalidades concernientes a las entrevistas; sin embargo, y de acuerdo con las metas del POA, era necesario establecer qué hacer con el proceso de los casos e informes. En este sentido, y siendo el módulo de escucha la única herramienta desarrollada y disponible, se optó por adicionar una nueva funcionalidad que permitiera el flujo de estos documentos. Según el equipo, la labor de escucha de la Comisión de la Verdad tiene dos caras: una escucha directa, que es la que se recoge en las entrevistas; y una escucha indirecta, que es la que se recoge en los casos e informes.

*<mark style="color:orange;">En ese momento no existía módulo de catalogación, no había equipo de curaduría, no había metabuscador, no había Omeka... nada de eso; el repositorio que había era el de las entrevistas. Entonces, lo que hicimos fue solicitarle a los ingenieros del módulo que nos generaran un espacio dentro de la herramienta para resguardar los informes y casos Eso de manera técnica y de manera conceptual, porque la labor de escucha son dos caras de una misma moneda: la escucha directa, cuando las víctimas vienen y nos hablan, y nosotros escuchamos de manera eventual o buscamos en las territoriales las entrevistas; pero también se concibe en la Comisión que los informes y casos son otra manera de escuchar a las personas de las organizaciones o instituciones que dicen "no, quizás yo no quiero hablar con la Comisión como entrevistado, pero sí le voy a presentar un informe"...</mark>*

Con respecto al manejo de los casos e informes, surgen algunos aspectos fundamentales a tener en cuenta: la clasificación de la información, el diligenciamiento de los metadatos y la categorización a partir de los núcleos y el mandato. Según el equipo de monitoreo, para este proceso es menester, por un lado, tener conocimiento sobre cuáles son los núcleos y a qué le apunta cada uno de los puntos del mandato; y, por otro lado, contar con el tesauro o guía para un vocabulario controlado a fin de focalizar y precisar los términos usados para la catalogación.

*<mark style="color:orange;">Por ejemplo, si no sabes a qué hace referencia en el mandato Dinámicas de la guerra, no lo puedes mandar ahí, porque no está funcionando... o cosas por el estilo. Funciona igual para los núcleos; hay un núcleo que se llama Sociedad, cultura y conflicto armado, que me costó bastante entender porque fue de lo último que surgió... y es como “bueno, qué va aquí”. Hay que tener el conocimiento previo para poder clasificar eso...</mark>*

En este sentido, señala el equipo, es importante estudiar a profundidad ambos procesos; en últimas, entender cómo funciona la Comisión ya que allí se instaura el fundamento de dicha categorización: ¿qué entiende la Comisión por Dinámicas de la guerra?, ¿qué entendemos por cultura?, ¿qué referencia hace con sociedad?

Ahora bien, adicional al manejo de los casos e informes, el equipo de monitoreo tuvo un papel fundamental en la estructuración, a *posteriori*, del módulo; es decir, en sus manos estuvo todo el testeo del aplicativo con el fin de generar una mejor experiencia de usuario. En este sentido, establecieron un lenguaje colectivo con los ingenieros desarrolladores quienes ya contaban con experiencias previas en otras comisiones de verdad, y tenían un conocimiento vasto en temas de conflicto y recolección de datos cualitativos. Todo ello implicó un acercamiento favorable entre ambos lenguajes ya que, según el equipo de monitoreo, el ingeniero líder supo traducir muy bien lo que se le preguntaba y sugería.

*<mark style="color:orange;">Yo le preguntaba: “necesitamos saber las fechas y lugares de las entrevistas cruzadas con no sé qué...”, (un cruce de variables); y me respondía: “listo, te lo voy a desarrollar”. Entonces, era a través de estas preguntas... y el ingeniero fue muy bueno en interpretarlas y volverlas funcionalidades de la herramienta...</mark>*

Resultado de estos procesos de testeo han sido las funcionalidades de consulta que han facilitado las labores de investigación: las visualizaciones, la buscadora, los filtros y la clasificación y marcación de información. Sin embargo, son funcionalidades que, como el mismo equipo de desarrollo señala, pueden mejorarse en proyectos futuros donde el aplicativo crezca, ya que la misión original de la herramienta fue especializarse en resguardar información más que en consultarla (es el [metabuscador ](https://docsmetabuscador.comisiondelaverdad.co/)la herramienta pensada para este propósito).

#### Logros y expectativas

Según el equipo de monitoreo, el logro más grande de la herramienta es el acopio de información. No obstante, es importante tener presente una ruta clara para que los diferentes grupos que conforman una organización realicen la tarea de acopio. Una de las dificultades que señala el equipo es, precisamente, lograr que cada dependencia cargue sus informes a la herramienta.

Ahora bien, como expectativas el equipo señala la posibilidad de mejorar los procesos de consulta y búsqueda. Debido a los tiempos de la Comisión de la Verdad, se priorizó el desarrollo del metabuscador dejando que el módulo de escucha se especializara en una tarea fundamental: el acopio del proceso de escucha; no obstante, diversos equipos señalan que sería importante contar con una buscadora más robusta, con un mayor cruce de variables y visualizaciones, entre otros aspectos relacionados con la consulta de información. Dichas posibilidades de mejora concuerdan con lo planteado por los ingenieros desarrolladores [Desarrolladores](/idiosincrasia-proyecto/desarrolladores-idiosincrasia-proyecto#por-que-se-ha-creado-una-buena-herramienta).

Finalmente, y según el equipo de monitoreo, la herramienta es potente en tanto ha conformado una base de datos importante en función de la población que nunca había hablado; en este sentido, la escucha se ha nutrido de una diversidad de testimonios que, de otra manera, no hubieran salido a la luz. Este mismo aspecto le imprime un valor adicional a la herramienta y a la entidad: salvaguardar la vida de las personas que decidieron romper el silencio en función del esclarecimiento, la reconciliación y la no repetición.

*<mark style="color:orange;">Hay organizaciones que no van a entregar su información sino a la Comisión; hay organizaciones, comunidades, personas que no han hablado con nadie más, sino solo con la Comisión porque conocen su misionalidad, su extrajudicialidad y su voluntad de esclarecimiento. Es una cosa muy abstracta, muy difícil de asir, pero tiene acogida cuando la gente la entiende. Ese va a ser el gran valor, y va a pintar un panorama complicado, distinto y profundo del conflicto hacia adelante en el tiempo...</mark>*


