- Add branch_id accessor to User model (resolves from role_user pivot)
- Create AppliesRoleScope trait for one-liner scope enforcement
- Enhance PermissionService: include head_trainer_id in group lookup,
  add training_programs and invoices table support for own_groups scope
- Apply AppliesRoleScope to 16 list components:
  ParticipantList, GroupList, EnrollmentList, AttendanceList,
  InvoiceList, ProgramList, EvaluationList, CashSessionList,
  WalletList, AssignmentList, PersonList, FacilityList,
  ProductList, PurchaseOrderList, KitList, StockCountList

Now trainers only see their assigned groups/participants,
branch managers only see their branch data, parents only
see their children, and receptionists are branch-scoped.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Detect on mount if user already has Trainer/Employee/Guardian records
- Show green notice when record exists, amber warning when role implies
  record but none exists (orphan state)
- Allow entity creation on save even without role change when entities
  are missing (repair orphaned users from before the redesign)
- Disable create toggles when record already exists to prevent duplicates
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- CreateTrainerWizard: 9-step flow with activities, user account creation,
  and initial group assignment (was 6 disconnected steps)
- CreateProgramWizard: 7-step flow with head trainer, schedule template,
  initial group, BasePrice record, facility (was 4 steps, no group/trainer)
- NewRegistrationWizard: add parent account creation step so guardians
  can log in to the Parent Portal immediately
- UserForm: role-aware prompts — assigning trainer role creates
  Trainer+Employee records, parent role links Guardian, staff creates Employee
- EnrollmentForm: 3-panel guided experience with group cards, capacity bars,
  live price preview from PricingService, and schedule conflict detection
- TrainerCredentialsGenerated event for async email delivery

Closes the "isolated CRUD screens" problem — every entity creation now
handles the full business workflow in a single transaction.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- PurchaseOrderList: status filter, receive/cancel actions
- KitList + KitForm: CRUD with dynamic components, assemble/disassemble
- StockCountList + StockCountForm: warehouse picker, variance display
- Register routes for all new inventory components
- config/mail.php: add SSL stream options for self-signed cert bypass
- Update gap-analysis.md to mark completed items
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Multi-tenant public website system: each academy gets a data-driven advertising
site at /site/{slug} with 16 customizable sections, theme editor, gallery,
testimonials, FAQ, news, partners, and contact form management.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

4 tiers in EGP: نسبة فقط (Free/12%), المبتدئ (1000/7.5%), المؤسسي (3500/5%),
الاحترافي (10000/3.5%). Interactive slider shows total cost based on monthly
collections volume, highlights the best-value plan dynamically.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

1. User form: add hint that email is used as login username
2. Dashboard low stock widget: only show products below min_stock_level (was showing all)
3. Dashboard attendance widget: link to filtered view showing only sessions without attendance
4. Trainer form: require at least one activity selected (validation + UI)
5. Cross-reference: show activities on trainer list, show trainers on activity cards
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Laravel 13 base Controller has no AuthorizesRequests trait.
Use Gate::authorize() facade instead.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Without branch filtering, the collection rate showed global stats even
when viewing a specific branch. Now filters invoices by branch via
their associated payments.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

The revenue query filtered by invoice_items.branch_id which doesn't
exist, causing 0 results when a branch is selected. Use
payments.branch_id directly since payments already track their branch.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

The template variable display used nested {{ '{{' }} syntax which
confused Blade's compiler, causing an "Unclosed '(' does not match '}'"
error. Use string concatenation with {!! !!} to output literal braces.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

11 Livewire screens: Home dashboard, Schedule (weekly), Attendance (monthly),
Finances (invoice list + detail), Profile, Child Detail (with tabs),
Evaluation Detail, Excuse Form, Notifications, and Programs browser.
Custom parent layout with fixed bottom nav bar (5 tabs).
Redirect parent role login to new portal.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Dashboard:
- Primary action (new registration) is now a full-width hero card
- Secondary actions are a compact 2x2 icon grid

Registration wizard:
- Mobile step indicator: compact progress bar + step name instead of
  cramped 5-circle stepper
- Sticky bottom nav bar on mobile (fixed position, safe-area aware)
  so Back/Next are always reachable without scrolling
- Activity selection uses horizontal scrollable pills on mobile
- Desktop layout remains unchanged (sm: breakpoint gates all changes)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

New instances and the service fallback now default to the academy paying
the platform fee rather than adding it to the client's invoice.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

GroupStatus is a backed enum — need ->value to get the string for __().
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

