Add internal pain-authenticity tags to TallyFlow use cases

TallyFlow/TallyFlow Use Cases.md

@@ -4,6 +4,21 @@
 
 This document describes practical use cases where TallyFlow is a strong fit. Each use case uses common industry language so operations, warehouse, quality, and supply chain teams can map TallyFlow to how they already work.
 
+---
+
+## Internal: Pain Authenticity Tags
+
+> **Internal only — not for customer-facing copies.** These tags judge whether the *problem statement* is a real operations pain versus manufactured marketing. They do **not** rate product completeness by themselves.
+
+| Tag | Meaning |
+|-----|---------|
+| **Real** | Genuine, named ops problem with clear time, money, risk, or compliance cost. Buyers already use this language. |
+| **Real-but-packaged** | Underlying pain is real, but the use case is framed as a distinct product category more cleanly than many buyers spontaneously name it—or it is niche / derivative of a stronger adjacent pain. |
+| **Watch-overclaim** | The pain is real; the risk is overstating how completely TallyFlow covers the full industry outcome (regulation, ERP depth, sensors, QMS, etc.). Sell the slice you actually deliver. |
+
+**Sales rule:** Lead with **Real**. Use **Real-but-packaged** as supporting outcomes. For **Watch-overclaim**, name the concrete TallyFlow slice (labels, photos, zone history, dock reads) and do not promise the whole regulated or enterprise system of record.
+
+
 ---
 
 ## Platform at a Glance
@@ -26,6 +41,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 1. Receiving & Inbound Verification
 
+**Pain authenticity (internal):** `Real` — Shortages, overages, wrong SKUs, chargebacks, and ERP cleanup are concrete dock pains—not invented.
+
 **Also called:** inbound receiving, ASN verification, dock receiving, goods receipt
 
 **Problem:** Teams do not know what actually arrived versus what was expected. Shortages, overages, and wrong SKUs create rework, chargebacks, and ERP cleanup.
@@ -42,6 +59,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 2. Shipping & Outbound Verification
 
+**Pain authenticity (internal):** `Real` — Wrong/incomplete ship and lack of load proof drive claims and customer disputes every day.
+
 **Also called:** shipping verification, outbound check, load verification, pre-ship scan
 
 **Problem:** Wrong items leave the building, incomplete orders ship, and there is no proof of what was loaded.
@@ -57,6 +76,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 3. Cycle Counting
 
+**Pain authenticity (internal):** `Real` — Full physicals are disruptive; location drift between counts is a standing warehouse/MRO cost.
+
 **Also called:** cycle count, perpetual inventory count, rolling inventory
 
 **Problem:** Full physical inventories are disruptive and expensive. Location accuracy drifts between counts.
@@ -73,6 +94,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 4. Physical Inventory & Stock Audits
 
+**Pain authenticity (internal):** `Real` — Finance and auditors need a defensible on-hand picture; this is a scheduled, budgeted pain.
+
 **Also called:** wall-to-wall inventory, annual inventory, stocktake, inventory audit
 
 **Problem:** Auditors and finance need a defensible count of what is on hand and where it is.
@@ -89,6 +112,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 5. Zone-Based Asset Tracking
 
+**Pain authenticity (internal):** `Real` — Lost WIP/tools and invisible bottlenecks are standard manufacturing and repair-shop problems.
+
 **Also called:** location tracking, WIP tracking, yard/floor tracking, process-stage tracking
 
 **Problem:** High-value tools, components, and work-in-process disappear into the facility. Teams waste time searching and cannot see bottlenecks.
@@ -105,6 +130,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 6. Exception Management
 
+**Pain authenticity (internal):** `Real-but-packaged` — Exceptions are real, but buyers usually buy this inside receive/ship/zone—not as a standalone category.
+
 **Also called:** shortage/overage handling, variance management, exception reporting
 
 **Problem:** Exceptions are found too late, buried in spreadsheets, or never tied back to a specific shipment or asset.
@@ -121,6 +148,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 7. Seek & Find (Asset Locate)
 
+**Pain authenticity (internal):** `Real` — Time hunting tools and tagged equipment is a visceral, easy-to-prove floor cost.
+
 **Also called:** asset locate, find-my-asset, tool find, Geiger-style RFID locate
 
 **Problem:** Time and money are lost looking for tools, tagged equipment, or specific cases on a busy floor.
@@ -136,6 +165,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 8. Asset Enrollment & Tag Commissioning
 
+**Pain authenticity (internal):** `Real` — Inconsistent tag-to-asset setup is a common reason RFID programs fail before fancy reads matter.
+
 **Also called:** asset onboarding, tag association, item registration, master data setup
 
 **Problem:** Tags exist without a system of record, or assets are entered inconsistently so later tracking fails.
@@ -152,6 +183,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 9. Label Printing, Encoding & Scan-and-Print
 
