← Sebastián Allende

Construye Hoy: control diario de obras para constructoras

Partes diarios, asistencia con GPS, bodega, programa, control de costos y un portal para el cliente, para constructoras pequeñas y medianas con varias obras a la vez. Una app sirve al jefe de obra, a bodega, a trabajadores, a subcontratos y al cliente, y un panel web a los dueños y a contabilidad. Está en desarrollo y todavía no está desplegada. Todo lo que se ve aquí usa datos ficticios.

Inicio del portal del cliente con el avance, la fecha de entrega y una decisión pendienteAvance
Un adicional con su precio, IVA y un botón para aprobarloAdicional
Mensajes entre el cliente y el jefe de obra, ligados al adicionalMensajes

El portal del cliente, con una constructora y una casa ficticias.

Cómo está armada

  1. Apps
    • App Expo con cinco roles, primero sin conexión
    • Panel web para dueños y contabilidad
  2. Servidor
    • API Hono en Cloudflare Workers
    • Lectura con IA, invitaciones, 2FA, acceso con QR
    • Tareas programadas
  3. Datos
    • PostgreSQL con seguridad por fila
    • Archivos y campos cifrados

Las apps leen y escriben en la base directamente con la sesión de cada usuario, así que la seguridad por fila decide qué ve cada persona. La API solo hace lo que un usuario no puede hacer solo, y usa acceso elevado únicamente en esos casos. La lógica del negocio que necesitan todas las apps vive en un paquete compartido.

IA que propone y espera a una persona

  1. Foto o PDF
  2. El modelo llena un esquema
  3. Se revisan los totales
  4. Una persona confirma
  • Salida estructurada, y después aritmética. Las facturas y cubicaciones vuelven como datos validados con un esquema, con una marca de legibilidad y una confianza por ítem. Después se revisan los totales de la factura con aritmética, antes de pedirle a alguien que confirme.
  • Los documentos son datos, no instrucciones. El documento va al modelo separado de la instrucción, así que el texto dentro de un PDF no puede actuar como una orden.
  • Primero el modelo barato. Lee primero un modelo rápido, y uno más fuerte reintenta solo si el resultado no es legible. Una respuesta cortada no se reintenta.
  • Costo en cada llamada, contenido en ninguna. Cada llamada, incluidas las fallidas, queda registrada con su modelo, tokens y costo calculado, pero sin el documento. Cada empresa tiene una cuota mensual, y un modelo desconocido se cobra a la tarifa más alta.
  • El proveedor es intercambiable. El modelo está detrás de una interfaz, y sin clave la app sigue funcionando a mano.

La lectura con IA está construida y probada, pero todavía no ha corrido contra la API real, así que aún no hay cifras de costo reales.

La base de datos es la frontera de seguridad

  • Seguridad por fila en cada tabla. Los roles de dueño y contabilidad solo funcionan después de la autenticación en dos pasos.
  • La plata donde pocos la ven. Los montos se guardan como enteros y solo en tablas que el personal de obra y los clientes no pueden leer. El RUT de los proveedores va cifrado.

Pruebas

59 archivos de Vitest con unos 580 casos para la API, el panel, la app y la lógica compartida, 42 archivos de pgTAP para las reglas de la base, y dos scripts de punta a punta que manejan la app y el panel en Chrome, uno de ellos con la red cortada a propósito. Las respuestas del modelo están grabadas, así que ninguna prueba llama a la API: una le entrega al SDK real una respuesta grabada y revisa la solicitud y el costo calculado. El flujo de integración continua revisa tipos, levanta una base local y corre todas. El código es privado, y con gusto lo recorro en una entrevista.