20vo Commit - Notificaciones, Kardex

This commit is contained in:
DillusDev001 2026-11-17 11:10:11 -04:00
parent 2945dcf6aa
commit 738e90c50e
56 changed files with 7551 additions and 256 deletions

View file

@ -15,13 +15,15 @@ TOKEN_KEY=cambia_esto_en_produccion
JWT_EXPIRES_IN=24h
HASH_SALT_ROUNDS=10
# Fotos de perfil: peso máximo tras comprimir (KB). Default 100.
PROFILE_MAX_KB=100
# OpenWA Easy API
OPENWA_URL=https://tu-servidor-openwa
OPENWA_API_KEY=tu_api_key
# Sesión(s) OpenWA para el PIN de login — ÚNICA FUENTE (la BD no participa).
# Un id se usa siempre; varios ids coma-separados rotan round-robin en cada envío.
OPENWA_SESSION_ID=
# Sesiones para el PIN de login: tabla sesion_whatsapp (sync desde OpenWA).
# Si no hay ninguna activa, fallback a configuracion.openwaSessionId.
# Path del envío; {sessionId} se sustituye en runtime
OPENWA_SEND_PATH=/api/sessions/{sessionId}/messages/send-text

View file

@ -47,10 +47,11 @@ COPY assets ./assets
COPY public ./public
# package.json se copia porque dist/*.js son ESM ("type": "module")
COPY package.json ./
# uploads (fotos de personas + PDFs de reportes) y backups/ se montan como
# volumen en docker-compose: crearlos acá en la imagen deja el ownership en
# node, que si no el volumen vacío nace root y la app no puede escribir.
RUN mkdir -p uploads backups && chown -R node:node /app
# uploads (fotos de perfil en uploads/profile/, APKs, PDFs de reportes) y
# backups/ se montan como volumen en docker-compose: crearlos acá en la imagen
# deja el ownership en node, que si no el volumen vacío nace root y la app no
# puede escribir.
RUN mkdir -p uploads/profile uploads/apks uploads/reportes backups && chown -R node:node /app
USER node
EXPOSE 4002
# /docs-json (Swagger, exento de auth) responde 200 cuando la app está arriba

File diff suppressed because it is too large Load diff

View file

@ -11,8 +11,9 @@ services:
environment:
TZ: America/La_Paz
# Persistencia fuera del contenedor: `docker compose down` no borra
# volúmenes nombrados (sí `down -v`). uploads = fotos de personas y
# PDFs de reportes; backups = respaldos .sql de Mantenimiento.
# volúmenes nombrados (sí `down -v`). uploads = fotos de perfil
# (`uploads/profile/`), APKs (`uploads/apks/`) y PDFs de reportes
# (`uploads/reportes/`); backups = respaldos .sql de Mantenimiento.
volumes:
- backups:/app/backups
- uploads:/app/uploads

View file

@ -30,6 +30,7 @@
"@nestjs/observe": "^0.1.8",
"@nestjs/platform-express": "^12.0.1",
"@nestjs/platform-socket.io": "^12.1.2",
"@nestjs/schedule": "^12.0.3",
"@nestjs/serve-static": "^12.0.0",
"@nestjs/swagger": "^12.0.2",
"@nestjs/typeorm": "^12.0.2",
@ -45,6 +46,7 @@
"pg": "^8.23.1",
"reflect-metadata": "^0.2.2",
"rxjs": "^7.8.1",
"sharp": "^0.35.5",
"socket.io": "^4.8.4",
"typeorm": "^1.1.1"
},

369
pnpm-lock.yaml generated
View file

@ -22,13 +22,16 @@ importers:
version: 12.0.0(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)
'@nestjs/observe':
specifier: ^0.1.8
version: 0.1.10(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2)(reflect-metadata@0.2.2)(rxjs@7.8.2)
version: 0.1.10(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2)(@nestjs/schedule@12.0.3(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2))(reflect-metadata@0.2.2)(rxjs@7.8.2)
'@nestjs/platform-express':
specifier: ^12.0.1
version: 12.1.2(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2)(supports-color@7.2.0)
'@nestjs/platform-socket.io':
specifier: ^12.1.2
version: 12.1.2(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/websockets@12.1.2)(rxjs@7.8.2)(supports-color@7.2.0)
'@nestjs/schedule':
specifier: ^12.0.3
version: 12.0.3(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2)
'@nestjs/serve-static':
specifier: ^12.0.0
version: 12.0.0(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2)(express@5.2.1(supports-color@7.2.0))
@ -74,6 +77,9 @@ importers:
rxjs:
specifier: ^7.8.1
version: 7.8.2
sharp:
specifier: ^0.35.5
version: 0.35.5(@types/node@24.19.0)
socket.io:
specifier: ^4.8.4
version: 4.8.4(supports-color@7.2.0)
@ -190,6 +196,9 @@ packages:
resolution: {integrity: sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==}
engines: {node: '>=0.1.90'}
'@emnapi/runtime@1.11.3':
resolution: {integrity: sha512-Xz4Tpyki7XyrpbUK1jR1AhdAdaXyhhY4lZ3neLodmhpuWfy2PAQN5B46sAiU4liOXGLkHypn/qU+jvfWSCYYLA==}
'@fastify/busboy@3.2.2':
resolution: {integrity: sha512-yXSS27qPExaXeuLvMRMXOLtpipzfQYNjG3FkunDWKGfMYjKuhFXko9CVzqxm8jcF+lmtS9Fd89QNdh9XDjnbNg==}
@ -266,6 +275,168 @@ packages:
engines: {node: '>=6'}
hasBin: true
'@img/colour@1.1.0':
resolution: {integrity: sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==}
engines: {node: '>=18'}
'@img/sharp-darwin-arm64@0.35.5':
resolution: {integrity: sha512-QRUlFQ0WxvdWyqqG/WtI3iupfD5rBzmCHXSdPsY91sAtVtTo7Q4cb6zOccZ3gqEqkr0f1As1ehLqmEpDsRf+lg==}
engines: {node: '>=20.9.0'}
cpu: [arm64]
os: [darwin]
'@img/sharp-darwin-x64@0.35.5':
resolution: {integrity: sha512-+BR255RhDlpygUpOc/Jdt1nT6DQ3XG/ERo5wbcdOf5Q320dKtPCKPLR1LJs9VGXRaMa8l1uUa0tkCNOXiAxZUw==}
engines: {node: '>=20.9.0'}
cpu: [x64]
os: [darwin]
'@img/sharp-freebsd-wasm32@0.35.5':
resolution: {integrity: sha512-Y/z91nEZ4uIBX5X3nfTovjU9lHNKFYbL2lpHCLVNmXQK03VIZvXBBt0KxbPGp2SdGSF+2mQU4e+hQaWOt86iAw==}
engines: {node: '>=20.9.0'}
os: [freebsd]
'@img/sharp-libvips-darwin-arm64@1.3.4':
resolution: {integrity: sha512-5R89nBYiRdUlSWJxPhO+GVtaXzXSxKnRu/xqMn3KTA3L9EB9Oy/P+Nn2f2vlhPuUdy/Zusb2DarbyTpGCfEDuw==}
cpu: [arm64]
os: [darwin]
'@img/sharp-libvips-darwin-x64@1.3.4':
resolution: {integrity: sha512-iR2OKH80yi0U+dUplyh3/xdpFvps6YkCwsXenIJxqxR1v9o+xtKTGbS9H7cps+2Vxjc8B1j96p75NmTGjIhtpQ==}
cpu: [x64]
os: [darwin]
'@img/sharp-libvips-linux-arm64@1.3.4':
resolution: {integrity: sha512-Y3dgX/6lE2QhQb+Gxy0WZxfg9MEm/JBjamZpS2IklP7xIQoKN4hzAm7KcMVGtaVDt3neE9OKBC7vAfonA/Lr1A==}
cpu: [arm64]
os: [linux]
libc: [glibc]
'@img/sharp-libvips-linux-arm@1.3.4':
resolution: {integrity: sha512-LmRtTsOHuvM2+wlO2Db37dx5MiZhB0FvSunciw48YjdOkZz9KAiRbm8ujeMOA1INqmei5NapFxYEK1D1ZSidmw==}
cpu: [arm]
os: [linux]
libc: [glibc]
'@img/sharp-libvips-linux-ppc64@1.3.4':
resolution: {integrity: sha512-Le6boB8Tai0Nis+gIxIpKx68UDVVIqdR8Tin5Yf1z2LJJQLDJvCDRqRu+jC2qCoD+eIomonmOwB4smBRxfVpYQ==}
cpu: [ppc64]
os: [linux]
libc: [glibc]
'@img/sharp-libvips-linux-riscv64@1.3.4':
resolution: {integrity: sha512-aHkkIEHPRdQEegJN20MLmGtxYD9R2wQr3Cwpddnu5+YKMt6Uzax7S9h5gpZTo8wyrGuZSlfQ63OevL5mTyOC7Q==}
cpu: [riscv64]
os: [linux]
libc: [glibc]
'@img/sharp-libvips-linux-s390x@1.3.4':
resolution: {integrity: sha512-ra/mB6MikESDUO7Yg+Mi95bFBb9GsObURuhnOv3OqknjGe9sZrG8tCe9q0xSIGrtLgvgw0gKnFWcK4blSgQOuQ==}
cpu: [s390x]
os: [linux]
libc: [glibc]
'@img/sharp-libvips-linux-x64@1.3.4':
resolution: {integrity: sha512-GJ//SSXbnwSDes02umB3nDJLFcQzw8a18V8fyhqr6tV515tOEMdImjjxj1AoafMRz56F3PHgftnj1QEKSU1zkw==}
cpu: [x64]
os: [linux]
libc: [glibc]
'@img/sharp-libvips-linuxmusl-arm64@1.3.4':
resolution: {integrity: sha512-hvulFwtjUcagsis6BBxHwGFwWoNZjgYmULGVrZcyfNbjA8hKILbRxGg15/7w5HDyXHXUos/j6baAWqnCyQ2DWA==}
cpu: [arm64]
os: [linux]
libc: [musl]
'@img/sharp-libvips-linuxmusl-x64@1.3.4':
resolution: {integrity: sha512-6zXKeE/p39I1AmA3cJG35eyBGNqNddLnUXjhwBnsGjFPWqf5VKkDBEqaEkPDoTEtkxwi2vv8Tcr2mDyP4So7Fg==}
cpu: [x64]
os: [linux]
libc: [musl]
'@img/sharp-linux-arm64@0.35.5':
resolution: {integrity: sha512-LYVx5JTsOM2CBzmxreh+nl64/3H6Xb09iSLknqH47z2T2DFFxDeFLP5y4dJwe6H7uGQlHPyEEtIqyo3DYsRwdQ==}
engines: {node: '>=20.9.0'}
cpu: [arm64]
os: [linux]
libc: [glibc]
'@img/sharp-linux-arm@0.35.5':
resolution: {integrity: sha512-LEaXK2WdXVK5ykcw0buWyPMsmLLL2vpHLD6yrNSW+JGEL3BZPA4tpKN6iaMc4AxTTAoaX/sU1rOL51lcIz48ZQ==}
engines: {node: '>=20.9.0'}
cpu: [arm]
os: [linux]
libc: [glibc]
'@img/sharp-linux-ppc64@0.35.5':
resolution: {integrity: sha512-QVxAAq8evVRI9ia2vqgwrmWucn5Dfv+JdWzj75pD8omHLPSP7f8p20O8jxzjCcuCEQEOtYOZUmX1hkiZ0kdevA==}
engines: {node: '>=20.9.0'}
cpu: [ppc64]
os: [linux]
libc: [glibc]
'@img/sharp-linux-riscv64@0.35.5':
resolution: {integrity: sha512-LtdreXguaavKODPIfzJ4kffx7UNt1omwtK0rch4EBbbSTXPnxWmYSayXdLJw0fJzQ97kHt1gL/yh4tvU+nCyRQ==}
engines: {node: '>=20.9.0'}
cpu: [riscv64]
os: [linux]
libc: [glibc]
'@img/sharp-linux-s390x@0.35.5':
resolution: {integrity: sha512-UZasTOFiYzotTsGOCu42BfUzP6Tu6Do/947iRm1RsLKvlllxwGcn4RN27LibGWceix4Y+Pmw3jsnTcCQIgWjqA==}
engines: {node: '>=20.9.0'}
cpu: [s390x]
os: [linux]
libc: [glibc]
'@img/sharp-linux-x64@0.35.5':
resolution: {integrity: sha512-SxFtLTeJInhAA9Q836kux2vZNeOBQEx658qvbboZScr0wIARym3IcGmW7KpVD5sbVg0Ojy+udFQdayYIZyoNog==}
engines: {node: '>=20.9.0'}
cpu: [x64]
os: [linux]
libc: [glibc]
'@img/sharp-linuxmusl-arm64@0.35.5':
resolution: {integrity: sha512-9HbMclmI1zlNkFRs3z9/eBtDjfD0sGlrX1z6b1qwmiFY5ElDLh4BC0LPBdVp7z1DXFiKlIcznf+ZlsuZzLxQqg==}
engines: {node: '>=20.9.0'}
cpu: [arm64]
os: [linux]
libc: [musl]
'@img/sharp-linuxmusl-x64@0.35.5':
resolution: {integrity: sha512-4KOphqB035HrVdqLZfCgMzzERrQkkzOwRhl4OAkRO1YCldbaFjySXMaK534Mo0V+LndnlJk+sbUyLeU0ULyD1A==}
engines: {node: '>=20.9.0'}
cpu: [x64]
os: [linux]
libc: [musl]
'@img/sharp-wasm32@0.35.5':
resolution: {integrity: sha512-Ptsga1su4tQx+LLF1ECS9U6nz5kmrXKo6XVbtR48Ke3ZRxxgaWBu7IDtEe1quo8hiupwm6WFqxVlXaSf7IINGQ==}
engines: {node: '>=20.9.0'}
'@img/sharp-webcontainers-wasm32@0.35.5':
resolution: {integrity: sha512-hfhF/FmoQyTUkA0bIKFOtw536BQSeBMe6BF6QyWlrPxT754+TFLaZ7sKKTfvvM0yJgKgaYTwnFCIZ/GuDw5SUA==}
engines: {node: '>=20.9.0'}
cpu: [wasm32]
'@img/sharp-win32-arm64@0.35.5':
resolution: {integrity: sha512-X4t7g+7ZA5DKblCBEXGjUqqemj4vczING/5viFwAL8h4N3qYeyjwdCvRLHi4EdOUI+2Z7UFlp1VM+p/AuEtm6Q==}
engines: {node: '>=20.9.0'}
cpu: [arm64]
os: [win32]
'@img/sharp-win32-ia32@0.35.5':
resolution: {integrity: sha512-5Zm82LoBc43nhwNybZlG7Y1KO//Zhsn306fQl29ZOuStHLGTo3BWL83q3cznX0poxSAMuYL1On/BHBxkBeKr6A==}
engines: {node: ^20.9.0}
cpu: [ia32]
os: [win32]
'@img/sharp-win32-x64@0.35.5':
resolution: {integrity: sha512-x76eH0vEiHlcMQu8Y8IenntaACtddpT6W0wmXtWrnKcnKI7ME5DdgqhAD6SEWOEl1v2zDvkZDhFA9KnURwpfqg==}
engines: {node: '>=20.9.0'}
cpu: [x64]
os: [win32]
'@inquirer/ansi@2.0.8':
resolution: {integrity: sha512-WpQM+Ti6Z40EFwwt+uL2p4UabT+W179zHp6HhLVOzfbwnVn05IPO/eXIZXGNqcT1jbQ15SujNLzQ39k4QPPxBQ==}
engines: {node: '>=23.5.0 || ^22.13.0 || ^20.17.0'}
@ -549,6 +720,13 @@ packages:
'@nestjs/websockets': ^12.0.0
rxjs: ^7.1.0
'@nestjs/schedule@12.0.3':
resolution: {integrity: sha512-7G0HMYKXirWFoD72zY6ieSwwwe+AruJgHDR4BJ0pg0FseA0iR2q+e1c1T0Sv10uHNXT2xiPAFFnPa0yO4lY5eQ==}
engines: {node: '>=20.19.0'}
peerDependencies:
'@nestjs/common': ^11.0.0 || ^12.0.0
'@nestjs/core': ^11.0.0 || ^12.0.0
'@nestjs/schematics@12.0.6':
resolution: {integrity: sha512-2OG0BUhGPJqVvWFhiy+7oaQa4VQUvTS9Dw8YRfvweznl4KS3YyZrdPi4cVGuRAThoEIsbdfguZzSOv1+t8U1tg==}
engines: {node: ^22.22.3 || ^24.15.0 || >=26.0.0}
@ -967,6 +1145,9 @@ packages:
'@types/jsonwebtoken@9.0.10':
resolution: {integrity: sha512-asx5hIG9Qmf/1oStypjanR7iKTv0gXQ1Ov/jfrX6kS/EO0OFni8orbmGCn0672NHR3kXHwpAwR+B368ZGN/2rA==}
'@types/luxon@3.7.6':
resolution: {integrity: sha512-6KSjliQAXK8ZLgFQO4B7iE4Rpf/B3rItzCFuXezBY/XIAGxOdLd7vRNK9/StRPwiS/yJsVbB7HKpW46B8tcEuQ==}
'@types/methods@1.1.4':
resolution: {integrity: sha512-ymXWVrDiCxTBE3+RIrrP533E70eA+9qu7zdWoHuOmGujkYtzf4HQF96b8nwHLqhuf4ykX61IGRIB38CC6/sImQ==}
@ -1329,6 +1510,10 @@ packages:
resolution: {integrity: sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==}
engines: {node: '>= 0.10'}
cron@4.4.0:
resolution: {integrity: sha512-fkdfq+b+AHI4cKdhZlppHveI/mgz2qpiYxcm+t5E5TsxX7QrLS1VE0+7GENEk9z0EeGPcpSciGv6ez24duWhwQ==}
engines: {node: '>=18.x'}
cross-spawn@7.0.6:
resolution: {integrity: sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==}
engines: {node: '>= 8'}
@ -1981,6 +2166,10 @@ packages:
lru-memoizer@3.0.0:
resolution: {integrity: sha512-m83w/cYXLdUIboKSPxzPAGfYnk+vqeDYXuoSrQRw1q+yVEd8IXhvMufN8Q5TIPe7e2jyX4SRNrDJI2Skw1yznQ==}
luxon@3.7.2:
resolution: {integrity: sha512-vtEhXh/gNjI9Yg1u4jX/0YVPMvxzHuGgCm6tC5kZyb08yjGWGnqAjGJvcXbqQR2P3MyMEFnRbpcdFS6PBcLqew==}
engines: {node: '>=12'}
magic-string@0.30.21:
resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
@ -2400,6 +2589,15 @@ packages:
setprototypeof@1.2.0:
resolution: {integrity: sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==}
sharp@0.35.5:
resolution: {integrity: sha512-Ywn4OnzGukp7CDMrp08RQ50YKmuwG47brZgIVPTvBaaAfQlRlygrRqSrxdCiL9M+LlzLBiJ68IR1QqvzHyjC7g==}
engines: {node: '>=20.9.0'}
peerDependencies:
'@types/node': '*'
peerDependenciesMeta:
'@types/node':
optional: true
shebang-command@2.0.0:
resolution: {integrity: sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==}
engines: {node: '>=8'}
@ -2927,7 +3125,7 @@ snapshots:
'@angular-devkit/core@22.2.0(chokidar@5.0.0)':
dependencies:
ajv: 8.20.0
ajv-formats: 3.0.1(ajv@8.20.0)
ajv-formats: 3.0.1
jsonc-parser: 3.3.1
picomatch: 4.0.7
rxjs: 7.8.2
@ -2974,6 +3172,11 @@ snapshots:
'@colors/colors@1.5.0':
optional: true
'@emnapi/runtime@1.11.3':
dependencies:
tslib: 2.8.1
optional: true
'@fastify/busboy@3.2.2': {}
'@firebase/app-check-interop-types@0.3.5': {}
@ -3086,6 +3289,112 @@ snapshots:
yargs: 17.7.3
optional: true
'@img/colour@1.1.0': {}
'@img/sharp-darwin-arm64@0.35.5':
optionalDependencies:
'@img/sharp-libvips-darwin-arm64': 1.3.4
optional: true
'@img/sharp-darwin-x64@0.35.5':
optionalDependencies:
'@img/sharp-libvips-darwin-x64': 1.3.4
optional: true
'@img/sharp-freebsd-wasm32@0.35.5':
dependencies:
'@img/sharp-wasm32': 0.35.5
optional: true
'@img/sharp-libvips-darwin-arm64@1.3.4':
optional: true
'@img/sharp-libvips-darwin-x64@1.3.4':
optional: true
'@img/sharp-libvips-linux-arm64@1.3.4':
optional: true
'@img/sharp-libvips-linux-arm@1.3.4':
optional: true
'@img/sharp-libvips-linux-ppc64@1.3.4':
optional: true
'@img/sharp-libvips-linux-riscv64@1.3.4':
optional: true
'@img/sharp-libvips-linux-s390x@1.3.4':
optional: true
'@img/sharp-libvips-linux-x64@1.3.4':
optional: true
'@img/sharp-libvips-linuxmusl-arm64@1.3.4':
optional: true
'@img/sharp-libvips-linuxmusl-x64@1.3.4':
optional: true
'@img/sharp-linux-arm64@0.35.5':
optionalDependencies:
'@img/sharp-libvips-linux-arm64': 1.3.4
optional: true
'@img/sharp-linux-arm@0.35.5':
optionalDependencies:
'@img/sharp-libvips-linux-arm': 1.3.4
optional: true
'@img/sharp-linux-ppc64@0.35.5':
optionalDependencies:
'@img/sharp-libvips-linux-ppc64': 1.3.4
optional: true
'@img/sharp-linux-riscv64@0.35.5':
optionalDependencies:
'@img/sharp-libvips-linux-riscv64': 1.3.4
optional: true
'@img/sharp-linux-s390x@0.35.5':
optionalDependencies:
'@img/sharp-libvips-linux-s390x': 1.3.4
optional: true
'@img/sharp-linux-x64@0.35.5':
optionalDependencies:
'@img/sharp-libvips-linux-x64': 1.3.4
optional: true
'@img/sharp-linuxmusl-arm64@0.35.5':
optionalDependencies:
'@img/sharp-libvips-linuxmusl-arm64': 1.3.4
optional: true
'@img/sharp-linuxmusl-x64@0.35.5':
optionalDependencies:
'@img/sharp-libvips-linuxmusl-x64': 1.3.4
optional: true
'@img/sharp-wasm32@0.35.5':
dependencies:
'@emnapi/runtime': 1.11.3
optional: true
'@img/sharp-webcontainers-wasm32@0.35.5':
dependencies:
'@img/sharp-wasm32': 0.35.5
optional: true
'@img/sharp-win32-arm64@0.35.5':
optional: true
'@img/sharp-win32-ia32@0.35.5':
optional: true
'@img/sharp-win32-x64@0.35.5':
optional: true
'@inquirer/ansi@2.0.8': {}
'@inquirer/checkbox@5.2.5(@types/node@24.19.0)':
@ -3309,13 +3618,15 @@ snapshots:
ora: 5.4.1
undici: 6.20.1
'@nestjs/observe@0.1.10(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2)(reflect-metadata@0.2.2)(rxjs@7.8.2)':
'@nestjs/observe@0.1.10(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2)(@nestjs/schedule@12.0.3(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2))(reflect-metadata@0.2.2)(rxjs@7.8.2)':
dependencies:
'@jridgewell/trace-mapping': 0.3.31
'@nestjs/common': 12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0)
'@nestjs/core': 12.1.2(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/platform-express@12.1.2)(@nestjs/websockets@12.1.2)(reflect-metadata@0.2.2)(rxjs@7.8.2)
reflect-metadata: 0.2.2
rxjs: 7.8.2
optionalDependencies:
'@nestjs/schedule': 12.0.3(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2)
'@nestjs/platform-express@12.1.2(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2)(supports-color@7.2.0)':
dependencies:
@ -3341,6 +3652,12 @@ snapshots:
- supports-color
- utf-8-validate
'@nestjs/schedule@12.0.3(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/core@12.1.2)':
dependencies:
'@nestjs/common': 12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0)
'@nestjs/core': 12.1.2(@nestjs/common@12.1.2(class-transformer@0.5.1)(class-validator@0.15.1)(reflect-metadata@0.2.2)(rxjs@7.8.2)(supports-color@7.2.0))(@nestjs/platform-express@12.1.2)(@nestjs/websockets@12.1.2)(reflect-metadata@0.2.2)(rxjs@7.8.2)
cron: 4.4.0
'@nestjs/schematics@12.0.6(chokidar@5.0.0)(prettier@3.9.9)(typescript@6.0.3)':
dependencies:
'@angular-devkit/core': 22.2.0(chokidar@5.0.0)
@ -3630,6 +3947,8 @@ snapshots:
'@types/ms': 2.1.0
'@types/node': 24.19.0
'@types/luxon@3.7.6': {}
'@types/methods@1.1.4': {}
'@types/ms@2.1.0': {}
@ -3755,8 +4074,8 @@ snapshots:
agent-base@7.1.4: {}
ajv-formats@3.0.1(ajv@8.20.0):
optionalDependencies:
ajv-formats@3.0.1:
dependencies:
ajv: 8.20.0
ajv@8.20.0:
@ -3994,6 +4313,11 @@ snapshots:
object-assign: 4.1.1
vary: 1.1.2
cron@4.4.0:
dependencies:
'@types/luxon': 3.7.6
luxon: 3.7.2
cross-spawn@7.0.6:
dependencies:
path-key: 3.1.1
@ -4776,6 +5100,8 @@ snapshots:
lodash.clonedeep: 4.5.0
lru-cache: 11.5.3
luxon@3.7.2: {}
magic-string@0.30.21:
dependencies:
'@jridgewell/sourcemap-codec': 1.6.0
@ -5226,6 +5552,39 @@ snapshots:
setprototypeof@1.2.0: {}
sharp@0.35.5(@types/node@24.19.0):
dependencies:
'@img/colour': 1.1.0
detect-libc: 2.1.2
semver: 7.8.5
optionalDependencies:
'@img/sharp-darwin-arm64': 0.35.5
'@img/sharp-darwin-x64': 0.35.5
'@img/sharp-freebsd-wasm32': 0.35.5
'@img/sharp-libvips-darwin-arm64': 1.3.4
'@img/sharp-libvips-darwin-x64': 1.3.4
'@img/sharp-libvips-linux-arm': 1.3.4
'@img/sharp-libvips-linux-arm64': 1.3.4
'@img/sharp-libvips-linux-ppc64': 1.3.4
'@img/sharp-libvips-linux-riscv64': 1.3.4
'@img/sharp-libvips-linux-s390x': 1.3.4
'@img/sharp-libvips-linux-x64': 1.3.4
'@img/sharp-libvips-linuxmusl-arm64': 1.3.4
'@img/sharp-libvips-linuxmusl-x64': 1.3.4
'@img/sharp-linux-arm': 0.35.5
'@img/sharp-linux-arm64': 0.35.5
'@img/sharp-linux-ppc64': 0.35.5
'@img/sharp-linux-riscv64': 0.35.5
'@img/sharp-linux-s390x': 0.35.5
'@img/sharp-linux-x64': 0.35.5
'@img/sharp-linuxmusl-arm64': 0.35.5
'@img/sharp-linuxmusl-x64': 0.35.5
'@img/sharp-webcontainers-wasm32': 0.35.5
'@img/sharp-win32-arm64': 0.35.5
'@img/sharp-win32-ia32': 0.35.5
'@img/sharp-win32-x64': 0.35.5
'@types/node': 24.19.0
shebang-command@2.0.0:
dependencies:
shebang-regex: 3.0.0

