FICHAYA — Wiki interna

Este documento describe la API de FichaYa, un sistema de fichaje laboral diseñado para pequeñas y medianas empresas. Permite a los empleados registrar su entrada y salida del trabajo, gestionar pausas, y solicitar correcciones. Los administradores pueden supervisar en tiempo real el estado del equipo, gestionar centros de trabajo, generar informes mensuales y legales, y controlar invitaciones. La API utiliza autenticación JWT y ofrece endpoints para organizaciones, fichajes, correcciones, centros de trabajo, invitaciones, informes, usuarios y alertas. Es la base técnica para que el producto FichaYa ofrezca una solución completa de control horario.

• Autenticación mediante Google Identity Services con soporte para códigos de invitación.
• Fichaje con geolocalización y verificación de geocerca para garantizar presencia en el lugar de trabajo.
• Gestión de organizaciones con planes, límites de empleados y códigos de unión.
• Informes mensuales y legales exportables a PDF, XLSX y CSV para cumplimiento normativo.
• Sistema de correcciones y alertas para gestionar incidencias en los fichajes.

FichaYa es un sistema de fichaje laboral multi-empresa que permite a empleados registrar su entrada y salida desde el móvil, con geolocalización y soporte offline. Los administradores pueden ver en tiempo real quién está trabajando, generar informes mensuales y gestionar centros de trabajo. La plataforma está construida sobre Cloudflare, lo que la hace escalable y de bajo coste, cumpliendo además con requisitos legales de inmutabilidad de registros.

• Arquitectura multi-tenant con aislamiento de datos por empresa.
• Fichaje con geolocalización y soporte offline con sincronización diferida.
• Roles: owner, admin, manager, employee con permisos diferenciados.
• Registros inmutables: las correcciones se vinculan al fichaje original sin modificarlo.
• Coste inicial cero gracias a Cloudflare Free Tier, escalable a miles de empresas.

Este documento analiza el marco legal español que obliga a las empresas a registrar la jornada laboral de sus empleados, detallando las sanciones por incumplimiento y la inminente transición al fichaje exclusivamente digital en 2025-2026. También presenta un estudio del mercado español, identificando que el 65% de las empresas aún usan métodos no digitales (papel, Excel o directamente no fichan), lo que supone una oportunidad de más de un millón de clientes potenciales para FichaYa. El documento explica cómo FichaYa cumple cada requisito legal, genera informes listos para Inspección de Trabajo y ofrece alertas automáticas de compliance, posicionándose como la solución ideal para micropymes y pymes que necesitan una herramienta sencilla, económica y legalmente sólida.

• El Real Decreto-ley 8/2019 obliga a todas las empresas a registrar la jornada diaria; el incumplimiento es infracción grave con multas de 626€ a 6.250€.
• El anteproyecto de ley 2025 exigirá fichaje exclusivamente digital y acceso remoto en tiempo real por Inspección de Trabajo.
• En España hay ~1,58 millones de empresas con asalariados; el 65% (~1,03 millones) aún no usa fichaje digital.
• FichaYa genera informes de registro horario en formato estándar para Inspección y alerta automáticamente sobre incumplimientos (horas extra, descansos, etc.).
• El hueco de mercado está en micropymes (1-10 empleados) con precio bajo (0-1€/empleado), donde no hay competidores sólidos.

Este documento define el sistema de diseño de FichaYa, una app de fichaje laboral. Establece la identidad visual, tipografía, iconografía, componentes y animaciones para garantizar una experiencia nativa y satisfactoria. Incluye pautas de accesibilidad, rendimiento y modo oscuro, asegurando consistencia en toda la aplicación. Es la guía de referencia para desarrolladores y diseñadores que trabajan en el producto.

• Define paleta de colores completa para modo claro y oscuro, con tokens semánticos.
• Especifica componentes clave como el botón de fichar con animaciones detalladas.
• Incluye escalas tipográficas, iconografía SVG inline y estilos para mapa Leaflet.
• Establece métricas de rendimiento (FCP <1s, bundle JS <80KB) y accesibilidad WCAG AA.
• Proporciona implementación de modo oscuro con detección automática y toggle manual.

Este documento detalla la estrategia de lanzamiento y monetización de FichaYa, una app de fichaje horario para micropymes de hostelería y comercio. Explica cómo captar clientes mediante SEO, Google Ads, partnerships con gestorías y un viral loop, con un modelo freemium que convierte usuarios gratis en clientes de pago al superar los 3 empleados. Incluye proyecciones de ingresos, análisis de competencia y métricas clave como MRR y churn. Es una guía práctica para entender cómo el producto generará negocio y crecerá de forma sostenible.

• Beachhead market: micropymes de hostelería y comercio en España (~775.000 empresas).
• Funnel de conversión freemium: Free para hasta 3 empleados, Starter a 9,99€/mes como plan principal.
• Canales de adquisición: SEO (70% tráfico), Google Ads (20%), partnerships con gestorías y asociaciones.
• Proyección conservadora: 2.000 organizaciones y ~19.000€ MRR al mes 12.
• Riesgos clave: competidores con plan gratuito, retrasos regulatorios, escalabilidad técnica.

