Ação concluída com sucesso!
B2Sync.Permissoes
Fase 1: Flash UI Spec & IAM Multi-Sistema (Web & Delphi Legado)

IAM Central Multi-Sistema RBAC + Cache RSA-2048

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.

4
Sistemas Multi-Plataforma (Web & VCL)
RSA-2048
Assinatura Assimétrica RS256
4 Camadas
Anti-Tamper (RSA + Nonce + HW + Clock)
1 Único IAM
Vínculo Direto Firebird (legacyUserId)
01 Diagnóstico Clínico & Arquitetura Alvo

Legado vs. Nova Arquitetura B2Sync.Permissoes

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.

⚠️ Modelo Legado (Atual)

Vulnerável & Rígido
  • ❌
    Nível de Acesso Rígido: 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.
  • ❌
    Flags Globais de Leitura/Escrita: permite_leitura e permite_escrita booleanos no usuário. Não há distinção entre exportar relatórios, estornar caixas ou excluir registros.
  • ❌
    Tabs Frontend Apenas Ocultas: 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.
  • ❌
    Inexistência de Grupos/Roles: A cada novo colaborador ou mudança de filial, 20+ telas precisam ser configuradas manualmente para cada usuário, gerando erros operacionais e drift de segurança.

🛡️ Nova Arquitetura Híbrida (RBAC + Tri-State)

Zero-Trust & Flexível
  • ✅
    Perfis Reutilizáveis (Roles): Grupos como Gerente Comercial, Analista Financeiro, Estoquista e Operador de Fechamento com matriz base unificada.
  • ✅
    Tri-State Overrides por Usuário: O usuário herda o grupo por padrão, mas pode receber exceções cirúrgicas: HERDAR, PERMITIR (Allow) ou NEGAR (Deny) por item e ação.
  • ✅
    Matriz Granular de Ações: 6 dimensões por menu: VIEW, CREATE, UPDATE, DELETE, EXPORT e SPECIAL (autorizações/estornos).
  • ✅
    Precedência Matemática O(1): Avaliação estrita no backend: Explicit Deny do usuário sobrepõe permissão do grupo, garantindo bloqueio imediato com retrocompatibilidade para o frontend.
Pipeline de Precedência Matemática de Resolução em O(1)
resolveEffectivePermission(user, itemKey, action)
PASSO 1 SuperAdmin Check Se user.is_superadmin === true ou role === 'SUPERADMIN', concede ALLOW irrestrito de imediato.
PASSO 2 Explicit User Deny Se o usuário tem override individual registrado com efeito DENY para este item e ação, o acesso é IMEDIATAMENTE NEGADO.
PASSO 3 Explicit User Allow Se o usuário possui override individual com efeito ALLOW, o acesso é CONCEDIDO mesmo que o grupo não possua.
PASSO 4 Herança do Grupo Se em estado HERDAR, consulta a regra configurada no(s) grupo(s) vinculado(s) ao usuário. Se algum grupo conceder, ALLOW.
PASSO 5 Default Deny Zero-Trust: Se nenhuma regra concedeu acesso explicitamente, o resultado final é DENY (Acesso Bloqueado).
02 Protótipo Interativo Funcional

B2Sync.Permissoes Live Simulator

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.

Seletor de Sistema Alvo (Header HTTP: X-System-UID)
X-System-UID: 8f9d2a10-4c3b-4e1a-9f0c-123456789abc
🖥️ ERP SGE Retaguarda
Delphi VCL / Firebird

Retaguarda comercial corporativa. Conecta com Firebird local/rede e grava comissão no legado.

🛒 PDV Frente de Caixa
Delphi VCL (Offline-First)

Emissão fiscal em alta velocidade no checkout. Suporta queda total de internet via cache .b2perm.

⚡ B2Sync.Dashboard
Web SPA (Modern CSS)

Portal analítico em tempo real: Curva ABC, KPIs de venda, monitor de caixas e relatórios executivos.

📦 B2Sync.Fechamento
Mobile-First (Expedição)

Esteira de conferência por bipagem de código de barras, comprovantes térmicos 58/80mm e WhatsApp.

MS

Marta Silva IAM Central: Cadastro Único

Login: marta • Perfil Base: Gerente Comercial • Vínculo Legado Firebird: legacyUserId: 14 (VENDA.VENDEDOR)
Controle Dinâmico de Vínculos Ative ou Desative os Sistemas da Marta:
Módulo & Item de Menu VIEW (Ler) CREATE (Criar) UPDATE (Editar) DELETE (Excluir) EXPORT (Exportar) SPECIAL (Especial)
Payload Efetivo do Usuário / JWT (Live)

            
Calculando permissões... 100% compatível com allowed_tabs legado
Simulador de Rota Backend (Middleware Check)
checkPermission()

