Módulo 16: Proyecto E-Contact Backend - Guía Completa
Objetivos del Módulo
Este módulo le guía a través de la realización completa del proyecto e-contact-backend, una aplicación Spring Boot profesional con:
- API REST completa para formulario de contacto
- Autenticación y seguridad JWT
- Base de datos PostgreSQL
- Integración de frontend
- Despliegue con GitHub Codespaces
📦 Repositorio Principal de GitHub
Acceso al Proyecto
Repositorio: inskillflow-docs-formation-spring-boot-projet-e-contact-backend
Este repositorio contiene el código fuente completo, la documentación, las guías de troubleshooting y el frontend de prueba.
Plan del Módulo
Capítulos Prácticos
| # | Capítulo | Duración | Descripción |
|---|---|---|---|
| 1 | Inicio con Codespaces | 1h | Configuración del entorno GitHub Codespaces |
| 2 | Troubleshooting | 1h30 | Resolución de problemas comunes |
| 3 | Integración Frontend | 1h | Conexión del frontend al backend |
| 4 | Curso Complementario | 3h | Módulos 22-28 - Profundización |
| 5 | Security Avanzada | 4h | Módulos 11-18 - Seguridad paso a paso |
Duración total estimada: 10-12 horas
🔗 Recursos del Proyecto
Código Fuente y Documentación
| Recurso | Enlace | Descripción |
|---|---|---|
| Repositorio Principal | GitHub | Código fuente completo del proyecto |
| Troubleshooting | Carpeta troubleshooting | Guías de resolución de problemas |
| Frontend | Carpeta frontend | Frontend simple para probar la API |
| Guía Frontend | Guía de integración | Integración frontend con Codespaces |
Cursos y Formaciones
| Recurso | Enlace | Descripción |
|---|---|---|
| Curso Complementario | Carpeta cursos | Cursos completos (especialmente módulos 22-28) |
| Security Detallada | Anexos Security | Módulos 11-18 sobre seguridad |
Arquitectura del Proyecto
e-contact-backend/
├── 📁 src/main/java/
│ ├── 📁 config/ # Configuración 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 negocio
├── 📁 src/main/resources/
│ └── application.yml # Configuración
├── 📁 frontend/ # Frontend de prueba HTML/JS
├── 📁 troubleshooting/ # Guías de soporte
└── 📁 cours/ # Documentación y cursos
└── 📁 annexes-security-1/ # Curso de seguridad detallado
Inicio Rápido
Opción 1: GitHub Codespaces (Recomendado)
- Abra el repositorio en GitHub
- Haga clic en Code → Codespaces → Create codespace on main
- Espere a que cargue el entorno (~2 min)
- Inicie la aplicación:
./mvnw spring-boot:run
Opción 2: En Local
# Clonar el repositorio
git clone https://github.com/hrhouma1/inskillflow-docs-formation-spring-boot-projet-e-contact-backend.git
# Acceder a la carpeta
cd inskillflow-docs-formation-spring-boot-projet-e-contact-backend
# Iniciar la aplicación
./mvnw spring-boot:run
📋 Requisitos Previos
Conocimientos Requeridos
- Módulos 1-13 de esta formación
- Fundamentos de Spring Boot y Spring MVC
- Nociones de Spring Data JPA
- Familiaridad con REST APIs
Herramientas Necesarias
| Herramienta | Versión | Uso |
|---|---|---|
| Cuenta GitHub | - | Para Codespaces |
| Navegador Web | Reciente | Para probar la API y el frontend |
| (Opcional) Java | 17+ | Si ejecución local |
| (Opcional) Maven | 3.8+ | Si ejecución local |
| (Opcional) PostgreSQL | 14+ | Si ejecución local |
Ruta de Aprendizaje Recomendada
Orden Sugerido
- Capítulo 1 - Comience configurando su entorno Codespaces
- Capítulo 2 - Consulte troubleshooting si encuentra problemas
- Capítulo 3 - Conecte el frontend para visualizar el resultado
- Capítulo 4 - Profundice con los cursos complementarios
- Capítulo 5 - Domine la seguridad con Spring Security y JWT
Competencias Desarrolladas
Al finalizar este módulo, usted será capaz de:
| Competencia | Nivel |
|---|---|
| Crear una API REST completa | ⭐⭐⭐⭐⭐ |
| Implementar JWT Authentication | ⭐⭐⭐⭐⭐ |
| Utilizar GitHub Codespaces | ⭐⭐⭐⭐ |
| Integrar un frontend | ⭐⭐⭐⭐ |
| Depurar una aplicación Spring | ⭐⭐⭐⭐⭐ |
| Configurar Spring Security | ⭐⭐⭐⭐⭐ |
📞 Soporte
Si encuentra dificultades:
- Consulte primero la guía de troubleshooting
- Revise los issues de GitHub
- Contacte a su instructor
⏭️ Siguiente Paso
Comenzar con GitHub Codespaces →