Painel Google Workspace

📋 Descrição

Painel de gerenciamento do Google Workspace para administração de domínios, usuários, grupos e configurações.

Como Subir o Ambiente de Desenvolvimento

Pré-requisitos

• Docker e Docker Compose instalados
• Acesso ao repositório dev-integracao-servicos
• Credenciais de acesso ao ambiente de desenvolvimento

Passo a Passo

1. Atualizar os Projetos

Navegue até o diretório raiz e atualize todos os projetos:

cd /home/dev/dev-integracao-servicos
git pull

2. Subir o Ambiente de Autenticação

Execute o script para subir o serviço de autenticação:

./scripts/uteis/dev-upauth

Este comando irá:

• Subir o authentication-service
• Configurar o ambiente de login
• Disponibilizar o serviço em login.kinghost.local

3. Subir o Ambiente do Google Workspace

Execute o script para subir os serviços do Google Workspace:

./scripts/uteis/dev-upgwr

Este comando irá:

• Subir o google-workspace-service (API)
• Subir o painel-google-workspace (Frontend)
• Configurar as dependências necessárias

4. Copiar Chaves de Autenticação

Copie as chaves OAuth do authentication-service para o google-workspace-service:

cp DevCanais/authentication-service/app/storage/secrets/oauth-p* DevIntegracoes/google-workspace-service/app/storage/auth-keys/local/

Importante: Este passo é necessário para sincronizar as chaves de autenticação entre os serviços.

5. Realizar Login no Sistema

Acesse o painel de login e faça a autenticação:

1. Abra o navegador e acesse: http://login.kinghost.local
2. Faça login com as credenciais de desenvolvimento:
   • Email: [email protected]
   • Senha: Use a senha de ambiente de desenvolvimento

6. Copiar Token de Autorização

Após o login, copie o token de autenticação:

1. Abra o DevTools do navegador (F12)
2. Vá para a aba Application (Chrome) ou Storage (Firefox)
3. Navegue até Local Storage → http://login.kinghost.local
4. Copie o valor da chave Authorization
5. Acesse http://painel-google-workspace.local
6. Abra o DevTools novamente
7. Navegue até Local Storage → http://painel-google-workspace.local
8. Cole o valor do Authorization copiado

Dica: Este passo sincroniza o token JWT entre as aplicações.

7. Acessar o Painel de Gerenciamento

Agora você pode acessar o painel com um domínio válido:

http://painel-google-workspace.local/google-workspace/gerenciamento?domain=dominio.com.br

Atenção: Substitua dominio.com.br por um domínio válido cadastrado no Google Workspace.

🔗 URLs de Acesso

| Serviço | URL | |---------|-----| | Login | http://login.kinghost.local | | Painel Google Workspace | http://painel-google-workspace.local | | API Google Workspace | http://google-workspace-service.local | | Gerenciamento | http://painel-google-workspace.local/google-workspace/gerenciamento?domain={domain} |

Comandos Úteis

Ver logs dos serviços

# Logs do authentication-service
docker-compose logs -f authentication-service

# Logs do google-workspace-service
docker-compose logs -f google-workspace-service

# Logs do painel-google-workspace
docker-compose logs -f painel-google-workspace

Parar os ambientes

# Parar ambiente de autenticação
./scripts/uteis/dev-downauth

# Parar ambiente do Google Workspace
./scripts/uteis/dev-downgwr

Restart dos serviços

# Restart authentication-service
docker-compose restart authentication-service

# Restart google-workspace-service
docker-compose restart google-workspace-service

# Restart painel-google-workspace
docker-compose restart painel-google-workspace

Troubleshooting

Problema: Não consigo fazer login

Solução: Verifique se o authentication-service está rodando:

docker ps | grep authentication-service

Problema: Token de autorização inválido

Solução: Refaça o processo de login e copie novamente o token do localStorage.

Problema: Domínio não encontrado

Solução: Certifique-se de usar um domínio válido cadastrado no Google Workspace e que está configurado no ambiente.

Problema: Erro de conexão com API

Solução: Verifique se o google-workspace-service está rodando e se as chaves OAuth foram copiadas corretamente.

Documentação Adicional

Para mais informações sobre os serviços:

• API Gateway: Consulte /mnt/DevCanais/api-gateway/README.md
• Authentication Service: Consulte /mnt/DevCanais/authentication-service/README.md
• Google Workspace Service: Consulte /mnt/DevIntegracoes/google-workspace-service/README.md

Contribuindo

Para contribuir com o projeto:

1. Crie uma branch a partir de develop
2. Faça suas alterações
3. Submeta um Pull Request
4. Aguarde revisão do time

Desenvolvido por: Equipe de Integrações KingHost