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
│ ├─ …