# Branch receipt settings database repair — 2026-11-12

This package corrects the earlier compatibility migration's malformed PHP namespace
imports and adds a later idempotent migration. The later migration is intentional:
it will run even if an earlier receipt-settings migration was already recorded in the
Laravel `migrations` table while the actual `branches.receipt_settings` column is absent.

After uploading/extracting the package into the Laravel project root, run:

```bash
php artisan migrate --force
php artisan migrate:status
php artisan optimize:clear
```

Confirm the output reports the new `2026_11_12_000003_repair_branch_receipt_settings_column`
migration as Ran. If it reports Pending, the migration has not been executed. If it
reports Ran but the column is still absent, confirm the cPanel terminal is using the
same `.env` and database as the website. Do not manually edit the migrations table.

Optional MySQL verification:

```sql
SHOW COLUMNS FROM branches LIKE 'receipt_settings';
```

The migration only adds the nullable JSON column when it is missing and does not
overwrite branch receipt data.
