Groma

Una cantidad debe poder explicarse

Cuantificar tablarroca no consiste solamente en reconocer líneas en un PDF. El estimador necesita saber qué representa cada muro, cuáles de sus caras llevan panel y qué altura corresponde a cada una. Si una cantidad pierde ese vínculo con el plano, resulta difícil revisarla o explicar una corrección.

Groma nació de ese problema, a partir de los criterios de estimación y el conocimiento de campo de la empresa familiar. El producto busca conservar la relación entre documento, geometría, criterio constructivo y cantidad.

Mi responsabilidad: del criterio al producto

Fundé Groma y traduzco las prácticas de cuantificación en requerimientos de producto. Reviso los resultados contra los planos y dirijo la implementación con herramientas de desarrollo asistido por IA. Mi responsabilidad es definir qué debe poder inspeccionar y corregir el estimador, y reconocer cuándo falta evidencia para aceptar un resultado.

Las tecnologías describen la arquitectura del proyecto, no un dominio personal equivalente de programación en cada una de ellas. La asistencia de IA forma parte del desarrollo; la revisión humana sigue siendo parte del producto.

Un muro físico, dos caras que revisar

El cálculo revisado identifica tramos físicos únicos de muro y conserva identificadores estables del tramo y su fuente. Para cada cara con tablarroca, calcula longitud por altura resuelta. Así, un muro compartido por dos habitaciones no se convierte en dos muros físicos, aunque sus dos caras puedan aportar superficie.

El ejemplo interactivo utiliza dos habitaciones ficticias de 11 × 10 y 9 × 10 pies. Comparten un muro de 10 pies; un vano de 3 deja 7 pies de tramo sólido. Con dos caras de 8 pies de altura, el resultado mostrado es 56 + 56 = 112 pies². El puente geométrico que cierra el contorno del vano aporta cero panel.

Esta demostración fue escrita de manera independiente. Permite comparar alturas de 8 o 9 pies y vanos de 0 o 3, únicamente en el muro central. No incluye dinteles, retornos del vano, capas, desperdicio, precios, exteriores ni plafones. No ejecuta Groma ni procesa planos de clientes.

La corrección modifica la fuente del cálculo

La interfaz en Next.js, el servicio en Python/FastAPI y Postgres forman parte de la implementación. Los registros conservan las referencias necesarias para relacionar geometría, revisión y cantidades.

Las correcciones admitidas modifican los datos de entrada, no solamente el total visible. La ruta de revisión valida los campos, registra el valor anterior y el nuevo, y pone el recálculo en cola. No permite editar cualquier propiedad ni resolver todos los casos geométricos.

Tres límites que el sistema debe conservar

Cerrar un contorno no crea material. Un tramo opening_bridge ayuda a cerrar la topología, pero tiene faces=[] y aporta cero panel. No constituye una deducción general de áreas de puertas o ventanas. El número de capas del sistema constructivo tampoco actúa como multiplicador en este cálculo.

La información faltante no se inventa. Una altura ausente o una cara pendiente de resolver bloquea la cuantificación para revisión. Elegir una altura predeterminada produciría una cifra aparentemente completa sin sustento suficiente.

Una corrección debe corresponder a la versión revisada. La ruta rechaza campos desconocidos, entradas duplicadas y un hash de artefacto desactualizado. Distingue el conflicto de versión 409 stale_revision del error de validación 422 validation_failed, para no confundir una entrada inválida con una revisión que ya cambió.

Pruebas ejecutadas, con alcance acotado

El 3 de octubre de 2026 se contrastó este caso con la revisión de código c058543c66e24f42ae377f7cb417719ca7360029. Pasaron 16 pruebas seleccionadas de pipeline/tests/stages/test_quantify.py en una copia aislada, sin acceso a la red, con el entorno de credenciales despejado y la carga de archivos dotenv deshabilitada. Se registraron cinco advertencias de deprecación de PyMuPDF.

Las pruebas utilizan los PDF sintéticos generados two_room_shared_wall y door_gap_water_closet. Recorren ingesta, escala, geometría, lectura y conciliación con respuestas de modelo simuladas, y cuantificación. No son una prueba integral de navegador, servicio y producción, ni una medición de precisión sobre planos de clientes. La imagen de control de calidad publicada también utiliza un plano sintético; no documenta uso en producción.

Consultar el resumen de verificación · JSON. Incluye la revisión de código, las condiciones de aislamiento, la cobertura y los límites del resultado; no contiene código privado ni planos de clientes.

De una corrección a un resultado aprobado

En la misma fecha y revisión de código pasó una prueba adicional de integración de la API, sin acceso a la red. Recorrió un plano sintético desde la confirmación de láminas hasta la revisión, una corrección de altura de 8 a 9 pies, el recálculo, la aprobación de una versión específica del presupuesto y la recuperación de archivos de salida. La corrección produjo una nueva versión de cantidades y un cambio de precio.

La prueba se ejecutó dentro de un mismo proceso, con datos y almacenamiento en memoria, respuestas de modelo simuladas y un archivo colocado en el almacenamiento por la propia prueba. No verificó la carga desde un navegador ni un flujo en producción. Se registraron 93 advertencias de deprecación.

Se recuperó el archivo XLSX y se comprobó su firma ZIP; su contenido y formato no se revisaron de manera independiente. La generación de PDF sigue sin verificarse: la salida identificada como PDF fue un respaldo en HTML porque faltaba una biblioteca nativa de renderizado. Que la prueba del flujo pase no demuestra que el PDF sea válido.

Consultar la verificación del flujo de la API · JSON. El registro distingue la revisión de código evaluada del identificador de prueba usado en los artefactos y documenta la configuración, los archivos observados y los límites pendientes.

Módulos implementados; integración en desarrollo

Groma tiene módulos de extracción, revisión y estimación implementados. La evidencia revisada respalda mecanismos concretos de cálculo y corrección, no un presupuesto completo ni un flujo automático hasta Minera. Esa integración continúa en desarrollo y validación. La vivienda de este sitio proviene de un modelo de Minera; no demuestra una extracción de Groma.

El repositorio permanece privado. No publico cifras de adopción, precisión o ahorro sin mediciones autorizadas. Sigue evaluar la cobertura de casos geométricos, las correcciones que debe hacer el estimador, la continuidad entre navegador y servicio, y la calidad de los archivos generados. Las pruebas sintéticas acotan esas preguntas; no las dan por resueltas.