# Quickstart — 099 Alerts v1 (Teams + Email)

This quickstart is for developers working on the Alerts v1 implementation.

## Prereqs

- Start Sail: `vendor/bin/sail up -d`
- Install deps (if needed): `vendor/bin/sail composer install`

## Database

- Run migrations: `vendor/bin/sail artisan migrate`

## Queue

Alerts delivery is queued. Ensure a worker is running:

- `vendor/bin/sail artisan queue:work`

Default queue connection is `database` (see `config/queue.php`).

## Email configuration

Configure mail in `.env` (examples):

- `MAIL_MAILER=smtp`
- `MAIL_HOST=...`
- `MAIL_PORT=...`
- `MAIL_USERNAME=...`
- `MAIL_PASSWORD=...`
- `MAIL_ENCRYPTION=tls`
- `MAIL_FROM_ADDRESS=...`
- `MAIL_FROM_NAME=TenantPilot`

## Teams webhook configuration

Create a Teams incoming webhook URL and store it via the Alerts → Targets UI.

Note: Webhook URLs are treated as secrets and must not appear in logs or audits.

## Running tests

Run focused tests as they’re added:

- `vendor/bin/sail artisan test --compact --filter=Alerts`

Or by file:

- `vendor/bin/sail artisan test --compact tests/Feature/...`

## Formatting

Before finalizing changes:

- `vendor/bin/sail bin pint --dirty`