# Navagoo Demo ↔ Portal Parity Re-Analysis **Date:** 2026-06-28 **Scope:** Full demo (`../Navagoo_MI`) ↔ portal (Yii2/Tailwind "aurora") parity, reflecting state after waves 8–13. **Method:** 13 domain agents each read both the demo React source and the current portal PHP and reported feature-by-feature. ## Executive summary The port is in strong overall health: of **224** features analyzed, **103 are at parity (done)**, **45 partial**, **41 intentionally/structurally different**, and **35 missing**. Roughly **66%** of features are either fully done or a deliberate, documented superset (different-but-richer). The portal's financial engine (`FinanceLedgerService` ↔ `finance.ts`), calendar scheduling engine (`BookingScheduleService` ↔ `lib/schedule.ts`), onboarding gate (`nextOnboardingScreen` ↔ `onboarding.ts`), and the entire admin side are faithful or better-than-demo, frequently wired to real DB tables rather than mocks. Since the last analysis, waves 8–13 closed substantial ground: **Settings** gained the 12h/24h toggle, per-method walk-in toggles, and deposit-cap gating; **Specialist display fields** (compensation, calendar colour, languages, reports_to column) landed; **Commercial Config** singleton form shipped; **Notifications** got usage tiles + a full admin trigger catalogue with timing modes; the admin-finance **SettleModal** (dual-upload, FormulaStrip, mismatch detection) and the **Finance hub** (5-tab shell + ShopBalances + TransferRequests) were ported. The remaining work concentrates in five places: (1) a **client/server contract bug** breaking calendar drag-to-reschedule/reassign; (2) the **solo bookings list** lacking an inline drawer / quick-actions / live search; (3) the **Notifications template + approval lifecycle** (no template columns in DB at all); (4) three **Finance tabs** (Charges filters, Invoices Pay/ZATCA flow, Subscription) being thin or stubbed; and (5) the **Team Structure** org-chart being read-only with no manager field. None of the admin-side gaps are high priority — the shop-owner surfaces are where the value is. --- ## Scorecard | Domain | Overall | Done | Partial | Different | Missing | Verdict | |---|---|---:|---:|---:|---:|---| | Shop Dashboard | mostly_done | 11 | 2 | 2 | 0 | Faithful, real-ledger; subscription banner substitutes contract lifecycle | | Shop Bookings list + Group Bookings | partial | 4 | 6 | 7 | 3 | Group half strong; solo half lacks drawer/search/columns + Pay-now | | Day/Month Calendar + Time-off | mostly_done | 16 | 1 | 4 | 0 | Near-1:1 engine; drag POST contract is broken | | Booking Detail + Timeline + Slot picker | mostly_done | 10 | 4 | 1 | 2 | Core faithful; payment rows + terminal timeline node missing | | Services / Catalogue | partial | 5 | 4 | 4 | 5 | List strong; forms lack variants/cropper/freebies/descriptions | | Team / Specialists / Structure | partial | 8 | 3 | 4 | 3 | Specialist form excellent; Structure is read-only, no manager field | | Shop Settings (all tabs) | partial | 9 | 6 | 3 | 2 | Shell + payments solid; Notifications tab shallow/static | | Notifications (3 surfaces) | partial | 6 | 5 | 3 | 6 | Shells ported; template + approval lifecycle entirely absent | | Shop Finance 5-tab hub | partial | 4 | 8 | 4 | 5 | Engine + detail strong; Charges/Invoices/Subscription tabs incomplete | | Marketing / Promo / Packages | mostly_done | 11 | 1 | 3 | 0 | Real persisted CRUD, superset of demo | | Customers + Onboarding/Auth | mostly_done | 13 | 3 | 2 | 0 | Near-1:1, prod-grade OTP superset; login still Bootstrap | | Admin Finance | partial | 7 | 5 | 3 | 4 | ShopBalances/Settle faithful; no AdminInvoices/AdminCharges screens | | Admin core (8 screens) | mostly_done | 15 | 0 | 3 | 0 | Most mature area; Activate modal + Geography not re-skinned | | **Total** | — | **103** | **45** | **41** | **35** | — | --- ## Prioritized gap backlog Every feature with status ≠ `done`, sorted Priority (high → med → low) then Effort (S → M → L). "Different" entries are included where the divergence is a real behavioral gap, not a documented superset. ### HIGH priority | Domain | Feature | Status | Gap | Effort | |---|---|---|---|---| | Day/Month Calendar | Drag-to-reschedule (same specialist) | different | JS posts `{datetime}` but server reads `date`+`from`+`to` → every drop fails "Invalid date or time." Confirm body also generic. | S | | Day/Month Calendar | Drag-to-reassign (cross specialist) | different | Same fatal `datetime`-vs-`date/from/to` POST mismatch; server can't read the move. | S | | Booking Detail | Payment breakdown rows (discount/online/in-person/tip/refund) | partial | Renders only Outstanding + Total; view-model already returns discountLabel/collectedOnlineLabel/inStoreLabel/tipLabel/refundValueLabel — pure view work. | S | | Booking Detail | Status timeline — terminal branches (Cancelled / No-Show) | different | Cancelled/no-show show 3 ghosted happy-path steps instead of a terminal node w/ timestamp + refund/reason lines. | M | | Shop Bookings | Live client-side search (booking#/customer/mobile) | different | Submit-based not live; status/ID/name filter ignores party rows entirely. | M | | Shop Bookings | Solo row inline expand → BookingDrawer | missing | No inline solo drawer at all; start/complete/reschedule/cancel/timeline only via separate /view page. Biggest solo-side gap. | L | | Shop Bookings | New group modal: Pay-now collection sub-flow | different | "Pay now" opens no payment-capture step (no method/tip/due); on_visit collects nothing. | M | | Services / Catalogue | Service variant / image-tier picker (VariantPicker) | missing | `service_image_variant` table + model exist but fully unwired; no UI, no persistence. | L | | Services / Catalogue | Routine-before/after/free-addon attachments on a service | missing | `service_freebie_link` table migrated but unwired; no picker, no +N min roll-up. | L | | Team / Structure | Structure tab — interactive org-chart editing | missing | Read-only tree; NO add-child/rename/reparent/delete AND no manager/reports_to field in form despite DB column+FK. Domain headline gap. | L | | Team / Specialists | Delete-with-bookings → deactivate-instead guard | missing | `actionDelete` hard-deletes with no booking-count check; risk of deleting specialist with live bookings. | M | | Shop Settings | Notifications — usage stat tiles (used/free/overage) | different | Usage hardcoded 0; free limits 100/50 ≠ demo 50/20; no overage "N billed · $X each"; extra In-app tile. | M | | Shop Settings | Notifications — paid-channel confirmation dialog | missing | Clicking SMS/WhatsApp submits immediately, no cost disclosure (a deliberate spend gate in demo). | M | | Shop Settings | Notifications — channel approval gating (locked/pending) | missing | Buttons always enabled; no per-channel approved/pending concept; posted values unvalidated. Data-model gap. | L | | Notifications | Admin: per-channel TEMPLATE authoring (SMS/WA/in-app bodies) | missing | `notification_trigger` has no template/channel columns; no template textareas anywhere. | L | | Notifications | Admin: variable catalogue ([bookingNum]…) click-to-insert | missing | No template area → no variable chips/insert/token catalogue. | M | | Notifications | Admin: template APPROVAL status + Approve control | missing | No status column/badges/Approve action; central admin governance concept absent. | L | | Notifications | Shop: per-trigger paid-channel picker not gated by approval | different | Always offers SMS+WhatsApp; shop can pick a channel admin never approved. | M | | Notifications | Send-time channel resolution + NotifSent emission | missing | No resolver/sender pipeline; configured paid_channel has no behavioral effect (usage stays 0). Engine behind the feature. | L | | Shop Finance | Earnings table columns (per-row finance state) | partial | Missing payment-timing pill, Net Earnings, Navagoo Payout, Eligible-verdict + hold countdown, Collection-status. | M | | Shop Finance | Charges filters (status Segmented + type Select) | missing | Controller computes filterStatus/filterType then ignores them; no filter UI rendered. ChargeQuery scopes already exist. | M | | Shop Finance | Invoice Pay flow (card vs bank-transfer slip) | missing | No Pay action, method modal, slip upload, or payInvoice mutation. Invoices read-only. | L | | Shop Finance | Subscription tab (plans, activate/cancel, status) | missing | Coming-soon stub; SubscriptionPackage/UserCard models exist but nothing wired. | L | | Admin Finance | AdminInvoices — platform-wide list + status filter | missing | No screen/action; Invoice model lacks period/issued_at/due_at/paid_at/documentStatus. Biggest admin-finance gap. | L | | Admin Finance | AdminInvoices — verify-payment + upload-document | missing | No verifyInvoice/attachInvoiceDocument; pending_verification unreachable from UI. | M | | Admin Finance | AdminCharges — platform-wide ledger + filters | missing | No platform-wide screen; only per-shop drill-down; no rate-label column or status/shop/type filters. | M | | Admin Finance | CommercialConfig values actually drive the charge engine | different | Form saves to `commercial_config` but `FinanceLedgerService` reads `Settings.taxes` + shop columns/hardcoded defaults — config is write-only w.r.t. ledger. | M | ### MEDIUM priority | Domain | Feature | Status | Gap | Effort | |---|---|---|---|---| | Shop Dashboard | Costs-to-date donut (legend dot colours) | partial | Legend dots all `bg-brand-300` instead of per-category `$p['color']` — minor bug. | S | | Shop Bookings | Status filter options parity | different | Dropdown vs segmented; any-guest-matches party rule moot since filter never touches party rows. | S | | Shop Bookings | Group reschedule modal (SlotPicker) | partial | Raw date+time inputs, no open-slot grid; clash only surfaces after submit. | M | | Shop Bookings | New group modal: organiser + guest repeater | partial | No "New" organiser path (existing-customer only) → blocks brand-new walk-in parties. | M | | Shop Bookings | New group modal: inline per-guest conflict | partial | `.grp-conflict` banner is dead UI; no client-side placement check at chosen slot. | M | | Shop Bookings | New group modal: live slot picker | different | Blind date/time entry; "add a guest first to see open times" non-functional. | M | | Shop Bookings | Group expand drawer: nested per-guest detail | partial | Guest rows don't expand to BookingDetailBody; single-guest in-drawer actions lost (eye-link only). | L | | Shop Bookings | Collection status column (solo + party) | missing | No Collection column; party shows "{amt} due" sub-line, no collected/pending badge. | M | | Booking Detail | Per-row actions menu (3-dot) | missing | No quick-actions menu on list rows; every transition needs the detail modal first. | M | | Booking Detail | Per-booking notifications bell | partial | Title-only sent list; no channel badge/body/Failed badge/Mark-failed, not per-row bell. | M | | Day/Month Calendar | Empty-slot click → pre-filled walk-in create | partial | JS appends `?datetime=`, actionWalkIn reads `?from=` → snapped TIME dropped. | S | | Services / Catalogue | Image cropper on all image pickers | different | filekit auto-resize only, no interactive crop step for square thumbnails. | L | | Services / Catalogue | Bilingual service description | missing | ShopService has no description field at all (demo treats it as first-class on every item). | M | | Services / Catalogue | Total-duration roll-up (+N min) | missing | Depends on freebie attachments; card chip + form hint need the +N. | M | | Services / Catalogue | Routines/add-ons as first-class items (Freebie CRUD) | partial | No bilingual name/description (no name_ar/description_ar), no image picker. | M | | Services / Catalogue | Subscription packages tab placement | partial | Lives on own route, not surfaced in unified catalogue; legacy package/_form coexists. | M | | Services / Catalogue | Unified catalogue Packages tab | partial | 4 tabs only; Packages (5th) split to package/subscriptions route. | M | | Services / Catalogue | Admin Catalogue women/men branch segmentation | missing | No gender-branch filter; admins can't separate female/male catalogues. | M | | Team / Structure | Structure — colour modes + zoom-pan-fullscreen | missing | No tint modes (specialist colour ignored), no zoom/pan/fit/fullscreen toolbar. | L | | Team / Payroll | Payroll tab — monthly breakdown | partial | net_of_fees flattened to gross (over-pays); "Tips Earned" sums booking tipping not the demo's owed-liability selector. | M | | Team / Structure | Structure help popover | partial | Describes a set-reporting-line-via-profile capability the form doesn't provide. | S | | Shop Settings | Scheduling — opening hours TimePicker | partial | Native time input ignores time_format toggle (always 24h, no 15-min snap). | M | | Shop Settings | Scheduling — time format toggle drives pickers | partial | Toggle persists but does NOT drive open/close picker display format. | M | | Shop Settings | Commercials — read-only terms table | partial | Missing Next-billing date + Payment-processing-fee rows; min-withdrawal not money()-formatted. | S | | Shop Settings | Notifications — customer triggers table | partial | Omits template preview, "N sent this month", schedule detail; In-app badge always "On · free". | M | | Shop Settings | Notifications — template preview (expand/collapse) | missing | No template text/preview/expand; shops can't see what an alert will say. | M | | Notifications | Admin: live preview + char/SMS-segment count | missing | No preview box/char count/smsSegments helper (needs template authoring first). | M | | Notifications | Admin: editing SMS/WA template re-pends it | missing | No re-approval-on-edit semantics (blocked on template+approval model). | M | | Notifications | Admin: "re-approval needed" confirm (N shops paused) | missing | No blast-radius confirm before re-pending a template. | M | | Notifications | Admin: eventBasis selector ("Fires") | different | No enumerated eventBasis column/selector; firing event implied by free-text event_key; timing always shown. | M | | Notifications | Shop Settings: usage tiles (in-app/SMS/WA) | partial | In-app real; SMS/WA hardcoded 0; "/100","/50" static literals, no real quota model. | M | | Notifications | Shop in-app inbox: feed list (data source) | different | Wired to legacy `notifications` table, not the demo's trigger-named NotifSent feed; the two systems are decoupled. | L | | Shop Finance | Earnings KPI tiles (P&L quartet) | different | Doesn't surface Revenue/Navagoo fees/Net earnings/Withdrawable exactly; no threshold-aware caption; uses ShopEarning sums not the engine. | M | | Shop Finance | Charges ledger table | partial | Missing Booking ref, Rate (rate_snapshot/fixed_snapshot exist but unshown), Invoice/TR ref, reversal annotation. | S | | Shop Finance | Invoices table | partial | No Period column, no Issued/Due pair, no action cell. | S | | Shop Finance | Invoice document viewer (ZATCA) | missing | No invoice document modal/printable view; earningsApplied credit line not surfaced. | M | | Shop Finance | Settlement eligibility table (per-booking) | partial | Missing customer/specialist/status/value/tips/per-booking charges/Held-days columns. | M | | Shop Finance | Request transfer / Approve & send action | different | Delegates to agents-wallet/create; no inline requestTransfer bundling eligible bookings → settlement tab; no "nothing eligible" warning. | M | | Shop Finance | Payment cards management | missing | No card list/add-card modal/make-default; UserCard model exists. | M | | Marketing | Create deal modal (description/title field) | different | Deals keyed by redemption CODE, no free-text description/title for marketing labels; blank cap = Unlimited vs demo 100. | M | | Admin Finance | Finance hub: 5-tab layout + badge counts | different | Fragmented into 3 separate menu items; no requested/to-verify/owing badge counts. | M | | Admin Finance | InvoiceDocument — printable render | missing | No generated invoice doc with line items/period/issued-due/earnings-applied. | M | | Admin Finance | CommercialConfig — messaging sub-fields | partial | Missing per-channel fail-refund + free-monthly allowance + live margin chip. | S | | Admin core | Shops — Activate modal | different | Only Shops surface NOT re-skinned to aurora; still legacy AdminLTE/Kartik/fancybox RTL chrome. | M | | Admin core | Geography — cities & districts | different | Two flat CRUD tables, not per-city card grid w/ inline district chips + enable/disable toggle (no city on/off switch). | M | | Customers/Auth | Login screen | different | Functional + richer (remember-me/locale/reset) but legacy Bootstrap shell, not aurora card. | M | | Customers/Auth | Sign-up form (chips + inline validation) | partial | Categories/type as Select2/dropdown not chips; no live "passwords don't match" or submit-disable-until-valid gate. | M | ### LOW priority | Domain | Feature | Status | Gap | Effort | |---|---|---|---|---| | Shop Dashboard | Page header + quick actions | done* | Header uses user name vs plain "Welcome back"; cosmetic. | S | | Shop Dashboard | Subscription banner (plan/trial/billing/card) | different | No Subscription/Plan model; substitutes contract/verification lifecycle. | L | | Shop Dashboard | KPI grid selection (4 vs 6 cards) | different | 6 KPIs vs demo's 4; adds in_progress+cancelled counts; data correct. | S | | Shop Dashboard | Costs-to-date breakdown population set | partial | Uses ->outstanding() (unpaid only); demo counts ALL non-pending so paid fees + reversals included. | M | | Shop Dashboard | Action cards (Invite/Detailed charges) | partial | Standalone "Detailed charges" card missing (CTA lives in donut); Invite copy generic. | S | | Shop Bookings | Unified table: parties + solos merged | different | Parties stacked at top, not interleaved chronologically by slot. | M | | Shop Bookings | View segmented control (List/Day/Month) | partial | List-only here; Day/Month on separate /booking-calendar route. | L | | Shop Bookings | Settlement status column | missing | Settlement state not surfaced in list (wide-screen-only secondary in demo). | M | | Shop Bookings | Per-row notification bell | different | Navigation link, not in-place BookingNotifBell popover/indicator. | M | | Shop Bookings | New walk-in: modal vs full page | different | Navigates to full create page, not the demo's inline modal. | L | | Shop Bookings | Empty state | partial | Not query-aware (no 'match "q"' variant). | S | | Day/Month Calendar | Specialist columns muted badge | partial | Hardcoded "Off"; demo distinguishes "Inactive" vs "Off". | S | | Day/Month Calendar | Group-booking badge on a block | different | Shows party SIZE instead of the group id the demo prints. | S | | Booking Detail | Action buttons No-Show grace state | done* | Hides No-Show button until grace vs demo's disabled+tooltip "available in N min". | S | | Booking Detail | Cancel overlay fee-disposition text | done* | "Reversed (partial)" vs demo's exact "Reversed {pct}%". | S | | Booking Detail | Reschedule overlay conflict feedback | done* | No live pre-submit banner (relies on slot-list filtering). | S | | Booking Detail | SlotPicker Book-now/Earliest dedupe | done* | bookNow not removed from grid; earliest can appear twice. | S | | Booking Detail | Inline expandable detail drawer in list | missing | Modal-only; no inline expand-in-place drawer. | M | | Booking Detail | Group/guest-label detail row | partial | guestLabel not shown alongside group id. | S | | Booking Detail | Status strip Settlement chip | done* | 2-state heuristic vs demo's fuller settlementStateFor(). | S | | Services / Catalogue | 3-panel pricing discount control | partial | Plain