Skip to main content
NEXCLARADocumentation

Decision policy lifecycle

Under construction

Part of the function exists; the page names precisely what is missing.

Creating a policy from a reference scorecard, setting its parameters, simulating it, submitting it and having it approved by another person.

A decision policy is the rule the engine applies to the applications of a credit product: exclusions, scorecard, outcome zones and the institution's parameters. In NEXCLARA, a policy is versioned data, not code: each version is created, simulated, submitted and then approved by someone who is not its author, and it no longer changes once submitted.

States of a version

State What is possible
Draft set parameters, simulate
Simulated submit; any change sends the version back to draft
Submitted, awaiting approval approve or reject (by someone other than the authors)
Active governs new applications for the product from its effective date
Archived can be viewed, no longer applies
Draft, simulated, submitted, active then archived; a coded rejection or a change returns it to draft; the approver is not an author.
The states of a policy version and what moves it from one to the next. Diagram.

Step by step

  1. Create — risk management creates a version from a reference scorecard of the product's family. The version arrives as a draft, with empty parameters: it cannot be activated as is.

  2. Set parameters — the institution enters its own values: completeness threshold, product cap, target debt-service ratio, maximum term, age bounds depending on the scorecard… Each parameter declares its unit and bounds; a rate is entered as a percentage. Required parameters that are still empty are listed on screen.

  3. Simulate — no version can be submitted without a simulation. Two modes open the way to submission: a fictitious test case, evaluated by the version, whose detailed calculation is shown on screen; and a replay of the product's most recently evaluated applications, within a sample limit, which counts outcomes and the applications whose outcome would change. The test case is not kept: only the simulation summary is, and it holds counts only, never an application.

    A historical simulation (Policies › “Historical simulation”) complements these two modes without changing the state of any version: it freezes a set of already evaluated applications (product, period, criteria), replays that set under a candidate version and a reference version, and returns their comparison: outcome transitions from one to the other, score distributions, exclusions and forced reviews by reason, the number of applications for which a factor changes points (never the points). The set, both versions, the engine and the results are fingerprinted; the simulation can be sealed, then reconstituted identically (“Reconstitute the simulation”). The effect on defaults is stated as “not measurable”: no credit outcome data is imported.

  4. Submit — the version is frozen: definition, fingerprint and authors no longer change. An effective date can be set; it is never in the past.

  5. Approve or reject — the policy approver, who is not an author of the version, approves it after a step-up verification of their second factor, or rejects it with a coded reason (inadequate parameters, insufficient simulation, inadequate effective date, other): the rejected version then returns to draft.

Parameters tab of a draft policy version: Eligibility, Repayment capacity and Decision zones sections, each field with its unit, description and technical name.
Institution parameters of a draft version, with units and bounds. Synthetic test parameters, not a validated scorecard. Demonstration scorecard, fictitious points and zones. Excerpt, local environment. Interface shown in French; the application is also available in English. Screenshot of the real product, synthetic data.
Result of a simulated test case on the demonstration scorecard: recommended outcome, score, zone bar and key factors with fictitious points, with the note Fictitious case, calculated by this policy version.
Simulating a fictitious test case: the case is not kept, only the simulation summary is; no application is created. Demonstration scorecard, fictitious points and zones. Excerpt, local environment. Interface shown in French; the application is also available in English. Screenshot of the real product, synthetic data.
Governance and versions tab of a submitted version: Approve and activate button, Rejection reason list set to Inadequate parameters, and Reject button.
Approval by someone other than the author, or rejection with a coded reason. Demonstration scorecard, fictitious points and zones. Excerpt, local environment. Interface shown in French; the application is also available in English. Screenshot of the real product, synthetic data.

The rule "an author does not approve their own version" is checked twice: by the service, and by a constraint of the database itself.

Scorecard points

The points of each scorecard band are reserved for the people who design, approve or audit the policy. An analyst sees the points obtained by an application and the factors that counted, not the full scale that would let them adjust an entry.

What is still under construction

  • No reason is collected at submission or approval of a version: the author and the date are recorded, the reason for the change is not yet.
  • No editor for points, zones or weights: the institution sets its parameters; the structure of the reference scorecard cannot be changed from the interface.
  • The simulation counts applications and outcome changes; it computes no amount and no outstanding volume.
  • The comparison covers two versions replayed on the same frozen set (historical simulation); two different simulations are not compared with each other, and no constraint yet links two parameters (for example a minimum age lower than the maximum age).

See also Reference scorecards and Decision engine.

About this page

Editorial status
Approved
Written by
Équipe produit NEXCLARA
Reviewed by
claude-relecteur-independant
Approved on
October 16, 2026
Revision
4
Updated
October 16, 2026
Classification
Public