# Homecare EVV Command

Homecare EVV Command is a Laravel/Inertia homecare operations system for
agencies, office branches, clients, caregivers, scheduling, EVV, GPS tracking,
timesheets, reports, call center work, email campaigns, and AI workflow help.

## Documentation

- [Installation guide](docs/INSTALLATION.md)
- [User guide](docs/USER_GUIDE.md)
- [AI Assistant guide](docs/AI_ASSISTANT_GUIDE.md)

The same starter documentation is seeded into the in-app Help Center during
installation, so agency users can search it from Help or ask the AI Assistant.

## cPanel First Run

1. Upload the application files.
2. Point the domain document root to `public`.
3. Make `storage` and `bootstrap/cache` writable.
4. Create an empty MySQL database and database user in cPanel.
5. Copy `.env.cpanel.example` to `.env` if `.env` does not exist.
6. Open the domain. A fresh install redirects to `/install`.

The installer checks PHP requirements, writes database settings, runs migrations,
seeds roles and help documentation, then creates the first Super Admin account.
No manual SQL import is required.

## Local Development

```bash
composer install
npm install
php artisan migrate --seed
npm run dev
php artisan serve --port=8001
```

## Production Build

```bash
npm run build
php artisan config:cache
php artisan route:cache
php artisan view:cache
```

Keep `.env`, `storage`, and uploaded files private. The browser favicon is the
platform brand; agency owners can change the dashboard/login logo from Company
Settings.