# Gimnasio — CLAUDE.md

> **Estado**: F0 ✅, F1 ✅, F2a ✅ (MVP de demo) y turnos + tablet de ingreso (sin sesión, vinculada) ✅. En test por turno (test corre `feat/gimnasio`), no en prod. Ver `docs/plan-gimnasio.md` §15 (§15.3 enganche con facturación, §15.8 diseño de F1, §15.9 diseño de F2a, §15.10 turnos y tablet).
> **Plan**: `docs/plan-gimnasio.md` (v0.5 del 09/11/2026: spa; original en `~/Descargas/plan-gimnasio-multisede (1).md`).
> **UI nueva**: migración terminada el 11/11 (U0–U12): todo el front en `src/features/gimnasio` (diseño `novasispy-erp/docs/superpowers/specs/2026-11-10-gimnasio-design.md`, resultado `novasispy-erp/docs/superpowers/plans/2026-11-11-gimnasio-resultado.md`). Guía de NovaIA: `docs/guias/guia-gimnasio.md`.
> **Rama**: `feat/gimnasio` (backend desde `pos`, frontend desde `main`), worktrees `backend-gimnasio` / `frontend-gimnasio`.
> **Regla**: todo cambio a código que NO es de `src/gimnasio/` y todo cambio manual en un entorno se registra en
> `docs/plan-gimnasio.md` §15 en el mismo commit.
> **Producto, no a medida**: lo que el primer cliente no usa (matrícula, congelamiento, gracia/bloqueo, comisiones,
> devengamiento, multisede) existe como configuración apagada. Nunca nombrar al cliente en el código.

## Decisiones de diseño (F0)

