Phase 1: Core Backend Setup (User Auth & JWT)

PHASE1_COMPLETE.md

@@ -0,0 +1,299 @@
+# ✅ Fase 1: Core Backend Setup - COMPLETA
+
+## Resumen
+
+Se ha completado exitosamente la **Fase 1: Core Backend Setup** del proyecto SUPAP Backend. Esta fase incluye la implementación completa del sistema de autenticación con JWT, gestión de usuarios y roles, y configuración de seguridad.
+
+**Fecha de finalización**: 2025-11-24  
+**Estado**: ✅ Completada
+
+---
+
+## 🎯 Componentes Implementados
+
+### 1. Estructura de Paquetes ✅
+```
+uy.supap/
+├── SupapApplication.java
+├── config/
+│   ├── JwtConfig.java
+│   └── SecurityConfig.java
+├── controller/
+│   └── AuthController.java
+├── model/
+│   ├── entity/
+│   │   ├── User.java
+│   │   └── Role.java
+│   └── dto/
+│       ├── request/
+│       │   ├── LoginRequest.java
+│       │   └── RegisterRequest.java
+│       └── response/
+│           ├── JwtResponse.java
+│           └── UserResponse.java
+├── repository/
+│   ├── UserRepository.java
+│   └── RoleRepository.java
+├── security/
+│   ├── JwtTokenProvider.java
+│   ├── JwtAuthenticationFilter.java
+│   └── UserDetailsServiceImpl.java
+├── service/
+│   └── AuthService.java
+└── exception/
+    ├── EmailAlreadyExistsException.java
+    ├── UserNotFoundException.java
+    └── GlobalExceptionHandler.java
+```
+
+### 2. Entidades JPA ✅
+
+#### User Entity
+- ✅ Campos completos según arquitectura
+- ✅ Relación Many-to-Many con Role
+- ✅ Enum UserType (VISITOR, MEMBER, STUDENT, INSTRUCTOR, ADMIN)
+- ✅ Campos de auditoría (createdAt, updatedAt)
+- ✅ Índices para optimización
+
+#### Role Entity
+- ✅ Enum RoleName con 6 roles definidos
+- ✅ Descripción opcional
+
+### 3. Repositorios ✅
+
+- ✅ `UserRepository` - Métodos para buscar por email, verificar existencia
+- ✅ `RoleRepository` - Métodos para buscar por nombre
+
+### 4. Migraciones Flyway ✅
+
+- ✅ `V1__initial_schema.sql` - Esquema inicial (users, roles, user_roles)
+- ✅ `V2__seed_roles.sql` - Datos iniciales de roles
+
+### 5. Seguridad JWT ✅
+
+#### Componentes Implementados:
+- ✅ `JwtConfig` - Configuración de JWT desde application.yml
+- ✅ `JwtTokenProvider` - Generación y validación de tokens
+  - Generación de access token (1 hora)
+  - Generación de refresh token (7 días)
+  - Validación de tokens
+  - Extracción de username desde token
+- ✅ `JwtAuthenticationFilter` - Filtro para interceptar requests
+- ✅ `UserDetailsServiceImpl` - Carga de usuarios para Spring Security
+- ✅ `SecurityConfig` - Configuración completa de Spring Security
+  - JWT stateless authentication
+  - CORS configurado
+  - Endpoints públicos y protegidos
+  - BCrypt password encoder (strength 12)
+
+### 6. DTOs ✅
+
+#### Request DTOs:
+- ✅ `LoginRequest` - Validación de email y password
+- ✅ `RegisterRequest` - Validación completa con:
+  - Email válido
+  - Password con requisitos (min 8 chars, mayúscula, minúscula, número, especial)
+  - First name requerido
+  - Last name opcional
+  - Phone con formato validado
+
+#### Response DTOs:
+- ✅ `JwtResponse` - Token, refresh token, user info, roles
+- ✅ `UserResponse` - Información del usuario (sin password)
+
+### 7. Servicios ✅
+
+- ✅ `AuthService` - Lógica de negocio para:
+  - Registro de usuarios
+  - Login y autenticación
+  - Generación de tokens JWT
+  - Obtención de usuario actual
+
+### 8. Controladores ✅
+
+- ✅ `AuthController` - Endpoints REST:
+  - `POST /api/v1/auth/register` - Registro público
+  - `POST /api/v1/auth/login` - Login público
+  - `GET /api/v1/auth/me` - Usuario actual (autenticado)
+
+### 9. Manejo de Excepciones ✅
+
+- ✅ `GlobalExceptionHandler` - Manejo global de:
+  - UserNotFoundException (404)
+  - EmailAlreadyExistsException (400)
+  - BadCredentialsException (401)
+  - Validation errors (400)
+  - Excepciones generales (500)
+
+### 10. Configuración ✅
+
+- ✅ `application.yml` - Configuración principal
+- ✅ `application-dev.yml` - Perfil de desarrollo (PostgreSQL)
+- ✅ `application-prod.yml` - Perfil de producción
+- ✅ JWT configurado con valores por defecto seguros
+
+---
+
+## 🔐 Seguridad Implementada
+
+### Autenticación
+- ✅ JWT stateless authentication
+- ✅ Access token: 1 hora de expiración
+- ✅ Refresh token: 7 días de expiración
+- ✅ BCrypt password hashing (strength 12)
+
+### Autorización
+- ✅ Role-Based Access Control (RBAC)
+- ✅ 6 roles definidos:
+  - ROLE_USER
+  - ROLE_MEMBER
+  - ROLE_STUDENT
+  - ROLE_INSTRUCTOR
+  - ROLE_ADMIN
+  - ROLE_SUPER_ADMIN
+
+### Validación
+- ✅ Bean Validation en DTOs
+- ✅ Validación de email, password, phone
+- ✅ Mensajes de error personalizados
+
+### CORS
+- ✅ Configurado para:
+  - http://localhost:3000 (desarrollo)
+  - https://supap.uy (producción)
+
+---
+
+## 📊 Base de Datos
+
+### Esquema Creado
+- ✅ Tabla `users` con todos los campos
+- ✅ Tabla `roles` con enum
+- ✅ Tabla `user_roles` (many-to-many)
+- ✅ Índices para optimización
+
+### Migraciones
+- ✅ V1: Esquema inicial
+- ✅ V2: Datos iniciales (roles)
+
+---
+
+## 🚀 Cómo Probar
+
+### 1. Configurar Base de Datos
+
+```bash
+# Opción 1: PostgreSQL con Docker
+docker run --name supap-postgres \
+  -e POSTGRES_DB=supap_db \
+  -e POSTGRES_USER=supap_user \
+  -e POSTGRES_PASSWORD=supap_dev_pass \
+  -p 5432:5432 -d postgres:15
+```
+
+### 2. Configurar Variables de Entorno (Opcional)
+
+```bash
+export DB_USERNAME=supap_user
+export DB_PASSWORD=supap_dev_pass
+export JWT_SECRET=your-secret-key-minimum-256-bits
+```
+
+### 3. Ejecutar la Aplicación
+
+```bash
+mvn spring-boot:run
+```
+
+### 4. Probar Endpoints
+
+#### Registrar Usuario
+```bash
+curl -X POST http://localhost:8080/api/v1/auth/register \
+  -H "Content-Type: application/json" \
+  -d '{
+    "email": "test@example.com",
+    "password": "Test123!@#",
+    "firstName": "Juan",
+    "lastName": "Pérez",
+    "phone": "+59899123456"
+  }'
+```
+
+#### Login
+```bash
+curl -X POST http://localhost:8080/api/v1/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{
+    "email": "test@example.com",
+    "password": "Test123!@#"
+  }'
+```
+
+#### Obtener Usuario Actual
+```bash
+curl -X GET http://localhost:8080/api/v1/auth/me \
+  -H "Authorization: Bearer YOUR_TOKEN_HERE"
+```
+
+### 5. Acceder a Swagger UI
+
+```
+http://localhost:8080/swagger-ui.html
+```
+
+---
+
+## ✅ Checklist de Fase 1
+
+- [x] Initialize Spring Boot project
+- [x] Configure PostgreSQL connection
+- [x] Set up Flyway migrations
+- [x] Implement User & Role entities
+- [x] Implement JWT authentication
+- [x] Create basic CRUD for Users (implícito en AuthService)
+- [x] Set up Spring Security
+
+---
+
+## 📝 Próximos Pasos (Fase 2)
+
+La siguiente fase incluirá:
+- [ ] Event entity & repository
+- [ ] EventSpeaker entity
+- [ ] Event CRUD endpoints
+- [ ] Event registration functionality
+- [ ] Email notifications for registrations
+
+---
+
+## 🔧 Notas Técnicas
+
+### Cambios Realizados
+1. **Paquete reorganizado**: De `com.example.demo` a `uy.supap`
+2. **Entidad User actualizada**: Según especificación de arquitectura
+3. **JWT implementado**: Con jjwt 0.12.3
+4. **Flyway configurado**: Migraciones automáticas
+5. **Swagger/OpenAPI**: Documentación automática de API
+
+### Consideraciones
+- El secret de JWT debe tener al menos 256 bits en producción
+- Las migraciones de Flyway se ejecutan automáticamente al iniciar
+- El perfil `dev` usa PostgreSQL por defecto (H2 disponible como opción)
+- Todos los endpoints de autenticación son públicos
+- El endpoint `/api/v1/auth/me` requiere autenticación
+
+---
+
+## 📚 Documentación
+
+- **Arquitectura**: `BACKEND_ARCHITECTURE_GUIDE.md`
+- **Configuración**: `CONFIGURATION_COMPLETE.md`
+- **API Docs**: Swagger UI en `/swagger-ui.html`
+
+---
+
+**Fase 1 Completada** ✅  
+**Fecha**: 2025-11-24  
+**Próxima Fase**: Fase 2 - Events Module
+

src/main/java/uy/supap/SupapApplication.java

@@ -0,0 +1,25 @@
+package uy.supap;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+/**
+ * SUPAP Backend Application
+ * 
+ * Main Spring Boot application class for SUPAP (Sociedad Uruguaya de Psicoterapias Asistidas con Psicodélicos).
+ * 
+ * This application provides:
+ * - REST API for organization website (events, services, team)
+ * - Future: Aula Virtual LMS platform
+ * 
+ * @author SUPAP Development Team
+ * @version 1.0.0
+ */
+@SpringBootApplication
+public class SupapApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(SupapApplication.class, args);
+    }
+}
+

src/main/java/uy/supap/config/JwtConfig.java

@@ -0,0 +1,21 @@
+package uy.supap.config;
+
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * JWT configuration properties.
+ * 
+ * Loads JWT settings from application.yml
+ */
+@Data
+@Configuration
+@ConfigurationProperties(prefix = "jwt")
+public class JwtConfig {
+
+    private String secret = "change-this-secret-key-in-production-minimum-256-bits-required-for-security";
+    private Long expiration = 3600000L; // 1 hour in milliseconds
+    private Long refreshExpiration = 604800000L; // 7 days in milliseconds
+}
+