Skip to content

feat(products): nested category sidebar with counts and smart groups, status tabs, bulk actions and draft hints - #133

Closed
roncodes wants to merge 23 commits into
release/v0.4.25from
feat/products-page
Closed

roncodes wants to merge 23 commits into
release/v0.4.25from
feat/products-page

Conversation

@roncodes

Copy link
Copy Markdown
Member

Summary

Products page from design board 8c. Stacked on #132; review the top commit.

  • Category sidebar: categories nest under their parent (the model already has parent_uuid) with a fold caret, each shows its product count (own plus children), and a Smart groups block lists Out of stock, Drafts, Recommended, On sale and Uncategorised with counts. Counts come from a new per-store products/summary endpoint.
  • Status tabs above the products (All, Published, Draft, On sale) and the smart groups set new filter query params (status, available, on_sale, recommended, uncategorized) that the server now honours (ProductFilter), on both the all-products and the category routes.
  • Selection and bulk actions: every card and row gets a checkbox; a bulk bar offers Publish, Unpublish, Move to category (picker modal), Mark on sale and Delete, done per record with the existing save endpoints, then refreshes.
  • Cards: a draft says what it is missing before it can publish (category, image, price); an out-of-stock product that is still published gets a warning badge and a "restock or unpublish" hint.

Not here: drag a product onto a category, right-click category menu (edit/delete stay in the header dropdown), "add to catalog" from the bulk bar (the catalog editor's picker covers it), server-side bulk endpoints.

Related Issue

Storefront UX overhaul, design canvas board 8c.

Type of Change

  • Feature

Implementation Notes

The grid/list toggle, import and add-ons management are unchanged. The category controller now declares its query params explicitly (it had tracked fields but no queryParams list).

Validation

  • Tests / Lint / Build — not run locally per the maintainer's request (CI).
  • Manual validation — maintainer.
php -l server/src/Http/Filter/ProductFilter.php, server/src/Http/Controllers/ProductController.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: new product filters (status, category, uncategorized, available, on_sale, recommended) apply to the public v1/storefront/products list too since the filter class is shared; internal GET storefront/int/v1/products/summary?store_uuid=.

Documentation Notes

docs/storefront → products: smart groups, status tabs, bulk actions, what a draft needs. needs-docs for the series.

Risk

Bulk actions save records one by one; a partial failure leaves some products changed (the toast reports the error and the page refreshes to show the real state).

Screenshots / Recordings

Design canvas board 8c: 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-api-spec Requires API specification updates needs-human-review Requires human review before proceeding type:feature Feature or enhancement labels Oct 10, 2026
@roncodes
roncodes force-pushed the feat/products-page branch 2 times, most recently from 7548186 to 2bc5a07 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
…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
@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-api-spec Requires API specification updates 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