| # | Decisión | Consecuencia |
|---|---|---|
| 1 | Módulo de seguridad **`GIMNASIO`** (= GYM_ESENCIAL) | GYM_PRO (débito automático, molinete) se agrega en F4 como submódulos `es_addon` de este módulo, el mecanismo del ERP para lo que se cobra aparte |
| 2 | **El precio vive en el producto**, nunca en `gym_planes`/`gym_servicios` | Plan y servicio crean su producto con `ProductosService.create` (servicio, sin inventario, gravado 10 %, UNI). Editar el precio del plan llama a `ProductosService.update`. Las listas de precios del ERP pueden pisarlo por cliente |
| 3 | Un producto es de **un solo plan o servicio activo** | Índices únicos parciales + `ProductoGymService.validarLibre`. Al facturar (F1) el producto identifica qué membresía o servicio activar, sin tipo de producto nuevo (`productos.tipo` no se toca) |
| 4 | **Paquete de clases = plan `CREDITOS`** | `gym_servicios` no tiene modalidad PAQUETE |
| 5 | **"Incluido en el plan" se deduce por la actividad** | Un servicio con `actividad_id` que el plan tiene en `actividades_incluidas` no se cobra a ese socio (F1/F2). No hay `incluido_en_planes` |
| 6 | Instructores y profesionales en **una tabla** (`gym_staff.tipo`) | El sueldo va por RRHH (`empleado_id`); `modalidad_pago`/`tarifa` sólo para otros clientes. `pin_hash` (F2) nunca sale en las respuestas |
| 7 | **Sin tablas de red, franquicia ni importador en F0** | Se crean en F5 con un caso real. Lo caro de agregar después (`sede_id` / `sedes_permitidas`) ya está. **El importador de socios llegó el 12/11 con el primer cliente** (`socios/importacion/`): cliente por `ClientesService` + ficha incompleta con origen `MIGRACION`. Desde el 16/11 con columnas opcionales Plan/Desde/Vence: el plan ya pagado se carga sin factura (`origen = MIGRACION`), también a quien ya era socio |
| 8 | **Sin bus de eventos** (regla del ERP, ver `src/crm/CLAUDE.md`) | Llamada directa: `FacturasService.create` (post-commit) → `GymVentasService.procesarFactura`; `revertirFacturaAnulada` → `anularPorFactura` |
| 9 | **`GimnasioVentasModule` aparte, sin imports** | Lo importan `FacturasModule` y `MiddlewareSifenModule`; no puede depender de nada que los importe a ellos (ciclos). Sólo Prisma y Audit (globales) |
| 10 | **El enganche nunca rompe una venta** | Siempre en `try/catch`; idempotente por `ux_gym_membresias_factura_det`; red de seguridad: cron `gym-ventas-reconciliar` cada 10 min (facturas de 3 días) |
| 11 | **Socio = cliente + ficha** (`gym_socios.cliente_id`, uno por cliente) | Si se le vende un plan a un cliente que no es socio, el enganche lo crea con `ficha_incompleta`; el alta después completa esa misma ficha |
| 12 | **Estados guardados de la membresía: `ACTIVA`, `VENCIDA`, `ANULADA`** | El acceso se decide **por fechas** (`common/acceso-reglas.ts`), no por el estado; `VENCIDA` la marca un cron diario para listados. `EN_GRACIA` se calcula |
| 13 | **Fechas `@db.Date` como `'YYYY-MM-DD'`** (`common/fechas-gym.ts`) | `dfeemide` se guarda en hora de Asunción sin zona: su día es la parte UTC (`deFecha`). En SQL crudo, el día va como texto `::date`, nunca un `Date` de JS |
| 14 | **Foto y firma en Spaces privado** (`socios/archivos-gym.service.ts`) | Se guarda la clave; la API devuelve URL firmadas de 10 min y nunca las claves |
| 15 | **Sesiones derivadas de la plantilla** (`clases/horarios-gym.service.ts`) | Se generan idempotentes (`(plantilla_id, inicio)` único) 4 semanas adelante, nunca hacia atrás. Si cambia el horario, las futuras **sin reservas** se borran y regeneran (única excepción a «no borrar»); las que tienen reservas se conservan |
| 16 | **El cupo se controla con `SELECT … FOR UPDATE`** de la sesión | Reservar, cancelar y promover la espera van en una transacción con la fila bloqueada |
| 17 | **El crédito del paquete se descuenta al confirmar la reserva** | Se devuelve si se cancela a tiempo o se cancela la clase; la puerta no descuenta otro si hoy ya lo descontó una reserva |
| 18 | **QR = link personal + código que rota** (`socios/qr-gym.service.ts`) | HMAC con `envs.jwtSecret`; el código vale ±60 s y sólo en la empresa de quien valida. `qr_version` invalida links viejos. El servidor calcula el código (la página necesita conexión) |
| 19 | **Turno = cliente del ERP**, no socio (`gym_turnos.cliente_id`; `socio_id` si lo es) | Un masaje se le vende a cualquiera. Reglas puras en `turnos/spa-reglas.ts`; la superposición (profesional y recurso, con su capacidad) se verifica con `pg_advisory_xact_lock` por empresa y día, en la misma transacción que el alta |
| 20 | **La tablet busca por CI exacta** (`recepcion/validar` con `{ documento }`) | Nunca por coincidencia parcial: el socio que escribe mal no ve el nombre de otro. Mismas reglas y registro que recepción |
| 21 | **La tablet anda sin sesión, vinculada** (`gym_tablets`, `recepcion/tablets-gym.service.ts`) | Código al azar que se muestra una vez; la base guarda sólo el sha256. El código va en el cuerpo (CORS). Desvinculada → **410** (no 404: la tablet lo distingue de «no encontramos esa cédula»). Corta si la suscripción venció (no si la empresa no tiene suscripción propia) |
| 22 | **Lecturas comunes en `GET opciones`** (cualquier privilegio de GIMNASIO) | Recepción, clases, turnos y el alta no dependen de `GYM_CFG_*`/`GYM_CAT_*`: cada bloque viene si su submódulo está contratado. Los catálogos completos siguen con su permiso |
| 23 | **Spa: turno = cabecera + ítems** (`gym_turnos` + `gym_turno_items`) | Encadenados y «2 personas a la vez». El recurso es una `gym_salas` (CABINA, HIDROMASAJE, SAUNA) con su capacidad; no hay `gym_recursos` |
| 24 | **Cantidad × unidad, sin precio guardado** | Duración = cantidad × `duracion_min` del servicio, en múltiplos de `fraccion_minima`. El importe se calcula de la lista al leer; el facturado sale de `factura_det` (decisión 2) |
| 25 | **Facturado por el enganche** | `vincularTurnos` (en `procesarFactura`) asigna cada línea de un servicio TURNO a un ítem REALIZADO del mismo cliente y producto; con todos asignados, FACTURADO. La anulación los devuelve a REALIZADO. La reconciliación también los mira |
| 26 | **Sauna y piscina del día = el turno** (desvío del plan §6.1.5 punto 7) | No se escribe `gym_accesos` para quien no es socio: un turno LLEGO/EN_CURSO/REALIZADO/FACTURADO de hoy con `habilita_acceso_dia` es la habilitación (Recepción la consulta) |
| 27 | **Liquidación de profesionales** | Ítems con `paga_profesional`, FACTURADOS (o cortesías si `cortesia_paga_profesional`) en el período, a la tarifa vigente ese día (`gym_staff_tarifas`: monto por unidad o %). Un ítem se liquida una vez (índice parcial por `activo`); anular la libera. Destino EXTERNO hasta que el cliente diga si facturan o van por RRHH |

