Release: Promoción inicial a Producción (v1.0.0)

.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.py]
+indent_style = space
+indent_size = 4
+
+[*.{js,html,css}]
+indent_style = space
+indent_size = 2

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,19 @@
+## Descripción
+<!-- ¿Qué cambia y por qué? -->
+
+## Tipo de cambio
+- [ ] feat
+- [ ] fix
+- [ ] refactor
+- [ ] chore
+- [ ] docs
+- [ ] test
+
+## Cómo probar
+<!-- Pasos para verificar que el cambio funciona correctamente -->
+
+## Checklist
+- [ ] Sigue las convenciones de commits del proyecto
+- [ ] Las pruebas existentes pasan sin errores
+- [ ] Se agregaron pruebas para el nuevo comportamiento (si aplica)
+- [ ] No se incluyen archivos .env ni credenciales

.github/workflows/.gitkeep

@@ -0,0 +1 @@
+

.github/workflows/daily-pipeline.yml

@@ -0,0 +1,33 @@
+name: Daily Pipeline
+
+on:
+  # Disparo programado: todos los días a las 00:00 UTC.
+  schedule:
+    - cron: "0 0 * * *"
+
+  # Disparo manual desde la interfaz de GitHub para poder probar sin esperar al horario programado o depurar fallos.
+  workflow_dispatch:
+
+jobs:
+  trigger-pipeline:
+    name: Trigger Daily Pipeline
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: POST /api/admin/trigger-pipeline
+        run: |
+          HTTP_STATUS=$(curl --silent --output /tmp/pipeline_response.json \
+            --write-out "%{http_code}" \
+            --request POST \
+            --header "X-Pipeline-Trigger-Key: ${{ secrets.PIPELINE_TRIGGER_SECRET }}" \
+            --header "Content-Type: application/json" \
+            "${{ secrets.PIPELINE_BACKEND_URL }}/api/admin/trigger-pipeline")
+
+          echo "HTTP status: $HTTP_STATUS"
+          echo "Response body:"
+          cat /tmp/pipeline_response.json
+
+          if [ "$HTTP_STATUS" != "200" ]; then
+            echo "::error::El pipeline falló con HTTP $HTTP_STATUS. Ver el body de arriba para detalles."
+            exit 1
+          fi

.github/workflows/tests.yml

@@ -0,0 +1,84 @@
+name: Tests
+
+on:
+  push:
+    branches: [develop]
+  pull_request:
+    branches: [develop]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: postgres:18
+        env:
+          POSTGRES_USER: usuario
+          POSTGRES_PASSWORD: password
+          POSTGRES_DB: skillstat_test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        working-directory: backend
+        run: |
+          pip install -r requirements.txt
+          pip install -r requirements-dev.txt
+
+      - name: Run database migrations
+        working-directory: backend
+        run: flask db upgrade
+        env:
+          FLASK_ENV: "testing"
+          SECRET_KEY: "test-secret-key"
+          TEST_DATABASE_URL: "postgresql://usuario:password@localhost:5432/skillstat_test"
+          JWT_SECRET_KEY: "test-jwt-secret"
+          GOOGLE_CLIENT_ID: "test-google-client-id"
+          FRONTEND_BASE_URL: "http://localhost:5500/frontend"
+          PIPELINE_TRIGGER_SECRET: "test-pipeline-secret"
+          RESEND_API_KEY: "test-resend-api-key"
+
+      - name: Install PostgreSQL 18 client tools
+        run: |
+          sudo apt-get install -y curl ca-certificates
+          sudo install -d /usr/share/postgresql-common/pgdg
+          sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc
+          sudo sh -c 'echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
+          sudo apt-get update
+          sudo apt-get install -y postgresql-client-18
+          pg_dump --version
+
+      - name: Run tests with coverage
+        working-directory: backend
+        run: pytest --cov=app --cov-report=xml
+        env:
+          FLASK_ENV: "testing"
+          SECRET_KEY: "test-secret-key"
+          TEST_DATABASE_URL: "postgresql://usuario:password@localhost:5432/skillstat_test"
+          JWT_SECRET_KEY: "test-jwt-secret"
+          GOOGLE_CLIENT_ID: "test-google-client-id"
+          FRONTEND_BASE_URL: "http://localhost:5500/frontend"
+          PIPELINE_TRIGGER_SECRET: "test-pipeline-secret"
+          RESEND_API_KEY: "test-resend-api-key"
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: backend/coverage.xml
+          fail_ci_if_error: false

