Welcome to the Compulyx Backend Project! This guide will help you get the project up and running quickly.
Before you start, ensure you have the following:
- Java 17 or later installed on your computer.
- Postman installed for API testing.
-
Download the Project:
- Click the green "Code" button above and choose "Download ZIP".
- Extract the downloaded ZIP file to a convenient location.
-
Run the Project:
- Open a terminal or command prompt.
- Navigate to the project directory (where the
pom.xml
file is located).
-
Run the Project with Maven:
- Run the following command to start the project with the embedded H2 in-memory database:
mvn spring-boot:run
- Run the following command to start the project with the embedded H2 in-memory database:
-
Explore the APIs:
- Open Postman.
- Import the Postman Collection provided with this project.
- Use the imported collection to test available endpoints, see example request and response formats.
-
API Testing Tools: You can use tools like Postman to test APIs interactively.
-
Logging: The project logs API requests and responses. Follow these steps to create the log directory:
- Windows Users:
- Open the File Explorer.
- Navigate to the
C:\
drive. - Create a new folder named
var
(if not already present). - Inside the
var
folder, create a new folder namedlog
. - Inside the
log
folder, create a new folder namedapplications
. - Inside the
applications
folder, create a new folder namedAPI
. - Inside the
API
folder, create a new folder namedlogs
. - The complete path should be:
C:\var\log\applications\API\logs
. - This is where you'll find the log files:
request.log
andresponse.log
after you interact with the APIs on Postman
- Windows Users:
-
Security: The project uses JWT-based security. You don't need to configure it, but it's there to protect the APIs.