Skip to content

feat(dashboard): needs-attention strip that counts today's work and deep-links into it - #134

Closed
roncodes wants to merge 25 commits into
release/v0.4.25from
feat/dashboard-attention
Closed

roncodes wants to merge 25 commits into
release/v0.4.25from
feat/dashboard-attention

Conversation

@roncodes

Copy link
Copy Markdown
Member

Summary

Dashboard from design board 8a: the needs-attention strip. Stacked on #133; review the top commit.

  • Needs attention widget (Widget::AttentionStrip, registered as a default storefront dashboard widget, full width): orders to confirm with the oldest wait, orders ready for pickup, deliveries without a driver, published products that are out of stock, trucks offline, pending network invitations for this store. Each tile deep-links into the page that handles it (orders with the matching status filter, products out of stock, trucks, networks). Shows "Nothing waiting on you" when clear and refreshes on incoming orders and store switches.
  • Backend: GET analytics/attention?storefront= computes the counts for the store.

The existing recent-orders widget already promotes next actions through Storefront::Order::Actions, and people and drivers already render as pills, so those parts of board 8a needed no change. Not here: the header open/closed badge from store hours (hours live on store locations; a later pass can summarise them), network widgets on the network overview (board 3a handles the overview).

Related Issue

Storefront UX overhaul, design canvas board 8a.

Type of Change

  • Feature

Implementation Notes

The widget follows the KPI tile pattern (fetch on construct, reload on order.broadcasted and storefront.changed). Pending invitations are matched by the store's email against open join_storefront_network invites.

Validation

  • Tests / Lint / Build — not run locally per the maintainer's request (CI).
  • Manual validation — maintainer. The widget appears for dashboards that still use defaults; saved dashboards can add it from the widget picker.
php -l server/src/Http/Controllers/AnalyticsController.php: no syntax errors

Documentation Impact

  • Documentation needed but not included

API Reference Impact

  • No API reference changes needed
  • API reference updates required but not included

API reference notes: internal GET storefront/int/v1/analytics/attention?storefront=; no public API change.

Documentation Notes

docs/storefront → dashboard: the needs-attention strip. needs-docs for the series.

Risk

None functional; purely additive.

Screenshots / Recordings

Design canvas board 8a: https://claude.ai/artifact/771ptEFmi4BLmYHBZuUhWF

The dummy app never ran: ember-classic-decorator (unused) crashes on Ember 5,
lazy loading kept the engine's modules out of the test bundle, and the host
services, config and intl data the panels need were missing. Mirrors what
fleetops already does: eager loading when `ember test` runs from this package,
an inert stand-in for the console's extensions module, the API config the
core adapter reads at module scope, and the legacy built-in components the
engine's templates still use.

The dummy intl service ignores missing locale data, since headless Chrome has
no number formats for every bundled locale, and the order details and network
controller tests stub the host router, fetch and app cache the way the widget
tests already do.
…rce card

Catalog, truck and network index pages use Layout::Resource::CardsGrid with
one card each on Layout::Resource::Card, following the Fleet-Ops anatomy:
identity and subtitle in the header, media or facts in the body, status,
icon actions and meta in the footer, with registry slots at each end.

A catalog card shows its categories with product counts, its hours as a
seven-day strip (the new Storefront::HoursStrip) and its product total; a
draft is dashed. A truck card is a Vehicle::Pill with the online dot, the
vehicle photo, where it serves, and a presence badge that says serving,
offline, inactive, or online with no catalog. A network card shows the logo on
its backdrop, the online state, the currency and member count.

"Food trucks" reads "Trucks" in the UI; the food-truck model, routes and
permissions keep their names. The catalogs and trucks pages gain the search
the header already offered.
@roncodes roncodes added needs-docs Requires documentation updates needs-human-review Requires human review before proceeding type:feature Feature or enhancement labels Oct 10, 2026
@roncodes
roncodes force-pushed the feat/dashboard-attention branch 2 times, most recently from b6102b8 to 4c93fcb Compare October 10, 2026 08:17
… and crashed createRecord; the store summary is store_summary
…s own sidebar for each

