Group Liberty — Guia de Instalação e Deploy

1. Instalar no Computador da Empresa (PC ou Mac)

Sem instalação de software! O sistema é um PWA — instala direto do navegador, funciona offline, e aparece no menu Iniciar / Spotlight como qualquer outro app.

Google Chrome (Windows / Mac / Linux)

1

Abra o sistema no Chrome Acesse o URL publicado (ex: https://groupliberty.genspark.site)

2

Clique no ícone de instalação Na barra de endereço, clique no ícone ou ⊕ que aparece à direita.
Alternativa: Menu ⋮ → "Instalar aplicativo..." ou "Adicionar à tela inicial"

3

Confirme a instalação Clique em "Instalar". O app abrirá como janela independente, sem barra do navegador.

4

✅ Pronto! Aparecerá no Menu Iniciar (Windows), Dock/Spotlight (Mac) e na área de trabalho. Clique duas vezes para abrir como qualquer app.

Microsoft Edge (Windows)

Abra o sistema no Edge
Menu ⋯ → "Aplicativos" → "Instalar este site como um aplicativo"
Confirme. Aparecerá no Menu Iniciar e como app fixado.

Dica para a empresa: O botão "Instalar App" já está implementado no canto superior direito do sistema — clique nele quando aparecer para instalar automaticamente.

2. Instalar no Android (Celular/Tablet)

Android suporta PWA nativamente — instala via Chrome sem precisar de app store!

Via Chrome (Android)

1

Abra o Chrome no Android Acesse o URL do sistema

2

Aparecerá um banner automático "Adicionar Group Liberty à tela inicial" — toque em Instalar.
Se não aparecer: Toque em ⋮ → "Adicionar à tela inicial"

3

✅ App instalado! O ícone do Group Liberty aparece na tela inicial. Toque para abrir em modo tela cheia.

Para o cliente: Envie o link do portal (ex: https://groupliberty.genspark.site/portal-cliente.html) por WhatsApp. Ele abre no Chrome, toca em instalar e pronto!

3. Instalar no iPhone / iPad (iOS/iPadOS)

iOS usa Safari — o Chrome e outros browsers no iPhone não suportam PWA install. Use o Safari!

1

Abra o Safari Acesse o URL do sistema (não use Chrome)

2

Toque em Compartilhar Botão na barra inferior do Safari

3

Role a lista e toque em "Adicionar à Tela de Início" Adicionar à Tela de Início

4

Confirme o nome e toque em "Adicionar" O ícone Group Liberty aparece na tela inicial do iPhone!

iOS 16.4+: Suporta Push Notifications em PWA instalados via Safari — quando ativarmos notificações push, os clientes iPhone receberão alertas de atualização do processo!

4. Publicar no Google Play (TWA — Trusted Web Activity)

TWA = seu PWA empacotado como app Android e publicado na Google Play Store. Usuários baixam da loja e funcionam como app nativo.

Pré-requisitos

Domínio próprio com HTTPS (ex: app.groupliberty.pt)
Conta Google Play Developer — taxa única de US$ 25 em play.google.com/console

Passo a passo com PWABuilder (recomendado)

1

Acesse pwabuilder.com Insira o URL do sistema publicado e clique em "Start"

2

Verifique o Score PWA O sistema já tem: ✅ manifest.json · ✅ Service Worker · ✅ HTTPS · ✅ Ícones
Score esperado: 100/100

3

Clique em "Package for stores" → Android Configure: nome do app, package ID (ex: pt.groupliberty.app), versão

4

Baixe o .aab (Android App Bundle) O PWABuilder gera o arquivo pronto para upload

5

Upload no Google Play Console play.google.com/console → Criar app → Versões → Carregar .aab

6

Criar assetlinks.json no seu domínio O PWABuilder instrui como criar este arquivo para vincular o domínio ao app Play

7

✅ Submeter para revisão O Google leva 1-3 dias para revisar. Após aprovação, app disponível na Play Store!

Importante: A TWA exige que o domínio tenha HTTPS e um arquivo /.well-known/assetlinks.json com a digital signature do app. O PWABuilder gera este arquivo automaticamente.

Alternativa — NÃO precisa da Play Store?

O PWA instalado direto via Chrome Android funciona exatamente como um app da loja — ícone na tela, modo tela cheia, offline. Para uso interno da empresa e portal do cliente, PWA sem Play Store é suficiente.

5. Configurar Domínio Próprio

Você tem domínio no registro.com (site) e e-mail no KingHost. Veja abaixo como apontar para o sistema.

Situação atual recomendada

groupliberty.pt (ou .com) → site institucional (WordPress, etc.)
app.groupliberty.pt ou sistema.groupliberty.pt → este sistema de gestão
portal.groupliberty.pt → portal do cliente
E-mail → manter no KingHost (não muda nada)

Como apontar o domínio para o sistema (CNAME)

1

Publique o sistema na Genspark Aba Publish → copie o URL gerado (ex: groupliberty.genspark.site)

2

Acesse o painel DNS do registro.com Faça login em registro.com.br → Domínios → Gerenciar → DNS

3

Adicione um registro CNAME

# Exemplo de registro DNS CNAME Tipo: CNAME Nome: app # cria app.seudominio.com Valor: groupliberty.genspark.site TTL: 3600

4

Aguarde propagação (15 min a 48h) Verifique com dnschecker.org

Estrutura DNS recomendada

# DNS Records — groupliberty.com (ou .pt) # Site institucional (mantém como está) @ A/CNAME → seu servidor atual # Sistema de gestão (este sistema) app CNAME → groupliberty.genspark.site # Portal do cliente (opcional subdomínio) portal CNAME → groupliberty.genspark.site # E-mail (não muda — KingHost) MX → mx.kinghost.net prioridade 10 SPF → v=spf1 include:kinghost.net ~all

6. Onde Hospedar — Comparativo

Genspark (atual) — Recomendado

✅ Deploy automático incluído
✅ HTTPS automático
✅ CDN global
✅ Suporta domínio customizado
✅ Zero configuração de servidor
✅ Tabelas/API incluídas
⚠️ Plataforma nova — verificar SLA

GitHub Pages (alternativa grátis)

✅ Grátis para repositórios públicos
✅ HTTPS automático
✅ Domínio customizado
❌ Sem API/banco de dados
❌ Apenas arquivos estáticos
⚠️ Requer conhecimento Git

KingHost (você já tem)

✅ Hospedagem web + e-mail
✅ Suporte em português
✅ Pode hospedar HTML estático
⚠️ Ideal para sites WordPress
⚠️ Sem API de tabelas nativa
✅ DNS fácil de configurar

Cloudflare Pages (grátis)

✅ Deploy git automático
✅ CDN ultra-rápido
✅ HTTPS + domínio customizado
✅ Workers (serverless)
⚠️ Curva de aprendizado
✅ Melhor performance

Recomendação para Group Liberty

1ª fase (agora): Manter na Genspark com CNAME apontando app.groupliberty.pt → Genspark. Zero custo extra, pronto para produção.
2ª fase (futuro): Migrar para Cloudflare Pages + Workers KV para banco de dados próprio quando precisar de mais controle.
E-mail: Manter no KingHost — não precisa mudar nada.

Pode comprar domínio na Genspark?

A Genspark não vende domínios diretamente. Use:

registro.br — domínios .pt e .com.br (você já usa)
Namecheap.com — domínios .pt, .com internacionais (muito bom preço)
GoDaddy.com — opção popular
KingHost — também vende e gerencia domínios com suporte PT-BR

Sugestão: Se não tiver groupliberty.pt, registre em Namecheap por ~€12/ano.

7. Configurar ASAAS (Pagamentos Brasil)

1

Criar conta no ASAAS Acesse asaas.com → Criar conta gratuita → Informar CNPJ/CPF → Verificar identidade

2

Obter o API Token No ASAAS: Menu → Integrações → API → Copiar o access_token
Começa com: $aact_XXXXXXXXXXXX...

3

Configurar no sistema No sistema: Configurações → Integrações → ASAAS → Configurar
Cole o token, selecione Produção e clique em Testar conexão

4

✅ Pronto! Ao criar pagamentos de clientes BR, o sistema automaticamente:
• Gera QR Code PIX com valor e vencimento exatos
• Gera boleto bancário com linha digitável
• Cria link de pagamento para o cliente pagar online

Outros bancos (Itaú, Santander, Nubank, Bradesco): Quando tiver contratos de integração com eles, basta adicionar nas configurações. O sistema já está preparado para receber novos métodos BR.

8. Configurar SIBS / MB Way (Portugal)

1

Registar no SIBS Gateway Acesse developer.sibsgateway.com → Criar conta → Preencher dados da empresa

2

Criar uma aplicação No portal developer → My Apps → Create App → Copiar:
• Bearer Token (API Key)
• Terminal ID
• Merchant / Client ID

3

Configurar no sistema Configurações → Integrações → SIBS/MB Way → Configurar
Preencha os 3 campos e clique Testar conexão

4

✅ Pronto! Pagamentos Portugal:
• MB Way — cliente recebe pedido no telemóvel e confirma
• Multibanco — gera entidade + referência automática
• SEPA — exibe dados IBAN para transferência

Millennium BCP: Já está listado nas integrações. Quando tiver contrato com o banco, preencha as credenciais (API Key, Client ID) — o sistema já tem os campos preparados.