[roncodes]

Summary

The console is now scoped to a store or a network, never both at once, and the sidebar is rewritten for whichever is active (design canvas, board 2 "Context model"). Stacked on #122 → #121; review the top commit.

• storefront service gains a network context (activeNetwork, isNetworkContext, activeContextType, activeContext, setActiveNetwork/clearActiveNetwork, getActiveNetwork, storefront.context.changed). The context is derived from the route, not persisted, so leaving a network returns to the store that was active.
• networks.index.network sets the context in afterModel and clears it in deactivate: a deep link under /storefront/networks/:id/… opens in the network context, every other URL in the store context.
• StoreSelector grew into the context switcher: Stores and Networks groups (labels appear only once both exist, so one store and no networks looks as before), the active entry marked, "Create network" beside "Create a new", network icon and name on the trigger while in a network.
• Application route loads networks beside stores; the controller branches the sidebar into store navigation vs network navigation (Stores, Trucks, Orders, Customers, Settings), keyed by network id with onClick/activeWhen like the product categories. Switching to a store from a network lands on the dashboard; switching to a network enters its Stores page; creating a network switches into it.
• The network page is a full page with an identity strip (logo, name, online badge, store count, currency, "All networks") instead of a 900px overlay; the networks grid hides while a network is open.
• New Trucks section for a network (networks.index.network.trucks) on the shared truck card, backed by FoodTruckFilter::network (whereHas('store.networks'), mirroring StoreFilter::network). Trucks are still created from a store.
• Bug fix: network Orders and Customers queried with the active store's public id, so they listed the store's data. They now use the network being viewed.
• createNewNetwork moved to the storefront service (mirrors createNewStorefront).

Not here, next PRs: network overview dashboard, invitations lifecycle, "Member of" group, invitation banner, ember-ui ContextSwitcher extraction.

Related Issue

Part of the Storefront UX overhaul (design canvas board 2).

Type of Change

• Bug fix
• Feature
• Refactor
• Documentation
• Test
• Chore

Implementation Notes

Network nav items cannot use route-name matching because all network routes share one dynamic segment; they carry id: network:<public_id>:<section> and activeWhen/onClick closures. The network route owns the context so nothing else has to clear it. The selector stays a DOM-built fixed menu (sidebar clipping) and gains data-test-store-selector-* hooks.

Validation

• Tests (targeted: store-selector 9/9; service, controller, route tests written for the context, not all re-run locally per the maintainer's request to stop local runs)
• Lint (pnpm lint clean before the final test edits)
• Build (pnpm build clean)
• Manual validation (maintainer will test)

pnpm lint    → intl/css/js/hbs all exit 0
pnpm build   → Built project successfully
ember test --filter store-selector → 9 passed, 0 failed
pest server/tests/Unit/Http/Filter/StorefrontFilterContractsTest.php → 15 passed (incl. new network filter)

The whole engine suite is not green on this release branch regardless of this PR (scaffold "it renders" tests, an ember-concurrency global error aborts the run). The full backend suite has pre-existing local failures (missing Fleetbase\Support\SocketCluster\* in the local core-api, OrderActivityFlow assertions); the two food truck controller tests fail identically with this filter change stashed.

Documentation Impact

• No documentation changes needed
• Documentation updated in fleetbase/fleetbase.io
• Documentation needed but not included

API Reference Impact

• No API reference changes needed
• Updated fleetbase/postman
• API reference updates required but not included

API reference notes: the network filter is on the internal console endpoint only.

Documentation Notes

fleetbase/fleetbase.io → docs/storefront networks: document the store vs network context and the network Trucks section once the network screens series lands (needs-docs for the series).

Risk

The network page is no longer an overlay; anything linking to networks.index.network now navigates into the network context. routes/application model is now { stores, networks } (only templates/application.hbs consumed it). Trucks of a network are read-only in the network context for now.

Screenshots / Recordings

Mockups: design canvas board 2 (https://claude.ai/artifact/771ptEFmi4BLmYHBZuUhWF). Live screenshots to follow from the maintainer's run.

[roncodes]

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