docker compose up --build

Fallback temporal sin certificado (solo desarrollo):

PowerShell:

$env:BACKEND_MAVEN_ARGS="-DskipTests package -Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true"
docker compose up --build

Linux / Mac:

BACKEND_MAVEN_ARGS="-DskipTests package -Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true" docker compose up --build

Sin Docker (desarrollo local)

Requisitos: Java 25, Maven, Node.js 20+, PostgreSQL 16 corriendo en localhost:5432 con base de datos paco_db.

Backend:

cd backend
./mvnw spring-boot:run

Frontend (en otra terminal):

cd frontend
npm install
npm run dev

Swagger / OpenAPI

Con el backend corriendo, accede a la documentación interactiva en:

http://localhost:8080/swagger-ui.html

Esquema JSON disponible en: http://localhost:8080/v3/api-docs

Endpoints principales

Decisiones técnicas

Backend y base de datos

• Java 25 + Spring Boot 4.0.7 — Framework principal para la API REST. Se eligió por su ecosistema maduro y facilidad de integración con seguridad y persistencia.
• PostgreSQL 16 — Motor relacional requerido. Las tablas app_user, b4b_customer e integration_event_log se crean automáticamente al arrancar vía schema.sql.
• Spring Security + JWT (jjwt 0.12.6) — Autenticación stateless con Bearer Token. El filtro JwtAuthenticationFilter valida el token en cada request protegido.
• Spring Data JPA + Hibernate 7 — ORM para la capa de persistencia. Se usa ddl-auto=validate para que Hibernate verifique el esquema sin modificarlo.
• Springdoc OpenAPI 3.0.2 — Genera y expone Swagger UI automáticamente sin configuración adicional.
• Soft delete — El endpoint DELETE no elimina físicamente el registro; cambia el status a INACTIVE y registra el evento en integration_event_log.
• Variables de entorno — Toda configuración sensible (DB_HOST, DB_PASSWORD, JWT_SECRET, etc.) se lee desde variables de entorno con valores por defecto para desarrollo local.

Frontend

• React 19 + TypeScript + Vite 8 — SPA con tipado estático. Vite permite HMR rápido en desarrollo y bundles optimizados para producción.
• React Router v7 — Enrutamiento en cliente con rutas protegidas que validan la presencia del token JWT antes de renderizar.
• Axios — Cliente HTTP con interceptor de request que adjunta automáticamente el Bearer Token almacenado en localStorage.
• Nginx — En el contenedor Docker, el build estático de Vite es servido por Nginx con regla try_files para soportar el enrutamiento SPA.