Dashboard
2 Order(s) Past Due
BP-28805, BP-28806
11
Active Orders
Click to view →
8
In Production
Click to view →
2
Overdue
Click to view →
2
Low Stock
Click to view →
3.8%
Avg Waste
Click to view →
Orders by Source
Pipeline Status
All Orders (12)
Search matches order ID, campaign fields, customer/recipient names, and available address metadata.
| Order | Source | Customer | Qty | Product | Status | SLA Due | Next Action | Actions |
|---|
✅
All Caught Up!
No orders require action at this station today.
📥 Pull More Work
Upcoming orders at this station (not yet due today)
2
Low Stock Items
20
Total Materials Tracked
3.8%
Avg Waste Rate
2
Pending Reorders
Bill of Materials Configuration
Define material usage per piece for each product type. These values are used to calculate expected consumption and identify waste.
| Material | Postcard | Printed Letter | Hybrid | Fully Written | Unit |
|---|---|---|---|---|---|
| Envelope | per piece | ||||
| Postage | |||||
| Forever Stamp | per piece | ||||
| Presort Stamp | per piece | ||||
| Printed Postage (Indicia) |
per piece | ||||
| Paper Stock | |||||
| Letter Paper (8.5x11) |
sheets per piece | ||||
| Insert Stock | sheets per piece | ||||
| Postcard Stock | per piece | ||||
| Ink & Toner | |||||
| Black Toner | % of cartridge | ||||
| Color Toner | % of cartridge | ||||
| Pens (Robot Writing) | |||||
| Blue Pen | % of cartridge | ||||
| Black Pen | % of cartridge | ||||
Unit Conversion Reference
Use these guidelines to calculate your usage percentages:
📝 Pen Cartridges
If 1 cartridge writes ~500 envelopes:
1 piece = 0.2% of cartridge
(100 ÷ 500 = 0.2)
🖨️ Toner Cartridges
If 1 cartridge prints ~5,000 pages:
1 piece = 0.02% of cartridge
(100 ÷ 5000 = 0.02)
📄 Paper (Ream = 500 sheets)
If tracking by case (10 reams):
1 sheet = 0.0002 cases
(1 ÷ 5000 = 0.0002)
Expected Usage Calculator
Based on current BOM settings and recent production:
LAST 7 DAYS PRODUCTION
Postcards:
52,000
Printed Letters:
8,800
Hybrid:
12,500
Fully Written:
4,200
EXPECTED MATERIAL USAGE
Waste Analysis
Comparing expected usage (based on orders shipped) vs actual consumption to identify waste, misprints, and potential theft.
4.5%
Highest: Floral Envelopes
0.8%
Lowest: Presort Stamps
12.5%
Flag: Blue Ink Pens ⚠️
| Material | Scheduled | Ordered | Expected Use | Actual Use | Variance | Status |
|---|
Expected Time Per Piece (seconds)
Configure expected processing time per piece for each station and product type. Used to calculate efficiency variance.
| Station | Postcard | Printed Letter | Hybrid | Fully Written | Unit |
|---|---|---|---|---|---|
| 📥 Incoming | sec/piece | ||||
| 📋 Prep | sec/piece | ||||
| 🖨️ Printing | sec/piece | ||||
| ✍️ Writing | sec/piece | ||||
| 📨 Inserting | sec/piece | ||||
| 📦 Shipping | sec/piece |
Capacity Reference: At 14 sec/piece = 257/hr (hybrid writing). At 24 sec/piece = 150/hr (fully written). At 1.4 sec/piece = 2,571/hr (postcard printing).
Station Performance Log
| Date | Order | Station | Product | Pieces | Expected | Actual | Variance | Operator |
|---|
Loading QA data...
Active Integrations
Order sources feeding into the production dashboard.
PropStream
via Ballpoint API • 2-day SLA
Connected
1,247 orders MTD
SoldFast
via Ballpoint API • 2-day SLA
Connected
892 orders MTD
Shopify
via Shopify API • 7-day SLA
Connected
156 orders MTD
Manual Upload
CSV import • 5-day SLA
Always Available
43 orders MTD
Webhook Endpoints
Incoming order webhooks from integration partners.
POST
/webhooks/propstream
Last: 3 min ago
Today: 47 events
Errors: 0
POST
/webhooks/soldfast
Last: 12 min ago
Today: 31 events
Errors: 0
POST
/webhooks/shopify
Last: 2 hr ago
Today: 8 events
Errors: 0
Outbound Webhooks (Status Updates)
OUT
order.status_changed
Sent: 156 today
Failed: 2
Retry queue: 0
Recent API Activity
| Time | Source | Event | Order ID | Details | Status |
|---|---|---|---|---|---|
| 2 min ago | PropStream | order.created | BP-28813 | 1,250 pieces • Hybrid Letter | Success |
| 8 min ago | SoldFast | order.created | BP-28812 | 500 pieces • Written Letter | Success |
| 15 min ago | PropStream | order.created | BP-28811 | 2,100 pieces • Postcard | Success |
| 1 hr ago | Shopify | order.created | BP-28810 | 100 pieces • Hybrid Letter | Success |
| 2 hr ago | Manual | order.created | BP-28809 | 750 pieces • Written Letter | Success |
Lock a batch to produce the AccuZIP master, upload the returned files, review what did not come back, render the print file and start production.
Print production
Choose orders
Letters, digits, dot, dash and underscore.
AccuZIP return
Both files are checked together against the locked batch. If anything fails, nothing is saved.
Other products
Group compatible orders for single Accuzip runs. Advancing a batch updates each order's status via the API individually — PropStream and partners see normal per-order updates.
💡 This grouping is dashboard-only and does not apply to 4×6, 6×9 or Hybrid print-engine orders. The API receives individual
PATCH /orders/{id}/status calls per order.💡 Batching is dashboard-only. The API receives individual
PATCH /orders/{id}/status calls per order. Partners are unaware of batching.Active Batches
Completed
Polling every 30s
System Status
API Health
—
Waiting for health check...
Queue Depth
—
Server + dashboard retry queues
Last Processed Event
—
From ingest/webhook metrics
Webhook Receiver
—
No webhook diagnostics yet
Last Correlation ID
—
Shown on API errors
No API errors captured in this session.
—
Loading...
Database
—
Loading...
Ingest Queue
—
Loading...
Order Queue
—
Loading...
Workers
—
Active Alerts
—Waiting for first health check...
Metrics
Requests
Total—
4xx Errors—
5xx Errors—
Ingest Pipeline
Jobs Created—
Completed—
Failed—
Dead Letter—
Events Processed—
Webhooks
Sent—
Delivered—
Failed—
Retries—
Database Pool
Pool Size
—
Free
—
Utilization
—
Endpoint Performance
| Endpoint | Requests | p50 | p95 | p99 | Latency |
|---|---|---|---|---|---|
| Waiting for metrics data... | |||||
Circuit Breakers
Loading circuit breaker states...
Manage who can access the dashboard, what they see, and which stations they're assigned to.
| Person | Role | Stations | Modules | Status | Actions |
|---|
Robot fleet availability summary.
Total Robots
—
Functional
—
Maintenance
—
Per-shift production targets by station. Used for pacing calculations and SLA compliance.
Authentication Method
📧
Active
Email OTP (One-Time Password)
All users receive a 6-digit code via email. No passwords to manage or forget.
🔐
Required for Management
TOTP Two-Factor Authentication
Required for all Management role users. Google Authenticator, Authy, 1Password, etc.
Security Settings
OTP Code Expiry
How long email codes remain valid
10 minutes
Session Duration
Auto-logout after inactivity
8 hours
Max OTP Attempts
Lock account after failed attempts
5 attempts
Allowed Domain
Only these email domains can sign in
@ballpointmarketing.com
Offline Queue Safety
Management-only emergency action. Clears queued offline order payloads for the currently signed-in user profile.
⚠ This permanently deletes unsynced queued order data and cannot be undone.
Backend Implementation Notes
When deployed at
1.
2.
3.
4. Session stored as HttpOnly, Secure, SameSite=Strict cookie with 8h expiry. Dashboard currently uses sessionStorage as interim; migrate to cookie-based auth when backend is deployed.
5. TOTP enrollment: Management users set up authenticator on first login via QR code from
⚠ Server-side authorization (required for production):
6. Session tokens must encode
7. All API endpoints must enforce role-based access: employees may only read/write orders at their assigned station(s); management-only endpoints (
8.
9.
10.
11. Before go-live, complete and archive a targeted authorization middleware audit for all dashboard-consumed endpoints (see
dashboard.ballpointmarketing.com, the auth flow will be:1.
POST /auth/send-code — sends OTP to the user's email via SES/SendGrid2.
POST /auth/verify-code — validates OTP, returns short-lived session token. If user is management role, returns requires_totp: true3.
POST /auth/verify-totp — validates authenticator code, upgrades session to full access4. Session stored as HttpOnly, Secure, SameSite=Strict cookie with 8h expiry. Dashboard currently uses sessionStorage as interim; migrate to cookie-based auth when backend is deployed.
5. TOTP enrollment: Management users set up authenticator on first login via QR code from
POST /auth/enroll-totp⚠ Server-side authorization (required for production):
6. Session tokens must encode
role, allowed_stations, and allowed_modules as JWT claims (or store server-side and validate per request)7. All API endpoints must enforce role-based access: employees may only read/write orders at their assigned station(s); management-only endpoints (
/batches, /reports, /staff, /sla) must return 403 for employee tokens8.
GET /orders must filter by employee's station scope server-side — never trust client-side filtering alone9.
PATCH /orders/:id/status must verify the operator has permission for that station before accepting the transition10.
GET /orders?q=... (server search) must also enforce station-scoped results for employee sessions11. Before go-live, complete and archive a targeted authorization middleware audit for all dashboard-consumed endpoints (see
deploy/developer-integration-checklist.md)
Service Level Agreements by Source
Define turnaround times for each order source. Integration orders have faster SLAs.
Source
Type
Standard
Rush
PropStream
Integration
days
days
Deal Machine
Integration
days
days
SoldFast
Integration
days
days
Shopify
Online Store
days
days
Manual
Manual
days
days
* All times in business days
Processing Time by Product Type
Hours required per stage. Variable stages scale with order quantity.
Product
Prep
Print/Write
Insert
Total Est.
Postcard
2h fixed
3h/1k
1.5h/1k
~6h
Printed Letter
2h fixed
4h/1k
2h/1k
~9h
Hybrid
3h fixed
2h + 6h/1k
2h/1k
~15h
Fully Written
2h fixed
10h/1k
1.5h/1k
~16h
* Times are estimates for 1,000 piece orders. Larger orders scale proportionally.
Station Capacities
Maximum throughput per hour for scheduling calculations.
pcs/hr
Print Station
pcs/hr
Writing Robots
pcs/hr
Inserting Line
pcs/hr
Shipping Prep
Daily Production Summary
to
| Date | Pieces In | Pieces Out | Active Orders | In Production | Completed | Overdue | Low Stock Items |
|---|
Account KPI Summary
to
| Date | Account | Created | Paid | Completed | Delivered | Cancelled | Failed |
|---|
Staff Performance vs Station Capacity
| Operator | Station | Orders Processed | Pieces Handled | Avg Time/Order | vs Expected | Efficiency |
|---|
Missed Due Today Tasks
| Order | Customer | Station | Should Have Completed | Actual Status | Hours Behind | Impact |
|---|