Trilha SQL para Suporte Técnico

Este repositório entrega a infraestrutura local para a trilha de formação em banco de dados e SQL descrita em docs/trilha.md.

O foco é permitir que o trainee suba um ambiente MySQL reproduzível, pratique modelagem, criação de tabelas, evolução de schema e consultas orientadas a suporte técnico.

Estrutura do projeto

.
├── docker-compose.yml
├── README.md
├── docs/
│   └── trilha.md
└── sql/
    ├── 01-init.sql
    ├── 02-seed.sql
    └── 03-exercicios.sql

Pré-requisitos

• Docker
• Docker Compose

Serviços disponíveis

• mysql: banco principal da trilha
• phpmyadmin: interface web opcional para inspeção e execução de consultas

Credenciais de estudo

Banco

• host: 127.0.0.1
• porta: 3306
• database: trilha_suporte

Usuários

• root:
  • usuário: root
  • senha: root
• trainee:
  • usuário: trainee
  • senha: trainee123

Interface web

• URL: http://localhost:8080
• servidor: mysql

Como subir o ambiente

docker compose up -d

Como verificar se o banco subiu

docker compose ps
docker compose logs mysql

Quando o container inicializa pela primeira vez, o MySQL executa automaticamente os scripts da pasta sql/ na ordem alfabética:

1. sql/01-init.sql
2. sql/02-seed.sql
3. sql/03-exercicios.sql

Como acessar o MySQL pelo terminal

Como root

docker compose exec mysql mysql -u root -proot

Como trainee

docker compose exec mysql mysql -u trainee -ptrainee123 trilha_suporte

Se preferir conectar por um cliente externo:

mysql -h 127.0.0.1 -P 3306 -u trainee -p

Como entregar para correção

Cada participante deve trabalhar no seu próprio fork deste repositório. Isso permite que as respostas, ajustes e exercícios fiquem isolados por aluno e facilita a revisão posterior.

Fluxo sugerido

1. Faça um fork deste repositório na sua conta do GitHub.
2. Clone o fork para a sua máquina.
3. Execute os exercícios e registre suas respostas diretamente nos arquivos combinados para a turma.
4. Faça commit das alterações no seu fork.
5. Envie o link do seu repositório ou abra um Pull Request para que a correção possa ser feita.

Exemplo de clone do fork:

git clone <URL_DO_SEU_FORK>
cd Trilha_SQL

Fluxo recomendado da trilha

1. Ler o material didático em docs/trilha.md.
2. Subir o ambiente com Docker.
3. Inspecionar a estrutura inicial com SHOW TABLES; e DESC nome_da_tabela;.
4. Explorar os dados de exemplo carregados em sql/02-seed.sql.
5. Resolver os enunciados comentados em sql/03-exercicios.sql.
6. Evoluir o schema com comandos ALTER TABLE propostos na trilha.

Resetar o ambiente

Para recriar o banco do zero e reexecutar os scripts de inicialização:

docker compose down -v
docker compose up -d

Conteúdo de cada script

• sql/01-init.sql: schema inicial com tabelas, chaves, índices e restrições
• sql/02-seed.sql: dados de prática cobrindo os cenários da trilha
• sql/03-exercicios.sql: enunciados comentados para prática guiada

Observações

• Os scripts em /docker-entrypoint-initdb.d só rodam automaticamente quando o volume do MySQL ainda não existe.
• O dataset foi montado para cobrir casos com e sem vendedor, produtos inativos, produtos nunca vendidos e pedido inconsistente para investigação.
• O material pedagógico original foi preservado em docs/trilha.md.