V1 Delivery Workflow (Printavo + Vendors)

A practical sequence from shop discovery to documented handoff—optimized for AI-assisted development with clear contracts and tests.

Step 1: Discovery — Shop Floor Reality

Shadow the workflow: which Printavo status means “buy blanks,” who approves substitutions, how S&S vs SanMar is chosen today, and what “done” looks like for receiving. Capture edge cases (rush, split ships, will-call).

Status trigger matrixRole mapException catalog

Step 2: Integration Contracts

Define Printavo GraphQL shapes needed for lines, SKUs, quantities, jobs, and write-back targets. Specify vendor operations (inventory batch sizes, cart limits, SOAP quirks) and error categories.

GraphQL contract docVendor capability matrixError code taxonomy

Step 3: Multi-Tenant Model

Model organizations, shops, users, and encrypted credential storage. Decide tenant-level rules storage and feature flags for phased rollout.

Tenant ERDSecrets strategyRBAC outline

Step 4: Adapter Implementation + Tests

Build vendor modules behind shared interfaces; add fixture-based tests and sandbox credentials path.

S&S adapterSanMar adapterContract test suite

Step 5: Rules Engine + PO Builder

Encode bundling logic with auditability: minimums, freight buckets, warehouse splits, rush lanes. Output proposed vendor PO drafts—not live orders until review.

Rules config schemaPO draft generatorAudit log

Step 6: Review UI + Placement

Ship branded responsive review queue; approve triggers vendor placement; capture confirmations and PO IDs.

Review screensPlacement pipelineConfirmation storage

Step 7: Receiving PDFs + Shipment Risk

Generate invoice-grouped checklists; ingest tracking where available; compute risk vs customer due dates.

PDF templatesTracking ingestionRisk banners

Step 8: Printavo Write-Back + Launch

Tasks for exceptions; expense entries for garment estimates; dry-run in staging with recorded fixtures; production cutover checklist and handoff docs.

Write-back mappingStaging sign-offRunbooks + README