56 lines
1.2 KiB
Markdown
56 lines
1.2 KiB
Markdown
# 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`
|