Fibretrace Monet docs/Knowledge base/Persona map

Persona map

How every persona connects to every other: who provisions whom, who hands data to whom, and who is blocked waiting on whom. Details per persona live in persona-01 through persona-06. Confidence markers per README.md; the arrows below are each backed by the evidence in those files.

FT Admin (platform staff) Owns: programmes, registrations, reservations, product categories, licences, scanners, SDUs, signup approvals, global settings (obfuscation) Program Owner Owns: programme certificates, documents, record wording (mini-CMS); watches uptake Routes: /owner/* Tier 4 Fibre Producer (gin / rPET) Owns: production records, pigment orders, SDU feed, EWR imports; raises Activated Routes: /fibre-creation, /sdu Persona = programme_producers rows Tier 2/3 neutral participant Owns: inbound/outbound scans, session shares; builds chain of custody; never claims Persona = fallback "scanner" Tier 1 Manufacturer Owns: facilities, scans (Scan History), linking, claim proposals + amounts, certificates attach, supplier close Routes: /link-to-po, /verifications, /facilities Persona = incoming shared nominations Tier 0 Retailer / Brand Owns: nominations + lines, reservation requests, claim confirm/reject + bulk approval, claims, evidence packs, public share tokens, supply-chain view Routes: /purchase-orders, /claim-position, /ready-to-claim, /claims, /supply-chain Persona = brand/retailer type + participant rows Auditor (field role, SAT) Performs the physical scans for any company; scan-only, blocked from the dashboard Public verifier (customs, buyer, consumer) Scans the QR on a claim certificate; sees the token-gated public claim page /c/:token registers owner + module, invites producer registration, ceiling, pigment, SDU licences, scanners participant registration, reservations reservation requests, signups certificates, documents, wording -> evidence packs claims + uptake volumes scans raise programme Activated (pool for claims) marked fibre ships downstream shipping scan pairs (waybill) session shares -> supply-chain map nomination shared (partner-gated) claim proposal + certificate + amount confirm / reject with reason performs scans performs scans QR claim certificate (public tokens)

Reading guide

Orange arrows are provisioning: nothing exists until FT Admin creates it, which is why the QC script runs the admin section first and why 7 of its 11 environment objects are admin-gated. Grey arrows are the operating loop, and the money path reads left to right along the bottom half: the producer’s scans fill the programme pool (Activated), the retailer reserves from that pool and nominates a manufacturer, the manufacturer links scans and proposes a claim with the amount only they can know, the retailer confirms and hands the resulting QR certificate to the public verifier. The owner’s contribution is content (certificates, documents, wording) flowing onto everyone’s evidence packs, and uptake data flowing back.

Who blocks whom: the retailer cannot claim without a manufacturer proposal (in the PO flow), the manufacturer cannot propose without a shared nomination AND scannable sessions, the producer cannot produce without registration, pigment and (for SDU flows) devices — and every one of those prerequisites is an FT Admin action. The auditor and the neutral Tier 2/3 participants are the quiet load-bearing actors: their scans and waybill pairs are what the supply-chain map and chain of custody are made of, though they never touch a claim.

Two personas the QC script does not test but the code enforces: the auditor (scan-only role, force-signed-out of the dashboard) and the public verifier (token-gated pages, revoked banners). Details in persona-06-additional-roles.md.