Initialize Backend
Generate a new backend application using the SOKit Initializer
Step 1: Open the Initializer
Navigate to the SOKit Initializer web interface by visiting:
http://dev.strategyobject.com:8888/initializer/
Here, you’ll be able to generate a new backend project based on available templates.
Step 2: Select a Backend Template
Select the template "SOKit-Document-OIDC-Postgres" and complete the fields on the right as shown in the previous screenshot.
Step 3: Generate and Extract the Project
Click Generate Template and download the archive.
- Extract the archive to your preferred workspace directory.
- Open the extracted folder using your IDE or terminal.
Your project structure will resemble the following:
By exploring the project structure, you’ll notice that it is divided into three main sections: data, document, and src. These correspond to the data layer, document definition, and business logic, respectively. Each of these areas will be explored in more detail in the upcoming sections.
As you can see, some Java classes are already present. In the next steps, we’ll create new ones, starting with the data module where we’ll define our custom entities. You may also remove any pre-existing entities if they are not needed.
As for the document module, you can safely delete the following files, we’ll recreate them step by step during the guide:
- /filter/DefaultFilter.java
- Operations.java
- OrderDocument.java
- StartOperations.java
- States.java
Ports, Instances, Consoles, and User Accounts
In the table below you can find Ports and Instances:
| Service Name | Port | User Accounts | Instances |
|---|---|---|---|
| Postgres | 5432 | so/so123 | DB Name: postgres |
| Keycloak Postgres | 6432 | kc/kc123 | DB Name: postgres |
| Minio | 6061 | mio/mio123 | Bucket Name: dev |
| Maildev (Fake SMTP) | 1025 | N/A | N/A |
Here below Consoles and User Accounts:
| Service Name | URL | User Accounts |
|---|---|---|
| SOKit Initializer | http://dev.strategyobject.com:8888/initializer/ | N/A |
| Keycloak Console | http://dev.strategyobject.com:6060 | kc/kc123, alice/123, bob/123 |
| Minio Console | http://dev.strategyobject.com:6062 | minio/minio123 |
| Maildev (Fake SMTP) | http://dev.strategyobject.com:1080/ | N/A |