Data Tracking

Data Tracking (/admin/data-tracking) lista una fila por día de obra en un proyecto. El operador revisa concreto usado vs rendimiento, totales diarios y profit; inicia una medición o una factura desde la misma pantalla después de elegir un proyecto en la barra.

Permisos: FunctionId DATA_TRACKING (10), menú Gestión de proyectos → Data Tracking (function.url = data_tracking). View abre el listado. Add muestra Nueva medición. Delete muestra Eliminar en el ⋮ y el borrado masivo. Nueva factura usa FunctionId INVOICE (11) Add, no el Add de Data Tracking.

Disposición de la pantalla

Listado Data Tracking

Figura: listado FoodHub — título Data Tracking, subtítulo Manage Data Tracking, New Invoice y New Measurement en la cabecera, ? de ayuda; tarjeta con Search data tracking…, combobox de proyecto, Filter, Export, Date y Project ordenables, columnas numéricas, tinta pending, ⋮, checkboxes y paginación (30 por defecto).

Región	Qué ves
Barra de página	Título Data Tracking, subtítulo Manage Data Tracking, Nueva factura (Invoice Add), Nueva medición (Data Tracking Add) y el icono `?` (este artículo).
Tarjeta de datos	Búsqueda, combobox Proyecto (siempre visible), Filtro, Exportar, columnas, tinta pending, checkboxes (Delete), barra masiva, Ordenar por en móvil, paginación.
Wizard del día	Superficie B en la URL del listado (`?create=1&projectId=` / `?edit=` / `?view=`) — pills General, Ítems, Mano de obra, Materiales, Proveedores de concreto, Subcontratista y Adjuntos.

Orden por defecto: Fecha descendente. Tamaño de página por defecto: 30.

Columnas del listado

Columna	Significado
Fecha	Día de obra (`m/d/Y`). Ordenable.
Proyecto	`projectNumber - description`. Ordenable. Un día cancelado muestra la pastilla roja Cancelado encima del nombre (tooltip: motivo, quién es responsable, notas). Si se cobra al cliente, la pastilla dice Cancelado · Cobrado.
Conc. usado (CY)	Suma de cantidades de proveedores de concreto de ese día.
Rendimiento conc. (CY)	Suma del yield del ítem: vacío/`none` → 0; `equation` → fórmula evaluada; si no, cantidad del ítem.
Diferencia (CY)	Conc. usado menos rendimiento, redondeado a 2 decimales.
Total conc. ($)	Costo de concreto del día.
Total labor ($)	Horas de labor más personas × overhead.
Total diario ($)	Importe diario de ítems menos subcontract.
Profit ($)	Total diario menos (concreto + labor + materiales + pérdida anormal).

Cantidades y montos usan el formato US del admin (miles ,, decimal ., dos decimales).

Un día Pendiente (pending = 1) lleva tinta ámbar. Esa tinta no es la misma que la selección del checkbox. Al guardar el día se recalcula el flag: sin ítems (salvo Prepwork) o algún ítem con quantity 0. El job HTTP GET /definir-pending-datatracking (handler pending-data-tracking en Jobs programados) reescanea todos los días para alinear filas viejas.

Un día Cancelado (cancelled = 1) conserva las columnas numéricas; la pastilla en Proyecto es cómo se ve en el listado. El wizard cambia motivo, notas, cobro o fecha de reprogramación.

Filtros y búsqueda

Proyecto — combobox de la barra (sección superior). Obligatorio antes de Nueva medición o Nueva factura. Si está vacío, el toast es Seleccioná el proyecto en la sección superior (EN: Select the project in the top section).
Búsqueda — número, nombre y descripción del proyecto, crew lead, measured by, station number, notes y other materials (tres o más caracteres).
Filtro:
- Estado — todos, Pendiente o Completado.
- Rango Desde / Hasta.
- ¿Mostrar solo lista PUNCH? — días con al menos un ítem con punch quantity mayor que 0.
Exportar — Copiar, Excel y CSV de la página actual, mismas columnas visibles.

Aplicar / Restablecer viven en el popover de filtro. Cambiar el combobox de proyecto recarga de inmediato.

Nueva medición y nueva factura

Nueva medición abre el wizard New Data Tracking: más el proyecto elegido en la barra. Recorré las pills General → Attachments (siete pasos). En Formulario del día hay una figura del wizard.

Si ya hay una medición para el mismo proyecto y fecha, aparece Duplicate Measurement (Medición duplicada). Yes / Sí igual guarda; la API no bloquea ese par.

Nueva factura también exige el proyecto de la barra. Abre /admin/invoices?create=1&projectId= con el período del mes calendario siguiente ya cargado. Ver Facturas.

