HealthLab Management Platform

A lab management system with appointment scheduling, capacity tracking, and digital report delivery. Go/Gin REST API backend with a React TypeScript admin dashboard.

Tech Stack

Go (Gin) PostgreSQL React TypeScript Docker GORM Swagger/OpenAPI
View Live

Project Insights

Challenges

  • Time-slot management with capacity tracking
  • Telegram bot integration for patient notifications

Outcomes

  • Telegram bot for lab test bookings
  • Production-ready API with Swagger documentation
  • Real-time analytics dashboard for lab administrators
  • Docker deployment

Architecture & Design

Problem

Pathology labs struggle with appointment scheduling and patient communication. Manual booking systems lead to:

  • Phone tag - Staff spending hours on calls for simple bookings
  • Double bookings - No real-time capacity tracking across time slots
  • Report delivery delays - Patients calling repeatedly to check if results are ready
  • No centralized dashboard - Lab admins managing everything in spreadsheets or paper

I wanted to build a system where patients could book tests via Telegram (where they already spend time), and lab admins could manage everything through a web dashboard. I got this idea while scheduling a blood test for myself. Labs already have partial digital workflows (WhatsApp reports, phone bookings), but these systems are fragmented.

Constraints

  • Multi-channel booking - Support Telegram bot today, extensible to WhatsApp/Web later
  • Real-time capacity tracking - Prevent overbooking of time slots
  • Secure API - JWT auth for admin dashboard, API keys for bot integrations
  • Production-ready - Dockerized, with proper migrations and Swagger docs
  • Minimal infrastructure - PostgreSQL + single Go binary, no message queues or Redis(for V1 MVP)
For a detailed breakdown of architecture, tradeoffs, and failure modes, see the full case study