Fase B1 — Base del Maestro de Activos

Versión: 0.8.0

Objetivo

Reemplazar el placeholder de Activos por el primer núcleo funcional del Maestro de Activos, sin fijar niveles como Empresa, Área, Yacimiento o Pozo.

Modelo incorporado

asset_types: tipos configurables y activables/desactivables;
asset_type_parent_rules: múltiples tipos padre permitidos por tipo hijo;
asset_attribute_definitions: atributos configurables por tipo;
assets: entidades administrables con identidad y padre opcional;
asset_attribute_values: valores tipados de cada activo.

La jerarquía se controla con dos reglas:

un tipo puede o no permitir activos raíz;
un tipo puede aceptar cero, uno o varios tipos padre.

La API también evita ciclos en la jerarquía real de activos.

Atributos dinámicos

Tipos iniciales de dato:

texto;
número;
verdadero/falso;
fecha;
fecha y hora;
selección con opciones configurables.

Los atributos pueden ser obligatorios, tener unidad, orden e inactivarse sin borrar valores existentes.

Estados de información

DRAFT;
PENDING_SURVEY;
SURVEYED;
VALIDATED;
OBSERVED;
OUTDATED;
INACTIVE.

Estos estados describen la calidad o vigencia de la información. No representan el estado operativo o mecánico del activo.

API

Tipos y atributos:

GET /api/v3/asset-types;
GET /api/v3/asset-types/:id;
POST /api/v3/asset-types;
PATCH /api/v3/asset-types/:id;
POST /api/v3/asset-types/:id/attributes;
PATCH /api/v3/asset-types/:id/attributes/:attributeId.

Activos:

GET /api/v3/assets;
GET /api/v3/assets/parent-options;
GET /api/v3/assets/:id;
POST /api/v3/assets;
PATCH /api/v3/assets/:id;
PATCH /api/v3/assets/:id/information-status.

No se implementa borrado físico.

Permisos

asset_types.read;
asset_types.manage;
assets.read;
assets.create;
assets.update;
assets.change_status.

La migración los asigna a los roles de sistema según su alcance y entrega todos al rol admin.

Interfaz web

/activos: búsqueda, filtros, tabla y jerarquía visible;
/activos/nuevo: alta con atributos dinámicos;
/activos/:id: consulta/edición y cambio de estado según permiso;
/admin/asset-types: configuración de tipos, padres y atributos.

Trazabilidad

Se auditan altas y cambios de tipos, atributos, activos y estado de información. Los valores dinámicos quedan incluidos en el antes/después sanitizado.

Fuera de B1

Quedan para próximas subfases:

geometrías PostGIS y edición en mapa;
fotografías y media versionada;
versiones históricas y consulta temporal;
importaciones/procedencia avanzada;
relevamiento de campo.

2.7 KiB Raw Blame History