The SystemSettingsForm only displayed settings already in the DB, so
platform_fee_customer_pays was invisible. Switched the route to use the
schema-driven Admin\SystemSettings component which always renders all
defined settings with their defaults.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Quick actions now includes: new registration, enroll existing, collect
payment, attendance. Below it a full "Creation Wizards" grid with buttons
for every wizard (program, group, transfer, invoice, facility, employee,
trainer, pricing rule, product, stock adjustment, cash session, setup).
Each button is permission-gated and uses wire:navigate.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- CreateProductWizard: fix permission mismatch (products.create→inventory.create),
  add SKU uniqueness validation, redirect to list after success instead of dead-end
- ProductForm: set branch_id on new products
- ProductList: fix dynamic Tailwind classes (use full class strings for JIT)
- GroupList: fix dynamic Tailwind status badge classes
- POSTerminal: remove dead addProgram() method and unused imports
- CSS: add safelist comment for dynamic color classes used via Blade interpolation
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- POS Terminal now shows products tab with addProduct() method
  (programs are enrolled via receptionist desk, not POS)
- Product list and POS show branch products + academy-wide (null branch)
- CreateProductWizard and ProductForm now set branch_id on create
- Product model gets ManglesUniqueOnDelete for SKU collision prevention
- Clicking a product in POS adds it to cart (or increments qty if exists)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add ManglesUniqueOnDelete trait that appends a timestamp suffix to unique
fields (code, slug, sku, employee_number) when a record is soft-deleted,
freeing the value for new records. Also make group code generation
collision-resistant by checking withTrashed().
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Programs: activate (draft/closed→active), close (active→closed)
Groups: activate (forming/on_hold→active), pause (active→on_hold)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- GroupSchedulePrintController used $this->authorize() but Laravel 13's base Controller has no AuthorizesRequests trait — switched to Gate::authorize()
- Added deleteGroup() to GroupList with full cascade: sessions (attendance auto-cascades), schedules, enrollments, waitlists, then the group itself
- Delete button with wire:confirm for Arabic confirmation prompt, gated behind groups.delete permission
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

1. ProgramForm now passes status to service — programs default 'active'
   (the property was set but never included in the data array, so the DB
   default 'draft' won)

2. Receptionist wizard now finds groups with branch_id=NULL (academy-wide
   programs) alongside branch-specific ones. Previously only exact branch
   match was checked, hiding programs created without a branch.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Programs with branch_id=NULL are academy-wide — they should be visible
regardless of which branch is selected. The filter now uses
WHERE branch_id = X OR branch_id IS NULL.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

training_groups.code is NOT NULL — the auto-created default group was
missing it, causing a constraint violation.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

The seeder was trying to set branch_id on the user, but that column
doesn't exist on the users table (it's on participants/payments).
Removed the branch assignment and unused Branch import.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

The academy identity is now established by the seeder (from ACADEMY_NAME_EN,
ACADEMY_NAME_AR env vars). The wizard no longer has an "Academy Profile" step.
It starts directly at Branches (step 1) and only configures operational data:
branches, activities, programs, facilities, groups, staff, settings.

This enforces one-academy-per-instance: the academy exists before the wizard
runs, and no user action can create or duplicate it.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

DatabaseSeeder now uses Academy::first() — never creates duplicates. If
the wizard already created an academy, the seeder respects it and just
ensures the env-var admin user is super_admin on that academy.

FinancialAccountsSeeder no longer has a hardcoded 'el-captain' fallback;
it skips gracefully if no academy exists yet.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- UsesBranchScope falls back to withoutGlobalScopes if no branch found in current academy
- Shows proper error message instead of TypeError when no branch exists
- DatabaseSeeder assigns branch_id to admin user on every seed run
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- RolesAndPermissionsSeeder: seed roles for ALL academies (not just hardcoded 'el-captain' slug)
- PermissionSeeder: assign permissions to all role instances per slug (across academies)
- DatabaseSeeder: look for owner role in user's academy first, always set is_super_admin