View file

@ -1,6 +1,7 @@
import { Module } from '@nestjs/common';
import { APP_GUARD } from '@nestjs/core';
import { ConfigModule, ConfigService } from '@nestjs/config';
import { ScheduleModule } from '@nestjs/schedule';
import { TypeOrmModule } from '@nestjs/typeorm';
import { AppController } from './app.controller.js';
import { AppService } from './app.service.js';
@ -22,6 +23,8 @@ import { AuthModule } from './modules/auth/auth.module.js';
import { DispositivoModule } from './modules/dispositivo/dispositivo.module.js';
import { MantenimientoModule } from './modules/mantenimiento/mantenimiento.module.js';
import { ReportesModule } from './modules/reportes/reportes.module.js';
import { KardexModule } from './modules/kardex/kardex.module.js';
import { SesionWhatsappModule } from './modules/sesion-whatsapp/sesion-whatsapp.module.js';
import { RealtimeModule } from './common/realtime.module.js';
import { ServeStaticModule } from '@nestjs/serve-static';
@ -37,6 +40,7 @@ const __dirname = dirname(__filename);
isGlobal: true,
envFilePath: ['.env'],
}),
ScheduleModule.forRoot(),
ServeStaticModule.forRoot({
// '__dirname' apunta a la carpeta 'dist', por lo que subimos un nivel ('..')
rootPath: join(__dirname, '..', 'public'),
@ -71,6 +75,8 @@ const __dirname = dirname(__filename);
DispositivoModule,
MantenimientoModule,
ReportesModule,
KardexModule,
SesionWhatsappModule,
RealtimeModule,
],
controllers: [AppController],

View file

@ -39,4 +39,6 @@ export enum EstadoConvocatoria {
Abierto = 'Abierto',
Cubierto = 'Cubierto',
Cancelado = 'Cancelado',
/** Borrado lógico (6d): solo vía DELETE, nunca aparece en un find. */
Eliminado = 'Eliminado',
}

View file

@ -7,13 +7,25 @@ export type OpenwaSessionInfo = {
phone?: string;
};
/**
* Fallo de envío reportado por OpenWA. `httpStatus` acompaña al fallo HTTP
* (p. ej. 404 = la sesión ya no existe → el caller puede marcarla `ausente`);
* queda `undefined` cuando el HTTP fue 2xx pero el cuerpo trae estado de error.
*/
export class OpenwaSendError extends Error {
constructor(
message: string,
readonly httpStatus?: number,
) {
super(message);
this.name = 'OpenwaSendError';
}
}
@Injectable()
export class OpenwaService {
private readonly logger = new Logger(OpenwaService.name);
/** Índice de la rotación round-robin del pool OPENWA_SESSION_ID. */
private indiceRotacion = 0;
private get baseUrl(): string {
return (process.env.OPENWA_URL || '').replace(/\/$/, '');
}
@ -37,31 +49,13 @@ export class OpenwaService {
}
/**
* Única fuente: `OPENWA_SESSION_ID` del .env (también sirve como pool
* **coma-separado**). El PIN de login rota round-robin entre los ids
* para no concentrar todo el volumen en un solo número:
* - un id → siempre ese;
* - varios → siguiente del pool en cada envío;
* - vacío → `null` (el caller responde que no hay sesión).
*
* `configuracion.openwaSessionId` ya **no** se lee (fuente única .env).
* Sesiones existentes en OpenWA. El envío no lee esto directamente: la
* fuente es la tabla `sesion_whatsapp` (sync desde acá).
*/
resolveSessionId(): string | null {
const sesiones = (process.env.OPENWA_SESSION_ID ?? '')
.split(',')
.map((id) => id.trim())
.filter((id) => id.length > 0);
if (sesiones.length === 0) return null;
if (sesiones.length === 1) return sesiones[0];
const elegida = sesiones[this.indiceRotacion % sesiones.length];
this.indiceRotacion = (this.indiceRotacion + 1) % sesiones.length;
return elegida;
}
async listSessions(): Promise<OpenwaSessionInfo[]> {
const res = await fetch(`${this.baseUrl}/api/sessions`, {
headers: this.headers(),
signal: AbortSignal.timeout(10_000),
});
if (!res.ok) {
const body = await res.text();
@ -70,6 +64,14 @@ export class OpenwaService {
return (await res.json()) as OpenwaSessionInfo[];
}
/**
* Envía un texto por una sesión. Lanza `OpenwaSendError` cuando OpenWA no
* acepta el envío:
* - HTTP fuera de 2xx → `httpStatus` = código (404 = sesión inexistente);
* - HTTP 2xx pero el cuerpo trae estado de fallo (`error` / `status` en
* `error|failed|failure|rejected|fail`).
* El caller reintenta con la siguiente sesión hasta entregar.
*/
async sendText(chatId: string, text: string, sessionId: string): Promise<void> {
const path = this.sendPathTemplate.replace('{sessionId}', encodeURIComponent(sessionId));
const url = `${this.baseUrl}${path}`;
@ -78,16 +80,58 @@ export class OpenwaService {
headers: this.headers(),
// Body confirmado en esta Easy API: solo chatId + text
body: JSON.stringify({ chatId, text }),
signal: AbortSignal.timeout(15_000),
});
const bodyText = await res.text();
if (!res.ok) {
const body = await res.text();
throw new Error(`OpenWA sendText HTTP ${res.status} (${url}): ${body.slice(0, 300)}`);
throw new OpenwaSendError(
`OpenWA sendText HTTP ${res.status} (${url}): ${bodyText.slice(0, 300)}`,
res.status,
);
}
const fallo = this.detectarFalloEnvio(bodyText);
if (fallo) {
throw new OpenwaSendError(
`OpenWA rechazó el envío (${url}): ${fallo} — ${bodyText.slice(0, 300)}`,
res.status,
);
}
this.logger.log(`Mensaje enviado a ${chatId} (session=${sessionId})`);
}
/**
* Estado de envío en el cuerpo de la respuesta. `null` = sin fallo
* detectado (2xx sin JSON o con estado OK).
*/
private detectarFalloEnvio(bodyText: string): string | null {
if (!bodyText.trim()) return null;
let body: unknown;
try {
body = JSON.parse(bodyText);
} catch {
return null; // respuesta no-JSON: se da por aceptada (HTTP 2xx)
}
if (!body || typeof body !== 'object') return null;
const registro = body as Record<string, unknown>;
if (registro.error === true) return 'error=true';
if (typeof registro.error === 'string' && registro.error.length > 0) {
return `error=${registro.error}`;
}
const estado = String(registro.status ?? registro.state ?? '')
.trim()
.toLowerCase();
if (['error', 'failed', 'failure', 'rejected', 'fail'].includes(estado)) {
return `status=${estado}`;
}
return null;
}
/**
* Arma el chatId de WhatsApp OpenWA: `{codPais}{whatsapp}@c.us`
*/

View file

@ -0,0 +1,115 @@
import { readdir, stat, unlink, writeFile } from 'fs/promises';
import { join } from 'path';
import sharp from 'sharp';
const DEFAULT_MAX_KB = 100;
const START_QUALITY = 85;
const MIN_QUALITY = 40;
const QUALITY_STEP = 5;
const START_DIMENSION = 1024;
const MIN_DIMENSION = 256;
const DIMENSION_STEP = 256;
/** Límite de peso para fotos de perfil (`PROFILE_MAX_KB`, por defecto 100). */
export function getProfileMaxKb(): number {
const raw = process.env.PROFILE_MAX_KB?.trim();
if (!raw) return DEFAULT_MAX_KB;
const parsed = Number.parseInt(raw, 10);
return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_MAX_KB;
}
/** Nombre estable de la foto: una por persona, sin timestamp. */
export function profilePhotoFilename(idPersona: string): string {
return `${idPersona}.jpg`;
}
/** Ruta pública estable (con `?v=` para romper caché del cliente). */
export function profilePhotoPublicUrl(idPersona: string): string {
return `/uploads/profile/${profilePhotoFilename(idPersona)}?v=${Date.now()}`;
}
async function encodeJpeg(
filePath: string,
maxDimension: number,
quality: number,
): Promise<Buffer> {
return sharp(filePath)
.rotate()
.resize(maxDimension, maxDimension, {
fit: 'inside',
withoutEnlargement: true,
})
.jpeg({ quality, mozjpeg: true, progressive: true })
.toBuffer();
}
/**
* Deja la imagen en `filePath` como JPEG ≤ `PROFILE_MAX_KB`.
* Si ya es JPEG y no supera el tope, no la toca.
*/
export async function compressProfileImage(filePath: string): Promise<string> {
const maxBytes = getProfileMaxKb() * 1024;
const { size } = await stat(filePath);
if (size <= maxBytes) {
try {
const format = (await sharp(filePath).metadata()).format;
if (format === 'jpeg') return filePath;
} catch {
// Si no se puede leer, se reintenta abajo con reencode.
}
}
let dimension = START_DIMENSION;
while (dimension >= MIN_DIMENSION) {
let quality = START_QUALITY;
while (quality >= MIN_QUALITY) {
const buffer = await encodeJpeg(filePath, dimension, quality);
if (buffer.length <= maxBytes || quality <= MIN_QUALITY) {
await writeFile(filePath, buffer);
return filePath;
}
quality -= QUALITY_STEP;
}
dimension -= DIMENSION_STEP;
}
const buffer = await encodeJpeg(filePath, MIN_DIMENSION, MIN_QUALITY);
await writeFile(filePath, buffer);
return filePath;
}
/**
* Borra en `dir` cualquier archivo de esa persona distinto del actual
* (legado con timestamp u otros formatos). Solo toca `uploads/profile`.
*/
export async function removeOtherProfilePhotos(
idPersona: string,
keepFilename: string,
dir = 'uploads/profile',
): Promise<void> {
let entries: string[];
try {
entries = await readdir(dir);
} catch {
return;
}
for (const name of entries) {
if (name === keepFilename) continue;
const esDeEstaPersona =
name === idPersona ||
name.startsWith(`${idPersona}.`) ||
name.startsWith(`${idPersona}-`);
if (!esDeEstaPersona) continue;
await unlink(join(dir, name)).catch(() => undefined);
}
}
/** Borra TODOS los archivos de la persona en `dir` (quitar foto de perfil). */
export async function removeProfilePhotos(
idPersona: string,
dir = 'uploads/profile',
): Promise<void> {
await removeOtherProfilePhotos(idPersona, '__none__', dir);
}

View file

@ -321,10 +321,20 @@ export class AsistenciaService {
// Dev/SuperAdmin: sin scoping (toda la visibilidad del find; el rol
// del usuario puede ser Líder/Estaca y no debe acotar — matriz K).
if (!isDeveloper(user) && !isSuperAdmin(user)) {
// 6e: además de las filas propias / de MIS equipos, quien cubre
// un reemplazo ve la fila del titular (tipo='Reemplazo') y quien
// acepta apoyo (fila con idEquipo del equipo solicitante) sigue
// viendo LA SUYA por idPersona aunque no sea de su equipo.
const cubreReemplazo = `EXISTS (
SELECT 1 FROM reemplazo r
WHERE r."idReemplazo" = asistencia."idReemplazo"
AND r."idPersonaReemplazo" = :id
)`;
if (user.rol === Rol.Servidor) {
query = query.andWhere('asistencia."idPersona" = :id', {
id: user.idPersona,
});
query = query.andWhere(
`(asistencia."idPersona" = :id OR ${cubreReemplazo})`,
{ id: user.idPersona },
);
} else if (user.rol === Rol.Lider || user.rol === Rol.Estaca) {
const misEquipos = await this.equipoPersonaRepository
.createQueryBuilder('ep')
@ -334,11 +344,17 @@ export class AsistenciaService {
.getRawMany();
const ids = misEquipos.map((r: { idEquipo: string }) => r.idEquipo);
if (!ids.length) {
query = query.andWhere('1 = 0');
query = query.andWhere(
`(asistencia."idPersona" = :id OR ${cubreReemplazo})`,
{ id: user.idPersona },
);
} else {
query = query.andWhere('asistencia."idEquipo" IN (:...ids)', {
ids,
});
query = query.andWhere(
`(asistencia."idEquipo" IN (:...ids)
OR asistencia."idPersona" = :id
OR ${cubreReemplazo})`,
{ ids, id: user.idPersona },
);
}
}
}
@ -367,8 +383,9 @@ export class AsistenciaService {
idPersona: string;
nombres: string | null;
apellidos: string | null;
photoUrl: string | null;
}[] = await this.asistenciaRepository.manager.query(
`SELECT "idPersona", nombres, apellidos
`SELECT "idPersona", nombres, apellidos, "photoUrl"
FROM persona
WHERE "idPersona" = ANY($1::uuid[])`,
[`{${ids.join(',')}}`],
@ -380,8 +397,40 @@ export class AsistenciaService {
...r,
nombres: p?.nombres ?? null,
apellidos: p?.apellidos ?? null,
photoUrl: p?.photoUrl ?? null,
};
});
// 6e: flag de UI — la fila es "mía" si soy idPersona o si es el
// reemplazo que YO cubro (el cliente gobierna el botón de
// marcar con esto; el backend ya lo permite en puedeMarcar).
const idsReemplazo = [
...new Set(
result
.map((r) => r.idReemplazo)
.filter((x): x is string => x != null && x !== ''),
),
];
const cubiertos = idsReemplazo.length
? ((await this.asistenciaRepository.manager.query(
`SELECT "idReemplazo" FROM reemplazo
WHERE "idReemplazo" = ANY($1::uuid[])
AND "idPersonaReemplazo" = $2`,
[`{${idsReemplazo.join(',')}}`, user.idPersona],
)) as { idReemplazo: string }[])
: [];
const cubroSet = new Set(cubiertos.map((r) => r.idReemplazo));
data = (data as Record<string, unknown>[]).map((r) => ({
...r,
// El titular de una fila ya reemplazada (tipo='Reemplazo')
// NO la puede marcar (6e): el flag es para el reemplazante.
esFilaMia:
(r['idPersona'] === user.idPersona &&
r['tipo'] !== TipoAsistencia.Reemplazo) ||
(r['idReemplazo'] != null &&
r['idReemplazo'] !== '' &&
cubroSet.has(r['idReemplazo'] as string)),
}));
}
serviceResult.boolean = result.length > 0;
@ -505,18 +554,36 @@ export class AsistenciaService {
});
const estadoEquipo = se?.estado;
// Con el equipo 'Finalizado' no se admite ingreso (las faltas de los
// que no ingresaron ya las aplica el cierre). La salida del que sí
// ingresó sigue permitida ese día. Sin fila de equipo (servicio
// extraordinario) se usa `servicio.estado`.
// Sin fila de equipo (servicio extraordinario) se usa `servicio.estado`.
const estadoVivo = se
? estadoEquipo
: (servicio.estado as EstadoServicio | null);
if (dto.accion === 'ingreso' && estadoVivo === EstadoServicio.Finalizado) {
// Gate de iniciado (tanda fix Publicado): el equipo (o la raíz sin
// equipos) debe estar EnCurso para marcar. Finalizado admite solo la
// salida de quien ya ingresó (el ingreso lo rechaza el check de abajo).
// Publicado/Programado/Cancelado/Eliminado no marcan nada.
const permiteIngreso = estadoVivo === EstadoServicio.EnCurso;
const permiteSalida =
estadoVivo === EstadoServicio.EnCurso ||
estadoVivo === EstadoServicio.Finalizado;
if (dto.accion === 'ingreso') {
if (estadoVivo === EstadoServicio.Finalizado) {
serviceResult.message =
'El servicio ya está finalizado: no se puede registrar ingreso.';
return serviceResult;
}
if (!permiteIngreso) {
serviceResult.message =
'El servicio aún no está en curso: no se puede registrar ingreso.';
return serviceResult;
}
} else if (!permiteSalida) {
serviceResult.message =
'El servicio aún no está en curso: no se puede registrar salida.';
return serviceResult;
}
if (dto.metodo === MetodoMarcado.Geolocalizacion) {
if (!dto.coords) {
@ -757,9 +824,12 @@ export class AsistenciaService {
return this.esLiderDeLaFila(user, a);
}
// Servidor / otros: solo filas propias según tipo
// Servidor / otros: solo filas propias según tipo.
// 6e: con el reemplazo activo (tipo='Reemplazo') el titular quedó
// sustituido — solo lo marca el reemplazante (o los gates
// elevados de arriba).
if (a.idPersona === user.idPersona) {
return true;
return a.tipo !== TipoAsistencia.Reemplazo;
}
// Reemplazo: si hay reemplazo vinculado y el solicitante es el reemplazo

View file

@ -22,7 +22,7 @@ export class AuthController {
const apiResult = defaultApiResult(routeAuth.enviarOtp.title, routeAuth.enviarOtp.route);
try {
const result = await this.authService.enviarOtp(dto, false);
const result = await this.authService.enviarOtp(dto);
if (result.boolean) {
apiResult.status = 'correct';
@ -35,6 +35,9 @@ export class AuthController {
} else {
apiResult.code = HttpStatus.BAD_REQUEST;
apiResult.message = result.message;
// Señal estructurada en errores (p. ej. `codigoActivo`) para que la
// app reaccione sin parsear el mensaje.
apiResult.data = result.object ? [result.object] : [];
}
} catch (error) {
apiResult.code = error.status ?? HttpStatus.INTERNAL_SERVER_ERROR;
@ -50,7 +53,7 @@ export class AuthController {
const apiResult = defaultApiResult(routeAuth.reenviarOtp.title, routeAuth.reenviarOtp.route);
try {
const result = await this.authService.enviarOtp(dto, true);
const result = await this.authService.enviarOtp(dto);
if (result.boolean) {
apiResult.status = 'correct';
@ -62,6 +65,9 @@ export class AuthController {
} else {
apiResult.code = HttpStatus.BAD_REQUEST;
apiResult.message = result.message;
// Señal estructurada en errores (p. ej. `codigoActivo`) para que la
// app reaccione sin parsear el mensaje.
apiResult.data = result.object ? [result.object] : [];
}
} catch (error) {
apiResult.code = error.status ?? HttpStatus.INTERNAL_SERVER_ERROR;

View file

@ -4,12 +4,18 @@ import { AuthController } from './auth.controller.js';
import { AuthService } from './auth.service.js';
import { Persona } from '../persona/entities/persona.entity.js';
import { CodigoOtp } from '../codigo-otp/entities/codigo-otp.entity.js';
import { ConfiguracionModule } from '../configuracion/configuracion.module.js';
import { SesionWhatsappModule } from '../sesion-whatsapp/sesion-whatsapp.module.js';
import { HashService } from '../../common/services/hash.service.js';
import { TokenService } from '../../common/services/token.service.js';
import { OpenwaService } from '../../common/services/openwa.service.js';
@Module({
imports: [TypeOrmModule.forFeature([Persona, CodigoOtp])],
imports: [
TypeOrmModule.forFeature([Persona, CodigoOtp]),
ConfiguracionModule,
SesionWhatsappModule,
],
controllers: [AuthController],
providers: [AuthService, HashService, TokenService, OpenwaService],
exports: [TokenService],

View file

@ -5,7 +5,9 @@ import { Persona } from '../persona/entities/persona.entity.js';
import { CodigoOtp } from '../codigo-otp/entities/codigo-otp.entity.js';
import { HashService } from '../../common/services/hash.service.js';
import { TokenService } from '../../common/services/token.service.js';
import { OpenwaService } from '../../common/services/openwa.service.js';
import { OpenwaService, OpenwaSendError } from '../../common/services/openwa.service.js';
import { Configuracion } from '../configuracion/entities/configuracion.entity.js';
import { SesionWhatsappService } from '../sesion-whatsapp/sesion-whatsapp.service.js';
import {
defaultServiceResult,
ServiceResult,
@ -27,6 +29,9 @@ export class AuthService {
private readonly logger = new Logger(AuthService.name);
private readonly otpCache = new Map<string, OtpCacheEntry>();
/** Índice de la rotación round-robin entre las sesiones elegibles. */
private indiceRotacionOpenwa = 0;
constructor(
@InjectRepository(Persona)
private personaRepository: Repository<Persona>,
@ -35,9 +40,12 @@ export class AuthService {
private hashService: HashService,
private tokenService: TokenService,
private openwaService: OpenwaService,
@InjectRepository(Configuracion)
private configuracionRepository: Repository<Configuracion>,
private sesionWhatsappService: SesionWhatsappService,
) {}
async enviarOtp(dto: EnviarOtpDto, isResend = false): Promise<ServiceResult> {
async enviarOtp(dto: EnviarOtpDto): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
const persona = await this.personaRepository.findOneBy({
@ -79,14 +87,20 @@ export class AuthService {
.orderBy('otp."fecCreacion"', 'DESC')
.getOne();
if (activo) {
if (activo && activo.enviado) {
const cache = this.otpCache.get(persona.idPersona);
const cacheVigente = !!cache && cache.expiraEn > Date.now();
// Reenviar: si tenemos el código en memoria, manda EL MISMO (no crea otro)
if (isResend && cacheVigente) {
// Idempotente: si el código sigue en caché, reenvía EL MISMO (no crea
// otro). Cubre el caso en que la app no recibió la respuesta del primer
// envío (red/lento) y el usuario vuelve a tocar "Pedir código".
if (cacheVigente) {
try {
await this.sendOtpViaOpenwa(persona, cache.codigo);
const sessionId = await this.sendOtpViaOpenwa(persona, cache.codigo);
await this.codigoOtpRepository.update(activo.idOtp, {
fecEnvio: new Date(),
sessionIdEnvio: sessionId,
});
} catch (error) {
this.logger.error(`Error OpenWA: ${error.message}`);
serviceResult.message = `No se pudo reenviar el código: ${error.message}`;
@ -104,15 +118,32 @@ export class AuthService {
return serviceResult;
}
// Ya hay código vigente → NO crear otro
// Código enviado y vigente en BD pero sin caché (p. ej. reinicio del
// server): no se puede reenviar el mismo. Respuesta `boolean=true`
// con `codigoActivo` para que el frontend salte a la pantalla de
// ingreso sin pintar un error — el PIN ya salió hacia el usuario.
const expira = new Date(activo.fecExpiracion);
const hhmm = `${String(expira.getHours()).padStart(2, '0')}:${String(
expira.getMinutes(),
).padStart(2, '0')}`;
serviceResult.boolean = true;
serviceResult.message = `Ya existe un código activo válido hasta las ${hhmm}. Úselo o espere a que expire para solicitar uno nuevo.`;
serviceResult.number = 1;
serviceResult.object = {
codigoActivo: true,
expiraEn: activo.fecExpiracion.toISOString(),
};
return serviceResult;
}
if (activo) {
// `enviado=false`: el PIN nunca llegó al usuario (falló el envío o la
// app mostró un falso error). Se invalida y se emite uno nuevo en vez
// de bloquear con "ya existe un código activo".
await this.codigoOtpRepository.update(activo.idOtp, { usado: true });
this.otpCache.delete(persona.idPersona);
}
// Sin código vigente → crear uno nuevo
const codigo = this.generateOtpCode();
const codigoHash = await this.hashService.hashText(codigo);
@ -121,7 +152,8 @@ export class AuthService {
fecCreacion.getTime() + OTP_EXPIRATION_MINUTES * 60_000,
);
await this.codigoOtpRepository.manager.transaction(async (manager) => {
const idOtpNuevo = await this.codigoOtpRepository.manager.transaction(
async (manager) => {
await manager
.createQueryBuilder()
.update(CodigoOtp)
@ -130,15 +162,18 @@ export class AuthService {
.andWhere('usado = :usado', { usado: false })
.execute();
await manager.save(CodigoOtp, {
const guardado = await manager.save(CodigoOtp, {
idPersona: persona.idPersona,
codigoHash,
intentosFallidos: 0,
fecCreacion,
fecExpiracion,
usado: false,
enviado: false,
});
});
return guardado.idOtp;
},
);
this.otpCache.set(persona.idPersona, {
codigo,
@ -146,7 +181,12 @@ export class AuthService {
});
try {
await this.sendOtpViaOpenwa(persona, codigo);
const sessionId = await this.sendOtpViaOpenwa(persona, codigo);
await this.codigoOtpRepository.update(idOtpNuevo, {
enviado: true,
sessionIdEnvio: sessionId,
fecEnvio: new Date(),
});
} catch (error) {
this.logger.error(`Error OpenWA: ${error.message}`);
serviceResult.message = `No se pudo enviar el código por WhatsApp: ${error.message}`;
@ -343,13 +383,23 @@ export class AuthService {
): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
// Vacío → null: la columna fecNac es `date` y rechaza ''.
const aNull = (v?: string) => {
const t = v?.trim();
return t ? t : null;
};
const clean: Partial<Persona> = {};
if (dto.nombres !== undefined) clean.nombres = dto.nombres;
if (dto.apellidos !== undefined) clean.apellidos = dto.apellidos;
if (dto.photoUrl !== undefined) clean.photoUrl = dto.photoUrl;
if (dto.fecNac !== undefined) clean.fecNac = dto.fecNac;
if (dto.ci !== undefined) clean.ci = dto.ci;
if (dto.complemento !== undefined) clean.complemento = dto.complemento;
if (dto.nombres !== undefined) clean.nombres = aNull(dto.nombres) ?? '';
if (dto.apellidos !== undefined) {
clean.apellidos = aNull(dto.apellidos) ?? '';
}
if (dto.photoUrl !== undefined) clean.photoUrl = aNull(dto.photoUrl);
if (dto.fecNac !== undefined) clean.fecNac = aNull(dto.fecNac);
if (dto.ci !== undefined) clean.ci = aNull(dto.ci);
if (dto.complemento !== undefined) {
clean.complemento = aNull(dto.complemento);
}
if (Object.keys(clean).length === 0) {
serviceResult.message = 'No hay campos para actualizar.';
@ -372,25 +422,90 @@ export class AuthService {
return String(Math.floor(1000 + Math.random() * 9000));
}
/**
* Entrega el PIN garantizando el envío: recorre las sesiones elegibles
* (tabla `sesion_whatsapp` activa + `ready`; si no hay, fallback a
* `configuracion.openwaSessionId`) en orden round-robin y, si una falla,
* reintenta con la siguiente hasta que alguna lo acepte.
* Devuelve el sessionId que realmente lo entregó.
*/
private async sendOtpViaOpenwa(
persona: Persona,
codigo: string,
): Promise<void> {
// Fuente única: OPENWA_SESSION_ID del .env (pool coma-separado con
// rotación round-robin; la BD ya no participa).
const sessionId = this.openwaService.resolveSessionId();
): Promise<string> {
const candidatas = await this.resolverSesiones();
if (!sessionId) {
if (candidatas.length === 0) {
throw new Error(
'No hay sessionId de OpenWA: definí OPENWA_SESSION_ID en .env (un id o una lista coma-separada).',
'No hay sesiones de WhatsApp disponibles: active una en sesion-whatsapp o configure openwaSessionId.',
);
}
const orden = this.rotar(candidatas);
const chatId = this.openwaService.buildChatId(
persona.codPais,
persona.whatsapp,
);
const text = `*Tu código de acceso es:* ${codigo}.\n🏛️ *_Ministerio Ser Ekklesia_*\n\n🔐 \n⏳ *Caduca en ${OTP_EXPIRATION_MINUTES} minutos.*\n\n🙏 No compartas este código con nadie.`;
let ultimoError: Error | undefined;
for (const sessionId of orden) {
try {
await this.openwaService.sendText(chatId, text, sessionId);
return sessionId;
} catch (error) {
ultimoError = error;
this.logger.warn(
`Envío de OTP falló con session=${sessionId}: ${error.message}`,
);
// Sesión que OpenWA ya no reconoce (404, o 400 "not active"): sale
// del pool hasta el próximo sync, sin esperar a un Developer.
if (error instanceof OpenwaSendError && this.esSesionInexistente(error)) {
await this.sesionWhatsappService.marcarAusente(sessionId);
}
}
}
throw new Error(
`No se pudo enviar el OTP con ninguna sesión (${orden.length} intentada(s)): ${ultimoError?.message ?? 'error desconocido'}`,
);
}
/**
* Candidatas al envío: primero las sesiones seleccionadas en la BD
* (`activo` + `ready`); si no hay ninguna, fallback de solo lectura a
* `configuracion.openwaSessionId` (acepta id único o lista coma-separada).
*/
private async resolverSesiones(): Promise<string[]> {
const activas = await this.sesionWhatsappService.getIdsParaEnvio();
if (activas.length > 0) return activas;
const configuracion = await this.configuracionRepository.findOneBy({});
return (configuracion?.openwaSessionId ?? '')
.split(',')
.map((id) => id.trim())
.filter((id) => id.length > 0);
}
/** Orden round-robin: empieza en la siguiente del pool y recorre todas. */
private rotar(sesiones: string[]): string[] {
const inicio = this.indiceRotacionOpenwa % sesiones.length;
this.indiceRotacionOpenwa = (this.indiceRotacionOpenwa + 1) % sesiones.length;
return [...sesiones.slice(inicio), ...sesiones.slice(0, inicio)];
}
/**
* OpenWA responde 404 o 400 "Session … is not active / start the
* session" cuando el id ya no existe: en ese caso la fila local queda
* desactualizada y se marca `ausente`.
*/
private esSesionInexistente(error: OpenwaSendError): boolean {
if (error.httpStatus === 404) return true;
if (error.httpStatus === 400) {
return /not active|not found|does not exist|start the session/i.test(
error.message,
);
}
return false;
}
}

View file

@ -37,27 +37,35 @@ export class LoginDto {
}
export class UpdatePerfilDto {
// Sin @IsOptional el ValidationPipe (whitelist) exigía TODOS los campos:
// el sheet de Datos omite photoUrl → 400 y no se guardaba fecNac/ci/complemento.
@ApiProperty({ required: false })
@IsString()
@IsOptional()
nombres?: string;
@ApiProperty({ required: false })
@IsString()
@IsOptional()
apellidos?: string;
@ApiProperty({ required: false })
@IsString()
@IsOptional()
photoUrl?: string;
@ApiProperty({ required: false })
@IsString()
@IsOptional()
fecNac?: string;
@ApiProperty({ required: false })
@IsString()
@IsOptional()
ci?: string;
@ApiProperty({ required: false })
@IsString()
@IsOptional()
complemento?: string;
}

View file

@ -22,4 +22,20 @@ export class CodigoOtp {
@Column({ default: false })
usado: boolean;
/**
* OpenWA aceptó el envío del PIN. `false` = el usuario nunca lo recibió,
* de modo que un nuevo pedido lo reemplaza en vez de bloquearlo con
* "ya existe un código activo".
*/
@Column({ default: false })
enviado: boolean;
/** Sesión de OpenWA que entregó el PIN (último envío exitoso). */
@Column({ type: 'varchar', nullable: true })
sessionIdEnvio?: string | null;
/** Fecha/hora del último envío exitoso. */
@Column({ type: 'timestamptz', nullable: true })
fecEnvio?: Date | null;
}

View file

@ -31,9 +31,10 @@ export class Configuracion {
/**
* SessionId de OpenWA (Easy API).
*
* **Sin uso en el envío de PIN** desde la tanda de rotación: la fuente
* única es `OPENWA_SESSION_ID` del .env (pool coma-separado). Se conserva
* el campo por compatibilidad con datos/configuración existentes.
* **Fallback de solo lectura** para el envío de PIN: si la tabla
* `sesion_whatsapp` no tiene ninguna activa, se usan estos ids (acepta
* lista coma-separada). La fuente principal es `sesion_whatsapp`.
* No se modifica desde el flujo de envío.
*/
@Column({ type: 'varchar', nullable: true })
openwaSessionId?: string | null;

View file

@ -7,8 +7,8 @@ export class DispositivoDto {
@IsNotEmpty()
token: string;
@ApiProperty({ enum: ['android', 'ios'], default: 'android' })
@IsIn(['android', 'ios'])
@ApiProperty({ enum: ['android', 'ios', 'web'], default: 'android' })
@IsIn(['android', 'ios', 'web'])
@IsOptional()
plataforma?: string;

View file

@ -0,0 +1,119 @@
import { ApiProperty } from '@nestjs/swagger';
import {
ArrayMaxSize,
IsArray,
IsBoolean,
IsNotEmpty,
IsOptional,
IsString,
ValidateIf,
ValidateNested,
} from 'class-validator';
import { Type } from 'class-transformer';
export class LiderCelulaItemDto {
@ApiProperty({ example: 'Juan Pérez' })
@IsString()
@IsNotEmpty()
lider: string;
@ApiProperty({ example: '71234567' })
@IsString()
@IsNotEmpty()
celular: string;
}
/**
* Body de PATCH /v1/kardex/:idPersona — todos los campos opcionales
* (upsert: crea la fila si no existe).
*/
export class KardexDto {
@ApiProperty({ required: false })
@IsOptional()
@IsString()
email?: string | null;
@ApiProperty({ required: false })
@IsOptional()
@IsString()
domicilio?: string | null;
@ApiProperty({ required: false })
@IsOptional()
@IsString()
zona?: string | null;
@ApiProperty({ required: false })
@IsOptional()
@IsString()
profesion?: string | null;
@ApiProperty({ required: false })
@IsOptional()
@IsString()
estadoCivil?: string | null;
@ApiProperty({ required: false })
@IsOptional()
@IsBoolean()
bautizoAgua?: boolean | null;
@ApiProperty({ required: false })
@IsOptional()
@IsBoolean()
academia?: boolean | null;
@ApiProperty({ required: false })
@IsOptional()
@IsBoolean()
lanzamiento?: boolean | null;
@ApiProperty({ required: false })
@IsOptional()
@IsBoolean()
esLiderCelula?: boolean | null;
@ApiProperty({ required: false })
@IsOptional()
@IsBoolean()
esLiderDiscipulado?: boolean | null;
@ApiProperty({ required: false })
@IsOptional()
@IsBoolean()
asisteEncuentro?: boolean | null;
@ApiProperty({ required: false })
@IsOptional()
@IsBoolean()
asisteCelula?: boolean | null;
@ApiProperty({ required: false })
@IsOptional()
@IsBoolean()
asisteDiscipulado?: boolean | null;
@ApiProperty({ required: false })
@IsOptional()
@IsString()
redPertenece?: string | null;
/**
* Lista de líderes de célula (máx. 2). El service la serializa a JSON
* string antes de persistir en `lideresCelula`.
*/
@ApiProperty({
required: false,
type: [LiderCelulaItemDto],
description: 'Máximo 2 elementos: [{ lider, celular }]',
})
@IsOptional()
@ValidateIf((o) => o.lideresCelula !== null && o.lideresCelula !== undefined)
@IsArray()
@ArrayMaxSize(2, {
message: 'lideresCelula admite como máximo 2 elementos.',
})
@ValidateNested({ each: true })
@Type(() => LiderCelulaItemDto)
lideresCelula?: LiderCelulaItemDto[] | null;
}

View file

@ -0,0 +1,4 @@
import { PartialType } from '@nestjs/mapped-types';
import { KardexDto } from './kardex.dto.js';
export class UpdateKardexDto extends PartialType(KardexDto) {}

View file

@ -0,0 +1,64 @@
import { Entity, PrimaryGeneratedColumn, Column, Unique } from 'typeorm';
/**
* Ficha de ministerio / discipulado de una persona (1:1).
* Todos los campos son opcionales: la fila se crea en el primer PATCH.
*/
@Entity('kardex')
@Unique(['idPersona'])
export class Kardex {
@PrimaryGeneratedColumn('uuid')
idKardex: string;
@Column({ type: 'uuid' })
idPersona: string;
@Column({ type: 'varchar', nullable: true })
email?: string | null;
@Column({ type: 'varchar', nullable: true })
domicilio?: string | null;
@Column({ type: 'varchar', nullable: true })
zona?: string | null;
@Column({ type: 'varchar', nullable: true })
profesion?: string | null;
@Column({ type: 'varchar', nullable: true })
estadoCivil?: string | null;
@Column({ type: 'boolean', nullable: true })
bautizoAgua?: boolean | null;
@Column({ type: 'boolean', nullable: true })
academia?: boolean | null;
@Column({ type: 'boolean', nullable: true })
lanzamiento?: boolean | null;
@Column({ type: 'boolean', nullable: true })
esLiderCelula?: boolean | null;
@Column({ type: 'boolean', nullable: true })
esLiderDiscipulado?: boolean | null;
@Column({ type: 'boolean', nullable: true })
asisteEncuentro?: boolean | null;
@Column({ type: 'boolean', nullable: true })
asisteCelula?: boolean | null;
@Column({ type: 'boolean', nullable: true })
asisteDiscipulado?: boolean | null;
@Column({ type: 'varchar', nullable: true })
redPertenece?: string | null;
/**
* JSON string de máx. 2 items `[{ lider, celular }, ...]`.
* El front arma la lista; el back valida el tope al guardar.
*/
@Column({ type: 'varchar', nullable: true })
lideresCelula?: string | null;
}

View file

@ -0,0 +1,99 @@
import { Body, Controller, Get, HttpStatus, Param, Patch, Req } from '@nestjs/common';
import { ApiBearerAuth, ApiTags } from '@nestjs/swagger';
import { KardexService } from './kardex.service.js';
import { KardexDto } from './dto/kardex.dto.js';
import {
ApiResult,
defaultApiResult,
} from '../../common/interfaces/api.result.js';
import { routeKardex } from './kardex.router.js';
import type { AuthRequest } from '../../common/utils/auth-user.js';
import { getAuthUser } from '../../common/utils/auth-user.js';
@ApiTags('kardex')
@ApiBearerAuth()
@Controller('kardex')
export class KardexController {
constructor(private readonly kardexService: KardexService) {}
// Sin @Roles: el permiso lo decide el service (propio / Líder del equipo /
// SuperAdmin / Developer). Un guard de rol bloquearía al SuperAdmin o al propio.
@Get(':idPersona')
async findOne(
@Req() req: AuthRequest,
@Param('idPersona') idPersona: string,
): Promise<ApiResult> {
const apiResult = defaultApiResult(
routeKardex.one.title,
routeKardex.one.route,
);
try {
const user = getAuthUser(req);
if (!user) {
apiResult.code = HttpStatus.UNAUTHORIZED;
apiResult.message = 'Token inválido.';
return apiResult;
}
const result = await this.kardexService.findOne(idPersona, user);
if (result.boolean) {
apiResult.status = 'correct';
apiResult.code = HttpStatus.OK;
apiResult.message = result.message;
apiResult.boolean = true;
apiResult.rows = result.number;
apiResult.data = result.object ? [result.object] : [];
} else {
apiResult.code = HttpStatus.BAD_REQUEST;
apiResult.message = result.message;
}
} catch (error) {
apiResult.code = error.status ?? HttpStatus.INTERNAL_SERVER_ERROR;
apiResult.message = error.message;
}
return apiResult;
}
@Patch(':idPersona')
async update(
@Req() req: AuthRequest,
@Param('idPersona') idPersona: string,
@Body() dto: KardexDto,
): Promise<ApiResult> {
const apiResult = defaultApiResult(
routeKardex.update.title,
routeKardex.update.route,
);
try {
const user = getAuthUser(req);
if (!user) {
apiResult.code = HttpStatus.UNAUTHORIZED;
apiResult.message = 'Token inválido.';
return apiResult;
}
const result = await this.kardexService.update(idPersona, dto, user);
if (result.boolean) {
apiResult.status = 'correct';
apiResult.code = HttpStatus.OK;
apiResult.message = result.message;
apiResult.boolean = true;
apiResult.rows = result.number;
apiResult.data = result.object ? [result.object] : [];
} else {
apiResult.code = HttpStatus.BAD_REQUEST;
apiResult.message = result.message;
}
} catch (error) {
apiResult.code = error.status ?? HttpStatus.INTERNAL_SERVER_ERROR;
apiResult.message = error.message;
}
return apiResult;
}
}

View file

@ -0,0 +1,15 @@
import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { Kardex } from './entities/kardex.entity.js';
import { Persona } from '../persona/entities/persona.entity.js';
import { EquipoPersona } from '../equipo-persona/entities/equipo-persona.entity.js';
import { KardexService } from './kardex.service.js';
import { KardexController } from './kardex.controller.js';
@Module({
imports: [TypeOrmModule.forFeature([Kardex, Persona, EquipoPersona])],
exports: [KardexService],
controllers: [KardexController],
providers: [KardexService],
})
export class KardexModule {}

View file

@ -0,0 +1,10 @@
export const routeKardex = {
one: {
route: '[GET].../v1/kardex/:idPersona',
title: 'Find One Kardex by Persona',
},
update: {
route: '[PATCH].../v1/kardex/:idPersona',
title: 'Upsert Kardex',
},
};

View file

@ -0,0 +1,174 @@
import { Injectable } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Repository } from 'typeorm';
import { Kardex } from './entities/kardex.entity.js';
import { KardexDto, LiderCelulaItemDto } from './dto/kardex.dto.js';
import { Persona } from '../persona/entities/persona.entity.js';
import { EquipoPersona } from '../equipo-persona/entities/equipo-persona.entity.js';
import {
defaultServiceResult,
ServiceResult,
} from '../../common/interfaces/service.result.js';
import {
AuthUser,
isDeveloper,
isSuperAdmin,
} from '../../common/utils/auth-user.js';
import { Rol } from '../../common/enums/rol.enum.js';
import { EstadoMiembro, EstadoGeneral } from '../../common/enums/estados.enum.js';
@Injectable()
export class KardexService {
constructor(
@InjectRepository(Kardex)
private kardexRepository: Repository<Kardex>,
@InjectRepository(Persona)
private personaRepository: Repository<Persona>,
@InjectRepository(EquipoPersona)
private equipoPersonaRepository: Repository<EquipoPersona>,
) {}
async findOne(idPersona: string, user: AuthUser): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
const persona = await this.personaRepository.findOneBy({ idPersona });
if (!persona || persona.estado === EstadoGeneral.Eliminado) {
serviceResult.message = 'No existe la persona.';
return serviceResult;
}
const ok = await this.puedeAcceder(user, idPersona);
if (!ok) {
serviceResult.message = 'No tiene permiso para ver este kardex.';
return serviceResult;
}
const kardex = await this.kardexRepository.findOneBy({ idPersona });
serviceResult.boolean = true;
serviceResult.message = kardex
? 'Kardex encontrado.'
: 'La persona aún no tiene kardex.';
serviceResult.number = kardex ? 1 : 0;
serviceResult.object = kardex;
serviceResult.data = kardex ? [kardex] : [];
return serviceResult;
}
/**
* Upsert: crea la fila si no existe; actualiza solo los campos enviados.
* Permisos: propia, Líder del equipo de la persona, SuperAdmin o Developer.
*/
async update(
idPersona: string,
dto: KardexDto,
user: AuthUser,
): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
const persona = await this.personaRepository.findOneBy({ idPersona });
if (!persona || persona.estado === EstadoGeneral.Eliminado) {
serviceResult.message = 'No existe la persona.';
return serviceResult;
}
const ok = await this.puedeAcceder(user, idPersona);
if (!ok) {
serviceResult.message = 'No tiene permiso para editar este kardex.';
return serviceResult;
}
const clean = this.buildCleanFields(dto);
if (Object.keys(clean).length === 0) {
serviceResult.message = 'No hay cambios para guardar.';
return serviceResult;
}
const existente = await this.kardexRepository.findOneBy({ idPersona });
let result: Kardex;
if (existente) {
await this.kardexRepository.update(existente.idKardex, clean);
result = (await this.kardexRepository.findOneBy({
idPersona,
})) as Kardex;
serviceResult.message = 'Kardex actualizado correctamente.';
} else {
const entity = this.kardexRepository.create({
idPersona,
...clean,
});
result = await this.kardexRepository.save(entity);
serviceResult.message = 'Kardex creado correctamente.';
}
serviceResult.boolean = true;
serviceResult.number = 1;
serviceResult.object = result;
serviceResult.data = [result];
return serviceResult;
}
private buildCleanFields(dto: KardexDto): Partial<Kardex> {
const clean: Partial<Kardex> = {};
const campos: (keyof KardexDto)[] = [
'email',
'domicilio',
'zona',
'profesion',
'estadoCivil',
'bautizoAgua',
'academia',
'lanzamiento',
'esLiderCelula',
'esLiderDiscipulado',
'asisteEncuentro',
'asisteCelula',
'asisteDiscipulado',
'redPertenece',
];
for (const campo of campos) {
if (dto[campo] !== undefined) {
(clean as Record<string, unknown>)[campo] = dto[campo];
}
}
if (dto.lideresCelula !== undefined) {
clean.lideresCelula =
dto.lideresCelula === null
? null
: JSON.stringify(dto.lideresCelula as LiderCelulaItemDto[]);
}
return clean;
}
/**
* Mismo criterio de edición de Persona: propio, Líder de SU equipo,
* SuperAdmin o Developer (bypass del guard).
*/
private async puedeAcceder(
user: AuthUser,
idPersonaObjetivo: string,
): Promise<boolean> {
if (isDeveloper(user) || isSuperAdmin(user)) return true;
if (user.idPersona === idPersonaObjetivo) return true;
if (user.rol !== Rol.Lider) return false;
const miEquipo = await this.equipoPersonaRepository.findOneBy({
idPersona: user.idPersona,
estado: EstadoMiembro.Activo,
});
if (!miEquipo) return false;
const delObjetivo = await this.equipoPersonaRepository.findOneBy({
idPersona: idPersonaObjetivo,
idEquipo: miEquipo.idEquipo,
estado: EstadoMiembro.Activo,
});
return !!delObjetivo;
}
}

View file

@ -11,6 +11,7 @@ import { Dispositivo } from '../dispositivo/entities/dispositivo.entity.js';
import { EquipoPersona } from '../equipo-persona/entities/equipo-persona.entity.js';
import { Equipo } from '../equipo/entities/equipo.entity.js';
import { Persona } from '../persona/entities/persona.entity.js';
import { Kardex } from '../kardex/entities/kardex.entity.js';
import { Reemplazo } from '../reemplazo/entities/reemplazo.entity.js';
import { ServicioEquipo } from '../servicio-equipo/entities/servicio-equipo.entity.js';
import { ServicioTurno } from '../servicio-turno/entities/servicio-turno.entity.js';
@ -66,6 +67,7 @@ export class BackupService {
@InjectRepository(Servicio) private servicioRepo: Repository<Servicio>,
@InjectRepository(Turno) private turnoRepo: Repository<Turno>,
@InjectRepository(Persona) private personaRepo: Repository<Persona>,
@InjectRepository(Kardex) private kardexRepo: Repository<Kardex>,
@InjectRepository(Backup) private backupRepo: Repository<Backup>,
@InjectRepository(Configuracion)
private configuracionRepo: Repository<Configuracion>,
@ -200,6 +202,11 @@ export class BackupService {
repo: this.dispositivoRepo,
fragmentos: { personas: '"idPersona" IS NOT NULL' },
},
{
nombre: 'kardex',
repo: this.kardexRepo,
fragmentos: { personas: '"idPersona" IS NOT NULL' },
},
{
nombre: 'servicio_equipo',
repo: this.servicioEquipoRepo,

View file

@ -6,6 +6,7 @@ import { Dispositivo } from '../dispositivo/entities/dispositivo.entity.js';
import { EquipoPersona } from '../equipo-persona/entities/equipo-persona.entity.js';
import { Equipo } from '../equipo/entities/equipo.entity.js';
import { Persona } from '../persona/entities/persona.entity.js';
import { Kardex } from '../kardex/entities/kardex.entity.js';
import { Reemplazo } from '../reemplazo/entities/reemplazo.entity.js';
import { ServicioEquipo } from '../servicio-equipo/entities/servicio-equipo.entity.js';
import { ServicioTurno } from '../servicio-turno/entities/servicio-turno.entity.js';
@ -35,6 +36,7 @@ import { ApkService } from './apk.service.js';
Servicio,
Turno,
Persona,
Kardex,
Backup,
Apk,
Configuracion,

View file

@ -7,6 +7,7 @@ import { Dispositivo } from '../dispositivo/entities/dispositivo.entity.js';
import { EquipoPersona } from '../equipo-persona/entities/equipo-persona.entity.js';
import { Equipo } from '../equipo/entities/equipo.entity.js';
import { Persona } from '../persona/entities/persona.entity.js';
import { Kardex } from '../kardex/entities/kardex.entity.js';
import { Reemplazo } from '../reemplazo/entities/reemplazo.entity.js';
import { ServicioEquipo } from '../servicio-equipo/entities/servicio-equipo.entity.js';
import { ServicioTurno } from '../servicio-turno/entities/servicio-turno.entity.js';
@ -56,6 +57,7 @@ export class MantenimientoService {
@InjectRepository(Servicio) private servicioRepo: Repository<Servicio>,
@InjectRepository(Turno) private turnoRepo: Repository<Turno>,
@InjectRepository(Persona) private personaRepo: Repository<Persona>,
@InjectRepository(Kardex) private kardexRepo: Repository<Kardex>,
) {}
/// Orden = orden de borrado (hijos primero). `1 = 1` = tabla completa.
@ -106,6 +108,11 @@ export class MantenimientoService {
repo: this.dispositivoRepo,
fragmentos: { personas: '"idPersona" IS NOT NULL' },
},
{
nombre: 'kardex',
repo: this.kardexRepo,
fragmentos: { personas: '"idPersona" IS NOT NULL' },
},
{
nombre: 'servicio_equipo',
repo: this.servicioEquipoRepo,

View file

@ -20,6 +20,7 @@ export class Persona {
@Column()
whatsapp: string;
/** Ruta pública de la foto, p. ej. `/uploads/profile/<idPersona>.jpg?v=…`. */
@Column({ type: 'varchar', nullable: true })
photoUrl?: string | null;

View file

@ -1,4 +1,5 @@
import { mkdirSync } from 'fs';
import { join } from 'path';
import type { Request } from 'express';
import {
Body,
@ -36,6 +37,13 @@ import {
} from '../../common/enums/rol.enum.js';
import type { AuthRequest } from '../../common/utils/auth-user.js';
import { getAuthUser } from '../../common/utils/auth-user.js';
import {
compressProfileImage,
profilePhotoFilename,
profilePhotoPublicUrl,
removeOtherProfilePhotos,
removeProfilePhotos,
} from '../../common/utils/compress-profile-image.js';
type UploadedImageFile = {
filename: string;
@ -425,12 +433,15 @@ export class PersonaController {
FileInterceptor('image', {
storage: diskStorage({
destination: (_req: Request, _file, callback) => {
mkdirSync('uploads', { recursive: true });
callback(null, 'uploads');
// Fotos de perfil en `uploads/profile/` (subcarpeta propia;
// reportes/ y apks/ ya usan las suyas).
mkdirSync('uploads/profile', { recursive: true });
callback(null, 'uploads/profile');
},
filename: (req: Request, file, callback) => {
filename: (req: Request, _file, callback) => {
const { idPersona } = req.params as { idPersona: string };
callback(null, `${idPersona}-${Date.now()}-${file.originalname}`);
// Nombre estable: una foto por persona, se sobrescribe al subir otra.
callback(null, profilePhotoFilename(idPersona));
},
}),
}),
@ -459,9 +470,21 @@ export class PersonaController {
return apiResult;
}
const storedName = profilePhotoFilename(idPersona);
// Recorta el peso al tope de PROFILE_MAX_KB (default 100 KB).
try {
await compressProfileImage(join('uploads/profile', storedName));
} catch {
// Si falla el reencode, se conserva el archivo como llegó.
}
// Quita legados con timestamp u otras copias de la misma persona.
await removeOtherProfilePhotos(idPersona, storedName);
const result = await this.personaService.uploadImage(
idPersona,
`/uploads/${file.filename}`,
profilePhotoPublicUrl(idPersona),
user,
);
@ -483,4 +506,45 @@ export class PersonaController {
return apiResult;
}
@Delete(':idPersona/image')
async imageRemove(
@Req() req: AuthRequest,
@Param('idPersona') idPersona: string,
): Promise<ApiResult> {
const apiResult = defaultApiResult(
routePersona.imageRemove.title,
routePersona.imageRemove.route,
);
try {
const user = getAuthUser(req);
if (!user) {
apiResult.code = HttpStatus.UNAUTHORIZED;
apiResult.message = 'Token inválido.';
return apiResult;
}
const result = await this.personaService.removeImage(idPersona, user);
if (result.boolean) {
// Borra los archivos solo si la fila quedó sin foto.
await removeProfilePhotos(idPersona);
apiResult.status = 'correct';
apiResult.code = HttpStatus.OK;
apiResult.message = result.message;
apiResult.boolean = true;
apiResult.rows = result.number;
apiResult.data = [result.object];
} else {
apiResult.code = HttpStatus.BAD_REQUEST;
apiResult.message = result.message;
}
} catch (error) {
apiResult.code = error.status ?? HttpStatus.INTERNAL_SERVER_ERROR;
apiResult.message = error.message;
}
return apiResult;
}
}

View file

@ -39,4 +39,8 @@ export const routePersona = {
route: '[POST].../v1/personas/:idPersona/image-upload',
title: 'Upload Persona Image',
},
imageRemove: {
route: '[DELETE].../v1/personas/:idPersona/image',
title: 'Remove Persona Image',
},
};

View file

@ -641,6 +641,55 @@ export class PersonaService {
return serviceResult;
}
/**
* Quita la foto de perfil (`photoUrl → null`). Mismos permisos que
* `uploadImage`: propio, Líder del equipo, SuperAdmin o Developer.
*/
async removeImage(idPersona: string, user: AuthUser): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
const esPropio = user.idPersona === idPersona;
const dev = isDeveloper(user);
const superAdmin = isSuperAdmin(user);
const lider = await this.esLiderDelEquipoDe(user, idPersona);
if (!esPropio && !dev && !superAdmin && !lider) {
serviceResult.message =
'No tiene permiso para quitar la imagen de esta persona.';
return serviceResult;
}
const persona = await this.personaRepository.findOneBy({ idPersona });
if (!persona) {
serviceResult.message = 'No se encontró la persona.';
return serviceResult;
}
if (!persona.photoUrl) {
serviceResult.boolean = true;
serviceResult.message = 'La persona no tiene foto de perfil.';
serviceResult.number = 0;
serviceResult.object = persona;
return serviceResult;
}
const result = await this.personaRepository.update(idPersona, {
photoUrl: null,
});
if (result.affected === 1) {
const actualizada = await this.personaRepository.findOneBy({ idPersona });
serviceResult.boolean = true;
serviceResult.message = 'Foto de perfil eliminada.';
serviceResult.number = 1;
serviceResult.object = actualizada;
} else {
serviceResult.message = 'No se encontró la persona.';
}
return serviceResult;
}
async isLiderDeEquipo(user: AuthUser, idEquipo: string): Promise<boolean> {
if (isDeveloper(user)) return true;
if (user.rol !== Rol.Lider) return false;

View file

@ -30,10 +30,13 @@ export class ReemplazoDto {
}
export class AceptarReemplazoDto {
@ApiProperty()
// 6c: el service usa `dto.idPersonaReemplazo ?? user.idPersona` — sin
// @IsOptional el ValidatePipe (whitelist + forbidNonWhitelisted) exigía
// el campo y rechazaba con 400 el aceptar "para mí" sin body.
@ApiProperty({ required: false })
@IsString()
@IsNotEmpty()
idPersonaReemplazo: string;
@IsOptional()
idPersonaReemplazo?: string;
}
export class UpdateReemplazoDto {

View file

@ -4,4 +4,7 @@ export const REMPLAZO_FIND_WHITELIST = [
'idPersonaTitular',
'idPersonaReemplazo',
'estado',
// 6c: orden por fecha de solicitud (las cards de convocatorias
// necesitan el más reciente primero; el whitelist no la tenía).
'fecSolicitud',
];

View file

@ -1,4 +1,4 @@
import { Body, Controller, Get, HttpStatus, Param, Patch, Post, Req } from '@nestjs/common';
import { Body, Controller, Delete, Get, HttpStatus, Param, Patch, Post, Req } from '@nestjs/common';
import { ApiBearerAuth, ApiTags } from '@nestjs/swagger';
import { ReemplazoService } from './reemplazo.service.js';
import {
@ -226,4 +226,43 @@ export class ReemplazoController {
return apiResult;
}
/** Borrado lógico (6d): estado → Eliminado (titular o Dev/SA). */
@Delete(':idReemplazo')
async eliminar(
@Req() req: AuthRequest,
@Param('idReemplazo') idReemplazo: string,
): Promise<ApiResult> {
const apiResult = defaultApiResult(
'Eliminar reemplazo',
'DELETE /v1/reemplazos/:idReemplazo',
);
try {
const user = getAuthUser(req);
if (!user) {
apiResult.code = HttpStatus.UNAUTHORIZED;
apiResult.message = 'Token inválido.';
return apiResult;
}
const result = await this.reemplazoService.eliminar(idReemplazo, user);
if (result.boolean) {
apiResult.status = 'correct';
apiResult.code = HttpStatus.OK;
apiResult.message = result.message;
apiResult.boolean = true;
apiResult.rows = result.number;
} else {
apiResult.code = HttpStatus.BAD_REQUEST;
apiResult.message = result.message;
}
} catch (error) {
apiResult.code = error.status ?? HttpStatus.INTERNAL_SERVER_ERROR;
apiResult.message = error.message;
}
return apiResult;
}
}

View file

@ -23,4 +23,8 @@ export const routeReemplazo = {
route: '[PATCH].../v1/reemplazos/:idReemplazo/cancelar',
title: 'Cancelar Reemplazo',
},
eliminar: {
route: '[DELETE].../v1/reemplazos/:idReemplazo',
title: 'Eliminar Reemplazo',
},
};

View file

@ -1,6 +1,6 @@
import { Injectable, Logger, Optional } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Repository } from 'typeorm';
import { In, Not, Repository } from 'typeorm';
import { EventsService } from '../../common/services/events.service.js';
import { Reemplazo } from './entities/reemplazo.entity.js';
import { Servicio } from '../servicio/entities/servicio.entity.js';
@ -148,19 +148,61 @@ export class ReemplazoService {
if (this.eventsService) {
try {
const elegibles = await this.personaRepository
.createQueryBuilder('p')
.where('p.estado = :e', { e: EstadoGeneral.Activo })
.andWhere('p.rol != :admin', { admin: Rol.Admin })
.andWhere('p."idPersona" != :titular', { titular: idPersonaTitular })
.getMany();
const ids = elegibles.map((p) => p.idPersona);
// Elegibilidad real de aceptar (6.4): activos, no Admin, no el
// titular, sin membresía activa en NINGÚN equipo asignado al
// servicio y sin participación previa en el servicio — fila de
// asistencia (p. ej. aceptó apoyo) ni cubriendo otro reemplazo
// (6d, regla simétrica).
const elegibles = (await this.personaRepository.query(
`SELECT p."idPersona" FROM persona p
WHERE p.estado = $1
AND p.rol != $2
AND p."idPersona" != $3
AND NOT EXISTS (
SELECT 1 FROM equipo_persona ep
WHERE ep."idPersona" = p."idPersona"
AND ep.estado = 'Activo'
AND ep."idEquipo" IN (
SELECT se."idEquipo" FROM servicio_equipo se
WHERE se."idServicio" = $4
)
)
AND NOT EXISTS (
SELECT 1 FROM asistencia a
WHERE a."idServicio" = $4
AND a."idPersona" = p."idPersona"
)
AND NOT EXISTS (
SELECT 1 FROM reemplazo r
WHERE r."idServicio" = $4
AND r."idPersonaReemplazo" = p."idPersona"
AND r.estado = 'Cubierto'
)`,
[
EstadoGeneral.Activo,
Rol.Admin,
idPersonaTitular,
dto.idServicio,
],
)) as { idPersona: string }[];
const ids = elegibles.map((r) => r.idPersona);
// Body con nombre/fecha del servicio (6c): el UUID en el push no
// le dice nada al destinatario.
const fechaCorta = servicio.fecha
? `${servicio.fecha.slice(8, 10)}/${servicio.fecha.slice(5, 7)}`
: '';
const nombreServicio = servicio.nombre || 'Servicio';
await this.eventsService.emitToPersonas({
event: 'reemplazo:abierto',
title: 'Reemplazo disponible',
body: `Hay un reemplazo abierto para el servicio ${dto.idServicio}.`,
body: `Hay un reemplazo abierto para "${nombreServicio}" (${fechaCorta}).`,
idPersonas: ids,
data: { idReemplazo: result.idReemplazo, idServicio: dto.idServicio },
data: {
idReemplazo: result.idReemplazo,
idServicio: dto.idServicio,
nombreServicio,
fechaServicio: servicio.fecha ?? '',
},
});
} catch (error) {
this.logger.warn(
@ -227,12 +269,54 @@ export class ReemplazoService {
);
});
if (user.rol === Rol.Servidor) {
query = query.andWhere(
`(reemplazo."idPersonaTitular" = :id OR reemplazo."idPersonaReemplazo" = :id)`,
{ id: user.idPersona },
);
} else if (user.rol === Rol.Lider || user.rol === Rol.Estaca) {
// Scoping de lectura (6c, doc §6.2): Dev/SuperAdmin/Admin ven todo.
// Los demás combinan (OR):
// 1. mis filas (titular o reemplazo) — el estado de mi solicitud;
// 2. las del servicio donde tengo membresía activa — quien está
// convocado ve todas las convocatorias de SU servicio (sección
// "Solicitudes del servicio" del detalle);
// 3. abiertas donde soy elegible — sin membresía activa en ningún
// equipo asignado al servicio de la fila (misma regla que el
// evento reemplazo:abierto y que aceptar). Un Servidor sin
// membresía en el servicio ya ve los reemplazos abiertos ajenos
// (antes solo los suyos y no podía aceptarlos desde la UI).
// Líder/Estaca suman sus equipos: cubre filas creadas sin fila
// `servicio_equipo` (el create permite el fallback a servicio.estado).
if (!isDeveloper(user) && !isSuperAdmin(user) && user.rol !== Rol.Admin) {
const partes = [
`reemplazo."idPersonaTitular" = :me`,
`reemplazo."idPersonaReemplazo" = :me`,
`EXISTS (
SELECT 1 FROM equipo_persona ep
JOIN servicio_equipo se ON se."idEquipo" = ep."idEquipo"
WHERE ep."idPersona" = :me
AND ep.estado = 'Activo'
AND se."idServicio" = reemplazo."idServicio"
)`,
`(reemplazo.estado = 'Abierto'
AND NOT EXISTS (
SELECT 1 FROM equipo_persona ep2
WHERE ep2."idPersona" = :me
AND ep2.estado = 'Activo'
AND ep2."idEquipo" IN (
SELECT se2."idEquipo" FROM servicio_equipo se2
WHERE se2."idServicio" = reemplazo."idServicio"
)
)
AND NOT EXISTS (
SELECT 1 FROM asistencia a2
WHERE a2."idServicio" = reemplazo."idServicio"
AND a2."idPersona" = :me
)
AND NOT EXISTS (
SELECT 1 FROM reemplazo r2
WHERE r2."idServicio" = reemplazo."idServicio"
AND r2."idPersonaReemplazo" = :me
AND r2.estado = 'Cubierto'
))`,
];
const params: Record<string, unknown> = { me: user.idPersona };
if (user.rol === Rol.Lider || user.rol === Rol.Estaca) {
const misEquipos = await this.equipoPersonaRepository
.createQueryBuilder('ep')
.select('ep."idEquipo"')
@ -240,12 +324,19 @@ export class ReemplazoService {
.andWhere('ep.estado = :e', { e: EstadoMiembro.Activo })
.getRawMany();
const ids = misEquipos.map((r: { idEquipo: string }) => r.idEquipo);
if (!ids.length) {
query = query.andWhere('1 = 0');
} else {
query = query.andWhere('reemplazo."idEquipo" IN (:...ids)', { ids });
if (ids.length) {
partes.push(`reemplazo."idEquipo" IN (:...misEquipos)`);
params.misEquipos = ids;
}
}
query = query.andWhere(`(${partes.join(' OR ')})`, params);
}
// Borrado lógico (6d): Eliminado nunca aparece en un find, para
// ningún rol (ni siquiera con filtro explícito de estado).
query = query.andWhere('reemplazo.estado != :noEliminado', {
noEliminado: EstadoConvocatoria.Eliminado,
});
if (!REMPLAZO_FIND_WHITELIST.includes(orderByAttribute)) {
throw new Error(`Atributo de orden no permitido: ${orderByAttribute}`);
@ -261,7 +352,7 @@ export class ReemplazoService {
serviceResult.boolean = result.length > 0;
serviceResult.message = `${result.length} reemplazo(s) encontrado(s).`;
serviceResult.number = totalRegistros;
serviceResult.data = result;
serviceResult.data = await this.enriquecer(result, user);
} catch (error) {
serviceResult.boolean = false;
serviceResult.message = `Error en el servicio: ${error.message}`;
@ -270,6 +361,138 @@ export class ReemplazoService {
return serviceResult;
}
/**
* Adjunta a cada fila del find lo que la card necesita (6c): nombre y
* fecha del servicio, nombre del equipo, nombres de las personas y los
* flags de UI. El cliente solo recibe las columnas de la entidad (UUIDs)
* y no puede calcularlos: no tiene `idPersona` ni el estado vivo del
* servicio. 4 queries por página (servicios, servicio_equipo, equipo y
* persona en raw), sin N+1.
*/
private async enriquecer(
filas: Reemplazo[],
user: AuthUser,
): Promise<Record<string, unknown>[]> {
if (!filas.length) return [];
const idsServicio = [...new Set(filas.map((r) => r.idServicio))];
const idsEquipo = [...new Set(filas.map((r) => r.idEquipo))];
const idsPersona = [
...new Set([
...filas.map((r) => r.idPersonaTitular),
...filas.flatMap((r) =>
r.idPersonaReemplazo ? [r.idPersonaReemplazo] : [],
),
]),
];
const [servicios, filasSe, equipos, personas, misMembresias] =
await Promise.all([
this.servicioRepository.findBy({ idServicio: In(idsServicio) }),
this.servicioEquipoRepository.findBy({ idServicio: In(idsServicio) }),
idsEquipo.length
? (this.reemplazoRepository.manager.query(
`SELECT "idEquipo", "nombreEquipo" FROM equipo
WHERE "idEquipo" = ANY($1::uuid[])`,
[`{${idsEquipo.join(',')}}`],
)) as Promise<{ idEquipo: string; nombreEquipo: string }[]>
: Promise.resolve([]),
idsPersona.length
? (this.reemplazoRepository.manager.query(
`SELECT "idPersona", nombres, apellidos FROM persona
WHERE "idPersona" = ANY($1::uuid[])`,
[`{${idsPersona.join(',')}}`],
)) as Promise<
{
idPersona: string;
nombres: string | null;
apellidos: string | null;
}[]
>
: Promise.resolve([]),
this.equipoPersonaRepository.findBy({
idPersona: user.idPersona,
estado: EstadoMiembro.Activo,
}),
]);
const porServicio = new Map(servicios.map((s) => [s.idServicio, s]));
const estadoSe = new Map(
filasSe.map((se) => [`${se.idServicio}|${se.idEquipo}`, se.estado]),
);
const nombreEquipo = new Map(equipos.map((e) => [e.idEquipo, e.nombreEquipo]));
const nombrePersona = new Map(
personas.map((p) => [
p.idPersona,
[p.nombres, p.apellidos].filter(Boolean).join(' ').trim() || '—',
]),
);
// Equipos asignados a cada servicio de la página (para el flag de
// elegibilidad: soy elegible si no tengo membresía activa en ellos).
const asignados = new Map<string, Set<string>>();
for (const se of filasSe) {
const set = asignados.get(se.idServicio) ?? new Set<string>();
set.add(se.idEquipo);
asignados.set(se.idServicio, set);
}
const misEquiposSet = new Set(misMembresias.map((m) => m.idEquipo));
const estoyAsignado = (idServicio: string): boolean => {
const set = asignados.get(idServicio);
if (!set) return false;
for (const e of set) if (misEquiposSet.has(e)) return true;
return false;
};
const puedeAdmin =
isDeveloper(user) || isSuperAdmin(user);
return filas.map((r) => {
const servicio = porServicio.get(r.idServicio);
const estadoVivo =
estadoSe.get(`${r.idServicio}|${r.idEquipo}`) ??
((servicio?.estado as EstadoServicio | null) ?? null);
const servicioIniciado =
estadoVivo === EstadoServicio.EnCurso ||
estadoVivo === EstadoServicio.Finalizado;
const esTitular = r.idPersonaTitular === user.idPersona;
const esMio = esTitular || r.idPersonaReemplazo === user.idPersona;
return {
...r,
nombreServicio: servicio?.nombre ?? '',
fechaServicio: servicio?.fecha ?? '',
nombreEquipo: nombreEquipo.get(r.idEquipo) ?? '',
nombreTitular: nombrePersona.get(r.idPersonaTitular) ?? '—',
nombreReemplazo: r.idPersonaReemplazo
? (nombrePersona.get(r.idPersonaReemplazo) ?? '—')
: null,
esMio,
// Espejo de las validaciones de aceptar() — el backend las
// revalida al POST; el flag solo gobierna el botón de la card.
puedeAceptar:
r.estado === EstadoConvocatoria.Abierto &&
!esMio &&
user.rol !== Rol.Admin &&
!estoyAsignado(r.idServicio),
// Espejo de cancelar() (6d): Abierto o Cubierto; titular con
// servicio no iniciado, o Dev/SuperAdmin (Cubierto también
// requiere servicio no iniciado — ya validado arriba).
puedeCancelar:
(r.estado === EstadoConvocatoria.Abierto ||
r.estado === EstadoConvocatoria.Cubierto) &&
((esTitular && !servicioIniciado) ||
(puedeAdmin &&
!(r.estado === EstadoConvocatoria.Cubierto &&
servicioIniciado))),
// Espejo de eliminar() (6d): lógico; con servicio iniciado solo
// desde Cancelado.
puedeEliminar:
r.estado !== EstadoConvocatoria.Eliminado &&
(esTitular || puedeAdmin) &&
(!servicioIniciado || r.estado === EstadoConvocatoria.Cancelado),
};
});
}
async update(
idReemplazo: string,
dto: { motivo?: string },
@ -372,6 +595,30 @@ export class ReemplazoService {
}
}
// Regla cruzada (6d): quien ya participa en el servicio no puede
// cubrir un reemplazo ahí — p. ej. quien aceptó un apoyo (tiene
// fila de asistencia) o quien ya cubre OTRO reemplazo del mismo
// servicio (el cubrimiento vive en idReemplazo, sin fila propia).
const yaAsistio = await this.asistenciaRepository.findOneBy({
idServicio: reemplazo.idServicio,
idPersona: solicitante,
});
if (yaAsistio) {
serviceResult.message =
'No puede aceptar: ya tiene una fila de asistencia en este servicio.';
return serviceResult;
}
const yaCubre = await this.reemplazoRepository.findOneBy({
idServicio: reemplazo.idServicio,
idPersonaReemplazo: solicitante,
estado: EstadoConvocatoria.Cubierto,
});
if (yaCubre) {
serviceResult.message =
'No puede aceptar: ya cubre un reemplazo en este servicio.';
return serviceResult;
}
const result = await this.reemplazoRepository
.createQueryBuilder()
.update(Reemplazo)
@ -390,12 +637,21 @@ export class ReemplazoService {
return serviceResult;
}
// 6e: la fila (del titular) queda en tipo='Reemplazo' con
// idReemplazo y en observación el nombre de quien aceptó — es la
// única pista de quién cubre (no se crea fila para el aceptador).
const nombreAceptador =
[persona.nombres, persona.apellidos]
.filter((x): x is string => !!x && x.trim().length > 0)
.join(' ')
.trim() || '—';
await this.asistenciaRepository
.createQueryBuilder()
.update(Asistencia)
.set({
tipo: TipoAsistencia.Reemplazo,
idReemplazo,
observacion: `Reemplazo - ${nombreAceptador}`,
})
.where('"idServicio" = :idServicio', { idServicio: reemplazo.idServicio })
.andWhere('"idPersona" = :idTitular', {
@ -409,12 +665,27 @@ export class ReemplazoService {
if (this.eventsService) {
try {
// Body con nombre/fecha + idServicio en data (6c): el tap del
// push del titular/reemplazante abre la pantalla de convocatorias
// (antes el UUID en el body y sin idServicio no navegaba bien).
const servicio = await this.servicioRepository.findOneBy({
idServicio: reemplazo.idServicio,
});
const fechaCorta = servicio?.fecha
? `${servicio.fecha.slice(8, 10)}/${servicio.fecha.slice(5, 7)}`
: '';
const nombreServicio = servicio?.nombre || 'Servicio';
await this.eventsService.emitToPersonas({
event: 'reemplazo:cubierto',
title: 'Reemplazo cubierto',
body: `Tu reemplazo del servicio ${reemplazo.idServicio} fue cubierto.`,
body: `Tu reemplazo de "${nombreServicio}" (${fechaCorta}) fue cubierto.`,
idPersonas: [reemplazo.idPersonaTitular, solicitante],
data: { idReemplazo },
data: {
idReemplazo,
idServicio: reemplazo.idServicio,
nombreServicio,
fechaServicio: servicio?.fecha ?? '',
},
});
} catch (error) {
this.logger.warn(
@ -427,10 +698,13 @@ export class ReemplazoService {
}
/**
* Cancelar:
* - SuperAdmin/Dev: reemplazos Abiertos
* - Titular: solo si servicio aún no ha iniciado (estado != EnCurso/Finalizado)
* Efecto: reemplazo Cancelado + asistencia a Pendiente/Titular/idReemplazo null
* Cancelar (6d, ampliado):
* - Titular: Abierto o Cubierto, solo si el servicio no inició.
* - Dev/SA: Abierto (cualquier momento) o Cubierto si no inició.
* Efecto: reemplazo → Cancelado + asistencia del titular revertida
* (Pendiente/Titular/idReemplazo null — en Cubierto deshace la
* cobertura; el aceptador nunca tuvo fila propia, todo vive en
* idReemplazo).
*/
async cancelar(idReemplazo: string, user: AuthUser): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
@ -441,54 +715,33 @@ export class ReemplazoService {
return serviceResult;
}
if (reemplazo.estado !== EstadoConvocatoria.Abierto) {
serviceResult.message = 'Solo se pueden cancelar reemplazos Abiertos.';
if (
reemplazo.estado !== EstadoConvocatoria.Abierto &&
reemplazo.estado !== EstadoConvocatoria.Cubierto
) {
serviceResult.message =
'Solo se pueden cancelar reemplazos Abiertos o Cubiertos.';
return serviceResult;
}
const servicio = await this.servicioRepository.findOneBy({
idServicio: reemplazo.idServicio,
});
const se = await this.servicioEquipoRepository.findOneBy({
idServicio: reemplazo.idServicio,
idEquipo: reemplazo.idEquipo,
});
const estadoVivo = se
? se.estado
: ((servicio?.estado as EstadoServicio | null) ?? null);
const servicioIniciado =
estadoVivo === EstadoServicio.EnCurso ||
estadoVivo === EstadoServicio.Finalizado;
const servicioIniciado = await this.servicioIniciado(reemplazo);
const esTitular = user.idPersona === reemplazo.idPersonaTitular;
const puedeAdmin = isDeveloper(user) || isSuperAdmin(user);
// Cubierto: deshacer la cobertura pisa la asistencia del titular —
// con el servicio ya iniciado no se revierte nada (6d).
if (reemplazo.estado === EstadoConvocatoria.Cubierto && servicioIniciado) {
serviceResult.message = 'No puede cancelar: el servicio ya inició.';
return serviceResult;
}
if (esTitular && !puedeAdmin) {
if (servicioIniciado) {
serviceResult.message = 'No puede cancelar: el servicio ya inició.';
return serviceResult;
}
await this.reemplazoRepository.manager.transaction(async (manager) => {
await manager.update(Reemplazo, idReemplazo, {
estado: EstadoConvocatoria.Cancelado,
});
await manager
.createQueryBuilder()
.update(Asistencia)
.set({
estado: EstadoAsistencia.Pendiente,
idReemplazo: null,
tipo: TipoAsistencia.Titular,
})
.where('"idServicio" = :idServicio', {
idServicio: reemplazo.idServicio,
})
.andWhere('"idPersona" = :idTitular', {
idTitular: reemplazo.idPersonaTitular,
})
.execute();
});
await this.revertirCobertura(reemplazo, EstadoConvocatoria.Cancelado);
serviceResult.boolean = true;
serviceResult.message =
@ -502,6 +755,15 @@ export class ReemplazoService {
return serviceResult;
}
if (reemplazo.estado === EstadoConvocatoria.Cubierto) {
await this.revertirCobertura(reemplazo, EstadoConvocatoria.Cancelado);
serviceResult.boolean = true;
serviceResult.message =
'Reemplazo cancelado. La asistencia volvió a Pendiente / Titular.';
serviceResult.number = 1;
return serviceResult;
}
const result = await this.reemplazoRepository.update(
{ idReemplazo, estado: EstadoConvocatoria.Abierto },
{ estado: EstadoConvocatoria.Cancelado },
@ -517,6 +779,117 @@ export class ReemplazoService {
return serviceResult;
}
/**
* Borrado lógico (6d): reemplazo → Eliminado (nunca aparece en un
* find). Autoriza el titular de SU reemplazo o Dev/SA.
* - Abierto/Cancelado: solo cambia el estado (no hay cobertura).
* - Cubierto (servicio no iniciado): antes revierte la cobertura
* (misma reversión que cancelar).
* - Servicio ya iniciado: solo desde Cancelado (nada que revertir),
* para no pisar asistencia marcada.
*/
async eliminar(idReemplazo: string, user: AuthUser): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
const reemplazo = await this.reemplazoRepository.findOneBy({ idReemplazo });
if (!reemplazo) {
serviceResult.message = 'No existe el reemplazo.';
return serviceResult;
}
if (reemplazo.estado === EstadoConvocatoria.Eliminado) {
serviceResult.message = 'El reemplazo ya fue eliminado.';
return serviceResult;
}
const esTitular = user.idPersona === reemplazo.idPersonaTitular;
const puedeAdmin = isDeveloper(user) || isSuperAdmin(user);
if (!esTitular && !puedeAdmin) {
serviceResult.message = 'No tiene permiso para eliminar este reemplazo.';
return serviceResult;
}
const servicioIniciado = await this.servicioIniciado(reemplazo);
if (servicioIniciado && reemplazo.estado !== EstadoConvocatoria.Cancelado) {
serviceResult.message =
'No puede eliminar: el servicio ya inició (solo registros '
+ 'Cancelados).';
return serviceResult;
}
if (reemplazo.estado === EstadoConvocatoria.Cubierto) {
await this.revertirCobertura(reemplazo, EstadoConvocatoria.Eliminado);
serviceResult.boolean = true;
serviceResult.message = 'Reemplazo eliminado.';
serviceResult.number = 1;
return serviceResult;
}
const result = await this.reemplazoRepository.update(
{ idReemplazo, estado: Not(EstadoConvocatoria.Eliminado) },
{ estado: EstadoConvocatoria.Eliminado },
);
serviceResult.boolean = result.affected === 1;
serviceResult.message =
result.affected === 1
? 'Reemplazo eliminado.'
: 'No se pudo eliminar.';
serviceResult.number = result.affected || 0;
return serviceResult;
}
/** ¿El servicio de este reemplazo ya está EnCurso/Finalizado? */
private async servicioIniciado(reemplazo: Reemplazo): Promise<boolean> {
const servicio = await this.servicioRepository.findOneBy({
idServicio: reemplazo.idServicio,
});
const se = await this.servicioEquipoRepository.findOneBy({
idServicio: reemplazo.idServicio,
idEquipo: reemplazo.idEquipo,
});
const estadoVivo = se
? se.estado
: ((servicio?.estado as EstadoServicio | null) ?? null);
return (
estadoVivo === EstadoServicio.EnCurso ||
estadoVivo === EstadoServicio.Finalizado
);
}
/**
* Reversión de la cobertura + transición de estado en una sola
* transacción: la asistencia del titular vuelve a Pendiente/Titular
* con idReemplazo null (el aceptador no tiene fila propia — 6d).
*/
private async revertirCobertura(
reemplazo: Reemplazo,
destino: EstadoConvocatoria,
): Promise<void> {
await this.reemplazoRepository.manager.transaction(async (manager) => {
await manager.update(
Reemplazo,
{ idReemplazo: reemplazo.idReemplazo, estado: Not(destino) },
{ estado: destino },
);
await manager
.createQueryBuilder()
.update(Asistencia)
.set({
estado: EstadoAsistencia.Pendiente,
idReemplazo: null,
tipo: TipoAsistencia.Titular,
// 6e: al deshacer la cobertura se borra quién la cubría.
observacion: null,
})
.where('"idServicio" = :idServicio', {
idServicio: reemplazo.idServicio,
})
.andWhere('"idPersona" = :idTitular', {
idTitular: reemplazo.idPersonaTitular,
})
.execute();
});
}
private async puedeVer(user: AuthUser, r: Reemplazo): Promise<boolean> {
if (isDeveloper(user) || isSuperAdmin(user) || user.rol === Rol.Admin)
return true;

View file

@ -382,6 +382,56 @@ export class ServicioController {
return apiResult;
}
/**
* Aviso manual a los convocados (5.16): SuperAdmin/Dev → todos; Líder
* o Estaca → solo sus equipos (validado en el service). Con body
* `{ idEquipo }` acota a UN equipo (solo Dev/SuperAdmin — la campana
* por fila). El push viene SIN ids en `data`, así el toque no navega.
*/
@Post(':idServicio/notificar')
@Autorizacion(AutorizacionEnum.SuperAdmin, AutorizacionEnum.Usuario)
async notificar(
@Req() req: AuthRequest,
@Param('idServicio') idServicio: string,
@Body() body?: { idEquipo?: string },
): Promise<ApiResult> {
const apiResult = defaultApiResult(
routeServicio.notificar.title,
routeServicio.notificar.route,
);
try {
const user = getAuthUser(req);
if (!user) {
apiResult.code = HttpStatus.UNAUTHORIZED;
apiResult.message = 'Token inválido.';
return apiResult;
}
const result = await this.servicioService.notificar(
idServicio,
user,
body?.idEquipo,
);
if (result.boolean) {
apiResult.status = 'correct';
apiResult.code = HttpStatus.OK;
apiResult.message = result.message;
apiResult.boolean = true;
apiResult.rows = result.number;
} else {
apiResult.code = HttpStatus.BAD_REQUEST;
apiResult.message = result.message;
}
} catch (error) {
apiResult.code = error.status ?? HttpStatus.INTERNAL_SERVER_ERROR;
apiResult.message = error.message;
}
return apiResult;
}
@Delete(':idServicio')
@Autorizacion(AutorizacionEnum.SuperAdmin)
async remove(@Param('idServicio') idServicio: string): Promise<ApiResult> {

View file

@ -10,8 +10,10 @@ import { Asistencia } from '../asistencia/entities/asistencia.entity.js';
import { Configuracion } from '../configuracion/entities/configuracion.entity.js';
import { Reemplazo } from '../reemplazo/entities/reemplazo.entity.js';
import { SolicitudApoyo } from '../solicitud-apoyo/entities/solicitud-apoyo.entity.js';
import { Persona } from '../persona/entities/persona.entity.js';
import { RealtimeModule } from '../../common/realtime.module.js';
import { ServicioService } from './servicio.service.js';
import { ServicioSchedule } from './servicio.schedule.js';
import { ServicioController } from './servicio.controller.js';
@Module({
@ -27,11 +29,12 @@ import { ServicioController } from './servicio.controller.js';
Configuracion,
Reemplazo,
SolicitudApoyo,
Persona,
]),
RealtimeModule,
],
exports: [ServicioService, TypeOrmModule],
controllers: [ServicioController],
providers: [ServicioService],
providers: [ServicioService, ServicioSchedule],
})
export class ServicioModule {}

View file

@ -35,4 +35,8 @@ export const routeServicio = {
route: '[POST].../v1/servicios/:idServicio/pin',
title: 'Regenerar PIN Marcado Servicio',
},
notificar: {
route: '[POST].../v1/servicios/:idServicio/notificar',
title: 'Notificar Servicio (aviso sin navegación)',
},
};

View file

@ -0,0 +1,262 @@
import { Injectable, Logger } from '@nestjs/common';
import { Cron } from '@nestjs/schedule';
import { InjectRepository } from '@nestjs/typeorm';
import { In, Repository } from 'typeorm';
import { EventsService } from '../../common/services/events.service.js';
import { Servicio } from './entities/servicio.entity.js';
import { ServicioTurno } from '../servicio-turno/entities/servicio-turno.entity.js';
import { ServicioEquipo } from '../servicio-equipo/entities/servicio-equipo.entity.js';
import { EquipoPersona } from '../equipo-persona/entities/equipo-persona.entity.js';
import { Turno } from '../turno/entities/turno.entity.js';
import { Persona } from '../persona/entities/persona.entity.js';
import { Configuracion } from '../configuracion/entities/configuracion.entity.js';
import {
EstadoGeneral,
EstadoMiembro,
EstadoServicio,
} from '../../common/enums/estados.enum.js';
import { Rol } from '../../common/enums/rol.enum.js';
import {
ZONA_HORA_DEFAULT,
fechaHoraEnZona,
instanteEnZona,
} from '../../common/utils/zona-horaria.js';
/** Minutos antes de la hora de ingreso para avisar a los líderes. */
const AVISO_MINUTOS = 40;
/** Minutos antes de la hora de ingreso para auto-iniciar si sigue en Publicado. */
const CORTE_MINUTOS = 20;
/**
* Schedule de inicio de servicios (Modelo A — tick cada minuto).
*
* Para los servicios de HOY (fecha en la zona de la organización) con un
* primer turno horario (`limiteIngreso ?? horaInicio`):
* - **T−40**: aviso push a los líderes (miembros activos con rol Líder)
* de los equipos que aún estén en `Publicado`.
* - **T−20**: si un equipo sigue en `Publicado`, se auto-inicia
* (`Publicado → EnCurso`). Idempotente por el `WHERE estado`; los
* equipos que ya iniciaron manualmente no se tocan. Servicio sin
* equipos: se auto-inicia la raíz `servicio.estado`.
*
* Dedup del aviso en memoria (clave `idServicio|fecha`); una sola
* instancia desplegada (docker-compose). Si el proceso estuvo caído
* durante la ventana [T−40, T−20) se registra el aviso como perdido.
*/
@Injectable()
export class ServicioSchedule {
private readonly logger = new Logger(ServicioSchedule.name);
/** Claves `${idServicio}|${fecha}` ya avisadas (dedup en memoria). */
private readonly avisados = new Set<string>();
/** Última fecha (zona org) procesada; al cambiar se limpia `avisados`. */
private ultimaFecha: string | null = null;
constructor(
@InjectRepository(Servicio)
private servicioRepository: Repository<Servicio>,
@InjectRepository(ServicioTurno)
private servicioTurnoRepository: Repository<ServicioTurno>,
@InjectRepository(ServicioEquipo)
private servicioEquipoRepository: Repository<ServicioEquipo>,
@InjectRepository(EquipoPersona)
private equipoPersonaRepository: Repository<EquipoPersona>,
@InjectRepository(Turno)
private turnoRepository: Repository<Turno>,
@InjectRepository(Persona)
private personaRepository: Repository<Persona>,
@InjectRepository(Configuracion)
private configuracionRepository: Repository<Configuracion>,
private eventsService: EventsService,
) {}
@Cron('* * * * *')
async tick(): Promise<void> {
try {
await this.ejecutar();
} catch (error) {
this.logger.error(`Fallo en tick de schedule: ${error.message}`);
}
}
private async ejecutar(): Promise<void> {
const config = await this.configuracionRepository.findOneBy({});
const zona = config?.zonaHoraria ?? ZONA_HORA_DEFAULT;
const ahora = new Date();
const hoy = instanteEnZona(ahora, zona).slice(0, 10);
if (this.ultimaFecha !== hoy) {
this.avisados.clear();
this.ultimaFecha = hoy;
}
const servicios = await this.servicioRepository.find({
where: { fecha: hoy },
});
for (const servicio of servicios) {
if (servicio.estado === EstadoServicio.Eliminado) continue;
await this.procesarServicio(servicio, ahora, zona);
}
}
private async procesarServicio(
servicio: Servicio,
ahora: Date,
zona: string,
): Promise<void> {
const hora = await this.horaIngreso(servicio.idServicio);
if (!hora) {
this.logger.debug(
`Sin hora de ingreso (turno u hora): servicio ${servicio.idServicio}`,
);
return;
}
const base = fechaHoraEnZona(servicio.fecha, hora, zona);
if (Number.isNaN(base.getTime())) {
this.logger.warn(
`Hora no parseable '${hora}' para servicio ${servicio.idServicio}`,
);
return;
}
const aviso = new Date(base.getTime() - AVISO_MINUTOS * 60_000);
const corte = new Date(base.getTime() - CORTE_MINUTOS * 60_000);
const clave = `${servicio.idServicio}|${servicio.fecha}`;
const equipos = await this.servicioEquipoRepository.find({
where: { idServicio: servicio.idServicio },
});
const vivos = equipos.filter(
(e) => e.estado !== EstadoServicio.Eliminado,
);
const enPublicado = vivos.filter(
(e) => e.estado === EstadoServicio.Publicado,
);
// --- Aviso T−40 (solo equipos en Publicado; sin equipos no hay a quién avisar)
if (
ahora >= aviso &&
ahora < corte &&
enPublicado.length > 0 &&
!this.avisados.has(clave)
) {
const enviado = await this.enviarAviso(
servicio,
enPublicado.map((e) => e.idEquipo),
);
if (enviado) this.avisados.add(clave);
} else if (ahora >= corte && enPublicado.length > 0) {
// Proceso caído durante la ventana: registrar como perdido (una vez).
if (!this.avisados.has(clave)) {
this.avisados.add(clave);
this.logger.warn(
`Aviso de inicio perdido (pasó el corte) — servicio ${servicio.nombre} (${servicio.idServicio})`,
);
}
}
// --- Auto-inicio T−20 (idempotente: solo filas aún en Publicado)
if (ahora < corte) return;
if (enPublicado.length > 0) {
const res = await this.servicioEquipoRepository.update(
{
idServicio: servicio.idServicio,
estado: EstadoServicio.Publicado,
},
{ estado: EstadoServicio.EnCurso },
);
if (res.affected) {
this.logger.log(
`Auto-inicio: ${res.affected} equipo(s) → EnCurso — ${servicio.nombre}`,
);
}
}
// Servicio extraordinario sin equipos: la raíz `servicio.estado`.
if (
vivos.length === 0 &&
servicio.estado === EstadoServicio.Publicado
) {
const res = await this.servicioRepository.update(
{
idServicio: servicio.idServicio,
estado: EstadoServicio.Publicado,
},
{ estado: EstadoServicio.EnCurso },
);
if (res.affected) {
this.logger.log(`Auto-inicio (raíz): ${servicio.nombre}`);
}
}
}
/** `limiteIngreso ?? horaInicio` del primer turno (`sec` ASC). */
private async horaIngreso(idServicio: string): Promise<string | null> {
const filas = await this.servicioTurnoRepository.find({
where: { idServicio },
order: { sec: 'ASC' },
});
if (!filas.length) return null;
const turno = await this.turnoRepository.findOneBy({
idTurno: filas[0].idTurno,
});
if (!turno) return null;
const hora = (
(turno.limiteIngreso && turno.limiteIngreso.length >= 5
? turno.limiteIngreso
: turno.horaInicio) ?? ''
).trim();
return hora || null;
}
/**
* Push a los líderes activos de los equipos dados. `true` si se envió
* (o no había destinatarios — no se reintenta en bucle); `false` si el
* envío falló para que el siguiente tick lo reintente dentro de la ventana.
*/
private async enviarAviso(
servicio: Servicio,
idsEquipos: string[],
): Promise<boolean> {
const membresias = await this.equipoPersonaRepository.find({
where: { idEquipo: In(idsEquipos), estado: EstadoMiembro.Activo },
});
const candidatos = [...new Set(membresias.map((m) => m.idPersona))];
if (!candidatos.length) return true;
const lideres = await this.personaRepository.find({
where: {
idPersona: In(candidatos),
rol: Rol.Lider,
estado: EstadoGeneral.Activo,
},
});
const ids = lideres.map((p) => p.idPersona);
if (!ids.length) return true;
try {
await this.eventsService.emitToPersonas({
event: 'servicio:aviso',
title: 'Iniciar Servicio',
body: `No olvides Iniciar el Servicio del día de hoy, '${servicio.nombre}'`,
idPersonas: ids,
// Sin ids navegables: al tocar no se navega (mismo criterio que
// el aviso manual de notificar()).
data: {},
});
this.logger.log(
`Aviso de inicio a ${ids.length} líder(es) — ${servicio.nombre}`,
);
return true;
} catch (error) {
this.logger.warn(
`No se pudo enviar aviso de inicio (${servicio.nombre}): ${error.message}`,
);
return false;
}
}
}

View file

@ -45,6 +45,7 @@ import {
import {
ZONA_HORA_DEFAULT,
fechaHoraEnZona,
instanteEnZona,
} from '../../common/utils/zona-horaria.js';
@Injectable()
@ -307,7 +308,7 @@ export class ServicioService {
serviceResult.boolean = count > 0;
serviceResult.message = `${count} servicio(s) encontrado(s).`;
serviceResult.number = totalRegistros;
serviceResult.data = await this.enriquecer(result);
serviceResult.data = await this.enriquecer(result, user);
} catch (error) {
serviceResult.boolean = false;
serviceResult.message = `Error en el servicio: ${error.message}`;
@ -321,8 +322,17 @@ export class ServicioService {
* del catálogo) y equipos (con nombre) en 4 queries por página: dos `IN`
* de filas de unión y dos `IN` de catálogo. Así el card de la lista
* pinta grupos, turnos y la hora de ingreso sin N+1.
*
* **6d/6e:** además `yoAsisto` y `participacion` — el usuario tiene
* fila de asistencia en el servicio (apoyo aceptado) o **cubre un
* reemplazo** ahí (sin fila propia: la asistencia es del titular);
* el Home lo usa para mostrar el servicio (aunque no sea "de mi
* equipo") con el chip "Apoyando" / "Sustituyendo".
*/
private async enriquecer(servicios: Servicio[]): Promise<Servicio[]> {
private async enriquecer(
servicios: Servicio[],
user: AuthUser,
): Promise<Servicio[]> {
if (!servicios.length) return servicios;
const ids = servicios.map((s) => s.idServicio);
@ -332,6 +342,26 @@ export class ServicioService {
const filasEquipo = await this.servicioEquipoRepository.findBy({
idServicio: In(ids),
});
const misFilas = await this.asistenciaRepository.findBy({
idPersona: user.idPersona,
idServicio: In(ids),
});
const serviciosQueAsisto = new Set(misFilas.map((a) => a.idServicio));
const serviciosQueApoyo = new Set(
misFilas
.filter((a) => a.tipo === TipoAsistencia.Apoyo)
.map((a) => a.idServicio),
);
// Reemplazos que yo cubro en ESTA página (la fila de asistencia es
// del titular — 6e: sin esto el reemplazante no ve el servicio).
const cubre = (await this.asistenciaRepository.manager.query(
`SELECT DISTINCT "idServicio" FROM reemplazo
WHERE "idPersonaReemplazo" = $1
AND estado = 'Cubierto'
AND "idServicio" = ANY($2::uuid[])`,
[user.idPersona, `{${ids.join(',')}}`],
)) as { idServicio: string }[];
const serviciosQueCubro = new Set(cubre.map((r) => r.idServicio));
const idsTurno = [...new Set(filasTurno.map((t) => t.idTurno))];
const idsEquipo = [...new Set(filasEquipo.map((e) => e.idEquipo))];
@ -361,6 +391,17 @@ export class ServicioService {
// Estado derivado para el cliente (el vivo está en servicio_equipo;
// `servicio.estado` solo aplica a servicios sin equipos).
estado: ServicioService.estadoDerivado(servicio, filasEq),
// 6d/6e: participo por asistencia (apoyo aceptado, u otra fila)
// o por cubrir un reemplazo, aunque mi equipo no esté convocado.
yoAsisto:
serviciosQueAsisto.has(servicio.idServicio) ||
serviciosQueCubro.has(servicio.idServicio),
// Chip del Home (6e): 'Apoyando' | 'Sustituyendo' | null.
participacion: serviciosQueApoyo.has(servicio.idServicio)
? 'Apoyo'
: serviciosQueCubro.has(servicio.idServicio)
? 'Reemplazo'
: null,
turnos: filasTurno
.filter((t) => t.idServicio === servicio.idServicio)
.sort((a, b) => a.sec - b.sec)
@ -551,10 +592,12 @@ export class ServicioService {
}
if (destino === EstadoServicio.Cancelado) {
const avisar = await this.destinatariosCancelacion(servicio, user);
await this.cancelarEfectos(servicio.idServicio);
await this.servicioRepository.update(servicio.idServicio, {
estado: EstadoServicio.Cancelado,
});
await this.emitirCancelado(servicio, avisar);
serviceResult.boolean = true;
serviceResult.message =
'Servicio cancelado. Convocatorias abiertas canceladas y asistencias Pendiente a Eliminado.';
@ -670,11 +713,17 @@ export class ServicioService {
}
if (destino === EstadoServicio.Cancelado) {
const avisar = await this.destinatariosCancelacion(
servicio,
user,
idsEquipo,
);
await this.cancelarEfectos(servicio.idServicio, idsEquipo);
await this.servicioEquipoRepository.update(
{ idServicio: servicio.idServicio, idEquipo: In(idsEquipo) },
{ estado: EstadoServicio.Cancelado },
);
await this.emitirCancelado(servicio, avisar);
serviceResult.boolean = true;
serviceResult.message = `Equipo(s) cancelado(s): ${idsEquipo.length}.`;
serviceResult.number = idsEquipo.length;
@ -959,6 +1008,64 @@ export class ServicioService {
await asist.execute();
}
/**
* Personas a avisar al cancelar: filas de asistencia ≠ `Eliminado`
* (acotadas al alcance `idsEquipo` si el cancelar es por equipo), sin el
* emisor. Se resuelve ANTES de `cancelarEfectos`, que pasa las filas
* `Pendiente` → `Eliminado`.
*/
private async destinatariosCancelacion(
servicio: Servicio,
user: AuthUser,
idsEquipo?: string[],
): Promise<string[]> {
const where: Record<string, unknown> = {
idServicio: servicio.idServicio,
};
if (idsEquipo?.length) where.idEquipo = In(idsEquipo);
const filas = await this.asistenciaRepository.findBy(where);
const ids = new Set<string>();
for (const f of filas) {
if (f.estado === EstadoAsistencia.Eliminado) continue;
ids.add(f.idPersona);
}
// Quien cancela ya lo sabe: no recibe su propio aviso (mismo criterio
// que servicio:aviso con el emisor).
ids.delete(user.idPersona);
return [...ids];
}
/**
* Push/WS `servicio:cancelado` a las personas del servicio. `data` con
* `idServicio`: al tocar se abre el detalle (un servicio `Cancelado` sí
* es visible; solo `Eliminado` lo oculta).
*/
private async emitirCancelado(
servicio: Servicio,
idPersonas: string[],
): Promise<void> {
if (!this.eventsService || !idPersonas.length) return;
const fechaCorta = servicio.fecha
? `${servicio.fecha.slice(8, 10)}/${servicio.fecha.slice(5, 7)}`
: '';
try {
await this.eventsService.emitToPersonas({
event: 'servicio:cancelado',
title: 'Servicio cancelado',
body:
`El servicio "${servicio.nombre || 'Servicio'}"` +
(fechaCorta ? ` (${fechaCorta})` : '') +
' fue cancelado.',
idPersonas,
data: { idServicio: servicio.idServicio },
});
} catch (error) {
this.logger.warn(
`No se pudo emitir servicio:cancelado: ${error.message}`,
);
}
}
/**
* Umbral de puntualidad del servicio (primer turno por `sec`):
* `limiteIngreso ?? horaInicio` + `configuracion.tolerancia` minutos.
@ -1065,6 +1172,32 @@ export class ServicioService {
SELECT 1 FROM servicio_equipo se2
WHERE se2."idServicio" = servicio."idServicio"
)
)
-- Participación propia (6d/6e): fila de asistencia (apoyo
-- aceptado u otra) con el equipo visible en el servicio.
OR EXISTS (
SELECT 1 FROM asistencia a
WHERE a."idPersona" = :idUser
AND a."idServicio" = servicio."idServicio"
AND EXISTS (
SELECT 1 FROM servicio_equipo se3
WHERE se3."idServicio" = a."idServicio"
AND se3."idEquipo" = a."idEquipo"
AND se3.estado IN (${visibles})
)
)
-- 6e: quien cubre un reemplazo del servicio (sin fila propia
-- de asistencia) también lo ve (Home "Sustituyendo").
OR EXISTS (
SELECT 1 FROM reemplazo r
WHERE r."idServicio" = servicio."idServicio"
AND r."idPersonaReemplazo" = :idUser
AND r.estado = 'Cubierto'
AND EXISTS (
SELECT 1 FROM servicio_equipo se4
WHERE se4."idServicio" = servicio."idServicio"
AND se4.estado IN (${visibles})
)
))`,
{ idUser: user.idPersona },
);
@ -1104,6 +1237,19 @@ export class ServicioService {
AND se3."idEquipo" = a."idEquipo"
AND se3.estado IN (${visibles})
)
)
-- 6e: reemplazante sin fila propia (la asistencia es del
-- titular): el servicio se ve por el cubrimiento.
OR EXISTS (
SELECT 1 FROM reemplazo r
WHERE r."idServicio" = servicio."idServicio"
AND r."idPersonaReemplazo" = :idUser
AND r.estado = 'Cubierto'
AND EXISTS (
SELECT 1 FROM servicio_equipo se4
WHERE se4."idServicio" = servicio."idServicio"
AND se4.estado IN (${visibles})
)
))`,
{ idUser: user.idPersona },
);
@ -1152,10 +1298,13 @@ export class ServicioService {
});
if (m) return true;
}
return false;
// Participación sin membresía en el servicio: apoyo aceptado o
// reemplazo cubierto (mismos casos del scoping del find).
return this.participaEnServicio(servicio.idServicio, user.idPersona, visibles);
}
// Servidor: su equipo visible o su fila de asistencia en equipo visible.
// Servidor: su equipo visible o su participación (asistencia /
// reemplazo cubierto) con el equipo visible.
for (const e of equipos) {
if (!visibles.has(e.estado)) continue;
const m = await this.equipoPersonaRepository.findOneBy({
@ -1165,18 +1314,46 @@ export class ServicioService {
});
if (m) return true;
}
return this.participaEnServicio(servicio.idServicio, user.idPersona, visibles);
}
/**
* ¿La persona participa en el servicio sin necesitar membresía en uno
* de sus equipos? Cubre (a) fila de asistencia (apoyo aceptado u otra)
* cuyo equipo está en estado visible y (b) reemplazo cubierto
* (`idPersonaReemplazo` = yo, `Cubierto`). Compartido por Líder/Estaca
* y Servidor en `puedeVerServicio`.
*/
private async participaEnServicio(
idServicio: string,
idPersona: string,
visibles: Set<EstadoServicio>,
): Promise<boolean> {
const a = await this.asistenciaRepository.findOneBy({
idServicio: servicio.idServicio,
idPersona: user.idPersona,
idServicio,
idPersona,
});
if (a) {
const se = await this.servicioEquipoRepository.findOneBy({
idServicio: servicio.idServicio,
idServicio,
idEquipo: a.idEquipo,
});
if (se && visibles.has(se.estado)) return true;
}
return false;
const cubre = await this.reemplazoRepository.query(
`SELECT 1 FROM reemplazo r
WHERE r."idServicio" = $1
AND r."idPersonaReemplazo" = $2
AND r.estado = 'Cubierto'
AND EXISTS (
SELECT 1 FROM servicio_equipo se
WHERE se."idServicio" = r."idServicio"
AND se.estado = ANY($3::text[])
)
LIMIT 1`,
[idServicio, idPersona, [...visibles]],
);
return Array.isArray(cubre) && cubre.length > 0;
}
/**
@ -1228,6 +1405,201 @@ export class ServicioService {
return serviceResult;
}
/**
* Aviso manual a los convocados (botón "Notificar" del detalle, 5.16).
* Push WS+FCM con mensaje fijo y **sin ids en `data`**: al tocar la
* notificación no se navega a ninguna pantalla (en web el SW abre la
* raíz `/`). Alcance:
* - Con `idEquipo` (campana por fila): **solo Dev/SuperAdmin**, acota
* a ese equipo convocado.
* - Sin `idEquipo` (botón global): SuperAdmin/Dev → todas las filas
* de asistencia del servicio; Líder/Estaca → solo las de SUS equipos.
*/
async notificar(
idServicio: string,
user: AuthUser,
idEquipo?: string,
): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
const servicio = await this.servicioRepository.findOneBy({ idServicio });
if (!servicio) {
serviceResult.message = 'No se encontró el servicio.';
return serviceResult;
}
if (servicio.estado === EstadoServicio.Eliminado) {
serviceResult.message = 'El servicio está eliminado.';
return serviceResult;
}
const esGlobal = isSuperAdmin(user) || isDeveloper(user);
let alcance: string[] | null = null; // null → todos los equipos
if (idEquipo) {
// Campana por fila: acotada a un equipo, solo Dev/SuperAdmin
// (la UI la gatea igual; aquí se revalida).
if (!esGlobal) {
serviceResult.message =
'Solo SuperAdmin/Developer pueden notificar a un equipo concreto.';
return serviceResult;
}
const convocado = await this.servicioEquipoRepository.findOneBy({
idServicio,
idEquipo,
});
if (!convocado || convocado.estado === EstadoServicio.Eliminado) {
serviceResult.message = 'El equipo no está convocado en el servicio.';
return serviceResult;
}
alcance = [idEquipo];
} else if (!esGlobal) {
if (user.rol !== Rol.Lider && user.rol !== Rol.Estaca) {
serviceResult.message =
'Solo el Líder o Estaca de un equipo convocado (o SuperAdmin/Developer) puede notificar.';
return serviceResult;
}
const membresias = await this.equipoPersonaRepository.findBy({
idPersona: user.idPersona,
estado: EstadoMiembro.Activo,
});
const propios = new Set(membresias.map((m) => m.idEquipo));
const convocados = await this.servicioEquipoRepository.findBy({
idServicio,
});
alcance = convocados
.filter((e) => propios.has(e.idEquipo))
.map((e) => e.idEquipo);
if (!alcance.length) {
serviceResult.message =
'Solo el líder o Estaca de un equipo convocado puede notificar a su equipo.';
return serviceResult;
}
}
const filas = await this.asistenciaRepository.findBy({ idServicio });
const ids = new Set<string>();
for (const f of filas) {
if (f.estado === EstadoAsistencia.Eliminado) continue;
if (alcance && !alcance.includes(f.idEquipo)) continue;
ids.add(f.idPersona);
}
// Quien envía ya lo sabe: no recibe su propio aviso (mismo criterio
// que apoyo:abierto con `solicitadoPor`).
ids.delete(user.idPersona);
if (!ids.size) {
serviceResult.message =
'No hay personas para notificar en este servicio.';
return serviceResult;
}
const cuerpo = await this.cuerpoRecordatorio(servicio);
if (this.eventsService) {
try {
await this.eventsService.emitToPersonas({
event: 'servicio:aviso',
title: 'Tienes Servicio',
body: cuerpo,
idPersonas: [...ids],
// SIN ids navegables: el toque no abre pantalla (5.16).
data: {},
});
} catch (error) {
this.logger.warn(`No se pudo emitir servicio:aviso: ${error.message}`);
}
}
serviceResult.boolean = true;
serviceResult.message = `Notificación enviada a ${ids.size} persona(s).`;
serviceResult.number = ids.size;
return serviceResult;
}
/**
* Cuerpo del recordatorio (5.16): "Hoy tienes servicio." /
* "Mañana tienes servicio: <fecha larga>." / "Tienes servicio el <fecha>."
* + "Debe llegar a las HH:mm." con la hora de ingreso del primer turno
* (`limiteIngreso ?? horaInicio`, mismo criterio que el header del
* detalle). Sin turnos/hora → solo la primera frase. "Hoy" se calcula
* en la zona horaria de la organización, no en la del servidor.
*/
private async cuerpoRecordatorio(servicio: Servicio): Promise<string> {
const config = await this.configuracionRepository.findOneBy({});
const zona = config?.zonaHoraria ?? ZONA_HORA_DEFAULT;
const hoy = instanteEnZona(new Date(), zona).slice(0, 10);
let frase: string;
if (servicio.fecha === hoy) {
frase = 'Hoy tienes servicio.';
} else if (servicio.fecha === ServicioService.sumarDia(hoy)) {
frase = `Mañana tienes servicio: ${ServicioService.fechaLarga(
servicio.fecha,
)}.`;
} else {
frase = `Tienes servicio el ${ServicioService.fechaLarga(
servicio.fecha,
)}.`;
}
const hora = await this.horaIngresoServicio(servicio.idServicio);
return hora ? `${frase} Debes llegar a las ${hora}.` : frase;
}
/** `limiteIngreso ?? horaInicio` del primer turno (`sec` ASC). */
private async horaIngresoServicio(
idServicio: string,
): Promise<string | null> {
const filas = await this.servicioTurnoRepository.find({
where: { idServicio },
order: { sec: 'ASC' },
});
if (!filas.length) return null;
const turno = await this.turnoRepository.findOneBy({
idTurno: filas[0].idTurno,
});
if (!turno) return null;
const hora = (turno.limiteIngreso ?? turno.horaInicio ?? '').trim();
if (!hora) return null;
return hora.length > 5 ? hora.slice(0, 5) : hora; // HH:mm:ss → HH:mm
}
/** `YYYY-MM-DD` + 1 día (aritmética UTC: no depende de la zona). */
private static sumarDia(fecha: string): string {
const d = new Date(`${fecha}T00:00:00Z`);
d.setUTCDate(d.getUTCDate() + 1);
return d.toISOString().slice(0, 10);
}
/** `YYYY-MM-DD` → "miércoles 11 de noviembre" (sin localización). */
private static fechaLarga(fecha: string): string {
const dias = [
'domingo',
'lunes',
'martes',
'miércoles',
'jueves',
'viernes',
'sábado',
];
const meses = [
'enero',
'febrero',
'marzo',
'abril',
'mayo',
'junio',
'julio',
'agosto',
'septiembre',
'octubre',
'noviembre',
'diciembre',
];
const d = new Date(`${fecha}T00:00:00Z`);
return `${dias[d.getUTCDay()]} ${Number(
fecha.slice(8, 10),
)} de ${meses[d.getUTCMonth()]}`;
}
/** PIN de 6 dígitos para marcar (tecleado o escaneado en QR). */
private generarPin(): string {
return Math.floor(Math.random() * 1_000_000)

View file

@ -0,0 +1,9 @@
import { ApiProperty } from '@nestjs/swagger';
import { IsBoolean, IsNotEmpty } from 'class-validator';
export class UpdateSesionWhatsappDto {
@ApiProperty({ example: true, description: 'Entra a la rotación de envío de OTP' })
@IsBoolean()
@IsNotEmpty()
activo: boolean;
}

View file

@ -0,0 +1,40 @@
import { Column, Entity, PrimaryGeneratedColumn, UpdateDateColumn } from 'typeorm';
/**
* Sesiones de WhatsApp (OpenWA) disponibles para enviar el OTP.
*
* Se sincronizan desde `GET /api/sessions` (upsert por `sessionId`);
* `activo` decide cuáles entran a la rotación de envío y `estado` refleja
* lo que OpenWA reporta (`ready`, `stopped`, `ausente` = ya no existe).
*/
@Entity('sesion_whatsapp')
export class SesionWhatsapp {
@PrimaryGeneratedColumn('uuid')
idSesion: string;
/** Id de la sesión en OpenWA (uuid). */
@Column({ type: 'varchar', unique: true })
sessionId: string;
/** Nombre visible de la sesión (OpenWA `name`). */
@Column({ type: 'varchar' })
nombre: string;
/** Número de WhatsApp conectado (OpenWA `phone`). */
@Column({ type: 'varchar', nullable: true })
telefono?: string | null;
/** Estado reportado por OpenWA: `ready` / `stopped` / `ausente` (eliminada). */
@Column({ type: 'varchar', default: 'unknown' })
estado: string;
/** Entra a la rotación de envío de OTP. */
@Column({ default: false })
activo: boolean;
@Column({ type: 'timestamptz', default: () => 'now()' })
fecCreacion: Date;
@UpdateDateColumn({ type: 'timestamptz' })
fecActualizacion: Date;
}

View file

@ -0,0 +1,100 @@
import { Body, Controller, Get, HttpStatus, Param, Patch, Post } from '@nestjs/common';
import { ApiBearerAuth, ApiTags } from '@nestjs/swagger';
import { SesionWhatsappService } from './sesion-whatsapp.service.js';
import { UpdateSesionWhatsappDto } from './dto/update-sesion-whatsapp.dto.js';
import { ApiResult, defaultApiResult } from '../../common/interfaces/api.result.js';
import { routeSesionWhatsapp } from './sesion-whatsapp.router.js';
import { Autorizacion } from '../../common/decorators/autorizacion.decorator.js';
import { Autorizacion as AutorizacionEnum } from '../../common/enums/rol.enum.js';
@ApiTags('sesion-whatsapp')
@ApiBearerAuth()
@Controller('sesion-whatsapp')
@Autorizacion(AutorizacionEnum.Developer)
export class SesionWhatsappController {
constructor(private readonly sesionWhatsappService: SesionWhatsappService) {}
@Get()
async find(): Promise<ApiResult> {
const apiResult = defaultApiResult(routeSesionWhatsapp.find.title, routeSesionWhatsapp.find.route);
try {
const result = await this.sesionWhatsappService.find();
if (result.boolean) {
apiResult.status = 'correct';
apiResult.code = HttpStatus.OK;
apiResult.message = result.message;
apiResult.boolean = true;
apiResult.rows = result.number;
apiResult.data = result.data;
} else {
apiResult.code = HttpStatus.BAD_REQUEST;
apiResult.message = result.message;
}
} catch (error) {
apiResult.code = error.status ?? HttpStatus.INTERNAL_SERVER_ERROR;
apiResult.message = error.message;
}
return apiResult;
}
@Post('sincronizar')
async sincronizar(): Promise<ApiResult> {
const apiResult = defaultApiResult(
routeSesionWhatsapp.sincronizar.title,
routeSesionWhatsapp.sincronizar.route,
);
try {
const result = await this.sesionWhatsappService.sincronizar();
if (result.boolean) {
apiResult.status = 'correct';
apiResult.code = HttpStatus.OK;
apiResult.message = result.message;
apiResult.boolean = true;
apiResult.rows = result.number;
apiResult.data = result.data;
} else {
apiResult.code = HttpStatus.BAD_REQUEST;
apiResult.message = result.message;
}
} catch (error) {
apiResult.code = error.status ?? HttpStatus.INTERNAL_SERVER_ERROR;
apiResult.message = `No se pudo sincronizar con OpenWA: ${error.message}`;
}
return apiResult;
}
@Patch(':idSesion')
async update(
@Param('idSesion') idSesion: string,
@Body() dto: UpdateSesionWhatsappDto,
): Promise<ApiResult> {
const apiResult = defaultApiResult(routeSesionWhatsapp.update.title, routeSesionWhatsapp.update.route);
try {
const result = await this.sesionWhatsappService.update(idSesion, dto);
if (result.boolean) {
apiResult.status = 'correct';
apiResult.code = HttpStatus.OK;
apiResult.message = result.message;
apiResult.boolean = true;
apiResult.rows = result.number;
apiResult.data = [result.object];
} else {
apiResult.code = HttpStatus.BAD_REQUEST;
apiResult.message = result.message;
}
} catch (error) {
apiResult.code = error.status ?? HttpStatus.INTERNAL_SERVER_ERROR;
apiResult.message = error.message;
}
return apiResult;
}
}

View file

@ -0,0 +1,14 @@
import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { SesionWhatsapp } from './entities/sesion-whatsapp.entity.js';
import { SesionWhatsappService } from './sesion-whatsapp.service.js';
import { SesionWhatsappController } from './sesion-whatsapp.controller.js';
import { OpenwaService } from '../../common/services/openwa.service.js';
@Module({
imports: [TypeOrmModule.forFeature([SesionWhatsapp])],
exports: [TypeOrmModule, SesionWhatsappService],
controllers: [SesionWhatsappController],
providers: [SesionWhatsappService, OpenwaService],
})
export class SesionWhatsappModule {}

View file

@ -0,0 +1,14 @@
export const routeSesionWhatsapp = {
find: {
route: '[GET].../v1/sesion-whatsapp',
title: 'Find Sesion Whatsapp',
},
sincronizar: {
route: '[POST].../v1/sesion-whatsapp/sincronizar',
title: 'Sincronizar Sesion Whatsapp',
},
update: {
route: '[PATCH].../v1/sesion-whatsapp/:idSesion',
title: 'Update Sesion Whatsapp',
},
};

View file

@ -0,0 +1,185 @@
import { Injectable, Logger, OnApplicationBootstrap } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Repository } from 'typeorm';
import { SesionWhatsapp } from './entities/sesion-whatsapp.entity.js';
import { UpdateSesionWhatsappDto } from './dto/update-sesion-whatsapp.dto.js';
import { OpenwaService } from '../../common/services/openwa.service.js';
import { defaultServiceResult, ServiceResult } from '../../common/interfaces/service.result.js';
@Injectable()
export class SesionWhatsappService implements OnApplicationBootstrap {
private readonly logger = new Logger(SesionWhatsappService.name);
constructor(
@InjectRepository(SesionWhatsapp)
private sesionRepository: Repository<SesionWhatsapp>,
private openwaService: OpenwaService,
) {}
/**
* Sync inicial al arrancar (fire-and-forget: no bloquea el boot).
* Si OpenWA no responde solo deja el aviso en el log; la tabla puede
* sincronizarse después desde el endpoint manual.
*/
onApplicationBootstrap(): void {
void this.sincronizar()
.then((result) => this.logger.log(`Sync inicial: ${result.message}`))
.catch((error) =>
this.logger.warn(`Sync inicial omitida: ${error.message}`),
);
}
async find(): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
const rows = await this.sesionRepository.find({ order: { nombre: 'ASC' } });
serviceResult.boolean = true;
serviceResult.message = rows.length
? 'Sesiones obtenidas.'
: 'No hay sesiones registradas. Use sincronizar.';
serviceResult.number = rows.length;
serviceResult.data = rows;
return serviceResult;
}
/**
* Upsert desde `GET /api/sessions`: crea las nuevas, actualiza
* nombre/teléfono/estado y marca `ausente` a las que OpenWA ya no
* devuelve. **Nunca borra filas** y no toca `activo` (la selección del
* Developer se mantiene entre syncs).
*/
async sincronizar(): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
const remotas = await this.openwaService.listSessions();
const idsRemotos = new Set(remotas.map((r) => r.id));
let creadas = 0;
let actualizadas = 0;
let ausentes = 0;
for (const remota of remotas) {
const existente = await this.sesionRepository.findOneBy({
sessionId: remota.id,
});
if (!existente) {
const nueva = this.sesionRepository.create({
sessionId: remota.id,
nombre: remota.name || remota.id,
telefono: remota.phone ?? null,
estado: remota.status || 'unknown',
activo: false,
});
await this.sesionRepository.save(nueva);
creadas++;
continue;
}
const nombre = remota.name || existente.nombre;
const telefono = remota.phone ?? existente.telefono ?? null;
const estado = remota.status || existente.estado;
if (
nombre !== existente.nombre ||
telefono !== (existente.telefono ?? null) ||
estado !== existente.estado
) {
await this.sesionRepository.update(existente.idSesion, {
nombre,
telefono,
estado,
});
actualizadas++;
}
}
const locales = await this.sesionRepository.find();
for (const local of locales) {
if (!idsRemotos.has(local.sessionId) && local.estado !== 'ausente') {
await this.sesionRepository.update(local.idSesion, {
estado: 'ausente',
});
ausentes++;
}
}
serviceResult.boolean = true;
serviceResult.message = `Sincronización completada: ${creadas} creada(s), ${actualizadas} actualizada(s), ${ausentes} ausente(s) de ${remotas.length} en OpenWA.`;
serviceResult.number = creadas + actualizadas + ausentes;
serviceResult.data = await this.sesionRepository.find({
order: { nombre: 'ASC' },
});
return serviceResult;
}
/**
* Ids elegibles para el envío de OTP: `activo = true` y `estado = ready`.
*/
async getIdsParaEnvio(): Promise<string[]> {
const rows = await this.sesionRepository.find({
where: { activo: true, estado: 'ready' },
order: { fecCreacion: 'ASC' },
});
return rows.map((row) => row.sessionId);
}
/**
* Higiene automática: un sessionId que falló con "no existe" sale del
* pool marcado `ausente` (la próxima sincroniza lo re-evalúa).
*/
async marcarAusente(sessionId: string): Promise<void> {
const row = await this.sesionRepository.findOneBy({ sessionId });
if (row && row.estado !== 'ausente') {
await this.sesionRepository.update(row.idSesion, {
estado: 'ausente',
});
this.logger.warn(
`Sesión ${sessionId} (${row.nombre}) marcada como ausente tras fallo de envío.`,
);
}
}
async update(
idSesion: string,
dto: UpdateSesionWhatsappDto,
): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
const existente = await this.sesionRepository.findOneBy({ idSesion });
if (!existente) {
serviceResult.message = 'No existe la sesión.';
return serviceResult;
}
if (dto.activo) {
if (existente.estado !== 'ready') {
serviceResult.message = `Solo se pueden activar sesiones en estado ready (actual: ${existente.estado}).`;
return serviceResult;
}
} else if (existente.activo) {
const otrasActivas = await this.sesionRepository.count({
where: { activo: true },
});
if (otrasActivas <= 1) {
serviceResult.message =
'No se puede desactivar la única sesión activa. Active otra primero.';
return serviceResult;
}
}
await this.sesionRepository.update(idSesion, { activo: dto.activo });
serviceResult.boolean = true;
serviceResult.message = dto.activo
? 'Sesión activada para envío de OTP.'
: 'Sesión desactivada.';
serviceResult.number = 1;
serviceResult.object = await this.sesionRepository.findOneBy({ idSesion });
return serviceResult;
}
}

View file

@ -8,15 +8,21 @@ export class SolicitudApoyoDto {
@IsNotEmpty()
idServicio: string;
@ApiProperty()
/**
* Obligatorio cuando el servicio tiene equipos. En servicios sin
* equipos se omite (`null` en la entidad) — opción A 2026-11.
*/
@ApiProperty({ required: false })
@IsOptional()
@IsString()
@IsNotEmpty()
idEquipo: string;
idEquipo?: string;
@ApiProperty()
@ApiProperty({ required: false })
@IsString()
@IsNotEmpty()
solicitadoPor: string;
@IsOptional()
solicitadoPor?: string;
@ApiProperty()
@IsInt()

View file

@ -9,8 +9,13 @@ export class SolicitudApoyo {
@Column({ type: 'uuid' })
idServicio: string;
@Column({ type: 'uuid' })
idEquipo: string;
/**
* Equipo solicitante. `null` en servicios sin equipos (extraordinario
* con turnos): la convocatoria es del servicio y, al aceptar, la fila
* de asistencia toma el equipo de origen del aceptador.
*/
@Column({ type: 'uuid', nullable: true })
idEquipo?: string | null;
@Column({ type: 'uuid' })
solicitadoPor: string;

View file

@ -5,4 +5,7 @@ export const SOLICITUD_APOYO_FIND_WHITELIST = [
'cuposSolicitados',
'cuposCubiertos',
'estado',
// 6c: orden por fecha de solicitud (las cards de convocatorias
// necesitan el más reciente primero; el whitelist no la tenía).
'fecSolicitud',
];

View file

@ -1,13 +1,10 @@
import { Body, Controller, Get, HttpStatus, Param, Patch, Post, Req } from '@nestjs/common';
import { Body, Controller, Delete, Get, HttpStatus, Param, Patch, Post, Req } from '@nestjs/common';
import { ApiBearerAuth, ApiTags } from '@nestjs/swagger';
import { SolicitudApoyoService } from './solicitud-apoyo.service.js';
import { SolicitudApoyoDto, UpdateSolicitudApoyoDto } from './dto/solicitud-apoyo.dto.js';
import { ApiResult, defaultApiResult } from '../../common/interfaces/api.result.js';
import { routeSolicitudApoyo } from './solicitud-apoyo.router.js';
import { FindDto } from '../../common/class/find.dto.js';
import { Roles } from '../../common/decorators/roles.decorator.js';
import { Autorizacion } from '../../common/decorators/autorizacion.decorator.js';
import { Rol, Autorizacion as AutorizacionEnum } from '../../common/enums/rol.enum.js';
import type { AuthRequest } from '../../common/utils/auth-user.js';
import { getAuthUser } from '../../common/utils/auth-user.js';
@ -17,8 +14,9 @@ import { getAuthUser } from '../../common/utils/auth-user.js';
export class SolicitudApoyoController {
constructor(private readonly solicitudApoyoService: SolicitudApoyoService) {}
// 6d: sin @Roles(Líder) — el service acepta Líder (de ese equipo),
// Developer y SuperAdmin (el guard rechazaba al SuperAdmin antes).
@Post()
@Roles(Rol.Lider)
async create(@Req() req: AuthRequest, @Body() dto: SolicitudApoyoDto): Promise<ApiResult> {
const apiResult = defaultApiResult(
routeSolicitudApoyo.create.title,
@ -138,9 +136,11 @@ export class SolicitudApoyoController {
return apiResult;
}
// 6d: el check de autorización vive en el service (Líder del equipo
// / Dev / SuperAdmin).
@Patch(':idSolicitudApoyo')
@Roles(Rol.Lider)
async update(
@Req() req: AuthRequest,
@Param('idSolicitudApoyo') idSolicitudApoyo: string,
@Body() dto: UpdateSolicitudApoyoDto,
): Promise<ApiResult> {
@ -150,7 +150,18 @@ export class SolicitudApoyoController {
);
try {
const result = await this.solicitudApoyoService.update(idSolicitudApoyo, dto);
const user = getAuthUser(req);
if (!user) {
apiResult.code = HttpStatus.UNAUTHORIZED;
apiResult.message = 'Token inválido.';
return apiResult;
}
const result = await this.solicitudApoyoService.update(
idSolicitudApoyo,
dto,
user,
);
if (result.boolean) {
apiResult.status = 'correct';
@ -208,9 +219,11 @@ export class SolicitudApoyoController {
return apiResult;
}
// 6d: sin @Autorizacion(SuperAdmin) — el service autoriza Líder del
// equipo solicitante, Dev o SuperAdmin.
@Patch(':idSolicitudApoyo/cancelar')
@Autorizacion(AutorizacionEnum.SuperAdmin)
async cancelar(
@Req() req: AuthRequest,
@Param('idSolicitudApoyo') idSolicitudApoyo: string,
): Promise<ApiResult> {
const apiResult = defaultApiResult(
@ -219,10 +232,59 @@ export class SolicitudApoyoController {
);
try {
const result = await this.solicitudApoyoService.cancelar(idSolicitudApoyo, {
idPersona: '',
autorizacion: AutorizacionEnum.SuperAdmin,
});
const user = getAuthUser(req);
if (!user) {
apiResult.code = HttpStatus.UNAUTHORIZED;
apiResult.message = 'Token inválido.';
return apiResult;
}
const result = await this.solicitudApoyoService.cancelar(
idSolicitudApoyo,
user,
);
if (result.boolean) {
apiResult.status = 'correct';
apiResult.code = HttpStatus.OK;
apiResult.message = result.message;
apiResult.boolean = true;
apiResult.rows = result.number;
} else {
apiResult.code = HttpStatus.BAD_REQUEST;
apiResult.message = result.message;
}
} catch (error) {
apiResult.code = error.status ?? HttpStatus.INTERNAL_SERVER_ERROR;
apiResult.message = error.message;
}
return apiResult;
}
/** Borrado lógico (6d): estado → Eliminado + borra asistencias Apoyo. */
@Delete(':idSolicitudApoyo')
async eliminar(
@Req() req: AuthRequest,
@Param('idSolicitudApoyo') idSolicitudApoyo: string,
): Promise<ApiResult> {
const apiResult = defaultApiResult(
routeSolicitudApoyo.eliminar.title,
routeSolicitudApoyo.eliminar.route,
);
try {
const user = getAuthUser(req);
if (!user) {
apiResult.code = HttpStatus.UNAUTHORIZED;
apiResult.message = 'Token inválido.';
return apiResult;
}
const result = await this.solicitudApoyoService.eliminar(
idSolicitudApoyo,
user,
);
if (result.boolean) {
apiResult.status = 'correct';

View file

@ -6,6 +6,7 @@ import { ServicioEquipo } from '../servicio-equipo/entities/servicio-equipo.enti
import { Asistencia } from '../asistencia/entities/asistencia.entity.js';
import { EquipoPersona } from '../equipo-persona/entities/equipo-persona.entity.js';
import { Persona } from '../persona/entities/persona.entity.js';
import { RealtimeModule } from '../../common/realtime.module.js';
import { SolicitudApoyoService } from './solicitud-apoyo.service.js';
import { SolicitudApoyoController } from './solicitud-apoyo.controller.js';
@ -19,6 +20,7 @@ import { SolicitudApoyoController } from './solicitud-apoyo.controller.js';
EquipoPersona,
Persona,
]),
RealtimeModule,
],
exports: [SolicitudApoyoService, TypeOrmModule],
controllers: [SolicitudApoyoController],

View file

@ -23,4 +23,8 @@ export const routeSolicitudApoyo = {
route: '[PATCH].../v1/solicitudes-apoyo/:idSolicitudApoyo/cancelar',
title: 'Cancelar Solicitud Apoyo',
},
eliminar: {
route: '[DELETE].../v1/solicitudes-apoyo/:idSolicitudApoyo',
title: 'Eliminar Solicitud Apoyo',
},
};

View file

@ -1,12 +1,13 @@
import { Injectable } from '@nestjs/common';
import { Injectable, Logger, Optional } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Repository } from 'typeorm';
import { In, Not, Repository } from 'typeorm';
import { SolicitudApoyo } from './entities/solicitud-apoyo.entity.js';
import { Servicio } from '../servicio/entities/servicio.entity.js';
import { ServicioEquipo } from '../servicio-equipo/entities/servicio-equipo.entity.js';
import { Asistencia } from '../asistencia/entities/asistencia.entity.js';
import { EquipoPersona } from '../equipo-persona/entities/equipo-persona.entity.js';
import { Persona } from '../persona/entities/persona.entity.js';
import { Reemplazo } from '../reemplazo/entities/reemplazo.entity.js';
import {
SolicitudApoyoDto,
UpdateSolicitudApoyoDto,
@ -31,9 +32,12 @@ import {
isDeveloper,
isSuperAdmin,
} from '../../common/utils/auth-user.js';
import { EventsService } from '../../common/services/events.service.js';
@Injectable()
export class SolicitudApoyoService {
private readonly logger = new Logger(SolicitudApoyoService.name);
constructor(
@InjectRepository(SolicitudApoyo)
private solicitudApoyoRepository: Repository<SolicitudApoyo>,
@ -47,6 +51,7 @@ export class SolicitudApoyoService {
private equipoPersonaRepository: Repository<EquipoPersona>,
@InjectRepository(Persona)
private personaRepository: Repository<Persona>,
@Optional() private readonly eventsService?: EventsService,
) {}
async create(dto: SolicitudApoyoDto, user: AuthUser): Promise<ServiceResult> {
@ -61,29 +66,60 @@ export class SolicitudApoyoService {
serviceResult.message = 'No existe el servicio.';
return serviceResult;
}
// El estado vivo es el del EQUIPO solicitante en este servicio.
const se = await this.servicioEquipoRepository.findOneBy({
// Opción A (servicios sin equipos): el pedido es del servicio. Con
// equipos, el estado vivo es el del equipo solicitante; sin ellos,
// la raíz `servicio.estado` (extraordinario).
const filasSe = await this.servicioEquipoRepository.findBy({
idServicio: dto.idServicio,
idEquipo: dto.idEquipo,
});
const estadoVivo = se
? se.estado
: ((servicio.estado as EstadoServicio | null) ?? null);
if (estadoVivo !== EstadoServicio.Publicado) {
const conEquipos = filasSe.length > 0;
if (conEquipos && !dto.idEquipo) {
serviceResult.message =
'Solo se puede solicitar apoyo cuando el equipo está Publicado.';
'Este servicio tiene equipos convocados: indicá el equipo solicitante.';
return serviceResult;
}
if (!conEquipos && dto.idEquipo) {
serviceResult.message =
'Este servicio no tiene equipos: omití idEquipo (apoyo del servicio).';
return serviceResult;
}
if (!isDeveloper(user)) {
let estadoVivo: EstadoServicio | null | undefined;
if (conEquipos) {
const se = filasSe.find((f) => f.idEquipo === dto.idEquipo);
if (!se) {
serviceResult.message = 'El equipo no está convocado en el servicio.';
return serviceResult;
}
estadoVivo = se.estado;
} else {
estadoVivo = (servicio.estado as EstadoServicio | null) ?? null;
}
if (estadoVivo !== EstadoServicio.Publicado) {
serviceResult.message = conEquipos
? 'Solo se puede solicitar apoyo cuando el equipo está Publicado.'
: 'Solo se puede solicitar apoyo cuando el servicio está Publicado.';
return serviceResult;
}
// 6d: pueden pedir Líder (de ese equipo), Dev o SuperAdmin — el
// bypass antes era solo Developer y el guard @Roles(Líder) rechazaba
// al SuperAdmin antes de llegar acá. Sin equipos no hay Líder de
// convocatoria: solo Dev/SuperAdmin (opción A).
if (!isDeveloper(user) && !isSuperAdmin(user)) {
if (!conEquipos) {
serviceResult.message =
'Solo SuperAdmin/Developer pueden pedir apoyo en servicios sin equipos.';
return serviceResult;
}
if (user.rol !== Rol.Lider) {
serviceResult.message =
'Solo el Líder del equipo (o Developer) puede pedir apoyo.';
'Solo el Líder del equipo (o Developer/SuperAdmin) puede pedir apoyo.';
return serviceResult;
}
const esLider = await this.equipoPersonaRepository.findOneBy({
idPersona: solicitadoPor,
idEquipo: dto.idEquipo,
idEquipo: dto.idEquipo!,
estado: EstadoMiembro.Activo,
});
if (!esLider) {
@ -95,7 +131,7 @@ export class SolicitudApoyoService {
const entity = this.solicitudApoyoRepository.create({
idServicio: dto.idServicio,
idEquipo: dto.idEquipo,
idEquipo: conEquipos ? dto.idEquipo! : null,
solicitadoPor,
cuposSolicitados: dto.cuposSolicitados,
cuposCubiertos: 0,
@ -109,6 +145,74 @@ export class SolicitudApoyoService {
serviceResult.number = 1;
serviceResult.object = result;
// Evento global (tanda notificaciones 2026-11-06): a quienes
// realmente pueden aceptar — mismas reglas de 7.4: activos, no
// Admin, sin membresía activa en el equipo solicitante ni en los
// equipos asignados al servicio y sin fila de asistencia ahí.
if (this.eventsService) {
try {
const elegibles = (await this.personaRepository.query(
`SELECT p."idPersona" FROM persona p
WHERE p.estado = $1
AND p.rol != $2
AND NOT EXISTS (
SELECT 1 FROM equipo_persona ep
WHERE ep."idPersona" = p."idPersona"
AND ep.estado = 'Activo'
AND ep."idEquipo" = $3
)
AND NOT EXISTS (
SELECT 1 FROM equipo_persona ep2
WHERE ep2."idPersona" = p."idPersona"
AND ep2.estado = 'Activo'
AND ep2."idEquipo" IN (
SELECT se."idEquipo" FROM servicio_equipo se
WHERE se."idServicio" = $4
)
)
AND NOT EXISTS (
SELECT 1 FROM asistencia a
WHERE a."idServicio" = $4 AND a."idPersona" = p."idPersona"
)
AND NOT EXISTS (
SELECT 1 FROM reemplazo r
WHERE r."idServicio" = $4
AND r."idPersonaReemplazo" = p."idPersona"
AND r.estado = 'Cubierto'
)
AND p."idPersona" != $5`,
[
EstadoGeneral.Activo,
Rol.Admin,
dto.idEquipo,
dto.idServicio,
// Fix notificaciones (6c): quien pide el apoyo no recibe su
// propia convocatoria (pasaba en el bypass de Developer, que
// pide sin membresía en el equipo solicitante).
solicitadoPor,
],
)) as { idPersona: string }[];
const fechaCorta = servicio.fecha
? `${servicio.fecha.slice(8, 10)}/${servicio.fecha.slice(5, 7)}`
: '';
const nombreServicio = servicio.nombre || 'Servicio';
await this.eventsService.emitToPersonas({
event: 'apoyo:abierto',
title: 'Se necesita apoyo',
body: `Hay una convocatoria de apoyo abierta para "${nombreServicio}" (${fechaCorta}).`,
idPersonas: elegibles.map((r) => r.idPersona),
data: {
idSolicitudApoyo: result.idSolicitudApoyo,
idServicio: dto.idServicio,
nombreServicio,
fechaServicio: servicio.fecha ?? '',
},
});
} catch (error) {
this.logger.warn(`No se pudo emitir evento apoyo: ${error.message}`);
}
}
return serviceResult;
}
@ -173,14 +277,71 @@ export class SolicitudApoyoService {
);
});
// Usuarios normales ven Abiertas elegibles + las suyas
if (user.rol === Rol.Servidor || user.rol === Rol.Estaca) {
query = query.andWhere(
`(solicitud_apoyo.estado = 'Abierto' OR solicitud_apoyo.solicitadoPor = :id)`,
{ id: user.idPersona },
);
// Scoping de lectura (6c, doc §7.2): Dev/SuperAdmin/Admin ven todo.
// Los demás combinan (OR):
// 1. mis solicitudes (solicitadoPor = yo) — el estado de mi pedido;
// 2. las del servicio donde tengo membresía activa — quien está
// convocado ve todas las convocatorias de SU servicio (sección
// "Solicitudes del servicio" del detalle);
// 3. abiertas donde soy elegible — sin membresía en el equipo
// solicitante ni en los equipos asignados y sin fila de
// asistencia (misma regla que el evento apoyo:abierto y que
// aceptar). Antes un Servidor veía TODAS las abiertas, incluso
// las de su propio equipo que no puede aceptar.
if (
!isDeveloper(user) &&
!isSuperAdmin(user) &&
user.rol !== Rol.Admin
) {
const partes = [
`solicitud_apoyo.solicitadoPor = :me`,
`EXISTS (
SELECT 1 FROM equipo_persona ep
JOIN servicio_equipo se ON se."idEquipo" = ep."idEquipo"
WHERE ep."idPersona" = :me
AND ep.estado = 'Activo'
AND se."idServicio" = solicitud_apoyo."idServicio"
)`,
`(solicitud_apoyo.estado = 'Abierto'
AND NOT EXISTS (
SELECT 1 FROM equipo_persona ep2
WHERE ep2."idPersona" = :me
AND ep2.estado = 'Activo'
AND solicitud_apoyo."idEquipo" IS NOT NULL
AND ep2."idEquipo" = solicitud_apoyo."idEquipo"
)
AND NOT EXISTS (
SELECT 1 FROM equipo_persona ep3
WHERE ep3."idPersona" = :me
AND ep3.estado = 'Activo'
AND ep3."idEquipo" IN (
SELECT se2."idEquipo" FROM servicio_equipo se2
WHERE se2."idServicio" = solicitud_apoyo."idServicio"
)
)
AND NOT EXISTS (
SELECT 1 FROM asistencia a
WHERE a."idServicio" = solicitud_apoyo."idServicio"
AND a."idPersona" = :me
)
AND NOT EXISTS (
SELECT 1 FROM reemplazo r
WHERE r."idServicio" = solicitud_apoyo."idServicio"
AND r."idPersonaReemplazo" = :me
AND r.estado = 'Cubierto'
))`,
];
query = query.andWhere(`(${partes.join(' OR ')})`, {
me: user.idPersona,
});
}
// Borrado lógico (6d): Eliminado nunca aparece en un find, para
// ningún rol (ni siquiera con filtro explícito de estado).
query = query.andWhere('solicitud_apoyo.estado != :noEliminado', {
noEliminado: EstadoConvocatoria.Eliminado,
});
if (!SOLICITUD_APOYO_FIND_WHITELIST.includes(orderByAttribute)) {
throw new Error(`Atributo de orden no permitido: ${orderByAttribute}`);
}
@ -198,7 +359,7 @@ export class SolicitudApoyoService {
serviceResult.boolean = result.length > 0;
serviceResult.message = `${result.length} solicitud(es) de apoyo encontrada(s).`;
serviceResult.number = totalRegistros;
serviceResult.data = result;
serviceResult.data = await this.enriquecer(result, user);
} catch (error) {
serviceResult.boolean = false;
serviceResult.message = `Error en el servicio: ${error.message}`;
@ -207,9 +368,134 @@ export class SolicitudApoyoService {
return serviceResult;
}
/**
* Adjunta a cada fila del find lo que la card necesita (6c): nombre y
* fecha del servicio, nombre del equipo, nombre de quien pidió el apoyo
* y los flags de UI. El cliente solo recibe las columnas de la entidad
* (UUIDs) y no puede calcularlos. 5 queries por página, sin N+1.
*/
private async enriquecer(
filas: SolicitudApoyo[],
user: AuthUser,
): Promise<Record<string, unknown>[]> {
if (!filas.length) return [];
const idsServicio = [...new Set(filas.map((r) => r.idServicio))];
const idsEquipo = [
...new Set(filas.map((r) => r.idEquipo).filter((e): e is string => !!e)),
];
const idsPersona = [...new Set(filas.map((r) => r.solicitadoPor))];
const [servicios, filasSe, equipos, personas, misMembresias, misFilas] =
await Promise.all([
this.servicioRepository.findBy({ idServicio: In(idsServicio) }),
this.servicioEquipoRepository.findBy({ idServicio: In(idsServicio) }),
idsEquipo.length
? (this.solicitudApoyoRepository.manager.query(
`SELECT "idEquipo", "nombreEquipo" FROM equipo
WHERE "idEquipo" = ANY($1::uuid[])`,
[`{${idsEquipo.join(',')}}`],
)) as Promise<{ idEquipo: string; nombreEquipo: string }[]>
: Promise.resolve([]),
idsPersona.length
? (this.solicitudApoyoRepository.manager.query(
`SELECT "idPersona", nombres, apellidos FROM persona
WHERE "idPersona" = ANY($1::uuid[])`,
[`{${idsPersona.join(',')}}`],
)) as Promise<
{
idPersona: string;
nombres: string | null;
apellidos: string | null;
}[]
>
: Promise.resolve([]),
this.equipoPersonaRepository.findBy({
idPersona: user.idPersona,
estado: EstadoMiembro.Activo,
}),
this.asistenciaRepository.findBy({
idPersona: user.idPersona,
idServicio: In(idsServicio),
}),
]);
const porServicio = new Map(servicios.map((s) => [s.idServicio, s]));
const nombreEquipo = new Map(
equipos.map((e) => [e.idEquipo, e.nombreEquipo]),
);
const nombrePersona = new Map(
personas.map((p) => [
p.idPersona,
[p.nombres, p.apellidos].filter(Boolean).join(' ').trim() || '—',
]),
);
const asignados = new Map<string, Set<string>>();
for (const se of filasSe) {
const set = asignados.get(se.idServicio) ?? new Set<string>();
set.add(se.idEquipo);
asignados.set(se.idServicio, set);
}
const misEquiposSet = new Set(misMembresias.map((m) => m.idEquipo));
const misServicios = new Set(misFilas.map((a) => a.idServicio));
const estoyAsignado = (idServicio: string): boolean => {
const set = asignados.get(idServicio);
if (!set) return false;
for (const e of set) if (misEquiposSet.has(e)) return true;
return false;
};
const puedeAdmin = isDeveloper(user) || isSuperAdmin(user);
return filas.map((r) => {
const servicio = porServicio.get(r.idServicio);
const esMio = r.solicitadoPor === user.idPersona;
// Líder con membresía en el equipo solicitante (6d: puede
// cancelar/eliminar aunque no haya sido él quien pidió).
const esLiderEquipo =
!!r.idEquipo &&
user.rol === Rol.Lider &&
misEquiposSet.has(r.idEquipo);
const puedeGestionarFila =
esMio || esLiderEquipo || puedeAdmin;
return {
...r,
nombreServicio: servicio?.nombre ?? '',
fechaServicio: servicio?.fecha ?? '',
// Servicio sin equipos (opción A): no hay nombre de equipo
// solicitante — el card usa el título del servicio.
nombreEquipo: r.idEquipo ? (nombreEquipo.get(r.idEquipo) ?? '') : '',
nombreSolicitadoPor: nombrePersona.get(r.solicitadoPor) ?? '—',
esMio,
// Espejo de las validaciones de aceptar() — el backend las
// revalida al POST; el flag solo gobierna el botón de la card.
// Sin equipo solicitante no se excluye por membresía ahí (no
// existe); sí por ya tener fila / estar en equipos asignados.
puedeAceptar:
r.estado === EstadoConvocatoria.Abierto &&
!esMio &&
user.rol !== Rol.Admin &&
r.cuposCubiertos < r.cuposSolicitados &&
(!r.idEquipo || !misEquiposSet.has(r.idEquipo)) &&
!estoyAsignado(r.idServicio) &&
!misServicios.has(r.idServicio),
// Espejo de cancelar() (6d): Abierto/Cubierto; creador, Líder
// del equipo o Dev/SuperAdmin (sin equipo: solo Dev/SA).
puedeCancelar:
(r.estado === EstadoConvocatoria.Abierto ||
r.estado === EstadoConvocatoria.Cubierto) &&
puedeGestionarFila,
// Espejo de eliminar() (6d): lógico + borra asistencias Apoyo.
puedeEliminar:
r.estado !== EstadoConvocatoria.Eliminado && puedeGestionarFila,
};
});
}
async update(
idSolicitudApoyo: string,
dto: UpdateSolicitudApoyoDto,
user: AuthUser,
): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
@ -221,6 +507,28 @@ export class SolicitudApoyoService {
return serviceResult;
}
// 6d: el check vive en el service (antes solo @Roles(Líder) en el
// controller y cualquier Líder editableaba la solicitud de otro
// equipo; SuperAdmin quedaba bloqueado por el guard). Sin equipo
// solicitante (servicio sin equipos): solo Dev/SuperAdmin.
const puedeAdmin = isDeveloper(user) || isSuperAdmin(user);
if (!puedeAdmin) {
if (user.rol !== Rol.Lider || !existente.idEquipo) {
serviceResult.message = 'No tiene permiso para editar esta solicitud.';
return serviceResult;
}
const esLider = await this.equipoPersonaRepository.findOneBy({
idPersona: user.idPersona,
idEquipo: existente.idEquipo,
estado: EstadoMiembro.Activo,
});
if (!esLider) {
serviceResult.message =
'Solo el Líder de ese equipo puede editar la solicitud.';
return serviceResult;
}
}
if (existente.estado !== EstadoConvocatoria.Abierto) {
serviceResult.message = 'Solo se pueden editar solicitudes Abiertas.';
return serviceResult;
@ -288,19 +596,22 @@ export class SolicitudApoyoService {
return serviceResult;
}
// no puede ser del equipo que pidió apoyo
const esDelEquipoSolicitante = await this.equipoPersonaRepository.findOneBy(
{
// no puede ser del equipo que pidió apoyo (solo aplica con equipo
// solicitante; en servicios sin equipos no hay equipo propio que
// excluir en este check).
if (solicitud.idEquipo) {
const esDelEquipoSolicitante =
await this.equipoPersonaRepository.findOneBy({
idPersona: solicitante,
idEquipo: solicitud.idEquipo,
estado: EstadoMiembro.Activo,
},
);
});
if (esDelEquipoSolicitante) {
serviceResult.message =
'No puede apoyar: pertenece al equipo que solicitó.';
return serviceResult;
}
}
// no puede estar en equipos asignados al servicio
const equiposServicio = await this.asistenciaRepository.query(
@ -330,10 +641,46 @@ export class SolicitudApoyoService {
return serviceResult;
}
// Regla simétrica (6d): quien está cubriendo un reemplazo en este
// servicio (sin fila propia — el cubrimiento vive en idReemplazo)
// no puede aceptar apoyo acá.
const yaCubreReemplazo = await this.asistenciaRepository.manager.findOneBy(
Reemplazo,
{
idServicio: solicitud.idServicio,
idPersonaReemplazo: solicitante,
estado: EstadoConvocatoria.Cubierto,
},
);
if (yaCubreReemplazo) {
serviceResult.message =
'No puede aceptar: está cubriendo un reemplazo en este servicio.';
return serviceResult;
}
// 6f / opción A: idEquipo de la fila de asistencia =
// - con equipo solicitante → el que PIDIÓ (Equipo 4);
// - sin equipos (servicio) → el equipo DE ORIGEN del aceptador.
// observación siempre = equipo de la membresía del aceptador
// («de qué equipo apoyó»).
const membresia = await this.equipoPersonaRepository.findOneBy({
idPersona: solicitante,
estado: EstadoMiembro.Activo,
});
let equipoOrigen = 'sin equipo';
if (membresia) {
const filaEq = (await this.asistenciaRepository.manager.query(
`SELECT "nombreEquipo" FROM equipo WHERE "idEquipo" = $1`,
[membresia.idEquipo],
)) as { nombreEquipo: string }[];
equipoOrigen = filaEq[0]?.nombreEquipo?.trim() || 'sin equipo';
}
const idEquipoFila = solicitud.idEquipo ?? membresia?.idEquipo;
if (!idEquipoFila) {
serviceResult.message =
'Para unirte como apoyo en este servicio necesitás tener un equipo activo.';
return serviceResult;
}
const resultado = await this.solicitudApoyoRepository.manager.transaction(
async (manager) => {
@ -359,11 +706,12 @@ export class SolicitudApoyoService {
await manager.insert(Asistencia, {
idServicio: solicitud.idServicio,
idEquipo: membresia?.idEquipo ?? solicitud.idEquipo,
idEquipo: idEquipoFila,
idPersona: solicitante,
tipo: TipoAsistencia.Apoyo,
idSolicitudApoyo,
estado: EstadoAsistencia.Pendiente,
observacion: `Apoyo - ${equipoOrigen}`,
});
return { ok: true, message: 'Te has unido como apoyo.' };
@ -374,42 +722,178 @@ export class SolicitudApoyoService {
serviceResult.message = resultado.message;
serviceResult.number = resultado.ok ? 1 : 0;
// Si ESTE aceptar cruzó el último cupo → avisar al Líder que pidió
// el apoyo (tanda notificaciones 2026-11-06). La lectura previa es
// válida: la transacción es atómica y solo un aceptar puede cruzar
// el umbral (los demás fallan con "Cupos agotados").
if (
resultado.ok &&
solicitud.cuposCubiertos + 1 >= solicitud.cuposSolicitados &&
this.eventsService
) {
try {
// Body con nombre/fecha del servicio (6c): el UUID en el push no
// le dice nada al Líder que pidió el apoyo.
const servicio = await this.servicioRepository.findOneBy({
idServicio: solicitud.idServicio,
});
const fechaCorta = servicio?.fecha
? `${servicio.fecha.slice(8, 10)}/${servicio.fecha.slice(5, 7)}`
: '';
const nombreServicio = servicio?.nombre || 'Servicio';
await this.eventsService.emitToPersonas({
event: 'apoyo:cubierto',
title: 'Apoyo completo',
body: `Tu solicitud de apoyo de "${nombreServicio}" (${fechaCorta}) está completa.`,
idPersonas: [solicitud.solicitadoPor],
data: {
idSolicitudApoyo,
idServicio: solicitud.idServicio,
nombreServicio,
fechaServicio: servicio?.fecha ?? '',
},
});
} catch (error) {
this.logger.warn(
`No se pudo emitir evento apoyo cubierto: ${error.message}`,
);
}
}
return serviceResult;
}
/**
* Cancelar (6d, ampliado): Líder del equipo solicitante, Dev o
* SuperAdmin (antes solo Dev/SA). Efecto: convocatoria → Cancelado +
* **borrado físico** de las filas `asistencia tipo='Apoyo'` de esta
* solicitud (los que aceptaron quedan libres para volver a servir).
* Abierto o Cubierto.
*/
async cancelar(
idSolicitudApoyo: string,
user: AuthUser,
): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
const puedeAdmin = isDeveloper(user) || isSuperAdmin(user);
if (!puedeAdmin) {
const solicitud = await this.solicitudApoyoRepository.findOneBy({
idSolicitudApoyo,
});
if (!solicitud) {
serviceResult.message = 'No existe la solicitud de apoyo.';
return serviceResult;
}
if (
solicitud.estado !== EstadoConvocatoria.Abierto &&
solicitud.estado !== EstadoConvocatoria.Cubierto
) {
serviceResult.message =
'Solo SuperAdmin/Developer pueden cancelar convocatorias.';
'Solo se pueden cancelar convocatorias Abiertas o Cubiertas.';
return serviceResult;
}
const result = await this.solicitudApoyoRepository.update(
{ idSolicitudApoyo, estado: EstadoConvocatoria.Abierto },
const autorizado = await this.puedeGestionar(user, solicitud);
if (!autorizado) {
serviceResult.message =
'No tiene permiso para cancelar esta convocatoria.';
return serviceResult;
}
await this.solicitudApoyoRepository.manager.transaction(async (manager) => {
await manager.update(
SolicitudApoyo,
{ idSolicitudApoyo, estado: Not(EstadoConvocatoria.Eliminado) },
{ estado: EstadoConvocatoria.Cancelado },
);
// Eliminación física de la asistencia de quienes aceptaron (6d):
// si luego se vuelve a pedir apoyo, la lista arranca de cero.
await manager.delete(Asistencia, {
idSolicitudApoyo,
tipo: TipoAsistencia.Apoyo,
});
});
serviceResult.boolean = result.affected === 1;
serviceResult.boolean = true;
serviceResult.message =
result.affected === 1
? 'Solicitud de apoyo cancelada.'
: 'No se pudo cancelar (solo Abiertas).';
serviceResult.number = result.affected || 0;
'Convocatoria cancelada. Se retiró a quienes habían aceptado.';
serviceResult.number = 1;
return serviceResult;
}
/**
* Borrado lógico (6d): convocatoria → Eliminado (nunca aparece en
* un find) + borrado físico de las filas `tipo='Apoyo'` asociadas.
* Mismos autores que cancelar: Líder del equipo, Dev o SuperAdmin.
*/
async eliminar(
idSolicitudApoyo: string,
user: AuthUser,
): Promise<ServiceResult> {
const serviceResult = defaultServiceResult();
const solicitud = await this.solicitudApoyoRepository.findOneBy({
idSolicitudApoyo,
});
if (!solicitud) {
serviceResult.message = 'No existe la solicitud de apoyo.';
return serviceResult;
}
if (solicitud.estado === EstadoConvocatoria.Eliminado) {
serviceResult.message = 'La solicitud ya fue eliminada.';
return serviceResult;
}
const autorizado = await this.puedeGestionar(user, solicitud);
if (!autorizado) {
serviceResult.message =
'No tiene permiso para eliminar esta convocatoria.';
return serviceResult;
}
await this.solicitudApoyoRepository.manager.transaction(async (manager) => {
await manager.update(
SolicitudApoyo,
{ idSolicitudApoyo, estado: Not(EstadoConvocatoria.Eliminado) },
{ estado: EstadoConvocatoria.Eliminado },
);
await manager.delete(Asistencia, {
idSolicitudApoyo,
tipo: TipoAsistencia.Apoyo,
});
});
serviceResult.boolean = true;
serviceResult.message = 'Solicitud de apoyo eliminada.';
serviceResult.number = 1;
return serviceResult;
}
/**
* ¿Puede cancelar/eliminar/editar esta convocatoria? (6d) Dev o
* SuperAdmin, o Líder con membresía activa en el equipo solicitante.
*/
private async puedeGestionar(
user: AuthUser,
solicitud: SolicitudApoyo,
): Promise<boolean> {
if (isDeveloper(user) || isSuperAdmin(user)) return true;
// Sin equipo solicitante (servicio sin equipos): solo Dev/SuperAdmin.
if (!solicitud.idEquipo) return false;
if (user.rol !== Rol.Lider) return false;
const m = await this.equipoPersonaRepository.findOneBy({
idPersona: user.idPersona,
idEquipo: solicitud.idEquipo,
estado: EstadoMiembro.Activo,
});
return !!m;
}
private async puedeVer(user: AuthUser, s: SolicitudApoyo): Promise<boolean> {
if (isDeveloper(user) || isSuperAdmin(user) || user.rol === Rol.Admin)
return true;
if (s.solicitadoPor === user.idPersona) return true;
if (user.rol === Rol.Lider || user.rol === Rol.Estaca) {
if (!s.idEquipo) return s.estado === EstadoConvocatoria.Abierto;
const m = await this.equipoPersonaRepository.findOneBy({
idPersona: user.idPersona,
idEquipo: s.idEquipo,

File diff suppressed because one or more lines are too long