╔══════════════════════════════════════════════════════════════════════════════════════════════════════╗
║ QuickWMS ECOSYSTEM ║
║ Enterprise Warehouse Management System — Reverse Logistics ║
╚══════════════════════════════════════════════════════════════════════════════════════════════════════╝
╔════════════╗ ╔════════════╗ ╔════════════╗ ╔════════════╗ ╔════════════╗ ╔════════════╗
║ Best Buy ║ ║ Target ║ ║ Amazon ║ ║ Costco ║ ║ Walmart ║ ║ Staples ║
╚═════╤══════╝ ╚═════╤══════╝ ╚═════╤══════╝ ╚═════╤══════╝ ╚═════╤══════╝ ╚═════╤══════╝
└──────────────┴──────────────┴──────┬───────┴──────────────┴──────────────┘
╔════════════╗ ╔════════════╗ ╔════════════╗│╔════════════╗ ╔════════════╗ ╔════════════╗
║ Home ║ ║ Samsung ║ ║ Apple ║│║ Lowe's ║ ║ Dell ║ ║ Other ║
║ Depot ║ ║ Direct ║ ║ Direct ║│║ ║ ║ Direct ║ ║ Retailers ║
╚═════╤══════╝ ╚═════╤══════╝ ╚═════╤══════╝│╚═════╤══════╝ ╚═════╤══════╝ ╚═════╤══════╝
└──────────────┴──────────────┴───────┴──────┴──────────────┴──────────────┘
│ EXTERNAL SUPPLIERS
│ Freight / Truckloads / Liquidation
│
┌─────────────────────────────────────────────▼──────────────────────────────────────────────────────┐
│ PHASE 0 — QUICKSALES │
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │
│ │ QuickLeadz │ │ QuickCRM │ │ QuickFinancez │ │
│ │ Buyer Disc. │ │ Relationships │ │ COGS / P&L │ │
│ └────────────────┘ └────────────────┘ └────────────────┘ │
│ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │
│ │ QuickPagez │ │ QuickEmailz │ │ QuickAssetz │ │
│ │ AI Landing │ │ AI Email Mktg │ │ Brand Assets │ │
│ │ Page Builder │ │ Resend / Tmpl │ │ Social / Blog │ │
│ └────────────────┘ └────────────────┘ └────────────────┘ │
└─────────────────────────────────────────┬──────────────────────────────────────────────────────────┘
│ Purchase Orders / Loads
▼
┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ PHASE 1 — QUICKINBOUND (:3031-3042) │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │QuickSupp- │ │ QuickPOz │ │QuickCarr- │ │ QuickBOLz │ │QuickTrackz│ │QuickLoadz │ │
│ │ lierz │ │ PO Mgmt │ │ ierz │ │ BOL Gen │ │ Tracking │ │ Truckload │ │
│ │ :3037 │ │ :3031 │ │ :3032 │ │ :3033 │ │ :3034 │ │ :3038 │ │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
│ ┌───────────┐ ┌───────────┐ │
│ │QuickManif-│ │ QuickDashz│ │
│ │ estz │ │ Overview │ │
│ │ :3036 │ │ :3042 │ │
│ └───────────┘ └───────────┘ │
└─────────────────────────────────────────┬──────────────────────────────────────────────────────────┘
│ Truckload arrives → pallets unloaded
▼
┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ PHASE 2 — QUICKPROCESSING (:8800) │
│ ┌─────────────────────────────────────────────────────────────────────────────────────────┐ │
│ │ QuickProcessing (Electron + Web App) │ │
│ │ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ │
│ │ │ QuickPalletz │──▶│ QuickIntakez │──▶│ QuickScanz │──▶│ QuickGradez │ │ │
│ │ │ Pallet Receive │ │ QLID Generate │ │ Barcode/UPC │ │ A/B/C/SCRAP │ │ │
│ │ │ PID Generation │ │ Item Receive │ │ API Lookup │ │ Assessment │ │ │
│ │ └─────────────────┘ └─────────────────┘ └─────────────────┘ └────────┬────────┘ │ │
│ │ │ │ │
│ │ ┌─────────────────┐ ┌─────────────────┐ │ │ │
│ │ │ QuickVisionz │ │ Batch Manager │◀──────────────────────────────────┘ │ │
│ │ │ AI Vision │ │ Export CSV/ │ │ │
│ │ │ Auto-Grade │ │ JSON/XLSX │ │ │
│ │ └─────────────────┘ └─────────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────┬───────────────────────────────────┬────────────────────────┘
│ Grade A/B/C → Inventory │ Needs Repair → Refurb
┌─────────────────┘ └──────────────┐
▼ ▼
┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ PHASE 3 — QUICKINVENTORYZ + QUICKLISTINGZ + QUICKMARKETSYNC │
│ ┌───────────────────────────┐ ┌───────────────────────────┐ ┌─────────────────────────┐ │
│ │ QuickInventoryz │ │ QuickListingz │ │ QuickMarketSync │ │
│ │ Stock Ledger :3026 │ │ 8 Marketplace Connectors │ │ Order Webhooks :3027 │ │
│ │ Source of Truth │ │ :3200 │ │ Inventory Sync │ │
│ └───────────────────────────┘ └───────────────────────────┘ └─────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────────────────────────────────────────┐ │
│ │ Channel Sync Engine — LISTEN/NOTIFY → push stock to all active channels │ │
│ │ BullMQ Job Queue (Redis-backed) → async listing with retry, concurrency, rate limits │ │
│ └──────────────────────────────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────────────────────────────────────┘
┌────────────────────────────────┐
│ PHASE 3b — QUICKREFURBZ │
│ QuickRefurbz (:3004) │
│ ┌────────────┐ ┌────────────┐ │
│ │ Intake & │ │ Ticket │ │
│ │ ID │ │ System │ │
│ └────────────┘ └────────────┘ │
│ ┌────────────┐ ┌────────────┐ │
│ │ 6-Stage │ │ Parts │ │
│ │ Refurb │ │ Inventory │ │
│ │ Workflow │ │ │ │
│ └────────────┘ └────────────┘ │
│ ┌────────────┐ ┌────────────┐ │
│ │ Technician │ │ Data Wipe │ │
│ │ Mgmt │ │ Certs │ │
│ └────────────┘ └────────────┘ │
└────────────────┬───────────────┘
│ WHTAG assigned → item available
▼
┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ PHASE 4 — QUICKFLOWS (:3050-3057) │
│ ┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐ │
│ │ QuickPalletz │ │ QuickTruckloadz │ │ QuickSalvagez │ │
│ │ Pallet Building │ │ Outbound Truckload │ │ Parts Harvest/ │ │
│ │ :3050 │ │ :3055 │ │ Salvage :3056 │ │
│ └─────────────────────┘ └─────────────────────┘ └─────────────────────┘ │
│ ┌─────────────────────┐ ┌─────────────────────┐ │
│ │ QuickDiscardz │ │ QuickAuctionz │ │
│ │ Recycle/Dispose │ │ Auction Lot Build │ │
│ │ :3057 │ │ → QuickBidz :3054 │ │
│ └─────────────────────┘ └─────────────────────┘ │
└──────────────────────────────────────┬──────────────────────────────────────────────────────────────┘
│ Items routed or orders received from marketplaces
▼
┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ PHASE 5 — QUICKOUTBOUND (:3060-3066) │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │QuickOrderz│ │ QuickPickz│ │ QuickShipz│ │ QuickLoadz│ │QuickReturn│ │
│ │ Order Mgmt│ │ Pick Lists│ │ Labels │ │ Outbound │ │ RMA / Insp│ │
│ │ :3060 │ │ :3061 │ │ :3062 │ │ :3063 │ │ :3064 │ │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ QuickFulfillment (:3011) │ │
│ │ Pick → Pack → Ship → Tracking (ShipStation) │ │
│ └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────────────────────────────┘
═══════════════════════════════════════════════════════════════════════════════════════════════════════
CROSS-CUTTING INFRASTRUCTURE (shared by all phases)
═══════════════════════════════════════════════════════════════════════════════════════════════════════
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ API Gateway │ │ Redis Streams │ │ PostgreSQL DB │ │ QuickAuthz │
│ :3000 │ │ Event Bus │ │ quickwms DB │ │ JWT / RBAC │
│ Unified entry │ │ Pub/Sub Sagas │ │ (all services) │ │ :3016 │
└─────────────────┘ └─────────────────┘ └─────────────────┘ └─────────────────┘
┌───────────────────────────────────────────────────────────────────────────────────┐
│ QuickData (Analytics & Reporting) │
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │
│ │ QuickScraperz │ │ QuickDashboardz │ │ QuickReportz │ │
│ │ Market pricing │ │ Real-time ops │ │ Scheduled rpts │ │
│ │ MSRP feeds │ │ dashboards │ │ PDF/CSV/Excel │ │
│ └─────────────────┘ └─────────────────┘ └─────────────────┘ │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ QuickAnalyticz │ │QuickProjections │ │
│ │ KPI engine │ │ Forecasting │ │
│ │ Trend analysis │ │ Demand planning│ │
│ └─────────────────┘ └─────────────────┘ │
└───────────────────────────────────────────────────────────────────────────────────┘
┌───────────────────────────────────────────────────────────────────────────────────┐
│ QuickAI (Shared AI Engine) │
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │
│ │ QuickClaude │ │ QuickRAG │ │ QuickBrand │ │
│ │ Claude API │ │ RAG retrieval │ │ Brand context, │ │
│ │ integration │ │ across full DB │ │ voice, assets │ │
│ └─────────────────┘ └─────────────────┘ └─────────────────┘ │
└───────────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────────────┐
│ Shared Node Packages (@quickwms/*) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
│ │ @qwms/api │ │ @qwms/ │ │ @qwms/events │ │ @qwms/enrichment │ │
│ │ REST helpers │ │ database │ │ Redis Streams│ │ SerpAPI/Rainfor- │ │
│ │ middleware │ │ PG + Drizzle │ │ Saga framework│ │ est/DataForSEO │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────────┘ │
│ ┌──────────────────────────────────────────────────────────────────────────┐ │
│ │ @quickwms/barcode-lookup — UPCItemDB, Open Food Facts, product lookup │ │
│ └──────────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────────┘
╔═══════════════════════════════════════════════════════════════════════╗
║ PHASE 0: QUICKSALES — Sales & Supplier Management ║
║ Includes: QuickLeadz · QuickCRM · QuickFinancez ║
╚═══════════════════════════════════════════════════════════════════════╝
╔══════════════╗ ╔══════════════╗ ╔══════════════╗ ╔══════════════╗ ╔══════════════╗
║ Best Buy ║ ║ Target ║ ║ Amazon ║ ║ Costco ║ ║ Walmart ║
╚══════╤═══════╝ ╚══════╤═══════╝ ╚══════╤═══════╝ ╚══════╤═══════╝ ╚══════╤═══════╝
╔══════╧═══════╗ ╔══════╧═══════╗ ╔══════╧═══════╗ ╔══════╧═══════╗ ╔══════╧═══════╗
║ Staples ║ ║ Home Depot ║ ║ Samsung ║ ║ Apple ║ ║ Lowe's/Dell ║
╚══════╤═══════╝ ╚══════╤═══════╝ ╚══════╤═══════╝ ╚══════╤═══════╝ ╚══════╤═══════╝
└────────────────┴───────────────┬┘────────────────┴────────────────┘
▼
┌──────────────────────────────────────────────────────────────────┐
│ QuickScraperz (see QuickData — Diagram 12) │
│ Market pricing / MSRP data feeds into QuickSales decisions │
└──────────────────────────────────────────────────────────────────┘
│ Pricing data
▼
┌─────────────────────┐ ┌───────────────────┐ ┌───────────────────┐
│ QuickLeadz │ │ QuickCRM │ │ QuickSupplyz │
│ │ │ │ │ │
│ Buyer discovery │ │ Contact / Deal │ │ supplierManager │
│ Enrichment │ │ Pipeline mgmt │ │ purchaseManager │
│ Outreach automation│ │ Relationship │ │ freightManager │
│ │ │ tracking │ │ │
└─────────────────────┘ └───────────────────┘ └─────────┬─────────┘
│
┌──────────────────────────────────────────────────┘
│ Creates PO + LID ↕ Sync
│ ┌─────────────────────────────────┐
│ │ QuickFinancez │
│ │ │
│ │ cogsManager → COGS per unit │
│ │ revenueManager → Sales P&L │
│ │ expenseManager → OpEx │
│ │ profitManager → Margins │
│ │ reportManager → Dashboards │
│ └─────────────────────────────────┘
│
▼
Purchase Order → flows into QuickInbound (Phase 1)
╔═══════════════════════════════════════════════════════════════════════════╗
║ PHASE 1: QUICKINBOUND (monorepo) ║
║ 9 modules, ports 3031-3042, deployed to /var/www/quickinbound ║
╚═══════════════════════════════════════════════════════════════════════════╝
╔══════════════════════════════╗
║ FREIGHT CARRIER / TRUCK ║
╚══════════════╤═══════════════╝
│
│ 1. Carrier is booked
▼
┌────────────────────────────────────────────────────────────────────────┐
│ QuickCarrierz (:3032) QuickBOLz (:3033) │
│ ┌──────────────────────────┐ ┌─────────────────────────────────┐ │
│ │ Carrier CRUD │ │ Bill of Lading generation │ │
│ │ LTL / FTL contracts │──▶│ PRO# tracking │ │
│ │ Performance tracking │ │ PDF templates │ │
│ └──────────────────────────┘ └───────────────────┬─────────────┘ │
│ │ │
│ QuickTrackz (:3034) │ │
│ ┌────────────────────▼─────────────┐ │ │
│ │ Carrier API integrations │ │ │
│ │ XPO, ODFL, TForce, UPS │ │ │
│ │ BullMQ event logging │ │ │
│ └──────────────────────────────────┘ │ │
└────────────────────────────────────────────────────────────────────────┘
│
│ 2. PO is created
▼
┌────────────────────────────────────────────────────────────────────────┐
│ QuickSupplierz (:3037) QuickPOz (:3031) │
│ ┌───────────────────────────┐ ┌────────────────────────────────┐ │
│ │ Supplier CRUD │ │ PO lifecycle management │ │
│ │ Performance ratings │──▶│ Line items + quantities │ │
│ │ Contact management │ │ LID (Load ID) integration │ │
│ └───────────────────────────┘ └────────────────────┬───────────┘ │
└────────────────────────────────────────────────────────────────────────┘
│
│ 3. Truck arrives
▼
┌────────────────────────────────────────────────────────────────────────┐
│ QuickLoadz (:3038) QuickManifestz (:3036) │
│ ┌───────────────────────────┐ ┌────────────────────────────────┐ │
│ │ Truckload building │ │ Receiving manifest upload │ │
│ │ LID → pallet grouping │──▶│ Supplier manifest vs actual │ │
│ │ Load tracking │ │ Discrepancy detection │ │
│ └───────────────────────────┘ │ COGS per line item │ │
│ └────────────────────┬───────────┘ │
└────────────────────────────────────────────────────────────────────────┘
│
│ 4. Dashboards & Settings
▼
┌────────────────────────────────────────────────────────────────────────┐
│ QuickDashz (:3042) QuickSettingz (:3041) │
│ ┌───────────────────────────┐ ┌────────────────────────────────┐ │
│ │ Executive overview │ │ Key-value config store │ │
│ │ Inbound pipeline stats │ │ Feature flags │ │
│ │ Cost summaries │ │ Per-environment settings │ │
│ └───────────────────────────┘ └────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────────┘
│
▼
Pallets ready for Processing (Phase 2)
Shared dependencies:
@quickwms/api · @quickwms/database · @quickwms/events (Redis Streams)
╔══════════════════════════════════════════════════════════════════════════╗
║ PHASE 2: QUICKPROCESSING (:8800) ║
║ Electron app + Node.js/Express + React/Vite frontend ║
║ Schema: quickprocessing (PostgreSQL) ║
╚══════════════════════════════════════════════════════════════════════════╝
┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
From Phase 1: Pallets with LID (Load ID) arrive at dock
└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ STEP 1 — QuickPalletz (/pallets) │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ • Receive pallet from LID │ │
│ │ • Generate PID (Pallet ID) → label print │ │
│ │ • Multi-pallet load management │ │
│ │ • Group units by LID │ │
│ └──────────────────────────────────────────────────────────────┘ │
│ Dashboard: Filter by status / LID / retailer — units per pallet │
└──────────────────────────────┬──────────────────────────────────────┘
│ Pallet opened, items scanned one by one
▼
┌─────────────────────────────────────────────────────────────────────┐
│ STEP 2 — QuickIntakez (/intake) │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ • Scan item barcode (or manual entry) │ │
│ │ • Generate QLID (QuickLotz Item ID) → sticker printed │ │
│ │ • Record unit cost from manifest COGS │ │
│ │ • Resolve LID / identifier │ │
│ └──────────────────────────────────────────────────────────────┘ │
└──────────────────────────────┬──────────────────────────────────────┘
│ QLID sticker applied, barcode scanned
▼
┌─────────────────────────────────────────────────────────────────────┐
│ STEP 3 — QuickScanz (integrated in intake loop) │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ • UPC / ASIN barcode lookup │ │
│ │ • @quickwms/barcode-lookup (UPCItemDB, Open Food Facts) │ │
│ │ • @quickwms/enrichment (SerpAPI, Rainforest, DataForSEO) │ │
│ │ • Product title, brand, category enrichment │ │
│ │ • Unknown → flagged for manual resolution │ │
│ └──────────────────────────────────────────────────────────────┘ │
└──────────────────────────────┬──────────────────────────────────────┘
│ Product identified
▼
┌─────────────────────────────────────────────────────────────────────┐
│ STEP 4 — QuickGradez (integrated in intake loop) │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ Hotkeys: 1/A=Grade A 2/B=Grade B 3/C=Grade C 4/S=SCRAP │ │
│ │ │ │
│ │ Grade A ──────────────────────────────┐ │ │
│ │ Grade B ──────────────────────────────┤ → QuickInventoryz │ │
│ │ Grade C ──────────────────────────────┘ (Phase 3) │ │
│ │ │ │
│ │ SCRAP ────────────────────────────────── → QuickFlows │ │
│ │ Needs Repair ─────────────────────────── → QuickRefurbz │ │
│ │ │ │
│ │ Audit sampling: supervisor spot-checks operator grades │ │
│ └──────────────────────────────────────────────────────────────┘ │
└──────────────────────────────┬──────────────────────────────────────┘
│ Grade submitted → batch updated
▼
┌─────────────────────────────────────────────────────────────────────┐
│ STEP 5 — Batch Manager (/batches) │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ • Create / close batches │ │
│ │ • Per-batch stats (count, grades, unit costs) │ │
│ │ • Export: CSV / JSON / XLSX │ │
│ └──────────────────────────────────────────────────────────────┘ │
└──────────────────────────────┬──────────────────────────────────────┘
│ Batch closed → Placement step
▼
┌─────────────────────────────────────────────────────────────────────┐
│ STEP 6 — Placement (/placement) │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ • Assign WHTAG (Warehouse Tag) → bin location │ │
│ │ • Complete QSKU (full SKU with location encoded) │ │
│ │ • Item status: AVAILABLE → signals QuickInventoryz │ │
│ └──────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────┘
│
▼
Item flows to QuickInventoryz (Phase 3)
┌────────────────────────────────────────────────────────────────────┐
│ QuickVisionz (Python/FastAPI — Raspberry Pi 5 fleet) │
│ Parallel Vision Pipeline (runs alongside manual grading) │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ pi-odea (192.168.20.216) pi-quicklotz (192.168.20.62)│ │
│ │ Hailo-10H NPU Hailo-10H NPU │ │
│ │ Fleet Manager API :8778 Fleet Manager API :8778 │ │
│ │ │ │
│ │ Stages: capture → preprocess → detect → classify → │ │
│ │ grade → label → count → read → bridge → alert │ │
│ │ │ │
│ │ QuickVisionz Web Dashboard (Next.js — localhost:3000) │ │
│ └─────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────┘
╔═════════════════════════════════════════════════════════════════════════════════════╗
║ PHASE 3: QUICKINVENTORYZ + QUICKLISTINGZ + QUICKMARKETSYNC ║
║ Stock ledger (source of truth) + marketplace listing + order sync ║
║ Ports: :3026 (Inventoryz) · :3200 (Listingz) · :3027 (MarketSync) ║
╚═════════════════════════════════════════════════════════════════════════════════════╝
Input sources:
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│QuickProcessing│ │ QuickRefurbz │ │ QuickReturnz │
│ (RECEIVE) │ │ (RECEIVE) │ │ (RESTOCK) │
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘
└─────────────────┴──────────────────┘
│ POST /api/inventory/receive
▼
┌──────────────────────────────────────────────────────────────────────┐
│ QuickInventoryz (:3026) │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ stock_ledger │ │
│ │ ┌────────────────┐ ┌───────────────────┐ │ │
│ │ │ qlid │ │ location_code │ │ │
│ │ │ quantity_on_ │ │ (BIN001, etc.) │ │ │
│ │ │ hand │ │ │ │ │
│ │ │ quantity_ │ │ unit_cost │ │ │
│ │ │ reserved │ │ received_at │ │ │
│ │ │ quantity_ │ │ status │ │ │
│ │ │ available │ │ (AVAILABLE / │ │ │
│ │ └────────────────┘ │ RESERVED / │ │ │
│ │ │ FULFILLED) │ │ │
│ │ └───────────────────┘ │ │
│ └──────────────────────────────────────────────────────────────┘ │
│ ┌─────────────────────┐ ┌──────────────────────────────────────┐ │
│ │ reservations │ │ stock_movements (audit trail) │ │
│ │ ┌────────────────┐ │ │ RECEIVE / RESERVE / RELEASE / │ │
│ │ │ order_id │ │ │ FULFILL / ADJUST_ADD / ADJUST_SUB /│ │
│ │ │ marketplace │ │ │ TRANSFER_OUT / TRANSFER_IN │ │
│ │ │ qty_reserved │ │ └──────────────────────────────────────┘ │
│ │ │ expiry │ │ │
│ │ └────────────────┘ │ ┌──────────────────────────────────────┐ │
│ └─────────────────────┘ │ alerts │ │
│ │ LOW_STOCK · OUT_OF_STOCK │ │
│ └──────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ Channel Sync Engine │ │
│ │ PostgreSQL LISTEN/NOTIFY → stock_changed event │ │
│ │ → immediately pushes to all active channels │ │
│ └──────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────┘
│ │ │
▼ ▼ ▼
Shopify eBay Amazon
Listings Listings Listings
Cycle counts → QuickCyclez (:3020)
┌──────────────────────────────────────────────┐
│ ABC-analysis schedules, variance tracking │
│ Zone/bin-level counts, recount workflows │
└──────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────┐
│ QuickListingz (:3200) + QuickMarketSync (:3027) — Also Phase 3 │
│ Listing Pipeline: Title/Desc (AI) → Pricing → Image → 8 channels │
│ MarketSync: Order webhooks → inventory reserve → outbound trigger │
└──────────────────────────────────────────────────────────────────────┘
════════════════════════════════════════════════════════
PHASE 3b: REFURBISHMENT DETOUR — QuickRefurbz (:3004)
════════════════════════════════════════════════════════
[Item flagged "Needs Repair" in QuickGradez]
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ QuickRefurbz (:3004) — JWT Auth, REST API, React frontend │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ 6-Stage Refurbishment Workflow │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ Intake │─▶│ Diag- │─▶│ Parts │─▶│ Repair │ │ │
│ │ │ & ID │ │ nostics │ │ Source │ │ & Test │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │
│ │ ┌──────────┐ ┌──────────┐ │ │
│ │ │ Grade │ │ Label │ │ │
│ │ │ & Cert │ │ & Ship │ │ │
│ │ └──────────┘ └──────────┘ │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ ticketManager│ │partsInventory│ │ technicianMgr│ │
│ │ Open/close │ │ Component │ │ Assign jobs │ │
│ │ repair tix │ │ harvesting │ │ Track output │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ Data Wipe + Certificates (NIST 800-88 compliant) │ │
│ └──────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────┘
│
│ Item repaired → POST /api/inventory/receive
▼
QuickInventoryz (:3026)
[item re-enters stock as Grade A/B]
╔══════════════════════════════════════════════════════════════════════════╗
║ PHASE 4: QUICKFLOWS (monorepo) ║
║ 6 services — items that don't go to individual online listing ║
╚══════════════════════════════════════════════════════════════════════════╝
[Item in QuickInventoryz with disposition tag assigned]
│
┌────────────────┼────────────────────────────────┐
│ │ │
▼ ▼ ▼
disposition=pallet disposition=truckload disposition=auction
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────────┐ ┌───────────────────────────┐
│ QuickPalletz │ │ QuickTruckloadz │ │ QuickAuctionz │
│ (:3050) │ │ (:3055) │ │ (:3054) │
│ │ │ │ │ │
│ Auto-assign │ │ Builds outbound │ │ Builds auction lots │
│ items to │ │ truckloads from │ │ from inventory │
│ pallet │ │ disposition=truck │ │ Pushes to QuickBidz │
│ categories │ │ items │ │ (PHP Pro Bid platform) │
│ by item type │ │ │ │ │
│ │ │ Redis + PostgreSQL │ │ quickbidz/ integration │
└─────────────────┘ └─────────────────────┘ └───────────────────────────┘
│
┌────────────────────────────────────────────
│ │ │
▼ ▼ ▼
disposition=salvage disposition=discard ╔══════════════════════╗
│ │ ║ QuickBidz Platform ║
▼ ▼ ║ quickbidz.com (PHP) ║
┌─────────────────┐ ┌─────────────────┐ ║ /var/www/quickbidz ║
│ QuickSalvagez │ │ QuickDiscardz │ ║ MariaDB + Redis ║
│ (:3056) │ │ (:3057) │ ╚══════════════════════╝
│ │ │ │
│ Parts harvest │ │ Recycling / │
│ Per-lb/inch │ │ Certified │
│ pricing │ │ disposal │
│ │ │ │
└────────┬────────┘ └────────┬────────┘
│ │
▼ ▼
QuickPartz (:3024) QuickRecyclez (:3023)
┌─────────────────┐ ┌─────────────────────┐
│ Parts catalog │ │ Recycling vendor │
│ Component │ │ Weight tracking │
│ inventory │ │ Compliance docs │
└─────────────────┘ └─────────────────────┘
All services share:
─────────────────────────────────────────────────────────
DATABASE_URL → postgresql://quickwms@localhost/quickwms
REDIS_HOST → localhost (Redis Streams event bus)
@quickwms/events → REFURB_JOB_CREATED / COMPLETED / FAILED
╔═══════════════════════════════════════════════════════════════════════════╗
║ PHASE 3 (continued): QUICKLISTINGZ + QUICKMARKETSYNC ║
║ :3200 / :3201 monitor — 8 channel connectors, BullMQ, webhook receiver ║
╚═══════════════════════════════════════════════════════════════════════════╝
[Item reaches AVAILABLE status in QuickInventoryz — WHTAG assigned]
│
(QuickMarketSync :3027 auto-publishes)
│
▼
┌──────────────────────────────────────────────────────────────────────────┐
│ QuickListingz (:3200) │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ src/index.ts — Express API server │ │
│ │ Routes: /quicklistingz/admin · /quicklistingz/webhooks │ │
│ │ /quicklistingz/monitor · /quicklistingz/inventory │ │
│ │ /quicklistingz/auction │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ Listing Generation Pipeline │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────────┐ │ │
│ │ │ Title / Desc│ │ Pricing │ │ Image optimization │ │ │
│ │ │ generation │ │ engine │ │ (resize/watermark) │ │ │
│ │ │ (AI-assisted)│ │ (% of MSRP) │ │ │ │ │
│ │ └──────────────┘ └──────────────┘ └──────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ ConnectorRegistry → 8 Marketplace Connectors │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
│ │ │ Shopify │ │ eBay │ │ Amazon │ │ │
│ │ │ Connector │ │ Connector │ │ Connector │ │ │
│ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
│ │ │ BackMarket │ │ Walmart │ │ Mercari │ │ │
│ │ │ Connector │ │ Connector │ │ Connector │ │ │
│ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │
│ │ ┌──────────────┐ ┌──────────────┐ │ │
│ │ │ Newegg │ │ Overstock │ │ │
│ │ │ Connector │ │ Connector │ │ │
│ │ └──────────────┘ └──────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ BullMQ Job Queue (Redis-backed) │ │
│ │ Listing jobs processed async — retry, concurrency, rate limits │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ State Machine — listing lifecycle │ │
│ │ DRAFT → PENDING → ACTIVE → SOLD / ENDED / CANCELLED │ │
│ └────────────────────────────────────────────────────────────────────┘ │
└───────────────────────────────────────────┬───────────────────────────────┘
│ Webhook callbacks from channels
▼
┌──────────────────────────────────────────────────────────────────────────┐
│ QuickMarketSync (:3027) │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ Inventory Sync Engine — auto-push when item becomes AVAILABLE │ │
│ │ Webhook Server — receive orders from Shopify / eBay / Amazon │ │
│ │ ShopifyClient · EbayClient · AmazonClient │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ Order received → POST /api/inventory/reserve (QuickInventoryz) │
└──────────────────────────────────────────────────────────────────────────┘
│
▼
Phase 5 — Outbound
╔══════════════════════════════════════════════════════════════════════════╗
║ PHASE 5: QUICKOUTBOUND (monorepo :3060-3066) + QuickFulfillment (:3011) ║
╚══════════════════════════════════════════════════════════════════════════╝
[Order received from marketplace via QuickMarketSync webhook]
│
▼
┌──────────────────────────────────────────────────────────────────────┐
│ QuickOrderz (:3060) │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ Order management — import from all channels │ │
│ │ Status: PENDING → PICKING → PACKED → SHIPPED → DELIVERED │ │
│ └─────────────────────────────────────────────────────────────┘ │
└──────────────────────────────┬───────────────────────────────────────┘
│ Order confirmed → pick list generated
▼
┌──────────────────────────────────────────────────────────────────────┐
│ QuickPickz (:3061) QuickFulfillment (:3011) │
│ ┌──────────────────────┐ ┌──────────────────────────────────┐ │
│ │ Pick list by WHTAG │ │ orderManager │ │
│ │ Bin walk-path opt. │──▶│ picklistManager │ │
│ │ Scan to confirm │ │ Pack workflow │ │
│ └──────────────────────┘ │ ShipStation integration │ │
│ │ Shipping label generation │ │
│ └──────────────────────────────────┘ │
│ Item packed │
└──────────────────────────────┬───────────────────────────────────────┘
▼
┌──────────────────────────────────────────────────────────────────────┐
│ QuickShipz (:3062) │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ ShipStation API · Rate shopping · Multi-carrier │ │
│ │ Tracking number → back to QuickMarketSync (notify customer) │ │
│ └─────────────────────────────────────────────────────────────┘ │
└──────────────────────────────┬───────────────────────────────────────┘
│ Item shipped → inventory.fulfill()
▼
┌──────────────────────────────────────────────────────────────────────┐
│ QuickLoadz (:3063) │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ Outbound truckload building for B2B wholesale orders │ │
│ │ Pallet manifests for outbound loads │ │
│ └─────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────┘
Returns flow back into the system:
┌──────────────────────────────────────────────────────────────────┐
│ QuickReturnz (:3064) + QuickReturnz (:3019) │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ returnManager · rmaManager · inspectionManager │ │
│ │ refundManager · restockManager │ │
│ │ │ │
│ │ Return received → Inspect → Grade → Route: │ │
│ │ Grade A/B ─────────────────────▶ QuickInventoryz restock│ │
│ │ Damaged ─────────────────────▶ QuickRefurbz │ │
│ │ Scrap ─────────────────────▶ QuickFlows/discard │ │
│ └─────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────┘
Dashboards:
┌──────────────────────────────────────────────────────────────────┐
│ QuickDashz (:3065) QuickSettingz (:3066) │
│ Outbound pipeline metrics Config store │
└──────────────────────────────────────────────────────────────────┘
╔═══════════════════════════════════════════════════════════════════════════╗ ║ CROSS-CUTTING INFRASTRUCTURE + QUICKDATA + QUICKOPS (shared by all phases)║ ╚═══════════════════════════════════════════════════════════════════════════╝ ┌──────────────────────────────────────────────────────────────────────────┐ │ API Gateway (:3000) │ │ ┌────────────────────────────────────────────────────────────────────┐ │ │ │ routes/ │ │ │ │ intake.ts · grading.ts · refurb.ts · listing.ts │ │ │ │ fulfillment.ts · manifests.ts · pallets.ts · analytics.ts │ │ │ │ items.ts · photoIdentification.ts │ │ │ │ │ │ │ │ JWT auth · Rate limiting · CORS · Swagger docs │ │ │ └────────────────────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────────┐ │ Authentication & Authorization — QuickAuthz (:3016) │ │ ┌────────────────────────────────────────────────────────────────────┐ │ │ │ userManager · roleManager · sessionManager · authService │ │ │ │ JWT tokens · RBAC roles · Refresh tokens │ │ │ │ Roles: admin / supervisor / operator / va / viewer │ │ │ └────────────────────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────────┐ │ Event Bus — @quickwms/events (Redis Streams) │ │ ┌────────────────────────────────────────────────────────────────────┐ │ │ │ RedisStreamEventBus · EventPublisher · Saga framework │ │ │ │ │ │ │ │ Event domains: intake · grading · inventory · listing │ │ │ │ fulfillment · refurb · auction │ │ │ │ │ │ │ │ Example events: │ │ │ │ ITEM_GRADED → triggers inventory RECEIVE │ │ │ │ STOCK_CHANGED → triggers channel sync │ │ │ │ ORDER_RECEIVED → triggers inventory RESERVE │ │ │ │ REFURB_JOB_CREATED / COMPLETED / FAILED │ │ │ └────────────────────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────────┐ │ QuickOps (Operational / People / Process Tools — 7 submodules) │ │ ┌──────────────────┐ ┌──────────────────┐ ┌────────────────────────┐ │ │ │ QuickTaskz │ │ QuickTeamz │ │ QuickNotificationz │ │ │ │ (:3018) │ │ (:3035) │ │ (:3017) │ │ │ │ Task mgmt │ │ Team mgmt │ │ Multi-channel notif. │ │ │ │ Assignments │ │ HR / Scheduling│ │ Slack · Email · SMS │ │ │ │ Priorities │ │ Roles · Time │ │ WhatsApp · Webhook │ │ │ │ Due dates │ │ tracking │ │ │ │ │ └──────────────────┘ └──────────────────┘ └────────────────────────┘ │ │ ┌──────────────────┐ ┌──────────────────┐ ┌────────────────────────┐ │ │ │ QuickAgentz │ │ QuickExec │ │ QuickMonitoring │ │ │ │ (:3030) │ │ │ │ │ │ │ │ AI-powered ops │ │ Executive views │ │ System health │ │ │ │ assistant │ │ P&L summaries │ │ Uptime / alerts │ │ │ │ (QuickAI │ │ Business intel │ │ Service monitoring │ │ │ │ consumer) │ │ │ │ │ │ │ └──────────────────┘ └──────────────────┘ └────────────────────────┘ │ │ ┌──────────────────┐ │ │ │ QuickNotez │ │ │ │ Internal notes │ │ │ │ Knowledge base │ │ │ │ CRUD, tags, │ │ │ │ search │ │ │ └──────────────────┘ │ └──────────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────────┐ │ QuickData (Analytics & Reporting Phase — 5 submodules) │ │ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │ │ │ QuickDashboardz │ │ QuickReportz │ │ QuickAnalyticz │ │ │ │ Real-time ops │ │ Scheduled │ │ KPI engine │ │ │ │ dashboards │ │ PDF/CSV/Excel │ │ Trend analysis │ │ │ │ │ │ Email delivery │ │ Metrics │ │ │ └──────────────────┘ └──────────────────┘ └──────────────────┘ │ │ ┌──────────────────┐ ┌──────────────────┐ │ │ │ QuickProjections │ │ QuickScraperz │ │ │ │ Forecasting │ │ Market pricing │ │ │ │ Demand planning │ │ MSRP feeds │ │ │ │ Inventory proj. │ │ │ │ │ └──────────────────┘ └──────────────────┘ │ │ KPIs: throughput / grade mix / COGS / margin / channel performance │ └──────────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────────┐ │ QuickAI (Shared AI Engine — cross-cutting, consumed by all phases) │ │ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │ │ │ QuickClaude │ │ QuickRAG │ │ QuickBrand │ │ │ │ Claude API │ │ RAG retrieval │ │ Brand context, │ │ │ │ integration │ │ across full │ │ voice, assets │ │ │ │ │ │ QuickWMS DB │ │ │ │ │ └──────────────────┘ └──────────────────┘ └──────────────────┘ │ │ Consumers: QuickAgentz · QuickListingz (AI titles) · QuickPagez · │ │ QuickEmailz · QuickVisionz · any module needing AI │ └──────────────────────────────────────────────────────────────────────────┘ QuickSales Marketing/Outreach Modules (see Phase 0): ┌──────────────────────────────────────────────────────────────────────┐ │ QuickPagez (AI-powered landing page builder) │ │ QuickEmailz (AI email marketing — Resend, campaigns, templates) │ │ QuickAssetz (brand assets, social media, blog, PR, brand voice) │ └──────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────────┐ │ Mobile — QuickMobilez-iOS │ │ Swift 5.9 / iOS 17+ · XcodeGen project │ │ Screens: Scan · Grade · Inventory · Receive · Pick │ │ Services: Authenticate · API calls to QuickWMS backend │ └──────────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────────┐ │ Shared Node Packages (@quickwms/*) │ │ @quickwms/api Shared Express middleware, response helpers │ │ @quickwms/database PostgreSQL + Drizzle ORM (all services share DB) │ │ @quickwms/events Redis Streams event bus + saga orchestration │ │ @quickwms/enrichment SerpAPI / Rainforest / DataForSEO / Keepa │ │ @quickwms/barcode- UPCItemDB / Open Food Facts / product lookup │ │ lookup │ └──────────────────────────────────────────────────────────────────────────┘ ╔══════════════════════════════════════════════════════════════════════╗ ║ Infrastructure — HetznerQL (5.78.41.196, ccx53, 128GB/32core) ║ ║ PostgreSQL 15 · Redis · nginx · PM2 · GitHub Actions CI/CD ║ ╚══════════════════════════════════════════════════════════════════════╝
| Port | Service | Description |
|---|---|---|
| :3000 | API Gateway | quickwms-cli / unified entry |
| :3002 | Quickscanz | Barcode scanning — monorepo |
| :3003 | QuickGradez | Grading — monorepo |
| :3004 | QuickRefurbz | Refurbishment — QuickFlows |
| :3006 | QuickManifestz | Manifests — monorepo |
| :3009 | Quicklistz | Listing — monorepo |
| :3011 | QuickFulfillment | Pick / pack / ship |
| :3015 | QuickInsightz | Analytics — legacy, merging into QuickData |
| :3016 | QuickAuthz | Auth / JWT |
| :3019 | QuickReturnz | RMA / returns |
| :3020 | QuickCyclez | Cycle counts |
| :3021 | QuickShipz | Shipping labels |
| :3022 | QuickFinancez | COGS / P&L |
| :3023 | QuickRecyclez | Recycling tracking |
| :3024 | QuickPartz | Parts catalog |
| :3025 | QuickDiscardz | Disposal |
| :3026 | QuickInventoryz | Stock ledger — source of truth |
| :3027 | QuickMarketSync | Marketplace webhooks |
| QuickInbound Monorepo | ||
| :3031 | QuickPOz | Purchase orders — QuickInbound |
| :3032 | QuickCarrierz | Carrier mgmt — QuickInbound |
| :3033 | QuickBOLz | Bill of lading — QuickInbound |
| :3034 | QuickTrackz | Shipment tracking — QuickInbound |
| :3036 | QuickManifestz | Receiving manifest — QuickInbound |
| :3037 | QuickSupplierz | Supplier mgmt — QuickInbound |
| :3038 | QuickLoadz | Truckload — QuickInbound |
| :3041 | QuickSettingz | Settings — QuickInbound |
| :3042 | QuickDashz | Dashboard — QuickInbound |
| QuickFlows Monorepo | ||
| :3050 | QuickPalletz | Pallet building — QuickFlows |
| :3054 | QuickAuctionz | Auction lots — QuickFlows |
| :3055 | QuickTruckloadz | Outbound truckload — QuickFlows |
| :3056 | QuickSalvagez | Salvage — QuickFlows |
| :3057 | QuickDiscardz | Discard — QuickFlows |
| QuickOutbound Monorepo | ||
| :3060 | QuickOrderz | Orders — QuickOutbound |
| :3061 | QuickPickz | Pick lists — QuickOutbound |
| :3062 | QuickShipz-Out | Shipping — QuickOutbound |
| :3063 | QuickLoadz-Out | Outbound loads — QuickOutbound |
| :3064 | QuickReturnz-Out | Returns — QuickOutbound |
| :3065 | QuickDashz-Out | Dashboard — QuickOutbound |
| :3066 | QuickSettingz-Out | Settings — QuickOutbound |
| QuickOps Submodules | ||
| :3017 | QuickNotificationz | Multi-channel notifications — Slack / Email / SMS / WhatsApp |
| :3018 | QuickTaskz | Task mgmt / assignments / priorities |
| :3030 | QuickAgentz | AI-powered ops assistant (QuickAI consumer) |
| :3035 | QuickTeamz | Team mgmt / HR / scheduling |
| :TBD | QuickExec | Executive views, P&L, BI |
| :TBD | QuickMonitoring | System health, uptime, service monitoring |
| :TBD | QuickNotez | Internal notes / knowledge base — CRUD, tags, search |
| QuickData Submodules | ||
| :TBD | QuickScraperz | Market pricing, MSRP feeds |
| :TBD | QuickDashboardz | Real-time operational dashboards |
| :TBD | QuickReportz | Scheduled reports — PDF / CSV / Excel |
| :TBD | QuickAnalyticz | KPI engine, trend analysis, metrics |
| :TBD | QuickProjections | Forecasting, demand planning |
| QuickAI / QuickSales Marketing | ||
| :TBD | QuickClaude | Claude API integration |
| :TBD | QuickRAG | RAG retrieval across full DB |
| :TBD | QuickBrand | Brand context, voice, assets |
| :TBD | QuickPagez | AI-powered landing page builder |
| :TBD | QuickEmailz | AI email marketing — Resend, campaigns, templates |
| :TBD | QuickAssetz | Brand assets, social media, blog, PR, brand voice |
| Core / Processing | ||
| :3200 | QuickListingz | Marketplace listing — :3201 monitor |
| :8800 | QuickProcessing | Intake scanning + grading |
| :8778 | QuickVisionz Fleet API | Raspberry Pi fleet manager |
╔══════════════════════════════════════════════════════════════════════════════╗
║ ITEM LIFECYCLE — End-to-End Data Flow ║
╚══════════════════════════════════════════════════════════════════════════════╝
SUPPLIERS (Best Buy, Target, Amazon, Costco, MARKETPLACE BUYER
Walmart, Staples, Home Depot, Samsung, End Customer
Apple, Lowe's, Dell, + Other Retailers) ─────────────────▶
│
│ 1. Purchase Order created in QuickPOz
│
▼
[FREIGHT TRUCK ARRIVES]
│
│ 2. LID (Load ID) resolved, pallets unloaded
│ quickloadz + quickmanifestz verify against PO
│
▼
┌──────────────┐
│ PALLET │ PID generated (PID-0001)
│ PID-0001 │
└──────┬───────┘
│
│ 3. Operator opens pallet, scans each item
▼
┌──────────────────────────────────────────────┐
│ ITEM │
│ Barcode scanned → UPC lookup → product ID │
│ QLID generated → QLID000012345 │
│ Sticker printed + applied │
└──────────────────────────────────────────────┘
│
│ 4. Graded (A/B/C) or routed out
│
├──── Grade A/B/C ────────────────────────────────────────▶ :3026
│ QuickInventoryz
│ stock_ledger
│ status=AVAILABLE
│
├──── Needs Repair ───────────────────────────────────────▶ :3004
│ QuickRefurbz
│ 6-stage repair
│ │
│ repaired ─────────────▶ back to :3026
│
└──── SCRAP ──────────────────────────────────────────────▶ QuickFlows
salvage/discard
[Item in QuickInventoryz — WHTAG assigned]
│
│ 5. Auto-publish trigger (QuickMarketSync)
▼
┌──────────────────────────────────────────────┐
│ QuickListingz (:3200) │
│ Title/desc generated → Priced at X% MSRP │
│ Published to: Shopify / eBay / Amazon / │
│ BackMarket / Walmart / Mercari │
└──────────────────────────────────────────────┘
│
│ 6. Customer places order
▼
┌──────────────────────────────────────────────┐
│ QuickMarketSync webhook (:3027) │
│ → QuickInventoryz: RESERVE(qlid, order) │
│ → QuickOutbound: create pick order │
└──────────────────────────────────────────────┘
│
│ 7. Warehouse operator picks item
▼
┌──────────────────────────────────────────────┐
│ QuickFulfillment (:3011) │
│ Pick list → Pack → Print label (ShipStation) │
│ → QuickInventoryz: FULFILL(reservation) │
│ → Customer notified with tracking │
└──────────────────────────────────────────────┘
│
│ 8. Package leaves warehouse
▼
DELIVERED ──── or ──── RETURNED
│
▼
QuickReturnz (:3019)
Inspect → Grade → Route
╔══════════════════════════════════════════════════════════════════════════════╗
║ QUICKDATA — Analytics & Reporting ║
║ Cross-cutting data layer for all phases ║
╚══════════════════════════════════════════════════════════════════════════════╝
Data Sources (all phases feed into QuickData):
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ QuickSales │ │ QuickInbound │ │QuickProcessing│ │QuickInventoryz│
│ Sales data │ │ PO / freight │ │ Grade mix │ │ Stock levels │
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘
┌──────┴───────┐ ┌──────┴───────┐ ┌──────┴───────┐ ┌──────┴───────┐
│ QuickFlows │ │QuickListingz │ │ QuickOutbound│ │ QuickBidz │
│ Disposition │ │ Marketplace │ │ Fulfillment │ │ Auction data│
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘
└────────────────┴──────────────────┴────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────────────────────┐
│ QuickData — 5 Submodules │
│ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
│ │ QuickScraperz │ │ QuickDashboardz │ │ QuickReportz │ │
│ │ Market pricing │ │ Real-time ops │ │ Scheduled │ │
│ │ MSRP feeds │ │ dashboards │ │ PDF/CSV/Excel │ │
│ │ │ │ │ │ Email delivery │ │
│ └──────────────────┘ └──────────────────┘ └──────────────────┘ │
│ ┌──────────────────┐ ┌──────────────────┐ │
│ │ QuickAnalyticz │ │ QuickProjections │ │
│ │ KPI engine │ │ Forecasting │ │
│ │ Trend analysis │ │ Demand planning │ │
│ │ Metrics │ │ Inventory proj. │ │
│ └──────────────────┘ └──────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────────────────┐ │
│ │ Data Pipeline (shared infrastructure for all 5 submodules) │ │
│ │ ETL / Aggregation · Redis Streams → PostgreSQL warehouse │ │
│ └──────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────────────────┐ │
│ │ Key Metrics & KPIs │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ Throughput │ │ Grade Mix │ │ COGS / │ │ Channel │ │ │
│ │ │ Items/hour │ │ A/B/C/Scrap │ │ Margins │ │ Performance │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ Inventory │ │ Fulfillment │ │ Return │ │ Revenue / │ │ │
│ │ │ Turnover │ │ Speed │ │ Rate │ │ P&L │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │ │
│ └──────────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────────────┘
╔══════════════════════════════════════════════════════════════════════════════════════════════╗
║ QUICKWMS — COMPREHENSIVE END-TO-END FLOW ║
║ From Supplier Sourcing to Customer Delivery ║
╚══════════════════════════════════════════════════════════════════════════════════════════════╝
╔═══════════════════════════════════════════════════════════════════════════════════════════╗
║ RETAILERS: Best Buy · Target · Amazon · Costco · Walmart · Staples · Home Depot ║
║ Samsung · Apple · Lowe's · Dell · Other Liquidation Sources ║
╚════════════════════════════════════════════╤════════════════════════════════════════════╝
│
┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─│─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
PHASE 0: QUICKSALES
│ QuickLeadz discovers deals → QuickCRM tracks pipeline → QuickFinancez calc. COGS │
QuickFinancez calculates COGS / margins ← QuickScraperz pricing (via QuickData)
│ QuickPagez (AI landing pages) · QuickEmailz (AI email marketing) · QuickAssetz (brand) │
└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─│─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
│ Purchase Order created
▼
┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
PHASE 1: QUICKINBOUND
│ │
QuickSupplierz QuickPOz QuickCarrierz QuickBOLz
│ (supplier profile) ───▶ (PO created) ──────▶ (carrier booked) ───▶ (BOL generated) │
│
│ ▼ │
QuickTrackz QuickLoadz QuickManifestz
│ (track shipment) ◀──── (truck arrives) ────▶ (verify manifest vs PO) │
└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─│─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
│ Pallets unloaded at dock
▼
┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
PHASE 2: QUICKPROCESSING (:8800)
│ │
QuickPalletz QuickIntakez QuickScanz QuickGradez
│ (receive pallet, ───▶ (scan item, ─────────▶ (UPC lookup, ──────▶ (grade A/B/C/ │
generate PID) generate QLID) enrich product) SCRAP/Repair)
│ │
│ ▼ │
QuickVisionz (AI) ┌────────────┐
│ (parallel auto-grade │Batch Manager│ │
on Raspberry Pi fleet) │(export data)│
│ └────────────┘ │
└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
┌─────────────────────────────┘ │
│ Grade A/B/C │ Needs Repair
▼ ▼
┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
PHASE 3: QUICKINVENTORYZ + QUICKLISTINGZ + QUICKMARKETSYNC
│ │
QuickInventoryz (:3026) ┌──────────────────────────┐
│ Stock Ledger ← RECEIVE item │ QUICKREFURBZ (:3004) │ │
QLID + Location + Grade + Qty │ 6-stage repair workflow │
│ On Hand / Reserved / Available │ Intake → Diagnose → │ │
Cycle Counts (QuickCyclez) │ Parts → Repair → Grade │
│ Stock Movements (full audit trail) │ → Label & Return │ │
│ ───▶ back to Inventory │
│ QuickListingz (:3200) └──────────────────────────┘ │
Listing Pipeline:
│ Title/Desc (AI) → Pricing (% MSRP) → Image opt. │
ConnectorRegistry: 8 channels
│ ┌────────┐ ┌────────┐ ┌────────┐ ┌─────────┐ ┌────────┐ │
│Shopify │ │ eBay │ │Amazon │ │BackMarkt│ │Walmart │
│ └────────┘ └────────┘ └────────┘ └─────────┘ └────────┘ │
┌────────┐ ┌────────┐ ┌────────┐
│ │Mercari │ │ Newegg │ │Overstck│ │
└────────┘ └────────┘ └────────┘
│ BullMQ job queue → async listing with retry │
QuickMarketSync (:3027) → receives orders via webhooks
│ Channel Sync Engine → LISTEN/NOTIFY → push stock to all channels │
└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─│─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
│ Order received from marketplace
▼
PHASE 4: QUICKFLOWS (disposition routing)
┌───────────────┐
│QuickPalletz │
│QuickTruckloadz│
│QuickAuctionz──│───▶ QuickBidz (quickbidz.com)
│QuickSalvagez │
│QuickDiscardz │
└───────────────┘
│
┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
PHASE 5: QUICKOUTBOUND (:3060-3066) + QuickFulfillment (:3011)
│ │
QuickOrderz QuickPickz QuickShipz
│ (import order) ──────▶ (pick list by ──────▶ (ShipStation label, ──────▶ SHIPPED │
WHTAG / bin walk) rate shopping) ▲
│ │ │
QuickFulfillment: Pick → Pack → Ship → Tracking → QuickInventoryz:FULFILL
│ │
QuickLoadz-Out (B2B wholesale truck building)
│ │
│ QuickReturnz: Return received → Inspect → Grade → Route: │
├── Grade A/B → QuickInventoryz (restock)
│ ├── Damaged → QuickRefurbz │
└── Scrap → QuickFlows/discard
└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
│
▼
╔════════════════╗
║ DELIVERED ║
║ to Customer ║
╚════════════════╝
┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
QUICKDATA (cross-cutting — feeds from ALL phases above)
│ │
QuickScraperz — market pricing, MSRP data feeds
│ QuickDashboardz — real-time operational dashboards │
QuickReportz — scheduled PDF/CSV/Excel reports, email delivery
│ QuickAnalyticz — KPI engine, metrics, trend analysis │
QuickProjections — forecasting, demand planning, inventory projections
│ │
Data Pipeline — ETL aggregation from Redis Streams → PostgreSQL warehouse
│ Key Metrics: throughput, grade mix, COGS/margins, channel performance, │
inventory turnover, fulfillment speed, return rate, revenue/P&L
└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
QUICKAI (cross-cutting — shared AI engine)
│ │
QuickClaude (Claude API) · QuickRAG (RAG retrieval across full DB) · QuickBrand
│ Consumers: QuickAgentz · QuickListingz · QuickPagez · QuickEmailz · QuickVisionz │
└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘
┌ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐
INFRASTRUCTURE (shared services across all phases)
│ │
API Gateway (:3000) · QuickAuthz (:3016) · Redis Streams Event Bus · PostgreSQL
│ QuickMobilez-iOS │
@quickwms/api · @quickwms/database · @quickwms/events · @quickwms/enrichment
│ @quickwms/barcode-lookup │
HetznerQL: 5.78.41.196, ccx53, 128GB/32core, PostgreSQL 15, Redis, nginx, PM2
│ │
QUICKOPS (cross-cutting — operational/people/process tools)
│ QuickTaskz (:3018) · QuickTeamz (:3035) · QuickNotificationz (:3017) · QuickAgentz │
QuickExec (executive views, P&L, BI) · QuickMonitoring (system health, uptime, alerts)
│ QuickNotez (internal notes / knowledge base) │
└ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┘