Wizard — General

Date / Fecha (obligatorio), Inspector (+ alta rápida), Station Number(s), Measured By (Field Measurements y luego Employees).
Total People — solo lectura; cantidad de filas de labor.
Overhead Price, Color Used/Price, Notes, Prepwork.
Cancelled — si está activo, Cancel reason y Cancellation details son obligatorios (copy de origen: Select the reason why the work was cancelled. / Write the cancellation details (what happened that day).). Opcionales Charge the customer y Re-schedule to (Invalid re-schedule date. si la fecha no es válida). Al marcar Charge the customer se agrega 1 MOBILIZATION en Items si el proyecto tiene ese ítem de catálogo (notas que empiezan con Cancelled: ). Desmarcar cobro o cancelado quita solo esa línea automática. Una fecha de reprogramación copia los Schedule del proyecto al día nuevo (o crea uno básico) con la marca (Re-scheduled from m/d/Y); cambiar la fecha borra la copia anterior.

Wizard — Items

Columnas: Code, Item, Unit, Yield Calculation, Quantity, Yield Calculation Value, Price, Total $.

Junto al nombre: R verde (retainage), B rojo (bond de catálogo), B azul (bonded) y + de historial change order / add-on.
Quantity puede mostrar Partial o PUNCH List y un + de historial de cantidad; Price muestra + de historial de precio si hay filas en project_item_history. Esos + abren Change Order History (el mismo log que usarán Invoices y Payments).
New abre New Pay Item Measured (fecha de obra en el título): % of Contract Completed, Quantity angosto, switches PUNCH y Partial.
+ junto al pay item agrega un ítem al proyecto (modal-item-project).

Wizard — Labor

Owner vs Subcontractor, horas, rol, Crew Lead, selector de color (default #34BFA3). Swatch de color junto al nombre en la tabla.
+ junto a Employee → New Employee: Name, Hourly Rate, Position, color (default #17C653).
+ junto al empleado de subcontratista → Name, Hourly Rate, Position.

Wizard — Materials

Tabla de materiales: material, proveedor, unidad, cantidad, precio.
Abnormal Loss está en este paso (no es otra pill): tabla Amount / Note; el botón Abnormal Loss abre importe ($, obligatorio), Note con formato y Attachments anidados.
Add Attachment anidado usa el mismo formulario que el paso 7. Acciones de fila: View (ojo), Edit, Delete.

Wizard — Conc Vendors

Columnas: Conc Vendor, Total Conc Used, Conc Price, Total $.

Leyenda	Significado (copy de origen en inglés)
Recuadro durazno + flecha arriba-derecha	Total over the amount quoted for that vendor — Over the quoted amount: total used $X vs quoted $Y (over by $Z).
Recuadro amarillo + triángulo de aviso	Vendor not assigned to the project — This vendor is not one of the concrete vendors assigned to the project.

Si el proyecto tiene proveedores de concreto asignados, la barra muestra Project vendors: Name (N classes, $quote).

Wizard — Subcontractor

Subcontratista, pay item, cantidad, precio, notas. Al guardar puede agregar el pay item a Items si faltaba.

Wizard — Attachments (paso 7)

Tabla Name, File. New abre New Attachment: Name, dropzone (Drop files here or click to upload.), Tags, Note con formato. Nombre duplicado: The attachment has already been added. Acciones: View, Edit, Delete.

Modales de colección — Add vs Update

Acción	Items, Labor, Materials, Abnormal Loss, Conc Vendors, Subcontractor	Catálogo anidado (+ employee, + ítem, + inspector, + vendor)	Attachments (día o Abnormal Loss)
Add	El modal queda abierto y el formulario se reinicia. En Labor Add se conserva el Crew Lead elegido.	El modal cierra al guardar.	El modal cierra al guardar.
Update	El modal cierra.	El modal cierra.	El modal cierra.

Formulario del día

Wizard del día de Data Tracking

Figura: wizard Surface B — título New Data Tracking: más el proyecto, siete pills General, Items, Labor, Materials, Conc Vendors, Subcontractor, Attachments, Date/Inspector/Station/Measured By, overhead y color, Prepwork, y tablas de colección.

Ver (?view=) es solo lectura y ofrece Cambiar a edición si hay permiso Edit. En edición, la cantidad acepta + / - / = respecto de la línea actual. El precio es siempre el vigente en el servidor para esa fecha.

Acciones de fila y borrado

El ⋮: Ver y Editar abren el wizard del día; Eliminar quita el encabezado (y sus hijos) si hay permiso.

El borrado masivo usa el mismo permiso. Toast de éxito: La operación se realizó correctamente.