Governança unificada de identidades e permissões para todo o ecossistema B2Sync: suporte nativo ao ERP SGE Retaguarda (Delphi VCL / Firebird), PDV Frente de Caixa, B2Sync.Dashboard (Web SPA) e B2Sync.Fechamento (Esteira) com autenticação cruzada, overrides pontuais ($O(1)$) e Cache Offline Blindado (.b2perm) com criptografia assimétrica RSA-2048 e anti-rollback de relógio.
Por que a abordagem histórica de flag única limita operações multicompanhia e como a arquitetura híbrida resolve escala, segurança e flexibilidade operacional.
api_usuarios.nivel_acesso em inteiro/enum simples (ex: 1=Admin, 2=Operador), forçando concessões de privilégios excessivos para atender exceções operacionais.
permite_leitura e permite_escrita booleanos no usuário. Não há distinção entre exportar relatórios, estornar caixas ou excluir registros.
allowed_tabs é apenas um array de strings no JSON do usuário. Usuários com ferramentas de DevTools conseguiam efetuar chamadas a endpoints REST não blindados por rotas.
HERDAR, PERMITIR (Allow) ou NEGAR (Deny) por item e ação.
VIEW, CREATE, UPDATE, DELETE, EXPORT e SPECIAL (autorizações/estornos).
user.is_superadmin === true ou role === 'SUPERADMIN', concede ALLOW irrestrito de imediato.
HERDAR, consulta a regra configurada no(s) grupo(s) vinculado(s) ao usuário. Se algum grupo conceder, ALLOW.
Alterne entre gestão por Grupos/Perfis e Usuário Individual. Clique nas células para alternar estados e veja o payload JSON e a autorização de rotas reagirem em tempo real.
Retaguarda comercial corporativa. Conecta com Firebird local/rede e grava comissão no legado.
Emissão fiscal em alta velocidade no checkout. Suporta queda total de internet via cache .b2perm.
Portal analítico em tempo real: Curva ABC, KPIs de venda, monitor de caixas e relatórios executivos.
Esteira de conferência por bipagem de código de barras, comprovantes térmicos 58/80mm e WhatsApp.
marta • Perfil Base: Gerente Comercial •
Vínculo Legado Firebird: legacyUserId: 14 (VENDA.VENDEDOR)
VENDEDOR = 14 no Firebird
| Módulo & Item de Menu | VIEW (Ler) | CREATE (Criar) | UPDATE (Editar) | DELETE (Excluir) | EXPORT (Exportar) | SPECIAL (Especial) |
|---|
allowed_tabs legado
Simule uma requisição REST enviada por este usuário autenticado para verificar se o middleware autoriza ou bloqueia o acesso:
Como a Opção A impede matematicamente que operadores ou atacantes usem ferramentas como Fiddler/Burp Suite ou editem o arquivo local .b2perm no Bloco de Notas para forjar privilégios no Windows.
A Chave Privada reside exclusivamente no servidor seguro Linux (cPanel / API) e nunca sai de lá. A Chave Pública é compilada como constante dentro do binário .exe do Delphi. Qualquer alteração de um único byte no JSON (ex: de "excluir": false para true) corrompe o digest SHA-256 e a assinatura é imediatamente rejeitada pelo Delphi.
A cada inicialização ou request, o Delphi gera um GUID aleatório volátil na memória RAM (CreateGUID). A API embute esse GUID dentro do payload assinado pela chave privada. O Delphi confere: if Payload.Nonce <> MemoryNonce then Rejeitar(). Isso impede que alguém capture um arquivo ou pacote de um Gerente ou de ontem e tente reutilizá-lo hoje.
O cache .b2perm é carimbado e validado contra o Volume Serial do Drive C: e COMPUTERNAME. Se o operador copiar o arquivo para um pendrive e colá-lo no computador do Caixa, o Delphi recusa o arquivo por divergência de hardware. Para login sem internet, o validador offline usa derivação segura PBKDF2-SHA256.
O cache offline possui validade máxima de 72 horas. Se o operador atrasar a data e hora do Windows para burlar a expiração, o Delphi executa: SELECT MAX(DATAHORA) FROM VENDA no banco Firebird local. Se a data do Windows for anterior à data da última venda do Firebird, ativa bloqueio preventivo imediato!
Clique em cada cenário abaixo para simular tentativas de fraude e veja o motor criptográfico da unit uB2PermissaoClient.pas neutralizar o ataque em tempo real:
C:\SGE\cache\marta.b2perm
Status: Íntegro
Integração zero-trust para o ERP SGE Retaguarda e PDV Frente de Caixa: suporte a todas as versões do Delphi (7 até 12 Athens), verificação criptográfica sem dependências externas complexas e vínculo com VENDA.VENDEDOR no Firebird.
uB2PermissaoClient.pas.
unit uB2PermissaoClient;
{==============================================================================
B2Sync.Permissoes — Cliente Oficial Delphi VCL / Firebird Legado
Autor: Equipe de Arquitetura INBM2 / B2Sync
Compatibilidade: Delphi 7, 2010, XE até Delphi 12 Athens (32/64-bit)
Segurança: RSA-2048 (RS256) + Challenge-Response Nonce + Hardware Hash + Anti-Clock Rollback
==============================================================================}
interface
uses
Windows, SysUtils, Classes, IniFiles;
type
TB2AcaoPermissao = (acView, acCreate, acUpdate, acDelete, acExport, acSpecial);
TB2AuthStatus = (
asOnlineAutenticado,
asOfflineValido,
asFalhaAssinaturaRSA,
asFalhaNonceReplay,
asFalhaMachineMismatch,
asFalhaClockRollback,
asTokenExpirado,
asSistemaNaoVinculado,
asCredenciaisInvalidas
);
TB2PermissaoClient = class
private
FSystemUID: string;
FSystemName: string;
FApiBaseUrl: string;
FLocalCacheDir: string;
FPublicKeyPEM: string;
FUsuarioId: Integer;
FUsuarioLogin: string;
FLegacyUserId: Integer; // ID correspondente no Firebird (ex: VENDA.VENDEDOR)
FAuthStatus: TB2AuthStatus;
FIsOffline: Boolean;
function ObterMachineHash: string;
function GerarRequestNonce: string;
function ObterMaxDataHoraFirebird(const ASQLConnection: TObject): TDateTime;
function ValidarAssinaturaRSA(const APayloadJSON, AAssinaturaBase64: string): Boolean;
function CarregarCacheLocal(const ALogin, ASenhaDigitada: string): Boolean;
procedure SalvarCacheLocal(const APayloadJSON, AAssinaturaBase64: string; AOfflineVerifier: string);
public
constructor Create(const ASystemUID, ASystemName, AApiBaseUrl: string);
destructor Destroy; override;
function Autenticar(const ALogin, ASenha: string; ASQLConnection: TObject = nil): TB2AuthStatus;
function TemAcesso(const AChaveItem: string; const AAcao: TB2AcaoPermissao = acView): Boolean;
property SystemUID: string read FSystemUID;
property UsuarioLogin: string read FUsuarioLogin;
property LegacyUserId: Integer read FLegacyUserId;
property IsOffline: Boolean read FIsOffline;
end;
var
B2Permissao: TB2PermissaoClient;
// Funções Utilitárias Globais
function B2PodeVisualizar(const AChaveItem: string): Boolean;
function B2PodeCriar(const AChaveItem: string): Boolean;
function B2PodeEditar(const AChaveItem: string): Boolean;
function B2PodeExcluir(const AChaveItem: string): Boolean;
function B2PodeExportar(const AChaveItem: string): Boolean;
function B2PodeEspecial(const AChaveItem: string): Boolean;
// ============================================================================
// EXEMPLO PRÁTICO: FormVenda.pas no ERP SGE Retaguarda (Delphi VCL)
// Gravação de venda associada ao legado Firebird (VENDA.VENDEDOR = 14)
// ============================================================================
procedure TFormVenda.btnExcluirVendaClick(Sender: TObject);
begin
// 1. Verificação Zero-Trust O(1) com a Unit B2Permissao
if not B2PodeExcluir('vendas-tab') then
begin
MessageDlg(
Format('Acesso Negado: A usuária "%s" não possui permissão para excluir vendas no SGE.',
[B2Permissao.UsuarioLogin]),
mtWarning, [mbOK], 0
);
Exit;
end;
// 2. Se autorizado, executa exclusão auditada no Firebird
if MessageDlg('Confirma a exclusão deste pedido?', mtConfirmation, [mbYes, mbNo], 0) = mrYes then
begin
QryVenda.SQL.Text := 'DELETE FROM VENDA WHERE ID_VENDA = :ID';
QryVenda.ParamByName('ID').AsInteger := VendaAtualId;
QryVenda.ExecSQL;
ShowMessage('Venda excluída com sucesso.');
end;
end;
procedure TFormVenda.GravarNovaVenda;
begin
// Utiliza B2Permissao.LegacyUserId para identificar o vendedor no Firebird sem duplicar cadastro!
QryGravarVenda.SQL.Text :=
'INSERT INTO VENDA (DATAHORA, TOTAL, VENDEDOR) VALUES (:DATAHORA, :TOTAL, :VENDEDOR)';
QryGravarVenda.ParamByName('DATAHORA').AsDateTime := Now;
QryGravarVenda.ParamByName('TOTAL').AsCurrency := TotalPedido;
QryGravarVenda.ParamByName('VENDEDOR').AsInteger := B2Permissao.LegacyUserId; // ID 14 (Marta)
QryGravarVenda.ExecSQL;
end;
// ============================================================================
// EXEMPLO PRÁTICO: FormFrenteCaixa.pas no PDV Frente de Caixa (Delphi VCL)
// Tratamento de contingência offline e verificação de vínculo com o PDV
// ============================================================================
procedure TFormFrenteCaixa.RealizarLoginOperador(const ALogin, ASenha: string);
var
Status: TB2AuthStatus;
begin
// Passa conexão do Firebird para verificação anti-rollback de relógio
Status := B2Permissao.Autenticar(ALogin, ASenha, DMConexao.FBDriverConnection);
case Status of
asOnlineAutenticado:
AtualizarBarraStatus('🟢 Online (Sincronizado com IAM Central)');
asOfflineValido:
AtualizarBarraStatus('🟡 Contingência Offline (Cache Assinado RSA-2048 Válido)');
asSistemaNaoVinculado:
begin
// Exemplo da Marta no PDV: Sistema desmarcado no IAM Central (HTTP 403)
MessageDlg(
Format('Acesso Bloqueado: O operador "%s" não possui autorização para operar o PDV Frente de Caixa!',
[ALogin]),
mtError, [mbOK], 0
);
Halt(1); // Fecha o sistema preventivamente
end;
asFalhaAssinaturaRSA:
MessageDlg('🚨 ALERTA CRÍTICO: Arquivo de cache foi adulterado! Assinatura RSA inválida.', mtError, [mbOK], 0);
asFalhaClockRollback:
MessageDlg('🚨 BLOQUEIO DE RELÓGIO: Data do Windows é anterior à última venda no Firebird!', mtError, [mbOK], 0);
end;
end;
Normalização estruturada em 5 tabelas com índices compostos, integridade referencial com cascading restrito e auditoria nativa.
-- =========================================================================
-- B2Sync.Permissoes — DDL MySQL 8.0+ / MariaDB 10.5+
-- Modelagem Relacional RBAC Híbrida com Overrides Tri-State
-- =========================================================================
-- 1. Catálogo Mestre de Módulos e Menus do Sistema
CREATE TABLE IF NOT EXISTS `api_modulos_itens` (
`id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`modulo` VARCHAR(60) NOT NULL COMMENT 'Ex: B2Sync.Dashboard, B2Sync.Fechamento',
`grupo_menu` VARCHAR(60) NOT NULL COMMENT 'Ex: Operacional, Vendas, Fiscal',
`chave_item` VARCHAR(80) NOT NULL COMMENT 'Ex: caixas-tab, fechamento.esteira',
`titulo` VARCHAR(100) NOT NULL COMMENT 'Rótulo amigável no menu',
`icone` VARCHAR(50) DEFAULT 'cube' COMMENT 'Ícone Lucide/Heroicon',
`ordem` SMALLINT UNSIGNED DEFAULT 100,
`acoes_suportadas` JSON NOT NULL COMMENT '["VIEW","CREATE","UPDATE","DELETE","EXPORT","SPECIAL"]',
`ativo` TINYINT(1) DEFAULT 1,
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
UNIQUE KEY `uk_chave_item` (`chave_item`),
INDEX `idx_modulo_ordem` (`modulo`, `ordem`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 2. Perfis / Grupos Reutilizáveis de Permissão
CREATE TABLE IF NOT EXISTS `api_grupos_permissao` (
`id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`nome` VARCHAR(80) NOT NULL COMMENT 'Ex: Gerente Comercial',
`slug` VARCHAR(80) NOT NULL COMMENT 'Ex: gerente_comercial',
`descricao` VARCHAR(255) NULL,
`is_system` TINYINT(1) DEFAULT 0 COMMENT 'Se 1, não permite exclusão',
`ativo` TINYINT(1) DEFAULT 1,
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
UNIQUE KEY `uk_slug` (`slug`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 3. Regras de Privilégios por Grupo
CREATE TABLE IF NOT EXISTS `api_grupo_permissao_regras` (
`id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`grupo_id` INT UNSIGNED NOT NULL,
`chave_item` VARCHAR(80) NOT NULL,
`ler` TINYINT(1) DEFAULT 0 COMMENT 'VIEW',
`criar` TINYINT(1) DEFAULT 0 COMMENT 'CREATE',
`editar` TINYINT(1) DEFAULT 0 COMMENT 'UPDATE',
`excluir` TINYINT(1) DEFAULT 0 COMMENT 'DELETE',
`exportar` TINYINT(1) DEFAULT 0 COMMENT 'EXPORT',
`especial` TINYINT(1) DEFAULT 0 COMMENT 'SPECIAL',
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
UNIQUE KEY `uk_grupo_item` (`grupo_id`, `chave_item`),
CONSTRAINT `fk_regras_grupo` FOREIGN KEY (`grupo_id`) REFERENCES `api_grupos_permissao` (`id`) ON DELETE CASCADE,
CONSTRAINT `fk_regras_item` FOREIGN KEY (`chave_item`) REFERENCES `api_modulos_itens` (`chave_item`) ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 4. Associação de Usuários a Grupos
CREATE TABLE IF NOT EXISTS `api_usuario_grupos` (
`id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`usuario_id` INT UNSIGNED NOT NULL,
`grupo_id` INT UNSIGNED NOT NULL,
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
UNIQUE KEY `uk_usuario_grupo` (`usuario_id`, `grupo_id`),
CONSTRAINT `fk_ug_usuario` FOREIGN KEY (`usuario_id`) REFERENCES `api_usuarios` (`id`) ON DELETE CASCADE,
CONSTRAINT `fk_ug_grupo` FOREIGN KEY (`grupo_id`) REFERENCES `api_grupos_permissao` (`id`) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 5. Overrides Tri-State Granulares por Usuário
CREATE TABLE IF NOT EXISTS `api_usuario_permissao_overrides` (
`id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`usuario_id` INT UNSIGNED NOT NULL,
`chave_item` VARCHAR(80) NOT NULL,
`efeito` ENUM('ALLOW', 'DENY') NOT NULL,
`acao` ENUM('VIEW', 'CREATE', 'UPDATE', 'DELETE', 'EXPORT', 'SPECIAL') NOT NULL,
`motivo` VARCHAR(255) NULL COMMENT 'Auditoria de concessão/bloqueio',
`concedido_por` INT UNSIGNED NULL COMMENT 'ID do administrador responsável',
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
UNIQUE KEY `uk_usuario_item_acao` (`usuario_id`, `chave_item`, `acao`),
CONSTRAINT `fk_ovr_usuario` FOREIGN KEY (`usuario_id`) REFERENCES `api_usuarios` (`id`) ON DELETE CASCADE,
CONSTRAINT `fk_ovr_item` FOREIGN KEY (`chave_item`) REFERENCES `api_modulos_itens` (`chave_item`) ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
'use strict';
/** @type {import('sequelize-cli').Migration} */
module.exports = {
async up(queryInterface, Sequelize) {
const { DataTypes } = Sequelize;
// 1. Tabela api_modulos_itens
await queryInterface.createTable('api_modulos_itens', {
id: { type: DataTypes.INTEGER.UNSIGNED, autoIncrement: true, primaryKey: true },
modulo: { type: DataTypes.STRING(60), allowNull: false },
grupo_menu: { type: DataTypes.STRING(60), allowNull: false },
chave_item: { type: DataTypes.STRING(80), allowNull: false, unique: true },
titulo: { type: DataTypes.STRING(100), allowNull: false },
icone: { type: DataTypes.STRING(50), defaultValue: 'cube' },
ordem: { type: DataTypes.SMALLINT.UNSIGNED, defaultValue: 100 },
acoes_suportadas: { type: DataTypes.JSON, allowNull: false },
ativo: { type: DataTypes.BOOLEAN, defaultValue: true },
created_at: { type: DataTypes.DATE, allowNull: false, defaultValue: Sequelize.fn('NOW') },
updated_at: { type: DataTypes.DATE, allowNull: false, defaultValue: Sequelize.fn('NOW') }
});
// 2. Tabela api_grupos_permissao
await queryInterface.createTable('api_grupos_permissao', {
id: { type: DataTypes.INTEGER.UNSIGNED, autoIncrement: true, primaryKey: true },
nome: { type: DataTypes.STRING(80), allowNull: false },
slug: { type: DataTypes.STRING(80), allowNull: false, unique: true },
descricao: { type: DataTypes.STRING(255), allowNull: true },
is_system: { type: DataTypes.BOOLEAN, defaultValue: false },
ativo: { type: DataTypes.BOOLEAN, defaultValue: true },
created_at: { type: DataTypes.DATE, allowNull: false, defaultValue: Sequelize.fn('NOW') },
updated_at: { type: DataTypes.DATE, allowNull: false, defaultValue: Sequelize.fn('NOW') }
});
// 3. Tabela api_grupo_permissao_regras
await queryInterface.createTable('api_grupo_permissao_regras', {
id: { type: DataTypes.INTEGER.UNSIGNED, autoIncrement: true, primaryKey: true },
grupo_id: {
type: DataTypes.INTEGER.UNSIGNED,
allowNull: false,
references: { model: 'api_grupos_permissao', key: 'id' },
onDelete: 'CASCADE'
},
chave_item: {
type: DataTypes.STRING(80),
allowNull: false,
references: { model: 'api_modulos_itens', key: 'chave_item' },
onUpdate: 'CASCADE'
},
ler: { type: DataTypes.BOOLEAN, defaultValue: false },
criar: { type: DataTypes.BOOLEAN, defaultValue: false },
editar: { type: DataTypes.BOOLEAN, defaultValue: false },
excluir: { type: DataTypes.BOOLEAN, defaultValue: false },
exportar: { type: DataTypes.BOOLEAN, defaultValue: false },
especial: { type: DataTypes.BOOLEAN, defaultValue: false },
created_at: { type: DataTypes.DATE, allowNull: false, defaultValue: Sequelize.fn('NOW') },
updated_at: { type: DataTypes.DATE, allowNull: false, defaultValue: Sequelize.fn('NOW') }
});
await queryInterface.addIndex('api_grupo_permissao_regras', ['grupo_id', 'chave_item'], {
unique: true,
name: 'uk_grupo_item'
});
// 4. Campo modo_permissao em api_usuarios
await queryInterface.addColumn('api_usuarios', 'modo_permissao', {
type: DataTypes.ENUM('GRUPO', 'HIBRIDO', 'INDIVIDUAL'),
defaultValue: 'HIBRIDO',
after: 'nivel_acesso'
});
// 5. Tabela api_usuario_permissao_overrides
await queryInterface.createTable('api_usuario_permissao_overrides', {
id: { type: DataTypes.INTEGER.UNSIGNED, autoIncrement: true, primaryKey: true },
usuario_id: {
type: DataTypes.INTEGER.UNSIGNED,
allowNull: false,
references: { model: 'api_usuarios', key: 'id' },
onDelete: 'CASCADE'
},
chave_item: {
type: DataTypes.STRING(80),
allowNull: false,
references: { model: 'api_modulos_itens', key: 'chave_item' },
onUpdate: 'CASCADE'
},
efeito: { type: DataTypes.ENUM('ALLOW', 'DENY'), allowNull: false },
acao: { type: DataTypes.ENUM('VIEW', 'CREATE', 'UPDATE', 'DELETE', 'EXPORT', 'SPECIAL'), allowNull: false },
motivo: { type: DataTypes.STRING(255), allowNull: true },
concedido_por: { type: DataTypes.INTEGER.UNSIGNED, allowNull: true },
created_at: { type: DataTypes.DATE, allowNull: false, defaultValue: Sequelize.fn('NOW') },
updated_at: { type: DataTypes.DATE, allowNull: false, defaultValue: Sequelize.fn('NOW') }
});
await queryInterface.addIndex('api_usuario_permissao_overrides', ['usuario_id', 'chave_item', 'acao'], {
unique: true,
name: 'uk_usuario_item_acao'
});
},
async down(queryInterface) {
await queryInterface.dropTable('api_usuario_permissao_overrides');
await queryInterface.removeColumn('api_usuarios', 'modo_permissao');
await queryInterface.dropTable('api_grupo_permissao_regras');
await queryInterface.dropTable('api_usuario_grupos');
await queryInterface.dropTable('api_grupos_permissao');
await queryInterface.dropTable('api_modulos_itens');
}
};
'use strict';
/**
* Seeds do Catálogo Mestre dos 21 Itens de Menu B2Sync
*/
module.exports = {
async up(queryInterface) {
const defaultActions = JSON.stringify(["VIEW", "CREATE", "UPDATE", "DELETE", "EXPORT", "SPECIAL"]);
const readExportOnly = JSON.stringify(["VIEW", "EXPORT"]);
const catalog = [
// Módulo B2Sync.Dashboard
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Geral', chave_item: 'visao-geral-tab', titulo: 'Visão Geral & KPIs', icone: 'chart-pie', ordem: 10, acoes_suportadas: readExportOnly },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Geral', chave_item: 'relatorios-tab', titulo: 'Relatórios & Curva ABC', icone: 'trending-up', ordem: 20, acoes_suportadas: readExportOnly },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Comercial', chave_item: 'vendas-tab', titulo: 'Vendas & Pagamentos', icone: 'shopping-cart', ordem: 30, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Comercial', chave_item: 'vbs-tab', titulo: 'VBs / Pré-Vendas', icone: 'receipt', ordem: 40, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Financeiro', chave_item: 'caixas-tab', titulo: 'Caixas & Movimentações', icone: 'dollar-sign', ordem: 50, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Fiscal', chave_item: 'notasfiscais-tab', titulo: 'Notas Fiscais NF-e/NFC-e', icone: 'file-text', ordem: 60, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Estoque', chave_item: 'compras-tab', titulo: 'Compras de Entrada', icone: 'truck', ordem: 70, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Estoque', chave_item: 'requisicoes-tab', titulo: 'Requisições & Romaneios', icone: 'clipboard-list', ordem: 80, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Cadastros', chave_item: 'produtos-tab', titulo: 'Produtos & Preços', icone: 'tag', ordem: 90, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Cadastros', chave_item: 'empresas-tab', titulo: 'Empresas & Filiais', icone: 'building', ordem: 100, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Cadastros', chave_item: 'pessoas-tab', titulo: 'Pessoas (Clientes/Fornec)', icone: 'users', ordem: 110, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Cadastros', chave_item: 'grupos-tab', titulo: 'Grupos & Subgrupos', icone: 'folder-tree', ordem: 120, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Operações', chave_item: 'conftransf-tab', titulo: 'Transferências entre Lojas', icone: 'arrow-left-right', ordem: 130, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Sistema', chave_item: 'ruletab-tab', titulo: 'Configurações RuleTab', icone: 'sliders', ordem: 140, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Dashboard', grupo_menu: 'Sistema', chave_item: 'permissoes-tab', titulo: 'Usuários & Permissões', icone: 'shield-check', ordem: 150, acoes_suportadas: defaultActions },
// Módulo B2Sync.Fechamento
{ modulo: 'B2Sync.Fechamento', grupo_menu: 'Esteira', chave_item: 'fechamento.esteira', titulo: 'Esteira & Bipagem de Pedidos', icone: 'barcode', ordem: 210, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Fechamento', grupo_menu: 'Impressão', chave_item: 'fechamento.impressao', titulo: 'Comprovantes 58/80mm & Etiquetas', icone: 'printer', ordem: 220, acoes_suportadas: readExportOnly },
{ modulo: 'B2Sync.Fechamento', grupo_menu: 'Comunicação', chave_item: 'fechamento.whatsapp', titulo: 'Notificação WhatsApp Cliente', icone: 'message-circle', ordem: 230, acoes_suportadas: defaultActions },
{ modulo: 'B2Sync.Fechamento', grupo_menu: 'Auditoria', chave_item: 'fechamento.estorno', titulo: 'Reabertura & Estorno de Conferência', icone: 'refresh-ccw', ordem: 240, acoes_suportadas: defaultActions },
// Módulo B2Sync.Api & Sincronismo
{ modulo: 'B2Sync.Api', grupo_menu: 'Monitoramento', chave_item: 'sync.monitor', titulo: 'Monitor de Filas Firebird <-> MySQL', icone: 'activity', ordem: 310, acoes_suportadas: readExportOnly },
{ modulo: 'B2Sync.Api', grupo_menu: 'Segurança', chave_item: 'sync.auditoria', titulo: 'Logs & Auditoria de Acesso', icone: 'lock', ordem: 320, acoes_suportadas: readExportOnly }
];
const records = catalog.map(item => ({
...item,
created_at: new Date(),
updated_at: new Date()
}));
await queryInterface.bulkInsert('api_modulos_itens', records, { updateOnDuplicate: ['titulo', 'acoes_suportadas', 'ordem'] });
}
};
Middleware express nativo com resolução de alta performance em cache local e garantia de retrocompatibilidade com allowed_tabs.
| Método | Rota REST | Descrição / Função | Nível Mínimo |
|---|---|---|---|
GET |
/api/v1/permissoes/catalogo |
Lista todos os módulos e menus catalogados | Autenticado (Bearer) |
GET |
/api/v1/permissoes/grupos |
Lista grupos/perfis e regras de privilégios | Admin / Gerente |
POST |
/api/v1/permissoes/grupos |
Cria ou atualiza perfil e regras em lote | SuperAdmin |
GET |
/api/v1/permissoes/usuarios/:id/efetivas |
Calcula matriz resolvida e payload JWT | Usuário / Admin |
PUT |
/api/v1/permissoes/usuarios/:id/overrides |
Grava ou remove exceções tri-state do usuário | SuperAdmin |
/**
* B2Sync Middleware: checkPermission(chaveItem, acao)
* Avalia autorização em O(1) com suporte a SuperAdmin, Overrides e Herança de Grupo
*/
const { resolveUserEffectivePermissions } = require('../services/permissionResolver.service');
function checkPermission(chaveItem, acao = 'VIEW') {
return async (req, res, next) => {
try {
const user = req.user; // Injetado pelo verifyJwt middleware
if (!user) {
return res.status(401).json({ success: false, error: 'Não autenticado' });
}
// Regra 1: SuperAdmin possui passe livre irrestrito
if (user.is_superadmin === true || user.nivel_acesso === 'SUPERADMIN' || user.nivel_acesso === 1) {
return next();
}
// Obter permissões efetivas cacheadas na sessão / Redis
let permissions = req.session?.effectivePermissions;
if (!permissions) {
permissions = await resolveUserEffectivePermissions(user.id);
if (req.session) req.session.effectivePermissions = permissions;
}
const itemPerms = permissions[chaveItem];
// Verificação de permissão específica
const isAllowed = itemPerms && Boolean(itemPerms[acao.toLowerCase()]);
if (!isAllowed) {
// Log de Auditoria DevSecOps
console.warn(`[RBAC_DENIED] Usuário ${user.email} (ID: ${user.id}) tentou ${acao} em ${chaveItem}`);
return res.status(403).json({
success: false,
error: `Acesso negado: privilégio '${acao}' ausente para o módulo '${chaveItem}'.`,
code: 'PERMISSION_DENIED',
required: { item: chaveItem, action: acao }
});
}
return next();
} catch (err) {
console.error('[RBAC_ERROR] Falha na avaliação de permissão:', err);
return res.status(500).json({ success: false, error: 'Erro interno ao validar permissões' });
}
};
}
// Exemplo de aplicação em rotas do Express:
// router.get('/caixas', checkPermission('caixas-tab', 'VIEW'), CaixaController.listar);
// router.delete('/caixas/:id', checkPermission('caixas-tab', 'DELETE'), CaixaController.excluir);
// router.post('/fechamento/estorno', checkPermission('fechamento.estorno', 'SPECIAL'), FechamentoController.estornar);
module.exports = { checkPermission };
Como os 4 modelos cooperam sinergicamente na implementação e validação do B2Sync.Permissoes sem silos e sem débito técnico.
Motor de inteligência arquitetural profunda. Constrói os algoritmos de resolução de precedência em memória, otimização de consultas e refatoração de serviços centrais.
PermissionResolverService.js com cache TTLcheckPermission.jsVelocidade extrema na construção de boilerplate, protótipos interativos, controladores CRUD padrão e integração visual mobile-first.
permissoes.js no DashboardAuditoria clínica e implacável contra falhas de segurança, IDOR, elevação horizontal/vertical de privilégios e anti-malandragem em testes.
Execução local in-situ, automação de comandos Linux/Windows, compilação de migrations e validação do sincronizador Firebird <-> MySQL.