@hed-hog/core 0.0.295 → 0.0.297

package/hedhog/data/setting_group.yaml

@@ -4,18 +4,18 @@
     en: General
     pt: Geral
   description:
-    en: General settings and configurations.
-    pt: Configurações e definições gerais.
+    en: General system settings and basic configurations
+    pt: Configurações gerais do sistema e configurações básicas
   relations:
     setting:
       - slug: url
         type: string
         name:
-          en: Base URL
-          pt: URL Base
+          en: System URL
+          pt: URL do Sistema
         description:
-          en: The base URL of the system
-          pt: A URL base do sistema
+          en: The public-facing base URL of the system for client requests and redirects
+          pt: A URL base acessível publicamente do sistema para requisições e redirecionamentos de clientes
         value: http://localhost:3200
         user_override: false
       - slug: api-url
@@ -24,19 +24,19 @@
           en: API URL
           pt: URL da API
         description:
-          en: The API URL of the system
-          pt: A URL da API do sistema
+          en: The endpoint URL where the API server is accessible
+          pt: A URL do endpoint onde o servidor da API está acessível
         value: http://localhost:3100
         user_override: false
       - slug: installed
         type: boolean
         component: switch
         name:
-          en: Installed
-          pt: Instalado
+          en: Installation Status
+          pt: Status de Instalação
         description:
-          en: Whether the system has already been installed
-          pt: Se o sistema ja foi instalado
+          en: Indicates whether the system has completed initial setup and installation procedures
+          pt: Indica se o sistema completou os procedimentos de instalação e configuração inicial
         value: false
         user_override: false
 - slug: maintenance
@@ -45,64 +45,62 @@
     en: Maintenance
     pt: Manutenção
   description:
-    en: Database maintenance and cleanup settings.
-    pt: Configurações de manutenção e limpeza do banco de dados.
+    en: Database maintenance, cleanup operations, and retention policies for long-term system health
+    pt: Manutenção do banco de dados, operações de limpeza e políticas de retenção para a saúde do sistema a longo prazo
   relations:
     setting:
       - slug: cleanup-batch-limit
         type: number
         component: input-number
         name:
-          en: Cleanup Batch Limit
-          pt: Limite de Lote de Limpeza
+          en: Batch Limit
+          pt: Limite de Lote
         description:
-          en: Maximum number of records to delete per cleanup task execution to avoid long table locks
-          pt: Número máximo de registros a deletar por execução de tarefa de limpeza para evitar locks prolongados da tabela
+          en: Maximum number of records to delete per cleanup task execution. Smaller values prevent long table locks but increase cleanup duration
+          pt: Número máximo de registros a deletar por execução de tarefa de limpeza. Valores menores evitam locks prolongados mas aumentam a duração da limpeza
         value: 20000
         user_override: false
+        subgroup_id:
+          where:
+            slug: database-cleanup
       - slug: session-retention-days
         type: number
         component: input-number
         name:
-          en: Session Retention Days
-          pt: Dias de Retenção de Sessão
+          en: Retention Period
+          pt: Período de Retenção
         description:
-          en: Number of days to retain expired sessions before permanent deletion for audit purposes
-          pt: Número de dias para reter sessões expiradas antes da exclusão permanente para fins de auditoria
+          en: Number of days to retain expired sessions before permanent deletion. Required for audit trails and compliance purposes
+          pt: Número de dias para reter sessões expiradas antes da exclusão permanente. Necessário para trilhas de auditoria e fins de conformidade
         value: 90
         user_override: false
+        subgroup_id:
+          where:
+            slug: session-retention
 - slug: authentication
   icon: lock-password
   name:
     en: Authentication
     pt: Autenticação
   description:
-    en: Configure the authentication settings.
-    pt: Configurar as definições de autenticação.
+    en: Configure authentication methods, security policies, and credentials for user access control
+    pt: Configure métodos de autenticação, políticas de segurança e credenciais para controle de acesso de usuários
   relations:
     setting:
       - slug: disable-authentication-with-email-and-password
         type: boolean
         component: switch
         name:
-          en: Disable Authentication with Email and Password
-          pt: Desabilitar Autenticação com Email e Senha
+          en: Disable Email/Password Auth
+          pt: Desabilitar Auth Email/Senha
         description:
-          en: Disable the authentication with email and password, allowing only OAuth and passwordless authentication methods
-          pt: Desabilitar a autenticação com email e senha, permitindo apenas métodos de autenticação OAuth e sem senha
-        value: false
-        user_override: false
-      - slug: require-mfa
-        type: boolean
-        component: switch
-        name:
-          en: Require MFA
-          pt: Exigir MFA
-        description:
-          en: Require all users to have at least one active MFA method
-          pt: Exigir que todos os usuários tenham pelo menos um método de MFA ativo
+          en: Prevent user authentication using email and password credentials, enforcing OAuth or passwordless authentication
+          pt: Impedir autenticação de usuários usando credenciais de email e senha, forçando autenticação OAuth ou sem senha
         value: false
         user_override: false
+        subgroup_id:
+          where:
+            slug: email-password-auth
       - slug: require-email-verification
         type: boolean
         component: switch
@@ -110,144 +108,208 @@
           en: Require Email Verification
           pt: Exigir Verificação de Email
         description:
-          en: Only allow user registration with verified email addresses
-          pt: Permitir apenas cadastros de usuários com endereços de email verificados
+          en: Require users to verify their email address before account activation and system access
+          pt: Exigir que os usuários verifiquem seus endereços de email antes da ativação da conta e acesso ao sistema
         value: false
         user_override: false
-      - slug: refresh-token-expiration-minutes
+        subgroup_id:
+          where:
+            slug: email-password-auth
+      - slug: password-min-length
         type: number
         component: input-number
         name:
-          en: Refresh Token Expiration Minutes
-          pt: Minutos de Expiração do Token de Atualização
+          en: Minimum Length
+          pt: Comprimento Mínimo
         description:
-          en: The number of minutes before a refresh token expires
-          pt: O número de minutos antes de um token de atualização expirar
-        value: 43200
+          en: Minimum number of characters required for passwords
+          pt: Número mínimo de caracteres obrigatórios para senhas
+        value: 6
         user_override: false
-      - slug: access-token-expiration-minutes
+        subgroup_id:
+          where:
+            slug: password-policy
+      - slug: password-min-uppercase
         type: number
         component: input-number
         name:
-          en: Access Token Expiration Minutes
-          pt: Minutos de Expiração do Token de Acesso
+          en: Uppercase Letters
+          pt: Letras Maiúsculas
         description:
-          en: The number of minutes before an access token expires
-          pt: O número de minutos antes de um token de acesso expirar
-        value: 15
+          en: Minimum number of uppercase letters (A-Z) required in passwords
+          pt: Número mínimo de letras maiúsculas (A-Z) obrigatórias em senhas
+        value: 0
         user_override: false
-      - slug: mfa-challenge-expiration-minutes
+        subgroup_id:
+          where:
+            slug: password-policy
+      - slug: password-min-numbers
         type: number
         component: input-number
         name:
-          en: MFA Challenge Expiration Minutes
-          pt: Minutos de Expiração do Desafio MFA
+          en: Numeric Digits
+          pt: Dígitos Numéricos
         description:
