Technical Architecture & Data Governance
የ20 ሞዴሎች አርክቴክቸር፣ ባለብዙ ኩባንያ የመዝገብ ህጎች፣ የ Python XML-RPC ውህደት እና 22 ዩኒት የሙከራ ስብስቦች።
1. Overview & Business Value#
ይህ አጠቃላይ የአሰራር መመሪያ በ SmartERP ውስጥ ለTechnical Architecture & Data Governance የሚያስፈልጉትን የስርዓት አርክቴክቸር፣ የንግድ የስራ ፍሰቶች፣ የማዋቀሪያ መለኪያዎች እና የአፈጻጸም እርምጃዎችን በዝርዝር ያብራራል።


2. Prerequisites & Security Access Groups#
- የሚያስፈልጉ ሞጁሎች:
smarterp_balanced_scorecard, smarterp_strategy - የደህንነት ቡድኖች:
Strategy Officer(ቴክኒካል መለያ፦smarterp_balanced_scorecard.group_bsc_user)Strategy Director(ቴክኒካል መለያ፦smarterp_balanced_scorecard.group_bsc_manager)Executive Committee Member(ቴክኒካል መለያ፦smarterp_balanced_scorecard.group_bsc_executive)
- የማስተር ዳታ ጥገኝነቶች: ስትራቴጂካዊ ጭብጦች፣ 4 የBSC እይታዎች (Financial, Customer, Internal Process, Learning & Growth)፣ የድርጅት KPIs እና የሩብ አመት ምዘና ክፍለ ጊዜያት።
3. Step-by-Step Configuration & Execution#
Step 1: Navigating to the Module Interface#
- ወደ SmartERP ስርዓት በ
https://smarterp.et/odooይግቡ። - የዋናውን App Switcher (ከላይ በስተግራ ጥግ ያለውን ፍርግርግ አዶ) ይክፈቱ።
- የ Strategic Execution መተግበሪያ አዶን ይምረጡ።
- ከላይኛው የማውጫ አሞሌ ላይ Strategic Execution → Perspectives → Strategic Objectives / KPIs / Action Plans የሚለውን ይክፈቱ።
Step 2: Creating and Parameterizing Records#
- ከላይ በስተግራ የቁጥጥር ፓነል ውስጥ ያለውን New የሚለውን አዝራር ጠቅ ያድርጉ።
- በመዝገብ ፎርሙ ውስጥ ያሉትን ግዴታ መስኮች ይሙሉ፡
- የግብ / KPI ስም (ግዴታ): ትክክለኛ ስትራቴጂካዊ የውጤት መግለጫ
- እይታ (ግዴታ): ከተወሰነው ክብደት ጋር ከ 4 ቱ ሚዛናዊ እይታዎች አንዱ
- ክብደት (%) (ግዴታ): ለአጠቃላይ የእይታ ነጥብ አስተዋፅኦ የሚያደርግ የመቶኛ ድርሻ
- የዒላማ ዋጋ እና መነሻ (ግዴታ): ሊለካ የሚችል የቁጥር ግብ እና ታሪካዊ መነሻ ነጥብ
- እንደ አስፈላጊነቱ አማራጭ የአሰራር መለኪያዎችን እና አካባቢያዊ መለያዎችን ያዋቅሩ፡
- የስሌት ቀመር (አማራጭ): አውቶማቲክ የSQL መጠይቅ ወይም የሞጁል ሞዴል መለኪያ ማውጣት
- የተነሳሽነት መሪ (አማራጭ): ለውጤቱ ተጠያቂ የሆነ የመምሪያ ኃላፊ ወይም ከፍተኛ ስራ አስኪያጅ
- የግምገማ ድግግሞሽ (አማራጭ): ወርሃዊ፣ ሩብ አመታዊ ወይም አመታዊ የምዘና ዑደት
- መዝገቡን ለማስቀመጥ በመቆጣጠሪያ አሞሌው ውስጥ ያለውን Save አዶ ጠቅ ያድርጉ።
Step 3: Validating and Processing Transactions#
- የሁኔታ ሽግግሮች: የአሰራር ሁኔታ እድገትን ያከናውኑ (Draft → Active Target → Mid-Term Review → Final Appraisal → Locked)።
- የመዝገብ እና የስርዓት ተፅዕኖ: የፋይናንስ እይታ KPIs የጠቅላላ ሂሳብ መዝገብ ቀሪዎችን፣ የገቢ እድገት መለኪያዎችን እና የወጪ ጥምርታዎችን በቀጥታ ከሂሳብ አያያዝ ሞተር ያነባሉ።
- የኦዲት ማረጋገጫ: የፈጣሪ መለያ፣ የጊዜ ማህተም እና የማይለወጥ የክለሳ ታሪክ በራስ-ሰር መመዝገብ።
Complete Data Model Architecture#
SmartERP BSC V3 በ 20 የተዋሃዱ ሞዴሎች ውስጥ ይሰራል፡
| Model Identifier | Database Table | Description & Relationships |
|---|---|---|
bsc.strategic.plan | bsc_strategic_plan | Strategic command center. One2many to versions, milestones, AOPs, analyses, scorecards, risks, scenarios, reviews. |
bsc.plan.version | bsc_plan_version | Immutable baseline snapshot. Stores changelog, approval metadata, and target benchmarks. |
bsc.plan.milestone | bsc_plan_milestone | Operational deliverables. Self-referential Many2many for predecessors with DFS cycle validation. |
bsc.analysis | bsc_analysis | Multi-framework diagnostic session (SWOT, PESTLE, Porter, VRIO, General). |
bsc.analysis.factor | bsc_analysis_factor | Granular analytical factor with Impact $\times$ Probability scoring and 1-click conversion links. |
bsc.analysis.assumption | bsc_analysis_assumption | Strategic hypotheses with validation status, sensitivity ratings, and review schedules. |
bsc.evidence.source | bsc_evidence_source | Verifiable empirical proof sources with reliability ratings and reference URLs. |
bsc.stakeholder | bsc_stakeholder | Mendelow Power vs. Interest matrix with engagement strategy classifications. |
bsc.competitor | bsc_competitor | Competitive profiling with tiers, market share %, and moats. |
bsc.annual.plan | bsc_annual_plan | Fiscal execution bridge with Capex/Opex budget envelopes and initiative linkages. |
bsc.initiative | bsc_initiative | Strategic programs with Capex/Opex allocations, actual costs, and ROI %. |
bsc.risk | bsc_risk | Strategic Risk Registry with $5 \times 5$ Inherent vs. Residual severity scoring and KRI links. |
bsc.scenario | bsc_scenario | Macro scenario models (Bull, Bear, Stress, Disruption) with revenue/cost variance percentages. |
bsc.strategy.review | bsc_strategy_review | Executive review sessions with discussion logs, approved pivots, and decision governance. |
bsc.scorecard | bsc_scorecard | Multi-tier scorecard (Corporate, Department, Team, Individual) tracking 4 perspectives. |
bsc.scorecard.perspective | bsc_scorecard_perspective | Perspective container enforcing mathematical 100% weight balance across child KPIs. |
bsc.objective | bsc_objective | Qualitative strategic goals linked to perspectives and parent-child cause-and-effect trees. |
bsc.kpi | bsc_kpi | Quantitative performance metric with directional scoring modes and ERP connectors. |
bsc.kpi.period | bsc_kpi_period | Time-slice period records (Monthly, Quarterly, Annual) storing target, actual, and score. |
bsc.theme | bsc_theme | Cross-cutting strategic themes (e.g., Digital Innovation, Customer Centricity). |
Security Groups & Multi-Company Isolation#
1. User Security Groups (security/bsc_security.xml)#
- BSC User (
group_bsc_user):- Read access across corporate and departmental scorecards.
- Read/Write access on individual scorecards and assigned milestone tasks.
- BSC Manager (
group_bsc_manager):- Full administrative rights: Create and approve Strategic Plans, generate version baselines, configure AOP budget envelopes, manage the Risk Registry, and configure ERP query connectors.
2. Multi-Company Record Rules#
የተከራዮችን መረጃ መነጠል ለማስከበር 7 የባለብዙ ኩባንያ የመዝገብ ህጎች ጥብቅ የተከራይ መለያየትን ያስገድዳሉ፡
<record id="rule_bsc_strategic_plan_company" model="ir.rule">
<field name="name">BSC Strategic Plan Multi-Company</field>
<field name="model_id" ref="model_bsc_strategic_plan"/>
<field name="domain_force">['|', ('company_id', '=', False), ('company_id', 'in', company_ids)]</field>
</record>
በ bsc.strategic.plan፣ bsc.annual.plan፣ bsc.analysis፣ bsc.risk፣ bsc.scorecard፣ bsc.objective እና bsc.kpi ላይ በተመሳሳይ መልኩ ተፈጻሚ ይሆናል።
External API Integration (Python XML-RPC)#
የውጭ የ BI መድረኮች (Tableau, PowerBI, Metabase, ብጁ ማይክሮ ሰርቪሶች) የ BSC V3 መለኪያዎችን በ Odoo ኦሪጅናል XML-RPC ወይም JSON-RPC በኩል ይጠይቃሉ እንዲሁም ያዘምናሉ፡
import xmlrpc.client
url = "https://smarterp.et"
common = xmlrpc.client.ServerProxy(f"{url}/xmlrpc/2/common")
uid = common.authenticate("dev", "api_user", "api_key_or_password", {})
models = xmlrpc.client.ServerProxy(f"{url}/xmlrpc/2/object")
# 1. Fetch Executive Corporate Health Score
plans = models.execute_kw(
"dev", uid, "api_key",
"bsc.strategic.plan", "search_read",
[[["state", "=", "approved"]]],
{"fields": ["name", "code", "horizon", "current_version", "milestone_progress"]}
)
print("Active Strategic Plan:", plans[0])
# 2. Query High-Priority Strategic Risks (Score >= 16)
risks = models.execute_kw(
"dev", uid, "api_key",
"bsc.risk", "search_read",
[[["inherent_score", ">=", 16]]],
{"fields": ["name", "category", "inherent_score", "residual_score", "risk_treatment"]}
)
for r in risks:
print(f"Alert: {r['name']} — Residual: {r['residual_score']}")
Automated Test Suites#
ሞጁሉ በ 4 የሙከራ ስብስቦች ውስጥ 22 ዩኒት እና ሪግሬሽን ሙከራዎችን ያካትታል፡
test_bsc_engine.py(8 Tests): የ P0 ጉድለት ማስተካከያዎችን፣ የ Odoo 19_read_groupየማጠቃለያ ሜካኒክስን፣ የወደፊት ክፍለ ጊዜ ዜሮ ጥበቃዎችን እና የማሳወቂያ ክሮን ባህሪን ያረጋግጣል።test_bsc_strategic_plan.py(6 Tests): የአድማስ ቀን ስሌትን፣ የፀደቀ የስሪት አለመለወጥ መቆለፊያዎችን፣ የኮድ ልዩነት ገደቦችን እና የ DFS ምእራፍ ዑደት ጥገኝነት ውድቅ ማድረጉን ያረጋግጣል።test_bsc_analysis_intelligence.py(4 Tests): የ SWOT/PESTLE ቅድሚያ ስሌቶችን፣ የሜንደሎው ማትሪክስ ምደባዎችን እና የ 1-ጠቅታ የፋክተር ለውጦችን ወደ ግቦች እና ስጋቶች ይፈትሻል።test_bsc_annual_plan_and_risk.py(4 Tests): የ AOP Capex/Opex በጀት ድምርን፣ የተነሳሽነት ROI መቶኛ ስሌቶችን እና የ $5 \times 5$ የስጋት ሙቀት ካርታ Inherent vs. Residual ነጥቦችን ይፈትሻል።
የተሟላውን የሙከራ ስብስብ ለማስኬድ፡
odoo --test-enable -i smarterp_bsc -d test_bsc_db --stop-after-init
4. Advanced Configuration Points#
- አውቶማቲክ እርምጃዎች እና የታቀዱ ተግባራት (ክሮኖች):
BSC: Calculate quarterly KPI achievements(smarterp_bsc.ir_cron_compute_kpi): ጥምር የስኬት ውጤቶችን ለማስላት በየሩብ አመቱ በ5ኛው ቀን ይሰራልBSC: Issue appraisal cascade reminders(smarterp_bsc.ir_cron_appraisal_alert): ኃላፊዎች እድገታቸውን እንዲያዘምኑ ለማስታወስ በየወሩ ይሰራል
- ብጁ የህትመት አብነቶች እና ሪፖርቶች:
- የተቋማዊ ሚዛናዊ የውጤት ካርድ የስራ አመራር ዳሽቦርድ
- የመምሪያ ደረጃ ስትራቴጂክ የካስኬድ ማትሪክስ
- የKPI አፈጻጸም ልዩነት እና የአዝማሚያ ትንተና
- የድርጅት ስትራቴጂ አፈጻጸም ማጠቃለያ
- የበርካታ ኩባንያዎች ህጎች: በኩባንያ 1 (
Ashewa Technology Solutions S.C.) ስር የመዝገብ-ደረጃ የደህንነት መነጠል፣ በዋና እና በቅርንጫፍ ህጋዊ አካላት መካከል የሂሳብ መዝገብ መረጃ መፍሰስን ይከላከላል።
5. Comprehensive Troubleshooting Matrix#
| Error Symptom / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Weighting Error: Perspective weights do not equal 100% | በእይታው ውስጥ ላሉ ግቦች የተመደቡ አጠቃላይ ክብደቶች ድምር 100.00% አልሞላም። | የእይታው አጠቃላይ ድምር በትክክል 100% እንዲሆን የግለሰብ ግብ ክብደቶችን ያስተካክሉ። |
Data Feed Error: Automated KPI metric returned null | መሰረታዊ የሞዴል መጠይቅ አልተሳካም ወይም የታለመው ዳታቤዝ እይታ ምንም መዝገብ የለውም። | በKPI አውቶማቲክ ስሌት መለኪያዎች ውስጥ የተገናኘውን የሞዴል ስም እና የማጣሪያ ጎራ ያረጋግጡ። |
Lockout Error: Period results locked for executive review | የአሁኑ የግምገማ ሩብ አመት በስትራቴጂ ዳይሬክተሩ ተቆልፏል። | የጽሁፍ ፈቃድ ያግኙ እና ከስትራቴጂ ዳይሬክተሩ ጊዜያዊ መክፈቻ ይጠይቁ። |
መጨረሻ የተሻሻለው: 2026-11-15