eshunvera62-source/AccraCare

AccraCare is a serverless hospital appointment booking platform for Ghana, built with API Gateway, Lambda, and DynamoDB. Patients browse and book available slots across hospitals in Accra, with atomic seat locking to prevent double-booking, and an admin portal for managing slots and bookings. # AccraCare — Serverless Hospital Appointment Booking System Capstone project for the Generation Ghana / Azubi Africa AWS Cloud Computing Programme. AccraCare replaces manual appointment booking (paper forms / spreadsheets) with a scalable serverless REST API backed entirely by AWS managed services, deployed with AWS SAM (CloudFormation). **🔗 Live Demo:** dvm40sl310hkp.cloudfront.net --- ## Table of Contents - AccraCare — Serverless Hospital Appointment Booking System - Table of Contents - Tech Stack - Quick Start - Problem Statement - Architecture - Screenshots - Architecture diagram - Cloudformation stack - SNS - Homepage or frontend ui - Book Appointment - Dynamo db slots - Lambda delete booking - Cloudwatch lambda logs - REST API Endpoints - Project Layout - File \& Folder Reference - Phase Deliverables Checklist - Phase 1 — Infrastructure Foundation - Phase 2 — API Development - Phase 3 — Automation \& CI/CD - Phase 4 — Monitoring \& Security - Phase 5 — Deployment \& Optimisation - AWS Deployment Guide - Local Development - GitHub Actions Secrets Required - Security Hardening - Authentication \& Authorization - Data Protection - CORS Hardening - Input Validation \& Injection Prevention - Cryptography - Rate Limiting \& Throttling - Known Limitations - Roadmap / What's Next - Built With / Acknowledgements --- ## Tech Stack - **Node.js 22** — TypeScript Lambda handlers (deployed) - **Python 3.12** — Python Lambda handlers (deployed) - **AWS Lambda** — serverless compute - **API Gateway** — REST API with CORS, throttling, access logging - **DynamoDB** — NoSQL database with GSIs, TTL, PITR, SSE-KMS - **S3** — static frontend hosting (SSE-S3 encrypted, versioned) - **CloudFront** — CDN with HTTPS enforcement - **SNS** — email confirmations and operational alerts - **CloudWatch** — logs, alarms, dashboard - **AWS SAM / CloudFormation** — infrastructure as code - **GitHub Actions** — CI/CD pipeline --- ## Quick Start ```bash # 1. Build sam build …