Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.keystn.com/llms.txt

Use this file to discover all available pages before exploring further.

QC review dashboard

Go to Quality Control > QC Dashboard in the sidebar. The dashboard displays a paginated table of all reviews with the following columns:
ColumnDescription
Loan #The broker loan number (links to the loan detail page)
BorrowerBorrower last name
TemplateThe QC template used for this review
ReviewerThe employee assigned to conduct the review
StatusCurrent review status displayed as a color-coded badge
SelectionThe month the loan was selected for review
Pass / Fail / N/ASummary counts of item results
CreatedWhen the review was created

Filtering reviews

You can filter the review dashboard by:
FilterOptions
StatusPending, In Progress, Completed, Waived
Selection MonthAny month that has reviews (format: YYYY-MM)

Pagination

Reviews are displayed 20 per page with standard pagination controls.

Selecting loans for QC review

There are three ways to create QC reviews:

Random selection

Random selection is the primary method for building a compliant QC sample. It uses your QC settings to determine how many loans to select and which loans are eligible. How to run a random selection:
  1. Go to the QC Dashboard and click Run Selection in the toolbar.
  2. Select the target month (defaults to the current month).
  3. Optionally enter a target count to override the percentage-based calculation.
  4. Click Run Selection.
How random selection works:
  1. The system identifies all loans that reached an eligible status (e.g., Funded or Closed) during the selected month.
  2. Loans that already have a QC review are excluded.
  3. The remaining loans are shuffled using a randomization algorithm.
  4. The system selects a number of loans based on your configured selection percentage (default: 10%) or the override target count.
  5. For each selected loan, a QC review is created with the appropriate template matched automatically.
  6. All reviews are created with status Pending and selection method Random.
The dialog shows a summary after the selection completes, indicating how many loans were selected out of the total eligible pool.

Manual selection

Manual selection lets you create a QC review for a specific loan. How to manually create a review:
  1. Open the loan detail page and click the QC tab.
  2. If no review exists, click Create QC Review.
  3. The system automatically matches the loan to the most appropriate active template based on the loan’s type, purpose, channel, and property state.
  4. The review is created with status Pending and selection method Manual.
Only one QC review can exist per loan. If a review already exists, the QC tab displays the existing review instead of offering to create a new one.

Targeted selection

Targeted selection works the same as manual selection but records a different selection method. Use targeted selection when a loan is being reviewed due to a specific concern, such as:
  • An investor audit request
  • A borrower complaint
  • A suspicious pattern identified in another review
  • A regulatory inquiry
The selection method is recorded on the review for audit trail purposes.

Review statuses

Every QC review progresses through a defined set of statuses:
StatusDescription
PendingReview has been created but no items have been evaluated yet
In ProgressAt least one item has been marked Pass, Fail, or N/A. Status changes automatically when the first item is reviewed.
CompletedAll items have been evaluated and the reviewer has finalized the review
WaivedThe review has been waived (skipped) with an optional reason
Status transitions happen as follows:
Pending  -->  In Progress  -->  Completed
                  |
                  v
               Waived
The transition from Pending to In Progress is automatic — it occurs when the first review item receives a result other than Pending.

Conducting a review

Once a review exists, a reviewer works through each checklist item.

Opening a review

Go to the QC Dashboard and click on a review row to open it. 3. The review detail page shows loan information at the top and the checklist below.

Marking items

For each checklist item, the reviewer selects one of four results:
ResultMeaningWhen to use
PassThe item meets requirementsDocumentation is present, accurate, and compliant
FailThe item does not meet requirementsDocumentation is missing, inaccurate, or non-compliant
N/AThe item does not apply to this loanThe question is not relevant (e.g., VA-specific question on a Conventional loan)
PendingThe item has not been reviewed yetDefault state — no action taken
Step by step:
  1. Locate the item in the checklist (items are grouped by category and sorted by sort order).
  2. Select the appropriate result: Pass, Fail, or N/A.
  3. The result is saved immediately.
  4. The review’s pass, fail, and N/A counts update in real time.

Adding notes to items

Each item has an optional notes field where the reviewer can provide detail:
  • For failures: Document what was wrong, what is missing, or what regulation was violated.
  • For passes: Optionally note anything noteworthy about the documentation.
  • For N/A: Optionally explain why the item does not apply.
Notes are saved when the item result is updated.

Review summary counts

As items are marked, the review header updates with real-time counts:
CountDescription
Total ItemsThe total number of checklist items on this review
PassNumber of items marked Pass
FailNumber of items marked Fail
N/ANumber of items marked N/A
These counts are stored on the review record for reporting purposes and do not need to be recalculated when viewing the review later.

Completing a review

When all items have been evaluated (no items remain in Pending status), the review can be completed. How to complete a review:
  1. Ensure all items have a result of Pass, Fail, or N/A.
  2. Click Complete Review.
  3. Optionally add overall notes summarizing the review findings.
  4. The review status changes to Completed and a completedAt timestamp is recorded.
If any items still have a Pending result, the system will prevent completion and display the number of items that still need to be reviewed.

Overall notes

The overall notes field is for the reviewer’s summary assessment of the loan. Common uses include:
  • Summarizing any failures and their severity
  • Noting patterns or training needs identified during the review
  • Recording follow-up actions required
  • Documenting the overall quality of the file

Waiving a review

In some cases, a QC review may need to be waived rather than completed. This could happen if:
  • The loan was paid off or rescinded before the review could be conducted
  • The review was created in error
  • An exception was approved by management
How to waive a review:
  1. Open the review detail page.
  2. Click Waive Review.
  3. Optionally provide a reason for waiving (stored in the overall notes field).
  4. The review status changes to Waived and a completedAt timestamp is recorded.
A waived review retains any item results that were recorded before the waiver. The waiver reason provides an audit trail for why the review was not fully completed.

Viewing QC results on a loan

Open the loan detail page and click the QC tab. If a review exists, you will see its status, summary counts, reviewer, and the full checklist with results. If no review exists, you will see an option to create one.

QC selection history

The selection history is available in the filter panel on the QC Dashboard, showing each month with its loan count. This helps you verify that selections are being run consistently and that sample sizes meet your policy requirements.