## Tablas (prefijo `gym_`, migración `20261103_gym_base`)

| Tabla | Notas |
|---|---|
| `gym_config` | 1 por empresa; nace sola en la primera lectura. Todo lo opcional, apagado por defecto (p. ej. `sin_plan_con_aviso`: socio sin plan entra en amarillo con `ALERTA_SIN_PLAN`, 14/11). `avisos_plantillas` (JSON, 16/11): texto editado de cada aviso de vencimiento; solo lo que difiere del original (`avisos/avisos-plantillas.ts`) |
| `gym_sedes` | Sede = sucursal del ERP (+ caja + depósito de esa sucursal). Una sucursal es una sola sede activa (índice parcial). Con salas activas no se da de baja |
| `gym_salas` | `SALA` (clases con cupo) / `CABINA` (servicios con turno). Nombre único por sede. Usada por un servicio activo → no se da de baja |
| `gym_actividades` | Nombre único (sin mayúsculas) entre activas. Usada por plan, servicio o staff → no se da de baja |
| `gym_planes` | `PERIODO`/`PASE` (1–7 días)/`CREDITOS`/`MIXTO`. Reglas en `common/reglas.ts` (mismas que el CHECK). Lo que no aplica al tipo se guarda vacío (`normalizarPorTipo`) |
| `gym_servicios` | `VENTA_SIMPLE`/`POR_TIEMPO`/`TURNO`/`CLASE`. TURNO y CLASE exigen salas; POR_TIEMPO, minutos y capacidad |
| `gym_staff` | Cédula única entre activos |

