Vendors covers onboarding and lifecycle: list with inline store hooks, create full page, detail/edit. Tied to stores and zones for multi-tenant operations.
| Goals | Non-goals |
|---|
| Register and maintain vendor accounts | Replace contract/legal onboarding |
| Tie vendors to stores for operations | Document payment settlement with acquirer |
- Routes: list, create,
:id, :id/edit (see table).
- Stat tiles may be partial—see list section for live vs placeholder.
- Create vendor → fill legal/business fields → save.
- Attach or verify stores from list inline actions.
- Assign or change a platform package from list actions.
- Open detail for audit trail and contacts.
- Check overview package card to confirm active package window.
- KYB/PII — restrict exports; align with legal retention.
- Offboarding: disable vendor + unlink stores per runbook.
| ID | Scenario | Expected |
|---|
| VN1 | Create vendor | Appears in list |
| VN2 | Inline store action | Store association updates |
| VN3 | Zone admin | Cannot see other zones |
| VN4 | Assign package | Vendor gets new active platform package |
| Path | Purpose |
|---|
/dashboard/vendors | Vendor list and inline store management |
/dashboard/vendors/create | Create vendor (full page form) |
/dashboard/vendors/:id | Vendor detail |
/dashboard/vendors/:id/edit | Edit vendor |
- Search — debounced (400ms), pagination size 10.
- Stats row — placeholder values (—) in the current UI for total / active / inactive / new (labels are i18n-backed).
- Vendor modals — create/edit via
VendorFormModal; delete via DeleteVendorModal.
- Deep link —
?edit=<vendorId> opens the edit modal when the list loads.
- Stores per vendor — Add / edit / delete store modals (
AddStoreModal, EditStoreModal, DeleteStoreModal) for the selected vendor.
- Package assignment — Assign package action opens a modal of active platform packages and calls
PATCH /admin/vendors/:id/membership-package. If an open platform package exists, it is canceled and replaced.
- Package block — Overview now shows the active package (
name/code), effective window (starts_at → ends_at), and duration days.
- Source API —
GET /admin/vendors/:id/membership-package returns the current open platform package (or null if none).
GET /admin/vendors/:id/customer-membership-products — lists active vendor_customer audience membership products for picking membership lines on Admin → Orders → Create (optional store_id query narrows plans scoped to that store). Matches vendor POS membership-picker filtering.
Vendor accounts power which stores exist under a tenant; vendor staff use the separate vendor web app. Operational lifecycle (invite, suspend) follows your backend and business rules; the UI exposes list and CRUD affordances above.