Skip to content

Commit

Permalink
Create README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Faisal-Sey committed Feb 8, 2024
1 parent c31d867 commit 7cbf0e0
Showing 1 changed file with 61 additions and 0 deletions.
61 changes: 61 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# Contact Management System - Spring Boot

This project is a Contact Management System built using Spring Boot, designed to efficiently manage contacts and provide CRUD (Create, Read, Update, Delete) operations via RESTful API endpoints.

## Overview

The Contact Management System allows users to perform various operations on contacts, including creating new contacts, retrieving existing contacts, updating contact information, and deleting contacts. The system provides functionalities such as search, pagination, and sorting to enhance the user experience.

## Features

- **CRUD Operations**: Perform Create, Read, Update, and Delete operations on contacts.
- **Search**: Search for contacts based on firstName, lastName, email, or phoneNumber.
- **Pagination**: Navigate through paginated results for better organization and efficiency.
- **Sorting**: Sort contacts based on different fields in ascending or descending order.
- **Detailed Endpoint Documentation**: Comprehensive documentation of API endpoints provided via Postman.

## Documentation

For detailed documentation and usage instructions, please refer to the [Postman documentation](https://documenter.getpostman.com/view/12600570/2s9YyzbHBK). The documentation provides information about each endpoint, including request parameters, responses, and sample requests.

## Getting Started

To get started with the Contact Management System, follow these steps:

1. Clone the repository to your local machine:

```bash
git clone <repository-url>
```

2. Navigate to the project directory:

```bash
cd contact-management-system
```

3. Build the project using Maven:

```bash
mvn clean package
```

4. Run the project using Java 17:

```bash
java -jar target/contact-management-system.jar
```

5. Access the API endpoints using tools like Postman or integrate them into your application.

## Contributing

Contributions to the Contact Management System are welcome! If you find any bugs or have suggestions for improvements, please submit an issue or pull request on GitHub.

## License

This project is licensed under the [MIT License](LICENSE).

---

Thank you for using the Contact Management System! If you have any questions or need further assistance, feel free to reach out.

0 comments on commit 7cbf0e0

Please sign in to comment.