docs: define F7 simple inventory model

docs/F7_SIMPLE_INVENTORY_MODEL.md

@@ -0,0 +1,136 @@
+# F7 · Modelo simple de Inventarios
+
+Este documento fija el nuevo eje funcional de Inventarios para DH Inspección V2. Su objetivo es reducir la complejidad visible y orientar toda la experiencia al trabajo real de inspección.
+
+## 1. Jerarquía
+
+La estructura física es única:
+
+**Departamento → Área → Yacimiento → Instalación → Subinstalación**
+
+- Departamento y Área organizan el territorio.
+- Yacimiento, Instalación y Subinstalación son niveles válidos para registrar Hallazgos.
+- Una Instalación pertenece a un Yacimiento.
+- Una Subinstalación pertenece a una Instalación.
+
+## 2. Empresas
+
+- Un Área puede estar explotada por varias Empresas al mismo tiempo.
+- Cada Yacimiento tiene una sola Empresa operadora vigente.
+- La Empresa del Yacimiento se elige entre las Empresas vinculadas al Área.
+- Instalaciones y Subinstalaciones heredan el contexto de Empresa desde su Yacimiento.
+- Cambiar la Empresa de un Yacimiento no mueve ni recrea su Inventario físico.
+
+## 3. Datos simples
+
+Todos los registros usan una base común reducida:
+
+- Nombre.
+- Código, opcional y autogenerable.
+- Ubicación jerárquica.
+- Estado.
+- GPS cuando corresponda.
+- Observaciones sólo cuando aporten valor.
+
+Departamento, Área y Yacimiento no necesitan un constructor técnico complejo.
+
+Instalaciones y Subinstalaciones pueden tener campos específicos configurados por el Superadmin técnico.
+
+Los tipos de campo visibles para la puesta a punto deben mantenerse simples:
+
+- Texto.
+- Número.
+- Fecha.
+- Sí / No.
+
+Teléfono, email o identificadores simples pueden resolverse como Texto. GPS es un dato básico del registro, no un atributo técnico configurable.
+
+## 4. Administración de tipos
+
+Sólo el Superadmin técnico modifica la configuración.
+
+La pantalla administrativa debe permitir únicamente:
+
+1. Crear/ocultar Tipos de Instalación.
+2. Crear/ocultar Tipos de Subinstalación.
+3. Definir qué Tipos de Subinstalación puede contener cada Tipo de Instalación.
+4. Agregar, mostrar/ocultar y marcar como obligatorios los campos simples de cada tipo.
+
+Los términos técnicos internos como `inventory_families`, reglas de compatibilidad o schemas no deben exponerse al usuario.
+
+## 5. Cambio de tipo / función
+
+La identidad física del elemento no cambia cuando cambia su función.
+
+Ejemplo: `TK-57` sigue siendo `TK-57`, aunque hoy funcione como tanque de petróleo y mañana como tanque de agua.
+
+El cambio debe registrarse cronológicamente con:
+
+- tipo / función anterior;
+- tipo / función nueva;
+- fecha efectiva;
+- observación opcional.
+
+No se crea un Inventario nuevo para representar un cambio de función.
+
+## 6. Cronología útil
+
+Para Yacimiento, Instalación y Subinstalación la cronología debe concentrar sólo hechos operativos relevantes:
+
+- Hallazgos.
+- Acta asociada.
+- Empresa operadora correspondiente a la fecha.
+- Cambio de tipo / función.
+- Cambio de ubicación cuando corresponda.
+- Alta e inactivación.
+
+La experiencia normal no debe obligar a navegar por procedencia, snapshots, registros técnicos o paneles administrativos separados.
+
+## 7. Filosofía de la APK
+
+La APK existe para **inspeccionar, generar Acta y generar Informe**.
+
+El Inspector no administra Inventarios como tarea separada.
+
+La mayoría de las altas reales ocurren en campo mientras se registra un Hallazgo.
+
+Flujo:
+
+1. La Inspección se planifica desde WEB y ya conoce el Yacimiento.
+2. El Inspector abre la Inspección al llegar.
+3. Pulsa `+ Crear hallazgo`.
+4. Decide si el Hallazgo corresponde a Yacimiento, Instalación o Subinstalación.
+5. Si la Instalación no existe, puede crearla rápidamente sin abandonar el flujo.
+6. Si necesita una Subinstalación que no existe, puede crearla rápidamente dentro de la Instalación seleccionada.
+7. El catálogo ayuda, pero `OTRO` siempre está disponible.
+8. Con el tiempo, el Inventario se completa naturalmente y disminuye la necesidad de altas nuevas.
+
+## 8. Planificación y recorrido
+
+La planificación WEB define:
+
+- Área.
+- Empresa.
+- Yacimiento.
+- Inspector.
+- Fecha/hora.
+- Instalaciones/Subinstalaciones elegidas preventivamente.
+- pendientes por vencer, mostrados por elemento a controlar.
+- pendientes vencidos, mostrados por elemento a controlar.
+
+La APK presenta ese conjunto como recorrido sugerido. No es una ruta rígida: el Inspector puede registrar Hallazgos nuevos en cualquier momento.
+
+## 9. Actas e Informes
+
+- Abrir una Inspección no crea automáticamente un Acta.
+- El Inspector pulsa `+ Nueva Acta` cuando empieza a documentar.
+- El número definitivo del Acta se genera al cerrarla.
+- Una Inspección puede tener varias Actas.
+- Al cerrar un Acta se pueden agregar uno o más acompañantes con Nombre + Email.
+- El Acta se envía a Empresa, Inspector y acompañantes.
+- El Informe se genera automáticamente en Word y se envía únicamente al Inspector que realizó el Acta.
+- La firma o validación legal definitiva queda para una etapa posterior; la prioridad actual es la usabilidad.
+
+## 10. Regla de diseño
+
+Si una pantalla, campo o estado necesita explicación técnica para ser usado correctamente, debe simplificarse antes de incorporarse a la experiencia cotidiana.