Recursos da Empresa

Gate de funcionalidades por empresa. Admin libera/bloqueia individualmente quais módulos cada empresa pode usar — e o sistema esconde/exibe automaticamente.

Tela: /dashboard/plataforma/empresas (Recursos)

O que é

Cada recurso do sistema (Clientes, Produtos, Comandas, KDS, Caixa, NFS-e, etc) tem um código. A tabela empresa_recursos guarda quais recursos cada empresa tem habilitados.

Quando a empresa tem recursos_configurados = false (criação antiga), ela vê tudo. Quando passa a true, vê apenas o que está em empresa_recursos.

Como configurar

Em Plataforma › Empresas (/dashboard/plataforma/empresas), clique no botão de Recursos da empresa. O dialog mostra todos os recursos agrupados (Comandas, Fiscal, Comunicação, etc). Marque ou desmarque os recursos.

Algumas mudanças exigem reload da sessão pra refletir. Quem está logado pode precisar dar logout/login.

Pacotes de recursos

Pacotes são templates que liberam vários recursos de uma vez ao cadastrar empresa:

Cada um dos nove tipos de negócio tem o seu pacote. Nenhum ramo usa mais o pacote Completo como padrão.

Salão / Barbearia / Estética — agenda, profissionais, comissões e NFS-e, mais catálogo de produtos, estoque, pagamentos e caixa (para vender shampoo, pomada, cera)
Oficina / Borracharia / Lava-jato — ordem de serviço com agenda, catálogo de peças, estoque, caixa, comissões e emissão fiscal. Não traz cozinha nem comanda de mesa
Restaurante / Delivery / Lanchonete — comandas, cozinha (KDS), caixa e NFC-e
Loja / Comércio — produtos, estoque, caixa, comissões e NFC-e
Prestador de Serviço — agenda, pagamentos, caixa e NFS-e, sem catálogo de produtos
Saúde / Clínica / Consultório — consultórios, profissionais, agenda por profissional, pacote de sessões e NFS-e da consulta
Educação / Escola / Curso — salas, professores, agenda de aula, mensalidade recorrente e NFS-e
Hospedagem / Pousada / Hotel — hóspedes e quartos cadastrados, caixa e NFS-e. Sem comanda de restaurante nem fila de cozinha
Geral / Demais segmentos — para quem não se encaixa nos oito acima (pet shop, academia, marcenaria, ONG, igreja). Vende produto, serviço ou os dois, com caixa, agenda e nota. Sem cozinha, sem oficina e sem cadastro de espaço
Completo — libera tudo. Existe para o admin da plataforma montar empresa de teste, e não é o padrão de nenhum ramo

Ao criar uma empresa, escolhe-se um pacote (ou deixa derivar do tipo de negócio). O pacote é só o ponto de partida — depois admin pode ajustar livremente pelo modal de Recursos.

Saúde e Educação ganharam consultório, sala e profissional. Os dois ramos usavam o pacote de Prestador de Serviço, que não traz recursos-fisicos nemprofissionais — na prática a clínica não conseguia cadastrar o consultório nem o profissional que atende, e sem profissional cadastrado não existe agenda por profissional. Empresas de saúde e educação que já existiam receberam os três recursos automaticamente.

Salão, barbearia, oficina e borracharia passaram a receber caixa, produtos, estoque e pagamentos no pacote. Antes esses negócios ficavam sem controlar o dinheiro do dia nem vender produto — se a sua empresa já existia, os recursos foram liberados automaticamente. Abrir caixa continua sendo opcional: nada passa a ser obrigatório.

A tela também precisa fazer sentido para o ramo

Liberar o recurso não é suficiente para a entrada aparecer no menu: algumas telas são de um ramo só, e não aparecem fora dele nem para admin.

Abertas, Cozinha (KDS), Estações de produção, Telas da cozinha e Adicionais — só restaurante. A tela de abertas trabalha em número de comanda e mesa, e a de cozinha em fila por estação de produção
Veículos — só automotivo. A tela cadastra placa, marca e modelo, e amarra o histórico ao carro em vez de ao dono
Mesas / Quartos / Boxes / Cadeiras / Consultórios / Salas — só os seis ramos que têm nome próprio para o espaço. Loja, prestador de serviço e Geral não veem: ramo sem nome para o lugar não tem lugar para cadastrar