.gitignore

@@ -0,0 +1,45 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+venv/
+.venv/
+env/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Database
+*.db
+*.sqlite3
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Migrations (solo rastrear estructura, no datos generados)
+migrations/versions/
+*.log.*
+
+# Backups
+backend/data/backups/*.sql

CONTRIBUTING.md

@@ -0,0 +1,24 @@
+# Normativa de Colaboración y Desarrollo
+
+Este documento establece las reglas operativas inquebrantables para el equipo de SkillStat. No son sugerencias, son requisitos para la integración de código.
+
+## 1. Flujo de Git y Ramas
+* **Ramas Protegidas:** `main` y `develop` están protegidas. Nadie hace un push directo a estas ramas bajo ninguna circunstancia.
+* **Nomenclatura de Ramas:** Toda rama nueva se crea a partir de `develop` utilizando el formato: `tipo/descripcion-en-kebab-case` (ej. `feature/sqlalchemy-models`).
+* **Integración:** Todo código entra a `develop` exclusivamente mediante un Pull Request revisado. No se deja deuda técnica sin corregir.
+
+## 2. Historial y Commits (Conventional Commits)
+Cada sub-ronda o bloque de trabajo debe ser un commit atómico. El mensaje debe seguir el estándar:
+`tipo(scope): descripción en imperativo`
+Tipos permitidos: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`, `perf`.
+
+## 3. Convención Estricta de Comentarios en Código
+Todo comentario debe explicar el **POR QUÉ**, nunca el **QUÉ**.
+* **Regla:** Si el código no deja clara la intención por sí solo, refactoriza. Si la regla de negocio es compleja, se comenta el razonamiento.
+* **Tono:** Primera persona del plural implícita en español. Sin tecnicismos innecesarios, sin emojis, sin numeración de pasos.
+* **Correcto:** `Descartamos las vacantes ya procesadas para no duplicar los resultados.`
+* **Incorrecto:** `Filtramos jobs / Función para filtrar`
+
+## 4. Seguridad
+* El archivo `.env` nunca se sube al repositorio.
+* Las contraseñas se manejan siempre mediante hashes (bcrypt) y el acceso a rutas protegidas se valida estrictamente por roles mediante tokens JWT.

INDUCCION_EQUIPO.md

@@ -0,0 +1,142 @@
+# Cómo trabajamos en SkillStat
+
+Este documento describe cómo organizamos el trabajo, cómo nos comunicamos
+a través del historial de cambios y cómo escribimos código. Lo leemos todos
+antes de tocar cualquier archivo del repositorio.
+
+## Ramas del repositorio
+
+Tenemos dos ramas permanentes que nunca se modifican directamente:
+
+- `main` - contiene el código que está en producción. Solo recibe cambios
+  desde `develop` a través de un Pull Request revisado y aprobado.
+- `develop` - es la rama de trabajo activo del equipo. Aquí integramos
+  todo antes de que llegue a producción.
+
+Para cualquier tarea nueva creamos una rama temporal que nace desde
+`develop` y muere cuando hacemos merge:
+
+| Tipo | Cuándo usarla | Ejemplo |
+|------|---------------|---------|
+| `feature/` | Funcionalidad nueva | `feature/jwt-authentication` |
+| `fix/` | Corrección de error en desarrollo | `fix/city-normalization` |
+| `hotfix/` | Corrección urgente en producción | `hotfix/token-exposure` |
+| `refactor/` | Reorganización sin cambiar comportamiento | `refactor/ingestion-cleanup` |
+| `chore/` | Mantenimiento, dependencias, configuración | `chore/update-requirements` |
+| `docs/` | Documentación únicamente | `docs/guia-entorno` |
+| `test/` | Pruebas nuevas o actualizadas | `test/trends-service-unit` |
+| `release/` | Preparación de versión para producción | `release/v1.0.0` |
+
+Los nombres van en minúsculas, con guiones y sin acentos.
+
+## Flujo de trabajo paso a paso
+
+Cada vez que vamos a trabajar en algo seguimos estos pasos:
+
+```bash
+# Nos aseguramos de que develop esté al día antes de empezar
+git checkout develop
+git pull origin develop
+
+# Creamos nuestra rama desde develop
+git checkout -b feature/nombre-descriptivo
+
+# Trabajamos y guardamos nuestros avances en commits
+git add .
+git commit -m "feat(scope): descripcion del cambio"
+
+# Mantenemos nuestra rama sincronizada con develop mientras trabajamos
+git fetch origin
+git rebase origin/develop
+
+# Subimos nuestra rama y abrimos el Pull Request hacia develop
+git push origin feature/nombre-descriptivo
+```
+
+Nadie toca `main` ni `develop` directamente. Todo pasa por un Pull Request.
+Nadie hace merge de su propio trabajo sin que alguien más lo haya revisado.
+Después del merge borramos la rama.
+
+## Formato de commits
+
+Cada commit sigue esta estructura:
+
+```
+tipo(alcance): descripcion breve en imperativo
+```
+
+Los tipos disponibles:
+
+| Tipo | Cuándo usarlo |
+|------|---------------|
+| `feat` | Funcionalidad nueva |
+| `fix` | Corrección de error |
+| `docs` | Cambio de documentación |
+| `style` | Formato sin cambio de lógica |
+| `refactor` | Reorganización sin cambio de comportamiento |
+| `test` | Agregar o modificar pruebas |
+| `chore` | Mantenimiento, dependencias, configuración |
+| `perf` | Mejora de rendimiento |
+
+Ejemplos reales del proyecto:
+
+```
+feat(auth): implement JWT login and token validation
+fix(nlp): resolve phrase matcher failure on multi-word skills
+chore(deps): add Flask-JWT-Extended and spaCy to requirements
+docs(contributing): add commit format and branching guide
+test(trends): add unit tests for weekly growth rate calculation
+refactor(ingestion): isolate Adzuna client from ingestion logic
+```
+
+## Cómo escribimos comentarios en el código
+
+Comentamos solo cuando el código por sí solo no deja clara la intención
+detrás de lo que hace. Si el código se entiende solo, no ponemos comentario.
+
+El comentario explica el por qué, no el qué. El qué ya lo dice el código.
+
+Escribimos en primera persona del plural, en español, sin tecnicismos,
+sin emojis y sin numerar los pasos. Aplica a todos los lenguajes del
+proyecto: Python, JavaScript, CSS e HTML.
+
+Así escribimos:
+
+```python
+# Descartamos las vacantes que ya procesamos para no duplicar los resultados.
+pending = jobs.filter(processed=False)
+
+# Guardamos el hash para detectar si la descripcion cambio en la fuente original.
+job.description_hash = compute_hash(raw_description)
+
+# Si el umbral ya se supero avisamos al usuario antes de continuar.
+if demand_count >= alert.threshold:
+    notify_user(alert)
+```
+
+```javascript
+// Esperamos el token antes de hacer la peticion para no enviar una solicitud sin autenticar.
+const token = await getAuthToken();
+
+// Mostramos el mensaje directamente para que el usuario sepa que paso sin tener que buscar.
+showErrorMessage(error.message);
+```
+
+Así no escribimos:
+
+```python
+# 1. Filtramos los jobs
+# Funcion para filtrar vacantes usando ORM
+# Filter unprocessed jobs from database
+# 🔍 Buscamos vacantes sin procesar
+```
+
+## Reglas que no se negocian
+
+- Nadie hace push directo a `main` ni a `develop`.
+- Nadie hace merge de su propio Pull Request sin revision previa.
+- Un commit representa un solo cambio logico. No mezclamos cosas distintas.
+- No dejamos deuda tecnica sin documentar. Si algo quedo incompleto
+  abrimos un issue o lo anotamos en el PR.
+- Si una rama lleva mas de una semana sin actividad, revisamos si sigue
+  siendo necesaria o la cerramos.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elías Ochoa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.