FCSALUD · App móvil (PWA)

App web instalable para el control diario de la Clínica FC Salud, creada a partir de facturaclaro-simple.html.

Qué incluye

• Hoy: balance del día, accesos de un toque a TPV, Efectivo y Gasto, y lista de movimientos. Desliza la tarjeta verde para cambiar de día.
• Registrar: tipo (TPV / Efectivo / Gasto), área (Fisioterapia / Podología), importe grande con importes frecuentes, patología (con las más usadas a un toque) y fecha.
• Gastos con foto o PDF: la app lee proveedor e importe total en el propio móvil (Tesseract.js) y guarda el justificante para verlo o descargarlo después.
• Historial: por mes, agrupado por día, con buscador y filtros por tipo y área.
• Resumen: TPV y efectivo de Podología y Fisioterapia, total cobrado, reparto por área, ranking de patologías (por sesiones o por ingresos, del mes o del año), gráfico día a día e informe mensual para la asesoría (descargar o enviar).
• Informe mensual (PDF): cuadros de resumen, listado solo de gastos y, a continuación, las facturas subidas ese mes (imágenes y PDF).
• Justificantes: se borran solos del móvil a los 4 meses de subirlos.
• Ajustes: proyectos, área preseleccionada, copia de seguridad (exportar/importar con justificantes) y borrado de datos.
• Editar, eliminar con "Deshacer", cerrar hojas deslizando hacia abajo o con el botón Atrás de Android.

Datos

Todo (movimientos, proyectos y facturas) se guarda en un almacén privado de Vercel Blob, protegido con contraseña. Cada móvil guarda además una copia local (IndexedDB) para funcionar sin conexión, y sincroniza los cambios en cuanto hay internet.

• Variables de entorno en Vercel: APP_PASSWORD (contraseña inicial), SESSION_SECRET (firma de la sesión) y BLOB_READ_WRITE_TOKEN (la crea Vercel al conectar el almacén).
• La contraseña se puede cambiar desde Ajustes; entonces se guarda cifrada (scrypt) en config/auth.json y APP_PASSWORD deja de usarse.
• Funciones en /api: login, password, data y doc (facturas en docs/{id}, máx. 4 MB). Las fotos se comprimen en el móvil antes de subirlas.
• Los movimientos se reparten por año (data/moves/2026.json…) y data/meta.json guarda la lista de años, los borrados, los proyectos y la versión. El antiguo data/fcsalud.json se pasa solo a este formato la primera vez y se conserva como copia.
• Cada escritura comprueba la versión (ETag) del archivo: si dos móviles guardan a la vez, el segundo vuelve a leer y aplica sus cambios, así no se pierde ninguno.
• Si el móvil ya tiene la última versión, la sincronización solo lee meta.json (menos operaciones del plan gratuito).
• Copia de seguridad automática semanal de los movimientos en backups/ (se guardan las 8 últimas; las facturas no se incluyen).
• Para probar en local sin Vercel: FC_LOCAL_STORE=./store guarda en una carpeta.

Cómo probarla

Sirve esta carpeta con un servidor web, por ejemplo:

cd FCSALUD-app-movil && python3 -m http.server 8080

y abre http://localhost:8080. Para instalarla en el móvil tiene que estar publicada en una dirección https (Vercel, Netlify, GitHub Pages…). Después: en iPhone, Compartir → Añadir a pantalla de inicio; en Android, menú ⋮ → Instalar aplicación.

Conexión

La app funciona sin conexión una vez abierta. La tipografía Georama, la lectura de facturas y la generación del PDF se descargan de internet la primera vez que se usan y quedan guardadas.

Archivos

index.html, styles.css, app.js, sw.js (modo sin conexión), manifest.webmanifest e icons/ (generados desde el logotipo)., api/ (servidor en Vercel) y package.json.