| `gym_socios` (F1) | Uno por cliente. `numero_socio` correlativo atómico (`gym_config.proximo_numero_socio`). Estado `ACTIVO`/`SUSPENDIDO`/`BAJA` con motivo (no se borra) |
| `gym_membresias` (F1) | Nace de la factura (`factura_id`, `factura_det_id` único). Encadena renovaciones (`membresia_anterior_id`). Créditos con `ultimo_credito_fecha` (uno por día). Excepción: plan ya pagado sin factura (`origen` `MANUAL` o `MIGRACION`, `motivo_sin_factura`, `socios/membresias-manuales.service.ts`, plan §15.12) |
| `gym_accesos` (F1) | Cada validación de recepción, aprobada o no. `dias_vencida` alimenta el reporte de ingresos con plan vencido |
| `gym_avisos_log` (F1) | Único por membresía + tipo + canal + umbral. `ERROR` se reintenta hasta 3 veces |
| `gym_horarios_plantilla` (F2a) | Horario semanal (`dia_semana` ISO 1–7). Sólo actividades con horario; sin superposición de sala ni instructor |
| `gym_sesiones` (F2a) | Clase concreta; `dia` = día de Asunción. `PROGRAMADA` → `DICTADA` (cron) o `CANCELADA` (con motivo) |
| `gym_reservas` (F2a) | Una viva por socio y sesión (índice parcial). `CONFIRMADA`/`LISTA_ESPERA`/`CANCELADA`/`ASISTIO`/`NO_SHOW` |
| `gym_tablets` | Tablet de ingreso vinculada a una sede: `nombre`, `token_hash` (único), `ultimo_uso_at`, baja con `revocado_at`/`revocado_por`. Migración `20261107_gym_tablets` |
| `gym_turnos` (spa) | Cabecera: cliente, día, `[inicio, fin)` del primer al último ítem, canal, cortesía, factura. `RESERVADO → LLEGO → EN_CURSO → REALIZADO → FACTURADO`, `CANCELADO` (motivo), `NO_SHOW`. Migraciones `20261106_gym_turnos`, `20261111_gym_spa` |
| `gym_turno_items` (spa) | Servicio, recurso (`gym_salas`), profesional, horario y `cantidad` (y `cantidad_real`); `factura_det_id` único |
| `gym_staff_tarifas`, `gym_liquidaciones`, `gym_liquidacion_items` | Tarifas de las profesionales y sus liquidaciones (BORRADOR → APROBADA → PAGADA / ANULADA) |

Todas con baja lógica (`activo` o `estado`), `audit_logs` (CREAR/EDITAR/ELIMINAR, `entity_type` `gym_*`) y RLS para el rol del Chat IA.

## Endpoints (`/api/v1/gimnasio/...`)

`GET/PATCH config` · `GET sedes` · `GET sedes/opciones` · `POST sedes` · `PATCH/DELETE sedes/:id` · `POST sedes/:id/salas` ·
`PATCH/DELETE salas/:id` · `GET/POST actividades` · `PATCH/DELETE actividades/:id` · `GET/POST planes` · `GET/PATCH/DELETE planes/:id` ·
`GET/POST servicios` · `PATCH/DELETE servicios/:id` · `GET/POST staff` · `GET staff/empleados?q=` · `PATCH/DELETE staff/:id`

Listados con `?incluir_inactivas=true` (sedes, actividades) o `?incluir_inactivos=true` (planes, servicios, staff).
UI nueva: `POST actividades|planes|servicios|staff|sedes|salas/:id/reactivar` (permiso `_ELIMINAR`: valida nombre/cédula/sucursal libre y que lo elegido siga activo; una sala pide su sede activa); `GET sedes?incluir_inactivas=true` trae también las salas dadas de baja; planes, servicios y staff traen `moneda` (la base de la empresa: la del producto o de la tarifa).

F1: `GET socios` (`q`, `estado`, `situacion`, `page`, `limit`) · `GET/PATCH socios/:id` · `POST socios` · `POST socios/:id/estado` ·
`POST socios/importar/preview` · `POST socios/importar` (multipart `archivo`, `sede_id` si hay varias sedes; 12/11) ·
`POST socios/:id/avisos/reenviar` · `POST avisos/procesar` · `POST membresias/:id/anular` ·
`GET membresias/vigencia?plan_id&desde` · `POST socios/:id/membresias` (plan ya pagado, `GYM_SOC_MEMBRESIA_ASIGNAR`; 16/11) · `GET reportes/membresias-sin-factura` · `GET recepcion/buscar?q=` ·
`POST recepcion/validar` · `POST recepcion/forzar` · `GET recepcion/ingresos` · `GET reportes/ingresos-vencidos` ·
`GET reportes/avisos-no-entregados` · **público** `POST /api/v1/gimnasio-publico/baja-avisos` (token HMAC, throttle).

