tipo(módulo): descripción breve en imperativo

# Cuerpo opcional: qué y por qué (no el cómo)
# Máximo 72 caracteres por línea

make lint          # Analiza código con ruff
make format        # Formatea código con ruff
make type-check    # Verifica tipos con mypy
make security-scan # Escaneo de seguridad con bandit
make test-unit     # Tests unitarios
make test-all      # Todos los tests (unit + integration + e2e + security)
make coverage      # Genera reporte de cobertura HTML (mínimo: 80%)

# 1. Clonar el repo
git clone https://github.com/gveraTrnsfty/LeydeProtecciondeDatos.git
cd LeydeProtecciondeDatos

# 2. Configurar entorno virtual
python -m venv venv
venv\Scripts\activate   # Windows
# source venv/bin/activate  # Mac/Linux

# 3. Instalar dependencias y hooks
make install

# 4. Copiar variables de entorno
cp .env.example .env
# Editar .env con los valores que te dará el Tech Lead

# 5. Inicializar base de datos local
flask db upgrade

# 6. Correr el servidor
python src/run.py

# 7. Verificar que los tests pasan
make test-unit

src/app/
  models/     → Modelos SQLAlchemy (solo definición de datos)
  routes/     → Blueprints Flask (solo HTTP: recibir request, devolver response)
  services/   → Lógica de negocio (aquí va la carne)
  templates/  → HTML Jinja2
  static/     → CSS, JS, imágenes

name: Code Review — Z.AI GLM 5.2

on:
  pull_request:
    types: [opened, synchronize]
    branches:
      - develop
      - main

jobs:
  code-review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write   # necesario para dejar comentarios

    steps:
      - name: Z.AI Code Review
        uses: tarmojussila/zai-code-review@v0.4.0
        with:
          ZAI_API_KEY: ${{ secrets.ZAI_API_KEY }}
        env:
          ZAI_MODEL: glm-5.2
          ZAI_REVIEWER_NAME: "PrivaSteward AI Reviewer"

name: Code Review — Z.AI GLM 5.2

on:
  pull_request:
    types: [opened, synchronize]
    branches:
      - develop
      - main

jobs:
  code-review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write

    steps:
      - name: Z.AI Code Review
        uses: tarmojussila/zai-code-review@v0.4.0
        with:
          ZAI_API_KEY: ${{ secrets.ZAI_API_KEY }}
        env:
          ZAI_MODEL: glm-5.2
          ZAI_REVIEWER_NAME: "PrivaSteward AI Reviewer"
          ZAI_SYSTEM_PROMPT: |
            Eres un revisor de código experto para PrivaSteward, sistema de
            cumplimiento de la Ley 21.719 de Protección de Datos de Chile.
            Stack: Python 3.11, Flask 3.0, SQLAlchemy.

            En cada revisión evalúa:
            1. SEGURIDAD: SQL injection, inputs sin sanitizar, secretos hardcodeados,
               datos personales expuestos en logs o respuestas HTTP.
            2. PRIVACIDAD (Ley 21.719): cualquier tratamiento de datos personales
               (RUT, nombre, email, salud) debe estar justificado por una base legal
               del RAT. Señalar si el código accede a datos sensibles sin control.
            3. CALIDAD: funciones con más de 20 líneas de lógica de negocio en rutas
               Flask (deben estar en services/), falta de tipado en funciones nuevas,
               print() en vez de logging.
            4. TESTS: código sin cobertura, casos borde no contemplados.

            Formato de respuesta:
            - Usa [BLOCKER], [SUGERENCIA] o [PREGUNTA] como prefijo.
            - Sé concreto y actionable. No repitas lo que ya hace bien el código.
            - Máximo 8 comentarios por PR. Prioriza los más importantes.

feature/TSF-42-historial-rat
feature/TSF-57-multi-tenant
fix/TSF-61-login-azure-ad

name: PR Automation — Trello + Z.AI Review

on:
  pull_request:
    types: [opened, synchronize, closed]
    branches:
      - develop
      - main

jobs:
  # ── Job 1: Llenar descripción del PR desde Trello ──────────────────
  trello-sync:
    runs-on: ubuntu-latest
    if: github.event.action == 'opened'
    permissions:
      pull-requests: write
    steps:
      - name: Trello Card → PR Description
        uses: rematocorp/trello-integration-action@v1
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}
          trello-api-key: ${{ secrets.TRELLO_API_KEY }}
          trello-auth-token: ${{ secrets.TRELLO_TOKEN }}
          trello-board-id: ${{ secrets.TRELLO_BOARD_ID }}
          # La action lee el ID de Trello del nombre de la rama (ej: TSF-42)
          trello-card-position: top
          github-include-pr-branch-name: true

  # ── Job 2: Code review automático con GLM 5.2 ─────────────────────
  zai-review:
    runs-on: ubuntu-latest
    if: github.event.action == 'opened' || github.event.action == 'synchronize'
    permissions:
      contents: read
      pull-requests: write
    steps:
      - name: Z.AI Code Review — GLM 5.2
        uses: tarmojussila/zai-code-review@v0.4.0
        with:
          ZAI_API_KEY: ${{ secrets.ZAI_API_KEY }}
        env:
          ZAI_MODEL: glm-5.2
          ZAI_REVIEWER_NAME: "PrivaSteward AI Reviewer"

  # ── Job 3: Mover tarjeta Trello al cerrar PR ──────────────────────
  trello-close:
    runs-on: ubuntu-latest
    if: github.event.action == 'closed' && github.event.pull_request.merged == true
    steps:
      - name: Mover tarjeta a Done
        uses: rematocorp/trello-integration-action@v1
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}
          trello-api-key: ${{ secrets.TRELLO_API_KEY }}
          trello-auth-token: ${{ secrets.TRELLO_TOKEN }}
          trello-board-id: ${{ secrets.TRELLO_BOARD_ID }}
          trello-list-name-done: "Done"
          github-include-pr-branch-name: true