This project creates a JSON API around patient records. The write API implements event sourcing based on these immutable patient events - admit patient, transfer patient, discharge patient, update patient name and update patient age. These events are aggregated asynchronously to generate a most recent patient record in the database. The read API just queries the database for these generated record(s).

Run the following steps to build/run the application -

1. cp .env.example .env
2. docker compose up --build -d

Now, docker containers for postgresql server, temporal server and the application server should be up and running and you can play with the API endpoints.

You can also access temporal web ui at this address: http://localhost:8080 and see which workflows are being executed.

1. Run cp .env.example .env command and set the environment variables for postgresql and temporal in the .env file.
2. Build command - go build -o api ./cmd/server
3. Run command - ./api

Now, application server should be up and running and you can play with the API endpoints.

Note: This manual build/run requires pre-running instances of Temporal and PostgreSQL. The application server will connect with these instances.

Base URL: http://localhost:3001

The API exposes the following endpoints -

Admit New Patient

POST /patient/admit

Request Body

{
    "name": "Foo Name",
    "ward": 10,
    "age": 25
}

The response contains id field which is the ID for new patient.

Transfer Patient to Ward

POST /patient/transfer

Request Body

{
    "id": "<patient-id-here>",
    "ward": 11
}

Discharge Patient

POST /patient/discharge

Request Body

{
    "id": "<patient-id-here>",
}

Update Patient Name

POST /patient/updateName

Request Body

{
    "id": "<patient-id-here>",
    "name": "New Foo Name",
}

Update Patient Age

POST /patient/updateAge

Request Body

{
    "id": "<patient-id-here>",
    "age": 30,
}

Get All Patients

GET /patient/all

Get Patient By ID

GET /patient/id/<patient-id-here>

Get Patient By Name

GET /patient/name/<patient-name>