# ARCHIVO
## ¿Qué es?
El archivo del esclarecimiento de la Comisión de la Verdad es un espacio donde confluye el archivo (conformado por todo el acervo documental acopiado por la institución), el discurso (representado en el Informe Final) y la acción (la posibilidad de crear narrativas desde otros puntos de vista y de enunciación). En este sentido, el archivo del esclarecimiento permite pensarse a sí mismo como repositorio vivo, a la vez que tiene la capacidad de poder activar procesos pedagógicos, creativos y de investigación futura.
## ¿Cuál es su historia?
Antes de que emergiera la idea de un archivo vivo, se había pensado en el proyecto de la biblioteca digital de la Comisión de la Verdad; sin embargo, es un proyecto que no encuentra mucha resonancia y, rápidamente, es abandonada la idea. Con ello, se empieza a mirar la posibilidad de crear el centro de documentación de la Comisión de la Verdad, el cual, según se determinó, iba a operar de manera física en el edificio de la entidad. La ejecución de este proyecto fue suspendido por dos razones: por un lado, la llegada de la pandemia por el virus SARS-CoV-2 llevó a la necesidad de pensar en escenarios virtuales y digitales; y, por otro lado, el área de Gestión Documental había licitado el programa GestionaDoc, el cual tenía, dentro de los términos de licitación, la construcción del centro de documentación de Gestión Documental. Ante este panorama, suena la idea de un museo (que había sido mencionada tímidamente en meses anteriores), a fin de producir dos frentes: la transmedia que, en su unidad mínima, contemplaba narrativas extendidas; y el museo que, en su unidad mínima, contemplaba colecciones.
En este sentido, la génesis del museo estuvo definida por tres objetivos principales: 1) almacenar, catalogar, curar y disponer copias de la información producida y consultada; 2) expandir a públicos masivos los procesos misionales de la Comisión de la Verdad, a través de formatos multiplataforma; y 3) posibilitar la continuación del esclarecimiento y la construcción de la convivencia a comunidades y territorios, a partir de la utilización de recursos y colecciones.
Finalmente, el nombre museo es cambiando a archivo del esclarecimiento, buscando mantener una identidad misional bajo el proyecto sombrilla transmedia; proyecto que impulsó la Comisión de la Verdad a partir del Informe Final.
# Entornos y metodologías
## Desarrollo
El desarrollo del archivo del esclarecimiento es un desarrollo original que parte desde cero. Construye sus propios organismos que interactúan entre sí para generar las páginas; y se apoya en Material-UI para el uso de moléculas y átomos preconstruidos.
### Tecnologías y arquitectura
**Para el FRONTEND:**
* ReactJS; versión 17.0.2
*
* Material-UI; versión 5.5
*
* Para definir las rutas se usa la librería [React-Router](https://reactrouter.com/docs/en/v6) (versión 6.2); con esta librería se define visualmente qué se muestra con base en la URL.
* Para el manejo del estado de las aplicaciones se usa la librería de JavaScript [Redux](https://es.redux.js.org/); con esta librería se busca que los estados queden persistentes.
* React-Redux; versión 7.2.6
* ReduxJS; versión 4.0.4
* Redux Persist; versión 6.0.0
Los archivos duck de Redux pueden ubicarse dentro de la aplicación en:
```
archivo-front/src/app/store/ducks
```
Para el archivo del esclarecimiento se usa `museo.duck`, dentro del cual está la variable central `activeCollection`.
{% hint style="info" %}
Para algunos desarrollos como los tableros de visualización, visualizaciones geográficas y/o interfaces experimentales de navegación, se utilizan Web Components. De esta manera, estos desarrollos independientes pueden ser definidos como recursos de la base de datos y/o pueden integrarse al frontend del archivo del esclarecimiento renderizándose mediante una arquitectura microfrontend.
{% endhint %}
**Para el BACKEND:**
* MongoDB
*
* Entorno de programación NodeJS; versión 14.16
*
* NestJS; versión 7.0.11 (backend basado en servicios; escrito en TypeScript versión 3.9.2)
*
*
* Para la indexación se utiliza ElasticSearch; versión 7.6.2
*
{% hint style="info" %}
Se usa MongoDB porque es la base de datos que se ha usado con el metabuscador de la Comisión de la Verdad, y es la que permite editar y agregar nuevo contenido; sin embargo, las consultas que se hacen al archivo del esclarecimiento reposan en el indexador ElasticSearch. En este sentido, toda la interacción y toda la recuperación de datos, se hace a través de este índice.
La decisión de este proceso se lleva a cabo en función de los tiempos de respuesta de ElasticSearch frente a MongoDB; en efecto, el indexador responde mucho más rápido a criterios de consulta complejos (como las búsquedas geográficas, por ejemplo).
{% endhint %}
**Tecnologías usadas en el módulo EDITA:**
* Para la creación de texto enriquecido, se usa la librería DraftJS; versión 0.11.7
*
* Para la creación de mapas, se usa la librería React Leaflet.js; versión 2.6.1
*
* LeafletJS; versión 1.6.0
*
* Para la edición de audios, se usa la librería WavesurferJS; versión 5.2.0
*
* Para visualizar la onda de audio, se usa la librería @foobar404/wave; versión 1.2.7
* Para el manejo de galerías, se usa la librería React Image Gallery; versión 1.2.7
{% hint style="warning" %}
El módulo EDITA es un módulo interno usado por la Comisión de la Verdad para crear colecciones temáticas a partir del acervo documental de la entidad. Para acceder a este módulo se requiere un perfil de creador de contenido, ya que no está disponible para la ciudadanía ni para la entrega. Se deja indicado en la documentación, ya que hace parte del aplicativo para la creación de las colecciones que son visibles en el home del archivo del esclarecimiento.
{% endhint %}
:heavy\_check\_mark: **Arquitectura orientada a servicios:** los desarrolladores crean los servicios que luego son consumidos por la aplicación; esto con el fin de reutilizar servicios para los distintos componentes que se van creando. Adicionalmente, permite una identidad misional para todos los desarrollos de la Comisión de la Verdad. En el archivo del esclarecimiento, los servicios se encuentran ubicados en el backend en:
```
archivo-backend/-/tree/develop/src
```
Dentro de esta ruta, se puede encontrar `search.service.ts`; allí se ubica el subservicio `simpleMuseo`, que es el servicio que hace las búsquedas para el archivo del esclarecimiento.
Desde el frontend se hace el llamado a los servicios del backend; los controladores principales para este proceso son: `SearchService.js`, `BookmarkCollectionService.js`, `CollectionService.js`. Se pueden encontrar en:
```
archivo-front/-/tree/develop/src/services
```
:heavy\_check\_mark: **Scripts de procesamiento:** se utiliza [Python](https://www.python.org/doc/) para los script de procesamiento usados por la aplicación. El script `runtime.py` es el script que orquesta los demás. El orquestamiento se hace desde la plataforma Cloudera, y los script pueden encontrarse en la ruta:
```
sim-data-processing/-/tree/develop/procesado-general
```
### Metodologías
* **Modelo atómico:** bajo esta metodología se definen: páginas, organismos, moléculas y átomos, que luego pueden ser reutilizados en otros desarrollos. Todos los componentes del archivo del esclarecimiento desarrollado por la Comisión de la Verdad, usan esta misma estrategia con el fin de tener una estructura homogénea.
* **Programación Sprint Scrum:** con esta metodología se buscó priorizar desarrollos; cada desarrollador ayudó en esa priorización detectando elementos que debían ser prioritarios.
* Historias de usuarios
* Definición de tableros y actividades (sprint)
* 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.
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.
**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.
**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.
**Pruebas unitarias (Unit Testing):** es una buena práctica realizar pruebas para comprobar que fragmentos de código funcionan correctamente. Es un procedimiento que se lleva a cabo en casi todas las metodologías ágiles de trabajo. Consiste en aislar un fragmento de código y comprobar que funciona a la perfección. Se recomienda crear pruebas unitarias para aquellos módulos que se consideren prioritarios o fundamentales dentro del desarrollo.
**Uso de software para la gestión de versiones:** el uso de software para el control de versionamiento es fundamental, más si se trabaja de manera colaborativa en un mismo proyecto. El software de gestión de versiones usado por la Comisión de la Verdad es GitLab. Se recomienda usar GitLab y generar un flujo de trabajo por ramas (metodología GitFlow).
{% hint style="warning" %}
De acuerdo con la experiencia del equipo desarrollador, GitFlow, por sí solo, no es suficiente para evitar conflictos y/o borramiento de código dentro de un proyecto. Es necesario recurrir a los Merge request, con el fin de que una sola persona sea la encargada de identificar los conflictos y hacer las fusiones (merge) dentro de la rama principal.
[¿Qué es GitFlow?](https://www.atlassian.com/es/git/tutorials/comparing-workflows/gitflow-workflow) [¿Qué es Merge request?](https://docs.gitlab.com/ee/user/project/merge_requests/)
{% endhint %}
# Arquitectura DB
## Colecciones DataBase
#### Colecciones usadas en MongoDB
Estas colecciones son usadas por el módulo ARCHIVO para recuperar recursos de acuerdo con parámetros específicos de búsqueda (palabra clave, ubicación, línea de tiempo y/o metadatos). Adicionalmente, el módulo EDITA usa estas colecciones para asociar recursos, archivos y usuarios en las colecciones.
Estas colecciones son usadas por el módulo EDITA para almacenar los recursos seleccionados (CollectionBookmark), y para almacenar las colecciones creadas desde el módulo (Collection). Desde la colección Collection se recuperan los metadatos que van a ser gestionados desde el HOME para la renderización de las colecciones del archivo del esclarecimiento.
# Idiosincrasia del proyecto
Las herramientas digitales del Sistema de Información Misional de la Comisión de la Verdad, han sido desarrolladas *in house* a partir de proyectos de co-creación donde intervienen ingenieros desarrolladores y profesionales de otros equipos (por ejemplo, curaduría, apropiación y visualización de datos). En este sentido, una de las apuestas de la documentación es consignar los aprendizajes y conocimientos construidos con base en los procesos de desarrollo y co-creación; a esto hemos denominado como Idiosincrasia del proyecto. Tenemos, entonces, dos miradas: desde los desarrolladores y desde los equipos que ayudaron en la creación y concreción de la herramienta.
{% content-ref url="/pages/LiYLXgD9ZpTCCX8W8f2Z" %}
[Desarrolladores](/aspectos-generales/idiosincrasia-del-proyecto/desarrolladores)
{% endcontent-ref %}
{% content-ref url="/pages/ORQe44QC1ddiGvaBnVt5" %}
[Co-creación](/aspectos-generales/idiosincrasia-del-proyecto/co-creacion)
{% endcontent-ref %}
# Desarrolladores
El archivo del esclarecimiento de la Comisión de la Verdad es un archivo sobre Derechos Humanos cuyo principal propósito es posibilitar un escenario participativo donde la ciudadanía interactúe, genere diálogos y procesos de colaboración y co-creación alrededor del Informe Final; todo ello con el fin de aportar en la construcción y reconstrucción del tejido social potenciando la pluralidad de voces. Este propósito potencia la herramienta como un archivo vivo, lo cual es, en últimas, la gran apuesta del equipo.
{% hint style="success" %}
El aporte más grande al legado, adicional a ser una aplicación funcional donde se pueda consultar el acervo documental de la Comisión de la Verdad, es la idea explícita que planeta el aplicativo: la posibilidad de crear nuevas narrativas. En otras palabras, fomentar, no solamente la apropiación de las narrativas, sino la creación de otras narrativas, de otra forma de ver las cosas. En últimas es la posibilidad de que las mismas personas interpreten lo que ha ocurrido en Colombia, creando narrativas desde sus puntos de vista y sus lugares de enunciación.
{% endhint %}
### Aprendizajes, retos y experiencias
El desarrollo de la herramienta implicó el diálogo colaborativo con otras áreas de la Comisión de la Verdad. En este sentido, y de acuerdo con el equipo de ingenieros, una de las dificultades presentes durante este tipo de proyectos es la posibilidad de trazar una frontera clara entre el rol de cada profesional a la hora de armar una página web:
*Pasa que los usuarios creen que porque usan una página web ya entienden de cómo armar una página web. En un trabajo en equipo, cada quien hace de lo que más sabe… y a veces esa frontera no está tan clara cuando se habla de una página web; y eso es complejo, porque uno puede navegar páginas web, pero nadie se ha pensado tanto un menú como la persona que se encarga de hacer el menú o de desarrollar los menús. Hacer entender esa diferencia, en un trabajo en equipo, implica dejar que cada quien haga lo que sabe...*
Algunos ingenieros manifiestan que es muy común que los usuarios confundan el hecho de usar una aplicación, con el hecho de saber de usabilidad; dos cosas muy diferentes si se las mira desde la perspectiva del desarrollo. De acuerdo con esto, y según la experiencia de co-creación, uno de los aspectos clave para poder comunicar las ideas y generar puentes entre los distintos equipos, es el diseño de mockups. En efecto, y durante el proceso de desarrollo, fueron los mockups los que permitieron establecer un lenguaje común a través del cual fue evolucionando el proyecto.
Ahora bien, en proyectos tan grandes donde intervienen muchas personas en el proceso de co-creación y se estructuran flujos de trabajo tan complejos, se hace necesario desarrollar una comunicación competente donde cada proceso sea comprendido en su integralidad. De acuerdo con el equipo de ingenieros, uno de los retos que reviste gran importancia es el acercamiento al contexto y, por tanto, la relación directa que se pueda o no tener con aquellos que van a usar el producto:
*Algo por lo que pasamos los desarrolladores al inicio de este tipo de proyectos es que entramos sin conocer, sin contextualizar… y ese es el mayor reto que hemos tenido: entrar en contexto, entrar a aprender mucho de los conceptos que se llevan en la Comisión y, a partir de eso, entrar a desarrollar lo que se quiere. Lo más difícil, hasta ahora, ha sido eso: entrar en ese contexto, evaluar qué se ha desarrollado, cuáles son las tecnologías que se están desarrollando y aprender de los desarrollos de las demás personas, leerlos para poder utilizarlos o para poder entrar a modificarlos (...) Ahora bien, existe una dificultad no menor que tiene que ver con el hecho de no tener relación directa con los dueños o los que van a usar el producto, para saber y entender el panorama de cómo se están pensando el museo y cómo lo quisieran...*
De acuerdo con esto, uno de los mayores logros resaltados por el equipo es la posibilidad de aprehender conceptos no necesariamente anclados al lenguaje técnico de la ingeniería; conceptos que se vuelven fundamentales para desarrollar y plasmar proyectos complejos. No obstante, tener este nivel de abstracción y conceptualización requiere construir lenguajes comunes y establecer relaciones directas con personas ubicadas en niveles jerárquicos diversos, algo que a veces no se logra a cabalidad.
{% hint style="success" %}
Uno de los conceptos aprehendidos es el de colecciones: ¿Qué es una colección? Al acercarse a este concepto, se va teniendo un panorama mucho más claro de lo que es un archivo vivo de Derechos Humanos.
{% endhint %}
A nivel técnico, el desarrollo del archivo del esclarecimiento implicó algunos retos de ingeniería importantes:
:heavy\_check\_mark: El uso de ElasticSearch para los procesos de búsqueda e indexación, debido a que, por el alto número de recursos, las búsquedas hechas directamente desde la base de datos, sobre todo búsquedas especializadas (por ejemplo, búsquedas geográficas), generan un bajo rendimiento de la herramienta. Así lo plantea el equipo: *el archivo sí reposa mucho en el índice, en Elastic, porque el índice es muy rápido, y es justamente eso lo que buscamos; por el contrario, si uno quiere filtrar por geografía, haciendo unos filtros de Mongo, se puede, pero no es tan eficiente...*
:heavy\_check\_mark: El uso de Material para la interfaz gráfica, en función de generar una interfaz que fuera familiar a las personas del común y poder hablarle al mayor número posible de personas. Tal y como lo relata el equipo: *uno le habla a todo el mundo no reinventándose la rueda, sino viendo qué es lo que funciona y cómo lo usan… y así no sea nada novedoso, porque a veces también se mal interpreta, que si uno es artista, todo tiene que ser súper novedoso, y no… porque acá el objetivo es comunicar, o tratar de llegar al mayor número de gente, y yo no voy a llegar al mayor número de gente haciendo, por más que me guste y me divierta, interfaces complejas...*
Adicional a estas dos herramientas, el equipo enfrentó retos técnicos en otros momentos del desarrollo, como lo fue en el caso del módulo EDITA, donde fue necesario personalizar un reproductor que permitiera señalar y reproducir fragmentos de audio específicos (todos los reproductores están en función de reproducir el contenido, más no de poder señalar únicamente lo que se quiere reproducir): *la idea es que el usuario seleccione qué pedazo del audio quiere, lo seleccione y lo reproduzca; pero también, ya no en modo edición, sino en modo reproducción, era necesario poder reproducir solo el fragmento que ya había elegido el usuario...*
Finalmente, un reto importante viene dado por la manera en que se orquesta el desarrollo. Una de las dificultades que señalan los ingenieros, es la polifonía de voces a la hora de dirigir el desarrollo, y más en proyectos donde muchas personas intervienen en el proceso de co-creación. Es importante, según el equipo, definir quién es el director de la orquesta y sobre cuál lineamiento conducir el desarrollo de la aplicación, ya que la falta de consenso en los requerimientos implica que las funcionalidades se extiendan indefinidamente afectando la estabilidad del aplicativo. La programación bajo la [metodología Scrum](/aspectos-generales/entornos-y-metodologias#buenas-practicas) ha resuelto varios de estos problemas al posibilitar la centralización y priorización de requerimientos, de allí que sea considerada como una buena práctica.
### Aportes a la ciudadanía
El archivo del esclarecimiento, a través de su proceso de colecciones, permite seguir construyendo procesos de memoria en el país; en efecto, las colecciones recogen historias y las presenta de una manera idónea para que sean apropiadas por las comunidades y se logre contribuir a los objetivos de la Comisión: mostrar lo que sucedió y dar elementos para la no repetición. Es un proceso de memoria que puede contribuir a que se produzcan nuevos contenidos como proyectos audiovisuales o cinematográficos, que permeen la sociedad en función del esclarecimiento y la reestructuración del tejido social.
*Lo que hace justamente la memoria es garantizar que todas esas situaciones estén en el imaginario de las personas; y que en ese sentido conozcamos ese pasado y evitemos mantenerlo. Yo creo que el legado documental, en este caso, va a servir muchísimo. Me imagino que va a servir como complemento a otras construcciones...*
# Co-creación
Los equipos de apropiación, y de catalogación y curaduría, tuvieron un papel importante en el proceso de co-creación de la herramienta, en tanto los procesos pedagógicos y de coleccionamiento, juegan un rol relevante en la finalidad del aplicativo. En este sentido, ambos equipos construyeron diálogos comunes con el equipo de desarrollo, buscando crear una herramienta idónea para el legado de la Comisión de la Verdad.
## Experiencias: aprendizajes, retos y oportunidades
### Equipo de apropiación: transferencia y pedagogía
Una de las apuestas del equipo de apropiación es la activación del legado de la Comisión de la Verdad en los territorios, buscando que las comunidades y las diferentes organizaciones sociales se apropien del acervo documental y puedan generar nuevas narrativas y creaciones que entablen diálogos propositivos con el Informe Final, y se conviertan, a su vez, en herramientas para la cotidianidad y el quehacer de cada comunidad. En este sentido, la idea inicial del archivo del esclarecimiento estuvo atravesado por propuestas estructuradas bajo esta óptica: convertir el repositorio de la Comisión de la Verdad en un archivo vivo de Derechos Humanos.
De acuerdo con el equipo de apropiación, no fue una labor fácil aterrizar el propósito fundamental en la idea de una plataforma. Para ello, se requirió de varias sesiones de trabajo con profesionales de todo tipo (diseñadores, analistas, desarrolladores):
*Todo eso fue una ideación del SIM en pleno… todos poníamos la visión de los equipos, expectativas y proyecciones de la experiencia que habíamos tenido con relacionamiento externo; y ese es el resultado de todas esas sesiones...*
El primer paso en esta dirección fue un ejercicio de conceptualización. A partir de allí, según narra el equipo, siguieron sesiones para estructurar user journey, pensar públicos y proponer wireframe y toda la arquitectura de navegación. Ahora bien, el diálogo con los ingenieros implicó un intercambio en doble vía: entender el lenguaje de programación (para el equipo de apropiación) y entender las apuestas que implica la apropiación social del conocimiento (para el equipo de desarrollo). De acuerdo con esto, un punto que jugó a favor en el flujo comunicativo entre ambos equipos, tiene que ver con el fácil acoplamiento del equipo de apropiación a la lógica de programación y desarrollo, en tanto ya contaban con una experticia en temas tecnológicos (conocimientos de backend, frontend, programación orientada a objetos en R); adicionalmente, y según el mismo equipo, al estar constantemente interactuando con personas y usuarios, se hacía feedback al equipo de desarrollo de manera continua. No obstante estas ventajas, el equipo señala que fue durante estos procesos de retroalimentación que surgieron algunos inconvenientes producto del carácter itinerante de la Comisión: en algunas ocasiones lo urgente imperaba sobre lo importante:
*Fueron discusiones acaloradas… porque ellos decían que no tenían tiempo de hacerlo; y fueron cosas que nosotros habíamos leído de los usuarios, y creo que eso pudo haber mejorado muchos de los requerimientos que nos llegaba a nosotros… porque a nosotros nos tocaba aterrizar muchas de las cosas: que no era fácil de usar, que no se entendía y cosas así. Sabíamos que con solo cambiar textos que estaban puestos, podía mejorar un poco la experiencia… y desde la apropiación, nos pensamos muchas cosas que podrían haberse pensado desde cero...*
De acuerdo con este aspecto, uno de los puntos críticos resaltados por el equipo de apropiación, es la necesidad de adaptar los textos en función de las experiencias de usuario. En este sentido, indican, es importante estructurar técnicas de wireframing desde el momento cero, desde que se hacen los mockups y los diseños. De este modo, por ejemplo, el tema de los textos estarían presentes en las decisiones de priorización, ya que, para que pueda existir una buena experiencia de usuario, no basta solo con poner los textos "bonitos", sino que es necesario pensar en las palabras clave que debe tener ese texto y en la naturaleza que todo ello encierra. Entonces, no son simplemente textos:
*Para nosotros es la base de una buena experiencia que puedan tener los usuarios, y así es en todo actualmente... no sirve una persona que solamente sepa escribir, sino una persona que sepa leer estadísticas, leer a los usuarios, que sepa de diseño e interfaces y, al mismo tiempo, pueda conversar con el desarrollo. Nosotros teníamos todas esas cualidades, y sentimos que fueron muy desaprovechadas… por la urgencia, por las prioridades que había que atender desde la misionalidad. Entonces, mostrar avances a Diálogo Social de tal cosa, eso se comía al equipo de desarrollo, y tocaba tomar decisiones de urgencia; y lo urgente, a veces, dejó relegado lo importante. Eso no nos permitió tener una línea editorial base para tener esa escritura de esa experiencia de usuario dentro de la interfaz...*
Mediar entre ambas consideraciones es un aspecto metodológico que debe aparecer en el momento mismo de la planeación para que pueda existir un flujo de trabajo que de respuesta tanto a lo urgente como a lo importante. Es un proceso de entendimiento mutuo, porque si bien es importante la herramienta funcional para la investigación, también es importante considerar elementos de usabilidad con el fin de que pueda ser apropiada y usada en toda su complejidad. En otras palabras, la apropiación implica un proceso que debe ser considerado desde el principio, con el fin de que pueda hacer parte del flujo de desarrollo de herramientas y aplicaciones; de esta manera, se podría garantizar que la herramienta, en su uso, se potencie.
En últimas, el enfoque de apropiación va en función de las experiencias de usuario; es decir, lograr que haya una interfaz amigable, sin muchos pain points o puntos de dolor para que no sea frustrante la navegación para los usuarios finales. En otras palabras, y siguiendo lo relatado por el equipo, si una herramienta no cuenta con una valoración en términos de experiencias de usuario, por más potente que sea, va a ser difícil que una persona de algún territorio, que sí tenga acceso a internet y que tenga unos conocimientos de tecnología muy básica o muy poca, la use. Lo más importante es cómo se le habla a la gente.
Otra de las expectativas que deja el equipo y puede ser considerada una posibilidad de mejora de la herramienta, es la necesidad de desarrollar indicadores objetivos para que las estadísticas de navegación no se queden en la subjetividad de unos pocos administradores. Los indicadores proveen insumos para seguir mejorando la interfaz y para tomar decisiones sobre contenidos nuevos, sobre nuevas interacciones con la comunidad.
### Aportes a la ciudadanía
De acuerdo con el equipo de apropiación, el acervo documental es lo más valioso que dejó la Comisión de la Verdad, en tanto es una herramienta que propicia escenarios de diálogo, construcción y movilización dentro de comunidades, personas y público en general. En otras palabras, si bien el Informe Final invita a una reflexión y a un acercamiento, son los instrumentos, los materiales, los insumos, los que permiten a la comunidad activar búsquedas para sus diversas demandas y/o trabajos de convivencia:
*Las bases de datos que nunca el Estado liberó y que la Comisión de la Verdad deja a disposición, anonimizadas y con un trabajo previo, son muy importantes para la rama de abogados, víctimas que están buscando reparación. Ahí es donde se da todo el panorama de distintos tipos: de reflexión, de movilización, de acción social, judicial, de verificación; ahí pueden ir las personas a ver si algo es cierto o no, llegar desde su necesidad específica y explorar...*
Adicionalmente, el archivo del esclarecimiento permite, a través de colecciones temáticas, establecer búsquedas específicas y especializadas, con el fin de guiar diversos procesos de construcción de conocimiento; es decir, a través de estas colecciones se abona el terreno para exploraciones futuras y, en ese sentido, siempre va a haber algo qué hacer con la herramienta. Es de esta manera que se alienta el propósito fundamental del archivo: ser un archivo vivo de Derechos Humanos. En este sentido, el éxito en el tiempo se da a partir de lo vivo que se vuelva; de los usos que la gente haga de la herramienta que, por su misma naturaleza, serán usos cada vez distintos: bifurcaciones y adentramientos con preguntas distintas que permiten la construcción de planteamientos y narrativas múltiples.
En últimas, el archivo del esclarecimiento potencia y refuerza el Informe Final, en tanto permite una exploración de la verdad desde otros ámbitos y desde el punto de vista de cada persona; es decir, el archivo del esclarecimiento potencia la búsqueda de verdades plurales.
# Descripción del módulo
Conjunto de filtros y herramientas que permiten explorar los recursos con los que cuenta el archivo del esclarecimiento.
El ARCHIVO permite navegar por todos y cada uno de los recursos que ha dispuesto la Comisión de la Verdad a la ciudadanía, ya sea por geografía, por línea de tiempo, por palabra clave o por metadatos.
## Tareas del ARCHIVO
El ARCHIVO permite realizar búsquedas a través de tres posibilidades:
### 1) Palabras clave.
Es la forma tradicional de realizar búsquedas en un archivo digital. Adicionalmente, el módulo permite filtrar por el tipo de archivo: si se quiere un audio, un video, un documento, una fotografía, etc. En este sentido, por ejemplo, si se pone en palabras clave "presidentes de Colombia", seleccionando en tipo de archivo audio, se pueden escuchar audios de expresidentes de la república.
### 2) Ubicación.
El filtro por ubicación fomenta el uso territorial del acervo documental. Esta funcionalidad permite, a través de un mapa, explorar qué tipo de contenido se ha producido en una zona geográfica específica (dónde se concentran los resultados, por ejemplo); y filtrar por departamentos y municipios para realizar búsquedas.
### 3) Línea de tiempo.
La línea de tiempo contiene búsquedas sobre unas bases de datos específicas las cuales contienen cronologías sobre diferentes sucesos. Es posible buscar, por ejemplo, "falsos positivos", y allí explorar la línea de tiempo que tiene asociada. En este sentido, la línea de tiempo proporciona un contexto histórico sobre búsquedas específicas, y permite ubicar periodos puntuales para ajustar la búsqueda a criterios más precisos.
{% hint style="info" %}
El ARCHIVO parte del hecho de que la persona no sabe qué está buscando; en este sentido, fomenta la exploración sugiriendo diversas formas de búsqueda que guíen al usuario a través de diversas posibilidades que vayan perfilando criterios de navegación más acotados. Por ejemplo, un usuario puede iniciar sus búsquedas filtrando por ubicación *¿Qué existe sobre el conflicto en el lugar que yo vivo?*
{% endhint %}
Adicionalmente, los resultados tienen la posibilidad de ser visualizados a partir de diferentes formatos:
**1. Recuperación de recursos**
**2. Concentración de búsqueda por ubicación**
**3. Concentración de búsqueda por temporalidad**
**4. Concentración de búsqueda por metadatos**
{% hint style="info" %}
Estas vistas son generadas a partir de análisis textuales; permiten al usuario ubicarse en la búsqueda, con el fin de que pueda centralizar los resultados y dirigir la exploración.
{% endhint %}
# Requerimientos
## Limitaciones y alcances
:heavy\_check\_mark: El ARCHIVO, más allá de limitaciones tiene unos alcances importantes. Material-UI es una librería gráfica con componentes que son usados en las aplicaciones de Google; en este sentido, la interfaz del aplicativo es amigable, en tanto los usuarios conocen estos mismos íconos y componentes en aplicaciones como YouTube o WhatsApp, o los reconoce de manera inconsciente por el uso de Android o del iPhone.
Para conocer más sobre los entornos de programación usados revisar:
{% content-ref url="/pages/SpLdvcPsMq8IGTs0Mxv0" %}
[Entornos y metodologías](/aspectos-generales/entornos-y-metodologias)
{% endcontent-ref %}
:heavy\_check\_mark: La infraestructura influye en el rendimiento del aplicativo; en este sentido, es importante evaluar la infraestructura en la que reposa el archivo del esclarecimiento con el fin de mejorar el rendimiento.
:heavy\_check\_mark: La estandarización de datos es un reto técnico importante. Se tienen dos tipos de estandarización: la estandarización de datos desde la base de datos, lo cual implica que el manejo de campos para todos los recursos sea igual, con el fin de evitar conflictos a nivel de la interoperabilidad y las búsquedas. Segundo, estandarizar los formatos de los archivos (en formatos web), con el fin de que audios, videos e imágenes sean soportados en diferentes entornos y/o dispositivos, y se mejoren los tiempos de respuesta del aplicativo. Los formatos manejados son:
* Documentos: PDF
* Videos: MP4, WEBM, OGV
* Audios: MP3, OGG
* Visualizaciones: JS
Adicional al proceso de conversión, los archivos son movidos a una carpeta específica definida para los recursos del archivo del esclarecimiento. Esta estandarización se realiza a través del script `procesadoSoporte.py`. Para verificar los script de procesamiento revisar [Entornos y metodologías](/aspectos-generales/entornos-y-metodologias#tecnologias-y-arquitectura).
{% hint style="info" %}
Gracias a este proceso de estandarización de datos, el aplicativo carga de manera fácil y rápida. Es un desarrollo pensado para que sea liviano y pueda ser desplegado desde cualquier dispositivo.
{% endhint %}
:heavy\_check\_mark: La calidad de los recursos almacenados se convierte en un aspecto importante que debe ser resaltado; en este sentido, debe definirse qué recursos y de qué tipo van a disponerse en el repositorio, con el fin de que la recuperación de información dentro de la exploración, arroje realmente resultados que promuevan la lectura. En últimas, se trata de definir un punto central que estructure qué puede ser usado y qué no. La Comisión de la Verdad, ha definido una serie de recursos que pueden ser públicos y, con base en ellos, ha generado una serie de colecciones con el fin de que haya una mayor profundidad en la exploración.
{% hint style="warning" %}
Si se quiere replicar el proyecto en otra entidad, es importante resaltar este aspecto fundamental, ya que, técnicamente, el aplicativo puede funcionar muy bien; sin embargo, sin un adecuado ejercicio curatorial, puede no ser amigable al usuario final. Tanto el trabajo técnico como el trabajo curatorial deben ir de la mano.
{% endhint %}
:heavy\_check\_mark: Es importante desarrollar pruebas de usabilidad con diferentes usuarios (internos y externos), con el fin de identificar aspectos que puedan mejorarse. Al cierre de esta documentación, las pruebas de usabilidad solo se han hecho con usuarios de la Comisión de la Verdad.
{% hint style="success" %}
Es importante resaltar que la idea que subyace al archivo del esclarecimiento, si bien no es revolucionaria en el sentido de que existen otros archivos digitales y otros museos que permiten la creación de narrativas, sí se instaura como un archivo de Derechos Humanos mucho más amigable a los usuarios. En efecto, y gracias a la interfaz que utiliza, potencia e incita a la exploración de los recursos dispuestos en el repositorio o en las colecciones. Es la interfaz, junto con los ejercicios de apropiación, lo que hace que haya un punto de quiebre con los demás archivos de Derechos Humanos que existen en el país. Un aplicativo no puede centrarse solamente en la funcionalidad; igual de importante es la experiencia de usuario.
{% endhint %}
## Posibilidades de mejora
:heavy\_check\_mark: Una posibilidad de mejora de la herramienta en sentido general, tiene que ver con la creación de bifurcaciones sobre las colecciones particulares; es decir, que se pueda generar un espacio para que se construyan nuevas versiones sobre las colecciones existentes. Esta mejora permite, eventualmente, la emergencia de voces diferentes que construyan su propio punto de vista sobre una narrativa particular, sin la necesidad de modificar la versión original. En otras palabras, lo que se busca es que las personas puedan apropiarse de una exposición y modificarla proponiendo otras maneras de ver y de narrar; en últimas, buscar una "democratización de las narrativas".
{% hint style="info" %}
Esta mejora va de la mano con la posibilidad de abrir la creación de narrativas a un público no experto, y la posibilidad de desarrollar el módulo EDITA para que sea factible crear colecciones de manera colaborativa. Adicionalmente, y al apuntar a un proceso de bifurcación y co-creación, es importante sistematizar y hacer seguimiento a la mutación de las narrativas para garantizar una trazabilidad de los cambios.
{% endhint %}
Todas las búsquedas, los filtros y las visualizaciones que estructuran el módulo principal del archivo del esclarecimiento, se configuran desde `bloqueBusqueda`. A este bloque se puede acceder, desde el repositorio, a través de:
```
visualizaciones-de-datos-sim/sim-ui/-/tree/feature/museo-develop/organisms/bloqueBusqueda
```
Otro archivo importante es el componente `TarjetaDocumento.js`; a través de este componente se desprenden los recursos que el usuario visualiza en la vista de resultados (desde allí se puede ver, por ejemplo, qué compone a un recurso: un video, un audio, una imagen, etc.). La tarjeta, como componente, es usada en todo el desarrollo del archivo del esclarecimiento (carga con un distintivo dependiendo del lugar desde donde sea llamado el componente). Su ubicación se da en el directorio:
```
sim-frontend/src/app/sim-ui
```
Todos los llamados que hace este archivo se configuran en `extraCard`; este bloque puede ubicarse, desde el repositorio, a través de:
```
visualizaciones-de-datos-sim/sim-ui/-/tree/feature/museo-develop/organisms/extraCard
```
# Descripción del módulo
El módulo EDITA del archivo del esclarecimiento, es el módulo que permite construir narrativas y contar historias a partir de los recursos que ha coleccionado la Comisión de la Verdad.
El módulo EDITA tiene dos objetivos fundamentales: primero, crear una historia o una narrativa a partir de una serie de recursos, con el fin de que el lector se interese en las perspectivas de las personas que han estado detrás del proceso de investigación de la Comisión de la Verdad. Segundo, brindar una serie de recursos, organizados por catálogos, sobre un tema específico.
Este módulo es uno de los componentes principales del archivo del esclarecimiento, en tanto es la herramienta que permite la construcción de narrativas a partir de los recursos disponibles en el acervo documental legado por la Comisión de la Verdad.
## Usuarios
El módulo cuenta con los siguientes usuarios:
* **Creadores:** usuarios encargados de crear contenido dentro del módulo. Para la entrega no se dispondrán creadores externos.
* **Lectores:** aquellos usuarios que van a visualizar los catálogos y las narraciones creadas en el módulo. Para la entrega, este perfil es abierto a la ciudadanía en general.
## Tareas del EDITA
## 1) Gestor narrativas
El gestor de narrativas es la funcionalidad que permite crear y armar las colecciones dentro del módulo EDITA. Esta funcionalidad cuenta con tres procesos:
### **a) Descripción de la colección.**
Es una tarea que permite describir, en términos generales, una colección particular; en este sentido, por ejemplo, se puede agregar una portada, un título y una descripción; adicionalmente, cuenta con campos para definir el lugar de creación, los creadores de la colección y el tema que engloba la colección (que apunta a los mandatos de la Comisión de la Verdad y a los temas dispuestos por la red de aliados). Por colección se debe entender el conjunto de recursos que arman un catálogo o una narrativa.
### **b) Contenedor de recursos.**
Esta funcionalidad es la que permite añadir recursos a la colección que se quiere crear. Allí se puede seleccionar qué tipo de elemento se quiere: todo el recurso, solo un fragmento de texto, audio o video, un documento o una galería particular, o elementos de externos embebidos (plataformas como YouTube, Spreaker, ArcGIS online, contenidos digitales de la Comisión de la Verdad, etc.). Adicionalmente, el contenedor permite ir agregando textos narrativos que vayan tejiendo una relación entre los elementos agregados. La búsqueda de los recursos que pueden agregarse al contenedor se da a través del módulo ARCHIVO, o a través de recursos ya coleccionados en Mi Biblioteca.
### **c) Caracterización.**
Esta funcionalidad permite definir términos clave, la georreferenciación y la línea de tiempo del conjunto de recursos agregados a la colección. En los tres casos, la caracterización es heredada de los metadatos que tienen los recursos agregados. Pueden modificarse agregando o eliminando características: en términos clave, se pueden agregar términos propios; en la georreferenciación, se pueden agregar nuevos puntos de interés; y se puede modificar la línea de tiempo que viene, por defecto, heredada de los recursos.
### Visualización de colecciones
Las colecciones serán visibles en el home del archivo del esclarecimiento. Se organizan de manera aleatoria cada vez que la página sea refrescada. Al ingresar a cada colección, se pueden visualizar los recursos asociados y los conectores conceptuales que los relacionan.
## 2) Mi Biblioteca
Es una funcionalidad que almacena los recursos que se han seleccionado desde el módulo ARCHIVO. Este espacio es fundamental para la creación de colecciones. Al igual que todo el módulo, esta funcionalidad no está dispuesta al público general.
# Requerimientos
## Limitaciones y alcances
:heavy\_check\_mark: En términos generales, la infraestructura está soportada; sin embargo, hay que hacerle, constantemente, pruebas de rendimiento. La base de datos, en ocasiones, se demora en responder a las peticiones. El indexador de búsqueda se encuentra optimizado.
:heavy\_check\_mark: El aplicativo contiene reproductores de audio y video; de acuerdo con esto, es importante unos mínimos de RAM y de procesador con el fin de que haya un óptimo rendimiento.
:heavy\_check\_mark: Otra limitante viene dada por el peso de los recursos almacenados en los servidores; hay documentos muy grandes, y eso puede afectar el rendimiento de la aplicación. Adicionalmente, aquellos recursos que son externos (enlaces, videos embebidos, etc.), si se pierden o se dañan, cortan el flujo de la narrativa.
## Posibilidades de mejora
:heavy\_check\_mark: La herramienta puede mejorar la creación de narrativas a partir del diseño de visualizaciones personalizadas; por ejemplo, la posibilidad de crear gráficos, tablas o mapas a partir de la información agrupada en el contenedor de recursos. Al cierre de esta documentación, lo que se puede agregar al contenedor son visualizaciones de datos y contenido digital que ya la Comisión de la Verdad ha creado en aplicaciones particulares.
:heavy\_check\_mark: Se puede desarrollar aún más el módulo con el fin de que sea posible co-crear colecciones. Al cierre de esta documentación, la herramienta no permite crear colecciones de manera colaborativa; cada usuario crea su propio espacio.
:heavy\_check\_mark: Se puede implementar un buscador conceptual que recupere los recursos que han sido agrupados en las diferentes colecciones. El aplicativo recupera recursos a partir de metadatos y palabras clave; sin embargo, no hay un buscador desarrollado que devuelva los conectores lógicos y las relaciones que los curadores han construido para cada una de las colecciones. Asimismo, es una posibilidad que permite identificar en qué colecciones está determinado recurso, con el fin de perfilar líneas de investigación:
*Podría expandir esas posibilidades del archivo y decirle: muéstreme con qué otros recurso se relaciona este, más a nivel conceptual... y sería ir a buscar en qué colecciones están usando este recurso y con qué otro recurso sale relacionado dentro de esas colecciones. Eso es otro nivel de relación del archivo. Es decir, el archivo crea relaciones entre recursos por metadatos, por ubicación, por franja de tiempo, etc.; sin embargo, esta posibilidad permite generar una capa adicional: una relación conceptual entre los recursos...*
{% hint style="warning" %}
Es necesario tener presente que estas posibilidades de mejora aplican solamente si se quiere mejorar el proyecto en el mediano y en largo plazo; la entrega que realiza la Comisión de la Verdad no contempla disponer este módulo a la ciudadanía. Las colecciones se crearon a través de un perfil especial, y no estará disponible para la entrega.
{% endhint %}
:heavy\_check\_mark: El archivo más importante dentro del desarrollo del módulo EDITA es`gestornarrativas.js`; dentro de esta página interactúan entre sí varios organismos y componentes que ayudan a formar la colección: se hace el llamado a los componentes que validan la colección, a los componentes de caracterización y a los módulos para crear el contenido de la colección. La mayoría de las acciones llegan a esta página para ser resueltas interactuando con la persistencia (es el orquestador). La ubicación de este archivo es:
```
sim-frontend/src/app/page/museo
```