F2a: `GET reportes/tablero` · `GET socios/:id/qr-link` · `POST socios/:id/qr-link/regenerar` · `GET/POST clases/horarios` ·
`PATCH/DELETE clases/horarios/:id` · `GET clases/agenda?desde&hasta&sede_id` · `GET clases/sesiones/:id` · `POST clases/sesiones/:id/cancelar` ·
`POST clases/sesiones/:id/reservas` · `POST clases/reservas/:id/cancelar` · `POST clases/reservas/:id/asistencia` · `GET clases/socios/:id/reservas` ·
`POST recepcion/validar` acepta `{ qr }` en lugar de `socio_id` · **público** `GET /api/v1/gimnasio-publico/mi-acceso?t=` (throttle 30/min).

Spa: `GET turnos/agenda?dia&sede_id` (recursos, horario, bloque, servicios con precio, turnos, totales por recurso) · `GET turnos/pendientes-cobro` (`GYM_TUR_TURNO_COBRAR`) · `GET turnos/:id` · `GET turnos/clientes/:id` · `POST turnos` (`items[]`) · `PATCH turnos/:id` (contacto/notas) · `POST turnos/:id/items` · `PATCH/DELETE turnos/items/:id` (mover, estirar, profesional, cantidad real) · `POST turnos/:id/cancelar` · `POST turnos/:id/estado` · `POST turnos/:id/cortesia` (`GYM_TUR_CORTESIA`).
Liquidaciones (`GYM_LIQUIDACIONES`): `GET/POST liquidaciones/tarifas` · `DELETE liquidaciones/tarifas/:id` · `POST liquidaciones/previsualizar` · `GET/POST liquidaciones` · `GET liquidaciones/:id` · `POST liquidaciones/:id/aprobar|pagada|anular`.
Reportes (UI nueva): `reportes/ingresos-vencidos` y `reportes/avisos-no-entregados` con `page`/`limit` → `{ filas, total, page, limit, … }`; `socios?situacion=POR_VENCER`. Recepción (UI nueva): `GET recepcion/buscar` → `{ socios (con exacto), turnos_hoy (spa de hoy que habilita sauna/piscina; habilita = LLEGO…FACTURADO) }`; `GET recepcion/ingresos?dia&sede_id&page&limit` → `{ dia, total, page, limit, resumen {VERDE,AMARILLO,ROJO}, items }` (límite 200). Opciones: `GET opciones` (cualquier privilegio del módulo). `POST recepcion/validar` acepta `{ documento }` (CI exacta, tablet de ingreso).

Avisos (16/11): `GET config/avisos` (textos vigentes, originales, variables, casilla) · `POST config/avisos/vista-previa` · `POST config/avisos/prueba` (`GYM_CFG_PARAMETROS_EDITAR`). `PATCH config` acepta `avisos_plantillas` y `canales_aviso_vencimiento: []` (= avisos apagados). Plan §15.13.

Tablets: `GET recepcion/tablets` · `POST recepcion/tablets` (`GYM_REC_ACCESO_AUTORIZAR`; devuelve el link una vez) · `DELETE recepcion/tablets/:id` ·
**público** `POST /api/v1/gimnasio-publico/tablet/info`, `POST /api/v1/gimnasio-publico/tablet/logo` (imagen en bytes, no la URL) y `POST /api/v1/gimnasio-publico/tablet/ingreso` (`{ k, documento | qr }`, throttle 60/min).

Crons (`gimnasio.cron.ts`, con advisory lock de transacción): `gym-ventas-reconciliar` (cada 10 min), `gym-membresias-vencidas` (00:10 Asunción), `gym-avisos-vencimiento` (cada hora, :05), `gym-clases-generar` (00:20 Asunción, 4 semanas adelante), `gym-clases-cerrar` (cada 15 min: `DICTADA` / `NO_SHOW`).

