FindDoctors Aggregator Server
FindDoctors Aggregator Server Link to heading
Unified search backend for Greek public health appointments
Overview Link to heading
High-performance Go backend that aggregates appointment availability from finddoctors.gov.gr, making it easier to discover where and when public health appointments are available across hospitals and primary care centers.
The Problem Link to heading
The official platform makes it difficult to search across different public health entities, regions, and appointment dates at once.
The Solution Link to heading
Built a concurrent aggregator API that searches multiple entities in parallel, returns the soonest available appointments, and is designed to power a future patient-facing UI for booking faster when availability exists.
Key Features Link to heading
- Unified Smart Search - A single
/api/searchendpoint for soonest appointments with optional distance and region filters - Cross-Entity Search - Searches public hospitals and primary health centers concurrently
- Distance-Aware Results - Supports location-based filtering and proximity sorting
- Capacity Reports - Shows fill rates and earliest availability per specialty for a hospital
- Granular Slots - Fetches appointment times, doctor names, clinic metadata, and unit details
- Type Safety - Generates TypeScript types from Go models with
tygo - TDD-Backed Core - Tests cover the search and sorting logic
Technical Implementation Link to heading
Architecture Link to heading
The backend works as a read-only aggregator in front of the official appointment system. It does not store user cookies or appointment session data; it focuses on stateless discovery.
| Area | Implementation |
|---|---|
| Backend | Go HTTP server |
| Search | Concurrent worker pool |
| Entities | Public hospitals and primary care centers |
| API | REST endpoints |
| Types | Go to TypeScript generation via tygo |
| Testing | Go tests with race detection |
Core Endpoints Link to heading
| Endpoint | Purpose |
|---|---|
/api/search | Find the soonest available appointment by specialty, region, and distance |
/api/hospitals/{hunitId}/capacity | Inspect hospital specialty capacity and first available dates |
/api/hospitals/{hunitId}/slots | Fetch detailed appointment slots for a unit, specialty, and date |
/api/specialties | Discover available medical specialties |
Product Direction Link to heading
The backend is designed as the foundation for a UI that helps patients answer the question that matters most:
Is there an appointment available, where is it, and how soon can I book it?
The intended user experience is fast, practical, and patient-centered: enter a specialty and location, see the nearest or soonest useful options, and avoid repeated manual searches across the public platform.