New React frontend (Vite + shadcn/ui)

.dockerignore

@@ -0,0 +1,30 @@
+# Version control
+.git/
+.gitignore
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+.venv/
+
+# Node
+node_modules/
+
+# Dev tooling
+.pre-commit-config.yaml
+ruff.toml
+justfile
+.claude/
+
+# CI/CD & deployment configs
+.gitlab-ci.yml
+install/vagrant/
+
+# Documentation (not needed in image)
+*.md
+LICENSE
+
+# OS files
+.DS_Store
+Thumbs.db

.gitignore

@@ -116,3 +116,7 @@ outputs
 # Pyenv #
 #########
 .python-version
+
+# Dev virtualenv #
+###################
+.venv/

.pre-commit-config.yaml

@@ -0,0 +1,15 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.7
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

CLAUDE.md

@@ -0,0 +1,32 @@
+# iKy - OSINT Tool
+
+## Project Structure
+
+- `backend/` — Python 3.12 Flask + Celery backend
+- `frontend/` — Angular frontend
+- `install/docker/` — Dockerfiles and compose config
+
+## Coding Style
+
+All Python code MUST comply with the project's `ruff.toml` configuration:
+
+- **Formatter**: ruff format (black-compatible), line-length 88, target py312
+- **Linter rules**: E, F, W (pycodestyle/pyflakes), I (isort), B (bugbear), UP (pyupgrade), SIM (simplify), C4 (comprehensions), A (builtins), RUF (ruff-specific)
+- **Ignored**: E203 (black-compatible whitespace), E501 (line length handled by formatter)
+- **Tests**: S101 (assert usage) is allowed in `**/tests/**`
+
+When writing or modifying Python code:
+
+1. Use modern Python 3.12 idioms (f-strings, `|` union types, `match`, etc.)
+2. Keep lines at 88 chars max
+3. Sort imports with isort style (stdlib, third-party, local — separated by blank lines)
+4. Prefer list/dict/set comprehensions over map/filter
+5. Avoid shadowing Python builtins (rule A)
+6. Use `pathlib.Path` over `os.path` where practical
+
+## Dev Workflow
+
+- `just setup` — create `.venv/` with pre-commit and ruff (pinned to match pre-commit config)
+- `just lint` / `just fmt` — check or auto-fix with ruff from the venv
+- `just build` / `just up` / `just down` — Docker lifecycle
+- `just test` — run pytest inside the backend container

README.es.md

@@ -6,11 +6,12 @@
 
 <div align="center" style="margin-bottom: 10px;">
     <img alt="Redis" src="https://img.shields.io/badge/storage-redis-red.svg?style=for-the-badge">
-    <img alt="Python" src="https://img.shields.io/badge/python-3.9-informational.svg?style=for-the-badge">
+    <img alt="Python" src="https://img.shields.io/badge/python-3.12-informational.svg?style=for-the-badge">
     <img alt="Celery" src="https://img.shields.io/badge/multiprocessing-celery-green.svg?style=for-the-badge">
     <img alt="Flask" src="https://img.shields.io/badge/interface-flask-yellowgreen.svg?style=for-the-badge">
-    <img alt="Node" src="https://img.shields.io/badge/node-12.x-brightgreen.svg?style=for-the-badge">
-    <img alt="Angular" src="https://img.shields.io/badge/web%20framwork-angular%207-red.svg?style=for-the-badge">
+    <img alt="Node" src="https://img.shields.io/badge/node-22.x-brightgreen.svg?style=for-the-badge">
+    <img alt="Angular" src="https://img.shields.io/badge/web%20framework-angular%208-red.svg?style=for-the-badge">
+    <img alt="Docker" src="https://img.shields.io/badge/deploy-docker-blue.svg?style=for-the-badge&logo=docker">
 </div>
 
 <!--
@@ -34,9 +35,9 @@
 
 ---
 
-<div align="center">   
+<div align="center">
 