- storefront service tracks a network context derived from the network route
- StoreSelector becomes the context switcher with a Networks group and create-network
- application route loads networks; sidebar rewrites for the network context
- network page is a full page with an identity strip; the list hides while one is open
- new Trucks section for a network backed by FoodTruckFilter::network
- network orders and customers are scoped to the network being viewed, not the active store
- createNewNetwork lives on the storefront service
…enu without Networks

- trigger: context icon, name, STORE/NETWORK label and caret; blue for a store, indigo for a network; invitation badge
- menu: Stores and Networks groups with tiles, currency or member count, a check on the active one, readable in dark mode; footer actions read New store / New network
- store navigation follows the design order (Dashboard, Orders, Products, Catalogs, Customers, Trucks, Promotions, Settings); networks live in the switcher, not the menu
- network page loses the All networks button; leaving a network is the switcher's job
@roncodes
roncodes force-pushed the feat/dashboard-attention branch from 4c93fcb to a64561c Compare October 10, 2026 09:34
…e sidebar re-renders on a switch; networks report their store count
…d an invite panel

- network index is now an Overview (stat tiles, members with 7-day share, invitations, recent orders); settings move to networks.index.network.settings
- NetworkController gains overview, invitations, resend and revoke; one Invite per recipient carrying category, expiry, message and approval in meta
- OrderFilter/CustomerFilter gain a network filter on meta.storefront_network_id; the network orders and customers routes use it
- Storefront::Network::InvitePanel (by email, shareable link, add a store you manage) replaces the share-network and add-stores modals
- stores page: store identity column via a new store descriptor, All/Online/Offline/Invited tabs, bulk assign category and remove, invitation rows with resend/revoke/invite again
- store and network resource descriptors registered with the shared identity registry; SelectOption::Store wrapper; width-style helper
…ost re-export broke console boot before the lazy engine loaded
…ore stacks and next actions

- a multi-store checkout is one expandable row (customer, stores, fulfillment, total with tip split, shared driver, least-advanced status) that opens into each store's order
- status tabs (needs action, preparing, ready for pickup, out for delivery, completed, canceled) drive the status query param; grouped/flat toggle
- new cells: reference, stores (identity stack of store pills), fulfillment, total, driver (inline assign), status, placed, actions (next action promoted, rest behind an ellipsis)
- order index resource keeps meta.checkout_id so the console can group
…lide with the networks list's page, sort and query
…ive questions first

- header: id, status and store/network badges, the next workflow action promoted to a button, Edit, the rest behind a menu
- Storefront::Order::FlowSteps renders the activity flow as steps (custom order configs contribute their own)
- Storefront::Order::IdentityStrip: customer, driver with inline assign, fulfillment and timing, total with tip and promotion
- tabs: Items (with store block and the other orders of the checkout), Route (with tracking), Payment, Activity (with comments), Customer, Data (metadata and documents); registered tabs still appended
- panel widened to 600px
…out rules and a save bar

- settings shell: store identity header with copy-store-key, a section rail (General, Branding and media, Locations, Checkout rules, Payment gateways, Notification channels, Alerts, API keys); anchors on the General page, routes for the rest
- General page restructured into always-open sections: general, branding and media, checkout rules, alerts
- every rule the server honours is a Storefront::SettingRule row with its consequence written under it, detail inputs appear when it is on
- sticky save bar with unsaved-change count and the sections touched; Discard rolls back attributes, options and alerts
…f categories, products, hours and who serves it

