⚡ Gatilho Obrigatório

• TRIGGER: Acessar, modificar ou registrar dados nas superglobais centrais do Conn2Flow ($_GESTOR, $_CONFIG, $_BANCO, $_ENV).
• SKIP APENAS SE: Funções puras que recebem todos os parâmetros por argumento sem usar estado global.
• CONSEQUÊNCIA DE IGNORAR: Colisão de chaves no array global, corrupção da resposta AJAX ($_GESTOR['ajax-resposta']), ou desvio no fluxo de roteamento de páginas e módulos.

--- name: c2f-global-variables description: "Use ao consultar, acessar ou modificar as superglobais do Conn2Flow: $_GESTOR (runtime), $_CONFIG (configuracao central), $_BANCO (conexao DB) e $_ENV (ambiente)." user-invocable: false

Superglobais do Conn2Flow ($_GESTOR, $_CONFIG, $_BANCO, $_ENV)

Consulte e aplique as seguintes convenções ao acessar ou definir propriedades nas superglobais do Conn2Flow.

1. $_GESTOR — Estado Dinâmico do Runtime

Array associativo populado durante o bootstrap (gestor/config.php). Contém o estado volátil da requisição atual.

1.1. Roteamento e Módulo

• $_GESTOR['modulo-id']: Identificador do módulo em execução (ex: admin-paginas, produtos).
• $_GESTOR['opcao']: Ação ou subpercurso ativo (ex: adicionar, editar, listar, status).
• $_GESTOR['tipo']: Classificação secundária da rota (ex: banco, pagina, parametros).
• $_GESTOR['pagina']: String contendo o HTML processado da página que será entregue no layout.

1.2. Caminhos e Diretórios

• $_GESTOR['raiz']: URL base / domínio raiz da instalação com barra final (ex: https://meusite.com/).
• $_GESTOR['ROOT_PATH']: Caminho absoluto do sistema de arquivos para a raiz do servidor.
• $_GESTOR['modulos-path']: Caminho absoluto para a pasta de módulos.
• $_GESTOR['logs-path']: Caminho para gravação de arquivos de log.
• $_GESTOR['linguagem-codigo']: Código do idioma ativo (ex: pt-br, en).

1.3. Respostas AJAX e JSON

• $_GESTOR['ajax-json']: Array associativo retornado ao cliente em requisições AJAX (status => 'Ok', data => [...], erro => ...).
• $_GESTOR['ajax-opcao']: Identificador da ação AJAX recebida do frontend.
• $_GESTOR['json']: Flag booleana indicando se o resultado da requisição será entregue exclusivamente em formato JSON.

1.4. Estado do Usuário e Sessão

• $_GESTOR['usuario-id']: ID numérico do usuário autenticado na sessão atual.
• $_GESTOR['usuario-nome']: Nome exibido do usuário autenticado.

2. $_CONFIG — Configurações Centrais do Sistema

Array populado por gestor/config.php a partir de $_ENV e valores padrão. Contém configurações persistentes que NÃO mudam entre requisições.

• Sessões e Cookies: $_CONFIG['session_lifetime'], $_CONFIG['cookie_secure'], $_CONFIG['cookie_httponly']
• Segurança CSP/CORS: $_CONFIG['csp_policy'], $_CONFIG['cors_origins']
• OAuth e Autenticação: $_CONFIG['oauth_google_client_id'], $_CONFIG['oauth_google_secret']
• Email/SMTP: $_CONFIG['smtp_host'], $_CONFIG['smtp_port'], $_CONFIG['smtp_user'], $_CONFIG['smtp_pass']
• Pagamentos: $_CONFIG['paypal_client_id'], $_CONFIG['stripe_key']

3. $_BANCO — Configurações de Conexão com Banco de Dados

• $_BANCO['host']: Host do servidor MySQL.
• $_BANCO['nome']: Nome do banco de dados.
• $_BANCO['usuario']: Usuário de conexão.
• $_BANCO['senha']: Senha de conexão.
• $_BANCO['tipo']: Tipo de driver (mysql, pgsql).

4. $_ENV — Variáveis de Ambiente (Dotenv)

Carregadas automaticamente pelo Dotenv a partir de gestor/autenticacoes/<dominio>/.env.

[!IMPORTANT] Protocolo de Novas Variáveis de Ambiente: Toda nova chave sensível DEVE ser registrada no template gestor/autenticacoes.exemplo/dominio/.env para garantir mesclagem automática no deploy/update. Consulte a skill c2f-environment-configuration para o fluxo completo.