> ## Documentation Index
> Fetch the complete documentation index at: https://docs.frankieone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Risk Assessment

### Video Guide

<iframe src="https://www.loom.com/embed/83252c6f91bf4c19ae9176fe4a203e2c" title="Loom video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

## Risk Assessment

FrankieOne calculates risk to help you assess customers and make informed decisions during onboarding, monitoring, and ongoing due diligence.

## Entity risk vs. Workflow risk

When viewing an entity in the Portal, you will see two related risk levels.

| **Level**         | **What it measures**                                                                                                                             | **When it updates**                           |
| :---------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------- |
| **Entity risk**   | The entity’s risk state, either based on the latest workflow run or as a cumulative risk across its lifetime (depending on configuration/model). | After each workflow run or a manual override. |
| **Workflow risk** | The risk score for a single workflow execution.                                                                                                  | At the end of that workflow run.              |

### How is entity risk calculated

1. Each check in a workflow returns one or more risk factors (for example, sanctions matches, device risk, jurisdiction).
2. Each risk factor is assigned a score based on your configuration.
3. FrankieOne aggregates these scores (sum or average, depending on your model) to produce a **workflow risk score** at the end of the workflow run.
4. The score is mapped to a **Risk Level** (Low, Medium, High, Unacceptable).

### How workflow risk and entity risk relate

1. Workflow risk represents the risk for a single workflow execution (for example, an onboarding attempt).
2. Entity risk represents the customer’s overall risk profile.
3. Entity risk is derived from workflow risk, either:
   * based on the latest workflow result, or
   * as a cumulative view over time, depending on your configuration.
4. A high workflow risk can increase the entity’s overall risk level (for example, from Medium to High).

### Entity risk vs Workflow risk

| **Aspect**            | **Workflow Risk**                                              | Entity Risk                                                             |
| --------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------- |
| **Scope**             | Single workflow execution (point-in-time assessment)           | Overall customer risk profile                                           |
| **Purpose**           | Identifies risk in a specific onboarding or assessment attempt | Reflects ongoing risk across the customer lifecycle                     |
| **Calculation basis** | Risk factors from a single workflow run                        | Derived from one or more workflow results (latest or cumulative model)  |
| **Update timing**     | At the end of each workflow run                                | After each workflow run or manual override (depending on configuration) |
| **Typical use case**  | Detecting immediate issues during onboarding or screening      | Maintaining long-term risk posture for the entity                       |

<Callout icon="thumbtack" iconType="regular" color="#1A6CFF">
  ***Risk accumulation over time***

  Entity risk is updated as new workflows are executed for the same entity. New workflows can change the risk score based on new or updated signals, so the entity risk may increase, decrease, or remain unchanged.

  **Example:** A customer is onboarded and assessed as **Low risk**. Later, during ongoing monitoring, new AML alerts are triggered and the workflow returns **High risk**. The entity’s risk level is then updated to **High**.
</Callout>

## Risk score and Risk levels

| Risk level   | Score range (example) | Typical action         |
| :----------- | :-------------------- | :--------------------- |
| Low          | 1–30                  | Auto-approve.          |
| Medium       | 31–50                 | Require extra checks.  |
| High         | 51–75                 | Manual review and EDD. |
| Unacceptable | >75                   | Auto-fail.             |

<Tip>
  Your risk score ranges and associated actions are configurable.
</Tip>

## Risk factors

[Risk factors](/docs/risk-factors) are defined in your **Risk Scorecard** and appear in the Risk drawer with their individual scores.

| Factor          | What it measures                      | Example values     |
| :-------------- | :------------------------------------ | :----------------- |
| `num_sanctions` | Count of sanctions matches.           | 0, 1+              |
| `num_pep`       | Count of PEP matches.                 | 0, 1+              |
| `device_risk`   | Fraud score from device intelligence. | Low, High          |
| `jurisdiction`  | Country risk tier.                    | Tier 1–4           |
| `document_age`  | Document expiry status.               | Valid, Expired     |
| `behaviour`     | Biometrics or usage anomalies.        | Normal, Suspicious |

## Overriding risk score

Authorised users can manually set a new Risk score in the Risk drawer (for example, lowering risk after enhanced due diligence).

<Callout icon="thumbtack" iconType="regular" color="#1A6CFF">
  A manual override remains until **any underlying risk factor changes in a future workflow run**. When that happens, the system recalculates risk and clears the old override.
</Callout>

## Where to find risk information

* **Profile header** – shows the current *Entity risk* badge
* **Workflow events tab** – each event row displays its *Workflow risk* level
* **Risk score** – click to open a drawer with risk factor details