# Arsenal Nexora V2 - Fase 7: Armory Experience

## Objetivo

Rediseñar `/shop/` como un Arsenal integrado en el ecosistema Nexora, sin modificar la transacción de compra, Warehouse, stock, saldo, tokens, encoder DbVersion 3, catálogo técnico ni opciones inteligentes.

## Cambios visuales

- Cabecera convertida en consola compacta con reino, estado operativo, entrega protegida y saldo.
- Navegación de categorías sticky con iconos simbólicos, conteos y taxonomía visual más coherente.
- Categorías genéricas como `Destacados` se resuelven visualmente por familia técnica (por ejemplo, Section 12 se muestra como Alas) sin reescribir el dato administrativo.
- Vistas locales `Catálogo`, `Selección` y `Ofertas`.
- Búsqueda con acceso rápido `/`.
- Ordenamiento 100% cliente por curaduría, precio, nombre e ID reciente.
- Zona `Selección del Arsenal` separada del grid, con `scroll-snap` y tratamiento cinematográfico para hasta tres destacados.
- El grid usa `auto-fit`; ya no reserva una tercera columna vacía cuando hay dos piezas.
- Cuando solo queda una card en el grid, adopta composición horizontal en desktop.
- Diferenciación automática entre render técnico (`image_file` vacío) y artwork promocional (`image_file` cargado en AdminCP).
- Perfil visual sutil según configuración: Base, Excellent, Ancient, Socket, Harmony o Especial.
- Chips compactos para +nivel, Skill, Luck, número de Excellent, Ancient, Harmony, sockets y 380.
- Estados de stock: disponibilidad abierta, stock y últimas unidades.
- Modal reconstruido como `Orden de adquisición`: imagen, configuración, reino, valor, saldo actual/posterior, destino y disponibilidad.

## Responsive

- Desktop: selección horizontal, navegación sticky y grid auto-fit.
- Tablet: cabecera simplificada y selección con scroll horizontal.
- Mobile <=640 px: categorías horizontales, controles compactos y cards horizontales específicas.
- Mobile <=430 px: las cards vuelven a composición vertical para conservar legibilidad.
- Se respeta `prefers-reduced-motion`; las transiciones y el scroll suave se neutralizan.

## Rendimiento

- Sin React/Vue.
- Sin carruseles o librerías de animación.
- Sin nuevos requests externos.
- Sin consultas SQL nuevas.
- Filtros y ordenamiento son locales sobre el catálogo ya cargado.
- CSS de Arsenal: ~34 KB sin comprimir / ~7.6 KB gzip.
- JavaScript de Arsenal: ~11 KB sin comprimir / ~2.8 KB gzip.
- Ambos assets siguen cargando solo en `/shop/`.

## Seguridad y regresión

- `class.itemshop.php` permanece idéntico byte por byte respecto a Fase 6.
- Por tanto `purchase()`, encoder 0-511, lectura del Warehouse, saldo, stock, serial y smart options no cambian.
- El token de intención de compra continúa siendo el mismo sistema de Fase 1+.
- El modal solo mejora presentación; el backend continúa siendo la autoridad.

## Archivos modificados

- `includes/plugins/itemshop/modules/catalog.php`
- `templates/nexoraves6custom/css/itemshop.css`
- `templates/nexoraves6custom/js/itemshop.js`
- `templates/nexoraves6custom/index.php` (cache-busting de assets)
- `plugin_itemshop_nexora.xml`

## Version

Arsenal Nexora Item Shop: `1.6.0`.