-          en: The number of minutes before a multifactor authentication challenge expires
-          pt: O número de minutos antes de um desafio de autenticação multifatorial expirar
-        value: 15
+          en: Minimum number of numeric digits (0-9) required in passwords
+          pt: Número mínimo de dígitos numéricos (0-9) obrigatórios em senhas
+        value: 0
+        user_override: false
+        subgroup_id:
+          where:
+            slug: password-policy
+      - slug: password-min-symbols
+        type: number
+        component: input-number
+        name:
+          en: Special Symbols
+          pt: Símbolos Especiais
+        description:
+          en: Minimum number of special characters (!@#$%^&*) required in passwords
+          pt: Número mínimo de caracteres especiais (!@#$%^&*) obrigatórios em senhas
+        value: 0
+        user_override: false
+        subgroup_id:
+          where:
+            slug: password-policy
+      - slug: email-host-whitelist
+        type: array
+        name:
+          en: Allowed Domains
+          pt: Domínios Permitidos
+        description:
+          en: List of email domain names allowed for registration. Leave empty to allow all domains
+          pt: Lista de nomes de domínios de email permitidos para registro. Deixe vazio para permitir todos os domínios
+        value: '[]'
+        user_override: false
+        component: input-tags
+        subgroup_id:
+          where:
+            slug: email-restrictions
+      - slug: email-host-blacklist
+        type: array
+        name:
+          en: Blocked Domains
+          pt: Domínios Bloqueados
+        description:
+          en: List of email domain names blocked from registration and login
+          pt: Lista de nomes de domínios de email bloqueados para registro e login
+        value: '[]'
         user_override: false
+        component: input-tags
+        subgroup_id:
+          where:
+            slug: email-restrictions
+      - slug: require-mfa
+        type: boolean
+        component: switch
+        name:
+          en: Require MFA
+          pt: Exigir MFA
+        description:
+          en: Enforce multi-factor authentication for all users to enhance security
+          pt: Forçar autenticação multifatorial para todos os usuários para aumentar a segurança
+        value: false
+        user_override: false
+        subgroup_id:
+          where:
+            slug: mfa-general
       - slug: mfa-issuer
         type: string
         name:
-          en: Issuer
-          pt: Emissor
+          en: Issuer Name
+          pt: Nome do Emissor
         description:
-          en: The issuer of the multifactor authentication
-          pt: O emissor da autenticação multifatorial
+          en: Application name displayed in authenticator apps (e.g., Google Authenticator, Authy)
+          pt: Nome do aplicativo exibido em aplicativos autenticadores (por exemplo, Google Authenticator, Authy)
         value: Hedhog
+        user_override: false
+        subgroup_id:
+          where:
+            slug: mfa-general
       - slug: mfa-window
         type: number
         component: input-number
         name:
-          en: Window
-          pt: Janela
+          en: Tolerance Window
+          pt: Janela de Tolerância
         description:
-          en: The window value defines the tolerance margin for multifactor authentication, allowing to verify tokens that are within a specific range of counters (HOTP) or time periods (TOTP), both before and after the expected value.
-          pt: O valor window define a margem de tolerância para autenticação multifatorial, permitindo verificar tokens que estão dentro de um intervalo específico de contadores (HOTP) ou períodos de tempo (TOTP), tanto antes quanto depois do valor esperado.
+          en: Number of time periods (30-second intervals) to accept as valid before/after the current token. Higher values increase security tolerance
+          pt: Número de períodos de tempo (intervalos de 30 segundos) para aceitar como válido antes/depois do token atual. Valores maiores aumentam a tolerância de segurança
         value: 1
+        user_override: false
+        subgroup_id:
+          where:
+            slug: mfa-totp
       - slug: mfa-setp
         type: number
         component: input-number
         name:
-          en: Step
-          pt: Passo
+          en: Time Step (seconds)
+          pt: Intervalo de Tempo (segundos)
         description:
-          en: The step in seconds that determines how long a code will be available in the user's app for multifactor authentication
-          pt: O passo em segundos que determina por quanto tempo um código ficará disponível no aplicativo do usuário para autenticação multifatorial
+          en: Duration in seconds each one-time password code remains valid. Standard is 30 seconds
+          pt: Duração em segundos que cada código de senha única permanece válido. O padrão é 30 segundos
         value: 30
-      - slug: password-min-length
+        user_override: false
+        subgroup_id:
+          where:
+            slug: mfa-totp
+      - slug: mfa-email-code-length
         type: number
         component: input-number
         name:
-          en: Password Minimum Length
-          pt: Comprimento Mínimo da Senha
+          en: Code Length
+          pt: Comprimento do Código
         description:
-          en: The minimum length required for user passwords
-          pt: O comprimento mínimo exigido para senhas de usuários
+          en: Number of digits for email-based MFA codes sent to user email
+          pt: Número de dígitos para códigos de MFA baseados em email enviados para o email do usuário
         value: 6
-      - slug: password-min-uppercase
-        type: number
-        component: input-number
-        name:
-          en: Password Minimum Uppercase Letters
-          pt: Mínimo de Letras Maiúsculas na Senha
-        description:
-          en: The minimum number of uppercase letters required for user passwords
-          pt: O número mínimo de letras maiúsculas exigidas para senhas de usuários
-        value: 0
-      - slug: password-min-numbers
+        user_override: false
+        subgroup_id:
+          where:
+            slug: mfa-email
+      - slug: mfa-challenge-expiration-minutes
         type: number
         component: input-number
         name:
-          en: Password Minimum Numbers
-          pt: Mínimo de Números na Senha
+          en: Challenge Expiration
+          pt: Expiração do Desafio
         description:
-          en: The minimum number of numeric digits required for user passwords
-          pt: O número mínimo de dígitos numéricos exigidos para senhas de usuários
-        value: 0
-      - slug: password-min-symbols
+          en: Minutes before an MFA challenge expires and becomes invalid
+          pt: Minutos antes de um desafio de MFA expirar e se tornar inválido
+        value: 15
+        user_override: false
+        subgroup_id:
+          where:
+            slug: mfa-general
+      - slug: access-token-expiration-minutes
         type: number
         component: input-number
         name:
-          en: Password Minimum Symbols
-          pt: Mínimo de Símbolos na Senha
+          en: Access Token Lifetime
+          pt: Duração do Token de Acesso
         description:
-          en: The minimum number of special symbols required for user passwords
-          pt: O número mínimo de símbolos especiais exigidos para senhas de usuários
-        value: 0
-      - slug: email-host-whitelist
-        type: array
-        name:
-          en: Email Host Whitelist
-          pt: Lista de Hosts de Email Permitidos
-        description:
-          en: The list of allowed email hosts for user registration and login
-          pt: A lista de hosts de email permitidos para registro e login de usuários
-        value: '[]'
-        user_override: false
-        component: input-tags
-      - slug: email-host-blacklist
-        type: array
-        name:
-          en: Email Host Blacklist
-          pt: Lista de Hosts de Email Bloqueados
-        description:
-          en: The list of blocked email hosts for user registration and login
-          pt: A lista de hosts de email bloqueados para registro e login de usuários
-        value: '[]'
+          en: Minutes before an access token expires. Shorter durations improve security but increase token refresh frequency
+          pt: Minutos antes de um token de acesso expirar. Durações mais curtas melhoram a segurança mas aumentam a frequência de atualização de tokens
+        value: 15
         user_override: false
-        component: input-tags
-      - slug: mfa-email-code-length
+        subgroup_id:
+          where:
+            slug: token-configuration
+      - slug: refresh-token-expiration-minutes
         type: number
         component: input-number
         name:
-          en: MFA Email Code Length
-          pt: Comprimento do Código de Email MFA
+          en: Refresh Token Lifetime
+          pt: Duração do Token de Atualização
         description:
-          en: The length of the multifactor authentication email code
-          pt: O comprimento do código de email de autenticação multifatorial
-        value: 6
+          en: Minutes before a refresh token expires. Used to obtain new access tokens without re-authentication
+          pt: Minutos antes de um token de atualização expirar. Usado para obter novos tokens de acesso sem re-autenticação
+        value: 43200
+        user_override: false
+        subgroup_id:
+          where:
+            slug: token-configuration
       - slug: max-concurrent-sessions
         type: number
         component: input-number
@@ -255,18 +317,21 @@
           en: Max Concurrent Sessions
           pt: Máximo de Sessões Simultâneas
         description:
-          en: Maximum number of active sessions per user. Set to 0 for unlimited sessions. When limit is reached, oldest sessions will be expired automatically.
-          pt: Número máximo de sessões ativas por usuário. Defina como 0 para sessões ilimitadas. Quando o limite for atingido, as sessões mais antigas serão expiradas automaticamente.
+          en: Maximum number of active sessions per user (0 = unlimited). Oldest sessions expire automatically when limit is reached
+          pt: Número máximo de sessões ativas por usuário (0 = ilimitado). As sessões mais antigas expiram automaticamente quando o limite é atingido
         value: 0
         user_override: false
+        subgroup_id:
+          where:
+            slug: session-management
 - slug: localization
   icon: world
   name:
     en: Localization
     pt: Localização
   description:
-    en: Configure the localization setting.
-    pt: Configurar as definições de localização.
+    en: Configure language, timezone, and date/time formatting globally or per-user preference
+    pt: Configure idioma, fuso horário e formatação de data/hora globalmente ou por preferência do usuário
   relations:
     setting:
       - slug: language
@@ -275,10 +340,8 @@
           en: Default Language
           pt: Idioma Padrão
         description:
-          en: The system default language, each user can have their own preferred language
-          pt:
-            O idioma padrão do sistema, cada usuário pode ter o seu próprio idioma
-            preferido
+          en: System default language for all users. Each user can override this with their own preference
+          pt: Idioma padrão do sistema para todos os usuários. Cada usuário pode substituir isso com sua própria preferência
         value: en
         user_override: true
         component: combobox
@@ -288,6 +351,9 @@
               order: 0
             - value: pt
               order: 1
+        subgroup_id:
+          where:
+            slug: regional-settings
       - slug: timezone
         type: string
         component: combobox
@@ -295,8 +361,8 @@
           en: Timezone
           pt: Fuso Horário
         description:
-          en: The timezone to use
-          pt: O fuso horário a utilizar
+          en: Default timezone for the system. Users can override this setting based on their location
+          pt: Fuso horário padrão para o sistema. Os usuários podem substituir essa configuração com base em sua localização
         value: UTC
         user_override: true
         relations:
@@ -317,6 +383,9 @@
               order: 6
             - value: Australia/Sydney
               order: 7
+        subgroup_id:
+          where:
+            slug: regional-settings
       - slug: time-format
         type: string
         component: combobox
@@ -324,8 +393,8 @@
           en: Time Format
           pt: Formato de Hora
         description:
-          en: How times will be displayed
-          pt: Como as horas serão exibidas
+          en: How times are displayed throughout the system (24-hour or 12-hour format)
+          pt: Como os horários são exibidos em todo o sistema (formato 24 horas ou 12 horas)
         value: HH:mm:ss
         user_override: true
         relations:
@@ -340,6 +409,9 @@
               order: 3
             - value: hh:mm
               order: 4
+        subgroup_id:
+          where:
+            slug: date-time-formats
       - slug: date-format
         type: string
         component: combobox
@@ -347,8 +419,8 @@
           en: Date Format
           pt: Formato de Data
         description:
-          en: How dates will be displayed
-          pt: Como as datas serão exibidas
+          en: How dates are displayed throughout the system
+          pt: Como as datas são exibidas em todo o sistema
         value: dd/MM/yyyy
         user_override: true
         relations:
@@ -359,24 +431,27 @@
               order: 1
             - value: yyyy-MM-dd
               order: 2
+        subgroup_id:
+          where:
+            slug: date-time-formats
 - slug: oauth
   icon: brand-auth0
   name:
     en: OAuth
     pt: OAuth
   description:
-    en: OAuth settings and configurations.
-    pt: Configurações e definições do OAuth.
+    en: Configure OAuth providers and authentication settings for third-party identity integration
+    pt: Configure provedores OAuth e configurações de autenticação para integração de identidade de terceiros
   relations:
     setting:
       - slug: providers
         type: array
         name:
-          en: Providers
-          pt: Provedores
+          en: Enabled Providers
+          pt: Provedores Habilitados
         description:
-          en: The OAuth providers accepted
-          pt: Os provedores de OAuth aceitos
+          en: List of OAuth providers available for user authentication
+          pt: Lista de provedores OAuth disponíveis para autenticação de usuários
         value: '[]'
         component: checkbox
         relations:
@@ -391,15 +466,18 @@
               order: 3
             - value: microsoft-entra-id
               order: 4
+        subgroup_id:
+          where:
+            slug: oauth-general
       - slug: oauth-role-assignment
         type: array
         component: checkbox
         name:
-          en: OAuth Role Assignment
-          pt: Atribuição de Função OAuth
+          en: Default Role
+          pt: Função Padrão
         description:
-          en: The role assigned to users who register via OAuth. If not set, the default role will be assigned.
-          pt: A função atribuída aos usuários que se registram via OAuth. Se não definido, a função padrão será atribuída.
+          en: Role automatically assigned to new users registering via OAuth providers. If not set, the system default role is used
+          pt: Função atribuída automaticamente a novos usuários registrados via provedores OAuth. Se não definido, a função padrão do sistema é usada
         value: ""
         user_override: false
         relations:
@@ -410,35 +488,44 @@
               order: 1
             - value: user
               order: 2
+        subgroup_id:
+          where:
+            slug: oauth-general
       - slug: microsoft_entra_id_client_id
         type: string
         name:
-          en: Microsoft Entra ID Client ID
-          pt: ID do Cliente Microsoft Entra ID
+          en: Client ID
+          pt: ID do Cliente
         description:
-          en: The client ID for Microsoft Entra ID OAuth
-          pt: O ID do cliente para o OAuth do Microsoft Entra ID
+          en: Azure/Microsoft Entra ID application client ID for OAuth authentication
+          pt: ID do cliente da aplicação Azure/Microsoft Entra ID para autenticação OAuth
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: microsoft-entra-id
       - slug: microsoft_entra_id_client_secret
         type: secret
         component: input-secret
         name:
-          en: Microsoft Entra ID Client Secret
-          pt: Segredo do Cliente Microsoft Entra ID
+          en: Client Secret
+          pt: Segredo do Cliente
         description:
-          en: The client secret for Microsoft Entra ID OAuth
-          pt: O segredo do cliente para o OAuth do Microsoft Entra ID
+          en: Microsoft Entra ID OAuth client secret credential
+          pt: Credencial de segredo do cliente OAuth do Microsoft Entra ID
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: microsoft-entra-id
       - slug: microsoft_entra_id_scopes
         type: array
         name:
-          en: Microsoft Entra ID Scopes
-          pt: Escopos do Microsoft Entra ID
+          en: OAuth Scopes
+          pt: Escopos OAuth
         description:
-          en: The scopes for Microsoft Entra ID OAuth
-          pt: Os escopos para o OAuth do Microsoft Entra ID
+          en: Permissions requested from the user during Microsoft Entra ID OAuth flow
+          pt: Permissões solicitadas ao usuário durante o fluxo OAuth do Microsoft Entra ID
         value: '["openid","profile","email","User.Read","offline_access"]'
         component: checkbox
         relations:
@@ -449,47 +536,60 @@
               order: 1
             - value: email
               order: 2
+        subgroup_id:
+          where:
+            slug: microsoft-entra-id
       - slug: microsoft_entra_id_tenant_id
         type: string
         name:
-          en: Microsoft Entra ID Tenant ID
-          pt: ID do Tenant Microsoft Entra ID
+          en: Tenant ID
+          pt: ID do Tenant
         description:
-          en: The Azure AD tenant ID for corporate Microsoft Entra ID (Azure AD) authentication. Leave empty to use common endpoint for personal Microsoft accounts.
-          pt: O ID do tenant do Azure AD para autenticação corporativa Microsoft Entra ID (Azure AD). Deixe vazio para usar o endpoint comum para contas pessoais da Microsoft.
+          en: Azure AD tenant ID for corporate Microsoft Entra ID authentication. Leave empty for personal Microsoft account endpoint
+          pt: ID do tenant do Azure AD para autenticação empresarial Microsoft Entra ID. Deixe vazio para o endpoint de conta pessoal da Microsoft
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: microsoft-entra-id
       - slug: google_client_id
         type: string
         name:
-          en: Google Client ID
-          pt: ID do Cliente Google
+          en: Client ID
+          pt: ID do Cliente
         description:
-          en: The client ID for Google OAuth
-          pt: O ID do cliente para o OAuth do Google
+          en: Google OAuth application client ID
+          pt: ID do cliente da aplicação OAuth do Google
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: google
       - slug: google_client_secret
         type: secret
         component: input-secret
         name:
-          en: Google Client Secret
-          pt: Segredo do Cliente Google
+          en: Client Secret
+          pt: Segredo do Cliente
         description:
-          en: The client secret for Google OAuth
-          pt: O segredo do cliente para o OAuth do Google
+          en: Google OAuth client secret credential
+          pt: Credencial de segredo do cliente OAuth do Google
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: google
       - slug: google_scopes
         type: array
         name:
-          en: Google Scopes
-          pt: Escopos do Google
+          en: OAuth Scopes
+          pt: Escopos OAuth
         description:
-          en: The scopes for Google OAuth
-          pt: Os escopos para o OAuth do Google
+          en: Permissions requested from the user during Google OAuth flow
+          pt: Permissões solicitadas ao usuário durante o fluxo OAuth do Google
         value: '["email","profile"]'
         component: checkbox
+        user_override: false
         relations:
           setting_list:
             - value: email
@@ -498,36 +598,44 @@
               order: 1
             - value: openid
               order: 2
-        user_override: false
+        subgroup_id:
+          where:
+            slug: google
       - slug: facebook_client_id
         type: string
         name:
-          en: Facebook Client ID
-          pt: ID do Cliente Facebook
+          en: Client ID
+          pt: ID do Cliente
         description:
-          en: The client ID for Facebook OAuth
-          pt: O ID do cliente para o OAuth do Facebook
+          en: Facebook OAuth application client ID
+          pt: ID do cliente da aplicação OAuth do Facebook
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: facebook
       - slug: facebook_client_secret
         type: secret
         component: input-secret
         name:
-          en: Facebook Client Secret
-          pt: Segredo do Cliente Facebook
+          en: Client Secret
+          pt: Segredo do Cliente
         description:
-          en: The client secret for Facebook OAuth
-          pt: O segredo do cliente para o OAuth do Facebook
+          en: Facebook OAuth client secret credential
+          pt: Credencial de segredo do cliente OAuth do Facebook
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: facebook
       - slug: facebook_scopes
         type: array
         name:
-          en: Facebook Scopes
-          pt: Escopos do Facebook
+          en: OAuth Scopes
+          pt: Escopos OAuth
         description:
-          en: The scopes for Facebook OAuth
-          pt: Os escopos para o OAuth do Facebook
+          en: Permissions requested from the user during Facebook OAuth flow
+          pt: Permissões solicitadas ao usuário durante o fluxo OAuth do Facebook
         value: '["id","emails","name","displayName","photos"]'
         user_override: false
         component: checkbox
@@ -543,35 +651,44 @@
               order: 3
             - value: photos
               order: 4
+        subgroup_id:
+          where:
+            slug: facebook
       - slug: microsoft_client_id
         type: string
         name:
-          en: Microsoft Client ID
-          pt: ID do Cliente Microsoft
+          en: Client ID
+          pt: ID do Cliente
         description:
-          en: The client ID for Microsoft OAuth
-          pt: O ID do cliente para o OAuth da Microsoft
+          en: Microsoft OAuth application client ID (Office/Personal)
+          pt: ID do cliente da aplicação OAuth da Microsoft (Office/Personal)
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: microsoft
       - slug: microsoft_client_secret
         type: secret
         component: input-secret
         name:
-          en: Microsoft Client Secret
-          pt: Segredo do Cliente Microsoft
+          en: Client Secret
+          pt: Segredo do Cliente
         description:
-          en: The client secret for Microsoft OAuth
-          pt: O segredo do cliente para o OAuth da Microsoft
+          en: Microsoft OAuth client secret credential
+          pt: Credencial de segredo do cliente OAuth da Microsoft
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: microsoft
       - slug: microsoft_scopes
         type: array
         name:
-          en: Microsoft Scopes
-          pt: Escopos da Microsoft
+          en: OAuth Scopes
+          pt: Escopos OAuth
         description:
-          en: The scopes for Microsoft OAuth
-          pt: Os escopos para o OAuth da Microsoft
+          en: Permissions requested from the user during Microsoft OAuth flow
+          pt: Permissões solicitadas ao usuário durante o fluxo OAuth da Microsoft
         value: '["openid","profile","email","User.Read","offline_access"]'
         component: checkbox
         relations:
@@ -586,46 +703,58 @@
               order: 3
             - value: offline_access
               order: 4
+        subgroup_id:
+          where:
+            slug: microsoft
         user_override: false
       - slug: microsoft_tenant_id
         type: string
         name:
-          en: Microsoft Tenant ID
-          pt: ID do Tenant Microsoft
+          en: Tenant ID
+          pt: ID do Tenant
         description:
-          en: The Azure AD tenant ID for corporate Microsoft Entra ID (Azure AD) authentication. Leave empty to use common endpoint for personal Microsoft accounts.
-          pt: O ID do tenant do Azure AD para autenticação corporativa Microsoft Entra ID (Azure AD). Deixe vazio para usar o endpoint comum para contas pessoais da Microsoft.
+          en: Azure AD tenant ID for corporate authentication (optional for personal accounts)
+          pt: ID do tenant do Azure AD para autenticação corporativa (opcional para contas pessoais)
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: microsoft
       - slug: github_client_id
         type: string
         name:
-          en: GitHub Client ID
-          pt: ID do Cliente GitHub
+          en: Client ID
+          pt: ID do Cliente
         description:
-          en: The client ID for GitHub OAuth
-          pt: O ID do cliente para o OAuth do GitHub
+          en: GitHub OAuth application client ID
+          pt: ID do cliente da aplicação OAuth do GitHub
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: github
       - slug: github_client_secret
         type: secret
         component: input-secret
         name:
-          en: GitHub Client Secret
-          pt: Segredo do Cliente GitHub
+          en: Client Secret
+          pt: Segredo do Cliente
         description:
-          en: The client secret for GitHub OAuth
-          pt: O segredo do cliente para o OAuth do GitHub
+          en: GitHub OAuth client secret credential
+          pt: Credencial de segredo do cliente OAuth do GitHub
         value: ""
         user_override: false
+        subgroup_id:
+          where:
+            slug: github
       - slug: github_scopes
         type: array
         name:
-          en: GitHub Scopes
-          pt: Escopos do GitHub
+          en: OAuth Scopes
+          pt: Escopos OAuth
         description:
-          en: The scopes for GitHub OAuth
-          pt: Os escopos para o OAuth do GitHub
+          en: Permissions requested from the user during GitHub OAuth flow
+          pt: Permissões solicitadas ao usuário durante o fluxo OAuth do GitHub
         value: '["read:user","user:email"]'
         component: checkbox
         relations:
@@ -633,7 +762,11 @@
             - value: read:user
               order: 0
             - value: user:email
+
               order: 1
+        subgroup_id:
+          where:
+            slug: github
         user_override: false
 - slug: appearance
   icon: palette
@@ -641,8 +774,8 @@
     en: Appearance
     pt: Aparência
   description:
-    en: Configure the appearance setting.
-    pt: Configurar as definições de aparência.
+    en: Customize visual appearance, themes, colors, branding, and UI layout for the entire system
+    pt: Customize aparência visual, temas, cores, marca e layout da UI para todo o sistema
   relations:
     setting:
       - slug: theme-mode
@@ -651,8 +784,8 @@
           en: Theme Mode
           pt: Modo de Tema
         description:
-          en: The theme mode to use
-          pt: O modo de tema a utilizar
+          en: Select between light, dark, or system-default theme mode
+          pt: Selecione entre modo de tema claro, escuro ou padrão do sistema
         value: system
         component: combobox
         user_override: true
@@ -663,15 +796,19 @@
             - value: dark
               order: 1
             - value: system
+
               order: 2
+        subgroup_id:
+          where:
+            slug: theme-selector
       - slug: theme-primary-light
         type: string
         name:
-          en: Primary Color (Light)
-          pt: Cor Primária (Claro)
+          en: Primary Color
+          pt: Cor Primária
         description:
-          en: The primary color for light theme
-          pt: A cor primária para o tema claro
+          en: Main brand color used for buttons, links, and highlights in light theme
+          pt: Cor de marca principal usada para botões, links e realces em tema claro
         value: "#ff760c"
         component: color-picker
         relations:
@@ -688,14 +825,17 @@
               order: 4
             - value: "#ff760c"
               order: 5
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-primary-foreground-light
         type: string
         name:
-          en: Primary Color Foreground (Light)
-          pt: Contraste da Cor Primária (Claro)
+          en: Primary Contrast
+          pt: Contraste Primário
         description:
-          en: The primary color foreground for light theme
-          pt: O contraste da cor primária para o tema claro
+          en: Text/foreground color for primary buttons and elements in light theme
+          pt: Cor de texto/foreground para botões primários e elementos em tema claro
         value: "#ffffff"
         component: color-picker
         relations:
@@ -706,14 +846,17 @@
               order: 1
             - value: "#f4f4f5"
               order: 2
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-secondary-light
         type: string
         name:
-          en: Secondary Color (Light)
-          pt: Cor Secundária (Claro)
+          en: Secondary Color
+          pt: Cor Secundária
         description:
-          en: The secondary color for light theme
-          pt: A cor secundária para o tema claro
+          en: Secondary accent color for less prominent UI elements in light theme
+          pt: Cor de acento secundária para elementos de UI menos proeminentes em tema claro
         value: "#f4f4f5"
         component: color-picker
         relations:
@@ -721,17 +864,21 @@
             - value: "#f4f4f5"
               order: 0
             - value: "#e4e4e7"
+
               order: 1
             - value: "#d4d4d8"
               order: 2
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-secondary-foreground-light
         type: string
         name:
-          en: Secondary Color Foreground (Light)
-          pt: Contraste da Cor Secundária (Claro)
+          en: Secondary Contrast
+          pt: Contraste Secundário
         description:
-          en: The secondary color foreground for light theme
-          pt: O contraste da cor secundária para o tema claro
+          en: Text/foreground color for secondary elements in light theme
+          pt: Cor de texto/foreground para elementos secundários em tema claro
         value: "#18181b"
         component: color-picker
         relations:
@@ -740,14 +887,17 @@
               order: 0
             - value: "#09090b"
               order: 1
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-accent-light
         type: string
         name:
-          en: Accent Color (Light)
-          pt: Cor de Realce (Claro)
+          en: Accent Color
+          pt: Cor de Acento
         description:
-          en: The accent color for light theme
-          pt: A cor de realce para o tema claro
+          en: Accent color for interactive elements and focus states in light theme
+          pt: Cor de acento para elementos interativos e estados de foco em tema claro
         value: "#f4f4f5"
         component: color-picker
         relations:
@@ -758,14 +908,17 @@
               order: 1
             - value: "#d4d4d8"
               order: 2
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-accent-foreground-light
         type: string
         name:
-          en: Accent Color Foreground (Light)
-          pt: Contraste da Cor de Realce (Claro)
+          en: Accent Contrast
+          pt: Contraste de Acento
         description:
-          en: The accent color foreground for light theme
-          pt: O contraste da cor de realce para o tema claro
+          en: Text/foreground color for accented elements in light theme
+          pt: Cor de texto/foreground para elementos com acento em tema claro
         value: "#18181b"
         component: color-picker
         relations:
@@ -774,14 +927,17 @@
               order: 0
             - value: "#09090b"
               order: 1
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-muted-light
         type: string
         name:
-          en: Muted Color (Light)
-          pt: Cor Suave (Claro)
+          en: Muted Color
+          pt: Cor Suave
         description:
-          en: The muted color for light theme
-          pt: A cor suave para o tema claro
+          en: Subtle background color for disabled or subtle UI elements in light theme
+          pt: Cor de fundo sutil para elementos de UI desabilitados ou sutis em tema claro
         value: "#f4f4f5"
         component: color-picker
         relations:
@@ -792,14 +948,17 @@
               order: 1
             - value: "#d4d4d8"
               order: 2
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-muted-foreground-light
         type: string
         name:
-          en: Muted Color Foreground (Light)
-          pt: Contraste da Cor Suave (Claro)
+          en: Muted Contrast
+          pt: Contraste Suave
         description:
-          en: The muted color foreground for light theme
-          pt: O contraste da cor suave para o tema claro
+          en: Text/foreground color for muted or disabled elements in light theme
+          pt: Cor de texto/foreground para elementos silenciosos ou desabilitados em tema claro
         value: "#71717a"
         component: color-picker
         relations:
@@ -809,71 +968,88 @@
             - value: "#52525b"
               order: 1
             - value: "#3f3f46"
+
               order: 2
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-background-light
         type: string
         name:
-          en: Background Color (Light)
-          pt: Cor de Fundo (Claro)
+          en: Page Background
+          pt: Fundo da Página
         description:
-          en: The background color for light theme
-          pt: A cor de fundo para o tema claro
+          en: Main background color for page content in light theme
+          pt: Cor de fundo principal para conteúdo da página em tema claro
         value: "#ffffff"
         component: color-picker
         relations:
           setting_list:
             - value: "#ffffff"
+
               order: 0
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-background-foreground-light
         type: string
         name:
-          en: Background Color Foreground (Light)
-          pt: Contraste da Cor de Fundo (Claro)
+          en: Page Text Color
+          pt: Cor do Texto da Página
         description:
-          en: The background color foreground for light theme
-          pt: O contraste da cor de fundo para o tema claro
+          en: Default text color for page content in light theme
+          pt: Cor de texto padrão para conteúdo da página em tema claro
         value: "#09090b"
         component: color-picker
         relations:
           setting_list:
-            - value: "#09090b"
-              order: 0
+              - value: "#09090b"
+                order: 0
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-card-light
         type: string
         name:
-          en: Card Color (Light)
-          pt: Cor do Card (Claro)
+          en: Card Background
+          pt: Fundo da Card
         description:
-          en: The card color for light theme
-          pt: A cor do card para o tema claro
+          en: Background color for cards and panels in light theme
+          pt: Cor de fundo para cards e painéis em tema claro
         value: "#ffffff"
         component: color-picker
         relations:
           setting_list:
-            - value: "#ffffff"
-              order: 0
+              - value: "#ffffff"
+                order: 0
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-card-foreground-light
         type: string
         name:
-          en: Card Color Foreground (Light)
-          pt: Contraste da Cor do Card (Claro)
+          en: Card Text Color
+          pt: Cor do Texto da Card
         description:
-          en: The card color foreground for light theme
-          pt: O contraste da cor do card para o tema claro
+          en: Text color for content within cards in light theme
+          pt: Cor do texto para conteúdo em cards em tema claro
         value: "#09090b"
         component: color-picker
         relations:
           setting_list:
             - value: "#09090b"
               order: 0
+        subgroup_id:
+          where:
+            slug: light-theme-colors
       - slug: theme-primary-dark
         type: string
         name:
-          en: Primary Color (Dark)
-          pt: Cor Primária (Escuro)
+          en: Primary Color
+          pt: Cor Primária
         description:
-          en: The primary color for dark theme
-          pt: A cor primária para o tema escuro
+          en: Main brand color used for buttons, links, and highlights in dark theme
+          pt: Cor de marca principal usada para botões, links e realces em tema escuro
         value: "#ff760c"
         component: color-picker
         relations:
@@ -890,14 +1066,17 @@
               order: 4
             - value: "#ff760c"
               order: 5
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-primary-foreground-dark
         type: string
         name:
-          en: Primary Color Foreground (Dark)
-          pt: Contraste da Cor Primária (Escuro)
+          en: Primary Contrast
+          pt: Contraste Primário
         description:
-          en: The primary color foreground for dark theme
-          pt: O contraste da cor primária para o tema escuro
+          en: Text/foreground color for primary buttons and elements in dark theme
+          pt: Cor de texto/foreground para botões primários e elementos em tema escuro
         value: "#ffffff"
         component: color-picker
         relations:
@@ -906,14 +1085,17 @@
               order: 0
             - value: "#fafafa"
               order: 1
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-secondary-dark
         type: string
         name:
-          en: Secondary Color (Dark)
-          pt: Cor Secundária (Escuro)
+          en: Secondary Color
+          pt: Cor Secundária
         description:
-          en: The secondary color for dark theme
-          pt: A cor secundária para o tema escuro
+          en: Secondary accent color for less prominent UI elements in dark theme
+          pt: Cor de acento secundária para elementos de UI menos proeminentes em tema escuro
         value: "#27272a"
         component: color-picker
         relations:
@@ -924,14 +1106,17 @@
               order: 1
             - value: "#52525b"
               order: 2
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-secondary-foreground-dark
         type: string
         name:
-          en: Secondary Color Foreground (Dark)
-          pt: Contraste da Cor Secundária (Escuro)
+          en: Secondary Contrast
+          pt: Contraste Secundário
         description:
-          en: The secondary color foreground for dark theme
-          pt: O contraste da cor secundária para o tema escuro
+          en: Text/foreground color for secondary elements in dark theme
+          pt: Cor de texto/foreground para elementos secundários em tema escuro
         value: "#fafafa"
         component: color-picker
         relations:
@@ -942,14 +1127,17 @@
               order: 1
             - value: "#e4e4e7"
               order: 2
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-accent-dark
         type: string
         name:
-          en: Accent Color (Dark)
-          pt: Cor de Realce (Escuro)
+          en: Accent Color
+          pt: Cor de Acento
         description:
-          en: The accent color for dark theme
-          pt: A cor de realce para o tema escuro
+          en: Accent color for interactive elements and focus states in dark theme
+          pt: Cor de acento para elementos interativos e estados de foco em tema escuro
         value: "#27272a"
         component: color-picker
         relations:
@@ -959,15 +1147,19 @@
             - value: "#3f3f46"
               order: 1
             - value: "#52525b"
+
               order: 2
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-accent-foreground-dark
         type: string
         name:
-          en: Accent Color Foreground (Dark)
-          pt: Contraste da Cor de Realce (Escuro)
+          en: Accent Contrast
+          pt: Contraste de Acento
         description:
-          en: The accent color foreground for dark theme
-          pt: O contraste da cor de realce para o tema escuro
+          en: Text/foreground color for accented elements in dark theme
+          pt: Cor de texto/foreground para elementos com acento em tema escuro
         value: "#fafafa"
         component: color-picker
         relations:
@@ -977,15 +1169,19 @@
             - value: "#f4f4f5"
               order: 1
             - value: "#e4e4e7"
+
               order: 2
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-muted-dark
         type: string
         name:
-          en: Muted Color (Dark)
-          pt: Cor Suave (Escuro)
+          en: Muted Color
+          pt: Cor Suave
         description:
-          en: The muted color for dark theme
-          pt: A cor suave para o tema escuro
+          en: Subtle background color for disabled or subtle UI elements in dark theme
+          pt: Cor de fundo sutil para elementos de UI desabilitados ou sutis em tema escuro
         value: "#27272a"
         component: color-picker
         relations:
@@ -996,14 +1192,17 @@
               order: 1
             - value: "#52525b"
               order: 2
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-muted-foreground-dark
         type: string
         name:
-          en: Muted Color Foreground (Dark)
-          pt: Contraste da Cor Suave (Escuro)
+          en: Muted Contrast
+          pt: Contraste Suave
         description:
-          en: The muted color foreground for dark theme
-          pt: O contraste da cor suave para o tema escuro
+          en: Text/foreground color for muted or disabled elements in dark theme
+          pt: Cor de texto/foreground para elementos silenciosos ou desabilitados em tema escuro
         value: "#a1a1aa"
         component: color-picker
         relations:
@@ -1014,144 +1213,183 @@
               order: 1
             - value: "#52525b"
               order: 2
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-background-dark
         type: string
         name:
-          en: Background Color (Dark)
-          pt: Cor de Fundo (Escuro)
+          en: Page Background
+          pt: Fundo da Página
         description:
-          en: The background color for dark theme
-          pt: A cor de fundo para o tema escuro
+          en: Main background color for page content in dark theme
+          pt: Cor de fundo principal para conteúdo da página em tema escuro
         value: "#09090b"
         component: color-picker
         relations:
           setting_list:
             - value: "#09090b"
               order: 0
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-background-foreground-dark
         type: string
         name:
-          en: Background Color Foreground (Dark)
-          pt: Contraste da Cor de Fundo (Escuro)
+          en: Page Text Color
+          pt: Cor do Texto da Página
         description:
-          en: The background color foreground for dark theme
-          pt: O contraste da cor de fundo para o tema escuro
+          en: Default text color for page content in dark theme
+          pt: Cor de texto padrão para conteúdo da página em tema escuro
         value: "#fafafa"
         component: color-picker
         relations:
           setting_list:
             - value: "#fafafa"
               order: 0
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-card-dark
         type: string
         name:
-          en: Card Color (Dark)
-          pt: Cor do Card (Escuro)
+          en: Card Background
+          pt: Fundo da Card
         description:
-          en: The card color for dark theme
-          pt: A cor do card para o tema escuro
+          en: Background color for cards and panels in dark theme
+          pt: Cor de fundo para cards e painéis em tema escuro
         value: "#09090b"
         component: color-picker
         relations:
           setting_list:
             - value: "#09090b"
               order: 0
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-card-foreground-dark
         type: string
         name:
-          en: Card Color Foreground (Dark)
-          pt: Contraste da Cor do Card (Escuro)
+          en: Card Text Color
+          pt: Cor do Texto da Card
         description:
-          en: The card color foreground for dark theme
-          pt: O contraste da cor do card para o tema escuro
+          en: Text color for content within cards in dark theme
+          pt: Cor do texto para conteúdo em cards em tema escuro
         value: "#fafafa"
         component: color-picker
         relations:
           setting_list:
             - value: "#fafafa"
               order: 0
+        subgroup_id:
+          where:
+            slug: dark-theme-colors
       - slug: theme-radius
         type: string
         name:
-          en: Radius
-          pt: Raio
+          en: Border Radius
+          pt: Raio da Borda
         description:
-          en: The radius to use
-          pt: O raio a utilizar
+          en: Global border radius value in rem units (affects corners of buttons, cards, etc.)
+          pt: Valor de raio de borda global em unidades rem (afeta cantos de botões, cards, etc.)
         value: "0.5"
+        subgroup_id:
+          where:
+            slug: theme-customization
       - slug: theme-font
         type: string
         name:
           en: Font Family
           pt: Família de Fontes
         description:
-          en: The font to use
-          pt: A fonte a utilizar
+          en: CSS font stack used throughout the system
+          pt: Stack de fontes CSS usado em todo o sistema
         value: ui-sans-serif, system-ui, sans-serif
+        subgroup_id:
+          where:
+            slug: theme-customization
       - slug: theme-text-size
         type: string
         name:
-          en: Text Size
-          pt: Tamanho do Texto
+          en: Base Text Size
+          pt: Tamanho de Texto Base
         description:
-          en: Text size of the application
-          pt: Tamanho do texto da aplicação
+          en: Scale factor for text sizes (1.0 = normal, >1.0 = larger, <1.0 = smaller)
+          pt: Fator de escala para tamanhos de texto (1.0 = normal, >1.0 = maior, <1.0 = menor)
         value: "1"
+        subgroup_id:
+          where:
+            slug: theme-customization
       - slug: menu-width
         type: string
         name:
-          en: Menu Width
-          pt: Largura do Menu
+          en: Sidebar Width
+          pt: Largura da Barra Lateral
         description:
-          en: Menu width of the application
-          pt: Largura do Menu da aplicação
+          en: Width of the left sidebar menu in rem units
+          pt: Largura do menu da barra lateral esquerda em unidades rem
         value: "18"
+        subgroup_id:
+          where:
+            slug: theme-customization
       - slug: image-url
         type: string
         component: input-file
         name:
-          en: System Image URL
-          pt: URL da Imagem do Sistema
+          en: Logo Image
+          pt: Imagem do Logo
         description:
-          en: System Image URL to use
-          pt: URL da Imagem do Sistema a utilizar
+          en: URL to the system logo/brand image (SVG or PNG recommended)
+          pt: URL para a imagem do logo/marca do sistema (SVG ou PNG recomendado)
         value: /logo.svg
+        subgroup_id:
+          where:
+            slug: branding
       - slug: icon-url
         type: string
         component: input-file
         name:
-          en: System Icon URL
-          pt: URL da Ícone do Sistema
+          en: Favicon
+          pt: Favicon
         description:
-          en: System Icon URL to use
-          pt: URL da Ícone do Sistema a utilizar
+          en: URL to the system favicon displayed in browser tabs
+          pt: URL para o favicon do sistema exibido nas abas do navegador
         value: /logo.svg
+        subgroup_id:
+          where:
+            slug: branding
       - slug: system-name
         type: string
         name:
           en: System Name
           pt: Nome do Sistema
         description:
-          en: System Name to use
-          pt: Nome do Sistema a utilizar
+          en: Display name of the system shown in headers and browser titles
+          pt: Nome de exibição do sistema mostrado em headers e títulos de navegador
         value: Hedhog
+        subgroup_id:
+          where:
+            slug: branding
       - slug: system-slogan
         type: string
         name:
-          en: System Slogan
-          pt: Slogan do Sistema
+          en: Tagline
+          pt: Slogan
         description:
-          en: System Slogan to use
-          pt: Slogan do Sistema a utilizar
+          en: Short tagline or subtitle displayed under the system name
+          pt: Slogan curto ou subtítulo exibido sob o nome do sistema
         value: Administration Panel
+        subgroup_id:
+          where:
+            slug: branding
 - slug: file-storage
   icon: folder
   name:
     en: File Storage
-    pt: Armazenamento
+    pt: Armazenamento de Arquivos
   description:
-    en: Configure the file storage setting.
-    pt: Configurar as definições de armazenamento de arquivos.
+    en: Configure file storage backend, accepted file types, and size limits for uploads
+    pt: Configure backend de armazenamento de arquivos, tipos de arquivo aceitos e limites de tamanho para uploads
   relations:
     setting:
       - slug: storage
@@ -1160,8 +1398,8 @@
           en: Storage Provider
           pt: Provedor de Armazenamento
         description:
-          en: The storage to use
-          pt: O armazenamento a utilizar
+          en: Select the backend service for file storage (local filesystem, AWS S3, Azure Blob, or Google Cloud)
+          pt: Selecione o serviço backend para armazenamento de arquivos (sistema de arquivos local, AWS S3, Azure Blob ou Google Cloud)
         value: local
         component: combobox
         relations:
@@ -1174,14 +1412,17 @@
               order: 2
             - value: gcs
               order: 3
+        subgroup_id:
+          where:
+            slug: storage-general
       - slug: storage-accept-mimetype
         type: array
         name:
-          en: Accept Mime Types
-          pt: Aceitar Tipos MIME
+          en: Allowed File Types
+          pt: Tipos de Arquivo Permitidos
         description:
-          en: The accepted mime types
-          pt: Os tipos MIME aceitos
+          en: MIME types accepted for file uploads (e.g., images, documents, videos)
+          pt: Tipos MIME aceitos para upload de arquivos (por exemplo, imagens, documentos, vídeos)
         value: '["application/pdf","image/jpeg","image/png","image/gif"]'
         component: checkbox
         relations:
@@ -1204,128 +1445,164 @@
               order: 7
             - value: text/plain
               order: 8
+        subgroup_id:
+          where:
+            slug: storage-general
       - slug: storage-max-size
         type: number
         name:
           en: Max File Size
           pt: Tamanho Máximo do Arquivo
         description:
-          en: The maximum file size in bytes
-          pt: O tamanho máximo do arquivo em bytes
+          en: Maximum file size in bytes (10485760 = 10 MB, 52428800 = 50 MB)
+          pt: Tamanho máximo do arquivo em bytes (10485760 = 10 MB, 52428800 = 50 MB)
         value: 10485760
+        subgroup_id:
+          where:
+            slug: storage-general
       - slug: storage-local-path
         type: string
         name:
-          en: Local Path
-          pt: Caminho Local
+          en: Local Directory
+          pt: Diretório Local
         description:
-          en: The local path to store file
-          pt: O caminho local para armazenar arquivos
+          en: Folder path on the server for local file storage. Must be writable by the application
+          pt: Caminho da pasta no servidor para armazenamento de arquivos local. Deve ser gravável pela aplicação
         value: storage
+        subgroup_id:
+          where:
+            slug: local-storage
       - slug: storage-s3-key
         type: string
         name:
-          en: S3 Key
-          pt: Chave S3
+          en: Access Key ID
+          pt: ID da Chave de Acesso
         description:
-          en: The S3 key
-          pt: A chave S3
+          en: AWS Access Key ID for S3 authentication
+          pt: ID da chave de acesso AWS para autenticação S3
         value: ''
+        subgroup_id:
+          where:
+            slug: s3-storage
       - slug: storage-s3-secret
         type: secret
         component: input-secret
         name:
-          en: S3 Secret
-          pt: Segredo S3
+          en: Secret Access Key
+          pt: Chave de Acesso Secreta
         description:
-          en: The S3 secret
-          pt: O segredo S3
+          en: AWS secret access key for S3 authentication
+          pt: Chave de acesso secreta AWS para autenticação S3
         value: ''
+        subgroup_id:
+          where:
+            slug: s3-storage
       - slug: storage-s3-region
         type: string
         name:
-          en: S3 Region
-          pt: Região S3
+          en: AWS Region
+          pt: Região AWS
         description:
-          en: The S3 region
-          pt: A região S3
+          en: AWS region where the S3 bucket is located
+          pt: Região AWS onde o bucket S3 está localizado
         value: 'us-east-1'
+        subgroup_id:
+          where:
+            slug: s3-storage
       - slug: storage-s3-bucket
         type: string
         name:
-          en: S3 Bucket
-          pt: Bucket S3
+          en: Bucket Name
+          pt: Nome do Bucket
         description:
-          en: The S3 bucket
-          pt: O bucket S3
+          en: S3 bucket name for storing uploaded files
+          pt: Nome do bucket S3 para armazenar arquivos enviados
         value: ''
+        subgroup_id:
+          where:
+            slug: s3-storage
       - slug: storage-abs-account
         type: string
         name:
-          en: ABS Account
-          pt: Conta ABS
+          en: Storage Account
+          pt: Conta de Armazenamento
         description:
-          en: The Azure Blob Storage account
-          pt: A conta de armazenamento de blob do Azure
+          en: Azure storage account name (without .blob.core.windows.net)
+          pt: Nome da conta de armazenamento do Azure (sem .blob.core.windows.net)
         value: ''
+        subgroup_id:
+          where:
+            slug: abs-storage
       - slug: storage-abs-key
         type: secret
         component: input-secret
         name:
-          en: ABS Key
-          pt: Chave ABS
+          en: Account Key
+          pt: Chave da Conta
         description:
-          en: The Azure Blob Storage key
-          pt: A chave de armazenamento de blob do Azure
+          en: Azure storage account access key for authentication
+          pt: Chave de acesso da conta de armazenamento do Azure para autenticação
         value: ''
+        subgroup_id:
+          where:
+            slug: abs-storage
       - slug: storage-abs-container
         type: string
         name:
-          en: ABS Container
-          pt: Container ABS
+          en: Container Name
+          pt: Nome do Contêiner
         description:
-          en: The Azure Blob Storage container
-          pt: O contêiner de armazenamento de blob do Azure
+          en: Azure Blob Storage container name for storing uploaded files
+          pt: Nome do contêiner de armazenamento de blob do Azure para armazenar arquivos enviados
         value: ''
+        subgroup_id:
+          where:
+            slug: abs-storage
       - slug: storage-gcs-keyfile
         type: secret
         component: input-secret
         name:
-          en: GCS Keyfile
-          pt: Arquivo de Chave GCS
+          en: Service Account Key
+          pt: Chave da Conta de Serviço
         description:
-          en: The Google Cloud Storage keyfile
-          pt: O arquivo de chave de armazenamento do Google Cloud
+          en: JSON keyfile contents for Google Cloud service account authentication
+          pt: Conteúdo do arquivo de chaves JSON para autenticação da conta de serviço do Google Cloud
         value: ''
+        subgroup_id:
+          where:
+            slug: gcs-storage
 - slug: 'mail'
   icon: mail
   name:
     en: Mail
     pt: Email
   description:
-    en: Configure the mail setting.
-    pt: Configurar as definições de email.
+    en: Configure email service provider, sender address, and credentials for system notifications
+    pt: Configure provedor de serviço de email, endereço do remetente e credenciais para notificações do sistema
   relations:
     setting:
       - slug: configured-mail
         type: boolean
         name:
-          en: Configured Mail
+          en: Email Configured
           pt: Email Configurado
         description:
-          en: Indicates if the mail is configured
-          pt: Indica se o email está configurado
+          en: Indicates whether email notifications are fully configured and operational
+          pt: Indica se as notificações de email estão totalmente configuradas e operacionais
         value: false
         user_override: false
         component: switch
+        subgroup_id:
+          where:
+            slug: mail-general
       - slug: mail-provider
         type: string
         name:
-          en: Mail Provider
+          en: Email Provider
           pt: Provedor de Email
         description:
-          en: The mail provider to use
-          pt: O provedor de email a utilizar
+          en: Email service provider to use for sending notifications
+          pt: Provedor de serviço de email a usar para enviar notificações
         value: SES
         component: combobox
         relations:
@@ -1335,139 +1612,347 @@
             - value: GMAIL
               order: 1
             - value: SES
+
               order: 2
+        subgroup_id:
+          where:
+            slug: mail-general
       - slug: mail-from
         type: string
         name:
-          en: Mail From
-          pt: Email de Remetente
+          en: Sender Address
+          pt: Endereço do Remetente
         description:
-          en: The mail from address
-          pt: O endereço de email do remetente
+          en: Email address used as the "From" field for outgoing system emails
+          pt: Endereço de email usado como campo "De" para emails de saída do sistema
         value: no-reply@hedhog.com
-      - slug: mail-gmail-client-id
-        type: string
-        name:
-          en: Gmail Client ID
-          pt: ID do Cliente Gmail
-        description:
-          en: The Gmail OAuth client ID
-          pt: O ID do cliente OAuth do Gmail
-        value: ''
-      - slug: mail-gmail-client-secret
-        type: secret
-        component: input-secret
-        name:
-          en: Gmail Client Secret
-          pt: Segredo do Cliente Gmail
-        description:
-          en: The Gmail OAuth client secret
-          pt: O segredo do cliente OAuth do Gmail
-        value: ''
-      - slug: mail-gmail-refresh-token
-        type: string
-        name:
-          en: Gmail Refresh Token
-          pt: Token de Atualização Gmail
-        description:
-          en: The Gmail OAuth refresh token
-          pt: O token de atualização OAuth do Gmail
-        value: ''
+        subgroup_id:
+          where:
+            slug: mail-general
       - slug: mail-smtp-host
         type: string
         name:
-          en: SMTP Host
-          pt: Host SMTP
+          en: SMTP Server
+          pt: Servidor SMTP
         description:
-          en: The SMTP server host
-          pt: O host do servidor SMTP
+          en: Hostname or IP address of the SMTP server
+          pt: Nome do host ou endereço IP do servidor SMTP
         value: ''
+        subgroup_id:
+          where:
+            slug: smtp-config
       - slug: mail-smtp-port
         type: number
         name:
           en: SMTP Port
           pt: Porta SMTP
         description:
-          en: The SMTP server port
-          pt: A porta do servidor SMTP
+          en: SMTP server port (typically 587 for TLS or 465 for SSL)
+          pt: Porta do servidor SMTP (geralmente 587 para TLS ou 465 para SSL)
         value: 587
+        subgroup_id:
+          where:
+            slug: smtp-config
       - slug: mail-smtp-secure
         type: boolean
         name:
-          en: SMTP Secure
-          pt: SMTP Seguro
+          en: Secure Connection
+          pt: Conexão Segura
         description:
-          en: Use secure connection for SMTP
-          pt: Usar conexão segura para SMTP
+          en: Use TLS/SSL encryption for SMTP connection
+          pt: Usar criptografia TLS/SSL para conexão SMTP
         value: false
+        subgroup_id:
+          where:
+            slug: smtp-config
       - slug: mail-client-secret
         type: secret
         component: input-secret
         name:
-          en: Mail Client Secret
-          pt: Segredo do Cliente de Email
+          en: SMTP Password
+          pt: Senha SMTP
+        description:
+          en: Authentication password for SMTP server
+          pt: Senha de autenticação do servidor SMTP
+        value: ''
+        subgroup_id:
+          where:
+            slug: smtp-config
+      - slug: mail-gmail-client-id
+        type: string
+        name:
+          en: Client ID
+          pt: ID do Cliente
         description:
-          en: The mail client secret
-          pt: O segredo do cliente de email
+          en: Google OAuth application client ID for Gmail API
+          pt: ID do cliente da aplicação Google OAuth para API do Gmail
         value: ''
+        subgroup_id:
+          where:
+            slug: gmail-config
+      - slug: mail-gmail-client-secret
+        type: secret
+        component: input-secret
+        name:
+          en: Client Secret
+          pt: Segredo do Cliente
+        description:
+          en: Google OAuth client secret for Gmail API authentication
+          pt: Segredo do cliente Google OAuth para autenticação da API do Gmail
+        value: ''
+        subgroup_id:
+          where:
+            slug: gmail-config
+      - slug: mail-gmail-refresh-token
+        type: string
+        name:
+          en: Refresh Token
+          pt: Token de Atualização
+        description:
+          en: OAuth refresh token for maintaining long-term access to Gmail API
+          pt: Token de atualização OAuth para manter acesso de longo prazo à API do Gmail
+        value: ''
+        subgroup_id:
+          where:
+            slug: gmail-config
       - slug: mail-aws-access-key-id
         type: string
         name:
           en: AWS Access Key ID
           pt: ID da Chave de Acesso AWS
         description:
-          en: The AWS access key ID for SES
-          pt: O ID da chave de acesso AWS para SES
+          en: AWS IAM access key for Amazon SES service
+          pt: Chave de acesso IAM da AWS para o serviço Amazon SES
         value: ''
+        subgroup_id:
+          where:
+            slug: ses-config
       - slug: mail-aws-secret-access-key
         type: secret
         component: input-secret
         name:
-          en: AWS Secret Access Key
-          pt: Chave de Acesso Secreta AWS
+          en: AWS Secret Key
+          pt: Chave Secreta AWS
         description:
-          en: The AWS secret access key for SES
-          pt: A chave de acesso secreta AWS para SES
+          en: AWS IAM secret key for Amazon SES authentication
+          pt: Chave secreta IAM da AWS para autenticação do Amazon SES
         value: ''
+        subgroup_id:
+          where:
+            slug: ses-config
       - slug: mail-aws-region
         type: string
         name:
           en: AWS Region
           pt: Região AWS
         description:
-          en: The AWS region for SES
-          pt: A região AWS para SES
+          en: AWS region where SES service is configured
+          pt: Região AWS onde o serviço SES está configurado
         value: 'us-east-1'
+        subgroup_id:
+          where:
+            slug: ses-config
 - slug: ai
   icon: brain
   name:
     en: Artificial Intelligence
     pt: Inteligência Artificial
   description:
-    en: Configure providers and credentials for AI integrations.
-    pt: Configure provedores e credenciais para integrações de IA.
+    en: Configure AI service providers and API credentials for intelligent system features
+    pt: Configure provedores de serviço de IA e credenciais de API para recursos inteligentes do sistema
   relations:
     setting:
       - slug: ai-openai-api-key
         type: secret
         component: input-secret
         name:
-          en: OpenAI API Key
-          pt: Chave de API OpenAI
+          en: API Key
+          pt: Chave de API
         description:
-          en: API key used to authenticate requests to OpenAI.
-          pt: Chave de API usada para autenticar requisições na OpenAI.
+          en: OpenAI API key for GPT models and other OpenAI services
+          pt: Chave de API OpenAI para modelos GPT e outros serviços OpenAI
         value: ''
         user_override: false
+        subgroup_id:
+          where:
+            slug: openai
       - slug: ai-gemini-api-key
         type: secret
         component: input-secret
         name:
-          en: Gemini API Key
-          pt: Chave de API Gemini
+          en: API Key
+          pt: Chave de API
         description:
-          en: API key used to authenticate requests to Google Gemini.
-          pt: Chave de API usada para autenticar requisições no Google Gemini.
+          en: Google AI API key for Gemini models and Google generative AI services
+          pt: Chave de API do Google AI para modelos Gemini e serviços de IA generativa do Google
         value: ''
         user_override: false
-   
+        subgroup_id:
+          where:
+            slug: gemini
+- slug: integration
+  icon: webhook
+  name:
+    en: Integration
+    pt: Integração
+  description:
+    en: Configure event-driven architecture with outbox pattern for reliable cross-module event processing
+    pt: Configure arquitetura orientada por eventos com padrão outbox para processamento confiável de eventos entre módulos
+  relations:
+    setting:
+      - slug: outbox-enabled
+        type: boolean
+        component: switch
+        name:
+          en: Outbox System
+          pt: Sistema de Caixa de Saída
+        description:
+          en: Enable the event outbox system for reliable event delivery across modules
+          pt: Habilitar o sistema de caixa de saída de eventos para entrega confiável de eventos entre módulos
+        value: true
+        user_override: false
+        subgroup_id:
+          where:
+            slug: outbox-general
+      - slug: outbox-processor-enabled
+        type: boolean
+        component: switch
+        name:
+          en: Background Processor
+          pt: Processador em Segundo Plano
+        description:
+          en: Enable the background job that processes and publishes pending events
+          pt: Habilitar o trabalho em segundo plano que processa e publica eventos pendentes
+        value: true
+        user_override: false
+        subgroup_id:
+          where:
+            slug: outbox-general
+      - slug: outbox-startup-drain-enabled
+        type: boolean
+        component: switch
+        name:
+          en: Startup Drain
+          pt: Drenagem na Inicialização
+        description:
+          en: Process all pending events immediately on application startup before accepting traffic
+          pt: Processar todos os eventos pendentes imediatamente na inicialização da aplicação antes de aceitar tráfego
+        value: true
+        user_override: false
+        subgroup_id:
+          where:
+            slug: startup-behavior
+      - slug: outbox-startup-drain-batch-size
+        type: number
+        component: input-number
+        name:
+          en: Batch Size
+          pt: Tamanho de Lote
+        description:
+          en: Number of events processed per iteration during startup drain
+          pt: Número de eventos processados por iteração durante a drenagem na inicialização
+        value: 50
+        user_override: false
+        subgroup_id:
+          where:
+            slug: startup-behavior
+      - slug: outbox-batch-size
+        type: number
+        component: input-number
+        name:
+          en: Batch Size
+          pt: Tamanho do Lote
+        description:
+          en: Number of events to process in each background processor iteration during normal operation
+          pt: Número de eventos a processar em cada iteração do processador em segundo plano durante operação normal
+        value: 10
+        user_override: false
+        subgroup_id:
+          where:
+            slug: processing-config
+      - slug: outbox-polling-interval-ms
+        type: number
+        component: input-number
+        name:
+          en: Active Poll Interval
+          pt: Intervalo de Sondagem Ativa
+        description:
+          en: Milliseconds between processor polls when events are pending. Lower values = faster processing but higher CPU
+          pt: Milissegundos entre sondagens quando eventos estão pendentes. Valores menores = processamento mais rápido mas maior CPU
+        value: 5000
+        user_override: false
+        subgroup_id:
+          where:
+            slug: processing-config
+      - slug: outbox-idle-polling-interval-ms
+        type: number
+        component: input-number
+        name:
+          en: Idle Poll Interval
+          pt: Intervalo de Sondagem Ociosa
+        description:
+          en: Milliseconds between processor polls when no events are waiting. Higher values = lower CPU usage during idle
+          pt: Milissegundos entre sondagens quando não há eventos esperando. Valores maiores = menor uso de CPU em ocioso
+        value: 30000
+        user_override: false
+        subgroup_id:
+          where:
+            slug: processing-config
+      - slug: outbox-processing-lease-ms
+        type: number
+        component: input-number
+        name:
+          en: Processing Lock Duration
+          pt: Duração do Lock de Processamento
+        description:
+          en: Milliseconds an event stays locked while being processed before becoming available for retry
+          pt: Milissegundos que um evento fica bloqueado durante o processamento antes de ficar disponível para reprocessamento
+        value: 30000
+        user_override: false
+        subgroup_id:
+          where:
+            slug: retry-config
+      - slug: outbox-max-attempts
+        type: number
+        component: input-number
+        name:
+          en: Max Retry Attempts
+          pt: Máximo de Tentativas de Reprocessamento
+        description:
+          en: Maximum number of times an event is retried before being moved to dead letter queue
+          pt: Número máximo de vezes que um evento é reprocessado antes de ser movido para fila de letra morta
+        value: 3
+        user_override: false
+        subgroup_id:
+          where:
+            slug: retry-config
+      - slug: outbox-retry-base-delay-ms
+        type: number
+        component: input-number
+        name:
+          en: Retry Base Delay
+          pt: Atraso Base de Reprocessamento
+        description:
+          en: Initial delay in milliseconds for exponential backoff. Increases by 2x with each retry attempt
+          pt: Atraso inicial em milissegundos para retirada exponencial. Aumenta 2x a cada tentativa de reprocessamento
+        value: 1000
+        user_override: false
+        subgroup_id:
+          where:
+            slug: retry-config
+      - slug: outbox-dead-letter-enabled
+        type: boolean
+        component: switch
+        name:
+          en: Dead Letter Queue
+          pt: Fila de Letra Morta
+        description:
+          en: Move permanently failed events to dead letter status for manual review and recovery
+          pt: Mover eventos com falha permanente para status de letra morta para revisão e recuperação manuais
+        value: true
+        user_override: false
+        subgroup_id:
+          where:
+            slug: retry-config
+
+