add car sharing project

.github/workflows/ci.yml

@@ -0,0 +1,18 @@
+name: Java CI
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up JDK 17
+        uses: actions/setup-java@v3
+        with:
+          java-version: '17'
+          distribution: 'adopt'
+          cache: maven
+      - name: Build with Maven
+        run: mvn --batch-mode --update-snapshots verify

.gitignore

@@ -4,6 +4,9 @@ target/
 !**/src/main/**/target/
 !**/src/test/**/target/
 
+.env
+*.env
+.env*
 ### STS ###
 .apt_generated
 .classpath

Dockerfile

@@ -0,0 +1,14 @@
+FROM openjdk:17-slim AS builder
+WORKDIR application
+ARG JAR_FILE=target/*.jar
+COPY ${JAR_FILE} application.jar
+RUN java -Djarmode=layertools -jar application.jar extract
+
+FROM openjdk:17-slim
+WORKDIR application
+COPY --from=builder application/dependencies/ ./
+COPY --from=builder application/spring-boot-loader/ ./
+COPY --from=builder application/snapshot-dependencies/ ./
+COPY --from=builder application/application/ ./
+ENTRYPOINT ["java", "org.springframework.boot.loader.launch.JarLauncher"]
+EXPOSE 8080

README.md

@@ -0,0 +1,151 @@
+# 🚗 Car-Sharing API
+
+This API is designed to manage a car-sharing service, offering features such as car inventory management, rental processing, user registration, JWT authentication, payment integration with Stripe, and Telegram notifications. It provides a complete solution for building a modern car-sharing platform with role-based access control for users and administrators.
+
+## 🛠️ Technologies & Tools
+- **Core Language**: Java 17
+- **Framework**: Spring Boot 3.4.4 (with Spring Web, Spring Data JPA, Spring Security)
+- **Database**: MySQL 8.0 (with Liquibase for schema migrations)
+- **Payment Processing**: Stripe API
+- **Notifications**: Telegram Bot API
+- **Testing**: JUnit 5, MockMvc, Testcontainers
+- **API Documentation**: Swagger/OpenAPI
+- **Dependency Management**: Maven
+- **Containerization**: Docker, Docker Compose
+- **Object Mapping**: MapStruct 1.6.3
+- **Validation**: Jakarta Validation 3.4.5
+
+## ⚡ Functionality
+The project provides a comprehensive set of features for managing cars, users, rentals, and payments:
+
+**👤 User Management** (`AuthController`, `UsersController`)
+- User registration and authentication with JWT
+- Role-based access control (MANAGER/CUSTOMER)
+- Profile management
+
+**🚗 Car Management** (`CarsController`)
+- CRUD operations for car inventory
+- Car type classification (SEDAN, SUV, HATCHBACK, UNIVERSAL)
+- Inventory tracking
+- Daily fee management
+
+**📅 Rental Management** (`RentalsController`)
+- Create new rentals with inventory checks
+- Return management with inventory updates
+- Rental status tracking (active/returned)
+- Filtering by user and status
+
+**💳 Payment Processing** (`PaymentsController`)
+- Integration with Stripe payment system
+- Payment session management
+- Success/cancel payment handlers
+- Fine calculation for overdue rentals
+
+**🔔 Telegram notifications**
+- New rentals
+- Overdue rentals
+- Successful payments
+
+## 📊 Database Schema
+
+![image](https://github.com/user-attachments/assets/7ca5d4c0-4331-419a-bd03-fd238edc5cff)
+
+
+## 🚀 Getting Started
+
+1️⃣ **Setup**
+
+Clone the repository:
+
+```bash
+git clone https://github.com/trokhim03/CarSharing-API.git
+```
+2️⃣ **Сreate an environment of variables**
+
+Create file .env by copying the content from file .env.sample and fill in the fields.
+
+3️⃣ **Build the project:**
+```bash
+docker build -t name_image_your_app
+```
+4️⃣ **Start the application using Docker Compose:**
+```bash
+docker-compose up
+```
+
+## Connecting to a Custom Database 🗄
+Configure your database connection and application settings by editing the src/main/resources/application.properties file.
+
+```bash
+# Application
+spring.application.name=car-sharing
+server.servlet.context-path=/api
+
+# Database
+spring.datasource.url=${DB_URL}
+spring.datasource.username=${DB_USERNAME}
+spring.datasource.password=${DB_PASSWORD}
+spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
+
+# JPA
+spring.jpa.hibernate.ddl-auto=update
+spring.jpa.show-sql=true
+spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
+
+# JWT
+jwt.secret=${JWT_SECRET}
+jwt.expiration=${JWT_EXPIRATION}
+
+# Stripe
+stripe.secret.key=${STRIPE_SECRET_KEY}
+stripe.public.key=${STRIPE_PUBLIC_KEY}
+stripe.success.url=${STRIPE_SUCCESS_URL}
+stripe.cancel.url=${STRIPE_CANCEL_URL}
+
+# Telegram
+telegram.bot.name=${TELEGRAM_BOT_NAME}
+telegram.bot.token=${TELEGRAM_BOT_TOKEN}
+telegram.bot.chat.id=${TELEGRAM_CHAT_ID}
+```
+The application will be available at http://localhost:8080 (default port)
+
+## 📖 API Documentation
+
+Explore the API endpoints with Swagger UI:
+
+**🔗 [Swagger UI](http://localhost:8080/api/swagger-ui/index.html)**
+
+<img width="1685" alt="Знімок екрана 2025-05-08 о 14 10 15" src="https://github.com/user-attachments/assets/d94f00a9-a52d-4fe0-9211-ff314faf3b84" />
+
+## 🔒 Security
+- JWT authentication for all endpoints
+
+- Role-based authorization
+
+- Password encryption
+
+- Secure payment processing with Stripe
+
+- All sensitive data stored in environment variables
+
+## 📌 Example API Requests
+**Register a new user:**
+
+```bash
+curl -X POST "http://localhost:8080/api/auth/registration" \
+-H "Content-Type: application/json" \
+-d '{
+    "email": "user@example.com",
+    "password": "securePassword123",
+    "repeatPassword": "securePassword123",
+    "firstName": "John",
+    "lastName": "Doe"
+}'
+```
+
+**Get available cars:**
+
+```bash
+curl -X GET "http://localhost:8080/api/cars" \
+-H "Authorization: Bearer your.jwt.token"
+```