Health Information System

Technologies used

• Golang 1.24 https://go.dev/dl/
• Make https://www.gnu.org/software/make/
• PostgreSQL https://www.pgadmin.org/download/
• Docker https://docs.docker.com/desktop/
• Air (live reload) https://github.com/air-verse/air

Powerpoint presentation: https://docs.google.com/presentation/d/13AXW5XdrwVaTFrY5SfnqQbtQ2RmhCLUZSyFV4tloCIc/edit?usp=sharing

Database design: https://github.com/wathika-eng/hims/blob/main/drawSQL-image-export-2025-04-27.png

API testing: https://www.postman.com/wathika/workspace/hims/collection/34083824-6c634517-02b7-4dfa-bbc0-fb585679cc2c?action=share&creator=34083824&active-environment=34083824-cb65b2c7-8738-47f7-8808-11bf34479d7c

Live API: http://159.89.7.122:8000

Setup local development

Ensure Make, Go, PostgreSQL, and Docker are installed on your machine. Without Make and Docker, you can't run the application.

1. Clone the repository

   git clone https://github.com/wathika-eng/hims --depth 1
   # cd into the directory 
   cd hims

2. Install dependencies

   make deps
   # or with go
   go mod tidy

3. Create a .env file

    cp .env.example .env
    cp .env.example .env.local
    # edit the .env with your credentials

4. Create a PostgreSQL database

   # create a database with the name in .env
   createdb -U postgres -h localhost -p 5432 hims

5. Run the application with live reload

   # go install github.com/air-verse/air@latest
   air

Then test the endpoint:

curl localhost:8000/api/v1/health

HTTP/1.1 200 OK
Date: Mon, 02 Jun 2025 07:27:43 GMT
Content-Type: application/json
Content-Length: 226
X-Xss-Protection: 1
X-Content-Type-Options: nosniff
X-Frame-Options: SAMEORIGIN
Cross-Origin-Embedder-Policy: require-corp
Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Resource-Policy: same-origin
Origin-Agent-Cluster: ?1
Referrer-Policy: no-referrer
X-Dns-Prefetch-Control: off
X-Download-Options: noopen
X-Permitted-Cross-Domain-Policies: none
Vary: Origin
X-Ratelimit-Limit: 20
X-Ratelimit-Remaining: 1
X-Ratelimit-Reset: 1

{
    "data": {
        "Idle": "1",
        "InUse": "0",
        "MaxIdleClosed": "0",
        "MaxLifetimeClosed": "0",
        "MaxOpenConnections": "0",
        "OpenConnections": "1",
        "WaitCount": "0",
        "WaitDuration": "0s"
    },
    "time": "2025-06-02 10:27:43.829031032 +0300 EAT m=+135.523468725"
}

6. With docker:

   COMPOSE_BAKE=true docker-compose up -d
   # or
   make docker-build
   make docker-run

Resources used

https://12factor.net/

https://bun.uptrace.dev/guide/golang-orm.html

https://testcontainers.com/guides/getting-started-with-testcontainers-for-go/

Tests