Glosario

Términos de obra y de Obratrace que aparecen en este manual. Si una pantalla dice APU o ledger, aquí está qué significa y qué hace en la app.

APU

APU significa Análisis de Precio Unitario (en inglés, Unit Price Analysis). Es el documento técnico que desglosa los costos necesarios para ejecutar una unidad de obra: un metro cuadrado, un metro cúbico, una unidad.

El precio de la partida se puede auditar insumo por insumo.

Qué incluye

Componente	Ejemplo
Materiales	Cemento, acero, arena
Mano de obra	Jornal del albañil y del ayudante
Equipos / maquinaria	Hormigonera, vibrador
Herramientas menores	Carretilla, palas (suelen calcularse como un % de la mano de obra)
Rendimiento	Por ejemplo, 0,8 h/m² de enlucido
Desperdicio	Por ejemplo, 5 % de material
Costo unitario final	El que se carga a la partida

En la pantalla de presupuesto, cada línea guarda tres importes: materiales, mano de obra y equipo. El precio unitario es la suma de los tres. Herramientas, rendimiento y desperdicio entran en ese cálculo antes de escribir la cifra; la app no tiene una columna aparte para cada uno. Si la línea no trae desglose, se carga un solo precio unitario.

Ejemplo: 1 m² de contrapiso

Concepto	Importe
Materiales	8,50
Mano de obra	6,20
Equipo	1,10
Herramientas (3 %)	0,44
APU	16,24 / m²

La moneda es la del proyecto (en este manual, USD).

Por qué importa

Justifica el precio: 16,24 sale de insumos que se pueden revisar, no de una cifra cerrada.
Permite comparar lo presupuestado con lo real en compras y en avance de obra.
El jefe de proyecto ve la desviación en la partida antes de que el sobrecosto sea irreversible.
Una biblioteca de APUs de obras anteriores mantiene el mismo criterio en la empresa.

En Cargar el presupuesto se revisan estas líneas al importar el CSV o al editar una revisión.

Ledger

Ledger (libro mayor) es el registro oficial de los movimientos de dinero y de tiempo que ya quedaron decididos. Cada movimiento tiene dueño, motivo, cambio vinculado y versión resultante.

Qué garantiza

Principio	Significado
Inmutabilidad	Una versión aprobada no se reescribe. Lo que sigue es una versión nueva.
Trazabilidad	Cada movimiento de importe y de días queda ligado a quién lo aprobó y por qué.
Auditoría	Siempre se puede responder cuánto costaba el proyecto en la versión 2, y por qué se añadieron 14 días.

Así se lee en la obra:

Presupuesto V0 (base) → Cambio n.º 1 aprobado → Presupuesto V1 (+importe, +días)
                         Cambio n.º 2 aprobado → Presupuesto V2 (+importe, −días)

El cliente es quien mueve el ledger al aceptar la cotización. La firma del arquitecto y la del constructor dejan constancia de que el alcance es ejecutable; el presupuesto y el plazo siguen igual hasta la aceptación del cliente. Sugerir tags propone etiquetas; alguien del equipo las confirma. La sugerencia no cambia el estado oficial.

Para recargar la base entera, el jefe de proyecto abre Editar presupuesto (nueva revisión) y la aprueba. La versión anterior sigue en el historial. Un cambio puntual de obra se formaliza en Cambios, no editando líneas a mano.

Coste y plazo, a la vez

Obratrace lleva los dos registros como datos de primer nivel:

LEDGER DEL PROYECTO
├── Coste → presupuesto vigente = base ± cambios aprobados
└── Plazo → fecha objetivo ± días de cada cambio aprobado

En el inicio del proyecto se leen el presupuesto vigente y el plazo vigente: cuánto cuesta ahora, cuánto tiempo añade el cambio y qué plazo queda.

Cómo se relacionan

APUs → partidas del presupuesto base (V0)
         ↓
     Cambios (impacto en importe y en días)
         ↓
     Ledger actualizado (V1, V2…)
         ↓
     Estado oficial: presupuesto vigente + plazo vigente

Los APUs construyen el baseline económico.
Los cambios modifican ese baseline.
El ledger registra cada modificación en una versión que permanece.
Coste y plazo se actualizan juntos: un cambio que solo mira el dinero deja la fecha sin cerrar.

Otros términos

Término	Qué es en Obratrace
Consulta	Hilo para aclarar una duda, etiquetado por elemento. El presupuesto y el plazo siguen igual. Si la duda cambia la obra, pasa a cambio.
Cambio (solicitud de cambio)	Trámite con impacto en coste y en días, cotización y firmas. El número oficial se actualiza cuando el cliente acepta.
Presupuesto vigente	Coste oficial de la obra: la última versión de presupuesto aprobada.
Plazo vigente	Fecha objetivo más o menos los días de los cambios que el cliente ya aceptó.
Impacto coste / impacto plazo	Las dos cifras de una solicitud. En el ejemplo de la escalera: +2.400 USD y +7 días. El cliente las ve juntas antes de aceptar.
Cadena de firmas	Orden por defecto: arquitecto, luego constructor, y al final el cliente. Tras la primera firma no se editan los totales ni los adjuntos.
Cotización	PDF, Excel o foto adjunto al cambio. Tiene que describir el mismo alcance que el impacto declarado.
Partida	Una línea del presupuesto: descripción, unidad, cantidad y precio (APU o precio unitario). La descripción es obligatoria en el CSV.
Capítulo	Grupo de partidas (cimentación, estructura, acabados…). El catálogo de la empresa sigue un esquema tipo CSI de Centroamérica.
Catálogo de categorías	Lista maestra de capítulos de la empresa. La edita el propietario en Configuración. Presupuesto y planos usan esos nombres.
Perfil de categorías	Subconjunto del catálogo (por ejemplo, solo acabados e instalaciones) que se aplica a una o varias obras. Abrirlo muestra sus capítulos y los proyectos que lo usan.
Versión de presupuesto	Foto numerada (v1, v2…). La aprobada es la del ledger. Las anteriores se consultan en el historial.
Revisión	Borrador abierto para corregir o recargar el presupuesto. El vigente sigue siendo el anterior hasta que esta revisión se aprueba.
Borrador	Presupuesto o cambio que todavía se está rellenando. Aún no es oficial.
Estado oficial	Lo vigente a la vez: presupuesto, plazo y versión oficial de planos y documentos. Se actualiza con una aprobación.
Versión oficial	El plano o documento que rige la ejecución. Subir el archivo lo incorpora al repositorio; Marcar oficial lo deja vigente. La revisión anterior sigue en el historial. Marcar oficial no aprueba un sobrecoste.
Elemento y tag	Etiqueta para reunir después todo lo de un mismo sitio, por ejemplo `Escalera`. Hace falta al menos una para abrir una consulta o un cambio.
Dominio	Qué toca el cambio: diseño, material, mano de obra, equipo, alcance, planificación… Se marca en Afecta a.
Archivo	Paquete exportado del proyecto (hoja de cálculo o JSON) para revisión externa o respaldo. Es una foto de lo ya registrado.
Organización	La empresa (constructora, estudio o promotora). La da de alta Obratrace e invita al primer usuario. Dentro viven los proyectos.
Proyecto	Una obra: cliente, moneda, fechas objetivo y, cuando se aprueban, presupuesto y plazo.
Rol	Lo que esa persona firma en la obra: jefe de proyecto (`project_manager`), arquitecto (`architect`), constructor (`contractor`) o cliente (`client`). El cliente es quien acepta el sobrecoste y el retraso.