Beef COOL package preview
Livestock Ledger Exchange
A buyer-safe, audit-ready exchange surface for beef origin evidence: animal identity, lot movement, processor packet, retail COOL support, QR proof, and recall readiness without exposing private herd records.
Exchange map
One package, six evidence lanes.
The design separates what a farm records, what a processor needs, what retail can review, and what a buyer can safely see from a QR page.
Animal and herd identity
MIUSA UUID, QR token, farm/ranch profile, optional official ID reference, and active head-count quantity logic.
Origin and movement chain
Birth/place-of-raising, movement events, custody changes, processor handoff, lot split/merge, and supporting documents.
COOL retail review packet
Country-of-origin support packet, label review notes, package manifest, evidence links, and exception flags.
Processor and lot ledger
Processor event, slaughter/harvest lot, package lot, cut list, pack date, ship date, buyer/retail batch reference.
Buyer-safe QR proof
Public QR page shows approved origin/proof summary while private records, prices, invoices, and audit files remain protected.
Recall readiness
Suspect/probable/confirmed status, movement hold, product hold, traceback notes, and private official-report workflow.
Interactive preview
Ledger lane detail
Click a lane to see the preview record language and operational boundary.
Beef COOL Package Manifest
The package manifest should define package lots, origin evidence, product label claims, processing references, required attachments, and the customer-safe public proof fields.
APAR-360 design intake
External BEEF COOL build review lane
Adam provided a VCloud package share for review. The package is received and hashed, but it is a limited APAR-362 traceability draft package rather than the complete APAR-360 static design bundle or a deployable APAR-361 Frappe app.
| External build claim | Current review state on a02 |
|---|---|
| Static `index.html` and local assets present | Not in received package |
| WO and checkout files created | Not in received package |
| Source manifest hash captured | Manifest not in received package |
| 9 ERPNext DocType model table | Not deployable from received package |
| Blockchain / QR verification lane | Draft events received; approval required before any claim |
Field preview
Core Beef COOL packet fields
These fields are a preview target for the manifest build. The exact manifest should confirm naming and required/optional state.
| Group | Fields | Use |
|---|---|---|
| Package | package_id, lot_id, sku, cut_name, pack_date, net_weight, case_count | Connect retail package to processor lot and buyer-safe proof. |
| Origin | farm_id, ranch_name, birth_country, raised_country, harvest_country, product_of_claim | Separate evidence from claim language for COOL/Product of USA review. |
| Custody | animal_uuid, movement_event, processor_id, processing_date, shipment_id | Preserve chain events without exposing private documents publicly. |
| Evidence | manifest_hash, document_set, reviewer_status, exception_flags, receipt_hash | Support audit review and future attestation without claiming a seal before evidence exists. |
| Public QR | qr_token, buyer_safe_status, approved_claim_summary, recall_tier | Show only approved public fields and hide private farm/process/payment records. |
Recall MGT
Screwworm notification and alerting lane
This lane connects Livestock Ledger package events to the existing VRP Cattle Recall Alert workflow. It is a validation and alert-routing design until approved notification recipients and test-send gates are complete.
New World Screwworm readiness
Live ERP recall readiness already supports `New World Screwworm` as a hazard type, with recall tiers `suspect`, `probable`, and `confirmed`. The preview design routes package/animal/lot events into Recall MGT while keeping private evidence protected.
Validation matrix
Compliance boundary requirements
Every requirement must pass before this becomes a live customer workflow.
| Requirement | Validation/Test | Status |
|---|---|---|
| Evidence organization only | Page and API copy must state workflow support, not certification. | Preview Pass |
| No Product of USA or COOL certification claim | Public language must say evidence support and review, not certified/approved. | Preview Pass |
| No USDA/FSIS/APHIS replacement | Boundary text must preserve regulatory and veterinary obligations. | Preview Pass |
| No legal advice | Page must avoid legal conclusions and route final decisions to qualified advisors/regulators. | Preview Pass |
| No ledger/TPM/blockchain attestation claim | Receipts remain draft/evidence-bound until matching evidence and approval exist. | Preview Pass |
| Recall MGT installed | Live API reports `VRP Cattle Recall Alert` available. | Live Readback Pass |
| Screwworm hazard supported | Live API hazard list includes `New World Screwworm`. | Live Readback Pass |
| Notification and alerting | Define recipients, draft copy, test-send account, opt-in/authority boundaries, and approval gate. | Next Build Gate |
| Exact BEEF COOL manifest | Hash and parse `BEEF_COOL_PACKAGE_MANIFEST.md` after intake. | Source Pending |