Pular para o conteúdo principal

Configuração de White Label

Assinatura Anual Necessária

A funcionalidade de White Label está disponível exclusivamente para usuários de Assinatura Anual. Entre em contato com nossa equipe de suporte via support@tikmatrix.com para obter seu código de desbloqueio após adquirir um plano anual.

O recurso de White Label permite que você personalize a marca do TikMatrix para corresponder à identidade da sua empresa. Você pode modificar o nome do aplicativo, logotipo e informações da marca para criar uma versão personalizada do TikMatrix.

Recursos​

Configurações Básicas​

  • App Name: Personalizar o nome de exibição do aplicativo
  • Logo Upload: Fazer upload do seu logotipo principal personalizado (recomendado 128x128px)
  • Favicon: Definir favicon personalizado para o aplicativo

Configurações de Marca​

  • Support Email: Endereço de email de suporte ao cliente
  • Tutorial URL: Link de tutorial/documentação personalizado
  • Telegram URL: Definir link do seu grupo ou canal Telegram

Alternadores de Recursos​

  • Show Tutorial Link: Controlar visibilidade do link do tutorial
  • Show Brand Info: Controlar exibição de informações da marca

Métodos de Configuração​

Método 1: Configuração via UI​

  1. Inicie o aplicativo TikMatrix
  2. Clique no ícone de paleta 🎨 na barra de título
  3. Configure os parâmetros no diálogo de Configurações de White Label:
    • App Name: Insira o nome do seu aplicativo personalizado
    • Main Logo: Faça upload do seu arquivo de logotipo (PNG/JPG, 128x128px recomendado)
    • Support Email: Insira seu endereço de email de suporte
    • Tutorial URL: Insira sua URL de tutorial personalizada
    • Telegram URL: Insira sua URL de grupo/canal Telegram
    • Feature Toggles: Habilite/desabilite links de tutorial e exibição de informações da marca
  4. Clique em "Save" para aplicar as configurações

Método 2: Arquivo de Configuração​

  1. Copie o arquivo de configuração de exemplo:

    cp examples/whitelabel-config.json src/config/whitelabel-custom.json

  2. Edite o arquivo de configuração:

    {
      "appName": "Your App Name",
      "logo": {
        "main": "/path/to/your/logo.webp",
        "favicon": "/path/to/your/favicon.ico"
      },
      "brand": {
        "supportEmail": "support@yourcompany.com",
        "tutorialUrl": "https://yourcompany.com/docs",
        "telegramUrl": "https://t.me/yourgroup"
      },
      "features": {
        "showTutorialLink": true,
        "showBrandInfo": true
      }
    }

  3. Salve o arquivo e reinicie o aplicativo

Método 3: Ferramenta de Linha de Comando​

  1. Navegue até o diretório do projeto:

    cd tikmatrix-desktop

  2. Execute a ferramenta de configuração:

    node scripts/whitelabel-config.js

  3. Siga as instruções para configurar cada parâmetro passo a passo

Construindo Versão Personalizada​

1. Preparar Arquivos de Recursos​

# Coloque seus arquivos de logotipo nos locais corretos
src/assets/your-logo.webp       # Logotipo principal
public/your-favicon.ico        # Favicon web
src-tauri/icons/               # Ícones do aplicativo (vários tamanhos)

2. Configurar Parâmetros de Build​

Use a ferramenta de linha de comando ou edite manualmente a configuração:

# Usando ferramenta de linha de comando
node scripts/whitelabel-config.js

# Ou editar manualmente
src/config/whitelabel-build.json

3. Construir Aplicativo​

# Modo de desenvolvimento
npm run dev

# Build de produção
npm run build

# Construir aplicativo Tauri
npm run tauri build

Prioridade de Configuração​

O sistema usa a seguinte ordem de prioridade para configuração:

  1. Runtime Config: Browser LocalStorage whitelabel_config
  2. Build Config: src/config/whitelabel-build.json (usado durante o build)
  3. Example Config: examples/whitelabel-config.json
  4. Default Config: Valores padrão integrados

