Deliverable 4 of 5

Revision Workflow — Versioning, Preservation & Re-signature

What happens when a rental agreement needs to change. Covers unsigned-but-sent, signed-and-active, and expired-within-7-days cases.
Core principle from the 3/30 meeting: the original agreement is preserved alongside every revision. Marsha: "I would think we'd need to save the both documents, especially because you have that expiration date set on — if they don't approve it with the original one is still the valid one. So in the naming, if they're, you know, named somehow as REV or V1, V2." (Transcript 35:39–36:06)

Standard revision-reason dropdown (derived from Nicole's real-world scenarios)

MNR (Mind Not Right) Customer changes their mind after sign-up
Instrument swap Cornet/trumpet, trombone mix-ups
New vs. used Parent insists on new, different purchase price
Price change Honoring missed promo, inventory swap
Date change Backorder delivery, real first-payment date
Typo fix Kid's name, email, address spelling
Taking over rental Another parent/guardian takes over
Other (reason required) Free text, captured for reporting
CSR opens existing agreement in Mega Tool — clicks "Revise" What is the agreement's current state? (determines which path) Unsigned, link active (within 7 days) Signed & active Expired (>7 days, unsigned) Update-in-place OR create V2 (see Q1 below) 1. CSR selects reason from dropdown 2. CSR updates values; math recalculates 3. System flags: "Customer must re-sign?" 4. If yes → invalidate old link, send new 5. If no (typo only) → push updated PDF to same link Q1 — Unsigned + link-active revisions — update in place, or always create V2? 1 Q6 — Typo fixes on unsigned agreements — always create a revision record, or allow silent inline edit? 6 Create revision (V2) Original stays active 1. Reason from dropdown 2. Update values 3. System builds V2 agreement 4. V1 marked "superseded on sig" 5. Send V2 signing link Q2 — Signed + active revisions — independent document or amendment to the original? 2 Fresh agreement (V2) Expired V1 archived 1. CSR regenerates from V1 as starting point 2. Reason is implicit: "expired" 3. Values can be updated (e.g., date shift) 4. New 7-day clock starts 5. Send V2 signing link Persist versioned record in Mega Tool File names: {CustomerLast}_{Student}_{Instrument}_{SchoolYear}_V1.pdf Revision: ..._V2.pdf, ..._V3.pdf. All versions browsable by CSR. Email customer: "Revised agreement — please re-sign" Includes reason for revision (optional), new 7-day expiration Old link deactivated on send Q3 — Does each revision start a fresh 7-day expiration clock? 3 Q4 — Notify customer on every revision, or only on "material" revisions? 4 Customer reviews V2, signs (same signing UX as original flow) V2 becomes active, V1 archived V1 retained for audit trail (legal compliance) AIM reference updated to point to V2 Q5 — Retention policy for superseded versions (V1 after V2 is signed) 5 Version State Diagram V1 (original) Active → Archived Revision created V2 (current) Active after customer sign Further revision? V3 (if needed) Same pattern, supersedes V2 All versions preserved • Browsable to CSR • Audit trail intact • Portal shows latest only (per Deliverable 5) Retention policy: TBD Cross-reference: AIM-side impact When a revision creates new financial terms (new rate, new purchase price, new first payment date), the AIM invoice / delivery ticket must be updated to match. If the revision is purely cosmetic (typo fix), AIM does not need to change. See Deliverable 2 (System Responsibility Matrix) for authority rules.

Open questions on revision handling

These shape the revision UX and the legal/audit posture. None blocks Deliverable 1 v2, but all should be resolved before dev.

1 Unsigned + link-active revisions — update in place, or always create V2?
Context

If a customer has the signing link open and hasn't signed yet, and the CSR needs to change something, we could either: (a) update the V1 record in place and push the new content to the same signing URL, or (b) invalidate V1 and create V2 with a new signing URL.

Why it matters

Update-in-place is simpler for the customer (their link still works), but legally dicey — the content they're looking at can change under them. V2 with new URL is safer (clean audit trail, unambiguous "what was signed") but risks the customer signing the old V1 if they refresh or the new email is slow. Industry best practice for e-signature leans toward V2-with-new-URL.

Transcript 35:30–36:10; Q&F Notes.pdf #7
2 Signed + active revisions — independent document or amendment to the original?
Context

Post-signature revisions (e.g., customer had the MNR realization a week later) can either be (a) a full replacement agreement where V2 supersedes V1, or (b) an amendment document that references V1 and only captures deltas.

Why it matters

Full replacement is simpler to build and to explain to customers, but creates ambiguity in audit trail ("which one is the real agreement?"). Amendment model is legally cleaner but doubles the document-management complexity. Most rental businesses use full-replacement with clear version metadata; we should confirm this is acceptable for Q&F's state-specific compliance needs.

Transcript 35:39–36:10
3 Does each revision start a fresh 7-day expiration clock?
Context

Original agreements expire after 7 days unsigned. If we revise and send V2, does V2 also have 7 days, or does it inherit the remaining time from V1?

Why it matters

Fresh-clock is customer-friendly and simpler to explain. Inheriting remainders (e.g., V1 had 2 days left, so V2 also has 2 days) prevents CSRs from using revisions to endlessly extend the window, which could be a concern if expiration is financially meaningful. Business policy call, not a technical one.

Original flow diagram expiration note; Transcript 35:17–35:28
4 Notify customer on every revision, or only on "material" revisions?
Context

If a CSR fixes a typo in the student's name on a signed agreement, does the customer get an email saying "Your agreement has been revised"? Or does it silently update with an audit log entry?

Why it matters

Always-notify: full transparency, high trust, potentially confusing volume of emails for small fixes. Only-material-notify: cleaner customer experience, but we need to define "material" (price change? date change? name spelling?). A middle path: always log the change in the customer portal, but only email on material changes.

Derived from discussion 36:10–38:00; not explicitly resolved
5 Retention policy for superseded versions (V1 after V2 is signed)
Context

Superseded versions need to be retained for audit/legal purposes, but for how long? Indefinitely? 7 years (standard contract retention)? Until rental ends + 3 years?

Why it matters

Retention affects storage cost (minor) and legal exposure (more material). Without a clear policy, superseded versions will accumulate forever by default, which may not match Q&F's record-keeping standards. Worth getting a policy answer from Marsha / George.

Not discussed on 3/30; flagged for follow-up
6 Typo fixes on unsigned agreements — always create a revision record, or allow silent inline edit?
Context

Linked to Deliverable 1 Q6. Specifically for this deliverable: if we do allow inline edits on unsigned agreements (no V2 created), we still need a decision on whether the edit history is captured as an audit-log entry or just vanishes.

Why it matters

"Silent" edits leave no trace — fastest for CSR, weakest audit posture. Audit-logged edits give us accountability without forcing a V2 document. Always-V2 gives the cleanest record but creates revision noise for trivial spelling fixes.

Q&F Notes.pdf #7; Transcript 38:19–38:43
Source references
Meeting: Q&F Mega Tool Priorities (3/30/26) — tldv recording
Revision scenarios derived from Nicole's real-world examples, Q&F Notes.pdf, and Renting over the phone.pdf.