[roncodes]

Summary

Network screens from the design canvas, boards 3a (overview), 3b (stores) and 3c (invite stores). Stacked on #123 (context switcher); review the top commit.

• Overview (networks.index.network.index): stat tiles (stores and how many are online, pending invitations, orders and revenue over 7 days with tips, customers and new this month), member stores with their 7-day order and revenue share, open invitations with resend/revoke/invite-again, the shareable link, and the five most recent network orders. Settings moved to networks.index.network.settings (same template and controller, renamed).
• Stores: the store column is a table/cell/identity typed store (new descriptor), status tabs All / Online / Offline / Invited with counts, a bulk bar while rows are selected (assign category, remove from network, clear), invitation rows under the table with their state badge and actions, and the remove-store copy from the design.
• Invite panel (Storefront::Network::InvitePanel, right overlay, 600px) with three tabs: by email (chips, duplicate/member flagging, category on joining, expiry, message, require approval), shareable link (toggle, copy), add a store you manage (multi-select of the organisation's non-member stores plus category). Replaces the share-network and add-stores-to-network modals.
• Backend: GET networks/{id}/overview, GET networks/{id}/invitations, POST networks/{id}/invitations/{invitationId}/resend, DELETE networks/{id}/invitations/{invitationId} on the internal API. sendInvites now creates one Invite per recipient and stores category_uuid, message, require_approval and status in meta, with expires_at from expires_in_days; state is derived (pending, expired, declined, accepted, revoked) without a core migration.
• Bug fix: network orders and customers were filtered on meta.storefront_id, which is always the store; the network is meta.storefront_network_id. OrderFilter::network and CustomerFilter::network added and the network routes pass network instead of storefront.
• Store and network resource descriptors registered with the shared identity registry (pill, identity cell, select option, summary for free); SelectOption::Store wrapper; width-style helper for share bars.

Not here: accept/decline flow for the invited store (/join/network/:token landing, store-side banner and switcher badge), approval queue when "require my approval" is on, suspend-from-network (needs a status column on network_stores), categories page.

Related Issue

Storefront UX overhaul, design canvas boards 3a–3c.

Type of Change

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

Implementation Notes

The overview reads orders by meta->storefront_network_id and groups shares by meta->storefront_id, mirroring how checkout writes them. Invitation state lives in Invite.meta.status plus expires_at; revoke deletes the row (core Invite has no soft deletes). Status tabs on the stores page filter client-side (a network's members are few and the route already loads them all).

Validation

• Tests — not run locally per the maintainer's request; new unit coverage was not added for this PR (follow-up).
• Lint — not run locally (CI).
• Build — not run locally (CI).
• Manual validation — maintainer.

php -l on the three changed PHP files: no syntax errors

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: all new endpoints are on the internal console namespace (storefront/int/v1), not the public API.

Documentation Notes

fleetbase/fleetbase.io docs/storefront → networks: overview, inviting stores (email, link, own stores), invitation states. needs-docs for the series.

Risk

networks.index.network.index changed meaning (settings → overview); any bookmark to the settings tab now lands on the overview. sendInvites creates one invite per recipient instead of one with many recipients; the mail template is unchanged. Existing multi-recipient invites render their first recipient.

Screenshots / Recordings

Design canvas boards 3a–3c: https://claude.ai/artifact/771ptEFmi4BLmYHBZuUhWF

[roncodes]

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