SmartERP Documentation An Ashewa Technology Solutions Platform

Balanced Scorecard Governance and Role Matrix

Access rights, user groups, and separation of duties for Strategy Directors, BSC Champions, Department Heads, and Auditors.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Balanced Scorecard Governance and Role Matrix within SmartERP.

Access rights, user groups, and separation of duties for Strategy Directors, BSC Champions, Department Heads, and Auditors.

{screenshot:bsc-roles-and-governance-overview-dashboard}

2. Prerequisites & Security Access Groups#

  • Required Modules: smarterp_balanced_scorecard, smarterp_strategy
  • Security Groups:
    • Strategy Officer (Technical ID: smarterp_balanced_scorecard.group_bsc_user)
    • Strategy Director (Technical ID: smarterp_balanced_scorecard.group_bsc_manager)
    • Executive Committee Member (Technical ID: smarterp_balanced_scorecard.group_bsc_executive)
  • Master Data Dependencies: Strategic themes, 4 BSC perspectives (Financial, Customer, Internal Process, Learning & Growth), corporate KPIs, and quarterly appraisal periods.

3. Step-by-Step Configuration & Execution#

Step 1: Navigating to the Module Interface#

  1. Log into your SmartERP instance at https://smarterp.et/odoo.
  2. Open the main App Switcher (grid icon in the top-left corner).
  3. Select the Strategic Execution app icon.
  4. From the top navigation bar, open Strategic Execution → Perspectives → Strategic Objectives / KPIs / Action Plans.

{screenshot:bsc-roles-and-governance-app-switcher-navigation}

Step 2: Creating and Parameterizing Records#

  1. Click the New button in the top-left control panel.
  2. Complete the mandatory fields in the record form:
    • Objective / KPI Name (Mandatory): Precise strategic outcome statement
    • Perspective (Mandatory): One of the 4 balanced perspectives with mandated weighting
    • Weight (%) (Mandatory): Percentage allocation contributing to overall perspective score
    • Target Value & Baseline (Mandatory): Quantifiable numerical goal and historical starting point
  3. Configure optional operational parameters and localized tags as required:
    • Calculation Formula (Optional): Automated SQL query or module model metric extraction
    • Initiative Champion (Optional): Department head or senior manager accountable for result
    • Review Frequency (Optional): Monthly, quarterly, or annual appraisal cadence
  4. Click the Save icon in the control bar to commit the record.

{screenshot:bsc-roles-and-governance-record-creation-form}

Step 3: Validating and Processing Transactions#

  • State Transitions: Execute operational state progression (Draft → Active Target → Mid-Term Review → Final Appraisal → Locked).
  • Ledger & System Impact: Financial perspective KPIs dynamically read General Ledger balances, revenue growth metrics, and cost ratios directly from the accounting engine.
  • Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.

{screenshot:bsc-roles-and-governance-transaction-processing-state}

Security Group and Governance Hierarchy#

RoleTechnical GroupResponsibilities & Access Rights
Employeesmarterp_bsc.group_userView own individual performance contract, self-score quarterly targets, attach portfolio evidence.
Department Headsmarterp_bsc.group_managerManage department scorecard, evaluate direct reports, propose target adjustments.
BSC Champion / Facilitatorsmarterp_bsc.group_facilitatorAudit KPI data entries, review automated ORM queries, coordinate QPR sessions.
Chief Strategy Officer (CSO)smarterp_bsc.group_directorFull administrative authority over strategy maps, corporate scorecards, weights, and initiative approvals.
Internal Auditoraccount.group_account_userRead-only audit access to historical performance records, formula definitions, and evidence attachments.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • BSC: Calculate quarterly KPI achievements (smarterp_bsc.ir_cron_compute_kpi): Runs quarterly on the 5th to compute composite achievement scores
    • BSC: Issue appraisal cascade reminders (smarterp_bsc.ir_cron_appraisal_alert): Runs monthly to remind objective champions to update progress
  • Custom Print Templates & Reports:
    • Institutional Balanced Scorecard Executive Dashboard
    • Departmental Strategic Cascade Matrix
    • KPI Performance Variance & Trend Analysis
    • Corporate Strategy Execution Summary
  • Multi-Company Rules: Record-level security isolation under Company 1 (Ashewa Technology Solutions S.C.), preventing cross-company ledger leakage across parent and subsidiary legal entities.

5. Comprehensive Troubleshooting Matrix#

Error Symptom / ExceptionProbable Root CauseCorrective Action / Resolution
Weighting Error: Perspective weights do not equal 100%Total weights assigned to objectives within perspective fail to sum to 100.00%.Adjust individual objective weightings so the perspective total equals exactly 100%.
Data Feed Error: Automated KPI metric returned nullUnderlying model query failed or target database view has no records.Verify connected model name and filter domain in the KPI automated calculation parameters.
Lockout Error: Period results locked for executive reviewCurrent appraisal quarter has been locked by the Strategy Director.Obtain written authorization and request temporary unlock from the Strategy Director.
Last updated: 2026-10-30