HoruxDespachos/docs/superpowers/plans/2026-04-17-plan3-roles-carteras.md

Plan 3: Roles y Carteras — Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task.

Goal: Supervisores crean carteras de contribuyentes y asignan auxiliares. La función getEntidadesVisibles() filtra qué contribuyentes puede ver cada rol. Clientes acceden solo a sus RFCs via cliente_accesos.

Architecture: Se extiende el type Role con 'supervisor' | 'cliente'. Se crea CRUD para carteras (tenant BD). Se crea helper getEntidadesVisibles(pool, userId, role) que retorna los IDs de entidades visibles según el rol. Los endpoints de contribuyentes filtran usando este helper.

---

Tasks

Task 1: Extend Role type

Task 2: Cartera CRUD service + controller + routes

Task 3: getEntidadesVisibles helper

Task 4: Filter contribuyentes by entidades visibles

Task 5: Validation