Módulo 16: Projeto E-Contact Backend - Guia Completo
Objetivos do Módulo
Este módulo orienta você na realização completa do projeto e-contact-backend, uma aplicação Spring Boot profissional com:
- API REST completa para formulário de contato
- Autenticação e segurança JWT
- Banco de dados PostgreSQL
- Integração com frontend
- Deploy com GitHub Codespaces
📦 Repositório GitHub Principal
Acesso ao Projeto
Repositório: inskillflow-docs-formation-spring-boot-projet-e-contact-backend
Este repositório contém o código-fonte completo, documentação, guias de troubleshooting e o frontend de teste.
Plano do Módulo
Capítulos Práticos
| # | Capítulo | Duração | Descrição |
|---|---|---|---|
| 1 | Iniciando com Codespaces | 1h | Configuração do ambiente GitHub Codespaces |
| 2 | Troubleshooting | 1h30 | Resolução de problemas comuns |
| 3 | Integração Frontend | 1h | Conexão do frontend com o backend |
| 4 | Curso Complementar | 3h | Módulos 22-28 - Aprofundamento |
| 5 | Security Avançada | 4h | Módulos 11-18 - Segurança passo a passo |
Duração total estimada: 10-12 horas
🔗 Recursos do Projeto
Código-Fonte e Documentação
| Recurso | Link | Descrição |
|---|---|---|
| Repositório Principal | GitHub | Código-fonte completo do projeto |
| Troubleshooting | Pasta troubleshooting | Guias de resolução de problemas |
| Frontend | Pasta frontend | Frontend simples para testar a API |
| Guia Frontend | Guia de integração | Integração do frontend com Codespaces |
Cursos e Treinamentos
| Recurso | Link | Descrição |
|---|---|---|
| Curso Complementar | Pasta cursos | Cursos completos (principalmente módulos 22-28) |
| Security Detalhada | Anexos Security | Módulos 11-18 sobre segurança |
Arquitetura do Projeto
e-contact-backend/
├── 📁 src/main/java/
│ ├── 📁 config/ # Configuração Spring Security, CORS
│ ├── 📁 controller/ # REST Controllers (Contact, Auth, Admin)
│ ├── 📁 dto/ # Data Transfer Objects
│ ├── 📁 model/ # Entidades JPA (Lead, User)
│ ├── 📁 repository/ # Spring Data JPA Repositories
│ ├── 📁 security/ # JWT, Filtros, Authentication
│ └── 📁 service/ # Lógica de negócio
├── 📁 src/main/resources/
│ └── application.yml # Configuração
├── 📁 frontend/ # Frontend de teste HTML/JS
├── 📁 troubleshooting/ # Guias de troubleshooting
└── 📁 cours/ # Documentação e cursos
└── 📁 annexes-security-1/ # Curso detalhado de segurança
Início Rápido
Opção 1: GitHub Codespaces (Recomendado)
- Abra o repositório no GitHub
- Clique em Code → Codespaces → Create codespace on main
- Aguarde o carregamento do ambiente (~2 min)
- Inicie a aplicação:
./mvnw spring-boot:run
Opção 2: Localmente
# Clonar o repositório
git clone https://github.com/hrhouma1/inskillflow-docs-formation-spring-boot-projet-e-contact-backend.git
# Acessar a pasta
cd inskillflow-docs-formation-spring-boot-projet-e-contact-backend
# Iniciar a aplicação
./mvnw spring-boot:run
📋 Pré-requisitos
Conhecimentos Necessários
- Módulos 1-13 deste treinamento
- Fundamentos de Spring Boot e Spring MVC
- Noções de Spring Data JPA
- Familiaridade com REST APIs
Ferramentas Necessárias
| Ferramenta | Versão | Uso |
|---|---|---|
| Conta GitHub | - | Para Codespaces |
| Navegador Web | Recente | Para testar a API e o frontend |
| (Opcional) Java | 17+ | Se execução local |
| (Opcional) Maven | 3.8+ | Se execução local |
| (Opcional) PostgreSQL | 14+ | Se execução local |
Roteiro de Aprendizagem Recomendado
Ordem Sugerida
- Capítulo 1 - Comece configurando seu ambiente Codespaces
- Capítulo 2 - Consulte o troubleshooting se encontrar problemas
- Capítulo 3 - Conecte o frontend para visualizar o resultado
- Capítulo 4 - Aprofunde com os cursos complementares
- Capítulo 5 - Domine a segurança com Spring Security e JWT
Competências Desenvolvidas
Ao final deste módulo, você será capaz de:
| Competência | Nível |
|---|---|
| Criar uma API REST completa | ⭐⭐⭐⭐⭐ |
| Implementar JWT Authentication | ⭐⭐⭐⭐⭐ |
| Utilizar GitHub Codespaces | ⭐⭐⭐⭐ |
| Integrar um frontend | ⭐⭐⭐⭐ |
| Depurar uma aplicação Spring | ⭐⭐⭐⭐⭐ |
| Configurar Spring Security | ⭐⭐⭐⭐⭐ |
📞 Suporte
Se você encontrar dificuldades:
- Consulte primeiro o guia de troubleshooting
- Verifique as issues no GitHub
- Entre em contato com seu instrutor
⏭️ Próxima Etapa
Comece com GitHub Codespaces →