# FlowFit

> FlowFit es una aplicación de administración de gimnasio para un solo gimnasio
> en una sola computadora (app de escritorio Tauri/Windows, offline). Maneja
> miembros, membresías, cobros, productos, gastos, reportes y mensajería por
> WhatsApp. Stack: React 19 + Vite, Fastify 5 + Prisma 7 sobre SQLite, Tauri 2.
> No es un SaaS multi-tenant. Esta documentación tiene dos mundos: Manual de
> usuario (gerente y recepción, lenguaje no técnico) y Documentación técnica
> (equipo de desarrollo).

## Manual de usuario

- [Bienvenida](/usuario/): qué es FlowFit, quién lo usa y cómo entrar.
- [Registrar un miembro](/usuario/empleado/registrar-miembro): dar de alta a una persona y cobrar su primer pago.
- [Cobrar](/usuario/empleado/cobrar): cobrar productos (cobro rápido) y membresías.
- [Renovar](/usuario/empleado/renovar): extender la membresía de un miembro existente.
- [Enviar WhatsApp](/usuario/empleado/enviar-whatsapp): mensajes automáticos y manuales a los miembros.
- [Ver reportes](/usuario/gerente/ver-reportes): ingresos, gastos, ganancia y crecimiento; exportar PDF/Excel.
- [Finanzas](/usuario/gerente/finanzas): caja, registrar gastos y anular movimientos.
- [Gestionar membresías](/usuario/gerente/gestionar-membresias): crear, editar y quitar planes, productos y categorías.
- [Confirmar pagos](/usuario/gerente/confirmar-pagos): aprobar pagos con tarjeta o transferencia contra su comprobante.

## Documentación técnica

- [Visión general](/tecnica/): qué es técnicamente, stack real y modos de despliegue.
- [Arquitectura](/tecnica/arquitectura): diagramas del modo escritorio (.exe offline) y boot; nota sobre el modo web (no implementado).
- [Reglas de negocio](/tecnica/reglas-de-negocio): fuente única de verdad — duraciones, vencimiento (medianoche, domingo→lunes), métodos de pago, estados, roles, WhatsApp, reportes, respaldo.
- [Despliegue](/tecnica/despliegue): entorno de desarrollo, variables de entorno, generación del instalador .exe, respaldo y auto-actualización.
- [Referencia de la API](/tecnica/referencia-api): tabla de rutas del sidecar Fastify con método, propósito y acceso.
- [ADR 0001 — Stack](/tecnica/adr/0001-stack): decisión de stack y de distribución de escritorio (sin multi-tenant).
- [ADR — Plantilla](/tecnica/adr/_plantilla): plantilla Contexto / Decisión / Consecuencias para nuevas decisiones.

## Notas

- Reglas clave: Diaria=1d, Semanal=7d, Quincenal=15d, Mensual=30d (planes sembrados por defecto, editables). Vencimiento en domingo se mueve a lunes. Efectivo = confirmado inmediato; tarjeta/transferencia = pendiente hasta confirmación manual del gerente.
- Teléfonos en formato (+503) y enlaces wa.me/. Notificaciones por WhatsApp vía Twilio.
- El "PDF" de reportes es impresión del navegador (window.print), no un PDF generado en servidor.