diff --git a/README.md b/README.md new file mode 100644 index 0000000..d64af9d --- /dev/null +++ b/README.md @@ -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 + ``` + +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.