- new full-page route catalogs.index.edit: categories on the left (add, rename, reorder, remove), the selected category's products in the middle with an in-place picker over the store's products that hides what is already in the catalog, health on the right; Hours (ScheduleManager), Served by (stores and trucks) and Details sections; sticky save bar with a summary of unsaved changes
- a store can now serve a catalog like a truck: Store gains catalog relations, PUT catalogs/{id}/subjects syncs stores and trucks, the catalog resource exposes hours and subjects
- category order persists; the catalog list opens the editor, the create modal only asks for name, description and status, and the card shows who serves the catalog
… issue badges and a save bar

- Storefront::Product::Form gains tabs: Details (basics, pricing, flags, a folded More for translations and metadata), Variants and add-ons, Availability, Media (images and videos)
- inline validation: missing name or price, sale price not below price, published without category or image; the tab holding the field carries a badge and the save bar links to it
- status select moves into the panel header; the save bar counts unsaved changes across the product, its variants, add-ons and queued uploads, with Discard
…ns on one screen

- header rebuilt: photo, name, type and preference badges, copyable id, since-date, and a lifetime strip (orders, spend, average, last order) from a new customers/{id}/insights endpoint scoped to the store or network
- actions: New order for this customer, Edit, copy id/email
- tabs: Overview (contact facts, saved places with the default marked, stores ordered from in network context, recent orders), Orders, Places (set default, open in Fleet-Ops from the pill), Activity and notes (first/last order, cancellations, internal notes via CommentThread); registered tabs keep working
- panel widened to 600px
…builder, a redemptions screen and promotion cards

- hub shell: title, subtitle, live counts (active, scheduled, redemptions, discount given) from promotions/hub, one tab strip across promotions, campaigns, segments, pushes and the new Redemptions tab
- promotions list: status tabs (all, active, scheduled, paused, ended, draft), cards or table, Storefront::Promotion::Card with value, trigger, window, targets and redemptions, row actions gain duplicate and view redemptions
- Storefront::Promotion::Builder replaces the modal: What, When it applies (with codes once saved), Targets (products, categories, exclusions, segment), Schedule and limits, Review and announce; done steps collapse to one line; save draft at any step
- Redemptions: PromotionRedemption controller, filter, resource and relations, frontend model, route and table
- Storefront::Promotion::Codes extracted from the codes modal so the builder and the modal share it
… can run their own trucks

- Storefront::Truck::Panel (Details: vehicle, service area, zone, status; Catalogs: assign with serving-now badges) replaces the create/edit and assign-catalogs modals
- trucks page gains All/Online/Offline/Inactive tabs; the network trucks page gets New truck, owned by the network
- food_trucks.network_uuid (nullable) with model relation, resource fields, filter (network: member stores' trucks plus network-owned; ownedByNetwork) and public API ownership rules
- card shows the owning network
… status tabs, bulk actions and draft hints

- category sidebar nests by parent, shows per-category counts from a new products/summary endpoint, and offers smart groups (out of stock, drafts, recommended, on sale, uncategorised)
- status tabs (all, published, draft, on sale) and smart groups drive new product filters: status, category, available, on_sale, recommended, uncategorized
- cards and rows are selectable; a bulk bar publishes, unpublishes, moves to a category, marks on sale or deletes the selection
- a draft card says what it is missing (category, image, price); an out-of-stock card that is still published says so
… sidebar and render the status tabs and bulk bar; the earlier edit never applied and the sidebar crashed on an undefined handler
…n today and deep-links into it

- analytics/attention returns orders to confirm (with the oldest wait), pickups ready, deliveries without a driver, published products out of stock, trucks offline and pending network invitations for the active store
- Widget::AttentionStrip renders them as clickable tiles and is registered as a default storefront dashboard widget
@roncodes
roncodes force-pushed the feat/dashboard-attention branch from a64561c to 3489f83 Compare October 10, 2026 10:20
@roncodes

Copy link
Copy Markdown
Member Author

Superseded by the single overhaul PR (one branch, one PR targeting release/v0.4.25, per maintainer request).

@roncodes roncodes closed this Oct 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-docs Requires documentation updates needs-human-review Requires human review before proceeding type:feature Feature or enhancement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant