Caso de estudio · Así construí iAsesor

iAsesor.net

Software para asesorías laborales y fiscales, y registro horario para pequeños negocios. De la primera línea de código a la versión actual en cinco semanas.

Autor
Francisco Pérez Teijeiro
Periodo
Agosto – octubre de 2026
Estado
En producción, en uso diario en una asesoría laboral
Web
iasesor.net
El problema

El día 20, en una asesoría, no paran de sonar los teléfonos

Trabajo en una asesoría laboral. Cada trimestre se repite lo mismo: se presentan los impuestos, se manda un correo a cada cliente y, días después, el cliente llama para preguntar cuánto pagó o si ya se presentó el 303. La información existe, pero está enterrada en una bandeja de entrada.

En el mercado había dos extremos: programas de gestión muy completos y caros, pensados para despachos grandes, o herramientas baratas que solo cubren la contabilidad. Faltaba algo intermedio, pensado desde dentro de un despacho pequeño, con un portal donde el cliente viera lo suyo sin llamar.

A eso se sumó el registro horario: es obligatorio desde 2019 para cualquier empresa con trabajadores, y muchos negocios lo siguen llevando en papel o en un Excel que cualquiera puede retocar.

Lo que se construyó

Un mismo sistema, dos productos

Para asesorías

Gestión del despacho + portal cliente

  • Portal donde cada empresa cliente ve sus impuestos, cotizaciones y bajas de trabajadores
  • Control fiscal trimestral: tabla de clientes × modelos de Hacienda con su estado
  • Cotizaciones a la Seguridad Social a partir de los XML de Siltra, enviadas por email en bloque
  • Recordatorios automáticos a 30, 15 y 7 días de cada plazo
  • Avisos internos, agenda de citas y apoderamientos con alerta de vencimiento
  • Auditoría de acciones y copias de seguridad diarias
Para negocios

Registro horario

  • Kiosco de fichaje en el ordenador de la tienda, una tablet o el móvil de empresa
  • PIN o tarjeta NFC en la misma pantalla, sin cambiar de modo
  • Funciona sin conexión: guarda el fichaje y lo sincroniza al volver la red
  • Registro inalterable: las correcciones se apilan, el original no se borra
  • Detección de olvidos (entradas sin salida) y exportación para la Inspección de Trabajo
  • Se vende también por separado, a negocios que no cambian de asesoría
Kiosco de fichaje en una tablet mostrando «Buenos días, Marta. Entrada registrada 07:58».
El kiosco de fichaje en la tienda de una panadería (datos de ejemplo).
Dos móviles con el kiosco: teclado de PIN y aviso «Guardado. Se confirmará cuando haya conexión».
Fichaje en el móvil de empresa de un repartidor, también sin cobertura.
Decisiones técnicas

Lo que hizo falta resolver

Un registro horario que no se pueda retocar sin que se note

Cada fichaje guarda la huella SHA-256 del fichaje anterior de la misma empresa, así que forman una cadena. Si alguien modificara un registro antiguo directamente en la base de datos, su huella dejaría de coincidir y la cadena se rompería a partir de ahí. Las correcciones (un olvido, un corte de luz) no editan nada: se añaden como eslabones nuevos con su motivo y su autor. Un botón de «Verificar integridad» recalcula la cadena entera.

Hashes reales calculados con el mismo formato que usa la aplicación, sobre fichajes de ejemplo.

Escrituras ordenadas en un backend sin servidor fijo

El backend corre en funciones serverless, sin memoria compartida entre peticiones. Cuando varios trabajadores fichan seguidos en la misma tablet, dos peticiones podrían leer el mismo «último hash» y romper la cadena. Lo resolví con bloqueos con nombre de la propia base de datos (GET_LOCK de MariaDB). Por el mismo motivo, el límite de intentos de PIN se lleva en una tabla y no en memoria.

Fichar sin conexión, y un fallo encontrado en uso real

El kiosco es una aplicación web instalable con un service worker limitado a sus propios archivos. Sin red, guarda los fichajes en una cola local y los envía al volver la conexión, sin duplicarlos si el envío se corta a medias. En las primeras pruebas reales, un fichaje sin conexión quedó registrado dos horas antes: la hora del dispositivo llegaba en UTC y se guardaba como hora de Madrid. Lo corregí y dejé una prueba automática que reproduce exactamente ese caso.

Varias asesorías en una sola instalación

Cada asesoría tiene sus propios datos, separados por un identificador que se comprueba en cada petición al servidor. Con esa misma base, un negocio que solo quiere el registro horario es una cuenta con un menú reducido: no ve nada fiscal ni de clientes, y sus trabajadores fichan directamente para su empresa. Pasarlo después a la versión completa es un clic.

Seguridad revisada como en una auditoría

Revisé todos los puntos de entrada del servidor y corregí lo encontrado: límite de intentos para que nadie pueda probar los 10.000 PIN posibles, PIN guardados con PBKDF2 y un secreto aparte, claves separadas para tareas automáticas y manuales, protección contra fórmulas maliciosas al abrir los CSV en Excel y la documentación de la API desactivada en producción.

Demos sin tocar datos reales

Para enseñar el producto por videollamada hay cuentas de demostración que se rellenan con un clic: clientes, impuestos, citas y tres semanas de fichajes con su cadena válida. Los clientes ficticios usan dominios de correo reservados, y el sistema de envío se niega a escribirles, así que los recordatorios automáticos nunca salen hacia ellos.

Cifras

El proyecto en números

152commits
23.500líneas de código
19módulos de la API
23pantallas
+160comprobaciones automáticas
5semanas de desarrollo
Cronología

De la idea a producción

  1. Arranque: primera versión desplegada con base de datos MariaDB y Vercel.
  2. Recordatorios automáticos por email con tareas programadas.
  3. Cotizaciones de la Seguridad Social desde los XML de Siltra, portal cliente y auditoría de acciones.
  4. Separación real de datos por asesoría. Primera asesoría en producción.
  5. Bajas de trabajadores e histórico de impuestos en el portal cliente.
  6. Registro horario: kiosco con PIN y tarjeta NFC y cadena de integridad.
  7. Modo sin conexión: aplicación instalable con cola local.
  8. Auditoría de seguridad completa y correcciones en producción.
  9. Registro horario como producto independiente para negocios.
  10. Web para negocios, cuentas de demostración y precio de lanzamiento.
Tecnología

Con qué está hecho

  • Python · FastAPI
  • SQLAlchemy 2
  • MariaDB
  • Vercel (serverless + tareas programadas)
  • Firebase Authentication
  • JavaScript sin framework (módulos ES)
  • PWA · Service Worker
  • Resend (email)

Frontend sin framework a propósito: carga rápido, no hay nada que compilar y cualquier pantalla se puede leer y cambiar directamente.

Cómo se hizo

Producto propio, programado con IA

La mayor parte del código se escribió con Claude, un asistente de programación con inteligencia artificial, bajo mi dirección. Lo que hice yo:

  • Definir el producto desde la experiencia diaria en una asesoría
  • Decidir la arquitectura, las prioridades y qué se dejaba fuera
  • Probar cada versión en uso real y detectar los fallos
  • Operar la base de datos, las migraciones y los despliegues
  • Revisar la seguridad y validar las correcciones
  • Precios, web de venta y captación de clientes
Contacto

¿Quieres verlo funcionando?

Lo enseño en una videollamada de 20 minutos con las cuentas de demostración. Y si a tu asesoría o a tu negocio le falta una función concreta, también hacemos desarrollos a medida.