Custody Chains¶
A chain is the life of one item under custody — from intake, through each holder, to release back to its owner.
Screenshot: Custody chains dashboard — TODO
Open Custody (/app/custody). The dashboard lists every chain with its current state,
holder, the date it entered that state, and whether it's open or closed. Filter and paginate to
find one.
Chain detail¶
Open a chain (/app/custody/chain/{id}) to see the full event timeline and the allowed
hand-off targets from the current state. Depending on configuration, a hand-off may require a
supervisor cosign. Typical actions: assign to the next holder, send to the hub, or return to the
owner.
Audit¶
- Audit inspector (
/app/custody/chain/{id}/audit) — the forensic view: every event field, item metadata, incidents, and owner/external-reference descriptors. - Audit PDF (
/app/custody/chain/{id}/audit.pdf) — download a signed audit trail for archival or to satisfy an inspector.
Items usually arrive automatically
Chains are typically created when another part of the system takes intake of an item (for example, employee originals intake). You then manage the hand-offs from here.