## Permisos

Módulo `GIMNASIO` en `src/seguridad/seeds/seguridad.seed-data.ts` (se siembra solo al arrancar).

| Submódulo | Privilegios |
|---|---|
| `GYM_CONFIG` | `GYM_CFG_PARAMETROS_VER/EDITAR`, `GYM_CFG_SEDE_VER/CREAR/EDITAR/ELIMINAR` (sedes, salas y cabinas) |
| `GYM_CATALOGO` | `GYM_CAT_ACTIVIDAD_*`, `GYM_CAT_PLAN_*`, `GYM_CAT_SERVICIO_*` (VER/CREAR/EDITAR/ELIMINAR) |
| `GYM_STAFF` | `GYM_STF_STAFF_VER/CREAR/EDITAR/ELIMINAR` |
| `GYM_SOCIOS` | `GYM_SOC_SOCIO_VER/CREAR/EDITAR/ELIMINAR` (ELIMINAR = suspender/baja/reactivar), `GYM_SOC_SOCIO_IMPORTAR` (planilla), `GYM_SOC_MEMBRESIA_ANULAR`, `GYM_SOC_MEMBRESIA_ASIGNAR` (plan ya pagado, sin factura), `GYM_SOC_AVISO_ENVIAR` |
| `GYM_RECEPCION` | `GYM_REC_ACCESO_CREAR` (validar/registrar), `GYM_REC_ACCESO_AUTORIZAR` (forzar un rechazo) |
| `GYM_REPORTES` | `GYM_REP_REPORTE_VER`, `GYM_REP_TABLERO_VER` (F2a) |
| `GYM_CLASES` (F2a) | `GYM_CLA_AGENDA_VER`, `GYM_CLA_HORARIO_EDITAR` (horario y cancelar clases), `GYM_CLA_RESERVA_CREAR` (reservar, cancelar reservas, asistencia) |
| `GYM_TURNOS` | `GYM_TUR_AGENDA_VER`, `GYM_TUR_TURNO_CREAR` (agendar, mover, estirar, cancelar, llegó / realizado / no vino), `GYM_TUR_TURNO_COBRAR` (pendientes de cobro), `GYM_TUR_CORTESIA` |
| `GYM_LIQUIDACIONES` | `GYM_LIQ_TARIFA_VER/EDITAR`, `GYM_LIQ_LIQUIDACION_VER/CREAR/APROBAR` |

Controller: `@UseGuards(AuthGuard('jwt'), SubmoduloGuard)` + `@RequireSubmodulo(...)` en la clase y
`@RequirePermission('GIMNASIO', ...)` por endpoint, igual que inmobiliario.

## Frontend (repo `novasispy-erp`, rama `feat/gimnasio`) — UI nueva

Todo el gimnasio vive en `src/features/gimnasio/` (kit `@/components/_standards/ui`, textos en `src/locales/es-PY/gimnasio.json`).
No queda código del gimnasio fuera de `src/features` (resultado de la migración: `docs/superpowers/plans/2026-11-11-gimnasio-resultado.md`).

