Chore/remove dead safe hash compare

.gitignore

@@ -41,11 +41,7 @@ lerna-debug.log*
 !.vscode/extensions.json
 
 # dotenv environment variable files
-.env
-.env.development.local
-.env.test
-.env.production.local
-.env.development
+.env*
 
 # temp directory
 .temp
@@ -59,3 +55,5 @@ pids
 
 # Diagnostic reports (https://nodejs.org/api/report.html)
 report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+CLAUDE.md
+GEMINI.md

AGENTS.md

@@ -0,0 +1,54 @@
+# AGENTS.md
+
+This file serves as the unified source of truth for all AI agents (Claude Code, Gemini CLI, etc.) working on the Rayuela project.
+
+## Project Overview
+
+Rayuela is a full-stack citizen science platform with adaptive gamification for crowdsourced data collection. It is a monorepo with two main packages:
+
+- `rayuela-NodeBackend/` — NestJS + TypeScript REST API (MongoDB + Garage S3)
+- `rayuela-frontend/` — Vue 3 + Vite SPA (Vuetify + Vuex)
+
+**GitHub Project:** [Rayuela Workspace Board](https://github.com/orgs/Rayuela-v2/projects/1/views/1)
+
+## Mandatory Development Rules
+- **ORG REPOSITORIES:** ALWAYS work exclusively in the repositories under the `Rayuela-v2` organization. NEVER perform actions in `cientopolis` source repositories.
+- **ISSUE TRACKING:** All issues are tracked in: [Rayuela-v2/rayuela-NodeBackend](https://github.com/Rayuela-v2/rayuela-NodeBackend)
+- **NO AI SIGNATURES:** Do not include agent signatures or attribution lines in PR descriptions or commits.
+
+## Development Commands
+
+### Backend (`rayuela-NodeBackend/`)
+- `npm run start:dev` — Development with watch mode
+- `npm run build` — Compile TypeScript to dist/
+- `npm run test` — Jest unit tests
+- `npm run test:e2e` — End-to-end tests
+- `npm run lint` — ESLint with auto-fix
+- `npm run format` — Prettier formatting
+- **Infrastructure:** `docker-compose up -d mongodb garage` (then `bash ../init-garage.sh` if first time)
+
+### Frontend (`rayuela-frontend/`)
+- `npm run dev` — Vite dev server (http://localhost:5173)
+- `npm run build` — Production build
+- `npm run test:unit` — Vitest unit tests
+- `npm run test:e2e` — Playwright e2e tests
+- `npm run lint` — ESLint with auto-fix
+
+## Architecture
+
+### Backend (NestJS)
+- API Prefix: `/v1`
+- Swagger Docs: `/docs`
+- Pattern: `controller → service → DAO/schema (persistence/) → entities/ + dto/`
+- **Gamification Engine:** Pluggable strategy-pattern engine in `src/module/gamification/entities/engine/`.
+
+### Frontend (Vue 3)
+- UI Library: Vuetify 3
+- State: Vuex
+- API Layer: `src/services/`
+- i18n: `src/locales/` (ES primary, EN secondary)
+
+## Environment Variables
+- Backend uses `.env.development` or `.env.production`.
+- Frontend uses `.env` with `VITE_` prefix.
+- Key secrets: `DB_CONNECTION`, `JWT_SECRET`, `S3_ACCESS_KEY`, `S3_SECRET_KEY`.

Dockerfile

@@ -1,18 +1,41 @@
-# Usar una imagen base de Node.js consistente
-FROM node:20-alpine
+# ─── Stage 1: Build ───────────────────────────────────────────────────────────
+# Usamos Node 20 sobre Alpine (imagen liviana) como entorno de compilación
+FROM node:20-alpine AS build
 
-# Establecer el directorio de trabajo
+# Directorio de trabajo dentro del contenedor donde se copiará el código
 WORKDIR /usr/src/app
 
-# Copiar solo los archivos de manifiesto del paquete para aprovechar el caché de Docker
+# Copiamos solo los manifiestos de dependencias primero para aprovechar
+# la caché de capas de Docker: si package*.json no cambia, npm install no se repite
 COPY package*.json ./
 
-# Instalar dependencias (esto se ejecutará dentro del contenedor Alpine)
+# Instalamos todas las dependencias (incluyendo devDependencies necesarias para compilar)
 RUN npm install
 
-# Copiar el resto del código (esto será sobrescrito por el volumen de docker-compose, pero es buena práctica tenerlo)
+# Copiamos el resto del código fuente
 COPY . .
 
-# El comando para iniciar la app en modo de desarrollo (usando ts-node-dev o similar)
-# docker-compose anulará este CMD, pero lo dejamos como referencia.
-CMD ["npm", "run", "start:dev"]
+# Compilamos TypeScript a JavaScript (genera la carpeta dist/)
+RUN npm run build
+
+# ─── Stage 2: Runtime ─────────────────────────────────────────────────────────
+# Nueva imagen limpia de Node 20 Alpine; no incluye el código fuente ni devDependencies
+FROM node:20-alpine
+
+# Mismo directorio de trabajo que en la etapa de build
+WORKDIR /usr/src/app
+
+# Copiamos los manifiestos para instalar solo dependencias de producción
+COPY package*.json ./
+
+# Instalamos únicamente las dependencias de producción (sin devDependencies)
+RUN npm install --only=production
+
+# Copiamos el código compilado desde la etapa de build
+COPY --from=build /usr/src/app/dist ./dist
+
+# Exponemos el puerto en el que escucha la aplicación NestJS
+EXPOSE 3000
+
+# Comando de inicio: ejecuta el archivo principal compilado
+CMD ["node", "dist/src/main"]

README.md

@@ -13,16 +13,25 @@ $ npm install
 
 ## Running the app
 
-```bash
-# development
-$ npm run start
+1. **Start Docker Services** (MongoDB & Garage):
+   ```bash
+   $ docker-compose up -d
+   ```
 
-# watch mode
-$ npm run start:dev
+2. **Initialize Garage** (First time only):
+   ```bash
+   $ bash ../init-garage.sh
+   ```
 
-# production mode
-$ npm run start:prod
-```
+3. **Start Backend**:
+   ```bash
+   # watch mode
+   $ npm run start:dev
+   ```
+
+## Google auth setup
+
+Para habilitar el login y registro con Google, configurar `GOOGLE_CLIENT_ID` con el Client ID Web generado en Google Cloud en `.env` or `.env.development`.
 
 ## Test
 

docker-compose.yml

@@ -4,34 +4,51 @@ services:
     build:
       context: .
       dockerfile: Dockerfile
-    # Agrega este comando para iniciar en modo desarrollo
     command: npm run start:dev
     ports:
-      - '3000:3000'   # El puerto por defecto de NestJS es 3000
+      - '3000:3000'
       - '9229:9229'
+    env_file:
+      - .env
     environment:
-      - NODE_ENV=development
+      - DB_CONNECTION=mongodb://root:root@mongodb:27017
+      - S3_ENDPOINT=http://garage:3900
     volumes:
       - .:/usr/src/app
       - /usr/src/app/node_modules
     depends_on:
       - mongodb
+      - garage
     networks:
       - rayuela_net
   mongodb:
     image: mongo:4.4
     container_name: mongodb
-    environment:
-      - MONGO_INITDB_ROOT_USERNAME=${MONGO_USER}
-      - MONGO_INITDB_ROOT_PASSWORD=${MONGO_PASSWORD}
+    env_file:
+      - .env
     ports:
       - "27017:27017"
     volumes:
       - mongodb_data:/data/db
     networks:
       - rayuela_net
+  garage:
+    image: dxflrs/garage:v2.2.0
+    container_name: garage
+    ports:
+      - "3900:3900" # S3 API
+      - "3901:3901" # RPC
+      - "3902:3902" # Web
+      - "3903:3903" # Admin API
+    volumes:
+      - ./garage.toml:/etc/garage.toml
+      - garage_data:/data
+    networks:
+      - rayuela_net
+
 volumes:
   mongodb_data:
+  garage_data:
 
 networks:
   rayuela_net:

docs/README.md

@@ -0,0 +1,13 @@
+# Rayuela Backend Documentation
+
+Welcome to the official documentation for the **Rayuela Backend**. 
+
+This repository contains the NestJS-based REST API and management backend for the Rayuela platform.
+
+## Quick Links
+- [Deployment](deployment)
+- [Gamification Architecture](gamification-badges)
+- [Adaptive Gamification: Badge Fading](adaptive-gamification/badge-fading)
+- [Vanishing Badges Simulator](adaptive-gamification/simulator)
+- [Mobile Architecture](mobile/)
+- [GitHub Repository](https://github.com/Rayuela-v2/rayuela-NodeBackend)

docs/_sidebar.md

@@ -0,0 +1,19 @@
+- [Home](README.md)
+- [Deployment & Infrastructure](deployment.md)
+- [Analytics Data Extraction](analytics-queries.md)
+- [Gamification & Badges Architecture](gamification-badges.md)
+- <a href="directed_graph_tool.html" target="_blank">Badge Graph Drawing Tool</a>
+
+- **Adaptive Gamification Strategies**
+  - [Badge Fading](adaptive-gamification/badge-fading.md)
+  - [Vanishing Badges Simulator](adaptive-gamification/simulator.md)
+  - <a href="vanishing_badges_simulator.html" target="_blank">Simulator (Fullscreen ↗)</a>
+
+- **Mobile Application**
+  - [Architecture Overview](mobile/README.md)
+  - [Offline Sync Architecture](mobile/offline-sync.md)
+  - [Project & Feature Structure](mobile/architecture.md)
+  - [Technical Details](mobile/technical-details.md)
+  - [Core Workflows](mobile/workflows.md)
+  - [UI Dissected](mobile/ui-dissection.md)
+  - [Reference & Stats](mobile/reference.md)