FBA Supply Chain Automator — Operator Manual & Real-World Execution Playbook

Living Document (v14.3): This manual walks through every panel of the FBA Supply Chain Automator (http://localhost:8080). For each step, it explains: 1. What the Step Does in the System Today ($0 Zero-API-Key Mode) 2. What the Real-World Business Step Looks Like 3. How It Operates Once Live APIs Are Connected

Quick Start: Launching the Command Center

Mode 1: Local Native Workstation ($0 Local Mode)

Start the server in PowerShell: powershell .\gradlew.bat bootRun
Open http://localhost:8080 in your browser.

Mode 2: Quick-Reference Cheat Sheet — Docker, Cloudflare Tunnel & Zero Trust Bypass

A. Docker Compose Commands (Runs Spring Boot + Postgres 17 + Cloudflare Tunnel Together)

# 1. Start (or rebuild after code/.env changes) in background
docker compose up -d --build

# 2. View live logs across the app, Postgres, and Cloudflare Tunnel
docker compose logs -f

# 3. Reload .env passcodes without rebuilding the JAR
docker compose up -d --force-recreate fba-automator

# 4. Stop all containers when finished (keeps database volume intact)
docker compose down

B. Cloudflare Tunnel CLI Commands (`ops.sammoho.com` — Tunnel `sammoho-fba`)

# 1. Start the tunnel manually in PowerShell (when running local native JAR without Docker)
cloudflared tunnel run sammoho-fba

# 2. Install as a permanent Windows Background Service (run ONCE in Admin PowerShell)
cloudflared service install

# 3. Uninstall the Windows Background Service
cloudflared service uninstall

# 4. Print the base64 tunnel token for .env / Docker / AWS Lightsail
cloudflared tunnel token sammoho-fba

C. Operator Login Passcodes (`/login.html` — Stored in Untracked `.env`)

FOUNDER_ADMIN (/): FOUNDER_ACCESS_KEY=Sammoho-Founder-2026!
OPS_MANAGER (/): OPS_MANAGER_ACCESS_KEY=Sammoho-OpsVA-2026!
WAREHOUSE_3PL (/warehouse.html): WAREHOUSE_3PL_ACCESS_KEY=Sammoho-3PL-2026!
QC_INSPECTOR (/inspector.html): QC_INSPECTOR_ACCESS_KEY=Sammoho-QC-2026!
CPA_AUDITOR (/?stage=6): CPA_AUDITOR_ACCESS_KEY=Sammoho-CPA-2026!

D. How to Configure Cloudflare Zero Trust Bypass Rules (`one.dash.cloudflare.com`)

[!IMPORTANT] Is it an Exclude rule? No! In Cloudflare Zero Trust, Exclude rules only exclude users/emails, not URL paths. To let specific URL paths (like Discord webhooks or Inspector Magic Links) bypass the Cloudflare Email PIN screen, you create a second Self-Hosted Application for those specific paths and set its Policy Action to Bypass. Cloudflare always evaluates the most-specific URL path first.

Go to one.dash.cloudflare.com → Access → Applications.
Application 1 (Main Admin Wall — Entire Domain):
Domain: ops.sammoho.com (Path: leave blank)
Policy Action: Allow
Include: Emails (your personal email) + Emails ending in (@sammoho.com)
Application 2 (Path Bypass for Signed Webhooks & Magic Links):
Click Add an application → Self-hosted.
Application Name: Sammoho Signed Webhooks & Magic Links
Click Add public hostname for each path that uses your app's own HMAC / Magic Link auth:
- ops.sammoho.com/api/v1/procurement/orders/* (Discord mobile PO decision links)
- ops.sammoho.com/inspector.html (Factory QC Inspector Magic Link portal)
- ops.sammoho.com/warehouse.html (3PL Warehouse Magic Link portal)
- ops.sammoho.com/api/v1/quality/* (Inspector AJAX API)
- ops.sammoho.com/api/v1/warehouse/* (Warehouse Blind-PO AJAX API)
Policy Name: Bypass Cloudflare Email Screen
Action: Select Bypass (NOT Allow)
Include Rule: Selector = Everyone
Click Save application.

Mode 3: 1-Click AWS Lightsail Cloud Deployment (When Ready)

Whenever you are ready to deploy to a live /mo cloud container with a free managed SSL/HTTPS domain: powershell .\deploy\lightsail\deploy-lightsail.ps1

Hosting Cost & Account Requirements Comparison Table:

Hosting Tier	Sign-Up Required	Monthly Cost	Domain & SSL	Recommended For
Local Workstation	None	$0.00	`localhost:8080` (Local only)	Research, discovery & drafting
Local Docker + Postgres	None (Docker Desktop)	$0.00	`localhost:8080` (Local only)	Testing real PostgreSQL 17
AWS Lightsail Container	AWS Account (`aws.amazon.com`)	~$7–$10/mo (3-mo free trial)	Free Managed HTTPS included	24/7 live store operations & alerts
AWS ECS Fargate + RDS	AWS Account	~$35–$45/mo	Route 53 / ALB HTTPS	Multi-million dollar 10+ SKU brands

Use the top-right navigation bar to switch between:
⚡ Admin Dashboard: Executive Portfolio KPI Banner + all 50 operational panels (Steps 1–6 and Panels 7A–7AL) + Floating ✨ AI Copilot.
🗄️ Embedded SQL Console (/h2-console): Direct SQL query editor connected to your disk database (./data/supplychain.mv.db across 49 SQL tables).

Step-by-Step Operational Guide Across All Panels

Top Banner: Executive Store Portfolio KPI Summary

API Endpoint: GET /api/v1/finance/portfolio-summary
What It Does in the System Today:
Aggregates real-time metrics across your SQL tables: Saved Candidates, Bookmarked Winners, Supplier Quotes Logged, Active SKUs, Open Purchase Orders, Total Landed Inventory Value ($), Expected Retail Revenue ($), PPC Audit Decisions, and HITL Alerts.

Panel 1: Unit Economics & Downside Liquidation Simulator

API Endpoints: POST /api/v1/economics/evaluate, POST /api/v1/economics/simulate-batch-risk
What It Does in the System Today:
Takes a candidate product's dimensions (length, width, height in inches), weight (grams), supplier factory COGS ($), tariff rate (%), target retail price ($), and estimated PPC cost per sale ($).
Deterministically classifies the product into Amazon US FBA size tiers (SMALL_STANDARD, LARGE_STANDARD, LARGE_BULKY, OVERSIZE_REJECTED) and computes exact FBA fulfillment fees, 15% referral fees, 5% return reserves, Air ($6.00/kg) vs. Sea ($1.50/kg) freight, and net margins using strict BigDecimal math.
Simulates a 100-unit test batch and calculates:
- Total Capital at Risk ($): Inventory landed cost + launch PPC/Vine budget.
- Cash Recovery Breakeven Units: How many units out of 100 you must sell to recover 100% of your upfront cash.
- Worst-Case Flop Liquidation Outcome ($ & % Loss): If the product flops after 15 sales and you slash the remaining 85 units by 35% to liquidate, exactly how much cash you recover or lose.
What the Real-World Step Looks Like:
While browsing Amazon and Alibaba/1688, you spot a niche product selling for $27.99 and see factories quoting ~$3.20/unit. Before spending a single dollar on samples or tooling, you run this simulator to prove that even if the launch completely fails, your maximum downside loss is capped at ~$150–$250, while a successful batch yields >22% Sea Net Margin.
Future State with Live APIs Connected:
Amazon SP-API Product Fees API (getMyFeesEstimateForASIN) and Keepa package dimension history automatically populate exact FBA fulfillment fees and historical Buy Box prices.

Panel 2: Product Discovery & Zero-Key Competitor Review Miner

API Endpoints: GET /api/v1/discovery/sandbox-scan, POST /api/v1/discovery/evaluate-candidate, GET /api/v1/discovery/saved-candidates, POST /api/v1/discovery/saved-candidates/{asin}/toggle-bookmark
SQL Table: candidate_products
What It Does in the System Today:
Click "+ Paste Custom Product" to paste any real Amazon ASIN, Buy Box price, BSR, review count, star rating, factory COGS estimate, and raw 1-to-3 star customer reviews copied from an Amazon product page.
The ReviewDefectAnalyzerService scans those negative reviews for 6 structural defect categories (structural breakage, rust/corrosion, weak adhesives/magnets, warping/splintering, dimensional mismatch, missing accessories), calculates a deterministic 0–100 Opportunity Score, prescribes a specific Factory Engineering Fix, and saves the candidate to candidate_products.
Click ☆ Bookmark to shortlist winners.
What the Real-World Step Looks Like:
You look for "vulnerable demand" on Amazon: products ranked BSR #2,000–#20,000 where customers are buying heavily despite a 3.6★–4.1★ rating because existing sellers ship cheap, flawed versions. By reading their 1-to-3 star reviews, you tell your factory to fix the exact defect (e.g., upgrading 0.8mm iron welds to 304 stainless steel) so your product launches with a permanent structural moat.
Future State with Live APIs Connected:
A scheduled weekly job queries the Keepa Product Finder API (product & query endpoints) for ASINs matching your exact BSR/price/rating filters, pulls negative review snippets automatically, and populates candidate_products while you sleep.

Panel 2B: Alibaba / 1688 Supplier RFQ & Amazon Listing Launch Studio

API Endpoints: POST /api/v1/sourcing/generate-rfq/{asin}, POST /api/v1/listing/generate-pack/{asin}
SQL Table: product_launch_packs
What It Does in the System Today:
Click "RFQ & Listing Pack" on any candidate in Panel 2.
Left Pane (Supplier RFQ Generator): Generates a complete B2B Request for Quotation (RFQ) message specifying your 18% EXW/FOB unit cost ceiling, 100-unit Air Test Batch vs. 500-unit Sea Batch pricing tiers, mandatory engineering upgrades from competitor defects, FNSKU barcode labeling, and 1.2m drop-test packaging requirements. Click "Copy B2B Supplier RFQ Message" to copy it to your clipboard.
Right Pane (Amazon Listing & PPC Launch Pack): Generates a <200-character SEO Title, 5 benefit-driven bullet points that explicitly counter competitor complaints, backend search terms (<249 bytes), and Day-1 Exact Match PPC launch keywords.
What the Real-World Step Looks Like:
You paste the generated RFQ message directly into Alibaba Trade Messenger, WeChat, or your 1688 sourcing agent's portal to request quotes from 5–10 verified manufacturers. Later, when creating your product listing in Amazon Seller Central (Catalog -> Add Products), you copy the generated Title, 5 Bullets, and Backend Keywords into your listing draft.
Future State with Live APIs Connected:
One click pushes the listing draft directly to Amazon Seller Central via the SP-API Listings Items API (putListingsItem) in INACTIVE (draft) status and creates a paused Exact Match campaign via the Amazon Ads Sponsored Products API.

Panel 3: Supplier Quote Comparison & Bid Matrix

API Endpoints: GET /api/v1/sourcing/quotes, POST /api/v1/sourcing/quotes, POST /api/v1/sourcing/quotes/{id}/promote-to-mvp
SQL Table: supplier_quotes
What It Does in the System Today:
Click "+ Log New Supplier Quote" as factories reply to your RFQ with their MOQ, unit COGS, FNSKU prep fee, DDP Air batch freight cost, DDP Sea batch freight cost, and production lead times.
Calculates the true All-In Air Landed Unit Cost, All-In Sea Landed Unit Cost (including 7.5% tariff), Total Upfront Air Batch Cash, and Air/Sea Net Margins, sorting factories from highest to lowest margin.
Clicking "★ Select Winner → Create MVP & PO" atomically:
1. Marks that supplier as the selected winner in supplier_quotes.
2. Creates/updates the SKU in your Active Store Catalog (active_skus).
3. Seeds a 30-Day MVP Launch Scorecard (mvp_launch_batches).
4. Drafts the initial Purchase Order (purchase_orders) in AWAITING_APPROVAL status.
What the Real-World Step Looks Like:
Factories quote in confusing ways (some quote EXW without prep, others quote FOB or DDP). Logging their numbers into this matrix normalizes every quote onto an apples-to-apples landed margin basis so you never pick a "cheap" unit price that gets destroyed by freight or prep fees.
Future State with Live APIs Connected:
Inbound supplier quote emails/webhooks or CSV quote sheets from your freight forwarder auto-populate the bid matrix and attach freight forwarder live rate cards.

Panel 3B: Pre-Shipment Quality Control (ISO 2859-1 AQL 2.5) & Master Carton Compliance Gate

API Endpoints: GET /api/v1/quality/inspections, POST /api/v1/quality/inspections
SQL Table: quality_inspections
What It Does in the System Today:
Evaluates factory pre-shipment inspection results against international ISO 2859-1 General Inspection Level II (AQL 2.5 Major / AQL 4.0 Minor) sampling rules.
Checks Drop Test, FNSKU Barcode Scannability, and Amazon FBA Master Carton Box Limits (rejecting or holding boxes exceeding 25.0 inches on any side or 50.0 lbs gross weight).
Issues an objective verdict:
- PASSED_RELEASE_70_PCT_BALANCE: Safe to wire the remaining 70% balance to the factory and authorize shipment.
- CONDITIONAL_HOLD_REWORK_REQUIRED: Factory must repackage overweight cartons or rework defects before shipping.
- REJECTED_DO_NOT_SHIP: Critical defects or unscannable FNSKU barcodes detected; withhold payment.
What the Real-World Step Looks Like:
Before wiring the final 70% payment to your Chinese supplier, you (or a $150 third-party inspector like QIMA / V-Trust, or your 1688 agent) inspect a random sample of units and measure the master shipping cartons. If a factory packs a 54-lb carton, Amazon FBA will fine you $25–$75 per box or refuse delivery—this gate catches it at the factory floor while you still hold 70% payment leverage.
Future State with Live APIs Connected:
Inspection reports from QIMA/V-Trust or 3PL receiving webhooks automatically post to /api/v1/quality/inspections and block PO state transitions to IN_TRANSIT_TO_FBA unless verdict == PASSED_RELEASE_70_PCT_BALANCE.

Panel 3C: Customs HTS Tariff Optimizer & LCL Sea Freight CBM Consolidator

API Endpoint: POST /api/v1/customs/optimize-hts-and-cbm
What It Does in the System Today:
Recommends the specific US Harmonized Tariff Schedule (HTS) code for your product material category (BAMBOO_WOOD, SILICONE_PLASTIC, STAINLESS_STEEL, TEXTILE_FABRIC, CERAMIC_GLASS, ELECTRONICS_LED), separating Base MFN Duty % from China Section 301 Tariff %, and calculates exact duty savings if sourced from a Non-Section-301 country (Vietnam/India/Mexico).
Computes total Master Carton Cubic Meters (CBM) against the standard 2.000 CBM LCL Ocean Freight minimum billing floor.
Tells you exactly how many Free Extra Units (freeExtraUnitsFittingInPaidCbm) you can add to your factory order for $0 additional ocean freight cost to fill dead air inside your paid 2.000 CBM minimum allocation!
What the Real-World Step Looks Like:
Ocean LCL freight forwarders charge a 2.0 CBM minimum. If a 500-unit order is only 1.15 CBM, you are paying for 0.85 CBM of empty space. By increasing your order to ~560–800 units to hit 2.00 CBM, your ocean freight cost per unit drops dramatically.
Future State with Live APIs Connected:
Integrates with USITC HTS REST API and Flexport / Freightos Ocean LCL live rate APIs during PO generation.

Panel 3D: Regulatory Compliance, USDA Lacey Act / FDA & Brand Protection Vault

API Endpoints: GET /api/v1/compliance/records, POST /api/v1/compliance/records
SQL Table: sku_compliance_records
What It Does in the System Today:
Tracks mandatory US Customs & Amazon Product Compliance documentation per SKU:
- 19 U.S.C. 1304 Country of Origin Marking ("Made in China" permanently printed on every unit and master carton—mandatory to avoid a 10% US Customs marking penalty or seizure).
- USDA APHIS Lacey Act PPQ Form 505 (mandatory for bamboo/wood products).
- FDA 21 CFR Food-Contact / BPA-Free Lab Report (mandatory for kitchenware/food-contact items).
- UL / FCC / CPC Third-Party Safety Lab Certificates (mandatory for electronics/children's items).
- USPTO Trademark & Amazon Transparency 2D Serialization (protects your listing against counterfeit hijackers).
Issues a Compliance Readiness Score (0–100) and a hard gate (CLEARED_FOR_IMPORT_AND_FBA, CONDITIONAL_WARNING_IP_UNPROTECTED, or BLOCKED_MISSING_MANDATORY_CERTS).
What the Real-World Step Looks Like:
Competitors often trigger automated Amazon compliance sweeps during peak season. Having your factory's FDA 21 CFR, Lacey Act PPQ 505, or CPC lab test report on file before importing ensures US Customs clears your shipment in hours and Amazon Account Health approves your listing without interruption.
Future State with Live APIs Connected:
Syncs with Amazon SP-API Account Health / Compliance Requirements API to alert you immediately if Amazon requests a new safety certificate on any ASIN.

Panel 4: 30-Day MVP Launch Scorecard & Mathematical Go / No-Go Gate

API Endpoints: GET /api/v1/launch/scorecards, POST /api/v1/launch/scorecards, POST /api/v1/launch/scorecards/{sku}/execute-verdict
SQL Table: mvp_launch_batches
What It Does in the System Today:
Tracks your 100-unit Air Freight validation batch across Impressions, Ad Clicks, CTR %, Orders, Conversion Rate (CVR %), Daily Velocity, TACoS %, and Upfront Cash Recovered %.
Issues a deterministic verdict:
- SCALE_TO_SEA_FREIGHT ($\text{CVR} \ge 10\%$ and $\text{Velocity} \ge 3.0\text{ units/day}$): Click "🚢 Execute: Draft 500u Sea Freight PO" to automatically transition the SKU to Sea Freight landed costs (30% lower than air) and generate a 500-unit Sea PO in Panel 6.
- KILL_AND_LIQUIDATE_AT_BREAKEVEN ($\ge 80\text{ clicks}$ and $\text{CVR} < 5\%$): Click "⚡ Execute: Slash SKU to Floor" to slash the active SKU's retail price in Panel 5 to its break-even liquidation floor and halt future reorders.
- TUNE_MAIN_IMAGE_OR_PPC / COLLECTING_INITIAL_DATA: Tells you whether to fix the hero image (if CTR < 0.45%) or enroll in Amazon Vine (if CVR is 5%–10%).
What the Real-World Step Looks Like:
Emotion is the enemy of e-commerce. Instead of falling in love with a losing product or hesitating on a winner, you look at the first 14–30 days of real customer clicks and orders. Winners graduate to 500-unit Ocean Freight containers where margins jump from ~10% to >28%; losers get liquidated immediately to recycle ~80% of your capital into the next candidate.
Future State with Live APIs Connected:
Nightly sync with Amazon SP-API Sales & Traffic Business Reports and Amazon Ads Campaign Reports updates mvp_launch_batches automatically and sends a Slack/Discord alert the moment a batch crosses the SCALE_TO_SEA_FREIGHT threshold.

Panel 4B: Working Capital, 30/70 Supplier Terms & Cash Flow Runway Gate

API Endpoint: GET /api/v1/finance/working-capital?bankroll={bankroll}&minReserve={minReserve}
What It Does in the System Today:
Aggregates live SQL data across active_skus and purchase_orders.
Models 30% upfront factory deposits vs. 70% pre-shipment balances, Active Transit POs locked, and Projected 30-Day Amazon Net Payouts (58% net disbursement after Amazon fees & ad reserve).
Enforces a Treasury Safety Gate (SAFE_TO_APPROVE_OPEN_POS, STAGE_30_70_SUPPLIER_TERMS, or BANKROLL_RESERVE_BREACH_RISK).
What the Real-World Step Looks Like:
Before clicking "Approve & Order" on a Purchase Order in Panel 6, you check Panel 4B to ensure that paying the 30% factory deposit today and the 70% balance upon production completion won't dip your bank account below your safety reserve while waiting on Amazon's 14-day settlement cycle.
Future State with Live APIs Connected:
Connects to Amazon SP-API Finances API (listFinancialEventGroups) for exact pending settlement balances and Mercury/Plaid bank balances for live treasury gating.

Panel 5: Active Store SKU Catalog & Inline Stock / Velocity Editor

API Endpoints: GET /api/v1/procurement/skus, POST /api/v1/procurement/skus/{sku}/inventory, POST /api/v1/automation/run-catalog-cycle
SQL Table: active_skus
What It Does in the System Today:
Displays all active SKUs with inline editable inputs for Available FBA Units, Inbound Units, 7d / 30d Sales, and Retail Price ($).
Clicking "Run 6-Hour Inventory Check Across All Active SKUs" runs the SupplyChainOrchestratorService:
- Computes weighted daily velocity ($60\% \times 7\text{d avg} + 40\% \times 30\text{d avg}$).
- Computes Reorder Point ($\text{ROP} = \text{Velocity} \times (\text{Lead Time} + \text{Safety Stock})$).
- If stock $\le \text{ROP}$, drafts a new Purchase Order in AWAITING_APPROVAL (while skipping duplicates if an open PO already exists).
- If Days of Supply $< 15\text{ days}$, automatically triggers a +12% Defensive Retail Price Hike to slow down velocity and protect organic keyword rank from a stockout.
What the Real-World Step Looks Like:
Running out of stock on Amazon is catastrophic—your Best Seller Rank (BSR) and organic keyword ranking collapse within 72 hours of hitting 0 inventory. This engine ensures you always reorder ahead of your factory + freight lead time and raises prices defensively if a shipment is delayed.
Future State with Live APIs Connected:
Runs automatically every 6 hours via @Scheduled cron or AWS EventBridge, pulling live FBA inventory (getInventorySummaries) and order velocity (getOrderMetrics) from Amazon SP-API.

Panel 5B: Amazon FBA Storage Fee, Low-Inventory Surcharge & Q4 3PL Drip-Feed Optimizer

API Endpoint: POST /api/v1/storage/optimize-q4-and-ipi
What It Does in the System Today:
Computes your SKU's cubic-foot volume and evaluates three critical Amazon FBA inventory fee traps:
1. Q4 Peak Storage Rate Surge (Oct–Dec): Amazon charges $2.40/cu.ft/month in Q4 vs. $0.87/cu.ft/month in Jan–Sep.
2. Low-Inventory-Level Penalty (<28 Days of Supply): Flags if your stock drops below 28 days ($0.32–$0.89/unit surcharge).
3. 180+ Day Aged Inventory Surcharge: Computes penalties on stagnant units ($1.50/cu.ft or $0.15/unit min).
Calculates the Optimal 45-Day FBA Target Stock ("Goldilocks Zone"), recommends how many excess units to hold at your 3PL warehouse (@ $0.45/cu.ft) for drip-feeding into FBA, and computes your Monthly Q4 3PL Drip-Feed Savings ($) and IPI Score Health Band.
What the Real-World Step Looks Like:
Sending 500+ units directly into Amazon FBA in October/November causes massive Q4 storage fees. Instead, experienced sellers keep ~45 days of inventory inside FBA and hold the remaining master cartons at a cheap domestic 3PL ($0.45/cu.ft vs Amazon's $2.40/cu.ft), drip-feeding boxes into FBA as stock sells through.
Future State with Live APIs Connected:
Pulls Amazon SP-API FBA Inventory Age & Planning Reports (GET_FBA_STORAGE_FEE_CHARGES_DATA and GET_FBA_INVENTORY_PLANNING_DATA) and automatically generates 3PL-to-FBA replenishment work orders whenever FBA stock approaches 32 days of supply.

Panel 6: Purchase Order State Machine & 3PL-to-FBA Label Handoff

API Endpoints: GET /api/v1/procurement/orders, POST /api/v1/procurement/orders/{id}/approve, POST /api/v1/automation/orders/{id}/auto-3pl-fba-handoff, POST /api/v1/procurement/orders/{id}/ship-to-fba, POST /api/v1/procurement/orders/{id}/close
SQL Table: purchase_orders
What It Does in the System Today:
Enforces a strict, auditable state machine: AWAITING_APPROVAL $\rightarrow$ SUPPLIER_ORDERED $\rightarrow$ ARRIVED_AT_3PL $\rightarrow$ FBA_LABELS_GENERATED $\rightarrow$ IN_TRANSIT_TO_FBA $\rightarrow$ CLOSED (or REJECTED).
Clicking "Simulate 3PL Arrival + Auto FBA Labels" executes the 1-step automated handoff: records the 3PL warehouse receipt, generates the Amazon FBA Inbound Shipment Plan + FNSKU/Carton PDF label bundle, and dispatches work instructions to the 3PL prep center.
What the Real-World Step Looks Like:
You approve the PO (Human-in-the-Loop capital control), pay the supplier via Alibaba Trade Assurance, track arrival at your freight forwarder/3PL prep center, generate FBA box labels in Seller Central (Send to Amazon), and close the PO once Amazon checks the units into fulfillment centers.
Future State with Live APIs Connected:
When your 3PL WMS fires an ASN_RECEIVED webhook, the system automatically calls Amazon SP-API Fulfillment Inbound v2024-03-20 (createInboundPlan, generatePlacementOptions, getLabels) and forwards the PDF carton labels to your 3PL via API with zero manual clicks.

Panel 6B: Dynamic Profit-First Buy Box Repricer & FBA Cubiscan Overcharge Auditor

API Endpoints: POST /api/v1/pricing/evaluate-reprice, POST /api/v1/pricing/audit-fba-overcharge
What It Does in the System Today:
Dynamic Buy Box Repricer: Evaluates your price, lowest competitor FBA price, days of supply, and landed costs to recommend an optimal price (MATCH_COMPETITOR_BUY_BOX, HOLD_MARGIN_FLOOR_GUARD, DEFENSIVE_LOW_STOCK_SURGE_PLUS_12_PCT, AGED_INVENTORY_VELOCITY_DISCOUNT_MINUS_8_PCT, or PREMIUM_MONOPOLY_EXPANSION_PLUS_5_PCT) while never dropping below your hard minimum net margin floor.
FBA Cubiscan Fee Discrepancy Auditor: Compares your verified packaging dimensions/weight against the FBA fee Amazon is actually billing you. If Amazon's warehouse Cubiscan mismeasured a stray packaging flap and bumped your product into a higher fee tier, it calculates the exact Per-Unit Overcharge ($), Total Historical Reimbursement Owed ($), and generates a Ready-to-Copy Seller Central Case Log Ticket.
What the Real-World Step Looks Like:
Competitors frequently start irrational price wars, and Amazon's warehouse scanners mismeasure ~5%–10% of FBA catalog items. The repricer stops you from selling at a loss during competitor price wars, and the Cubiscan auditor recovers hundreds or thousands of dollars in overcharged FBA fees via Seller Support reimbursement cases.
Future State with Live APIs Connected:
Listens to Amazon SP-API ANY_OFFER_CHANGED EventBridge notifications for real-time repricing and audits SP-API GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA reports weekly to flag Cubiscan overcharges automatically.

Panel 7: Nightly PPC Bleed-Protection & Zero-Key Seller Central Search Term CSV Importer

API Endpoints: POST /api/v1/ppc/evaluate-search-terms, POST /api/v1/ppc/import-csv
SQL Table: ppc_decision_logs
What It Does in the System Today:
Click "+ Paste Seller Central Search Term CSV" to paste raw rows from any Amazon Sponsored Products Search Term Report (CSV or TSV).
Applies deterministic rules:
1. Stop the Bleed (ADD_NEGATIVE_EXACT): $\ge 10\text{ clicks}$ or $\ge \$10.00\text{ spend}$ with $0\text{ orders}$.
2. Scale Winners (PROMOTE_TO_EXACT_AND_RAISE_BID): $\ge 3\text{ orders}$ and $\text{ACoS} < 20\%$ (+10% bid).
3. Protect Margin (LOWER_BID_HIGH_ACOS): $\text{ACoS} > \text{Target Max ACoS}$ (-15% bid).
Generates a downloadable amazon_ads_bulk_operations_upload.csv file ready to upload directly into Seller Central Campaign Manager.
What the Real-World Step Looks Like:
In Seller Central (Advertising -> Campaign Manager -> Measurement & Reporting -> Sponsored Ads Reports), you download your Search Term Report, paste it into Panel 7, download the generated Bulk Operations CSV, and upload it under Sponsored Ads -> Bulk Operations to negate all bleeding search terms and scale winners in 60 seconds.
Future State with Live APIs Connected:
Runs nightly at 2:00 AM via the Amazon Advertising API v3 (/sp/targets/reports, /sp/negativeKeywords, /sp/keywords), negating bleed terms and adjusting bids autonomously.

Panel 7B: Customer Return Root-Cause Analyzer, Carrier-Damage Reimburser & Voice-of-the-Customer (VoC) Shield

API Endpoints: GET /api/v1/returns/audits, POST /api/v1/returns/audits
SQL Table: return_defect_audits
What It Does in the System Today:
Breaks down 30-day SKU returns into four buckets: Amazon-Fault Carrier/Warehouse Damage, Factory Manufacturing Defects, Listing Expectation / Size Mismatch, and Customer Remorse.
Computes Total Return Rate %, NCX Defect Rate %, and Estimated Amazon-Fault Carrier Damage Reimbursement Owed ($) (carrierDamagedUnits * 85% of retail price).
Evaluates Voice of the Customer (VoC) Listing Suspension Risk (HEALTHY_GREEN, ELEVATED_WATCH_YELLOW, CRITICAL_SUSPENSION_RISK_RED) and generates a targeted Corrective Action Plan (CAPA) so you fix listing or factory issues before Amazon suppresses your ASIN.
What the Real-World Step Looks Like:
If a SKU exceeds an 8% return rate or 5% NCX rate, Amazon slaps a "Frequently Returned Item" badge on your listing or suspends it until you submit a Root-Cause Plan of Action. Furthermore, Amazon often blames sellers for units crushed by UPS/Amazon delivery drivers (CARRIER_DAMAGED)—auditing these lets you claim 85% net reimbursement when Amazon fails to auto-reimburse within 45 days.
Future State with Live APIs Connected:
Automatically ingests Amazon SP-API GET_FBA_FULFILLMENT_CUSTOMER_RETURNS_DATA reports weekly, logs audits to return_defect_audits, and alerts you via Slack/Discord if any SKU enters ELEVATED_WATCH_YELLOW or CRITICAL_SUSPENSION_RISK_RED.

Panel 7C: Live Regulatory, Tariff & Fee Schedule Registry + Catalog "Rate Shock" Simulator

API Endpoints: GET /api/v1/policy/rates, POST /api/v1/policy/rates, POST /api/v1/policy/simulate-rate-shock
SQL Table: policy_rate_schedules
What It Does in the System Today:
Stores your live, editable benchmark rates in SQL (CHINA_SECTION_301_TARIFF_PCT, FBA_SMALL_STD_BASE_FEE_USD, FBA_LARGE_STD_BASE_FEE_USD, FBA_Q4_PEAK_STORAGE_CUFT_USD, SEA_LCL_RATE_PER_CBM_USD, MIN_REQUIRED_SEA_MARGIN_PCT) along with each rate's reviewCadenceDays (14d for Freight, 30d for USITC HTS Tariffs, 90d for Amazon FBA Fee Schedules) and auditFreshnessStatus (FRESH_VERIFIED, APPROACHING_REVIEW_WINDOW, STALE_AUDIT_DUE).
Includes a Regulatory & Fee "Rate Shock" Stress-Test Simulator: enter any sudden tariff hike (e.g., +17.5% China Section 301 hike), FBA fee increase (+$0.45/unit), or freight surge (+$0.35/unit) and immediately see:
- Pre-Shock vs. Post-Shock Net Profit & Margin %
- Exact Retail Price Increase (+$X.XX) Required to Restore Your 22% Margin Floor (accounting for the fact that Amazon takes 15% referral fee on the price increase itself: $\text{NewPrice} = \frac{\text{TotalNonReferralCostsAfterShock}}{0.85 - \text{TargetMargin}}$).
- Exact Factory FOB Cost Reduction (-$Y.YY) Required if you cannot raise retail price due to competitors.
What the Real-World Step Looks Like:
Instead of getting blindsided when Amazon announces its annual January FBA fee increase or when USTR raises Section 301 tariffs, you update the rate in policy_rate_schedules and run the Rate Shock Simulator to know whether to raise your retail price by $1.50 or negotiate a $0.35 FOB discount with your supplier before your next PO.
Future State with Live APIs Connected:
Automatically polls the free public USITC HTS REST API (https://hts.usitc.gov/reststop/search) monthly for tariff changes and Amazon SP-API Product Fees API (getMyFeesEstimateForASIN) weekly for FBA fee changes.

Panel 7D: Bi-Weekly Amazon Settlement Payout Reconciler, Hidden Fee Leakage Auditor & CPA Accounting Ledger

API Endpoints: GET /api/v1/ledger/settlements, POST /api/v1/ledger/settlements, GET /api/v1/ledger/export-cpa-csv
SQL Table: sku_settlement_ledgers
What It Does in the System Today:
Reconciles your bi-weekly Amazon Settlement Payouts per SKU: takes Gross Sales ($), Refund Deductions ($), Expected Amazon Fee/Unit ($) vs. Actual Deducted Amazon Fees ($), Storage/Placement Fees ($), PPC Ad Spend ($), FBA Reimbursements Credited ($), and Unit Landed COGS ($).
Computes Net Amazon Bank Deposit ($), Total Landed COGS Sold ($), Realized Net Profit ($), Realized Net Margin %, and Hidden Fee Leakage ($) (actualAmazonFeesDeductedUsd - expectedAmazonFeesUsd).
Flags ALERT_UNEXPLAINED_AMAZON_FEE_LEAKAGE whenever Amazon deducts $\ge \$25.00$ or $>2\%$ more in fees than your SKU's verified size tier should cost, or WARNING_MARGIN_COMPRESSION if realized margin drops below 22%.
Includes a 1-Click Download CPA / QuickBooks / Tax CSV Journal button (GET /api/v1/ledger/export-cpa-csv).
What the Real-World Step Looks Like:
Every 14 days when Amazon wires your disbursement to your bank account, you reconcile the settlement in Panel 7D to verify that what landed in your bank account minus the Landed COGS of units sold actually matches your projected unit economics—and export the clean CSV for your CPA or QuickBooks.
Future State with Live APIs Connected:
Automatically ingests Amazon SP-API GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_V2 every 14 days, reconciles every SKU line item against active_skus and policy_rate_schedules, and triggers a Cubiscan Reimbursement claim whenever feeDiscrepancyLeakageUsd > 0.

Panel 7E: Geopolitical Tariff Horizon Radar, CBP Entry-Date Collision Detector & Inventory Front-Loading Arbitrage (`geopolitical_tariff_events` table)

API Endpoints: GET /api/v1/geopolitics/events, POST /api/v1/geopolitics/events, POST /api/v1/geopolitics/evaluate-po-horizon
SQL Table: geopolitical_tariff_events
What It Does in the System Today:
Tracks upcoming political & regulatory tariff changes (such as USTR Federal Register 60-day Section 301 tariff notices or Section 321 De Minimis restrictions) before they take effect (daysUntilEffective, currentDutyPct, proposedDutyPct, enactmentProbabilityPct).
CBP Customs Entry-Date Collision Detector: Under US Customs law (19 CFR § 141.68), the tariff rate you pay is based on the day your vessel enters the US port of entry, NOT the day you placed your Purchase Order! Because factory production (~22 days) + ocean transit (~32 days) takes 54+ days, a tariff hike taking effect in 60 days will hit any PO placed more than 6 days from today (COLLISION_ARRIVES_AFTER_TARIFF_HIKE).
Calculates the Last Safe Day to Place PO (lastSafeDayToPlacePoFromToday) to clear US Customs before the hike, and computes Front-Loading Arbitrage Net Savings ($): how much cash you save by front-loading extra units today and holding them in a US 3PL ($0.45/cu.ft/mo) vs. paying the higher tariff in 60 days.
What the Real-World Step Looks Like:
When a political event or USTR 60-day public comment notice is published in the Federal Register, you log the proposed tariff and effective countdown in Panel 7E and run the PO Horizon Evaluator. If your netFrontLoadingArbitrageSavingsUsd is positive (e.g., saving +$271.50 in customs duties minus $8.10 in 3PL storage = +$263.40 net savings), you place your PO immediately before lastSafeDayToPlacePoFromToday so your container clears Long Beach before the tariff goes live.
Future State with Live APIs Connected:
Automatically monitors Federal Register REST API (https://www.federalregister.gov/api/v1/documents.json filtered by agency=trade-representative and customs-and-border-protection) daily to detect 30/60/90-day USTR tariff notices and alert you to front-load affected SKUs.

Panel 7F: Global Supply Chain Blackout Calendar (Chinese New Year / Golden Week / Q4 Peak) & Lead-Time Buffer Adjuster (`global_supply_calendar_events` table)

API Endpoints: GET /api/v1/calendar/events, POST /api/v1/calendar/evaluate-blackout-buffer
SQL Table: global_supply_calendar_events
What It Does in the System Today:
Tracks predictable global factory and port blackout windows (CNY-FACTORY-SHUTDOWN, CHINA-GOLDEN-WEEK-OCT, AMAZON-Q4-FBA-CHECKIN-RUSH) along with their exact additionalProductionDelayDays and additionalFreightOrFbaDelayDays.
Evaluates any SKU's current stock against the Blackout-Adjusted Reorder Point (normalTotalLeadTimeDays + additionalBlackoutDelayDays + safetyStockDays). Even when a SKU looks healthy under normal 52-day lead times, the engine flags URGENT_ORDER_IMMEDIATELY_BEFORE_SHUTDOWN if the 35-day Chinese New Year shutdown will cause a stockout before the post-holiday vessel arrives, and prescribes the exact Pre-Blackout Pull-Forward Order Quantity.
What the Real-World Step Looks Like:
Every November/December (45–60 days before Chinese New Year), factories in Ningbo, Shenzhen, and Yiwu stop accepting pre-holiday orders, close for 3–4 weeks, and take 2 weeks post-holiday to re-train assembly workers. Panel 7F tells you exactly how many extra units to order before the factory cutoff so your FBA listing stays in stock all through February and March while competitors stock out.
Future State with Live APIs Connected:
Automatically injects the blackout delay buffer into the 6-hour SupplyChainOrchestratorService whenever daysUntilEventStarts <= 60.

Panel 7G: Amazon FBA Inbound Shipment Shortage, Lost-in-Warehouse Reconciler & BOL Claim Engine (`fba_inbound_discrepancies` table)

API Endpoints: GET /api/v1/discrepancy/shipments, POST /api/v1/discrepancy/shipments
SQL Table: fba_inbound_discrepancies
What It Does in the System Today:
Compares unitsShippedFrom3pl against unitsCheckedInByAmazon for each FBA Inbound Shipment ID (FBA18X...).
Computes missingShortageUnits, calculates Estimated Net Reimbursement Owed ($) (missingShortageUnits * retailPrice * 85%), checks whether both your Signed Bill of Lading (BOL) / Proof of Delivery (POD) and Factory Commercial Invoice are on file, and enforces Amazon's strict 60-Day FBA Inbound Reconciliation Window (READY_TO_FILE_REIMBURSEMENT_CLAIM vs. BLOCKED_MISSING_POD_OR_INVOICE_DOCS vs. EXPIRED_PAST_60_DAY_WINDOW).
Generates a ready-to-copy Seller Central Inbound Shipment Discrepancy Claim Packet.
What the Real-World Step Looks Like:
Amazon receiving docks (ONT8, CLT2, FTW1) routinely miscount 1–5% of inbound cartons. When a shipment closes with 24 units missing ($571.00 owed), you open Seller Central (Inventory -> Shipments -> Contents -> Reconcile), upload your factory Commercial Invoice and carrier-stamped POD, and paste the claim text generated by Panel 7G before the 60-day window expires.
Future State with Live APIs Connected:
Automatically polls Amazon SP-API Fulfillment Inbound API v2024-03-20 (listShipmentItems) daily as shipments transition to CLOSED and alerts you whenever QuantityShipped > QuantityReceived.

Panel 7H: Buy Box Hijacker, Counterfeit Seller Monitor & Brand Registry Cease-and-Desist Engine (`buybox_hijacker_incidents` table)

API Endpoints: GET /api/v1/hijacker/incidents, POST /api/v1/hijacker/incidents
SQL Table: buybox_hijacker_incidents
What It Does in the System Today:
Tracks unauthorized 3rd-party sellers ("hijackers") who attach to your private-label ASIN at an undercut price and steal your Buy Box share.
Calculates Daily Revenue Bleed ($/day) (normalDailyUnitVelocity * ourRetailPrice * (100 - ourCurrentBuyBoxWinPct) / 100), checks USPTO Brand Registry and Amazon Transparency 2D status, tracks your Test-Buy Order ID (114-...), and generates a dual Formal Legal Cease & Desist Notice + Amazon Brand Registry Counterfeit Takedown Complaint.
What the Real-World Step Looks Like:
If you launch a SKU before enabling Amazon Transparency 2D serialization and a counterfeit seller jumps on your listing at $18.99 (dropping your Buy Box win rate from 99% to 38%), you immediately place an expedited Test Buy from the hijacker's storefront, log the Order ID in Panel 7H, send the generated Cease & Desist via Buyer-Seller Messaging, and file the Brand Registry Counterfeit Test-Buy report once the knockoff arrives.
Future State with Live APIs Connected:
Subscribes to Amazon SP-API ANY_OFFER_CHANGED EventBridge notifications, triggering an instant Slack/Discord alert within 30 seconds if NumberOfOffers > 1 on any of your private-label ASINs.

Panel 7I: Multi-Currency Supplier FX (USD/CNY) Fluctuation Optimizer & Payment Rail Fee Arbitrage (`fx_supplier_hedges` table)

API Endpoints: GET /api/v1/fx/hedges, POST /api/v1/fx/evaluate
SQL Table: fx_supplier_hedges
What It Does in the System Today:
Compares the baseline USD/CNY exchange rate when your supplier originally quoted your FOB price (e.g., 6.9500) against the current live spot USD/CNY rate (e.g., 7.2600).
Calculates the Implied Fair USD FOB/Unit (quotedUsdFob * baselineRate / spotRate) and exact FX Negotiation Savings ($) you can demand from your factory when the US Dollar strengthens against the RMB.
Compares traditional Bank SWIFT Wire Fees (2.8% FX spread + $35 wire fee) against Fintech Local CNH Rails (0.35% via Airwallex / Wise Business / LianLian) to compute Payment Rail Arbitrage Savings ($).
What the Real-World Step Looks Like:
Chinese factories pay all raw materials and labor in RMB (CNY), so when the US Dollar strengthens from 6.95 to 7.26 (+4.4%), the factory earns an extra 4.4% windfall on your USD invoice unless you ask for an FX-indexed price adjustment—and paying via a traditional US bank wire wastes another ~2.8% in hidden bank FX spreads compared to a fintech multi-currency account.
Future State with Live APIs Connected:
Automatically fetches live USD/CNH spot rates daily from the European Central Bank / OpenExchangeRates API and Airwallex FX Quote API before every PO deposit or balance wire.

Panel 7J: Coupon, Prime Exclusive Discount (PED) & Lightning Deal Margin Stacking Guardrail (`promo_deal_simulations` table)

API Endpoints: GET /api/v1/promotions/simulations, POST /api/v1/promotions/simulate
SQL Table: promo_deal_simulations
What It Does in the System Today:
Simulates promotional campaigns combining Clip Coupons (%), Prime Exclusive Discounts (PED %), and Subscribe & Save (%), plus Amazon's $0.60 per-redemption coupon clip fee.
Catastrophic Discount Stacking Guardrail: If couponsDisabledDuringPrimeDeal = false while both a Clip Coupon (e.g., 15%) and Prime Exclusive Discount (20%) are active (+ 5% Subscribe & Save), Amazon stacks all three discounts (40% total off!)—causing you to sell out your inventory at a massive per-unit loss! Panel 7J flags BLOCKED_DISCOUNT_STACKING_LOSS_TRAP before you launch the promo and computes the exact Velocity Lift Multiplier (requiredVelocityMultiplierToBreakEvenOnTotalProfit) needed for a valid promo to generate more total net profit dollars than full-price sales.
What the Real-World Step Looks Like:
Before scheduling any Prime Day, Black Friday, or clip coupon in Seller Central (Advertising -> Coupons / Prime Exclusive Discounts), you run the campaign in Panel 7J to verify that multiple promotions cannot stack and that your post-promo net profit per unit remains solidly positive.
Future State with Live APIs Connected:
Audits active promotions before every Prime Deal event to ensure overlapping clip coupons are paused automatically.

Panel 7K: Dimensional Weight (`Dim-Weight`) & FBA Size-Tier Packaging Trim Optimizer (`packaging_optimization_audits` table)

API Endpoints: GET /api/v1/packaging/audits, POST /api/v1/packaging/audits
SQL Table: packaging_optimization_audits
What It Does in the System Today:
Audits each SKU's retail packaging dimensions (L x W x H in inches) and unit weight (grams) against Amazon's Dimensional Weight divisor (139) and FBA size-tier boundaries (SMALL_STANDARD requires shortest side $\le 0.75"$, median $\le 12"$, longest $\le 15"$, and weight $\le 16\text{ oz}$).
Detects when shaving just 0.20"–0.75" off a retail gift box or switching to vacuum-sealed poly packaging drops a SKU from LARGE_STANDARD (~$4.15/unit) down to SMALL_STANDARD (~$3.27/unit), saving +$0.88/unit (+$3,168/year on 3,600 units) permanently.
What the Real-World Step Looks Like:
Chinese factories default to generic oversized stock cardboard boxes with air gaps inside. Before approving mass-production dielines, you run your sample box dimensions in Panel 7K and instruct the factory packaging engineer to trim the box height by 0.35" so every single unit ships in the lower FBA fee tier for the life of the product.
Future State with Live APIs Connected:
Automatically compares SP-API Catalog Items API package dimensions against FBA tier thresholds and flags any SKU within 0.75" of a lower size tier.

Panel 7L: Multi-Channel Fulfillment (MCF) & Off-Amazon (Shopify / TikTok Shop / Walmart) Arbitrage Engine (`mcf_channel_evaluations` table)

API Endpoints: GET /api/v1/multichannel/evaluations, POST /api/v1/multichannel/evaluations
SQL Table: mcf_channel_evaluations
What It Does in the System Today:
Compares your net profit per unit on Amazon FBA (15% referral fee + standard FBA fee) against selling the exact same unit on Shopify DTC (2.9% Stripe fee + Amazon MCF blank-box fulfillment), TikTok Shop (6.0% fee + MCF), or Walmart Marketplace (WFS).
Calculates the exact Per-Unit Profit Advantage vs. Amazon FBA (profitAdvantageVsAmazonFbaUsd) and issues a channel expansion verdict (EXPAND_CHANNEL_HIGHER_UNIT_PROFIT_THAN_AMAZON).
What the Real-World Step Looks Like:
Once your inventory is sitting inside Amazon's warehouses, Amazon's Multi-Channel Fulfillment (MCF) program lets you ship orders placed on your Shopify store or TikTok Shop using unbranded brown boxes from your existing FBA stock—saving up to 9%–12% in marketplace referral fees while diversifying your revenue beyond Amazon.
Future State with Live APIs Connected:
Connects Shopify / TikTok Shop orders directly to Amazon SP-API Fulfillment Outbound API (createFulfillmentOrder) for 100% automated blank-box 3-day fulfillment.

Panel 7M: Automated Supplier SLA, Defect Clawback & Credit Memo Ledger (`supplier_clawback_credits` table)

API Endpoints: GET /api/v1/clawback/credits, POST /api/v1/clawback/credits
SQL Table: supplier_clawback_credits
What It Does in the System Today:
Combines defective units discovered in pre-shipment AQL inspections (quality_inspections) and customer returns (return_defect_audits) with factory late delivery delays beyond your Purchase Order SLA (> 5 days late).
Calculates Defect COGS + Amazon Return Processing Fee Recovery ($) plus Late SLA Penalty & 50% Emergency Air Bridge Recovery ($), generating a formal Supplier Credit Memo Notice to deduct directly from the 70% balance wire on your next Purchase Order.
What the Real-World Step Looks Like:
Instead of quietly absorbing the cost of factory-defective returns or emergency air freight when a factory misses its production deadline by 9 days, you attach the itemized Credit Memo from Panel 7M to your next PO invoice and deduct $449.60 from the final wire transfer.
Future State with Live APIs Connected:
Automatically links return_defect_audits and quality_inspections to open purchase_orders, reducing the net wire payout amount in Panel 5.

Panel 7N: Portfolio Exit Valuation, Brand Acquisition M&A Scorecard & SDE Multiple Maximizer (`brand_exit_valuations` table)

API Endpoints: GET /api/v1/valuation/valuations, POST /api/v1/valuation/valuations
SQL Table: brand_exit_valuations
What It Does in the System Today:
Calculates your live Enterprise Brand Exit Valuation ($) based on Trailing 12-Month (TTM) Seller's Discretionary Earnings (SDE) multiplied by a deterministic M&A Valuation Multiple (2.50x to 4.25x), plus 100% of Sellable Inventory at Landed Cost ($).
Evaluates the 5 institutional M&A multiple drivers prized by e-commerce aggregators and SBA/private equity buyers:
1. Net SDE Margin $\ge 25\%$ (+0.45x multiple expansion)
2. Organic Sales Share $\ge 65\%$ (+0.40x low PPC dependency)
3. Diversified Hero SKU Count ($\ge 3$ SKUs) (+0.35x)
4. USPTO Brand Registry + Transparency 2D Anti-Counterfeit Moat (+0.30x)
5. Dual-Source Backup Suppliers Verified (+0.25x)
What the Real-World Step Looks Like:
E-commerce FBA brands are liquid digital assets that sell on marketplaces like Empire Flippers, Quiet Light, and Website Closers for 2.5x–4.25x annual net profit (SDE) plus inventory at cost. Panel 7N shows how scaling from 2 Hero SKUs ($55.5k SDE @ 3.90x = $234,850 exit) to 5 Hero SKUs ($192.2k SDE @ 4.25x = $870,850 exit) compounds both annual cash flow and the exit multiple simultaneously.
Future State with Live APIs Connected:
Automatically pulls Trailing 12-Month SDE from sku_settlement_ledgers (Panel 7D) and live inventory value from active_skus (Panel 5) to display a real-time M&A data room valuation.

Panel 7O: Automated Competitor Price-War, Stockout & Review Collapse Radar (`competitor_anomaly_radars` table)

API Endpoints: GET /api/v1/competitor/anomalies, POST /api/v1/competitor/anomalies
SQL Table: competitor_anomaly_radars
What It Does in the System Today:
Monitors your top competitors on each keyword for 3 critical market anomalies:
1. Competitor Stockout Imminent ($\le 15$ units left): Recommends raising your retail price by +8.00% and boosting PPC conquest bids by +25.00% to capture their organic rank while their listing goes dark.
2. Competitor Quality Collapse ($\le 3.70\star$ recent rating): Recommends launching an ASIN-Targeting Product Display PPC campaign (+30.00% bid boost) directly on their product page showing your superior structural engineering.
3. Competitor Panic Liquidation ($\le -20.00\%$ price drop): Flags COMPETITOR_PANIC_LIQUIDATION_DO_NOT_FOLLOW_DOWN so you hold your price (0.00% change) and temporarily trim PPC (-15.00%) instead of getting dragged into a margin-destroying price war while a failing seller liquidates their last batch.
What the Real-World Step Looks Like:
Most sellers panic when a competitor drops their price by 25%, matching them down and destroying their own profit margin—even when that competitor is simply liquidating 140 remaining units before exiting the niche. Conversely, when a top competitor runs low on stock before Chinese New Year, you can raise your price by $2.00/unit and still win the Buy Box and #1 organic spot.
Future State with Live APIs Connected:
Polls the Keepa Product API daily for competitor stock counts, Buy Box price deltas, and 30-day review rating velocity.

Panel 7P: US Customs Duty Drawback (`19 U.S.C. § 1313`) & Export Tax Recovery Engine (`customs_duty_drawbacks` table)

API Endpoints: GET /api/v1/drawback/claims, POST /api/v1/drawback/claims
SQL Table: customs_duty_drawbacks
What It Does in the System Today:
Tracks imported inventory (by CBP Form 7501 Entry Summary Number) that is subsequently exported outside the United States via Amazon NARF (Remote Fulfillment with FBA to Canada & Mexico), exported to UK/EU, or returned/destroyed as defective merchandise.
Under 19 U.S.C. § 1313(j) (Unused Merchandise Drawback) and § 1313(c) (Rejected Merchandise), US Customs and Border Protection (CBP) refunds 99% of all Base MFN Duties and Section 301 China Tariffs (10.7%–30.3%) paid upon original US import when those units are exported within 5 years of entry!
Computes Gross Duties Paid on Exported Units ($), 99% Recoverable CBP Duty Drawback ($), 12% Drawback Broker Filing Fee ($), and Net Cash Refund Owed ($).
What the Real-World Step Looks Like:
If you enable Amazon's free NARF program (allowing Canadian and Mexican shoppers to buy from your US FBA inventory), 10%–20% of your sales may ship across the border. You paid 28.2% US China tariffs when those units entered Los Angeles—and under 19 U.S.C. § 1313, you can file CBP Form 7551 through an automated drawback broker (like Charter Brokerage or Paxos/Flexport Drawback) to recover 99% of those tariffs in cash!
Future State with Live APIs Connected:
Automatically matches Amazon SP-API Fulfillment Customer Shipment Sales Report (CA/MX destination country codes) against your customs broker's CBP Form 7501 entry records.

Panel 7Q: Automated Product Bundle, Virtual Multipack & AOV Expansion Simulator (`virtual_bundle_simulations` table)

API Endpoints: GET /api/v1/bundles/simulations, POST /api/v1/bundles/simulations
SQL Table: virtual_bundle_simulations
What It Does in the System Today:
Simulates Physical Pre-Packed 2-Packs (PHYSICAL_PREPACKED_2PACK_IN_1_BOX) and Amazon Virtual Brand Bundles (AMAZON_VIRTUAL_BRAND_BUNDLE) combining either two identical units or two complementary SKUs (SKU-BAMBOO-TRAY-01 + SKU-SILICONE-MAT-02).
Quantifies two massive unit-economics advantages of bundling:
1. Single PPC Click Amortization: You pay for only ONE Sponsored Products click (~$3.50/order) on a $46.99 bundle order instead of paying $3.50 twice ($7.00 total) to sell two separate $27.99 orders.
2. Single FBA Pick-and-Pack Fee (Pre-Packed 2-Pack): A pre-packed 2-pack pays one $4.55 Large Standard FBA fee instead of two separate $3.25 fees ($6.50 total), lifting net profit per order from $11.89 to $21.59 (+$9.70/order profit lift, 45.95% net margin).
What the Real-World Step Looks Like:
Once your hero SKU is live, you can create a Virtual Bundle in Seller Central (Brands -> Virtual Bundles) in 5 minutes with zero extra inventory or packaging changes—Amazon automatically pulls 1 unit of SKU A + 1 unit of SKU B from your existing FBA stock when a customer buys the bundle. For your next Sea PO, you instruct the factory to pack 20% of units as a physical 2-pack variation to capture the single-FBA-fee savings.
Future State with Live APIs Connected:
Publishes Virtual Bundle ASINs and variation relationships via SP-API Listings Items API.

Panel 7R: Production API Cutover Readiness Wizard & Enterprise Multi-Format Exporter (`system_cutover_checks` table)

API Endpoints: GET /api/v1/system/cutover-checks, POST /api/v1/system/cutover-checks, GET /api/v1/system/export-backup-manifest, GET /api/v1/system/export/tax-pack, GET /api/v1/system/export/cbp-7551-dossier, GET /api/v1/system/export/due-diligence-dataroom, GET /api/v1/system/export/manifest
SQL Table: system_cutover_checks
What It Does in the System Today:
Tracks each external integration subsystem (Amazon SP-API LWA, Amazon Advertising API, Keepa Product Finder API, US 3PL WMS Webhook, and HITL Slack/Discord Webhook), showing its required environment variable (SP_API_LWA_CLIENT_SECRET, etc.), verifying that its $0 Zero-Key Fallback Workflow is 100% operational today, and allowing you to toggle each integration to PRODUCTION_API_CONNECTED as you add live credentials.
Provides a 1-Click Full System JSON Snapshot Exporter (⬇ Export Full System Backup Manifest) that downloads a timestamped JSON manifest of your system configuration and cutover readiness.
Generates an enterprise-grade CPA Tax Pack CSV (/api/v1/system/export/tax-pack) structured across 5 core compliance sections: IRC § 471 & § 263A ending inventory capitalization, catalog landed margins, 19 U.S.C. § 1313 duty drawbacks, FBA shipment discrepancy reimbursements, and CSCO capital forecasts.
Generates a formal CBP Form 7551 Customs Duty Drawback Claim Dossier (/api/v1/system/export/cbp-7551-dossier) complete with Commercial Invoice, Packing List, and AES-ITN proof of exportation schedules.
Bundles a comprehensive M&A Due Diligence Data Room (/api/v1/system/export/due-diligence-dataroom) ZIP archive containing system backup manifest, CPA tax pack, customs drawback dossier, brand exit valuations, and SKU compliance vault records.
What the Real-World Step Looks Like:
You can run the entire business in $0 Zero-Key Sandbox/Manual Mode during product discovery, supplier sourcing, and your first 100-unit MVP batch. Once your first SKU is generating steady daily cash flow, you use Panel 7R as your step-by-step checklist to plug in live API keys one subsystem at a time without any downtime.

Panel 7S: Amazon AWD (Amazon Warehousing & Distribution) vs. Private 3PL Staging Arbitrage (`awd_staging_evaluations` table)

API Endpoints: GET /api/v1/awd/evaluations, POST /api/v1/awd/evaluations
SQL Table: awd_staging_evaluations
What It Does in the System Today:
Compares the total cost of staging bulk reserve cartons in Amazon AWD ($0.48/cu.ft./month storage + $1.00/cu.ft. inbound auto-replenishment transport) vs. private 3PL warehouse pallet storage ($38/pallet/mo + SPD forwarding fees).
Explicitly accounts for the 100% waiver of Amazon FBA Low-Inventory-Level Fees ($0.32–$1.11/unit) granted automatically when SKUs are auto-replenished from AWD.
What the Real-World Step Looks Like:
When shipping a 40ft container from Shanghai, you can split your inventory: send 300 units into active FBA and route the remaining 1,700 reserve units directly into an Amazon AWD facility (e.g., IUSJ in California) to lock in low $0.48 storage and guarantee you never pay low-inventory surcharges.
Future State with Live APIs Connected:
Automatically submits AWD Inbound Shipments via Amazon SP-API AWD Inbound API (createAwdInboundShipment).

Panel 7T: Subscribe & Save (SnS) Retention & LTV Margin Simulator (`sns_retention_simulations` table)

API Endpoints: GET /api/v1/sns/simulations, POST /api/v1/sns/simulations
SQL Table: sns_retention_simulations
What It Does in the System Today:
Models customer retention, 15% referral fee savings on seller discounts, and customer lifetime value (LTV) across 0%, 5%, and 10% seller-funded SnS tiers.
Highlights that while order #1 incurs an acquisition CAC, repeat subscription deliveries incur $0.00 PPC ad spend, dramatically multiplying total customer profit.
What the Real-World Step Looks Like:
For consumable or replenishable products (e.g., coffee filters, silicone baking sheets, supplements), you enable 5% SnS in Seller Central to earn the Subscribe & Save search filter badge, which lifts organic conversion by ~15% and locks in repeat orders.
Future State with Live APIs Connected:
Integrates with Amazon SP-API FBA Subscribe & Save API to pull live active subscriber counts and cohort churn rates.

Panel 7U: Aged Inventory Surcharge (181–365+ Day) & Disposition Optimizer (`aged_inventory_liquidations` table)

API Endpoints: GET /api/v1/liquidation/evaluations, POST /api/v1/liquidation/evaluations
SQL Table: aged_inventory_liquidations
What It Does in the System Today:
Evaluates slow-moving inventory facing aged storage penalties ($1.50/cu.ft. at 181 days, escalating to $6.90/cu.ft. at 365+ days).
Compares the net cash recovered across three distinct paths over 90 days: (1) Outlet Flash-Sale Price Slash, (2) Amazon FBA Bulk Liquidation (~8% gross recovery), and (3) FBA Removal/Donation Orders (-$1.04/unit fee).
What the Real-World Step Looks Like:
Rather than letting slow units bleed storage fees indefinitely, the system tells you the exact date to trigger an Amazon Outlet Deal or submit a bulk liquidation order to salvage working capital before punitive 365-day surcharges hit.
Future State with Live APIs Connected:
Creates automated Amazon FBA Removal/Liquidation orders via SP-API Fulfillment Inbound/Inventory API.

Panel 7V: Maritime Chokepoint Disruption & Dynamic Air-Bridge Engine (`maritime_route_disruptions` table)

API Endpoints: GET /api/v1/maritime/disruptions, POST /api/v1/maritime/disruptions
SQL Table: maritime_route_disruptions
What It Does in the System Today:
Detects maritime delays (Red Sea diversions, Panama Canal draft cuts, West Coast port congestion) and dynamically expands ocean lead-times.
Calculates the exact additional safety stock required and evaluates whether splitting 20%–50% of the inventory gap via Air Express saves more profit than allowing the listing to stock out.
What the Real-World Step Looks Like:
When port labor negotiations stall in Los Angeles adding 14 days of anchor dwell time, you immediately instruct your freight forwarder to fly 10 cartons via Air DDP to maintain Buy Box velocity while the main container waits for a berth.
Future State with Live APIs Connected:
Ingests automatic ocean AIS vessel tracking and port dwell telemetry via Project44 / Freightos APIs.

Panel 7W: Amazon Brand Referral Bonus (10% Kickback) & External Ads ROI Engine (`brand_referral_attributions` table)

API Endpoints: GET /api/v1/attribution/campaigns, POST /api/v1/attribution/campaigns
SQL Table: brand_referral_attributions
What It Does in the System Today:
Calculates true net Customer Acquisition Cost (CAC) for external marketing campaigns (TikTok Ads, Meta Reels, Google Search, Creator partnerships) after deducting Amazon's 10% Brand Referral Bonus rebate credited against your referral fees.
Factors in 14-day halo purchases and compares net effective CAC against native on-Amazon Sponsored Products clicks.
What the Real-World Step Looks Like:
You generate an Amazon Attribution link in Seller Central for an Instagram influencer partnership. When their followers purchase $3,200 of products, Amazon credits $320 back to your seller account, effectively cutting your ad spend in half.
Future State with Live APIs Connected:
Pulls automated attribution click and conversion reports from the Amazon Advertising Attribution API.

Panel 7X: Amazon Vine Review Velocity & Launch ROI Simulator (`vine_launch_simulations` table)

API Endpoints: GET /api/v1/vine/simulations, POST /api/v1/vine/simulations
SQL Table: vine_launch_simulations
What It Does in the System Today:
Models the three Amazon Vine enrollment tiers ($0 fee for 1–2 units, $75 fee for 3–10 units, $200 fee for 11–30 units).
Calculates total investment (fee + landed giveaway cost), models the conversion rate lift (e.g., 6.5% to 14.2%), and calculates the exact daily PPC ad spend waste avoided and payback days.
What the Real-World Step Looks Like:
On day 1 of product check-in at FBA, you enroll 30 units in Amazon Vine. Within 21 days, you receive 25+ detailed, verified customer reviews with photos, instantly boosting your organic search ranking and PPC efficiency.
Future State with Live APIs Connected:
Enrolls products and tracks reviewer claim status via Amazon SP-API Vine endpoints.

Panel 7Y: FBA Inbound Placement Service Fee Optimizer (2025/2026 Rules) (`inbound_placement_optimizations` table)

API Endpoints: GET /api/v1/placement/optimizations, POST /api/v1/placement/optimizations
SQL Table: inbound_placement_optimizations
What It Does in the System Today:
Compares total domestic inbound logistics costs under 2025/2026 Amazon Inbound Placement rules:
- Minimal Split (Single FC Consolidation): Lower carrier freight + $0.27–$0.68/unit placement fee.
- Amazon-Optimized Split (5-Way Regional Split): Higher LTL/SPD freight + $0.00 placement fee.
Recommends the mathematically optimal routing strategy to minimize total landed inbound expense.
What the Real-World Step Looks Like:
When booking domestic freight from your West Coast 3PL, you compare whether paying an extra $350 in LTL carrier fees for a 5-way split saves $760 in Amazon inbound placement fees.
Future State with Live APIs Connected:
Pulls real-time inbound placement fee quotes via Amazon SP-API Inbound v2024 (generatePlacementOptions).

Panel 7Z: Section 321 De Minimis ($800 Threshold) & Competitor Shock Simulator (`section321_policy_simulations` table)

API Endpoints: GET /api/v1/deminimis/simulations, POST /api/v1/deminimis/simulations
SQL Table: section321_policy_simulations
What It Does in the System Today:
Simulates the margin shock on cross-border direct-air sellers (Temu, Shein, or grey-market China sellers) when US Customs revokes duty-free Section 321 treatment for specific HTS chapters.
Calculates the competitor's forced price hike and estimates your market share capture and annualized net profit gains as compliant bulk ocean FBA importers.
What the Real-World Step Looks Like:
When CBP issues a Notice of Proposed Rulemaking targeting textile or kitchenware de minimis imports, you prepare inventory to capture demand as drop-shippers and air-parcel sellers exit the market.
Future State with Live APIs Connected:
Monitors Federal Register and CBP CSMS cargo messaging bulletins for HTS-specific regulatory revisions.

Panel 7AA: US Quarterly Estimated Tax, IRC § 471 COGS & QBI Reserve Engine (`us_corporate_tax_reserves` table)

API Endpoints: GET /api/v1/tax/reserves, POST /api/v1/tax/reserves
SQL Table: us_corporate_tax_reserves
What It Does in the System Today:
Computes IRS Forms 1040-ES / 1120-W quarterly estimated tax payments.
Properly capitalizes unsold ending FBA inventory assets on the balance sheet under IRC § 471 / § 263A (only sold units are deductible as COGS!).
Applies the 20% IRC § 199A Qualified Business Income (QBI) deduction for pass-through entities and generates a CPA-ready tax reserve schedule.
What the Real-World Step Looks Like:
Every quarter (April 15, June 15, Sept 15, Jan 15), you transfer the calculated tax reserve from your operating account to a separate high-yield tax savings account, completely avoiding IRS underpayment penalties.
Future State with Live APIs Connected:
Syncs directly with QuickBooks Online or Xero accounting software via REST webhooks.

Panel 7AB: Amazon $1M Commercial General Liability & 110% Marine Cargo Insurance Optimizer (`cargo_and_liability_policies` table)

API Endpoints: GET /api/v1/insurance/evaluations, POST /api/v1/insurance/evaluations
SQL Table: cargo_and_liability_policies
What It Does in the System Today:
Audits compliance with Section 9 of the Amazon Services Business Solutions Agreement (mandating $1M Commercial General Liability insurance naming Amazon as Additional Insured once gross sales exceed $10,000 in any single month).
Evaluates ocean shipment CIF commercial values and computes 110% All-Risk Marine Cargo insurance (ICC-A) to eliminate statutory COGSA carrier limits ($500/pallet).
What the Real-World Step Looks Like:
Upon crossing $10k in monthly sales, you obtain a $1M CGL Certificate of Insurance (COI) from an Amazon-approved broker (e.g., Next, Bunker, or Marsh) and upload it to Seller Central, protecting your brand from suspension and personal liability.
Future State with Live APIs Connected:
Submits COI verification documents directly to Amazon Seller Central via Account Health API.

Panel 7AC: Amazon "Manage Your Experiments" (A/B Testing) Revenue Lift Calculator (`manage_experiments_tests` table)

API Endpoints: GET /api/v1/abtesting/experiments, POST /api/v1/abtesting/experiments
SQL Table: manage_experiments_tests
What It Does in the System Today:
Analyzes A/B test results from Amazon Manage Your Experiments (MYE) for Main Hero Images, SEO Titles, Bullet Points, and A+ Content.
Computes two-proportion statistical significance (95%+ confidence), relative conversion rate (CVR) lift, and projected annualized net profit increase.
What the Real-World Step Looks Like:
You run a 4-week split test in Seller Central comparing a 3D rendered main image against a studio photograph. The calculator confirms 99.9% statistical confidence and an extra $4,000/year in net profit, directing you to publish Version B immediately.
Future State with Live APIs Connected:
Automatically fetches experiment metrics from the Amazon SP-API Experiments API.

Panel 7AD: Chief Supply Chain Officer (CSCO) Autonomous Morning Briefing (`autonomous_daily_briefings` table)

API Endpoints: GET /api/v1/executive/briefings, POST /api/v1/executive/briefings
SQL Table: autonomous_daily_briefings
What It Does in the System Today:
Acts as an autonomous CSCO, synthesizing liquid bank balances, 30-day PO commitments, unclaimed cash recoveries (FBA reimbursements, duty drawbacks, supplier clawbacks), and stockout/hijacker alerts.
Assigns an overall system posture (GREEN_AUTOPILOT_SCALING_READY, AMBER_EXECUTE_CASH_RECOVERY_AND_REORDERS, RED_DEFENSIVE_LIQUIDITY_PRESERVATION_MODE) and generates the Top 3 highest-ROI tactical action items for the day.
What the Real-World Step Looks Like:
You open the dashboard every morning, glance at the CSCO briefing card for 60 seconds, and know exactly what operational decisions need approval today.
Future State with Live APIs Connected:
Broadcasts the morning briefing directly to your private executive Slack or Discord channel at 8:00 AM daily.

Panel 7AE: Buyer-Seller Messaging & VOC Defect Shield (`buyer_seller_messages` table)

API Endpoints: GET /api/v1/messaging/messages, POST /api/v1/messaging/analyze
SQL Table: buyer_seller_messages
What It Does in the System Today:
Ingests customer inbound messages & critical product reviews.
Automatically assesses Voice of Customer (VOC) sentiment, computes defect risk escalation, drafts compliant Seller Central warranty/troubleshooting responses (strictly adhering to Amazon Customer Communication Guidelines — no review incentives, no diversion off-Amazon), and triggers emergency listing holds if defect complaint rate spikes.
What the Real-World Step Looks Like:
When a customer sends a message regarding a cracked drawer divider, the system drafts a policy-compliant warranty response and flags factory QA without risking Amazon Account Health suspensions.

Panel 7AF: Amazon Transparency 2D Serialization & Anti-Counterfeit Vault (`transparency_serial_batches` table)

API Endpoints: GET /api/v1/transparency/batches, POST /api/v1/transparency/generate-batch, POST /api/v1/transparency/reconcile
SQL Table: transparency_serial_batches
What It Does in the System Today:
Generates unique Amazon Transparency 2D Data Matrix serial codes (AZ:TRANS:...) with monotonic range tracking.
Reconciles factory physical application audits against warehouse check-ins to prevent unauthorized distributor leakages and knockoff hijackings.

Panel 7AG: Ocean Demurrage & Container Detention Shield (`ocean_demurrage_shields` table)

API Endpoints: GET /api/v1/demurrage/records, POST /api/v1/demurrage/audit
SQL Table: ocean_demurrage_shields
What It Does in the System Today:
Tracks port terminal free time (standard 4–7 days) and container equipment detention clocks (10–14 days).
Computes daily escalating per-diem fees and automates off-dock drop yard staging arbitrage decisions to save $1,500+ in carrier fines.

Panel 7AH: Global Multi-Region Cross-Border VAT & EPR Expansion Engine (`global_marketplace_expansions` table)

API Endpoints: GET /api/v1/global/evaluations, POST /api/v1/global/evaluate
SQL Table: global_marketplace_expansions
What It Does in the System Today:
Analyzes expansion profitability into Amazon UK, EU (DE/FR), Canada, and Japan.
Deducts destination VAT/GST (UK 20%, DE 19%, FR 20%, CA 5%, JP 10%), EPR eco-packaging fees (VerpackG / CITEO), localized FX rates, and international FBA fees to gate international launch approvals.

Panel 7AI: Amazon FBA Reimbursements Auto-Filing Engine (`fba_reimbursement_claims` table)

API Endpoints: GET /api/v1/reimbursement/claims, POST /api/v1/reimbursement/claims
SQL Table: fba_reimbursement_claims
What It Does in the System Today:
Detects lost, damaged, destroyed, or customer-return-uncredited inventory inside Amazon fulfillment centers.
Generates ready-to-file Seller Support claim dossiers with exact discrepancy unit math, estimated value per unit, and claim reference codes (CLM-...).
Tracks claim lifecycles from SUBMITTED to REIMBURSED or DENIED with audit trail case notes.
What the Real-World Step Looks Like:
FBA warehouses routinely lose or destroy 1–3% of seller inventory. This engine cross-references monthly inventory ledger adjustments against reimbursements credited, automatically filing claims within Amazon's 18-month recovery window.

Panel 7AJ: Multi-Echelon Lead Time Variance & Dynamic Safety Stock Engine (`multi_echelon_safety_stocks` table)

API Endpoints: GET /api/v1/safety-stock/evaluations, POST /api/v1/safety-stock/evaluate
SQL Table: multi_echelon_safety_stocks
What It Does in the System Today:
Computes stochastic safety stock accounting for both daily demand variance ($\sigma_d$) and factory/freight lead time variance ($\sigma_{LT}$): $$SS = Z \times \sqrt{\mu_{LT} \times \sigma_d^2 + \mu_d^2 \times \sigma_{LT}^2}$$
Enforces desired CSL service levels (e.g. 98% $Z=2.05$, 95% $Z=1.65$) to compute exact Dynamic Reorder Points ($\text{ROP} = \mu_d \times \mu_{LT} + SS$) and annual inventory holding costs.
What the Real-World Step Looks Like:
Instead of relying on a flat "30-day rule of thumb", the system protects hero SKUs against volatile holiday sales spikes and Red Sea/Panama shipping delays without over-allocating tied-up cash.

Panel 7AK: Dynamic Price Elasticity & Profit-Maximizing Repricer (`price_elasticity_experiments` table)

API Endpoints: GET /api/v1/repricing/experiments, POST /api/v1/repricing/evaluate
SQL Table: price_elasticity_experiments
What It Does in the System Today:
Measures price elasticity of demand ($\epsilon_p = \frac{\% \Delta Q}{\% \Delta P}$) between baseline and test prices.
Compares daily gross profit dollars ($(\text{Price} - \text{COGS}) \times \text{Units}$) to determine whether the SKU is price inelastic ($|\epsilon_p| < 1$, raising price maximizes profit) or elastic ($|\epsilon_p| > 1$).
Outputs an algorithmic repricing verdict (RECOMMEND_PRICE_INCREASE, RECOMMEND_PRICE_DECREASE, or MAINTAIN_CURRENT_PRICE) with target optimal price.
What the Real-World Step Looks Like:
Brand owners often fear raising prices; this tool proves mathematically whether a $2.00 price hike yields more net profit dollars even if unit velocity slightly drops.

Panel 7AL: Working Capital Waterfall & Inventory Financing Revolver (`working_capital_revolvers` table)

API Endpoints: GET /api/v1/revolver/facilities, POST /api/v1/revolver/simulate-drawdown
SQL Table: working_capital_revolvers
What It Does in the System Today:
Simulates drawdowns against inventory revolving lines of credit (e.g. 8.5% APR fintech revolver).
Calculates interest cost for the financing duration ($T$ days until Amazon bi-weekly payout) and projects net Return on Invested Capital (ROIC).
Automates drawdown approval status (APPROVED_HIGH_ROI_DRAWDOWN vs. REJECTED_EXCEEDS_CREDIT_LIMIT vs. UNPROFITABLE_DEBT_COST).
What the Real-World Step Looks Like:
When placing large 1,000+ unit ocean POs before Q4, brands draw on credit lines to preserve operational liquidity, using this panel to ensure gross profits vastly outstrip financing interest costs.

Panel 8: System Audit & Safety Check Console + Embedded SQL Console

API Endpoints: GET /api/v1/ppc/audit-logs, GET /api/v1/integration/alerts
SQL Tables: ppc_decision_logs, hitl_alert_logs (plus all 48 tables in /h2-console)
What It Does in the System Today:
Provides a permanent, filterable SQL audit log of every PPC bid/negation decision and every Human-in-the-Loop (HITL) capital approval and defensive repricing alert.
Clicking 🗄️ Embedded SQL Console (/h2-console) in the top navigation bar opens the full SQL editor with 1-click query chips for all 48 database tables.

Panel 9: Autonomous Supply Chain AI Copilot Drawer (`copilot_chat_history` table)

API Endpoints: POST /api/v1/copilot/chat, GET /api/v1/copilot/status, GET /api/v1/copilot/context-summary
SQL Table: copilot_chat_history
What It Does in the System Today:
Accessible via the glowing ✨ AI Copilot floating button at the bottom-right corner of the dashboard.
Connects to Google Gemini 1.5/2.5 Flash (via your Google AI Studio key GEMINI_API_KEY) or operates in Local Deterministic Database Mode ($0).
Automatically injects a real-time operational context snapshot: active catalog SKUs, inventory counts, open POs, cash runway, and logged supplier quotes.
Drafts bilingual English/Mandarin factory dispute letters, credit memo clawbacks, cash runway forecasts, and tariff impact assessments.
What the Real-World Step Looks Like:
When you need to send a firm defect clawback message to your factory in Ningbo, click the copilot, prompt: "Draft a defect clawback letter in English and Chinese for 28 cracked divider units", and paste the generated dual-language B2B memo straight into WeChat or Alibaba Trade Messenger.

Panel 10: Amazon Seller Central 1-Click OAuth2 Wizard (`amazon_store_credentials` table)

API Endpoints: GET /api/v1/auth/amazon/authorize-url, GET /api/v1/auth/amazon/callback, GET /api/v1/auth/amazon/stores, POST /api/v1/auth/amazon/stores/manual-connect, POST /api/v1/auth/amazon/stores/{sellerId}/test-connection
SQL Table: amazon_store_credentials
What It Does in the System Today:
Accessible via the 🔗 Connect Amazon Store button in the top navigation bar.
Encrypts LWA refresh tokens at rest using AES-256 encryption in the database.
Option 1 (1-Click OAuth): Launches the official Amazon Seller Central consent flow in a secure popup window, captures the authorization code, and completes token exchange.
Option 2 (Direct Developer Token Entry): Allows sellers who already have their LWA Client ID, Client Secret, and Refresh Token to paste them directly into the encrypted vault.
Automatically manages token expiration and auto-rotates 1-hour access tokens with Amazon's token endpoint (https://api.amazon.com/auth/o2/token).
What the Real-World Step Looks Like:
When connecting your live Amazon store, you click "Connect Amazon Store", sign into Seller Central in the popup, and click "Confirm". Your store is instantly linked, enabling real-time Buy Box repricing and SP-API catalog publishing without manual flat files.

Panel 11: Autonomous Live Amazon SP-API Sync Scheduler (`amazon_sync_job_logs` table #50)

API Endpoints: POST /api/v1/sync/amazon/trigger, GET /api/v1/sync/amazon/status, GET /api/v1/sync/amazon/logs
SQL Table: amazon_sync_job_logs
What It Does in the System Today:
Runs on an autonomous Spring @Scheduled(fixedRate = 14400000) cron loop (every 4 hours), or on-demand via the 🔄 Sync Amazon Now button.
Checks amazon_store_credentials. When active live credentials exist, queries real Amazon SP-API inventory reports; otherwise executes realistic deterministic sandbox catalog reconciliation.
For each catalog SKU:
1. Reconciles available FBA units and updates 7-day and 30-day velocity curves.
2. Runs Reorder Point ($\text{ROP}$) evaluation. If stock hits threshold, automatically drafts an AWAITING_APPROVAL replenishment Purchase Order.
3. Evaluates stockout risk. If days of supply $< 15$ days, triggers an autonomous +12% defensive price hike to preserve organic search rank and suppress stockouts.
Records duration, units reconciled, and decisions to SQL Table #50 amazon_sync_job_logs.
What the Real-World Step Looks Like:
You never have to manually log into Seller Central to check inventory counts or calculate replenishment dates. The system keeps stock synced in the background and has draft POs ready for your one-click approval before stockouts occur.

Panel 12: Multi-Modal AI Listing Vision & Packaging Inspector Studio (`image_inspection_audits` table #51)

API Endpoints: POST /api/v1/vision/audit-hero-image, POST /api/v1/vision/audit-carton-label, POST /api/v1/vision/generate-storyboard, GET /api/v1/vision/audits
SQL Table: image_inspection_audits
What It Does in the System Today:
1. Hero Image RGB (255, 255, 255) Pure White Background Audit:
- Uses local Java BufferedImage pixel border raster scanning ($0 API cost) across perimeter coordinates to verify that background pixels are pure white #FFFFFF (RGB 255, 255, 255).
- When GEMINI_API_KEY is present, it augments the audit with Gemini Flash multi-modal vision to verify $\ge 85\%$ frame occupancy, absence of watermarks/promotional badges, and realistic lighting.
2. Master Carton & Drop-Test Label Audit:
- Verifies factory carton markings, FNSKU barcode scannability/contrast, gross weight, and drop-test packaging corner integrity.
3. 7-Module Amazon A+ Content Storyboard Generator:
- Generates high-converting A+ Content layouts: Brand Header Banner (970x600), 4-Image Feature Quadrant (300x300), 3D CAD Schematic, Lifestyle 3-Pack, Competitor Comparison Matrix Grid, Unboxing Knolling Flat-Lay, and Brand Trust Guarantee.
Costs Associated with Multi-Modal AI Vision:
Google AI Studio Free Tier: $0.00 / month (1,500 free multi-modal requests per day, which comfortably supports auditing 1,500 listing images, carton photos, and A+ content designs daily).
Paid Pay-As-You-Go Tier (if scaled beyond free tier): Google charges $0.00002 per image (less than 2 cents per 1,000 image audits).
Offline Zero-Cost Fallback: When offline or if API key is unset, the local Java raster pixel border sampler executes with $0.00 total cost.
What the Real-World Step Looks Like:
Before uploading a product photo to Amazon Seller Central, you drop the render into Panel 7AM. It instantly tells you if your background is true pure white (255,255,255) or off-white (e.g. 251,252,250), preventing search suppression before you launch. You also hand the generated 7-module A+ storyboard directly to your graphic designer on Fiverr or Upwork.

Step 7AN: Autonomous High-Margin Niche Discovery & Reverse-ASIN Keyword Engine (Panel 7AN | Table #52)

Real-World Purpose: Moves beyond tracking single known ASINs to an automated machine that constantly surfaces high-demand, low-competition private label niches.
What It Computes:
Category BSR Tree Sweeps: Filters for categories where estimated monthly revenue exceeds hurdle rates (e.g., $10k-$15k/mo) while competitor review counts remain low (<250 reviews).
Opportunity Score (0 - 100): Evaluates revenue velocity against review entrenchment and fee burden.
Reverse-ASIN Keyword Extraction: Deconstructs winning ASINs into 5 prioritized search terms with monthly search volume, competitor CPC benchmarks, and recommended PPC bid caps (calculated at 85% of CPC to maintain profitable ACoS).
How to Use:
In Panel 7AN, select a preset (e.g., Kitchen Organization or Travel Tech) or enter a seed keyword.
Click "🚀 Launch Autonomous Category Niche Scan". The system evaluates candidates, identifies the winning ASIN (e.g., B09SPICE01), and outputs target keywords ready for PPC campaign creation.

Step 7AO: Chinese Factory Negotiation & Bilingual Supplier Procurement Portal (Panel 7AO | Table #53)

Real-World Purpose: Bridges domestic brand operations with Chinese contract manufacturing in Guangdong, Zhejiang, and Jiangsu.
What It Computes:
Bilingual English & Mandarin RFQs: Generates culturally authentic Chinese business letters (询价函) with exact technical tolerances, flame-retardant ratings, and material standards.
Volume Price Curves: Deterministically models price breaks across 1,000, 2,000, and 5,000 unit tiers with margin expansion percentages.
ISO 2859-1 / AQL 2.5 Quality Protocol: Computes exact sample sizes to pull (e.g., 125 units from a 3,000-unit batch) and max allowable major/minor defect thresholds, providing bilingual inspection checklists for 3rd-party audit firms (QIMA / V-Trust).
How to Use:
In Panel 7AO, enter product specifications and target MOQ.
Click "🇨🇳 Generate Bilingual RFQ & Volume Curve" to view and export the English & Chinese letters.
Click "📋 Generate AQL 2.5 Quality Inspection Protocol" to generate the pre-shipment audit sheet before releasing the final 70% balance wire.
Click "💾 Save Negotiation Record" to archive the contract terms into persistent Table #53.

Step 7AP: Mobile PWA Warehouse Mode & Camera Barcode Scanner (Panel 7AP | Table #54)

Real-World Purpose: Transforms any smartphone or tablet into a rugged warehouse scanner for physical carton receiving and FNSKU verification.
What It Does:
Progressive Web App (PWA): Installable directly to your phone's home screen with offline caching (manifest.json and sw.js).
Live Optical Barcode Scanner: Uses your device camera and the native browser BarcodeDetector API to scan 1D (Code 128, UPC-A, EAN-13) and 2D QR codes in real time.
1-Tap PO Receiving Reconciler: Cross-checks scanned barcodes against open Purchase Orders in state SUPPLIER_ORDERED or ARRIVED_AT_3PL, transitions the PO state, and increments inventory counts.
How to Use:
Open http://localhost:8080 (or your cloud URL) on mobile Safari or Chrome.
Click "📷 Turn On Camera" in Panel 7AP and point the phone at incoming carton stickers or sample FNSKU labels.
The system flashes green upon optical match, verifies the SKU, and reconciles the batch into inventory.

Step 7AQ: Master Carton Shipping Mark & 2D QR / GS1-128 Label Generator (Panel 7AQ | Table #55)

Real-World Purpose: Generates factory-ready, carrier-compliant Master Carton Shipping Marks and 4x6" thermal labels before goods leave the manufacturer in China.
What It Computes:
GS1-128 & 2D QR Barcode Generation: Dynamically renders high-resolution Code 128 linear barcodes and 2D Data Matrix QR codes (ZXing engine) embedded directly in Base64 PNG format.
Carton CBM & Weight Aggregation: Calculates volume per carton in cubic meters ((L * W * H) / 1,000,000 to 4 decimal places), total shipment CBM, net weight, and gross weight with strict BigDecimal math.
4x6" Thermal Print Engine: Delivers direct printable HTML specifically formatted for Zebra, Rollo, and MUNBYN 4x6" thermal label printers with zero page scaling errors.
How to Use:
Under the Purchase Orders table in the Command Center, click "🏷️ Marks" on any active purchase order.
A browser tab opens with direct printable 4x6" shipping marks for every carton in that order (e.g. Box 1 of 4, Box 2 of 4).
Send the direct print link (/api/v1/procurement/orders/{poId}/shipping-marks/print) directly to your Chinese factory or freight forwarder to apply to outer master cartons before drayage.

Step 7AR: Contactless 3PL Dock Receiving, Pre-Provisioned Station Binding & Photo Evidence Pass-Through (Table #56)

Real-World Purpose: Secures third-party warehouse receiving dock lanes with zero public sign-ups, hardware laser scanner wedge listeners, and blind receiving data privacy.
What It Does:
Blind Receiving Data Redaction: Automatically scrubs manufacturer unit purchase costs, wholesale margins, and confidential supplier order codes from the 3PL dock view (toBlindReceiving()), preventing warehouse clerks or competing sellers from viewing proprietary financial margins.
Pre-Provisioned Physical Station Registry: Eliminates manual dock clerk onboarding by binding hardware terminals to pre-registered dock bay stations (FAC-LAX-01::BAY-14, BAY-01, CONV-02) via physical station QR codes.
Hardware Laser Scanner Wedge Listener: Natively intercepts keystrokes from Zebra and Honeywell handheld terminals (DataWedge enter-key handlers) with automatic form submission in under 50ms.
Photo Evidence Pass-Through: Captures high-resolution photographic evidence of incoming cartons, damaged corners, and packing slips on the dock (/warehouse.html) and instantly surfaces them in the QC Inspector portal (/inspector.html).
How to Use:
3PL dock clerks navigate to http://localhost:8080/warehouse.html. The station barcode binds the device in 1 scan.
When a pallet arrives, scan carton barcodes using the terminal's physical laser trigger or phone camera.
Quality assurance managers view receipts and photos in real time at http://localhost:8080/inspector.html.

Step 7AS: Institutional Customs Commercial Invoices, Ocean Packing Lists & CBP Form 7551 Duty Drawback Packets

Real-World Purpose: Generates institutional customs declaration dossiers, ocean carrier manifests, and duty drawback refunds compliant with US Customs and Border Protection (CBP) and WTO transaction valuation rules.
What It Generates:
Customs Commercial Invoice: Features exporter/importer declarations, Incoterms (FOB NINGBO), automated HTS tariff code mapping (e.g., 4421.99.9880 for bamboo), and total transaction valuation.
Ocean Freight Packing List: Generates vessel voyage schedules, container numbers, seal numbers, per-carton allocations, and total metric weight/CBM breakdowns.
CBP Form 7551 Duty Drawback Packet: Claims 99% statutory refund of Section 301 and MFN tariffs paid on imported goods that are subsequently exported or destroyed under 19 U.S.C. § 1313 and 19 CFR Part 190 (TFTEA).
IRC § 471 & § 263A Tax COGS Ledger CSV: Generates multi-section CPA audit packs reporting deductible landed COGS vs. capitalized ending inventory asset balances.
How to Use:
In the Command Center Purchase Orders table, click "📄 Invoice", "📦 Packing", or "🏛️ CBP 7551" to view and print official customs documents.
In Panel 7AA (Tax Reserves), click "📑 Export IRC § 471 Tax COGS Ledger (CSV)" to download the ledger for your CPA.

Step 7AT: 1-Click Autonomous End-to-End 32-Stage Lifecycle Simulation Harness

Real-World Purpose: Validates the entire supply chain math model from market discovery through manufacturing, customs clearance, Amazon AWD replenishment, PPC bid optimization, and tax reserves in a single automated pass.
What It Does:
Executes all 32 core supply chain lifecycle stages sequentially in under 200 milliseconds.
Generates dynamic batch runs (SIM-...) with zero database collisions or lock contention.
Audits end-to-end profitability, sea freight net margin, AQL 2.5 defect thresholds, and CSCO cash flow postures.
How to Use:
In the Command Center header bar or via terminal, trigger POST /api/v1/system/simulate-e2e-run.
Review the complete 32-line lifecycle execution log and KPI scorecard.

Regulatory, Geopolitical, Tariff & Fee Update Cadence Reference

Rate / Regulation Domain	Review Cadence	Official Source / API	Action When Updated
Buy Box Offer Count & Hijacker Monitoring	Daily / Real-Time	SP-API `ANY_OFFER_CHANGED` Webhook	Log unauthorized seller in Panel 7H & execute Test-Buy / Brand Registry takedown.
Competitor Stockout, Price-War & Review Radar	Every 3–7 Days	Keepa API / Competitor Listing Check	Log competitor shift in Panel 7O to hike price on rival stockouts or avoid panic liquidations.
Promotional & Prime Deal Stacking Check	Before Every Deal / Coupon	Seller Central `Coupons` & `Prime Exclusive Discounts`	Run Panel 7J Promo Stacking Guardrail to prevent stacked discount loss traps.
USD/CNY Supplier FX & Wire Rail Spread	Before Every PO Deposit/Balance	Live `USD/CNH` Spot Rate & Fintech FX Quote	Run Panel 7I FX Optimizer to capture RMB depreciation discounts & avoid bank SWIFT spreads.
Supplier SLA & Defect Credit Memo Clawback	Before Every 70% Balance Wire	Pre-Shipment AQL (`Panel 3B`) & Return Audits (`Panel 7B`)	Generate Supplier Credit Memo in Panel 7M & deduct from next PO wire.
Packaging Dim-Weight & FBA Tier Boundary Audit	Before Every Dieline / Reorder	Amazon FBA Size Tier Schedule (`139` Dim Divisor)	Run Panel 7K Packaging Optimizer to shave `0.25"–0.75"` and drop FBA fee tier.
US Customs 19 U.S.C. 1313 Duty Drawback Claim	Quarterly (5-year statutory window)	CBP Form 7501 & Amazon NARF Export Report	Run Panel 7P Duty Drawback Engine to recover 99% of Section 301 tariffs on exported units.
FBA Inbound Shipment Receiving Reconciliation	14 Days After Shipment Closes (60d hard cutoff)	Seller Central `Shipments -> Reconcile` / SP-API Inbound v2024	Audit shipment in Panel 7G & submit BOL/Invoice claim packet for missing units.
Geopolitical & USTR 30/60/90-Day Tariff Notices	Weekly (and upon political announcements)	Free Federal Register API (`federalregister.gov/api/v1`) & USTR Dockets	Log upcoming hike in Panel 7E & run CBP Entry-Date Collision / Front-Load Arbitrage check.
Global Holiday & Factory Blackout Windows (CNY / Q4)	45–60 Days Before Window	Factory Production Cutoff Schedule (`global_supply_calendar_events`)	Run Panel 7F Blackout Buffer Adjuster to pull forward pre-CNY / pre-Q4 POs.
Ocean LCL (`$/CBM`) & Air DDP (`$/kg`) Spot Rates	Every 14 Days (and before every PO)	Freightos Baltic Index (FBX) / Forwarder Quote Sheet	Update `SEA_LCL_RATE_PER_CBM_USD` in Panel 7C & re-run Panel 3C.
US Customs HTS Duty & China Section 301 Tariffs	Every 30 Days (plus Jan 1 & Jul 1 USITC revisions)	Free USITC HTS API (`hts.usitc.gov`) & Federal Register	Update `CHINA_SECTION_301_TARIFF_PCT` in Panel 7C & run Rate Shock Simulator.
Amazon FBA Monthly Storage & Q4 Peak Rates	Every 60 Days (Seasonal switch Oct 1 & Jan 1)	Amazon Seller Central Storage Fee Schedule	Update `FBA_Q4_PEAK_STORAGE_CUFT_USD` in Panel 7C & run Panel 5B 3PL Drip-Feed Optimizer.
Amazon FBA Fulfillment Tier Fees & Low-Inventory Bands	Every 90 Days (Annual schedule update Jan/Feb + Oct 15 Peak)	Amazon SP-API `Product Fees API v0`	Update `FBA_SMALL_STD_BASE_FEE_USD` / `FBA_LARGE_STD_BASE_FEE_USD` in Panel 7C.
Bi-Weekly Settlement vs. Expected Fee Reconciliation	Every 14 Days (on each Amazon payout)	Seller Central `Reports -> Payments -> All Statements`	Log payout in Panel 7D to catch hidden fee overcharges & export CPA CSV.

Physical Purchase Order State Machine, SLA Watchdogs & Escalation Control

1. State Machine Classification: Transitional vs. True Terminal States

The Purchase Order lifecycle is governed by a strict Finite State Machine. Every order exists in one of three functional tiers:

┌──────────────────────────────────────────────────────────────────────────────────┐
│                             PURCHASE ORDER STATE TIERS                           │
├──────────────────────┬─────────────────────────┬─────────────────────────────────┤
│ Tier                 │ States                  │ Characteristics                 │
├──────────────────────┼─────────────────────────┼─────────────────────────────────┤
│ 1. Initiation        │ DRAFT_PO,               │ Unfunded; awaiting human        │
│                      │ AWAITING_APPROVAL       │ founder authorization           │
├──────────────────────┼─────────────────────────┼─────────────────────────────────┤
│ 2. In-Flight         │ SUPPLIER_ORDERED,       │ Active physical transit;        │
│    (Transitional)    │ CONDITIONAL_HOLD,       │ subject to automated SLA        │
│                      │ ARRIVED_AT_3PL,         │ watchdogs and quality gates     │
│                      │ FBA_LABELS_GENERATED,   │                                 │
│                      │ IN_TRANSIT_TO_FBA       │                                 │
├──────────────────────┼─────────────────────────┼─────────────────────────────────┤
│ 3. Terminal          │ CLOSED                  │ Terminal Success (Units live)   │
│    (Immutable)       ├─────────────────────────┼─────────────────────────────────┤
│                      │ REJECTED / CANCELLED    │ Terminal Abort (Capital recovered)│
└──────────────────────┴─────────────────────────┴─────────────────────────────────┘

2. Deep Dive: Transitional Holding States (What Picks Them Back Up?)

A. `CONDITIONAL_HOLD` (Not a Terminal State)

Why It Happens: The Pre-Shipment Inspection (PSI) detected defect rates exceeding ISO 2859-1 Level II AQL 2.5/4.0 limits (or drop test failure), but below the catastrophic 100% rejection ceiling. 70% balance payment is frozen in escrow.
The Remediation Window: The factory is legally contractually bound to execute 100% rework on defective units within 7–10 calendar days at their expense.
What Picks It Back Up:
Re-Inspection (Re-PSI) Upload: The third-party inspector reinspects the reworked batch and logs a new inspection report via POST /api/v1/quality/inspections.
Pass Branch: If the re-inspection passes (PASSED_RELEASE_70_PCT_BALANCE), the PO transitions back to SUPPLIER_ORDERED (cleared for departure) and releases the 70% wire.
Fail Branch: If the supplier refuses rework or fails the second inspection, the founder triggers one-click cancellation, transitioning the PO to the true terminal state: REJECTED, and files an Alibaba Trade Assurance / insurance clawback memo via POST /api/v1/clawbacks/calculate.

B. `ARRIVED_AT_3PL` $\rightarrow$ `FBA_LABELS_GENERATED` (Not a Terminal State)

Why It Happens: Master cartons have been unloaded, deconsolidated from the ocean container, and scanned into the 3PL Carson staging facility (threePlReceiptId generated).
What Picks It Back Up:
Automated SP-API Handoff: SupplyChainOrchestratorService.automate3plArrivalAndFbaLabelHandoff catches the 3PL receiving webhook, calls Amazon SP-API Fulfillment Inbound v2024 to generate the inbound shipment plan, and downloads thermal FNSKU barcodes and 4x6" master carton box labels.
WMS Dispatch: The label bundle is automatically uploaded into the 3PL's warehouse management system (WMS).
Carrier BOL Pickup: Once 3PL warehouse staff affixes the labels, the Amazon Partnered Carrier (or LTL freight line) scans the bill of lading (BOL). The carrier milestone webhook dispatches markShippedToFba(poId, carrierTrackingNumber), automatically advancing the order to IN_TRANSIT_TO_FBA.
Terminal Closure: When Amazon FC staff scans the cartons into sellable inventory at the dock (ONT8/GYR3), the inbound shipment RECEIVING_COMPLETED webhook triggers closeCompletedOrder(poId), landing the order in its true terminal state: CLOSED.

3. Automated SLA Watchdog & Ghost-Supplier Circuit Breakers

To guarantee no purchase order ever waits indefinitely:

Lifecycle Trigger	Target SLA Window	Watchdog Escalation Point	Automated System Action	Founder Options (You)
PO Approval	72 hours	Day 4 without approval	Stale draft flag on dashboard	• One-click Sign Off • Delete / Reject Draft
Manufacturing & PSI	Production Lead Days (e.g., 28d)	Lead Days + 5 grace days without logged QC	Dispatches High-Priority Slack/Discord alert: "PO Overdue by 5 days"	• WeChat push to factory • Grant 7-day grace extension • Transition to `REJECTED` & refund
Rework Hold	10 calendar days	Day 11 without Re-PSI report	Freezes PO in Command Center; docks 20 points from Supplier SLA Scorecard	• Force Trade Assurance wire dispute • Reroute batch to backup factory
3PL Cross-Docking	3 business days	Day 4 without carton label generation	Pings 3PL warehouse floor supervisor	• Review dock exception photos • Override receiving unit count
Inbound FBA Check-in	14 calendar days	Day 15 without Amazon dock scan	Dispatches SP-API discrepancy audit request	• File Amazon FBA lost-inventory claim (Panel 7G / 7Q)

Sprint 1–4 & Closed-Loop Calibration Modules (`5M`, `6DD`, `5BB`, `5BE`, `5LI`, `6VOC`, `5AWD`, `5AMS`, `2COO`, `2CBD`, `6BQ`, `6CAL`)

Panel 6CAL: Closed-Loop Forecast vs. Actual Calibration, HITL Approval Gate & 8-SKU Chaos Benchmark (`/api/v1/calibration`)

API Endpoints:
POST /api/v1/calibration/evaluate
GET /api/v1/calibration/sample?scenario=CUBISCAN_AND_PPC_DRIFT
GET /api/v1/calibration/reconcile/{sku} (Live DB join across sku_settlement_ledgers + candidate_products)
POST /api/v1/calibration/propose (Stages a PENDING_APPROVAL policy rate adjustment without mutating live rates)
POST /api/v1/calibration/proposals/{id}/decision?action=APPROVE|REJECT (Founder sign-off applying or dismissing the staged proposal)
POST /api/v1/calibration/portfolio-benchmark (8-SKU Sandbox Chaos & Calculator Verification Suite)
SQL Table: forecast_calibration_audits
What It Does in the System Today:
Reconciles Ex-Ante Pre-Launch Forecasted Unit Economics against Ex-Post Realized Settlement & 3PL Actuals across 6 deterministic cost buckets.
Human-in-the-Loop (HITL) Calibration Approval Gate: Staging a calibration proposal (POST /propose) never mutates your global policy rates automatically. Instead, it creates a PENDING_APPROVAL record and dispatches a Discord approval card so you can Approve (if the fee/tariff shift is permanent) or Reject (if it was a one-off anomaly like an Amazon Cubiscan error that should be disputed via Panel 7AI instead).
8-SKU Sandbox Chaos Benchmark Suite: Injects synthetic operational friction across 8 catalog cohorts and verifies 100.00% penny-exact leakage detection.

Panel 6RDY: Pre-Flight Production Readiness Inspector, Clean-Slate Mode & Seller Central TSV Importer (`/api/v1/system`)

API Endpoints:
GET /api/v1/system/readiness (7-subsystem Pre-Flight Production & Live-API Readiness Diagnostic)
POST /api/v1/system/clean-slate (Purges sandbox demo SKUs/POs/settlements and sets DEMO_SEED_ENABLED=false)
POST /api/v1/system/reseed-demo (Re-enables DEMO_SEED_ENABLED=true and restores sandbox training benchmarks)
GET /api/v1/system/rate-limits (Inspects live token-bucket rate limiters for SP_API_PRICING, SP_API_INVENTORY, SP_API_INBOUND, and KEEPA_PRODUCT)
POST /api/v1/ledger/import-seller-central-csv & GET /api/v1/ledger/sample-seller-central-tsv
What It Does in the System Today:
Clean-Slate Production Mode: On Day 1 when launching your first real SKU, click 🧹 Purge Demo Data (Clean Slate) in Panel 6RDY (or set DEMO_SEED_ENABLED=false in .env) so fake demo items (B09SPICE01, ELEC-CHARGER-65W) are wiped and never re-seeded into your real accounting ledgers.
Day-1 Seller Central Flat-File V2 Settlement TSV/CSV Importer: While waiting 1–3 weeks for Amazon to approve your production SP-API developer credentials, download your bi-weekly Flat-File V2 Settlement .tsv from Seller Central and paste/import it in Panel 6RDY to run full fee reconciliation and CPA journal CSV exports on Day 1.
Token-Bucket Rate Limiter (ExternalApiRateLimiter): Enforces burst/restore quotas and honors HTTP 429 Retry-After and x-amzn-RateLimit-Limit headers across SP-API and Keepa.

Panel 6SEC & `/login.html`: 5-Role RBAC Delegation, Discord Founder Gate & HMAC Magic Links (`/api/v1/security`)

API Endpoints:
POST /api/v1/security/login, POST /api/v1/security/logout, GET /api/v1/security/me
GET /api/v1/security/status, POST /api/v1/security/simulate-access, POST /api/v1/security/toggle
POST /api/v1/security/magic-link (Generates time-bound HMAC-SHA256 Magic Links for /inspector.html & /warehouse.html)
What It Does in the System Today:
Zero-Cost ($0/mo) 5-Role RBAC & Portal Isolation (RbacPortalIsolationFilter): Isolates FOUNDER_ADMIN, OPS_MANAGER (VA), WAREHOUSE_3PL, QC_INSPECTOR, and CPA_AUDITOR using stateless 30-day HMAC-signed HttpOnly cookies (SAMMOHO_SESSION) or X-Operator-Key headers.
Discord Channel Founder Gate: If your OPS_MANAGER (VA) is in your Discord server and clicks [⏳ Snooze 48h], it succeeds; if they click [✅ Approve PO] or [❌ Reject PO], the browser intercepts the request with a 🔐 Founder Authorization Required PIN prompt.
Passwordless Time-Bound HMAC Magic Links (?magicToken=...): Generate a 7-day signed link in Panel 6SEC and send it via WeChat/WhatsApp to your Chinese QC inspector (/inspector.html?magicToken=...&sku=...&tab=aql) or 3PL dock worker (/warehouse.html?magicToken=...&bay=...). Clicking the link automatically verifies the HMAC signature, sets a role-scoped SAMMOHO_SESSION cookie, and opens /inspector.html or /warehouse.html in Blind PO Mode (with factory FOB costs and margins redacted) while blocking /index.html (403 Forbidden).
Discord Channel Hygiene (POST /api/v1/notifications/discord/purge-aged): Edits resolved Discord cards in-place (PATCH) and purges aged/resolved messages from the Discord channel via DELETE while preserving all SQL audit rows in hitl_alert_logs.
Architectural Highlights:
Dynamic Policy Registry Synchronization (SupplyChainPolicyProperties): Updating any tariff, FBA fee, or storage rate in Panel 5R (PUT /api/v1/policy/rates) immediately propagates into the live SupplyChainPolicyProperties bean in memory, updating all 16 downstream calculators without restarting the container.
Command Center Quick-Jump (Ctrl+K): Instant real-time module search and filtering in the sticky Command Center header across all 100+ panels.

Panel 7AE: Factory-Floor BOM Reverse-Engineering & Alibaba / 1688 RFQ Dispatcher (`/api/v1/procurement/bom` | Module 106 | Table #114)

API Endpoints:
POST /api/v1/procurement/bom/estimate
GET /api/v1/procurement/bom/history/{sku}
GET /api/v1/procurement/bom/materials
What It Does in the System Today:
Raw Material Commodity Breakdown: Deconstructs any product's net weight in grams against real-world commodity benchmarks (Food-grade Silicone: $4.50/kg, 304 Stainless Steel: $3.25/kg, ABS Plastic: $2.20/kg, Polypropylene: $1.65/kg, 6061 Aluminum: $4.10/kg, Memory Foam: $3.80/kg, 600D Oxford: $3.50/kg) with 5% scrap margin.
Tooling Amortization & Assembly Labor: Factoring in amortized injection molds across batch MOQ and Chinese labor & machine cycles ($0.22 - $0.55/unit) plus 12% factory electricity and management overhead.
Deterministic Negotiation Brackets: Outputs both a Fair Target FOB (15% factory gross margin) and an Aggressive Negotiation Floor (8% factory gross margin).
Instant 1-Click Bilingual RFQs: Generates ready-to-dispatch inquiry letters in English and Chinese (1688/WeChat 询盘信) with buyer credentials (Sammoho Holdings LLC), trial MOQ, FOB port, 30/70 T/T payment terms, and required testing certifications (FDA/LFGB/CE).

Panel 7AF: Rolling 90-Day Cash Runway & 30/70 Supplier Capital Scheduler (`/api/v1/finance/runway` | Module 107 | Table #115)

API Endpoints:
POST /api/v1/finance/runway/simulate
GET /api/v1/finance/runway/latest
What It Does in the System Today:
Multi-Milestone Restock Cash Horizon: Models cash inflows and outflows across the entire 90-day manufacturing and shipping timeline:
- Day 0: 30% PO deposit wired to factory.
- Day 30: 70% PO balance wired upon original Bill of Lading (B/L) issue.
- Day 40: CBP Customs duties (Section 301 tariffs + 0.3464% MPF) paid upon entry summary.
- Day 45: Freight forwarder ocean container & 3PL drayage settled.
- Days 14, 28, 42, 56, 70, 84: Bi-weekly Amazon settlement disbursements deposited.
Liquidity Trough & Solvency Protection: Computes the exact minimum treasury cash trough and warning level (HEALTHY_SOLVENT, CAPITAL_CRUNCH_WARNING, or INSOLVENCY_DEFICIT).
Dynamic Maximum PO Calculation: Algorithmic ceiling on maximum safe purchase order size that guarantees cash reserves never dip below the $2,000 emergency liquidity threshold.

Panel 7CB: Multi-Currency Forward FX Hedging & Depletion Lock (`/api/v1/finance/forward/contracts` | Module 155 | Table #164)

API Endpoints: POST /api/v1/finance/forward/contracts, POST /api/v1/finance/forward/contracts/{contractId}/status, GET /api/v1/finance/forward/contracts
What It Does: Locks foreign exchange rates (USD/CNY or USD/EUR) for upcoming 70% ex-factory purchase order wire balances. Computes real-time mark-to-market valuations and unrealized hedge gain/loss metrics using strict BigDecimal math to protect landed product margins from currency volatility.

Panel 7CC: Port Terminal PierPass & Clean Truck Surcharge Sentry (`/api/v1/logistics/pierpass/audits` | Module 156 | Table #165)

API Endpoints: POST /api/v1/logistics/pierpass/audits, POST /api/v1/logistics/pierpass/audits/{auditId}/status, GET /api/v1/logistics/pierpass/audits
What It Does: Audits drayage container appointments at major US ports (USLAX/USLGB). Calculates Traffic Mitigation Fees (PierPass TMF @ $34.21/TEU) and Clean Truck Fund (CTF @ $10.00/TEU), highlighting off-peak night/weekend gate appointment savings ($0 TMF waiver).

Panel 7CD: Autonomous AWD to Prime FBA Cross-Dock Pallet Shuttler (`/api/v1/awd/shuttle` | Module 157 | Table #166)

API Endpoints: POST /api/v1/awd/shuttle/dispatch, POST /api/v1/awd/shuttle/{shuttleId}/status, GET /api/v1/awd/shuttle/shuttles
What It Does: Automates pallet transfer orders from Amazon AWD upstream low-cost storage into high-velocity Prime fulfillment centers. Automatically calculates the $0.32/unit inbound placement fee waiver against $18.50/pallet handling costs to guarantee net positive replenishment margins.

Panel 7CE: Maritime GRI & Bunker Fuel Surcharge (BAF) Predictor (`/api/v1/maritime/fuel` | Module 158 | Table #167)

API Endpoints: POST /api/v1/maritime/fuel/forecast, POST /api/v1/maritime/fuel/{forecastId}/status, GET /api/v1/maritime/fuel/forecasts
What It Does: Predicts ocean carrier General Rate Increases (GRI) and Bunker Adjustment Factors (BAF @ $8.50/FEU per $1/bbl crude). Analyzes transpacific vessel capacity curves to recommend booking actions (LOCK_EARLY_DEPARTURE vs SPOT_WAIT).

Panel 7CF: Project Zero Automated Counterfeit Self-Removal Sentry (`/api/v1/brandprotection/projectzero` | Module 159 | Table #168)

API Endpoints: POST /api/v1/brandprotection/projectzero/takedown, POST /api/v1/brandprotection/projectzero/{takedownId}/status, GET /api/v1/brandprotection/projectzero/takedowns
What It Does: Leverages Amazon Brand Registry Project Zero privileges for immediate zero-hour rogue hijacker takedowns without manual Seller Support ticketing, quantifying preserved revenue velocity.

Panel 7CG: Factory Sedex SMETA Ethical Trade & Social Audit Compliance Studio (`/api/v1/procurement/smeta` | Module 160 | Table #169)

API Endpoints: POST /api/v1/procurement/smeta/audit, POST /api/v1/procurement/smeta/{auditId}/status, GET /api/v1/procurement/smeta/audits
What It Does: Audits factory 2-Pillar and 4-Pillar SMETA compliance across Labor, Health & Safety, Environment, and Business Ethics. Deterministically deducts points for critical, major, and minor non-conformances, assigning compliance tiers (TIER_A_EXEMPLARY, TIER_B_ACCEPTABLE, TIER_C_HIGH_RISK_CAPA).

Panel 7CH: Amazon Vine Review Enrollment & Unit Cost-Per-Review ROI Calculator (`/api/v1/marketing/vine` | Module 161 | Table #170)

API Endpoints: POST /api/v1/marketing/vine/enroll, POST /api/v1/marketing/vine/{enrollmentId}/status, GET /api/v1/marketing/vine/enrollments
What It Does: Models tiered Amazon Vine Voice reviewer enrollment fees ($0 up to 2 units, $75 up to 10 units, $200 up to 30 units), free sample inventory unit COGS, and cost-per-review metrics (assuming 85% review velocity).

Panel 7CI: Ocean Container Rail Intermodal In-Transit Dwell & Railcar Bottleneck Sentry (`/api/v1/logistics/raildwell` | Module 162 | Table #171)

API Endpoints: POST /api/v1/logistics/raildwell/audit, POST /api/v1/logistics/raildwell/audits/{auditId}/status, GET /api/v1/logistics/raildwell/audits
What It Does: Monitors Class I inland rail terminal ramps (BNSF/UP Chicago/Dallas). Tracks dwell against standard 48-hour free time, daily storage demurrage ($150/day), and daily chassis rental ($35/day), categorizing bottleneck risk into ON_SCHEDULE, ELEVATED_RISK, or CRITICAL_CONGESTION.

Panel 7CJ: Amazon Business Quantity Discount (QD) Tier Matrix & B2B Volume Price Governor (`/api/v1/pricing/quantitydiscount` | Module 163 | Table #172)

API Endpoints: POST /api/v1/pricing/quantitydiscount/tier, POST /api/v1/pricing/quantitydiscount/tiers/{tierId}/status, GET /api/v1/pricing/quantitydiscount/tiers
What It Does: Configures Amazon Business volume break discount schedules while enforcing strict minimum profit margin floors per tier (default 20.00%) to safeguard profitability on B2B orders.

Panel 7CK: Lithium Battery UN 38.3 & Dangerous Goods Transport Certification Ledger (`/api/v1/compliance/battery` | Module 164 | Table #173)

API Endpoints: POST /api/v1/compliance/battery/audit, POST /api/v1/compliance/battery/audits/{auditId}/status, GET /api/v1/compliance/battery/audits
What It Does: Audits lithium battery models, computing Watt-hour ratings and verifying UN 38.3 test summaries. Automatically classifies items into SECTION_II_EXEMPT_CELL (<=20Wh), SECTION_II_EXEMPT_BATTERY (<=100Wh), or CLASS_9_FULLY_REGULATED_HAZMAT with cargo aircraft flight restrictions.

Panel 7CL: FBA Customer Return Liquidation & Grade-and-Resell Recovery Maximizer (`/api/v1/recovery/liquidation` | Module 165 | Table #174)

API Endpoints: POST /api/v1/recovery/liquidation/evaluate, POST /api/v1/recovery/liquidation/evaluations/{evaluationId}/status, GET /api/v1/recovery/liquidation/evaluations
What It Does: Compares net salvage yields: Amazon FBA Liquidations (7.50% gross recovery minus 15% Amazon fee) versus 3PL removal and refurbishing for Used-Like-New secondary resale (50% retail minus costs), recommending the optimal recovery channel.

Panel 7CM: Supplier Quality Non-Conformance Report (NCR) & Material Review Board (MRB) Escrow (`/api/v1/quality/mrb` | Module 166 | Table #175)

API Endpoints: POST /api/v1/quality/mrb/audit, POST /api/v1/quality/mrb/audits/{auditId}/status, GET /api/v1/quality/mrb/audits
What It Does: Tracks factory defect rates in PPM and automates Material Review Board (MRB) disposition financial chargebacks (SCRAP, REWORK, USE_AS_IS_CONCESSION, RETURN_TO_VENDOR) plus a standard $250 inspection fee against supplier wire escrows.

Panel 7CN: Amazon FBA Subscribe & Save Tiered Discount Margin Forecaster (`/api/v1/marketing/sns` | Module 167 | Table #176)

API Endpoints: POST /api/v1/marketing/sns/forecast, POST /api/v1/marketing/sns/{forecastId}/status, GET /api/v1/marketing/sns/forecasts
What It Does: Models seller-funded 5% vs 10% Subscribe & Save discounts against base unit margins. Enforces a 25.00% profit hurdle rate to recommend SKU enrollment (RECOMMEND_ENROLL_SNS vs HOLD_MARGIN_DILUTIVE).

Panel 7CO: Marine Terminal Container Gate Reservation & Vessel Cut-Off Sentry (`/api/v1/logistics/gatereservation` | Module 168 | Table #177)

API Endpoints: POST /api/v1/logistics/gatereservation/reserve, POST /api/v1/logistics/gatereservation/reservations/{reservationId}/status, GET /api/v1/logistics/gatereservation/reservations
What It Does: Manages marine container gate appointment slots against vessel cut-off timelines. Detects late gate surcharges ($175 for < 12h) and flags missed vessel risk tiers (SCHEDULED_ON_TRACK, URGENT_DISPATCH_REQUIRED, ROLLOVER_IMMINENT_CRITICAL).

Panel 7CP: Multi-Carrier Small Parcel Dimensional Weight (DIM) Factor Optimizer (`/api/v1/logistics/dimfactor` | Module 169 | Table #178)

API Endpoints: POST /api/v1/logistics/dimfactor/optimize, POST /api/v1/logistics/dimfactor/optimizations/{optimizationId}/status, GET /api/v1/logistics/dimfactor/optimizations
What It Does: Calculates package volume and compares commercial parcel DIM divisors: FedEx/UPS DIM 139 vs USPS DIM 166. Identifies whether cartons qualify for USPS Priority Cubic to minimize billable shipping costs.

Panel 7CQ: Proposition 65 & Heavy Metals Chemical Testing Certificate Vault (`/api/v1/compliance/prop65` | Module 170 | Table #179)

API Endpoints: POST /api/v1/compliance/prop65/certificate, POST /api/v1/compliance/prop65/certificates/{certificateId}/status, GET /api/v1/compliance/prop65/certificates
What It Does: Ingests laboratory chemical test reports (SGS, Intertek). Validates Lead (max 100 ppm), Cadmium (max 300 ppm), and Phthalates (max 1000 ppm) against California Prop 65 safe harbor limits, determining warning label requirements.

Panel 7CR: Amazon Prime Day / Black Friday Lightning Deal Fee & Profit Governor (`/api/v1/pricing/lightningdeal` | Module 171 | Table #180)

API Endpoints: POST /api/v1/pricing/lightningdeal/deal, POST /api/v1/pricing/lightningdeal/deals/{dealId}/status, GET /api/v1/pricing/lightningdeal/deals
What It Does: Governs promotional deal submissions, factoring in deal promotion fees ($150 standard / $300 Prime Day / $500 Black Friday), minimum 20% discounts, and Amazon referral fees, strictly approving deals achieving > 12.00% net margin.

Panel 7CS: Factory Tooling & Injection Mold Capital Depreciation Asset Sentry (`/api/v1/procurement/tooling` | Module 172 | Table #181)

API Endpoints: POST /api/v1/procurement/tooling/asset, POST /api/v1/procurement/tooling/assets/{assetId}/status, GET /api/v1/procurement/tooling/assets
What It Does: Amortizes steel injection mold capital depreciation per unit shot ($0.0500/shot), tracking cumulative book depreciation, remaining book value, and mold wear health percentage (flagging maintenance overhaul when wear health <= 15.00%).

Panel 7CT: Amazon FBA Dangerous Goods / HAZMAT Storage Surcharge Forecaster (`/api/v1/compliance/hazmatstorage` | Module 173 | Table #182)

API Endpoints: POST /api/v1/compliance/hazmatstorage/forecast, POST /api/v1/compliance/hazmatstorage/forecasts/{forecastId}/status, GET /api/v1/compliance/hazmatstorage/forecasts
What It Does: Models dangerous goods inventory storage fees ($0.99/cu.ft. standard vs $1.39/cu.ft. Q4 peak) against specialized 3PL DG warehousing costs ($0.65/cu.ft.), generating automated transfer triggers when storage savings exceed $150/mo.

Panel 7CU: Ocean Container Chassis Split & Tri-Axle Heavy Weight Sentry (`/api/v1/logistics/chassissplit` | Module 174 | Table #183)

API Endpoints: POST /api/v1/logistics/chassissplit/audit, POST /api/v1/logistics/chassissplit/audits/{auditId}/status, GET /api/v1/logistics/chassissplit/audits
What It Does: Audits drayage container cargo gross weight against US DOT bridge law limits (>44,000 lbs cargo), calculating tri-axle chassis surcharges ($125/day) and terminal chassis split dry-run accessorials ($110 flat).

Panel 7CV: TikTok Shop & Shopify Omnichannel Inventory Buffer Governor (`/api/v1/inventory/buffer` | Module 175 | Table #184)

API Endpoints: POST /api/v1/inventory/buffer/allocate, POST /api/v1/inventory/buffer/buffers/{bufferId}/status, GET /api/v1/inventory/buffer/buffers
What It Does: Partitions safety stock across Amazon FBA Multi-Channel Fulfillment (MCF), TikTok Shop flash sale buffers, and Shopify DTC reserves, automatically consolidating inventory to Amazon Prime when total catalog stock drops below critical thresholds.

Panel 7CW: FDA Food Contact Substance (FCS) Material Compliance Sentry (`/api/v1/compliance/foodcontact` | Module 176 | Table #185)

API Endpoints: POST /api/v1/compliance/foodcontact/audit, POST /api/v1/compliance/foodcontact/audits/{auditId}/status, GET /api/v1/compliance/foodcontact/audits
What It Does: Audits laboratory overall migration limits (<= 10.0 mg/dm²) and volatile organic matter (<= 0.50%) under FDA 21 CFR § 177 for kitchenware, silicone, and polypropylene food-contact articles.

Panel 7CX: Dynamic Coupon Clipping Fee ($0.60/redemption) ROI Forecaster (`/api/v1/marketing/coupon` | Module 177 | Table #186)

API Endpoints: POST /api/v1/marketing/coupon/forecast, POST /api/v1/marketing/coupon/forecasts/{forecastId}/status, GET /api/v1/marketing/coupon/forecasts
What It Does: Computes the true landed economics of Amazon digital coupons: the flat $0.60 clipping fee plus discount value across projected redemptions, ensuring campaigns exceed an 18.00% net margin hurdle rate.

Panel 7CY: Factory Production Milestones & Stage-Gate Holdback Ledger (`/api/v1/procurement/holdback` | Module 178 | Table #187)

API Endpoints: POST /api/v1/procurement/holdback/milestone, POST /api/v1/procurement/holdback/milestones/{holdbackId}/status, GET /api/v1/procurement/holdback/milestones
What It Does: Enforces a 3-stage milestone release schedule (30% deposit, 40% mid-production, 30% final balance) locked in escrow until third-party pre-shipment AQL inspection passes.

Panel 7CZ: Amazon FBA Remote Fulfillment with Prime (NARF) Cross-Border Studio (`/api/v1/crossborder/narf` | Module 179 | Table #188)

API Endpoints: POST /api/v1/crossborder/narf/evaluate, POST /api/v1/crossborder/narf/evaluations/{evaluationId}/status, GET /api/v1/crossborder/narf/evaluations
What It Does: Evaluates export economics for selling US FBA stock to Canadian (.ca) and Mexican (.com.mx) buyers, factoring in NARF fulfillment surcharges, import VAT/GST, and currency conversion.

Panel 7DA: Ocean Carrier Low Sulfur Fuel (VLSFO) / IMO 2020 Surcharge Ledger (`/api/v1/maritime/vlsfo` | Module 180 | Table #189)

API Endpoints: POST /api/v1/maritime/vlsfo/audit, POST /api/v1/maritime/vlsfo/audits/{auditId}/status, GET /api/v1/maritime/vlsfo/audits
What It Does: Compares carrier Low Sulfur Fuel surcharges against global VLSFO/HSFO bunker fuel spreads, identifying carrier accessorial overcharges and generating dispute claims when variances exceed $15.00/TEU.

Panel 7DB: Amazon Brand Registry Report a Violation (RAV) IP Infringement Sentry (`/api/v1/brandprotection/rav` | Module 181 | Table #190)

API Endpoints: POST /api/v1/brandprotection/rav/file, POST /api/v1/brandprotection/rav/filings/{filingId}/status, GET /api/v1/brandprotection/rav/filings
What It Does: Automates Brand Registry IP complaints for design patent piracy, trademark counterfeiting, and copyright image theft, calculating monthly brand harm values and filing priority cases.

Panel 7DC: Panama & Suez Canal Transit Disruption & War Risk Surcharge Forecaster (/api/v1/maritime/canalsurcharge | Module 182 | Table #191)

API Endpoints: POST /api/v1/maritime/canalsurcharge/forecast, POST /api/v1/maritime/canalsurcharge/forecasts/{forecastId}/status, GET /api/v1/maritime/canalsurcharge/forecasts
What It Does: Models Panama Canal booking slot auction premiums (,000–,000/slot) and Red Sea/Suez Canal diversions around the Cape of Good Hope (+12 transit days, +/TEU fuel & war risk insurance), recommending optimal transit routes.

Panel 7DD: Cross-Border Multi-Currency Treasury & Forward Contract Hedge Governor (/api/v1/finance/forex | Module 183 | Table #192)

API Endpoints: POST /api/v1/finance/forex/contract, POST /api/v1/finance/forex/contracts/{contractId}/status, GET /api/v1/finance/forex/contracts
What It Does: Evaluates foreign exchange exposure on future overseas factory PO commitments in CNY and CAD, locking in forward contracts and computing mark-to-market variances against budget hedge benchmarks.

Panel 7DE: Section 321 De Minimis Commercial Manifest Compliance Sentry (/api/v1/customs/manifest321 | Module 184 | Table #193)

API Endpoints: POST /api/v1/customs/manifest321/audit, POST /api/v1/customs/manifest321/audits/{auditId}/status, GET /api/v1/customs/manifest321/audits
What It Does: Audits direct-to-consumer imports under 19 U.S.C. § 1321 against the /day aggregate consignee exemption ceiling, validating CBP Entry Type 86 commercial manifests and flagging administrative hold risks.

Panel 7DF: Amazon Sponsored Display VCPM (Viewable CPM) Attribution Auditor (/api/v1/ppc/vcpm | Module 185 | Table #194)

API Endpoints: POST /api/v1/ppc/vcpm/audit, POST /api/v1/ppc/vcpm/audits/{auditId}/status, GET /api/v1/ppc/vcpm/audits
What It Does: Audits Amazon Sponsored Display view-through attribution (vCPM billing per 1,000 viewable impressions), separating view-through vs click-through orders and identifying organic conversion cannibalization.

Panel 7DG: Amazon FBA Low-Price FBA Fee (<) Threshold Optimization Engine (/api/v1/pricing/lowpricefba | Module 186 | Table #195)

API Endpoints: POST /api/v1/pricing/lowpricefba/optimize, POST /api/v1/pricing/lowpricefba/optimizations/{optimizationId}/status, GET /api/v1/pricing/lowpricefba/optimizations
What It Does: Models Amazon's Low-Price FBA fulfillment fee schedule (.77 discount on items priced <.00), analyzing unit price elasticity (.99 vs .49 net margin crossover) and automating price adjustments.

Panel 7DH: Dead Stock Liquidation & Wholesale B2B Salvage Auction Ledger (/api/v1/inventory/salvage | Module 187 | Table #196)

API Endpoints: POST /api/v1/inventory/salvage/auction, POST /api/v1/inventory/salvage/auctions/{auctionId}/status, GET /api/v1/inventory/salvage/auctions
What It Does: Governs aged/slow-moving ASIN liquidation bids across secondary wholesale liquidation brokers at 10%–25% of retail, evaluating net cash recovery against ongoing storage fee burn rates.

Panel 7DI: Factory Corrective Action Plan (CAPA) & 8D Root-Cause Resolution Vault (/api/v1/procurement/capa | Module 188 | Table #197)

API Endpoints: POST /api/v1/procurement/capa/resolution, POST /api/v1/procurement/capa/resolutions/{resolutionId}/status, GET /api/v1/procurement/capa/resolutions
What It Does: Governs factory 8D Root Cause Problem Solving and CAPA cycles for recurring factory manufacturing defects, verifying containment actions, 5-Why root cause investigations, and sign-offs.

Panel 7DJ: Customer Warranty & Return Defect Indemnity Reserve Ledger (/api/v1/finance/indemnity | Module 189 | Table #198)

API Endpoints: POST /api/v1/finance/indemnity/reserve, POST /api/v1/finance/indemnity/reserves/{reserveId}/status, GET /api/v1/finance/indemnity/reserves
What It Does: Calculates manufacturer warranty reserve liabilities (2.5%–4.0% of landed COGS), tracking supplier chargeback recovery for customer returns classified as factory product defects.

Panel 7DK: Amazon Counterfeit Crimes Unit (CCU) Joint Law Enforcement Referral Sentry (/api/v1/brandprotection/ccu | Module 190 | Table #199)

API Endpoints: POST /api/v1/brandprotection/ccu/dossier, POST /api/v1/brandprotection/ccu/dossiers/{dossierId}/status, GET /api/v1/brandprotection/ccu/dossiers
What It Does: Assembles comprehensive criminal prosecution referral dossiers for Amazon CCU and federal law enforcement (HSI/DOJ), synthesizing test buy evidence, rogue seller bank accounts, and customs BOL records.

Panel 7DL: Amazon Lightning Deal & 7-Day Deal Dynamic Yield Optimizer (/api/v1/marketing/deals/yield | Module 191 | Table #200)

API Endpoints: POST /api/v1/marketing/deals/yield/optimize, POST /api/v1/marketing/deals/yield/optimizations/{optimizationId}/status, GET /api/v1/marketing/deals/yield/optimizations
What It Does: Evaluates Amazon promotional deals ($300 Lightning / $150 7-Day Deal fees, mandatory 15% discount floor), calculating estimated unit velocity lifts, promotional margin deltas, and organic BSR halo profitability.

Panel 7DM: Factory Tooling, Injection Mold & Capital Asset Depreciation Amortizer (/api/v1/procurement/tooling/depreciation | Module 192 | Table #201)

API Endpoints: POST /api/v1/procurement/tooling/depreciation/amortize, POST /api/v1/procurement/tooling/depreciation/amortizations/{amortizationId}/status, GET /api/v1/procurement/tooling/depreciation/amortizations
What It Does: Amortizes custom steel injection molds and tooling investments ($3k-$25k) over rated production shot lifespans, computing per-unit capital cost deductions and remaining unamortized asset value.

Panel 7DN: US Customs Continuous Entry Bond & AD/CVD Tariff Escrow Sentry (/api/v1/customs/bond/escrow | Module 193 | Table #202)

API Endpoints: POST /api/v1/customs/bond/escrow/audit, POST /api/v1/customs/bond/escrow/audits/{auditId}/status, GET /api/v1/customs/bond/escrow/audits
What It Does: Audits US Customs Continuous Entry Bonds ($50,000 baseline) against rolling 12-month import duty liability and calculates required cash deposit reserves for Anti-Dumping / Countervailing Duties (AD/CVD).

Panel 7DO: Amazon Seller-Fulfilled Prime (SFP) Regional Speed & Delivery Auditor (/api/v1/logistics/sfp/speed | Module 194 | Table #203)

API Endpoints: POST /api/v1/logistics/sfp/speed/audit, POST /api/v1/logistics/sfp/speed/audits/{auditId}/status, GET /api/v1/logistics/sfp/speed/audits
What It Does: Monitors Seller-Fulfilled Prime regional speed thresholds (>=93.5% 1-day delivery, >=95.0% standard delivery, >=99.0% valid tracking), comparing regional 3PL ground fulfillment rates against Amazon FBA fees.

Panel 7DP: FBA Customer Return Refurbishment & Re-Kitting Workflow Studio (/api/v1/inventory/refurbish/grade | Module 195 | Table #204)

API Endpoints: POST /api/v1/inventory/refurbish/grade/evaluate, POST /api/v1/inventory/refurbish/grade/evaluations/{evaluationId}/status, GET /api/v1/inventory/refurbish/grade/evaluations
What It Does: Inspects and categorizes customer return units by condition (packaging damaged, cosmetic imperfection, defective component), determining salvage value across Amazon Warehouse Deals, repackaging, or B2B salvage auctions.

Panel 7DQ: Amazon Vine Review Sentiment & Early Defect Alert Sensor (/api/v1/brandprotection/vinedefect/sensor | Module 196 | Table #205)

API Endpoints: POST /api/v1/brandprotection/vinedefect/sensor/evaluate, POST /api/v1/brandprotection/vinedefect/sensor/evaluations/{sensorId}/status, GET /api/v1/brandprotection/vinedefect/sensor/evaluations
What It Does: Analyzes the initial 30-unit Vine review cohort for recurring product defect patterns and negative sentiment, calculating defect severity ratios to issue supplier stop-ship holds before full inventory rollout.

Panel 7DR: Global Harmonized System (GHS) SDS & Chemical Hazard Sentry (/api/v1/compliance/sds/hazard | Module 197 | Table #206)

API Endpoints: POST /api/v1/compliance/sds/hazard/audit, POST /api/v1/compliance/sds/hazard/audits/{auditId}/status, GET /api/v1/compliance/sds/hazard/audits
What It Does: Audits 16-section Safety Data Sheets (SDS) for topical and chemical formulations against OSHA and Amazon Dangerous Goods regulations, verifying flash points and hazardous material storage classifications.

Panel 7DS: FBA Inbound 2D Carton Contents Barcode Automation Studio (/api/v1/logistics/barcode2d/carton | Module 198 | Table #207)

API Endpoints: POST /api/v1/logistics/barcode2d/carton/generate, POST /api/v1/logistics/barcode2d/carton/cartons/{cartonId}/status, GET /api/v1/logistics/barcode2d/carton/cartons
What It Does: Generates compliant 2D carton contents barcode payloads for FBA inbound shipments, bypassing Amazon manual processing placement fees ($0.15-$0.30/unit) and accelerating FC receiving.

Panel 7DT: Carrier Annual GRI (General Rate Increase) & Peak Surcharge Forecaster (/api/v1/logistics/gri/rate | Module 199 | Table #208)

API Endpoints: POST /api/v1/logistics/gri/rate/forecast, POST /api/v1/logistics/gri/rate/forecasts/{forecastId}/status, GET /api/v1/logistics/gri/rate/forecasts
What It Does: Forecasts the margin impact of carrier annual rate increases (5.9% standard GRI) and Q4 holiday residential delivery surcharges, computing unit margin erosion and automated repricing adjustments.

Panel 7DU: Master Autonomous Supply Chain Executive Cockpit & Clearinghouse (/api/v1/orchestration/master/cockpit | Module 200 | Table #209)

API Endpoints: POST /api/v1/orchestration/master/cockpit/evaluate, POST /api/v1/orchestration/master/cockpit/evaluations/{evaluationId}/status, GET /api/v1/orchestration/master/cockpit/evaluations
What It Does: The landmark 200-Module clearinghouse aggregating system-wide health scores, total financial capital at risk, cross-module critical alerts, and real-time autonomous remediation actions.

Panel 7DV: Amazon SP-API & ShipBob 3PL Autonomous Simulation Studio & Webhook Console (Modules 201 & 202)

API Endpoints:
GET /api/v1/integrations/shipbob/status - ShipBob diagnostic health and webhook URL verification.
POST /api/v1/integrations/shipbob/webhook - Live native ShipBob receiver with HMAC-SHA256 Base64 verification.
POST /api/v1/integrations/shipbob/simulate - Local simulation testbed for receiving_completed and order_shipped events.
GET /api/v1/integrations/amazon/synthetic/types - Lists supported Amazon report schemas (Settlement V2, Ads Search Terms, Inventory Ledger).
POST /api/v1/integrations/amazon/synthetic/generate - Generates synthetic flat-file text with parsed summary metrics.
POST /api/v1/integrations/amazon/synthetic/download - Downloads raw .tsv or .csv files as browser attachments.
POST /api/v1/integrations/amazon/synthetic/generate-and-ingest - Generates and executes database reconciliation against sku_settlement_ledgers, ppc_decision_logs, and active_skus.
What It Does: Native offline rehearsal and simulation cockpit allowing operators to test full-chain 3PL dock receiving, FBA transfer dispatches, bi-weekly settlement reconciliation, and PPC keyword harvesting with one click without waiting for external API approvals.
CLI Tools:
scripts/simulate_shipbob_webhook.py - Simulates authentic ShipBob webhooks with HMAC-SHA256 generation.
scripts/generate_amazon_synthetic_reports.py - Generates and ingests Amazon flat files offline.
scripts/local_smoke_test.py - Runs 25/25 automated platform-wide smoke checks.
Briefing Document: docs/SHIPBOB_INTEGRATION_BRIEFING.pdf (1-page executive technical summary for Yogesh call).

To ensure zero credentials leak into Git while working seamlessly across local laptops, Docker, and cloud production, all external secrets are managed through external environment variables:

Where Secrets Live:
Local Development / Standalone JAR: Stored in the untracked .env file in the project root (C:\Users\Sam\Documents\shopping\.env), automatically imported by Spring Boot via spring.config.import=optional:file:.env[.properties]. A safe template is committed at .env.example.
Docker Compose: Loaded automatically from .env via env_file: - path: .env in docker-compose.yml.
Cloud Linux VM (AWS Lightsail / EC2 Ubuntu): Stored in /etc/fba-automator/fba-automator.env (chmod 600) and injected into the JVM by systemd (EnvironmentFile=-/etc/fba-automator/fba-automator.env).
Cloud Container PaaS (Render / Railway / Fly.io / ECS): Stored in the hosting provider's encrypted Environment Variables / Secrets Manager dashboard and injected as OS environment variables at container launch.
External Service Integration Status:
Discord Symmetrical Webhook Matrix (DISCORD_BOT_TOKEN, DISCORD_GUILD_ID, DISCORD_SANDBOX_*, DISCORD_LIVE_*): ✅ 100% Configured & Active in .env (Sammoho Operations Server 1565640203656503326 with all 3 Sandbox and 3 Live channels wired).
Multi-User RBAC & HMAC Security (ENFORCE_RBAC, WEBHOOK_HMAC_SECRET, TOKEN_VAULT_MASTER_KEY, Role Keys): ✅ Wired in application.properties & application-prod.properties.
Amazon SP-API & Ads API (SP_API_LWA_CLIENT_ID, SP_API_LWA_CLIENT_SECRET, SP_API_REFRESH_TOKEN): ⏳ Pending Seller Central Developer Signup (Operates in $0 Offline Sandbox Mock Mode + Flat-File V2 TSV Importer until populated).
Keepa Data API (KEEPA_API_KEY): ⏳ Pending Keepa API Key (Operates via Bulk CSV Importer in Panel 7CJ until populated).
ShipBob 3PL WMS (SHIPBOB_BASE_URL, SHIPBOB_API_TOKEN, SHIPBOB_CHANNEL_ID, SHIPBOB_WEBHOOK_SECRET): ⏳ Pending ShipBob Developer Sandbox (https://sandbox-hub.shipbob.com) Signup (Operates via SandboxThreePlWmsClient & /api/v1/integrations/3pl/* webhooks until populated).

Operator Manual & Real-World Playbook