aleph

.. epigraph::

La verdad no puede penetrar una mente cerrada. Si todos los lugares del universo están en el Aleph, entonces todas las estrellas, todas las lámparas, todas las fuentes de luz están en él, también.

-- El Aleph <http://www.phinnweb.org/links/literature/borges/aleph.html>_, Jorge Luis Borges

⚠️ ESTADO DEL PROYECTO: CIERRE ⚠️ Nuestra participación en este proyecto de código abierto está siendo suspendida. El mantenimiento de esta versión finalizará oficialmente después de diciembre de 2025.

¿Por qué?

Esta decisión marca un cambio estratégico significativo para nosotros. Durante el último año, nuestro equipo reescribió completamente la base de código de Aleph desde cero para lanzar Aleph Pro. A medida que hacemos la transición a esta nueva plataforma compatible, estamos enfocando todos nuestros recursos en Aleph Pro para garantizar que podamos mantener las luces encendidas para investigaciones en todo el mundo.

Para obtener más detalles sobre esta decisión y lo que significa para el futuro, lea nuestras preguntas frecuentes oficiales <https://www.occrp.org/en/announcement/aleph-pro-frequently-asked-questions-on-the-future-of-occrps-investigative-data-platform/>__ .

Cronograma y Soporte

• Continuaremos brindando mantenimiento a este repositorio hasta el 31 de diciembre de 2025. Después de esta fecha, el equipo central no proporcionará más actualizaciones, correcciones de errores ni soporte.
• Para cualquier pregunta sobre la transición o el software heredado, comuníquese a través de nuestra comunidad Discourse <https://aleph.discourse.group//>__.
• Para aquellos que actualmente alojan sus propias instancias de Aleph, nos pondremos en contacto con ustedes muy pronto con respecto a la transición.
• Las organizaciones e individuos interesados en colaborar pueden comunicarse con [email protected].

¡Gracias! Estamos increíblemente orgullosos de lo que hemos construido hasta ahora. Gracias a todos los contribuyentes y miembros de la comunidad que ayudaron a construir este proyecto y creyeron en nuestra misión.

Acerca del software

Aleph es una herramienta para indexar grandes cantidades de datos tanto documentales (PDF, Word, HTML) como estructurados (CSV, XLS, SQL) para facilitar la navegación y la búsqueda. Está construida con el periodismo de investigación como caso de uso principal. Aleph permite hacer referencias cruzadas de menciones de entidades conocidas (como personas y empresas) con listas de vigilancia, por ejemplo, de investigaciones previas o conjuntos de datos públicos.

Para obtener más detalles sobre el software, cómo usarlo, instalarlo o administrar importaciones de datos, consulte la documentación en:

• https://docs.aleph.occrp.org
• Instalación: https://docs.aleph.occrp.org/developers/installation

Soporte

Aleph es utilizado y desarrollado por múltiples organizaciones e individuos interesados. Si está interesado en participar en este proceso, lea la política de soporte (SUPPORT.md), las reglas de contribución (CONTRIBUTING.md) y el código de conducta (CODE_OF_CONDUCT.md) y luego póngase en contacto:

• https://docs.aleph.occrp.org/get-in-touch

Desarrollo de Aleph

Si está buscando involucrarse en el desarrollo de Aleph, consulte el archivo CONTRIBUTING.md para obtener detalles sobre cómo comenzar.

⚠️ IMPORTANTE ⚠️ La rama predeterminada en este repositorio de GitHub es "develop". La rama develop contiene código no publicado e inestable. Para versiones estables, consulte la lista de versiones <https://github.com/alephdata/aleph/releases>_ o cambie a la rama main <https://github.com/alephdata/aleph/tree/main>_.

Proceso de lanzamiento

Si está interesado en, o se le ha encargado, lanzar una nueva versión de Aleph, debe seguir los siguientes pasos:

Resumen

El proceso básico para lanzar Aleph es este:

1. Verificar las bibliotecas internas en busca de actualizaciones y fusionar. Publicar nuestras bibliotecas en el siguiente orden
2. servicelayer
3. followthemoney
4. ingest-file
5. react-ftm
6. Asegurarse de que todas las bibliotecas para un lanzamiento estén actualizadas en aleph y fusionadas en la rama develop.
7. Asegurarse de que todas las funciones y correcciones de errores estén fusionadas en develop y que todas las compilaciones estén pasando.
8. Asegurarse de que el archivo CHANGELOG.md esté actualizado en la rama develop. Agregar información según sea necesario.
9. Crear un lanzamiento RC de Aleph.
10. Probar y verificar el RC. Realizar lanzamientos RC adicionales según sea necesario.
11. Fusionar todos los cambios en main.
12. Crear una versión final de Aleph.

En la medida de lo posible, aplicar las reglas de versionado semántico al determinar el tipo de lanzamiento a realizar.

Proceso técnico

Lanzamientos RC

Si necesita realizar un lanzamiento RC de Aleph, siga estos pasos:

1. Asegurarse de que el `CHANGELOG`` esté actualizado en la rama develop y que todos los PR pendientes se hayan fusionado.
2. Desde la rama develop ejecutar bump2version (major, minor, patch) esto creará una versión x.x.x-rc1 de aleph.
3. enviar las etiquetas al remoto con git push --tags
4. enviar el aumento de versión con git push
5. Si hay problemas con el RC, puede solucionarlos y usar bump2version build para generar un nuevo lanzamiento rc.

Lanzamientos major, minor, patch

1. cambiar a main y hacer pull desde el remoto
2. Si aún no se ha hecho, fusionar develop en main
3. Actualizar traducciones usando make translate
4. Si obtiene errores de npm, vaya a la carpeta ui y ejecute npm install
5. confirmar las traducciones en main y enviar al remoto
6. ejecutar bump2version --verbose --sign-tags release. Tenga en cuenta que bump2version no mostrará cambios cuando realice el cambio, pero funcionará (consulte git log para verificar)
7. enviar las etiquetas al remoto con git push --tags
8. enviar el aumento de versión al remoto con git push
9. fusionar main de nuevo en develop. Ligeramente no relacionado con el proceso de lanzamiento, pero es un buen momento para hacerlo para que los nuevos números de versión también aparezcan en .