🚗 Gallery Management System

A comprehensive car gallery management system built with Spring Boot 3.5.6 and Java 21, featuring authentication, sales tracking, and customer management.

🏗️ Technology Stack

• Backend: Spring Boot 3.5.6, Java 21
• Database: PostgreSQL
• Security: Spring Security + JWT
• ORM: Spring Data JPA + Hibernate
• Documentation: Swagger/OpenAPI 3
• Mapping: MapStruct
• Caching: Redis
• Monitoring: Spring Boot Actuator
• Testing: JUnit 5, Mockito, MockMvc

🚀 Features

Core Functionality

• ✅ User Authentication - JWT-based secure authentication
• ✅ Car Management - Add, update, and track cars
• ✅ Customer Management - Customer profiles and accounts
• ✅ Sales Tracking - Complete sales workflow
• ✅ Currency Support - Multi-currency transactions (TL/USD)
• ✅ Audit Trail - Complete audit logging

Technical Features

• ✅ RESTful API - Clean REST endpoints
• ✅ Request/Response Logging - Comprehensive logging
• ✅ Event-Driven Architecture - Asynchronous event processing
• ✅ Caching - Redis-based caching
• ✅ API Documentation - Swagger UI integration
• ✅ Health Monitoring - Actuator endpoints

📋 Prerequisites

• Java 21+
• Maven 3.6+
• PostgreSQL 12+
• Redis 6+ (optional, for caching)

🛠️ Installation & Setup

1. Clone the Repository

git clone <repository-url>
cd gallery

2. Database Setup

-- Create database
CREATE DATABASE postgres;

-- Create schema
CREATE SCHEMA gallery;

3. Configuration

Update application.yml with your database credentials:

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/postgres
    username: your_username
    password: your_password

4. Run the Application

mvn spring-boot:run

📚 API Documentation

Swagger UI

Once the application is running, access the interactive API documentation at:

• Swagger UI: http://localhost:8080/swagger-ui.html
• API Docs: http://localhost:8080/v3/api-docs

Authentication Flow

1. Register a User

POST /register
Content-Type: application/json

{
  "username": "testuser",
  "password": "password123"
}

2. Authenticate

POST /authenticate
Content-Type: application/json

{
  "username": "testuser",
  "password": "password123"
}

Response:

{
  "success": true,
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

3. Use Token in Requests

GET /rest/api/car
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

🔐 Security

JWT Configuration

• Access Token: 2 hours expiration
• Refresh Token: 4 hours expiration
• Algorithm: HS256
• Secret: Configurable via application.yml

CORS Configuration

• Allowed Origins: * (configurable)
• Allowed Methods: GET, POST, PUT, DELETE, OPTIONS
• Allowed Headers: *
• Credentials: Enabled

🧪 Testing

Run Tests

# Run all tests
mvn test

# Run specific test class
mvn test -Dtest=CarServiceTest

# Run with coverage
mvn test jacoco:report

Test Coverage

• Unit Tests: Service layer, Repository layer
• Integration Tests: Controller layer with MockMvc
• Test Coverage: >80% target

📊 Monitoring & Health Checks

Actuator Endpoints

• Health: http://localhost:8080/actuator/health
• Metrics: http://localhost:8080/actuator/metrics
• Info: http://localhost:8080/actuator/info

Logging

• Application Logs: logs/gallery.log
• Log Level: DEBUG (configurable)
• Request/Response Logging: Enabled

🏗️ Architecture

Project Structure

src/
├── main/java/com/ahmetsahin/gallery/
│   ├── config/          # Configuration classes
│   ├── controller/      # REST controllers
│   ├── dto/            # Data Transfer Objects
│   ├── event/          # Event handling
│   ├── exception/      # Exception handling
│   ├── filter/         # Request filters
│   ├── handler/        # Exception handlers
│   ├── jwt/           # JWT utilities
│   ├── mapper/        # MapStruct mappers
│   ├── model/         # JPA entities
│   ├── repository/    # Data repositories
│   └── service/       # Business logic
└── test/              # Test classes

Key Design Patterns

• Repository Pattern - Data access abstraction
• Service Layer - Business logic encapsulation
• DTO Pattern - Data transfer optimization
• Event-Driven - Asynchronous processing
• Audit Pattern - Change tracking

🔧 Configuration

Environment Variables

# Database
SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/postgres
SPRING_DATASOURCE_USERNAME=postgres
SPRING_DATASOURCE_PASSWORD=your_password

# JWT
JWT_SECRET=your_secret_key
JWT_ACCESS_TOKEN_EXPIRATION=7200000
JWT_REFRESH_TOKEN_EXPIRATION=14400000

# Redis (optional)
SPRING_REDIS_HOST=localhost
SPRING_REDIS_PORT=6379

🚀 Deployment

Docker Deployment

FROM openjdk:21-jdk-slim
COPY target/gallery-0.0.1-SNAPSHOT.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app.jar"]

Production Considerations

• Configure proper JWT secrets
• Set up Redis for caching
• Configure database connection pooling
• Set up monitoring and alerting
• Configure log aggregation

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

👨‍💻 Author

Ahmet Şahin

• Email: ahmet@example.com
• GitHub: @sahinahmet

🆘 Support

For support and questions:

• Create an issue in the repository
• Contact: ahmet@example.com

---

Happy Coding! 🚀