# PipeStock Pro tenant seed package

Seed package for turning Plumbing Supply Inventory into a configured buyer tenant with users, roles, data sources, integrations, feature flags, automations, notifications, support defaults, and launch assets.

Tenant: Riverbend Plumbing Supply
Production domain: plumbing-supply.ideas-realized.com
Preview domain: plumbing-supply.ideas-realized.com
Primary proof screen: ops
JSON manifest: /demo-library/plumbing-supply/tenant-seed-package.json

## Seed Counts

- Users: 3
- Permission scopes: 3
- Data sources: 3
- Integrations: 4
- Automations: 3
- Notifications: 2
- Feature flags: 13
- Support tickets: 5
- Launch assets: 4
- Needs client input: 3

## Users And Roles

- Maya Chen (maya.chen@riverbendplumbingsupply.example) as Counter manager: Controls SKU visibility, low-stock watch, and will-call priorities.. Permissions: Branch inventory and approval control; Approve receiving variances; Review cycle-count exceptions
- Luis Romero (luis.romero@riverbendplumbingsupply.example) as Warehouse associate: Receives POs, updates bins, and resolves picking exceptions.. Permissions: Counter lookup and will-call updates; Search SKUs; Update pickup readiness
- Dana Patel (dana.patel@riverbendplumbingsupply.example) as Buyer: Reviews reorder pressure, supplier ETAs, and PO history.. Permissions: Receiving and cycle-count workflow; Scan incoming items; Flag receiving variances

## Permission Scopes

- Scanner receiving: Branch manager, Warehouse receiver. Restricted: Variance approval, ERP post flag, Supplier cost. Launch check: Receiving variance requires manager review before export.
- Will-call readiness: Branch manager, Counter associate. Restricted: Customer pricing, Internal margin, ERP order id. Launch check: Counter role can update readiness without seeing restricted pricing.
- Cycle-count adjustment: Branch manager, Warehouse receiver. Restricted: Adjustment approval, ERP posting note, Cost variance. Launch check: Open variance stays blocked until manager approval is recorded.

## Data Sources

- [ready] SKU master from ERP item export or branch inventory spreadsheet: 250 to 1,500 SKU records. Owner: Branch operations manager. Template: /demo-library/plumbing-supply/import-templates/sku-catalog. Required fields: Product.sku, Product.description, InventoryLocation.bin, InventoryBalance.onHand
- [template] Supplier and reorder file from ERP purchasing export: 100 to 800 supplier/SKU rows. Owner: Purchasing lead. Template: /demo-library/plumbing-supply/import-templates/receiving-open-pos. Required fields: Supplier.name
- [needs-client] Will-call queue from Counter order export or inside sales spreadsheet: 20 to 90 open will-call orders. Owner: Inside sales lead. Template: /demo-library/plumbing-supply/import-templates/sku-catalog. Required fields: WillCall.orderNumber, WillCallLine.productId, WillCall.status

## Integrations

- [template] Barcode scanner input (Branch operations manager): Scanner-friendly SKU matching is scoped for browser or mobile hardware.
- [ready] CSV product import (Purchasing lead): Demo data already maps to importable SKU fields.
- [needs-client] ERP/accounting sync (Inside sales lead): Depends on the supply house source of truth and pricing model.
- [optional] Supplier catalog feed (Branch operations manager): Can be added after core inventory and PO workflow is stable.

## Feature Flags

- core_searchable_sku_catalog=on: Searchable SKU catalog. Owner: Counter manager. Enabled for pilot launch.
- core_counter_quote_desk=on: Counter quote desk. Owner: Warehouse associate. Enabled for pilot launch.
- core_counter_checkout_desk=on: Counter checkout desk. Owner: Buyer. Enabled for pilot launch.
- core_bin_and_aisle_inventory_locations=on: Bin and aisle inventory locations. Owner: Counter manager. Enabled for pilot launch.
- core_reorder_point_monitoring=on: Reorder point monitoring. Owner: Warehouse associate. Enabled for pilot launch.
- core_supplier_purchase_order_board=on: Supplier purchase order board. Owner: Buyer. Enabled for pilot launch.
- core_receiving_discrepancy_resolution=on: Receiving discrepancy resolution. Owner: Counter manager. Enabled for pilot launch.
- core_will_call_pickup_queue=on: Will-call pickup queue. Owner: Warehouse associate. Enabled for pilot launch.
- core_stock_movement_audit_trail=on: Stock movement audit trail. Owner: Buyer. Enabled for pilot launch.
- optional_barcode_scanner_mode=off: Barcode scanner mode. Owner: Branch manager. Disabled until buyer approves add-on scope.
- optional_receiving_and_partial_receipts=off: Receiving and partial receipts. Owner: Counter associate. Disabled until buyer approves add-on scope.
- optional_cycle_count_workflows=off: Cycle count workflows. Owner: Warehouse receiver. Disabled until buyer approves add-on scope.
- optional_quickbooks_or_erp_sync=off: QuickBooks or ERP sync. Owner: Branch manager. Disabled until buyer approves add-on scope.

## Automations

- [template] Low-stock reorder alert: On-hand quantity falls below approved reorder point. -> Create a purchasing review task with SKU, supplier, lead time, and current bin.. Fallback: Show low-stock SKU in branch dashboard until purchase export is configured.
- [ready] Receiving variance review: Receiving session quantity does not match purchase order quantity. -> Flag the session for warehouse lead review before stock is marked available.. Fallback: Keep variance in exception queue if ERP writeback is not enabled.
- [needs-client] Will-call readiness update: All order lines are picked or one line is marked missing. -> Update will-call status and prepare a counter-facing pickup note.. Fallback: Limit update to internal queue until customer messaging is approved.

## Notifications

- [ready] Receiving variance alert (In-app, Warehouse lead): Receiving variance needs review
- [template] Will-call ready note (In-app, Counter team): Will-call status updated

## Support Defaults

- [open/urgent] PS-SUP-331 Review cycle count variance for brass valve bin B-14: Scanner count is eight units below ERP on-hand and needs supervisor approval before export.. Owner: Warehouse lead
- [in-review/watch] PS-SUP-339 Clear will-call exception for Ferguson pickup lane: Two SKUs are staged but missing final bin scan, blocking pickup-ready status.. Owner: Counter manager
- [open/normal] PS-SUP-344 Approve PO receiving variance export: Pilot workflow can export receiving exceptions after ERP posting rules are accepted.. Owner: Branch operations owner
- [scheduled/urgent] PLUMBINGSUPPLY-SUP-700 Demo app availability: Rollback DNS alias to preview or pause launch announcement until the route passes.. Owner: Technical lead
- [scheduled/watch] PLUMBINGSUPPLY-SUP-701 Branch exceptions reviewed before ERP posting: Review analytics key, event mapping, and privacy guardrails before widening access.. Owner: Growth lead

## Launch Assets

- [ready] SKU import template: Product, bin, supplier, reorder, and price fields are defined.
- [template] Counter workflow SOP: Search, reserve, pick, receive, and adjust flows map to the app screens.
- [ready] SEO landing page: Canonical page targets plumbing supply inventory searches.
- [template] Scanner acceptance test: Test cases cover barcode lookup, bad scans, and bin verification.

## Implementation Links

- Client launch plan JSON: /demo-library/plumbing-supply/client-launch-plan.json
- Deployment launch plan JSON: /demo-library/plumbing-supply/deployment-launch.json
- OpenAPI implementation spec: /demo-library/plumbing-supply/openapi.json
- Sample data package JSON: /demo-library/plumbing-supply/sample-data-package.json