Cuxial License & Card system

## 🇪🇸 Cuxial License & ID System — Creador visual · Tienda · Emisión por trabajo · Captura de foto · Escáner policial

Sistema completo de documentos de identidad con NUI en **Svelte 5 + TypeScript**. Los administradores diseñan tarjetas desde un **creador visual (asistente de 5 pasos)** con previsualización en vivo y 4 orientaciones (horizontal, vertical, cuadrada y credencial tipo placa). Los ciudadanos compran carnets en una **tienda con preview real**, y los trabajos autorizados los **emiten por rango** capturando la foto del jugador con una **cámara orbital** sobre green-screen (recorte transparente + subida a Fivemanage). Incluye **escáner de ID policial**, **generador de ID falsa**, **animación de mostrar el documento con prop en mano**, y se integra automáticamente con **cuxial_police** para marcar ciudadanos en búsqueda y captura o peligrosos sobre la identificación. Multi-framework vía **cuxial_bridge**.

### ✨ Características principales

• **Creador visual de tarjetas** — asistente de 5 pasos (orientación, colores, logo, campos, restricciones) con **preview en vivo**.

• **4 orientaciones** — horizontal, vertical, cuadrada y credencial (cartera tipo placa policial).

• **NUI moderna en Svelte 5 + TypeScript** con estilo folder, escala a **1080p · 2K · 4K**.

• **Tienda de carnets (NUI)** con preview real de cada tarjeta, multi-selección, total y cobro.

• **Emisión por trabajo y rango (manager)** con captura de foto al jugador objetivo.

• **Captura de foto** — cámara orbital suave, **+60 expresiones faciales**, poses/animaciones, hora del día y green-screen → fondo transparente (subida a Fivemanage).

• **Escáner de ID policial** — jugadores cercanos o búsqueda por CID, lista de licencias con estado válida/expirada.

• **Generador de ID falsa** con campos, foto y logo personalizables.

• **Animación de mostrar documento** con prop en mano (tarjeta o placa) y tecla **E** para guardar.

• **Display de la ID** anclado en pantalla + mostrar a jugadores cercanos.

• **Integración con cuxial_police** (auto-detectada) — overlay de **Búsqueda y Captura / Peligroso** sobre la identificación.

• **Revocar y restaurar licencias** desde el panel de gestión.

• **Sin duplicados en BD** — re-emitir una licencia actualiza la fila existente (upsert por tarjeta + ciudadano).

• **4 items de ox_inventory** — `license_card`, `fake_id`, `job_badge` y `worker_id` con sus exports de uso.

• **Idiomas centralizados** — origen único en el Lua (en/es); el Lua envía los textos a la NUI en runtime.

• **Tema de acento configurable** + arquitectura modular (`server/modules` · `client/modules`) y build con carga diferida por sección.

• **Persistencia en DB** con tablas creadas automáticamente — sin importar `.sql` a mano.

### ⌨️ Comandos

| Comando | Función |

|---|---|

| `/license` | Abre el creador / gestión de tarjetas (admin) |

| `/jobissue` | Abre el panel de emisión por trabajo (trabajo autorizado) |

| `/checklicense [id]` | Abre el escáner con las licencias de un jugador (trabajo autorizado) |

| `exports openGetCard / openIdCheck / openFakeId / openJobManager` | Abren la tienda, el escáner, la ID falsa o el gestor desde otros recursos |

### 🔧 Compatibilidad y dependencias

• **Multi-framework:** QBox · ESX · QBCore (vía nuestro `cuxial_bridge` — mismo script en los 3 sin tocar código).

• **Dependencias:** `cuxial_bridge`, `ox_lib`, `oxmysql`, `ox_inventory`, `screencapture`, `cuxial_police` (opcional).

- Requiere registrar 4 items en `ox_inventory` (`license_card`, `fake_id`, `job_badge`, `worker_id`).

- Captura de foto vía `screencapture` + token de Fivemanage.

- Integración opcional con `cuxial_police` (overlay búsqueda y captura / peligroso, auto-detectada por `GetResourceState`).

### ⚡ Rendimiento

• **0.00ms** en idle (cliente y servidor).

• La NUI solo se activa al abrir un panel; tarjetas y locales cacheados; build con **code-splitting** (un chunk por sección).

### 🛡️ Extras

• Protegido por **Cfx.re Escrow**.

- `shared/config.lua` y `locales/` abiertos y editables.

• **Tabla SQL automática** — no importas nada a mano.

• **Soporte por tickets** en la web.

• **Actualizaciones incluidas.**