Multi-channel AI-powered healthcare triage platform for low-resource environments
# FirstLine Healthcare Triage Platform
> Multi-channel AI-powered clinical decision-support system for low-resource environments
## π― Overview
FirstLine functions as a digital medical call center with one central AI brain accessible through multiple channels:
- **π± Smartphone Application**: Full-featured app with offline capability
- **π Toll-free Voice Calls**: Natural language voice interaction via IVR
- **π¬ USSD/SMS**: Feature phone support for maximum accessibility
- **π₯οΈ Web Dashboard**: Clinician and administrator interfaces
The platform collects patient symptoms, applies medical reasoning using AWS Bedrock and WHO-style guidance, assigns triage levels (RED/YELLOW/GREEN), and provides safe care instructions with referral documents.
## π Quick Start
### For AIdeas 2026 Competition
See **docs/aideas-2026/** for complete submission materials.
**Quick Links:**
- Quick Start Guide - 2-hour deployment
- AWS Migration Guide - GCP to AWS
- Deployment Script - Automated setup
### Standard Installation
```bash
# Install dependencies
npm install
# Build backend
npm run build
# Deploy to AWS
cd infrastructure
npx cdk deploy
# Or run locally
npm start
```
## ποΈ Architecture
### AWS Deployment (Primary)
- **Backend**: TypeScript/Node.js Lambda functions
- **API**: API Gateway REST API
- **Database**: DynamoDB (single-table design)
- **Storage**: S3 for referral documents
- **AI Engine**: AWS Bedrock (Claude Haiku)
- **Monitoring**: CloudWatch logs and metrics
- **Infrastructure**: AWS CDK (TypeScript)
### GCP Deployment (Legacy)
- **Backend**: Cloud Run
- **Database**: Firestore
- **Storage**: Google Cloud Storage
- **AI Engine**: Vertex AI (MedGemma)
### Frontend
- **Web Apps**: React 18 + TypeScript + Vite
- **Mobile**: React Native
- **UI Library**: Material-UI
## π Project Structure
```
.
βββ src/ # Backend source code
β βββ handlers/ # Lambda function handlers
β βββ services/ # Business logic services
β ββ β¦