Simule uma requisição REST enviada por este usuário autenticado para verificar se o middleware autoriza ou bloqueia o acesso:

Veredito do Middleware:
Selecione uma rota para testar
PERMITIDO
Pipeline avaliado: Verificando hierarquia...
03 Blindagem Criptográfica Zero-Trust

Laboratório Anti-Manipulação (Cache Assinado RSA-2048 + Nonce)

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.

🔑 1. Assinatura Assimétrica RSA-2048 (RS256)

Criptografia Assimétrica

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.

⚡ 2. Challenge-Response Nonce (Anti-Replay)

Zero Replay Attack

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.

💻 3. Machine Hash & Senha Offline (PBKDF2)

Vínculo de Hardware

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.

⏰ 4. Anti-Rollback de Relógio via Firebird

Tolerância Máx 72h

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!

Testador Interativo de Ataques em Tempo Real (Simulador Delphi VCL)

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:

📄 Arquivo em Disco: C:\SGE\cache\marta.b2perm Status: Íntegro

          
Delphi VCL Security Engine (uB2PermissaoClient) ONLINE
Resultado da Avaliação Criptográfica:
200 OK — AUTENTICAÇÃO E CACHE ASSINADO VALIDADOS COM SUCESSO
A assinatura RSA-2048 bate com a Chave Pública, o GUID Nonce bate com a memória RAM e o Machine Hash confere com esta estação. Acesso ao ERP SGE autorizado!
LIBERADO
04 Cliente Oficial Delphi VCL / Firebird

Unit Delphi Oficial (uB2PermissaoClient.pas)

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.

📦 Arquivos Oficiais de Produção Prontos para Uso
Pacote completo com backend Node.js Express para cPanel + Unit Delphi uB2PermissaoClient.pas.
Baixar b2permissao-cpanel-dist.zip Baixar 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;
05 Engenharia de Dados & Persistência

Modelagem Relacional (MySQL / Sequelize)

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'] });
  }
};
06 Arquitetura de Serviços & Contratos REST

Contratos de API & Middleware RBAC Zero-Trust

Middleware express nativo com resolução de alta performance em cache local e garantia de retrocompatibilidade com allowed_tabs.

Novos Endpoints em B2Sync.Api (/api/v1/permissoes)

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

Implementação de Referência: checkPermission.middleware.js

/**
 * 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 };
05 Orquestração Técnica em 4 Pilares

Divisão de Engenharia Multi-Model Orchestrator

Como os 4 modelos cooperam sinergicamente na implementação e validação do B2Sync.Permissoes sem silos e sem débito técnico.

Gemini 4 Argon Fase 2: Arquitetura Core

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.

  • Desenvolve PermissionResolverService.js com cache TTL
  • Refatora middleware checkPermission.js
  • Escreve harness completo de testes com mock de banco
  • Garante que nenhuma rota REST fique desprotegida
Gemini 3.8 Flash Fase 1: Boilers & UI

Velocidade extrema na construção de boilerplate, protótipos interativos, controladores CRUD padrão e integração visual mobile-first.

  • Gera spec interativo e matriz live (este documento HTML)
  • Cria controllers REST de grupos e catálogo de menus
  • Implementa tela de edição permissoes.js no Dashboard
  • Gera seeds completas para MySQL com os 21 itens de menu
Claude Opus / Sonnet 5.5 Fase 3: Auditoria DevSecOps

Auditoria clínica e implacável contra falhas de segurança, IDOR, elevação horizontal/vertical de privilégios e anti-malandragem em testes.

  • Audita testes unitários contra falso-positivos (mocks frágeis)
  • Verifica se usuário consegue burlar Deny via IDOR
  • Avalia race conditions na invalidação de cache JWT
  • Valida compliance com o padrão OWASP Top 10 API Security
GPT-OSS 120B / Local Fase 4: Infra & Execução

Execução local in-situ, automação de comandos Linux/Windows, compilação de migrations e validação do sincronizador Firebird <-> MySQL.

  • Roda migrations do Sequelize em staging
  • Executa suite de testes Jest com telemetria
  • Dispara notificações no AGY Hub & AGY Bridge
  • Valida integridade com o banco de dados do cPanel