Whodo API - Ambiente de Desenvolvimento

Este diretório contém a configuração do ambiente de desenvolvimento para o Whodo API.

🔧 Configuração

1. Configure as variáveis de ambiente no arquivo .env:

REGISTRY_URL=seu-registry.com
DOCKER_USERNAME=seu-usuario
DOCKER_PASSWORD=sua-senha

2. crie o whodo-network

docker network create whodo-network

3. Inicie o ambiente de desenvolvimento:

docker-compose -f docker-compose.dev.yml up -d

🚀 Uso

Build de todos os serviços

O ambiente de desenvolvimento automaticamente fará o build e push de todos os serviços quando iniciado através do entrypoint.sh. Este script:

1. Faz login no registry Docker
2. Builda e faz push de todos os serviços em sequência
3. Mantém o container rodando para desenvolvimento

Build individual de serviços

Para fazer o build de um serviço específico:

docker exec whodo-dev /scripts/build-service.sh whodo-api-auth

📝 Estrutura

• docker-compose.yml: Configuração do ambiente de build
• docker-compose.dev.yml: Configuração para desenvolvimento com imagens buildadas
• Dockerfile: Configuração do container de desenvolvimento
• entrypoint.sh: Script de inicialização do ambiente que faz o build inicial de todos os serviços
• scripts/: Scripts utilitários
  • build-service.sh: Script para build individual de serviços

🔄 Workflow de Desenvolvimento

1. Faça suas alterações no código
2. Execute o build do serviço modificado:

   docker exec whodo-dev /scripts/build-service.sh nome-do-servico

3. Reinicie o serviço no ambiente de desenvolvimento:

   docker-compose -f docker-compose.dev.yml restart nome-do-servico

🌐 Portas dos Serviços

• Auth: 8050
• Customer: 8060
• Kanban: 8070
• Orders: 8080
• Stock Group: 8090
• Supplier: 8010
• Products: 8035
• Categories: 8040
• CDN: 8041
• Company: 8042
• Sectors: 8043
• Comments: 8044
• purcheseOrder: 8045

📌 Notas

• Certifique-se de ter acesso ao registry Docker configurado
• As imagens são taggeadas como :latest por padrão
• O ambiente de desenvolvimento mantém estado no volume dbdata

🗃️ Migrations

Para executar as migrations do banco de dados:

docker compose -f docker-compose.dev.yml up --build migrations

Este comando irá:

1. Reconstruir o container de migrations
2. Executar todas as migrations em ordem
3. Criar/atualizar as tabelas necessárias no banco de dados

⚠️ Atenção: Este comando irá remover todas as tabelas existentes antes de executar as migrations. Use com cuidado em ambiente de desenvolvimento.