# Branch-specific receipt printing settings — 2026-11-12

## Changes
- Added nullable JSON `branches.receipt_settings` column through migration `2026_11_12_000001_add_branch_receipt_settings`.
- General Settings now displays one receipt configuration form for each active branch assigned to the signed-in user.
- Each branch can configure business name, address, primary/alternative phone, email, website, KRA PIN, M-Pesa Till and Paybill, landmark, receipt header/footer, logo, and print visibility options.
- Branch receipt updates verify that the signed-in user is assigned to the target branch.
- Restaurant POS receipts, bar tab receipts and room payment receipts now resolve receipt identity from the transaction's branch-specific settings, with existing global settings as fallback for branches not yet configured.
- Existing global receipt settings remain available and continue to act as defaults.

## Installation
Back up files and database, upload/extract the ZIP, then run:

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

Ensure the Laravel public storage link exists for branch logo display (`php artisan storage:link` if it has not already been created).

## Validation
- PHP syntax checks passed for changed PHP files and migration.
- ZIP integrity checked after packaging.
- `php artisan view:cache` could not run in the local environment because PHP lacks the `mbstring` extension (`mb_split()` unavailable). Blade rendering and live branch/receipt testing remain necessary.