Requisitos de Logotipo​

Logotipo Principal​

  • Formato: PNG, JPG ou SVG
  • Tamanho: 128x128px (recomendado)
  • Fundo: Transparente (para PNG)
  • Uso: Cabeçalho, tela de splash, diálogo sobre

Favicon​

  • Formato: ICO ou PNG
  • Tamanho: 32x32px ou 16x16px
  • Uso: Aba do navegador, ícone da janela

Ícones do Aplicativo (para builds)​

  • Formatos: PNG, ICO, ICNS
  • Tamanhos: 32x32, 128x128, 256x256, 512x512
  • Localização: Diretório src-tauri/icons/

Integração de API​

API JavaScript​

import { 
  getWhiteLabelConfig,
  saveWhiteLabelConfig, 
  resetWhiteLabelConfig,
  validateWhiteLabelConfig 
} from './config/whitelabel.js';

// Obter configuração atual
const config = getWhiteLabelConfig();

// Salvar nova configuração
saveWhiteLabelConfig(newConfig);

// Redefinir para padrões
resetWhiteLabelConfig();

// Validar configuração
validateWhiteLabelConfig(config);

Funções Utilitárias​

import { 
  initWhiteLabel,
  updateDocumentTitle,
  updateFavicon
} from './utils/whitelabel.js';

// Inicializar white label ao iniciar o aplicativo
initWhiteLabel();

// Atualizar título do documento
updateDocumentTitle('Your App Name');

// Atualizar favicon
updateFavicon('/path/to/favicon.ico');

Melhores Práticas​

Design de Logotipo​

  • Use imagens de alta resolução para exibição nítida
  • Mantenha a marca consistente em todos os tamanhos de logotipo
  • Teste logotipos em fundos claros e escuros
  • Certifique-se de que os logotipos sejam legíveis em tamanhos pequenos

Consistência de Marca​

  • Use cores e fontes consistentes por todo o aplicativo
  • Alinhe com suas diretrizes de marca existentes
  • Teste a interface personalizada em diferentes tamanhos de tela
  • Mantenha aparência profissional

Configuração de URL​

  • Use URLs HTTPS para todos os links externos
  • Teste todos os links antes da implantação
  • Certifique-se de que os canais de suporte sejam monitorados adequadamente
  • Mantenha URLs de documentação atualizadas

Solução de Problemas​

Problemas Comuns​

Logotipo não está sendo exibido:

  • Verifique o caminho do arquivo e permissões
  • Verifique se o formato da imagem é suportado
  • Certifique-se de que o tamanho da imagem seja apropriado
  • Limpe o cache do navegador e reinicie o aplicativo

Configuração não está sendo salva:

  • Verifique as permissões do sistema de arquivos
  • Verifique se a sintaxe JSON está correta
  • Certifique-se de que o diretório de configuração exista
  • Tente executar como administrador (se necessário)

Build falhando:

  • Verifique se todos os arquivos de recursos existem
  • Verifique a sintaxe do arquivo de configuração
  • Certifique-se de que os arquivos de ícone estejam no formato correto
  • Revise os logs de build para erros específicos

Obtendo Ajuda​

Se você encontrar problemas com a configuração de White Label:

  1. Verifique a seção de solução de problemas acima
  2. Revise a sintaxe do arquivo de configuração
  3. Entre em contato com o suporte via support@tikmatrix.com
  4. Inclua seu arquivo de configuração e mensagens de erro ao relatar problemas

Licença e Uso​

  • A funcionalidade de White Label está disponível apenas para usuários de Assinatura Anual
  • Direitos de marca personalizada estão incluídos na sua assinatura
  • A redistribuição de versões personalizadas pode exigir licenciamento adicional
  • Entre em contato com o suporte para opções de licenciamento empresarial

Precisa do código de desbloqueio? Entre em contato com nossa equipe de suporte via support@tikmatrix.com com os detalhes da sua assinatura anual.