-[Descripción](#description)&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;[Instalación](#installation)&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;[Website][website]&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;[Módulos](#modules)&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;[Issues][issues]&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;[Supporting](#sponsor)
+[Descripcion](#description)&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;[Instalacion](#installation)&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;[Website][website]&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;[Modulos](#modules)&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;[Issues][issues]&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;[Supporting](#sponsor)
 
 </div>
 
@@ -52,8 +53,8 @@ Website References
 
 <h1 align="center">iKy</h1>
 
-<h1 id="description">Description</h1>
-El proyecto iKy es una herramienta que colecta información a partir de una dirección de e-mail y muestra los resultados en una interface visual.
+<h1 id="description">Descripcion</h1>
+El proyecto iKy es una herramienta que colecta informacion a partir de una direccion de e-mail y muestra los resultados en una interface visual.
 
 Visite el Gitlab Page del [Projecto](https://kennbroorg.gitlab.io/ikyweb/)
 
@@ -64,7 +65,7 @@ Visite el Gitlab Page del [Projecto](https://kennbroorg.gitlab.io/ikyweb/)
     <a href="https://vimeo.com/434501702">Video Demo</a>
 </div>
 
-<h1 id="modules">Módulos</h1>
+<h1 id="modules">Modulos</h1>
 
 <div align="center" style="margin-bottom: 10px;">
     <img alt="fullcontact" src="https://img.shields.io/badge/module-fullcontact-blue.svg?style=flat-square">
@@ -95,79 +96,116 @@ Visite el Gitlab Page del [Projecto](https://kennbroorg.gitlab.io/ikyweb/)
     <img alt="mastodon" src="https://img.shields.io/badge/module-mastodon-blue.svg?style=flat-square">
 </div>
 
-<h1 id="installation">Instalación</h1>
+<h1 id="installation">Instalacion</h1>
+
+### Prerequisitos
+
+- [Docker](https://docs.docker.com/get-docker/)
+- [Docker Compose](https://docs.docker.com/compose/install/) (incluido con Docker Desktop)
+- (Opcional) [just](https://github.com/casey/just#installation) ejecutor de tareas
 
-Se debe instalar Redis y encenderlo en una terminal
+### Inicio rapido
 
 ```shell
-wget http://download.redis.io/redis-stable.tar.gz
-tar xvzf redis-stable.tar.gz
-cd redis-stable
-make
-sudo make install
-cd ..
+git clone https://gitlab.com/kennbroorg/iKy.git
+cd iKy
+docker compose build
+docker compose up -d
 ```
 
-Vaya a nuestro [website][website]. Descargar el ZIP y descomprimirlo, instalar las dependencias y encenderlo en otra terminal
+O, si tiene `just` instalado:
+
+```shell
+just build
+just up
 ```
-unzip iKy.zip
-cd iKy-pack
-pip install -r requirements.txt
-cd backend
-python3 app.py -e prod
+
+Abra su navegador en [http://localhost:4200](http://localhost:4200)
+
+Para detener todos los servicios:
+
+```shell
+docker compose down
+# o
+just down
 ```
 
-Y finalmente, [browsearlo](#browse).
+<h1 id="development">Desarrollo</h1>
 
-<h3 id="browser">Browse</h3>
+El flujo de desarrollo utiliza un **virtualenv para linting/pre-commit hooks** y **Docker para compilar y ejecutar** la aplicacion.
 
-Abrir el browser en esta [url](http://127.0.0.1:4200)
+### Configurar el entorno de desarrollo
+
+Instale [just](https://github.com/casey/just#installation), luego:
+
+```shell
+just setup
+source .venv/bin/activate
+```
+
+Esto crea un virtualenv de Python con `pre-commit` y `ruff`, e instala los git hooks.
+
+### Recetas comunes
+
+| Comando | Descripcion |
+|---------|-------------|
+| `just build` | Compilar imagenes Docker |
+| `just up` | Iniciar todos los servicios |
+| `just down` | Detener todos los servicios |
+| `just logs` | Seguir logs del backend (`just logs frontend` para frontend) |
+| `just ps` | Mostrar contenedores en ejecucion |
+| `just shell-backend` | Abrir una shell en el contenedor del backend |
+| `just shell-frontend` | Abrir una shell en el contenedor del frontend |
+| `just lint` | Ejecutar ruff linter y verificacion de formato |
+| `just fmt` | Auto-formatear codigo Python |
+| `just restart backend` | Reiniciar un servicio especifico |
+| `just rebuild` | Detener, recompilar e iniciar todos los servicios |
+| `just clean` | Eliminar contenedores, volumenes e imagenes locales |
 
 # API Keys
 
-Una vez cargada la aplicación en el navegador, debería obtener la mayoría de las APIs y/o cookies de sesión del navegador.
-A continuación se muestra una tabla con todos los campos a rellenar
+Una vez cargada la aplicacion en el navegador, deberia obtener la mayoria de las APIs y/o cookies de sesion del navegador.
+A continuacion se muestra una tabla con todos los campos a rellenar
 
-|   **Módulo**   | **Status** | **Campo en apikey** | **Descripción** |
+|   **Modulo**   | **Status** | **Campo en apikey** | **Descripcion** |
 | :------------- | :--------: | :--------- | :--------- |
 | Fullcontact    | :octagonal\_sign: |  | Discontinuado |
-| PeopleDataLabs | :ok: | peopledatalabs\_key | :free: API **Free**. Explicado [aquí](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#peopledatalabs) |
-| Linkedin | :ok: | linkedin\_li\_at / linkedin\_JSESSIONID [\(***\)](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#postdata) | :free: Cookie browser(:cookie:) Metodo. Explicado [aquí](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#linkedin) |
-| Twitter        | :ok: | twitter\_user / twitter\_pass [\(***\)](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#postdata) | :free: Cookie browser(:cookie:) o usuario/password. Explicado [aquí](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#twitter) |
-| Instagram      | :ok: | instagram\_user / instagram\_pass [\(***\)](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#postdata) | :free: Cookie browser(:cookie:) o user/pass. Explicado [aquí](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#instagram) |
-| HaveIBeenPwned | :ok: | haveibeenpwned\_key |:heavy\_dollar\_sign: API **Paid**. Explicado [aquí](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#haveibeenpwned) |
-| Emailrep       | :ok: | emailrep\_key | :free: API **Free**. Explicado [aquí](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#emailrep) |
-| Leaklookup     | :ok: | leaklookup\_key | :free: API **Free**. Explicado [aquí](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#leaklookup) |
-| Spotify        | :ok: | spotify\_client\_id / spotify\_client\_secret | :free: API **Free**. Explicado [aquí](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#spotify) |
-| Twitch         | :ok: | twitch\_client\_id / twitch\_client\_secret | :free: API **Free**. Explicado [aquí](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#twitch) |
-| CSE (Google)   | :ok: | cse\_api\_key / cse\_cx |:free: API **Free**. Explicado [aquí](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#cse) |
+| PeopleDataLabs | :ok: | peopledatalabs\_key | :free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#peopledatalabs) |
+| Linkedin | :ok: | linkedin\_li\_at / linkedin\_JSESSIONID [\(***\)](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#postdata) | :free: Cookie browser(:cookie:) Metodo. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#linkedin) |
+| Twitter        | :ok: | twitter\_user / twitter\_pass [\(***\)](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#postdata) | :free: Cookie browser(:cookie:) o usuario/password. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#twitter) |
+| Instagram      | :ok: | instagram\_user / instagram\_pass [\(***\)](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#postdata) | :free: Cookie browser(:cookie:) o user/pass. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#instagram) |
+| HaveIBeenPwned | :ok: | haveibeenpwned\_key |:heavy\_dollar\_sign: API **Paid**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#haveibeenpwned) |
+| Emailrep       | :ok: | emailrep\_key | :free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#emailrep) |
+| Leaklookup     | :ok: | leaklookup\_key | :free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#leaklookup) |
+| Spotify        | :ok: | spotify\_client\_id / spotify\_client\_secret | :free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#spotify) |
+| Twitch         | :ok: | twitch\_client\_id / twitch\_client\_secret | :free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#twitch) |
+| CSE (Google)   | :ok: | cse\_api\_key / cse\_cx |:free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#cse) |
 | Reddit         | :warning: |  | En revision |
-| Tiktok         | :ok: |  | Obtenida de su browser preferido. Solo logueesé in tiktok |
+| Tiktok         | :ok: |  | Obtenida de su browser preferido. Solo logueese en tiktok |
 
 <h1 id="update">Actualizar iKy</h1>
 
-Debido a que el frontend de iKy está desarrollado en Angular, el cual se transpila, y un proceso de CI/CD lo empaqueta, lo mejor para la actualización es descargar iKy-pack del [website][website] y volver a ejecutar estos pasos
+Descargue los ultimos cambios y reconstruya las imagenes Docker:
 
-``` shell
-unzip iKy.zip
-cd iKy-pack
-pip install -r requirements.txt
-cd backend
-python app.py -e prod
+```shell
+git pull
+docker compose build
+docker compose up -d
 ```
 
-> No es necesario una reinstalación de redis
+O con `just`:
 
-Una vez completado lo anterior pueden copiar el archivo apikeys.json situado en backend/factories dentro del directorio de iKy desde la vieja instalación hacia la nueva instalación
+```shell
+git pull
+just rebuild
+```
 
-O pueden utilizar la interface gráfica en el menu de apikeys las opciones de Exportar/Importar (Exportar desde la vieja instalación e importar en la nueva instalación)
+Para preservar sus API keys entre actualizaciones, use las opciones de Exportar/Importar en el menu de apikeys de la interface grafica.
 
 <div align="center">
     <img alt="apis" height="400" src="https://kennbroorg.gitlab.io/ikyweb/assets/img/iKy-08.png">
 </div>
 
-O pueden utilizar una combinación de ambas (Lo mejor) utilizando la opción de importar desde la nueva instalación y buscando el archivo apikeys.json en backend/factories en el directorio de iKy de la vieja instalación
-
 # Wiki
 - [iKy Wiki](https://gitlab.com/kennbroorg/iKy/-/wikis/home)
 
@@ -179,27 +217,27 @@ O pueden utilizar una combinación de ambas (Lo mejor) utilizando la opción de
 </div>
 
 <h1 id="sponsor">Apoyar el proyecto</h1>
-Ya sea que use este proyecto, haya aprendido algo de él o simplemente le guste, por favor considere apoyarlo comprándome un café, para que pueda dedicar más tiempo a proyectos de código abierto como este.
+Ya sea que use este proyecto, haya aprendido algo de el o simplemente le guste, por favor considere apoyarlo comprandome un cafe, para que pueda dedicar mas tiempo a proyectos de codigo abierto como este.
 
 <div align="center" style="margin-top: 30px;">
 <a href="https://www.buymeacoffee.com/kennbro" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="80" ></a>
 </div>
 
 # Aviso Legal
 
-Todo aquel que contribuya o haya contribuído con el proyecto, incluyendome, no somos responsables por el uso de la herramienta (Ni el uso legal ni el uso ilegal, ni el "otro" uso). 
+Todo aquel que contribuya o haya contribuido con el proyecto, incluyendome, no somos responsables por el uso de la herramienta (Ni el uso legal ni el uso ilegal, ni el "otro" uso).
 
 Tenga en cuenta que este software fue inicialmente escrito para una broma, luego con fines educativos (para educarnos a nosotros mismos), y ahora el objetivo es colaborar con la comunidad haciendo software libre de calidad, y si bien la calidad no es excelente (a veces ni siquiera buena) nos esforzamos en perseguir la excelencia.
 
-Considere que toda la informacion recolectada está libre y disponible por internet, la herramienta solo intenta descubrirla, recolectarla y mostrarla.
-Muchas veces la herramienta ni siquiera puede lograr su objetivo de descubrimiento y recolección. Por favor, cargue las APIs necesarias antes de acordarse de mi madre.
-Si aún con las APIs no muestra cosas "lindas" que usted espera ver, pruebe con otros e-mails antes de acordarse de mi madre.
-Si aún probando con otros e-mails no ve las cosas "lindas" que usted espera ver, puede crear un issue, contactarnos por e-mail o por cualquiera de las RRSS, pero tenga en cuenta que mi madre no es ni la creadora ni contribuye con el proyecto.
+Considere que toda la informacion recolectada esta libre y disponible por internet, la herramienta solo intenta descubrirla, recolectarla y mostrarla.
+Muchas veces la herramienta ni siquiera puede lograr su objetivo de descubrimiento y recoleccion. Por favor, cargue las APIs necesarias antes de acordarse de mi madre.
+Si aun con las APIs no muestra cosas "lindas" que usted espera ver, pruebe con otros e-mails antes de acordarse de mi madre.
+Si aun probando con otros e-mails no ve las cosas "lindas" que usted espera ver, puede crear un issue, contactarnos por e-mail o por cualquiera de las RRSS, pero tenga en cuenta que mi madre no es ni la creadora ni contribuye con el proyecto.
 
-No reembolsamos su dinero si no está satisfecho.
+No reembolsamos su dinero si no esta satisfecho.
 
-Espero que disfrute la utilizacion de la herramienta tanto como nosotros disfrutamos hacerla. El esfuerzo fue y es enorme (Tiempo, conocimiento, codificacion, pruebas, revisiones, etc) pero lo haríamos de nuevo.
+Espero que disfrute la utilizacion de la herramienta tanto como nosotros disfrutamos hacerla. El esfuerzo fue y es enorme (Tiempo, conocimiento, codificacion, pruebas, revisiones, etc) pero lo hariamos de nuevo.
 
 No use la herramienta si no puede leer claramente las instrucciones y/o el presente Aviso Legal.
 
-Por cierto, para quienes insistan en acordarse de mi madre, ella murió hace muchos años pero la amo como si estuviera aquí mismo.
+Por cierto, para quienes insistan en acordarse de mi madre, ella murio hace muchos anos pero la amo como si estuviera aqui mismo.