Manual do qbx_management

Menu de gerenciamento de empresas e gangues — sistema abrangente para gerenciamento de funcionários, promoções, contratações e demissões.

Funcionalidades Principais

Gerenciamento de Empresa

• Lista de Funcionários: Visualizar todos os funcionários atuais com status online/offline
• Contratar: Contratar novos funcionários entre jogadores próximos
• Demitir: Remover funcionários da organização
• Promover/Rebaixar: Alterar graus e cargos dos funcionários
• Menu do Chefe: Acesso rápido a todas as funções de gerenciamento

Gerenciamento de Gangue

• Funcionalidades idênticas ao gerenciamento de empresa
• Suporte completo para líderes de gangue
• Gerenciamento de membros e hierarquia

Sistema de Permissões

• Chefe: Pode contratar, demitir, promover e rebaixar
• Recrutador: Pode apenas contratar novos membros
• Permissões gerenciadas via mri_Qjobsystem

Interface

• UI moderna para gerenciamento
• Indicadores visuais: 🟢 online, ❌ offline
• Navegação intuitiva entre abas

Acesso

• Comando: /bossmenu (configurável)
• Zonas: Use ox_target ou text UI em locais configurados
• Atalhos: /+tablet:job e /+tablet:gang

Logging

• Registro de ações de contratação/demissão
• Webhook do Discord para auditoria
• Log de promoções e alterações de cargo

Comandos

Configuração

config/server.lua

config = {
    commandName = 'bossmenu',      -- Comando para abrir menu
    commandHelp = 'Open boss menu', -- Texto de ajuda
    discordWebhook = '',            -- URL do webhook Discord
    menus = {                       -- Zonas de menu do chefe
        {
            groupName = 'police',
            type = 'job',
            coords = vector3(440.84, -981.34, 30.69),
            size = vec3(2.0, 2.0, 2.0),
            rotation = 0.0
        },
        -- Adicione mais menus conforme necessário
    }
}

config/client.lua

config = {
    useTarget = true,       -- Usar ox_target (true) ou text UI (false)
    holdTablet = true,      -- Animação de tablet ao abrir menu
    debugPoly = false,      -- Mostrar polígonos de debug
}

Exports (API)

Client Exports

Server Exports

Estrutura do MenuInfo

---@class MenuInfo
---@field groupName string  # Nome do grupo (trabalho/gangue)
---@field type GroupType      # 'job' ou 'gang'
---@field coords vector3      # Coordenadas da zona
---@field size? vector3       # Tamanho da zona (padrão: vec3(1.5, 1.5, 1.5))
---@field rotation? number    # Rotação da zona (padrão: 0.0)

Callbacks do Servidor

Eventos

Client Events

Exemplos de Uso

Abrindo o Menu do Chefe

-- Via export
exports.qbx_management:OpenBossMenu('job')
exports.qbx_management:OpenBossMenu('gang')
 
-- Via evento
TriggerClientEvent('qbx_management:client:OpenBossMenu', source, 'job')

Adicionando Itens Personalizados

local menuId = exports.qbx_management:AddBossMenuItem({
    title = 'Ação Personalizada',
    description = 'Fazer algo personalizado',
    icon = 'wrench',
    args = {
        type = 'job' -- ou 'gang'
    },
    onSelect = function()
        -- Sua lógica aqui
    end
})

Registrando Zonas (Servidor)

exports.qbx_management:RegisterBossMenu({
    groupName = 'police',
    type = 'job',
    coords = vector3(440.84, -981.34, 30.69),
    size = vec3(2.0, 2.0, 2.0),
    rotation = 0.0
})

Estrutura de Arquivos

qbx_management/
├── client/
│   └── main.lua           # UI do menu, gerenciamento, zonas
├── server/
│   ├── main.lua           # Funcionários, contratação, logging
│   └── storage.lua         # Banco de dados
├── config/
│   ├── client.lua         # Config do client
│   └── server.lua         # Config do servidor
└── locales/               # Traduções

Dependências

Permissões

• Chefe: Acesso total ao menu, pode contratar, demitir, promover, rebaixar
• Recrutador: Pode apenas contratar novos funcionários
• Permissões definidas no mri_Qjobsystem

Solução de Problemas

Menu não abre

• Verifique se o jogador tem permissão de chefe/recrutador
• Confirme que o mri_Qjobsystem está rodando
• Verifique se o grupo existe em qbx_core

Zona não funciona

• Verifique a configuração em config/server.lua
• Confirme se useTarget está configurado corretamente
• Verifique se as coordenadas estão corretas

Funcionário não aparece na lista

• Recarregue o menu após contratação
• Verifique se o jogador está no banco de dados
• Confirme que o grupo foi atribuído corretamente

Webhook não envia logs

• Verifique se a URL do webhook está correta
• Confirme que o Discord aceita a conexão
• Verifique os logs do servidor para erros