# Guía de desarrollo administrativo

## Estado actual

El importador vigente implementa análisis y vista previa de un lote temporal. Lee el formato maestro de nueve columnas, clasifica filas como `valida`, `requiere_revision` o `error`, permite filtrar sin volver a consultar ni modificar el catálogo y permite cancelar el lote.

La conexión administrativa está limitada a `jirehgo_compatibilidades_prueba`. Las respuestas técnicas no deben exponer credenciales ni errores completos. PhpSpreadsheet se carga mediante Composer.

## Próximas fases

1. Crear el nuevo lote temporal desde `Compatibilidades_madre_JIREHGO.xlsx`.
2. Completar herramientas administrativas para resolver cada fila pendiente.
3. Materializar marcas, modelos, técnicos, ficha reducida y referencias LKG.
4. Crear las tres asignaciones obligatorias por teléfono.
5. Asignar referencias JIREHGO y niveles solo mediante decisión administrativa.
6. Publicar compatibilidades oficiales únicamente después de confirmación.
7. Integrar inventario y precios en fases independientes.

## Criterios de aceptación

- Ningún teléfono se confirma automáticamente.
- No se generan alias.
- Referencia LKG y JIREHGO permanecen separadas.
- Un lote conserva datos originales, normalizados, mensajes y resolución.
- Las operaciones multi-tabla usan transacciones y consultas preparadas.
- Todo endpoint de escritura valida método, esquema activo, entrada y estado del lote.
- La aplicación pública continúa leyendo únicamente información oficial publicada.

## Archivos vigentes

El importador se compone de `public/admin/importador_catalogo.php`, sus recursos en `public/admin/assets/`, los endpoints de `admin/api/` y los servicios de `admin/includes/`. El esquema reconstruible es `database/ESQUEMA_OFICIAL_JIREHGO_PRUEBA.sql` y su comprobación de solo lectura es `database/PREVALIDACION_ESQUEMA_OFICIAL_PRUEBA.sql`.