código completo FLUJOS — snapshot limpio sin datos scrapeados

Incluye: backend Node.js/Express, visualización 3D (Three.js/3d-force-graph), scrapers Wikipedia/noticias/imágenes, analizador Qwen3-VL, pipeline maestro con systemd timer, fixes de seguridad (NoSQL injection, XSS, ReDoS, port binding) y documentación técnica completa en docs/. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-21 23:45:29 +02:00 · 2026-04-21 23:45:29 +02:00 · 83f67b76b4
commit 83f67b76b4
parent 013fe673f3
190 changed files with 193337 additions and 2 deletions
--- a/README.md
+++ b/README.md
@ -0,0 +1,116 @@
+# FLUJOS
+
+Software libre para analizar y visualizar flujos de información. Conecta noticias, documentos y eventos históricos para entender la historia como una sucesión de eventos y combatir la desinformación.
+
+---
+
+## Requisitos
+
+- Node.js >= 18.x
+- Python >= 3.11
+- MongoDB >= 6.x
+
+### Instalar MongoDB (Ubuntu/Debian)
+
+```bash
+sudo apt install -y gnupg curl
+curl -fsSL https://pgp.mongodb.com/server-6.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg --dearmor
+echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
+sudo apt update && sudo apt install -y mongodb-org
+sudo systemctl enable --now mongod
+```
+
+---
+
+## Instalación
+
+```bash
+git clone https://gitea.laenre.net/hacklab/FLUJOS.git
+cd FLUJOS
+git checkout production
+```
+
+### Variables de entorno
+
+```bash
+cp .env.example FLUJOS/BACK_BACK/.env
+```
+
+Edita `.env` con tus valores:
+
+| Variable    | Por defecto                   | Descripción                  |
+|-------------|-------------------------------|------------------------------|
+| `MONGO_URL` | `mongodb://localhost:27017`   | URL de conexión a MongoDB    |
+| `DB_NAME`   | `FLUJOS_DATOS`                | Nombre de la base de datos   |
+| `PORT`      | `3000`                        | Puerto del servidor          |
+
+### Dependencias Node.js
+
+```bash
+cd FLUJOS/BACK_BACK && npm install
+cd ../VISUALIZACION && npm install
+```
+
+### Dependencias Python
+
+```bash
+cd ../../FLUJOS_DATOS
+python3 -m venv myenv
+source myenv/bin/activate
+pip install transformers==4.10.0 tensorflow==2.17.0 scikit-learn==0.24.2 \
+            pandas==1.3.2 numpy==1.19.5 nltk==3.6.2 django obsei[all]
+python FLUJOS_DATOS/manage.py migrate
+```
+
+---
+
+## Arrancar
+
+```bash
+# Servidor principal
+cd FLUJOS/BACK_BACK && npm start
+
+# API Python (en otra terminal, con el venv activo)
+cd FLUJOS/BACK_BACK && python flask_api/app.py
+```
+
+Disponible en `http://localhost:3000`
+
+---
+
+## Base de datos
+
+La app lee de MongoDB (`FLUJOS_DATOS`). Las colecciones se pueblan con el pipeline de datos:
+
+```bash
+# 1. Scraping
+python FLUJOS_DATOS/NOTICIAS/main_noticias.py
+python FLUJOS_DATOS/WIKIPEDIA/main.py
+python FLUJOS_DATOS/TORRENTS/procesar_torrents.py
+
+# 2. Comparaciones
+python FLUJOS_DATOS/COMPARACIONES/pipeline_completo.py
+```
+
+Consulta `FLUJOS_DATOS/DOCS/` para más detalle.
+
+---
+
+## Estructura
+
+```
+flujos/
+├── FLUJOS/
+│   ├── BACK_BACK/       # Servidor Express + Flask API + OBSEI
+│   └── VISUALIZACION/   # Frontend (Three.js, force-graph)
+└── FLUJOS_DATOS/
+    ├── NOTICIAS/        # Scraper de noticias
+    ├── WIKIPEDIA/       # Extracción Wikipedia
+    ├── TORRENTS/        # Documentos WikiLeaks
+    ├── COMPARACIONES/   # Similitud entre documentos
+    └── DOCS/            # Documentación técnica
+```
+
+---
+
+*"Los gigantes vistos en perspectiva parecen marionetas."*