# Maree-CareFlow v1.2.20 — cPanel Deployment Package

**Australian Allied Health & NDIS Practice Management Software**

## Quick Start (cPanel Shared Hosting)

### Step 1 — Upload & Extract
1. Log in to cPanel File Manager
2. Navigate to `public_html` (or your subdomain directory)
3. Upload `careflow-cpanel-v1.2.20.zip`
4. Right-click → Extract

### Step 2 — Run the Setup Wizard
1. Open your browser: `https://yourdomain.com/setup_wizard.php`
2. Follow the 5-screen wizard:
   - **Screen 1** — Requirements check (PHP 8.1+, PDO, OpenSSL)
   - **Screen 2** — Database credentials (create DB in cPanel first)
   - **Screen 3** — Application settings (domain, SMTP, licence secret)
   - **Screen 4** — Create admin account
   - **Screen 5** — Complete & launch
3. Delete `setup_wizard.php` after setup

### Step 3 — Post-Install Configuration
1. Log in at `https://yourdomain.com/app/login`
2. Add your licence key at **Admin → Licences**
3. Configure Stripe at **Settings → Billing**
4. Invite practitioners at **Settings → Team**

## Package Contents

```
careflow-cpanel-v1.2.20/
├── backend/          FastAPI application source
├── frontend-src/     React 19 source (pre-built for production)
├── deploy/
│   ├── public_html.htaccess   Apache/LiteSpeed .htaccess
│   └── setup_wizard.php       Browser-based setup wizard
├── .env.example      Environment variable template
└── README.md         This file
```

## Requirements

| Component      | Minimum           | Recommended      |
|----------------|-------------------|------------------|
| PHP            | 8.1               | 8.3              |
| Python         | 3.12              | 3.12             |
| MySQL          | 8.0               | 8.0 LTS          |
| PostgreSQL     | 14                | 16               |
| RAM            | 2 GB              | 4 GB             |
| Disk           | 5 GB              | 20 GB            |
| cPanel version | 106+              | Latest           |

## Support

- **Documentation**: https://maree.careflow.au/docs
- **Email**: support@maree.careflow.au
- **Website**: https://maree.careflow.au

## Licence

© 2026 Maree-CareFlow Pty Ltd. All rights reserved.
Proprietary software. See `LICENCE` for terms.