| | |
|---|---|
| API y tipos | `features/gimnasio/api.ts`, `tipos.ts`; permisos por pantalla en `comun/usePermisosGym.ts` (mismos que el back) |
| Inicio | `inicio/PantallaInicioGym` (`/gimnasio/inicio`) |
| Recepción | `recepcion/` (`/gimnasio/recepcion`): búsqueda, semáforo, turnos del spa de hoy, ingresos del día, `DialogoTablets` |
| Socios | `socios/` (`/gimnasio/socios`, `/nuevo`, `/importar`, `/:id`, `/:id/editar`): listado, ficha (`PaginaDetalle`), alta/edición (`PaginaFormulario`), `DialogoQrAcceso`, `importar/PaginaImportarSocios` |
| Clases | `clases/` (`/gimnasio/clases`, `?tab=horario`): agenda del día por sala (`AgendaGrilla`), `PanelSesion`, `DialogoHorario` |
| Spa y liquidaciones | `spa/` (`/gimnasio/spa`), `liquidaciones/` (`/gimnasio/liquidaciones`) |
| Catálogo y staff | `catalogo/` (`/gimnasio/catalogo`, páginas `/gimnasio/catalogo/<entidad>/nuevo|:id`), `staff/` (`/gimnasio/staff`, `/nuevo`, `/:id`) |
| Configuración | `config/` — secciones `gimnasio-reglas`, `gimnasio-sedes`, `gimnasio-spa` (`/gimnasio/configuracion` redirige) |
| Reportes | `reportes/PantallaReportesGym` (`/reportes/gimnasio`, `?vista=vencidos|avisos`) |
| Públicas | `publico/` — `/gym/ingreso` (tablet), `/gym/mi-acceso`, `/gym/baja-avisos` |
| Cobrar en caja | `comun/useCobrarEnCaja`: abre `/pos` con el socio y el plan precargados (Nueva factura; el POS retail todavía no) y copia la CI por las dudas (§15.3) |
| Plan en el alta / ya pagado | `socios/CamposPlan`, `socios/DialogoPlanPagado`, `socios/planPagado.ts`; reporte `?vista=sinFactura` (§15.12) |
| Datos de demo | `e2e/demo-gimnasio.seed.spec.js` (`E2E_DEMO=1 pnpm run demo:gym`): idempotente, emite facturas con fecha pasada; sólo empresas sin SIFEN |

## Pruebas

```bash
npx jest src/gimnasio            # reglas, fechas y semáforo, avisos, multiempresa
# frontend (e2e por la pantalla, F0)
E2E_BASE_URL=http://localhost:5181 E2E_API_URL=http://localhost:3099/api/v1 E2E_TOKEN=<jwt> pnpm run e2e:gym
# F1 y F2a emiten facturas sólo con E2E_FACTURAR=1 (nunca contra una empresa con SIFEN activo)
```

Contra la base local: la empresa holding **Novasis PY** salta los controles de plan y perfil. Backend con
`PORT=3099 MIDDLEWARE_SIFEN_URL=http://127.0.0.1:9 node dist/main.js` (sin emitir al middleware de test);
frontend con `VITE_API_BASE_URL=http://localhost:3099/api/v1 vite --port 5181`.

## Reglas — NO hacer

1. No guardar precios en tablas `gym_` (decisión 2).
2. No agregar valores a `productos.tipo` para el gimnasio (decisión 3).
3. No usar `@OnEvent` / event-emitter (decisión 8).
4. No borrar físicamente nada del vertical.
5. No hacer que el enganche con facturación lance hacia `FacturasService`: una venta emitida no se puede "deshacer" con un 500 (el POS reintenta y sale otra factura legal).
6. No decidir el acceso por `gym_membresias.estado`: se decide por fechas (`decidirAcceso`).
7. No pasar un `Date` de JS a SQL crudo para una columna `DATE` (ver decisión 13).
8. No devolver `foto_key` / `firma_key` / `apto_fisico_key` en las respuestas.
9. No crear una membresía sin factura fuera de `MembresiasManualesService` (motivo, permiso, sin pisarse, auditoría).
10. No crear sesiones a mano en el pasado ni contar el cupo fuera de la transacción con la sesión bloqueada.
11. No devolver ids ni documentos en las respuestas públicas (`gimnasio-publico/*`).
12. No buscar al socio de la tablet por coincidencia parcial ni agendar un turno fuera de la transacción con el día bloqueado.
13. No guardar ni devolver de nuevo el código de una tablet: sólo su hash. Un link perdido se resuelve desvinculando y vinculando otra vez.
