# Business Details: documentación

> Un directorio de los negocios de la ciudad con estado de apertura en vivo, waypoints y reseñas.

- URL: https://xexstudio.com/es/docs/business-details
- Versión: 2.0.0
- Ficha del producto: https://xexstudio.com/es/scripts/business-details
Un directorio de los negocios de tu ciudad: cuáles están abiertos ahora mismo, dónde están, qué ofrecen y qué
opinan los jugadores de ellos. Los empleados abren y cierran su negocio desde la misma pantalla. ESX, QBCore y Qbox.

Gratuito y de código abierto.

## Requisitos

- [ox_lib](https://github.com/overextended/ox_lib)
- Un framework: **ESX**, **QBCore** o **Qbox**
- Opcional: [oxmysql](https://github.com/overextended/oxmysql) para las reseñas de jugadores (la tabla se crea en el primer arranque)

## Instalación

1. Copia `xex_businessdetails` en tu carpeta de recursos.
2. Añade a `server.cfg` después de tu framework, ox_lib y oxmysql:
   ```cfg
   ensure xex_businessdetails
   ```
3. Configura el idioma con `setr ox:locale en` (o `es`).
4. Opcional, para permitir que el staff elimine reseñas:
   ```cfg
   add_ace group.admin xex_businessdetails.staff allow
   ```
5. Edita `config.lua` con tus negocios y trabajos, y coloca tus imágenes en `ui/images/` (16:9, con 640×360 es suficiente).

Los jugadores abren el directorio con `/business` (configurable), una tecla opcional o una app del teléfono (ver más abajo).

## Configuración

Todo está en `config.lua`:

| Ajuste | Qué hace |
| --- | --- |
| `Config.Framework` | `auto`, o fuerza `esx` / `qb` / `qbox` |
| `Config.Command` / `Config.Keybind` | Cómo abren los jugadores el directorio |
| `Config.UI` | Nombre de marca, título y color de acento |
| `Config.Status` | Tiempo de espera antes de reabrir, distancia al negocio, requisito de estar de servicio, cierre automático cuando no hay personal conectado |
| `Config.Announce` | Notificación a todos los jugadores al abrir / cerrar, y un recordatorio periódico de lo que está abierto |
| `Config.Blips` | Blips del mapa, solo para negocios abiertos o siempre |
| `Config.Descriptions` | Permite a los empleados reescribir su descripción en el juego (se guarda entre reinicios) |
| `Config.Reviews` | Reseñas de jugadores: activadas / desactivadas, distancia, longitud del comentario |
| `Config.Categories` | Chips de filtro |
| `Config.Businesses` | Tus negocios: id, etiqueta, trabajo, rango mínimo, categoría, imagen, coordenadas, descripción |

`config_server.lua` contiene el webhook de Discord (aperturas, cierres, ediciones de descripción, reseñas). Nunca se envía a los jugadores.

Varios negocios pueden compartir un mismo trabajo. Mantén cada `id` único y no lo cambies una vez que los jugadores hayan dejado reseñas.

## Apps de teléfono

Abre el directorio desde cualquier app de teléfono con el export del cliente:

```lua
exports.xex_businessdetails:Open()
```

Ejemplo para lb-phone (`lb-phone/config/config.lua`, dentro de `Config.CustomApps`):

```lua
['businesses'] = {
    name = 'Businesses',
    description = 'What is open in the city right now',
    developer = 'XeX',
    defaultApp = true,
    icon = 'https://your-cdn/businesses.png', -- your own icon
    onUse = function()
        exports.xex_businessdetails:Open()
    end,
},
```

## Para desarrolladores

```lua
-- server
exports.xex_businessdetails:IsOpen('burgershot')        -- true / false
exports.xex_businessdetails:GetOpen()                   -- { 'burgershot', 'vanilla', ... }
exports.xex_businessdetails:SetOpen('burgershot', true) -- open or close from another resource (announced as usual)

AddEventHandler('xex_businessdetails:statusChanged', function(id, open, src) end)
```

Los clientes pueden leer `GlobalState.xex_businesses` (`{ [id] = openedAt }`) para el estado en vivo.

`bridge/server.lua` es abierto: adáptalo si usas un framework o sistema de trabajos personalizado.

## Seguridad

- Abrir, cerrar y editar se comprueba en el servidor: trabajo, rango, servicio, distancia y tiempo de espera.
- Las reseñas se validan en el servidor (estrellas, longitud, distancia, una por jugador y negocio, no se puede reseñar el propio
  negocio) y tienen límite de frecuencia.
- Todo texto escrito por los jugadores se muestra como texto plano en la UI, nunca como HTML.
