Preferencias de unidades

Cada usuario puede elegir en qué unidades VE TankOS — métrico (SI) o imperial — desde /me/settings. Esta es la convención central del sistema: cambiar una unidad afecta solo cómo se presenta un valor, nunca lo que se almacena ni los cálculos de custodia. La definición canónica vive en el glosario: Sistema de unidades (SI ⇄ Imperial).

El invariante SI

TankOS almacena TODO en SI — la unidad solo cambia el render

TankOS almacena todas las magnitudes en el Sistema Internacional (SI): longitudes en mm, volúmenes en m³, masa en kg, temperatura en °C, presión en kPa, densidad en kg/m³ y caudal en m³/h. La conversión ocurre solo al renderizar.

🔒 Cambiar una unidad solo cambia cómo VES el valor, nunca lo que se almacena ni los cálculos de custodia.

Por eso un usuario puede ver todo el sistema —dashboard, detalle de tanque, tablas de aforo, gauging tickets y reportes— en imperial: alturas en pie · pulgada · fracción (por ejemplo 37′ 8⅛″), volúmenes en barriles (bbl), temperaturas en °F y presiones en psi — sin pérdida de precisión.

Este invariante es lo que hace seguro el valor custody: el dato almacenado es reproducible bit-a-bit, independiente de la unidad mostrada. Dos usuarios —uno en SI, otro en imperial— miran el mismo ticket de custodia o el mismo reporte y leen el mismo valor físico, cada uno en su unidad de trabajo, sobre un único número canónico en SI.

Las 7 magnitudes

Cada dimensión (magnitud) tiene una unidad de almacenamiento en SI y un conjunto de unidades aceptables para mostrar. El override por magnitud cambia solo el render; el storage es siempre la columna Unidad SI.

Magnitud	Unidad SI (almacenamiento)	Equivalentes imperiales / alternativas
Longitud	mm	in, ft, ft-in-frac (37′ 8⅛″) · cm, m
Volumen	m³	bbl (barriles), gal · L
Masa	kg	lb, short_ton · t
Temperatura	°C	°F
Presión	kPa	psi · bar, MPa
Densidad	kg/m³	API (grados API)
Caudal	m³/h	bbl/h, gpm

ft-in-frac es el estándar de aforo de la industria petrolera

ft-in-frac es un caso especial de la dimensión longitud: expresa la altura en pie · pulgada · fracción de pulgada (37′ 8⅛″), el formato habitual de las tablas de aforo imperiales. Es un LengthDisplayUnit aceptado solo en la dimensión longitud — no aplica a las demás magnitudes.

Configurar tus preferencias paso a paso

1. Abrir /me/settings. La página carga tus preferencias actuales.
2. Idioma, región y tema: language (es-VE | en), timezone IANA (default America/Caracas), theme (light | dark).
3. Sistema de unidades general: unitSystem (metric | imperial). Es el preset que define las unidades de todas las magnitudes a la vez.
4. Overrides por magnitud: cada una de las 7 magnitudes tiene su propio dropdown con las unidades aceptables de esa dimensión. Así puedes, por ejemplo, ver casi todo en métrico pero las alturas en ft-in-frac.
5. Precisión decimal: decimalDisplayPrecisionOverride (un valor 1–6, o default para usar la precisión propia de cada unidad).
6. Revisar el live preview: la tarjeta de la derecha muestra en tiempo real cómo quedarían tus KPIs con las preferencias actuales (ver más abajo).
7. Guardar o cancelar: el indicador "sucio" (punto ámbar) avisa cuando hay cambios sin guardar. Guardar persiste tus preferencias; Cancelar las revierte a los valores del servidor sin recargar.

Live preview

Ve el efecto antes de guardar

La tarjeta MeSettingsPreviewCard (una columna sticky de 320 px) renderiza en tiempo real —mediante form.watch()— cómo se verían los KPIs con las unidades que estás seleccionando, antes de guardar. Así confirmas que 37′ 8⅛″, bbl, °F o psi se muestran como esperas sin tener que aplicar el cambio a ciegas.

Régimen de custodia (custody regime lock)

El régimen de custodia es del TANQUE, no del usuario

El régimen de custodia (Tank.custodyRegime: SI | US-MPMS) es un parámetro de ingeniería a nivel de cada tanque, que fija el ingeniero en el editor de tanque. NO es editable por el usuario en /me/settings.

Las alturas de las tablas de aforo se renderizan en el régimen del tanque (regime-locked), no con tu preferencia personal — por trazabilidad custody: la lectura de aforo debe leerse siempre en el régimen con el que se calibró el tanque, sea quien sea quien la mira.

Páginas relacionadas

• Sistema de unidades (SI ⇄ Imperial) — la definición canónica de la convención.
• Detalle de tanque — donde el conmutador SI ⇄ Imperial se usa sobre la cadena de factores custody.
• Tickets de custodia y Reportes — se pueden leer en SI o imperial sobre el mismo valor almacenado, sin pérdida de precisión.

La guía por rol con las preferencias recomendadas para cada perfil se publicará (próximamente).