🧥 OutfitLab Backend

🚀 Quick Start

1️⃣ Setup Environment Variables

# Copy environment template
cp .env.example .env

# Edit .env with your values
nano .env

2️⃣ Run with Docker (Recommended)

# Start full stack (Backend + PostgreSQL + Redis)
docker compose up --build -d

# Check status
docker compose ps

# View logs
docker compose logs -f outfitlab-backend

3️⃣ Test API

# Health check
curl http://localhost:8080/actuator/health

# Test endpoint
curl http://localhost:8080/api/users/1

🔧 Configuration

Environment Variables

Variable	Description	Default	Example
POSTGRES_DB	Database name	outfitlab	outfitlab
POSTGRES_USER	App database user	-	outfitlab_user
POSTGRES_PASSWORD	App database password	-	secure_pass_123
SPRING_SECURITY_USER	Admin username	admin	admin
SPRING_SECURITY_PASSWORD	Admin password	-	secure_admin_pass

Spring Profiles

• default: Local development (no database)
• docker: Docker environment (full stack)

📊 Architecture

📤 Upload 2D Image → 🤖 AI/3D Processing → 📦 3D Model → ☁️ Storage → 🌐 API → 💻 Frontend

🛠️ Development

Local Development (without Docker)

# Run with mock data
./mvnw spring-boot:run

# Access: http://localhost:8080

Docker Development

# Rebuild after code changes
docker compose up --build

# View specific service logs
docker compose logs outfitlab-backend

# Reset everything
docker compose down -v
docker compose up --build

🔐 Security

• All sensitive data in .env file
• .env is git-ignored for security
• Use .env.example as template

📋 API Endpoints

Endpoint	Method	Description
/api/users/{id}	GET	Get user by ID
/actuator/health	GET	Health check
/actuator/metrics	GET	Application metrics

🗄️ Database

• PostgreSQL 15 for main data
• Redis 7 for caching and queues
• Auto-migrations with Hibernate DDL

📦 Tech Stack

• Spring Boot 3.5.6 + Java 17
• PostgreSQL 15 + Redis 7
• Docker + Docker Compose
• Maven for dependency management
• Actuator for monitoring

🐳 Docker Services

Service	Port	Description
outfitlab-backend	8080	Main Spring Boot API
postgres	5432	PostgreSQL Database
redis	6379	Redis Cache/Queue

---

Variables de entorno requeridas

Variable	Descripción	Ejemplo
SPRING_DATASOURCE_RENDER_URL	JDBC URL de PostgreSQL (Render)	jdbc:postgresql://...:5432/db
SPRING_DATASOURCE_RENDER_USERNAME	Usuario DB	outfitlab_user
SPRING_DATASOURCE_RENDER_PASSWORD	Password DB	s3cret
SPRING_SECURITY_USER	Usuario básico HTTP	admin
SPRING_SECURITY_PASSWORD	Password básica	admin123
AWS_ACCESS_KEY_ID	Credencial AWS	AKIA...
AWS_SECRET_ACCESS_KEY	Credencial AWS	...
AWS_REGION	Región S3	sa-east-1
AWS_BUCKET_NAME	Bucket S3	outfitlab-bucket
FASHION_IA_SECRET_KEY	API key modelo IA	fa-...
MP_ACCESS_TOKEN	Token Mercado Pago	APP_USR-...
FRONTEND_BASE_URL	URL pública del front	https://outfitlab.com.ar
FRONTEND_ORIGINS	Lista de orígenes CORS	https://outfitlab.com.ar,http://localhost:5173
SPRING_MAIL_HOST	Host SMTP	smtp.gmail.com
SPRING_MAIL_PORT	Puerto SMTP	587
SPRING_MAIL_USERNAME	Cuenta SMTP	tpi8bits@gmail.com
SPRING_MAIL_PASSWORD	Password/Token SMTP	xxxx
SPRING_MAIL_FROM	Email remitente (usa username por defecto)	remitente@tudominio.com
MAX_FILE_SIZE / MAX_REQUEST_SIZE	Límites upload	50MB
LOG_LEVEL_ROOT / LOG_LEVEL_OUTFITLAB	Logging	INFO / DEBUG
SERVER_PORT	Puerto interno	8080

Testing

Utilizacion de Patron Given - When - Then

- Given: preparar datos y mocks. Ej:

 private UserSubscriptionEntity givenExistingSubscriptionReturningEntity(String email, String planCode, int combinations) {
    UserSubscriptionEntity entity = givenSubscriptionEntity(email, planCode, 10L, combinations);
    when(userSubscriptionJpaRepository.findByUserEmail(email))
            .thenReturn(Optional.of(entity));
    return entity;
}

- WHEN: ejecutar el método a probar. Ej:

private void whenFindingSubscriptionByUserEmail(String email, UserSubscriptionEntity entity) {
    when(userSubscriptionJpaRepository.findByUserEmail(email)).thenReturn(Optional.of(entity));
}

- THEN: verificar resultados o excepciones. Ej:

private void thenSubscriptionShouldHaveCombinationsUsed(UserSubscriptionModel model, int expected) {
    assertThat(model).isNotNull();
    assertThat(model.getCombinationsUsed()).isEqualTo(expected);
}

- Test completo del metodo

@Test
void shouldReturnSubscriptionModelWhenEmailExists() throws SubscriptionNotFoundException {
    String email = "test@mail.com";
    UserSubscriptionEntity entity = givenExistingSubscriptionReturningEntity(email, "BASIC", 10);

    whenFindingSubscriptionByUserEmail(email, entity);

    UserSubscriptionModel result = whenFindByUserEmail(email);

    thenSubscriptionShouldHaveCombinationsUsed(result, 10);
    verify(userSubscriptionJpaRepository).findByUserEmail(email);
}