# Showcase Automation Scripts

This directory contains local-only automation for regenerating public showcase assets.

Currently implemented:

- `capture-screenshots.js`: captures the reusable screenshot set into `assets/screenshots/`.

Planned later:

- a video/demo recorder script can be added here with the same environment conventions.

## Screenshot Prerequisites

The script does not start any Qlockify services. Start them before running it:

- frontend: `http://localhost:5173`
- backend: `http://localhost:8000`
- database/Redis/Celery as required by your normal local app setup

Install Playwright for the script:

```powershell
cd scripts
npm install
```

If Playwright cannot find a browser, either install Chromium:

```powershell
npx playwright install chromium
```

or point the script to your installed Chrome:

```powershell
$env:QLOCKIFY_CHROME_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"
```

## Capture Public And App Screenshots

From the showcase repo root:

```powershell
node scripts/capture-screenshots.js
```

Or from the `scripts` directory:

```powershell
npm run screenshots
```

By default, the script deletes old `.png` files from `assets/screenshots/` first. Disable that with:

```powershell
$env:QLOCKIFY_CLEAN_SCREENSHOTS="0"
node scripts/capture-screenshots.js
```

## Capture Admin Screenshots

Admin screenshots are optional. When enabled, the script creates/updates a local superuser fixture and logs into Django admin.

```powershell
$env:QLOCKIFY_CAPTURE_ADMIN="1"
$env:QLOCKIFY_ADMIN_USERNAME="09900000000"
$env:QLOCKIFY_ADMIN_PASSWORD="QlockifyLocalAdmin!2026"
node scripts/capture-screenshots.js
```

If demo creation is rate-limited, the script falls back to the latest active local demo environment through Django shell. For that fallback and admin fixture setup, it needs the backend repo path:

```powershell
$env:QLOCKIFY_BACKEND_REPO="D:\Programing\Scripts\Qlockify\qlockify-backend"
```

## Environment Variables

- `QLOCKIFY_FRONTEND_URL`: frontend URL, default `http://localhost:5173`.
- `QLOCKIFY_BACKEND_URL`: backend URL, default `http://localhost:8000`.
- `QLOCKIFY_BACKEND_REPO`: local backend repo path, default `../qlockify-backend`.
- `QLOCKIFY_DEMO_TOKEN_FILE`: optional JSON file with `access`, `refresh`, `workspace_id`, and `expires_at`.
- `QLOCKIFY_CAPTURE_ADMIN`: set `1` to capture Django admin screenshots.
- `QLOCKIFY_ADMIN_USERNAME`: local admin login mobile.
- `QLOCKIFY_ADMIN_PASSWORD`: local admin password.
- `QLOCKIFY_ADMIN_USER_ID`: optional user id for the admin user-detail screenshot; defaults to the demo owner when available.
- `QLOCKIFY_CHROME_PATH` or `CHROME_EXECUTABLE`: optional installed Chrome path.
- `QLOCKIFY_CLEAN_SCREENSHOTS`: set `0` to keep existing PNG files before capture.