API REST de Lumina hecha con Spring Boot, Spring Data JPA y MySQL.
- JDK 21
- MySQL 8 (o ninguno, si pruebas con el perfil
h2) - Maven (IntelliJ y VS Code con el Extension Pack for Java ya lo traen)
-
En MySQL, ejecuta en este orden los scripts de la carpeta
data-base/(están en la raíz del repo):01_schema.sql(crea las tablas) y02_seed.sql(datos de ejemplo). -
Si tu usuario de MySQL no es
rooto la contraseña no esroot, define las variables de entornoDB_USERyDB_PASSWORD. Así no subimos contraseñas a GitHub. -
Desde esta carpeta (
backend/):mvn spring-boot:runLa API queda en
http://localhost:8080.
Sin MySQL: mvn spring-boot:run -Dspring-boot.run.profiles=h2 usa una base de datos en memoria.
Se borra al apagar la API y empieza sin productos.
Los paquetes van por dominio, como se definió en docs/DESARROLLO.md:
com.lumina
├── usuario/ Role, AppUser, registro y login
├── producto/ Product (categoría como texto)
├── vela/ CustomCandle (vela personalizada)
├── pedido/ UserOrder, OrderItem (estado como enum)
├── config/ CORS, BCrypt y roles básicos
└── common/ excepciones y manejo de errores
Entidades del MVP: role, app_user, product, user_order, order_item y custom_candle.
No hay tablas para categorías, cupones, carrito, favoritos, contactos ni estados de pedido.
Cada dominio tiene sus entidades, su repositorio (JpaRepository, que ya trae el CRUD completo),
su servicio (la lógica) y su controlador (los endpoints).
| Método | Ruta | Qué hace |
|---|---|---|
| POST | /api/registro |
Crea una cuenta (rol CUSTOMER) |
| POST | /api/login |
Revisa correo y contraseña |
| GET | /api/usuarios · /api/usuarios/{id} |
Lista o consulta usuarios |
| PUT · DELETE | /api/usuarios/{id} |
Edita nombre y teléfono, o elimina |
| GET | /api/productos |
Lista. Filtros: ?categoria=navidad&disponibles=true |
| GET | /api/productos/{id} · /api/productos/slug/{slug} |
Un producto |
| POST · PUT · DELETE | /api/productos · /api/productos/{id} |
Crea, edita, elimina |
| POST · GET · DELETE | /api/velas-personalizadas · ?usuarioId= · /{id} |
Velas de "Crea tu Lumina" |
| POST | /api/pedidos |
Crea un pedido (calcula precios y baja el stock; sin cupones) |
| GET | /api/pedidos · ?usuarioId=2 · /api/pedidos/{id} |
Lista o consulta pedidos |
| PUT | /api/pedidos/{id}/estado |
Cambia el estado. Si pasa a CANCELLED, el stock vuelve |
Estados válidos de un pedido: PENDING, CONFIRMED, PREPARING, COMPLETED y CANCELLED.
Todo pedido nuevo empieza en PENDING.
Registro:
POST /api/registro
{
"fullName": "Laura Gómez",
"phone": "300 123 4567",
"email": "laura@correo.com",
"password": "lumina2026"
}Pedido:
POST /api/pedidos
{
"userId": 2,
"items": [
{ "productId": 1, "quantity": 2 },
{ "productId": 4, "quantity": 1 }
]
}Los errores siempre tienen esta forma:
{
"status": 400,
"error": "Bad Request",
"message": "Revisa los datos enviados.",
"details": ["email: Escribe un correo válido, por ejemplo nombre@correo.com."],
"timestamp": "2026-11-14T16:30:00"
}Códigos: 400 datos inválidos, 401 login incorrecto, 404 no existe, 409 ya existe o hay datos que dependen de él.
- Las contraseñas se guardan con BCrypt. Los usuarios de
02_seed.sqltienen contraseñas de mentira (demo-hash-...), por eso no se puede iniciar sesión con ellos: crea una cuenta nueva con/api/registro. - Todavía no hay JWT. Los endpoints de administración (crear o borrar productos, cambiar estados de pedidos, etc.) están abiertos. Es el siguiente paso para restringirlos por rol.
- CORS permite
localhost:5500y127.0.0.1:5500(Live Server) y la página de GitHub Pages del equipo. Si el frontend corre en otro puerto, se agrega enconfig/WebConfig.java.