# 🚀 MEDIX Q - Docker Quick Start

Get MEDIX Q running in 3 minutes!

## Step 1: Verify Docker is Installed

```bash
# macOS/Linux
./verify-docker.sh

# Windows (PowerShell)
docker --version
docker-compose --version
```

## Step 2: Start the Application

### Option A: Using the Startup Script (Easiest)

**macOS/Linux:**
```bash
./docker-start.sh
```

**Windows:**
```cmd
docker-start.bat
```

### Option B: Using Docker Compose

```bash
docker-compose up -d
```

## Step 3: Access the Application

Open your browser:
```
http://localhost:3000
```

Done! 🎉

---

## 📌 Common Commands

### View Logs
```bash
docker-compose logs -f
```

### Stop Application
```bash
./docker-start.sh stop        # macOS/Linux
docker-start.bat stop         # Windows
```

### View Status
```bash
docker-compose ps
```

### Development Mode (Hot Reload)
```bash
./docker-start.sh dev         # macOS/Linux
docker-start.bat dev          # Windows
```

---

## ❓ Troubleshooting

**Port 3000 already in use?**
```bash
# Edit docker-compose.yml and change:
ports:
  - "3001:3000"
```

**Docker not running?**
- macOS/Windows: Open Docker Desktop
- Linux: Start with `sudo systemctl start docker`

**Build errors?**
```bash
./docker-start.sh rebuild
```

---

## 📖 Full Documentation

See `README_DOCKER.md` for comprehensive setup and advanced options.

---

## 🏥 Features

✅ Healthcare queue management  
✅ Patient management system  
✅ Real-time dashboard  
✅ Doctor workflow  
✅ Medical records  
✅ Analytics & reports  

---

## 💡 Tips

- Data persists in `./data/medix_q.json`
- First startup takes ~5 minutes
- Check `docker-compose.yml` for port/volume configuration
- Use `dev` mode for development with hot reload
- Use production mode for live deployment

---

Happy healthcare management with MEDIX Q! 🏥✨