Why ownership matters
While a loan sits unassigned, it lives in a shared team queue and notifications fan out to everyone who can work that stage. The moment someone owns it, the platform narrows those notifications to the owner alone. Ownership is how work gets directed and how a loan stops being “anyone’s job” and becomes “this person’s job.”The two ways a loan gets an owner
Claim: take an unassigned loan for yourself
Claim: take an unassigned loan for yourself
A staff member who works a stage can pull an unassigned loan in that stage onto themselves. This is self-service. You need the loans.claim capability, and you must be eligible for the loan’s current stage. Claiming records
loan_application.claimed and sets you as the owner.Claiming is race-safe. If two people try to claim the same loan at the same moment, only one wins. The other is told the loan is already owned.Assign: direct a loan to a specific person
Assign: direct a loan to a specific person
A supervisor can assign or reassign a loan to any eligible person, overwriting any existing owner. The loans.assign capability is the supervisor right that allows this on any loan. The platform validates that the chosen person can actually work the loan’s current stage, so you cannot route a loan to someone who has no way to act on it. Assigning records
loan_application.assigned and notifies the new owner by email.Two scoped assign rights exist alongside loans.assign. A Credit Officer who holds loans.submit can route their own DRAFT to a specific adjudicator (a pre-assignment that carries forward into adjudication). And a stage worker who holds the loan’s current owning capability can reassign within their own stage, for example one Adjudicator handing a file to another Adjudicator.Who holds each capability
The stage workers (Adjudicator, Securities, Disbursement) claim their own work. The supervisors (Credit Manager and Branch Manager) direct work to others. The Administrator holds both loans.claim and loans.assign through workspace management.
Which stages can have an owner
A loan can carry an owner only while it sits in a stage that someone actively works. The eligible owner for each stage is determined by the capability that owns the work there.
Transient and terminal states (
APPROVED, DISBURSED, FILED, DECLINED, CANCELLED, DRAFT_ABANDONED) have no owner. A DRAFT is treated as a pre-assignment: a Credit Officer can route a draft to the adjudicator who will review it once it is submitted, and that owner carries forward into adjudication.
The Assigned to card
The Assigned to card appears on the loan detail page in the adjudication, securities, and disbursement queues, and on the Credit Officer’s own loan detail page at/loans/[appId]. That officer view is where the DRAFT pre-assignment happens, routing a file to the adjudicator who will review it once it is submitted. What you see on the card depends on your capabilities and the loan’s state.
- When a loan is unassigned and you can work the stage, you see a Claim button.
- When you hold loans.assign and at least one eligible person exists for the stage, you see a picker listing every eligible person. On the worker-stage queues it reads Assign to or Reassign to; on the Credit Officer’s DRAFT view it reads Route to an adjudicator or Change adjudicator. When no eligible staff exist and the loan is still unassigned, the card shows “No eligible staff to assign for this stage” instead. That message appears only while the loan is unassigned.
- When a loan is owned, a Release button appears for the current owner or for anyone holding loans.assign.
Filtering the queue by ownership
Each of the three queues (adjudication, securities, disbursement) has the same three assignment tabs, driven by theassign URL parameter.
Use Unassigned to find work that needs picking up, and My queue to focus on what you already own.
Releasing and automatic handoff
A loan leaves an owner in three ways.1
Manual release
The current owner, or anyone holding loans.assign, clicks Release on the Assigned to card. The loan goes back to its team queue and records
loan_application.unassigned. Anyone eligible can then claim it. Releasing a loan that already has no owner records nothing.2
Stage handoff
The platform clears the owner automatically at exactly two boundaries: APPROVED to SECURITIES, and SECURITIES to DISBURSEMENT. The receiving team then sees the new work and someone there claims it. This also records
loan_application.unassigned. The adjudicator’s ownership carries forward from SUBMITTED through ADJUDICATION and APPROVED, and only clears at the move into SECURITIES.3
Reassignment
A supervisor assigns the loan to a different person. The previous owner is recorded on the audit trail alongside the new owner.
Events recorded
Every ownership change is written to the audit trail.Assignment never changes the loan’s status or moves it through the workflow. It only changes who owns the current step. Moving a loan forward is a separate action gated by its own capabilities.