Runbook

How to operate

# Spa Assist — FrontDesk Assist (FDA) — Runbook (MVP)

## Local start
1. Create `.env.local` (copy from `.env.example`).
2. Install deps: `npm i`
3. Run: `npm run dev`

## Webhooks (dev)
Expose local server for Twilio:
- `ngrok http 3000`

Configure provider URLs:
- Voice webhook: `POST https://<public>/api/twilio/voice`
- Inbound SMS: `POST https://<public>/api/twilio/inbound-sms`

## Day-to-day operations
- Check `/daily-report` for counts.
- Check `/leads` for new missed calls.
- Use “Send SMS” if auto-send is disabled.

## Data files
- `data/leads.json` — lead state
- `data/outreach_log.jsonl` — outbound log

## Common issues
- Webhook 403/404: confirm path and that tunnel is running.
- Duplicate SMS: confirm idempotency window.