Este documento define la estructura de la base de datos de FichaYa, un sistema de fichaje laboral. Explica cómo se almacenan empresas, empleados, centros de trabajo, fichajes, correcciones y alertas. El modelo está diseñado para ser escalable, cumplir con normativas laborales y permitir informes precisos. Es la base técnica que garantiza que el producto funcione de manera fiable y legal.

• Define 9 tablas principales: organizaciones, usuarios, centros de trabajo, fichajes, correcciones, invitaciones, auditoría, alertas y caché de informes.
• Los fichajes son inmutables: nunca se modifican ni eliminan, solo se corrigen creando nuevos registros.
• Incluye índices críticos para consultas frecuentes como fichajes del día, mapa de equipo e informes mensuales.
• Estima un volumen de 1,4 millones de fichajes al mes para 2.000 empresas, dentro de los límites gratuitos de D1.
• Soporta geolocalización, fichaje offline y auto-cierre de jornada tras 12 horas.

Este documento detalla el plan de desarrollo de FichaYa, una aplicación de fichaje laboral para micropymes. El roadmap está dividido en fases que van desde un MVP básico hasta funcionalidades avanzadas como geofencing, reportes legales, planes de pago y BI. El objetivo es ofrecer una herramienta sencilla y rápida que compita con soluciones como Sesame, adaptada a las necesidades de pequeños negocios. La estrategia prioriza la velocidad de desarrollo y la iteración constante para capturar un mercado aún no dominado.

• MVP en 2 semanas con fichaje, geolocalización y gestión básica de empleados.
• Fase 2 enfocada en cumplimiento legal: informes para Inspección de Trabajo y retención de datos 4 años.
• Geofencing y notificaciones push para control de equipos distribuidos.
• Monetización desde la Fase 4 con planes Free/Pro/Business y trial de 14 días.
• Roadmap a 6+ meses incluye BI, turnos, integraciones con ERPs y API pública.

Este documento detalla la experiencia de usuario de FichaYa, un sistema de fichaje laboral para micropymes. Describe desde la primera visita hasta la gestión de incidencias, incluyendo onboarding, fichaje con geolocalización, mapas de equipo y reportes. El objetivo es mostrar cómo se simplifica el cumplimiento legal del registro horario, reduciendo la fricción para empleados y administradores. Es relevante para entender el producto desde la perspectiva del usuario final y validar flujos clave.

• Onboarding con Google SSO y opción de crear o unirse a empresa mediante código.
• Fichaje con botón grande, geofencing y modo offline con sincronización automática.
• Vista admin con mapa en vivo, gestión de equipo y reportes exportables.
• Flujos especiales: correcciones, jornadas abiertas y auto-cierre nocturno.
• Plan gratuito hasta 3 empleados, con planes de pago escalables.

FichaYa es un servicio de fichaje horario digital para empresas en España, diseñado especialmente para micropymes que aún usan papel o Excel. Cumple con la legislación española que exige el registro digital de jornada, evitando multas que pueden alcanzar los 6.250 euros. Se diferencia por su rapidez de configuración (30 segundos), un mapa en tiempo real que muestra la ubicación del equipo, y un precio muy competitivo con un plan gratuito para hasta 3 empleados. El objetivo es capturar el 0,1% de las 1,76 millones de empresas que necesitan digitalizarse, generando un negocio recurrente de más de 400.000 euros anuales.

• Obligatorio por ley desde 2019, con sanciones de hasta 6.250€ por empresa.
• Configuración en 30 segundos sin instalación (PWA y Google SSO).
• Mapa en vivo del equipo y geolocalización de fichajes.
• Planes desde 0€/mes (hasta 3 empleados) hasta 79,99€/mes (250 empleados).
• Dirigido a hostelería, comercio, construcción y otros sectores con alta rotación.

Este documento describe el asistente conversacional inteligente integrado en FichaYa, que permite a empleados y managers consultar datos de fichaje en lenguaje natural. El sistema combina function calling para datos en tiempo real (horas, fichajes, cumplimiento normativo) con embeddings para conocimiento legal estático (ley española, FAQ). Está diseñado para ser preciso, económico y escalable, usando DeepSeek Chat como LLM principal y Workers AI como fallback gratuito. El chatbot ya está en producción con fases 1, 2 y 3 completadas, ofreciendo valor tanto a usuarios como a la empresa como diferenciador competitivo.

• Chatbot experto en control horario que responde preguntas sobre fichajes, horas trabajadas y cumplimiento de la normativa laboral española.
• Arquitectura híbrida: function calling para datos vivos (precisión 100%) y embeddings para conocimiento estático (ley, FAQ).
• Usa DeepSeek Chat como LLM principal por su bajo coste y buen rendimiento, con Workers AI como fallback gratuito.
• Implementa control de acceso por roles (empleado vs admin) y aislamiento por organización.
• Incluye alertas proactivas, predicción de ausencias y notificaciones push diarias.
• Coste estimado de ~$0.10/mes en MVP, escalando a ~$40/mes para 500 organizaciones.