SisterCheck 🩺

SisterCheck is a mobile healthcare app that uses AI to help women understand ovarian cyst risk, get personalised care recommendations, and plan for the financial reality of treatment — built for African healthcare contexts.

📱 Demo

⚠️ The hosted backend is currently offline. The APK can be built locally by following the setup instructions below.

---

✨ Features

• AI Risk Assessment — ML-powered ovarian cyst behaviour prediction
• Care Templates — Personalised treatment plan recommendations
• Cost Planning — Financial breakdown of care options per patient
• Crystal AI — In-app AI chat for health guidance
• Educational Content — Audio lessons and health information
• Clinic Finder — Locate nearby healthcare facilities
• Analytics — Comprehensive health data insights

---

📁 Project Structure

SisterCheck/
├── apps/
│   ├── flutter/          # Flutter mobile application
│   ├── api/              # Node.js REST API
│   └── python/           # Python ML backend
├── docker-compose.yml    # Production Docker Compose
├── docker-compose.dev.yml # Development Docker Compose
├── docker-scripts.sh     # Docker management script
├── nginx/                # Nginx configurations
└── README.md

---

🐳 Quick Start (Docker)

Prerequisites

• Docker and Docker Compose
• Git

git clone https://github.com/Wendyshiro/SisterCheck.git
cd SisterCheck

# Build all services
./docker-scripts.sh build

# Start production environment
./docker-scripts.sh start

Access the app:

• Web App → http://localhost:8080
• API → http://localhost:5000
• ML API → http://localhost:5001

Development (with hot reloading)

./docker-scripts.sh start-dev
./docker-scripts.sh logs-dev

All Docker Commands

Command	Description
./docker-scripts.sh build	Build all images
./docker-scripts.sh start	Start production
./docker-scripts.sh start-dev	Start development
./docker-scripts.sh stop	Stop all services
./docker-scripts.sh logs [service]	View logs
./docker-scripts.sh status	Check service status
./docker-scripts.sh restart <service>	Restart a service
./docker-scripts.sh cleanup	Clean Docker resources

---

🛠️ Manual Setup

Prerequisites

• Node.js 18+ · Python 3.8+ · Flutter 3.0+

# Install all dependencies
npm install
cd apps/api && npm install
cd apps/python && pip install -r requirements.txt
cd apps/flutter && flutter pub get

# Start all services
npm run start:all

---

⚙️ Environment Variables

API (apps/api/.env):

NODE_ENV=production
PORT=5000
MONGODB_URI=mongodb://admin:sistercheck123@mongodb:27017/sistercheck
JWT_SECRET=your-jwt-secret

Python (apps/python/.env):

FLASK_ENV=production
PORT=5001
MONGODB_URI=mongodb://admin:sistercheck123@mongodb:27017/sistercheck

---

🏗️ Architecture

Service	Stack	Port
Mobile App	Flutter	—
REST API	Node.js	5000
ML Backend	Python / Flask	5001
Database	MongoDB	27017
Cache	Redis	6379
Reverse Proxy	Nginx	443 / 8080

---

🔒 Security

• HTTPS with SSL/TLS in production
• JWT authentication
• API rate limiting
• CORS configuration
• Containers run as non-root users

---

📄 License

MIT License — see LICENSE for details.