+**Pain authenticity (internal):** `Real` — Wrong serials, print disconnected from inventory, and damaged-tag reprint are daily floor friction.
+
 **Also called:** RFID encoding, case labeling, GS1 labeling, SSCC labeling, field re-label, scan-and-print, on-demand reprint
 
 **Problem:** Labels are inconsistent, serials are wrong, printing is disconnected from the inventory system, or operators must leave the floor app to reprint a damaged or missing tag.
@@ -175,6 +208,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 10. Freight Claims Documentation
 
+**Pain authenticity (internal):** `Real` — Shippers lose money without proof of condition/quantity at ship time; photo evidence is a known fix.
+
 **Also called:** pre-shipment photography, damage claims support, proof of condition
 
 **Problem:** When freight is damaged or short, the shipper cannot prove what left the dock in good condition and complete quantity.
@@ -191,6 +226,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 11. Quality Control (Incoming, In-Process, Outgoing)
 
+**Pain authenticity (internal):** `Real` — Searchable visual history is a real gap for many mid-market plants. Do not stretch into full QMS/CAPA.
+
 **Also called:** IQC, IPQC, OQC, inspection documentation, visual QC
 
 **Problem:** Defects and damage are hard to prove, trends are invisible, and paper inspection records are slow to retrieve.
@@ -207,6 +244,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 12. Repair & MRO Process Documentation
 
+**Pain authenticity (internal):** `Real` — High-value rebuild shops need customer-facing proof and multi-step history; photos + zones match the work.
+
 **Also called:** work-order documentation, repair history, teardown photos, service records
 
 **Problem:** Repair shops need to show customers what was done and retain a visual history of high-value equipment over time.
@@ -223,6 +262,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 13. Food Traceability & FSMA 204 Compliance
 
+**Pain authenticity (internal):** `Watch-overclaim` — Regulatory/customer pressure is real. Full FSMA 204 compliance is broader than labels + movement history—sell the TallyFlow slice only.
+
 **Also called:** produce traceability, CTEs/KDEs capture, farm-to-ship tracking, food safety audit support
 
 **Problem:** Manual or paper tracking will not meet modern food traceability expectations or FSMA 204-style audit needs.
@@ -239,6 +280,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 14. Compliance Audits & Audit Trails
 
+**Pain authenticity (internal):** `Real-but-packaged` — Strong under real scrutiny; softer as a generic pitch to unregulated sites that are not being asked these questions yet.
+
 **Also called:** regulatory audit support, chain-of-custody reporting, operational audit trail
 
 **Problem:** When auditors ask “where was this, when, and who touched it?”, answers live in email, paper, and tribal knowledge.
@@ -255,6 +298,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 15. Field Document Capture
 
+**Pain authenticity (internal):** `Real` — BOLs and receipts lost in email/text/mail delay accounting and service; boring and very common.
+
 **Also called:** digital BOL capture, paperwork digitization, proof-of-delivery imaging
 
 **Problem:** Bills of lading, receipts, and signed deliveries are mailed, texted, or lost—delaying accounting and customer service.
@@ -271,6 +316,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 16. Field Installation & Service Tracking
 
+**Pain authenticity (internal):** `Real-but-packaged` — Real in niches (irrigation, distributed equipment); not a universal pain across all TallyFlow prospects.
+
 **Also called:** installed base tracking, as-built documentation, service locate
 
 **Problem:** Equipment installed in the field is hard to find later, especially when buried or spread across sites.
@@ -288,6 +335,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 17. Automated Dock-Door & Tunnel Reads
 
+**Pain authenticity (internal):** `Real` — Manual scan cannot keep up with conveyor or high-volume doors; this is why portals/tunnels exist.
+
 **Also called:** RFID portal reading, tunnel scanning, hands-free dock capture
 
 **Problem:** Manual scanning cannot keep up with conveyor or high-volume outbound/inbound flow.
@@ -304,6 +353,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 18. ERP & System Integration
 
+**Pain authenticity (internal):** `Watch-overclaim` — The handoff gap is real and kills projects. “We integrate” is only as strong as proven patterns per customer ERP/WMS.
+
 **Also called:** ERP handoff, WMS/ERP receive update, system of record sync
 
 **Problem:** RFID and mobile capture data never reliably lands in the systems people trust (ERP, WMS, BI).
@@ -320,6 +371,8 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ### 19. Condition & Environmental Monitoring (IoT)
 
+**Pain authenticity (internal):** `Watch-overclaim` — Cold-chain and handling damage are real. Lead only where sensor-linked deployments are actual and repeatable.
+
 **Also called:** cold-chain monitoring, shock/temperature tracking, sensor-linked assets
 
 **Problem:** Location alone is not enough when temperature, humidity, or handling damage matter.
@@ -335,30 +388,41 @@ Together they cover the full path from **print a tag → scan or read it → doc
 
 ## Use Case Matrix (Quick Reference)
 
