page:blueprints:wholesale distributors:order tracking:django
Wholesale distributors: Order Tracking Using Django
Summary
A order tracking blueprint for wholesale distributors built with Django on Ample.
Domain Schema:
- products (sku, name, category, case_size, list_price, active): SKU catalog with case sizes
- stock_movements (sku, warehouse, delta, reason, moved_at): receipts, picks and adjustments
- orders (order_no, account_reference, status, placed_at): trade orders with status transitions
- order_lines (order_no, sku, cases, unit_price): order contents
- events (seq, record_type, record_id, kind, at): application-owned history written in the same transaction.
Public Information:
- Catalog with case sizes, minimum order and delivery terms, trade account application.
Kept Out of Scope:
- Account pricing tiers, credit terms, delivery addresses. Account-specific pricing and credit terms are confidential; the catalog shown publicly carries list prices only.
Technical Basis:
- Verified on Django
- An optimistic version check
- An event row written in the same transaction
- A stale update rejected
- A history query over the application-owned events (history=2 conflict=rejected).
Representative Queries
- Wholesale distributors: order tracking using Django
- Where can I host Wholesale distributors: Order tracking built with Django?
- I need a genuinely specialized order tracking workflow covering case-pack units, B2B catalog visibility and volume order imports.
Resource Requirements
- Compute
- Postgres
- S3-compatible object storage
Infrastructure Requirements
Compute
Apps run in isolated x86_64 Firecracker microVMs that auto-pause when idle and wake on request; sizes are the priced VM sizes.Postgres
Managed PostgreSQL 16 runs in its own microVM and is auto-provisioned when an app needs a database and no DATABASE_URL is supplied.S3-compatible Object Storage
Buckets are S3-compatible with issued credentials; PutObject and GetObject are verified by canary. Other S3 operations are not verified.
Workflow Steps
- Model the wholesale distributors domain
- Create the tables products, stock_movements, orders, order_lines, events.
- SKU catalog with case sizes lives in products; keep the sensitive classes (account pricing tiers, credit terms, delivery addresses) out of this schema.
- Model orders with explicit status transitions and order lines
- Apply status changes transactionally and record an event per change
- Expose status history to authorized callers only
- Deploy and verify history and conflict rejection
- Run the synchronous deploy once and read the result. Re-running with no change is a no-op.
- Run the pattern self-test(s) and your own acceptance checks for the wholesale distributors workflow.
Examples
Django Pattern Fixture
- Verified transactional workflows basis for this blueprint.
Success Checks
- App responds on its public URL
- Transactional-workflows self-test from the example
Limitations
- The technical basis (transactional workflows on Django) was verified with the pattern fixture; the wholesale distributors schema and workflow are an original design for this blueprint and were not executed as a separate application.
- No health, financial, privacy, or other compliance claim is made. Account-specific pricing and credit terms are confidential; the catalog shown publicly carries list prices only.
- Public content and synthetic examples only until actual data-handling requirements have been reviewed.
Cost Estimate
- Currency: USD
- Monthly Amount: 10.0
- Basis: size prices from pricing.toml
- Components:
- App server (s-1vcpu-1gb): $5.0
- Managed PostgreSQL database (s-1vcpu-1gb): $5.0
- Note: Always-on monthly price of the tested sizes; apps and databases auto-pause when idle.
Evidence Summary
- Detailed canary run summary including pattern transactional workflows verified. Last verified on 2026-09-20.
Next Actions
- Browse the catalog index
- Search published recipes by intent, stack, and constraints
- Prepare a side-effect-free deployment plan for an authorized project
- Read the existing agent authentication setup
- Browse Wholesale distributors
- Browse Order tracking
- Browse Django
- Browse Deploy web app