Root cause: wizard-created academy had different slug than seeder expected, so roles/permissions
were never created for it, leaving the admin user with no permissions (403 on dashboard).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Fix setup wizard CHECK violation: tax_percentage type 'number' → 'integer'
- Programs now default to 'active' status (not 'draft')
- Auto-create first group when program is created via TrainingProgramService
- Enable auto_create_groups_enabled setting in wizard for overflow auto-creation
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Reads ADMIN_EMAIL, ADMIN_PASSWORD, ADMIN_NAME, ACADEMY_NAME_EN,
ACADEMY_NAME_AR from env — set by the manager during provisioning.
Falls back to defaults for dev environments.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- key:generate needs an APP_KEY= line in .env to write to (even empty)
- Replace el-captain:setup (doesn't exist) with db:seed
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

CapRover passes env vars as container environment, but Laravel's
config:cache reads from .env file. Must dump env to .env first,
then generate APP_KEY if missing.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Registration wizard now opens /invoices/{uuid}/print in new tab instead of printing whole page
- Print view redesigned: mobile-responsive layout, touch-friendly 48px buttons, proper viewport
- Share button (Web Share API) shows on mobile devices that support it
- Print-receipt-button component changed from window.open popup to target=_blank link
- Added min-height 48px to all action buttons for touch accessibility
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Remove 23 hardcoded business decisions: all financial/operational behaviors now configurable per-academy

Every penalty, compensation, auto-invoice, and automation is now guarded by a
SettingsService toggle (default OFF for financial, ON for operational). Added
88 system settings across 8 groups with Arabic labels, conditional UI visibility
for dependent fields, and a new "رواتب وتعويضات" admin tab.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Money flows:
- Payslip paid → double-entry financial transaction (debit salary expense / credit cash)
- POS sale → inventory movements for tracked products
- Enrollment → auto-invoice via PricingService
- Invoice overdue detection enhanced with balance guard

Operational events (previously empty → now wired):
- AssignmentCreated → generate trainer attendance expectations
- AssignmentEnded → remove future trainer attendance
- FacilityStatusChanged → cancel reservations on maintenance
- PurchaseOrderReceived → create receiving inventory movements
- StockCountCompleted → process count adjustments
- KitAssembled → deduct component stock
- InventoryMovementCreated → check low stock threshold

Business rule enforcement:
- Medical certificate enforcement at attendance time (configurable)
- Group capacity check + auto-waitlist on enrollment
- Participant status blocking (frozen/suspended can't enroll)
- Attendance threshold from settings (not hardcoded)

Dashboard rebuilt with actionable data:
- Today's sessions, trainers present, payments, active participants
- Needs-attention cards (overdue invoices, pending approvals, expired docs)
- Today's schedule with take-attendance buttons
- Recent payments feed + quick action buttons

Scheduled jobs:
- attendance:auto-absent (hourly)
- documents:expire (daily 06:00)
- payments:detect-defaults (daily 08:00)
- attendance:send-alerts (daily 20:00)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Complete trainer compensation lifecycle:
- 7 migrations (trainer_compensations, payroll_periods, payslips, payslip_items, trainer_advances, trainer_rate_history + make employee_id nullable for freelancers)
- 7 enums, 6 models with proper relationships
- CompensationCalculatorService: auto-calculates session/player/revenue/penalty earnings
- PayrollService: period management, bulk payslip generation, approval workflow, payment recording
- TrainerAdvanceService: salary advance/loan lifecycle with installment tracking
- Event listeners: AttendanceMarked → auto-compensation, SessionCancelled → trainer pay
- 4 Livewire pages: PayrollDashboard, TrainerCompensations, PayslipDetail, TrainerAdvances
- Sidebar navigation + routes with permission middleware
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

The layout file lives at resources/views/layouts/app.blade.php, so the
correct Livewire attribute is Layout('layouts.app'). 11 components had
the wrong path 'components.layouts.app' causing MissingLayoutException.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Expanded from 10 shallow steps to 12 deep steps covering ALL organization data:
- Academy profile: phone, email, address, type, website, WhatsApp
- Branches: working days (inline toggles), email, city, manager name
- Programs: age range (age_min/age_max columns), sessions_per_week, registration fee (separate BasePrice), payment frequency
- Facilities: branch selection per facility, visual grid preview
- Groups: structured schedule (day + start/end time repeater), segment selection
- Participants: classification (on Person), skill_level (on Participant), national_id, medical_notes, collapsible extras
- Staff: phone, specialization (creates linked Person for trainers)
- NEW Step 9: Financial (tax, invoice/receipt prefix, payment methods, wallet, discounts, family discount, trial period)
- NEW Step 10: Policies (attendance grace periods, auto-absent, suspension threshold, medical/guardian requirements, waitlist, freeze days, email/SMS toggles)
- Step 11: General settings (currency, timezone, week start, date/time format, pagination)
- Step 12: Summary dashboard with stats cards

Schema alignment verified: Branch uses operating_hours (not metadata), Person owns classification/medical_notes, Participant owns skill_level, TrainingProgram uses age_min/age_max/sessions_per_week columns directly, all SettingsService keys match SystemSettings schema exactly.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>