-| Use case | Primary TallyFlow components | Typical industries |
-|----------|------------------------------|--------------------|
-| Receiving & inbound verification | IoT, Assets, Core | Distribution, retail, manufacturing |
-| Shipping & outbound verification | IoT, Capture, Assets, Core | Manufacturing, 3PL, produce |
-| Cycle counting | Assets, Core | Warehouse, MRO, food distribution |
-| Physical inventory & stock audits | Assets, Capture, Core | Any inventory-heavy operation |
-| Zone-based asset tracking | Assets, IoT, Core | Repair, manufacturing WIP |
-| Exception management | Core, IoT, Assets | High-volume ops, compliance |
-| Seek & find | Assets | Tools, equipment, large facilities |
-| Enrollment & commissioning | Print, Assets, Core | New programs, fleet tagging |
-| Label printing, encoding & scan-and-print | Print, Assets, Core | Produce, retail cases, assets, field re-label |
-| Freight claims documentation | Capture | Manufacturing, shipping |
-| Quality control (IQC/IPQC/OQC) | Capture, Core | Manufacturing, suppliers |
-| Repair & MRO documentation | Capture, Assets, Core | Component repair, industrial MRO |
-| FSMA 204 / food traceability | Print, Assets, Core, IoT | Produce, food distribution |
-| Compliance audits | Core, Capture | Regulated and audited ops |
-| Field document capture | Capture | Multi-site sales and logistics |
-| Field installation tracking | Capture | Field equipment, controls |
-| Dock-door & tunnel automation | IoT, Core | High-volume DCs |
-| ERP / BI integration | Core, IoT | ERP-centric enterprises |
-| Condition monitoring | IoT, Core | Cold chain, sensitive goods |
+| Use case | Pain authenticity (internal) | Primary TallyFlow components | Typical industries |
+|----------|------------------------------|------------------------------|--------------------|
+| Receiving & inbound verification | **Real** | IoT, Assets, Core | Distribution, retail, manufacturing |
+| Shipping & outbound verification | **Real** | IoT, Capture, Assets, Core | Manufacturing, 3PL, produce |
+| Cycle counting | **Real** | Assets, Core | Warehouse, MRO, food distribution |
+| Physical inventory & stock audits | **Real** | Assets, Capture, Core | Any inventory-heavy operation |
+| Zone-based asset tracking | **Real** | Assets, IoT, Core | Repair, manufacturing WIP |
+| Exception management | **Real-but-packaged** | Core, IoT, Assets | High-volume ops, compliance |
+| Seek & find | **Real** | Assets | Tools, equipment, large facilities |
+| Enrollment & commissioning | **Real** | Print, Assets, Core | New programs, fleet tagging |
+| Label printing, encoding & scan-and-print | **Real** | Print, Assets, Core | Produce, retail cases, assets, field re-label |
+| Freight claims documentation | **Real** | Capture | Manufacturing, shipping |
+| Quality control (IQC/IPQC/OQC) | **Real** | Capture, Core | Manufacturing, suppliers |
+| Repair & MRO documentation | **Real** | Capture, Assets, Core | Component repair, industrial MRO |
+| FSMA 204 / food traceability | **Watch-overclaim** | Print, Assets, Core, IoT | Produce, food distribution |
+| Compliance audits | **Real-but-packaged** | Core, Capture | Regulated and audited ops |
+| Field document capture | **Real** | Capture | Multi-site sales and logistics |
+| Field installation tracking | **Real-but-packaged** | Capture | Field equipment, controls |
+| Dock-door & tunnel automation | **Real** | IoT, Core | High-volume DCs |
+| ERP / BI integration | **Watch-overclaim** | Core, IoT | ERP-centric enterprises |
+| Condition monitoring | **Watch-overclaim** | IoT, Core | Cold chain, sensitive goods |
 
 ---
 
+
+### Pain authenticity rollup (internal)
+
+| Tag | Count | Use cases |
+|-----|-------|-----------|
+| **Real** | 13 | Receiving; shipping; cycle count; physical inventory; zone tracking; seek & find; enrollment; label/scan-and-print; freight claims; QC photos; repair/MRO docs; field document capture; dock/tunnel automation |
+| **Real-but-packaged** | 3 | Exception management; compliance audit trails; field installation tracking |
+| **Watch-overclaim** | 3 | FSMA 204 / food traceability; ERP & system integration; condition & environmental monitoring |
+
+**One-pager note:** The Capabilities one-pager compresses these same pains into outcome lines. It does not introduce separate manufactured pains. Prefer leading the one-pager with **Real** outcomes; keep FSMA, ERP, and condition language tied to the concrete slice delivered.
+
 ## How Customers Typically Start
 
 Most successful deployments begin with **one high-pain workflow**, then expand: