Business Rules Catalogue Template
Business rules: types and conventions, catalogue with ID, statement, type, source, owner, enforcement level, details, enforcement points, change log
Cách dùng: Use it when business rules are scattered across policies, code and scripts and need one owned list. Fill the conventions and the catalogue first, then enforcement points for each behavioural rule. The main pitfall is writing rules as system requirements, so they vanish when the system changes.
Xem trước
Business Rules Catalogue: [Business domain]
Catalogue of the business rules for one domain: each rule's ID, statement, type, source, owner and the points where it is enforced. The rule types follow the Business Rules Analysis technique of IIBA's BABOK Guide version 3 (technique 10.9: definitional and behavioural rules) and the rule categories of the OMG Semantics of Business Vocabulary and Business Rules (SBVR) version 1.5 (December 2019). Replace every
[bracketed]value and every row marked Example.
Document control
| Field | Value |
|---|---|
| Document ID | [BRC-DOMAIN-001] |
| Domain | [Business domain, for example Home claims] |
| Version | [0.1] |
| Status | [Draft / Approved / Superseded] |
| Owner | [@business-rules-owner] |
| Rule change approver | [Role or board] |
| Last updated | YYYY-MM-DD |
| Related documents | [Business requirements], [Process models], [Decision tables], [Glossary] |
1. Rule types and writing conventions
| Type | What it does | Example wording |
|---|---|---|
| Definitional (SBVR: definitional rule) | Defines a term or how something is classified or computed; cannot be broken, only applied wrongly | "A policy is active if today is between its start date and end date and the premium is not overdue by more than 30 days." |
| Behavioural (SBVR: behavioral business rule) | Guides conduct; people or systems can break it, so it needs an enforcement level | "A claim with an estimated value above 5,000 must be referred to a handler before any payment." |
Writing conventions:
- One rule per statement, in the business's terms from the glossary.
- Use "must", "must not" or "may only" for behavioural rules, and "is" or "is defined as" for definitional rules.
- Name the subject explicitly; avoid "the system", "it" and "they".
- Put thresholds in the rule, not in a footnote.
- State exceptions as separate rules with their own IDs.
2. Rule catalogue
| Rule ID | Statement | Type | Source | Owner | Enforcement level | Status |
|---|---|---|---|---|---|---|
| BR-CLM-001 (Example) | A first notice of loss is the first report of an incident by or for the policyholder | Definitional | Claims manual 2.1 | Head of claims | n/a | Approved |
| BR-CLM-002 (Example) | A policy is active if today is between its start date and end date and no premium is overdue by more than 30 days | Definitional | Policy terms, section 4 | Head of underwriting | n/a | Approved |
| BR-CLM-004 (Example) | A claim may only be notified online for an active policy | Behavioural | Digital channel policy | Head of claims | Strictly enforced | Approved |
| BR-CLM-007 (Example) | A claim with an estimated value above 5,000 must be referred to a handler before any payment | Behavioural | Claims authority matrix | Head of claims | Strictly enforced | Approved |
| BR-CLM-008 (Example) | A handler must contact the policyholder within 2 working days of a referral | Behavioural | Service standard | Claims operations manager | Monitored, breach reported | Approved |
| BR-CLM-009 (Example) | Each claim photo must be 10 MB or smaller, and a claim may have at most 10 photos | Behavioural | Upload policy | Digital product owner | Strictly enforced | Approved |
| BR-CLM-012 (Example) | A claim must be referred to the fraud team if two or more fraud indicators from the indicator list apply | Behavioural | Fraud policy | Head of fraud | Strictly enforced | In review |
| [BR-XXX-nnn] | [Statement] | [Definitional / Behavioural] | [Source] | [Role] | [Level] | [Proposed / In review / Approved / Retired] |
Enforcement levels used: Strictly enforced (cannot be broken), Override allowed (can be broken by an authorised role, with a reason recorded), Monitored (breaches are allowed but reported), Guideline (advice only).
3. Rule details
BR-CLM-007 (Example)
| Field | Value |
|---|---|
| Statement | A claim with an estimated value above 5,000 must be referred to a handler before any payment |
| Rationale | Large losses need a human check of cover and value |
| Terms used | Claim, estimated value, handler, payment (glossary) |
| Exceptions | [None. If an exception is needed, write it as a separate rule with its own ID and link it here] |
| Examples | 7,500: referred. 5,000: not referred (the rule says "above") |
| Related rules | BR-CLM-004, BR-CLM-012 |
| Acceptance scenarios | SC-04, SC-05 in requirements/acceptance-criteria-bdd |
| Effective from | YYYY-MM-DD |
4. Enforcement points
| Rule ID | Enforcement point | Mechanism | Owner of the point |
|---|---|---|---|
| BR-CLM-004 (Example) | Claims portal, notification start | Policy status check through the policy service | Digital product owner |
| BR-CLM-007 (Example) | Claims service, payment step | Referral decision from the rules engine | Claims IT lead |
| BR-CLM-007 (Example) | Contact centre script | Agent refers manually for phone claims | Claims operations manager |
| BR-CLM-009 (Example) | Claims portal and mobile app upload | Client and server size checks | Digital product owner |
| BR-CLM-012 (Example) | Fraud scoring service | Indicator count from the fraud indicator list | Head of fraud |
5. Change log and governance
| Date | Rule ID | Change | Reason | Approved by |
|---|---|---|---|---|
| YYYY-MM-DD | BR-CLM-007 (Example) | Threshold raised from 3,000 to 5,000 | Referral volume too high for handler capacity | Head of claims |
| YYYY-MM-DD | [BR-ID] | [Change] | [Reason] | [@approver] |
Review the catalogue at least [yearly] and whenever a source policy, contract or law changes.
Standard and licence note
Structure aligned with the Business Rules Analysis technique (10.9) of
A Guide to the Business Analysis Body of Knowledge (BABOK Guide)
version 3, International Institute of Business Analysis (IIBA), 2015,
and with the distinction between definitional rules and behavioral business
rules in the Object Management Group specification Semantics of
Business Vocabulary and Business Rules (SBVR), version 1.5, December
2019. Both are cited by name and number only; this template is original
text written for this collection. Check the current editions before
use. Official text: IIBA, purchase or member access at
https://www.iiba.org/career-resources/a-business-analysis-professionals-foundation-for-success/babok/;
OMG specification at https://www.omg.org/spec/SBVR/. Related templates:
requirements/business-requirements, requirements/business-analysis-plan,
requirements/traceability-matrix. Template licence: MIT.
Template liên quan
Business Analysis Plan Template
Plan for BA work: approach decision, stakeholder engagement, decision rights and change control, information management, BA performance measures, effort, risks
Yêu cầu & Phân tíchBusiness Requirements Specification (BRS) Template
Business purpose, measurable objectives, processes, rules, business requirements with attributes, success metrics (BRS/BRD)
Yêu cầu & Phân tíchNFR Catalogue Template (ISO/IEC 25010:2023, 29148)
NFR register with metric, target, minimum, priority, source, verification; 25010:2023 categories plus operability, compliance, cost; traceability