A Spring Boot REST API project that provides mathematical operations through RESTful endpoints. This project demonstrates the use of modern Spring Boot features, Swagger documentation, and Docker containerization.

• Java 17
• Spring Boot 3.2.3
• SpringDoc OpenAPI (Swagger) 2.3.0
• Maven
• Docker
• Lombok

• RESTful API endpoints for mathematical operations
• Comprehensive API documentation using Swagger/OpenAPI
• Docker containerization
• Error handling and validation
• Logging using SLF4J with Lombok
• Clean code architecture

src/main/java/com/arjunai/project/
├── ArjunAiProjectApplication.java
├── config/
│   └── SwaggerConfig.java
└── controllers/
    └── MathOperationsController.java

• JDK 17 or higher
• Maven 3.6+
• Docker (optional)

# Clone the repository
git clone <repository-url>
cd arjun-ai-project

# Build with Maven
mvn clean package

java -jar target/arjun-ai-project-1.0.0.jar

# Build Docker image
docker build -t arjun-ai-project .

# Run container
docker run -p 8080:8080 arjun-ai-project

# Addition
curl "http://localhost:8080/api/math/add?a=5&b=3"
# Response: 8.0

# Subtraction
curl "http://localhost:8080/api/math/subtract?a=10&b=4"
# Response: 6.0

# Multiplication
curl "http://localhost:8080/api/math/multiply?a=6&b=7"
# Response: 42.0

# Division
curl "http://localhost:8080/api/math/divide?a=15&b=3"
# Response: 5.0

# Equal split
curl "http://localhost:8080/api/split/equal?amount=100&people=4"
# Response: 25.0

# Split with tip
curl "http://localhost:8080/api/split/with-tip?amount=100&people=4&tipPercentage=15"
# Response: 28.75

The API documentation is available through Swagger UI when the application is running:

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

The API includes comprehensive error handling for:

• Invalid input parameters
• Division by zero
• Invalid number of participants
• Server errors

# Server Configuration
server.port=8080

# Logging Configuration
logging.level.com.arjunai.project=DEBUG

# Swagger Configuration
springdoc.swagger-ui.path=/swagger-ui.html
springdoc.api-docs.path=/v3/api-docs

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

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

Arjun Raju

• GitHub: @arjunraju

For support, please open an issue in the GitHub repository or contact the development team.

This project uses GitHub Actions for CI/CD and deploys to an AWS EC2 Ubuntu instance.

1. AWS EC2 Ubuntu instance
2. Docker Hub account
3. Domain name (optional, for SSL)

Set up the following secrets in your GitHub repository:

DOCKER_HUB_USERNAME
DOCKER_HUB_ACCESS_TOKEN
AWS_HOST
AWS_USERNAME
AWS_SSH_KEY

1. SSH into your EC2 instance:

   ssh -i your-key.pem ubuntu@your-ec2-ip

2. Clone the repository:

   git clone https://github.com/your-username/arjun-ai-project.git
   cd arjun-ai-project

3. Run the setup script:

   chmod +x scripts/setup-ubuntu.sh
   ./scripts/setup-ubuntu.sh

4. Update Nginx configuration:

   sudo nano /etc/nginx/sites-available/arjun-ai-project
   # Update server_name with your domain

5. Set up SSL (if using a domain):

   sudo certbot --nginx

The CI/CD pipeline performs the following steps:

1. Builds the application with Maven
2. Runs tests
3. Builds Docker image
4. Pushes image to Docker Hub
5. Deploys to AWS EC2

The pipeline runs automatically on:

• Push to main branch
• Pull requests to main branch

The application is monitored using:

• Cron job checking container status every 5 minutes
• Automatic container restart on failure
• Nginx as reverse proxy

SSL certificates are managed by Let's Encrypt and auto-renewed by certbot.