Isto vale inclusive para o admin da plataforma. Admin não passa pelo gate de recursos por empresa — ele precisa alcançar qualquer tela para dar suporte —, e por isso o menu dele mostrava toda tela em toda empresa: uma padaria aparecia com Veículos, uma marcenaria com Comandas e Cozinha. As duas travas respondem perguntas diferentes: o recurso diz "esta empresa contratou isto" e o ramo diz "isto existe neste tipo de negócio". A segunda ninguém contorna. As telas continuam alcançáveis pela URL, para o suporte não ficar sem saída.

A ordem do menu segue o fluxo de trabalho do ramo

Dentro de cada grupo, a ordem dos itens é a sequência em que o trabalho acontece naquele tipo de negócio — não uma ordem única para todos.

Oficina, borracharia e lava-jato — Orçamentos, Lista, Veículos, Boxes, Agenda. O cliente pergunta quanto custa antes de deixar o carro, então o orçamento é o primeiro passo. A agenda vem por último de propósito: oficina de bairro atende quem chega
Restaurante — Painel do dia, Abertas, Mesas, Cozinha, Lista. O gargalo é a mesa, e o garçom trabalha em cartão de comanda, não em tabela
Salão, barbearia, clínica e escola — Agenda primeiro: o dia delas já está vendido
Marcenaria, pet shop, academia — Orçamentos primeiro: ninguém encomenda um móvel sem preço
Loja — Venda e caixa; no catálogo, Produtos e Estoque logo em seguida
Pousada — Quartos, que é a unidade de tudo

No grupo Dinheiro a diferença é maior do que parece. Quem tem gaveta abre o Caixa — restaurante, loja, oficina, salão. Clínica e escola não têm gaveta: recebem por transferência, boleto e mensalidade, então o primeiro item delas é Recebido e Fiado. O prestador de serviço abre em Emitir nota avulsa, porque a nota é o que o cliente dele pede e o que costuma travar o serviço.

Reordenar não esconde nada. Todo item liberado continua no menu — o que não está na sequência do ramo aparece depois, na ordem padrão. Há teste que reprova se um item desaparecer: tela contratada e inalcançável é pior que ordem ruim, porque não há como o dono descobrir sozinho.

Recurso desativado no sistema

Um recurso pode ser desativado no sistema inteiro (recursos.ativo = false). Quando isso acontece, ele deixa de aparecer no menu e na lista do dialog de Recursos de qualquer empresa — mesmo nas que já o tinham liberado.

Tentar liberar um recurso desativado agora é recusado, e a mensagem diz qual recurso está inativo, pelo código e pelo nome. Antes a gravação era aceita em silêncio: o dialog respondia "salvo", o recurso não era salvo, e não havia erro em lugar nenhum para explicar o que aconteceu.

Empresa que já tinha o recurso antes de ele ser desativado

A liberação antiga continua registrada no banco, mas não vale para nada: menu, telas e API ignoram recurso inativo. Para reativá-la de verdade, reative o recurso no sistema. Para limpar o registro, basta abrir o dialog de Recursos da empresa e salvar — o salvar reescreve a lista e descarta o que sobrou.

Quanto tempo leva para valer

A verificação de recursos é guardada em memória por 60 segundos, para não consultar o banco em toda requisição. Ao salvar o dialog, essa memória é limpa na hora — o recurso liberado (ou bloqueado) passa a valer imediatamente.

Quando o sistema roda em mais de uma instância, o aviso de que os recursos mudaram é enviado às outras pelo RabbitMQ. Se o RabbitMQ estiver fora do ar ou não estiver configurado, nada falha: as demais instâncias levam até 60 segundos para perceber a mudança, que é o comportamento normal do cache.

Recurso 'Vincular WhatsApp'

Controla se o botão de vincular WhatsApp via QR Code aparece no cadastro de empresa. O campo de texto "WhatsApp Vinculado" continua visível, mas a vinculação automática só fica disponível quando o recurso está liberado.