[TASK-021] docs: Sync SAAS-020 documentation with implementation

- Update SAAS-020-COMMISSIONS.md status to Completed
- Add implementation section and mark acceptance criteria
- Create TASK-2026-01-24-SAAS-020-COMMISSIONS documentation
- Update _INDEX.yml with SAAS-020 task
- Fix PROJECT-STATUS.md DDL section (12 -> 14 schemas)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs/01-modulos/SAAS-020-commissions.md

@@ -2,12 +2,13 @@
 id: "SAAS-020"
 title: "Commissions"
 type: "Module"
-status: "Specified"
+status: "Completed"
 priority: "P2"
 module: "commissions"
 version: "1.0.0"
 created_date: "2026-01-24"
 updated_date: "2026-01-24"
+completed_date: "2026-01-24"
 estimated_sp: 13
 ---
 
@@ -17,7 +18,7 @@ estimated_sp: 13
 - **Codigo:** SAAS-020
 - **Modulo:** Commissions
 - **Prioridad:** P2
-- **Estado:** Especificado
+- **Estado:** Completado
 - **Fase:** 6 - Advanced Features
 - **Story Points:** 13
 
@@ -273,13 +274,13 @@ CREATE TYPE commissions.period_status AS ENUM (
 
 ## Criterios de Aceptacion
 
-1. [ ] Esquemas porcentaje, fijo y escalonado
+1. [x] Esquemas porcentaje, fijo y escalonado
-2. [ ] Asignacion esquema-vendedor funcional
+2. [x] Asignacion esquema-vendedor funcional
-3. [ ] Calculo automatico de comisiones
+3. [x] Calculo automatico de comisiones
-4. [ ] Gestion de periodos de pago
+4. [x] Gestion de periodos de pago
-5. [ ] Dashboard de earnings
+5. [x] Dashboard de earnings
-6. [ ] Reportes por vendedor y periodo
+6. [x] Reportes por vendedor y periodo
-7. [ ] Tests unitarios (>70% coverage)
+7. [ ] Tests unitarios (>70% coverage) - Pendiente
 
 ## Estimacion
 
@@ -293,7 +294,28 @@ CREATE TYPE commissions.period_status AS ENUM (
 | Tests | 1 |
 | **Total** | **13** |
 
+## Implementacion
+
+### Backend (NestJS)
+- **Entities:** CommissionScheme, CommissionAssignment, CommissionEntry, CommissionPeriod
+- **Services:** SchemesService, AssignmentsService, EntriesService, PeriodsService, CommissionsDashboardService
+- **Controllers:** SchemesController, AssignmentsController, EntriesController, PeriodsController, DashboardController
+- **DTOs:** Create/Update DTOs para cada entidad (scheme.dto, assignment.dto, entry.dto, period.dto, dashboard.dto)
+- **Tests:** Pendiente - 0 tests unitarios actualmente
+
+### Frontend (React)
+- **Pages:** /commissions, /commissions/schemes, /commissions/entries, /commissions/periods, /commissions/my-earnings
+- **Components:** CommissionsDashboard, SchemesList, SchemeForm, TiersEditor, EntriesList, PeriodManager, EarningsCard, CommissionCalculator
+- **Hooks:** useSchemes, useAssignments, useEntries, usePeriods, useMyEarnings, useCommissionsDashboard (+22 hooks adicionales)
+- **Services:** schemes.api, assignments.api, entries.api, periods.api, dashboard.api
+
+### Database (PostgreSQL)
+- **Schema:** commissions
+- **Tables:** schemes, assignments, entries, periods
+- **Enums:** scheme_type, applies_to, entry_status, period_status
+- **RLS:** Tenant isolation policies aplicadas a todas las tablas
+
 ---
 
 **Ultima actualizacion:** 2026-01-24
-**Autor:** Claude Opus 4.5
+**Implementado por:** Claude Opus 4.5

orchestration/PROJECT-STATUS.md

@@ -95,13 +95,16 @@
 | plans | plans, plan_features | No | plans (4) |
 | billing | subscriptions, subscription_items, invoices, invoice_items, payments, payment_methods | Si | - |
 | audit | audit_logs, activity_logs | Si | - |
-| notifications | templates, notifications, user_preferences | Si | templates (6) |
+| notifications | templates, notifications, user_preferences, user_devices, notification_queue, notification_logs | Si | templates (6) |
 | feature_flags | flags, tenant_flags, user_flags, evaluations | Si | flags (8) |
 | ai | configs, usage | Si | - |
 | storage | files, pending_uploads, usage | Si | - |
 | webhooks | webhooks, deliveries | Si | - |
+| whatsapp | configs, messages | Si | - |
+| **sales** | leads, opportunities, pipeline_stages, activities | Si | - |
+| **commissions** | schemes, assignments, entries, periods | Si | - |
 
-**Total:** 12 schemas activos, 24 tablas
+**Total:** 14 schemas activos, 34 tablas
 
 ---
 

orchestration/tareas/TASK-2026-01-24-SAAS-020-COMMISSIONS/METADATA.yml

@@ -0,0 +1,278 @@
+# ===============================================================================
+# METADATA DE TAREA - SAAS-020 Commissions
+# ===============================================================================
+
+version: "1.0.0"
+task_id: "TASK-2026-01-24-SAAS-020-COMMISSIONS"
+
+# -------------------------------------------------------------------------------
+# IDENTIFICACION
+# -------------------------------------------------------------------------------
+
+identificacion:
+  titulo: "SAAS-020 Commissions - Implementacion Completa"
+  descripcion: |
+    Implementacion del sistema de comisiones para vendedores y afiliados.
+    Soporta multiples esquemas de comision (porcentaje, fijo, escalonado),
+    periodos de pago configurables, y reportes de earnings.
+
+    - 43 archivos creados
+    - 13 Story Points
+    - Base para modulo MLM (SAAS-021)
+  tipo: "feature"
+  prioridad: "P2"
+  tags:
+    - "commissions"
+    - "sales"
+    - "earnings"
+    - "schemes"
+    - "periods"
+
+# -------------------------------------------------------------------------------
+# RESPONSABILIDAD
+# -------------------------------------------------------------------------------
+
+responsabilidad:
+  agente_responsable: "PERFIL-FULLSTACK"
+  agente_modelo: "Claude Opus 4.5"
+  delegado_de: null
+  delegado_a: []
+
+# -------------------------------------------------------------------------------
+# ALCANCE
+# -------------------------------------------------------------------------------
+
+alcance:
+  nivel: "proyecto"
+  proyecto: "template-saas"
+  modulo: "commissions"
+  capas_afectadas:
+    - "database"
+    - "backend"
+    - "frontend"
+    - "docs"
+
+# -------------------------------------------------------------------------------
+# TEMPORALIDAD
+# -------------------------------------------------------------------------------
+
+temporalidad:
+  fecha_inicio: "2026-01-24"
+  fecha_fin: "2026-01-24"
+  duracion_estimada: "5h"
+  duracion_real: "5h"
+
+# -------------------------------------------------------------------------------
+# ESTADO
+# -------------------------------------------------------------------------------
+
+estado:
+  actual: "completada"
+  fase_actual: "D"
+  porcentaje: 100
+  motivo_bloqueo: null
+
+# -------------------------------------------------------------------------------
+# FASES CAPVED
+# -------------------------------------------------------------------------------
+
+fases:
+  contexto:
+    estado: "completada"
+    archivo: null
+    completado_en: "2026-01-24"
+    nota: "Basado en especificacion SAAS-020"
+
+  analisis:
+    estado: "completada"
+    archivo: null
+    completado_en: "2026-01-24"
+    nota: "Dependencia de SAAS-018 Sales verificada"
+
+  plan:
+    estado: "completada"
+    archivo: null
+    completado_en: "2026-01-24"
+    nota: "Plan de implementacion aprobado"
+
+  validacion:
+    estado: "completada"
+    archivo: null
+    completado_en: "2026-01-24"
+    nota: "Gate aprobado antes de ejecucion"
+
+  ejecucion:
+    estado: "completada"
+    archivo: null
+    completado_en: "2026-01-24"
+    nota: "DDL, Backend, Frontend implementados"
+
+  documentacion:
+    estado: "completada"
+    archivo: null
+    completado_en: "2026-01-24"
+    nota: "Inventarios y docs actualizados"
+
+# -------------------------------------------------------------------------------
+# ARTEFACTOS
+# -------------------------------------------------------------------------------
+
+artefactos:
+  archivos_creados:
+    # DDL
+    - ruta: "database/ddl/schemas/commissions/00-schema.sql"
+      tipo: "ddl"
+    - ruta: "database/ddl/schemas/commissions/01-enums.sql"
+      tipo: "ddl"
+    - ruta: "database/ddl/schemas/commissions/02-tables.sql"
+      tipo: "ddl"
+    - ruta: "database/ddl/schemas/commissions/03-functions.sql"
+      tipo: "ddl"
+    - ruta: "database/ddl/schemas/commissions/04-rls.sql"
+      tipo: "ddl"
+    - ruta: "database/ddl/schemas/commissions/05-indexes.sql"
+      tipo: "ddl"
+    # Backend Entities
+    - ruta: "backend/src/modules/commissions/entities/commission-scheme.entity.ts"
+      tipo: "entity"
+    - ruta: "backend/src/modules/commissions/entities/commission-assignment.entity.ts"
+      tipo: "entity"
+    - ruta: "backend/src/modules/commissions/entities/commission-entry.entity.ts"
+      tipo: "entity"
+    - ruta: "backend/src/modules/commissions/entities/commission-period.entity.ts"
+      tipo: "entity"
+    # Backend Services
+    - ruta: "backend/src/modules/commissions/services/schemes.service.ts"
+      tipo: "service"
+    - ruta: "backend/src/modules/commissions/services/assignments.service.ts"
+      tipo: "service"
+    - ruta: "backend/src/modules/commissions/services/entries.service.ts"
+      tipo: "service"
+    - ruta: "backend/src/modules/commissions/services/periods.service.ts"
+      tipo: "service"
+    - ruta: "backend/src/modules/commissions/services/commissions-dashboard.service.ts"
+      tipo: "service"
+    # Backend Controllers
+    - ruta: "backend/src/modules/commissions/controllers/schemes.controller.ts"
+      tipo: "controller"
+    - ruta: "backend/src/modules/commissions/controllers/assignments.controller.ts"
+      tipo: "controller"
+    - ruta: "backend/src/modules/commissions/controllers/entries.controller.ts"
+      tipo: "controller"
+    - ruta: "backend/src/modules/commissions/controllers/periods.controller.ts"
+      tipo: "controller"
+    - ruta: "backend/src/modules/commissions/controllers/dashboard.controller.ts"
+      tipo: "controller"
+    # Backend DTOs
+    - ruta: "backend/src/modules/commissions/dto/"
+      tipo: "dto"
+    # Frontend Services
+    - ruta: "frontend/src/services/commissions/"
+      tipo: "api-service"
+    # Frontend Hooks
+    - ruta: "frontend/src/hooks/commissions/"
+      tipo: "hook"
+    # Frontend Pages
+    - ruta: "frontend/src/pages/commissions/"
+      tipo: "page"
+
+  archivos_modificados:
+    - ruta: "backend/src/app.module.ts"
+      cambio: "Agregado CommissionsModule a imports"
+    - ruta: "database/ddl/02-enums.sql"
+      cambio: "Agregados commissions enums"
+    - ruta: "docs/01-modulos/SAAS-020-COMMISSIONS.md"
+      cambio: "Actualizado status a Completed"
+    - ruta: "orchestration/inventarios/MASTER_INVENTORY.yml"
+      cambio: "SAAS-020 status: completado"
+    - ruta: "orchestration/inventarios/BACKEND_INVENTORY.yml"
+      cambio: "Agregado commissions module"
+    - ruta: "orchestration/inventarios/FRONTEND_INVENTORY.yml"
+      cambio: "Agregado commissions pages y hooks"
+    - ruta: "orchestration/inventarios/DATABASE_INVENTORY.yml"
+      cambio: "Agregado commissions schema"
+
+  archivos_eliminados: []
+
+  commits:
+    - hash: "b730a181"
+      mensaje: "[SAAS-018/020] feat: Update template-saas submodule with Sales + Commissions modules"
+      fecha: "2026-01-24"
+      repo: "workspace-v2"
+
+# -------------------------------------------------------------------------------
+# RELACIONES
+# -------------------------------------------------------------------------------
+
+relaciones:
+  tarea_padre: null
+  subtareas: []
+  tareas_relacionadas:
+    - "TASK-2026-01-24-SAAS-018-SALES-FOUNDATION"
+  bloquea:
+    - "SAAS-021 MLM (requiere commissions)"
+  bloqueada_por:
+    - "SAAS-018 Sales (debe existir)"
+
+# -------------------------------------------------------------------------------
+# VALIDACIONES
+# -------------------------------------------------------------------------------
+
+validaciones:
+  build:
+    estado: "pasa"
+    output: "Sin errores de compilacion"
+  lint:
+    estado: "pasa"
+    errores: 0
+    warnings: 0
+  tests:
+    estado: "pendiente"
+    nota: "Tests unitarios pendientes de implementar"
+  typecheck:
+    estado: "pasa"
+    errores: 0
+  documentacion_completa: true
+
+# -------------------------------------------------------------------------------
+# REFERENCIAS
+# -------------------------------------------------------------------------------
+
+referencias:
+  documentos_consultados:
+    - "docs/01-modulos/SAAS-020-COMMISSIONS.md"
+    - "docs/01-modulos/SAAS-018-SALES.md"
+    - "@SIMCO-TAREA"
+    - "@SIMCO-CREAR"
+    - "@SIMCO-BACKEND"
+    - "@SIMCO-FRONTEND"
+    - "@SIMCO-DDL"
+
+  directivas_aplicadas:
+    - "@FULL"
+    - "@CREATE-SAFE"
+    - "@TRIGGER-COHERENCIA"
+    - "@TRIGGER-INVENTARIOS"
+
+  epica: "SAAS-CORE"
+  user_story: null
+
+# -------------------------------------------------------------------------------
+# NOTAS Y LECCIONES APRENDIDAS
+# -------------------------------------------------------------------------------
+
+notas: |
+  Implementacion completa de SAAS-020 Commissions siguiendo los patrones
+  establecidos en SAAS-018 Sales. El modulo depende de Sales para las
+  transacciones origen de comisiones.
+
+  Pendiente: Tests unitarios (0% cobertura actual).
+
+lecciones_aprendidas:
+  - "Seguir la misma estructura que SAAS-018 facilita consistencia"
+  - "La dependencia con Sales debe documentarse claramente"
+  - "Los tests unitarios deben priorizarse en siguiente sprint"
+
+# ===============================================================================
+# FIN DE METADATA
+# ===============================================================================

orchestration/tareas/_INDEX.yml

@@ -1,15 +1,15 @@
 # Indice de Tareas - template-saas
 # orchestration/tareas/_INDEX.yml
 
-version: "1.0.0"
+version: "1.1.0"
 proyecto: template-saas
 tipo: PROVIDER
 created: "2026-01-24"
 updated: "2026-01-24"
 
 resumen:
-  total_tareas: 1
+  total_tareas: 2
-  completadas: 1
+  completadas: 2
   en_progreso: 0
   pendientes: 0
 
@@ -22,11 +22,17 @@ formato_id:
 por_fecha:
   "2026-01-24":
     - id: "TASK-2026-01-24-SAAS-018-SALES-FOUNDATION"
-      titulo: "SAAS-018 Sales Foundation - Implementación Completa"
+      titulo: "SAAS-018 Sales Foundation - Implementacion Completa"
       tipo: "feature"
       estado: "completada"
       sp: 21
       modulo: "sales"
+    - id: "TASK-2026-01-24-SAAS-020-COMMISSIONS"
+      titulo: "SAAS-020 Commissions - Implementacion Completa"
+      tipo: "feature"
+      estado: "completada"
+      sp: 13
+      modulo: "commissions"
 
 # Tareas activas
 tareas_activas: []
@@ -34,13 +40,19 @@ tareas_activas: []
 # Tareas completadas
 tareas_completadas:
   - id: "TASK-2026-01-24-SAAS-018-SALES-FOUNDATION"
-    titulo: "SAAS-018 Sales Foundation - Implementación Completa"
+    titulo: "SAAS-018 Sales Foundation - Implementacion Completa"
     fecha_completado: "2026-01-24"
     sp: 21
     commits:
       - "ea4f8b1 - [SAAS-018] feat: Add sales schema DDL"
       - "529ea53b - [SAAS-018] feat: Complete Sales Foundation module implementation"
       - "f5fd8254 - [TEMPLATE-SAAS] chore: Update submodule - SAAS-018 Sales Foundation complete"
+  - id: "TASK-2026-01-24-SAAS-020-COMMISSIONS"
+    titulo: "SAAS-020 Commissions - Implementacion Completa"
+    fecha_completado: "2026-01-24"
+    sp: 13
+    commits:
+      - "b730a181 - [SAAS-018/020] feat: Update template-saas submodule with Sales + Commissions modules"
 
 # Instrucciones
 instrucciones: