# EasyTransport / Advalorem Runtime Notes

## Local PocketBase workflow

1. Bootstrap local DB files from tracked backup:
   - `npm run db:bootstrap`
   - `npm run db:bootstrap:reset` (force overwrite)
2. Start PocketBase on `DB_URL` host/port:
   - `npm run db:start`
3. Start app:
   - `npm run start`

## Advalorem runtime overrides

- `ADV_WORKSPACE_ROOT`: force workspace root for packaged/runtime environments
- Advalorem APIs (`/advalo/*`) run in PocketBase mode by default.
- No `sqlite3` CLI dependency is required for historique/cumul/reporting/export.

## Notes

- `pb_data/*.db*` are local runtime files and are no longer intended to be versioned.
- `src/db/pb_data_backup/` remains the baseline source for local bootstrap.