An open API service indexing awesome lists of open source software.

https://github.com/atlas-b28/final_project_ajd

Final Project AJD
https://github.com/atlas-b28/final_project_ajd

api h2 html-css java javascript maven rest spring springdata-jpa springsecurity6 sql

Last synced: about 2 months ago
JSON representation

Final Project AJD

Awesome Lists containing this project

README

          

# Todo Rails Elite Solution

A Spring Boot-based task management solution with user authentication and authorization features.

## ๐Ÿš€ Features

- User authentication and authorization
- Secure API endpoints
- RESTful API design
- Input validation
- Global exception handling
- JPA for data persistence

## ๐Ÿ› ๏ธ Tech Stack

- **Java 21**
- **Spring Boot 3.3.5**
- Spring Security
- Spring Data JPA
- Spring Validation
- **Maven** - Dependency Management
- **H2 Database** (for development)

## ๐Ÿ“ฆ Prerequisites

- Java 21 or higher
- Maven 3.6.3 or higher
- Your favorite IDE (IntelliJ IDEA, Eclipse, or VS Code)

## ๐Ÿš€ Getting Started

### Running the Application

1. Clone the repository:
```bash
git clone
```

2. Navigate to the project directory:
```bash
cd solution
```

3. Build the project:
```bash
./mvnw clean install
```

4. Run the application:
```bash
./mvnw spring-boot:run
```

The application will start on `http://localhost:8080` by default.

## ๐Ÿ”’ Authentication

The application uses JWT (JSON Web Tokens) for authentication. Include the token in the `Authorization` header for authenticated requests:

```
Authorization: Bearer
```

## ๐Ÿ“š API Documentation

API documentation is available at:
- Swagger UI: `http://localhost:8080/swagger-ui.html`
- OpenAPI JSON: `http://localhost:8080/v3/api-docs`

## ๐Ÿงช Testing

Run the test suite with:

```bash
./mvnw test
```

## ๐Ÿ™ Acknowledgments

- Spring Boot Team
- Open Source Community