የSmartERP መመሪያ የAshewa Technology Solutions መድረክ

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#

  1. ወደ SmartERP ስርዓት በ https://smarterp.et/odoo ይግቡ።
  2. የዋናውን App Switcher (ከላይ በስተግራ ጥግ ያለውን ፍርግርግ አዶ) ይክፈቱ።
  3. የ Strategic Execution መተግበሪያ አዶን ይምረጡ።
  4. ከላይኛው የማውጫ አሞሌ ላይ Strategic Execution → Perspectives → Strategic Objectives / KPIs / Action Plans የሚለውን ይክፈቱ።

Step 2: Creating and Parameterizing Records#

  1. ከላይ በስተግራ የቁጥጥር ፓነል ውስጥ ያለውን New የሚለውን አዝራር ጠቅ ያድርጉ።
  2. በመዝገብ ፎርሙ ውስጥ ያሉትን ግዴታ መስኮች ይሙሉ፡
    • የግብ / KPI ስም (ግዴታ): ትክክለኛ ስትራቴጂካዊ የውጤት መግለጫ
    • እይታ (ግዴታ): ከተወሰነው ክብደት ጋር ከ 4 ቱ ሚዛናዊ እይታዎች አንዱ
    • ክብደት (%) (ግዴታ): ለአጠቃላይ የእይታ ነጥብ አስተዋፅኦ የሚያደርግ የመቶኛ ድርሻ
    • የዒላማ ዋጋ እና መነሻ (ግዴታ): ሊለካ የሚችል የቁጥር ግብ እና ታሪካዊ መነሻ ነጥብ
  3. እንደ አስፈላጊነቱ አማራጭ የአሰራር መለኪያዎችን እና አካባቢያዊ መለያዎችን ያዋቅሩ፡
    • የስሌት ቀመር (አማራጭ): አውቶማቲክ የSQL መጠይቅ ወይም የሞጁል ሞዴል መለኪያ ማውጣት
    • የተነሳሽነት መሪ (አማራጭ): ለውጤቱ ተጠያቂ የሆነ የመምሪያ ኃላፊ ወይም ከፍተኛ ስራ አስኪያጅ
    • የግምገማ ድግግሞሽ (አማራጭ): ወርሃዊ፣ ሩብ አመታዊ ወይም አመታዊ የምዘና ዑደት
  4. መዝገቡን ለማስቀመጥ በመቆጣጠሪያ አሞሌው ውስጥ ያለውን 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 IdentifierDatabase TableDescription & Relationships
bsc.strategic.planbsc_strategic_planStrategic command center. One2many to versions, milestones, AOPs, analyses, scorecards, risks, scenarios, reviews.
bsc.plan.versionbsc_plan_versionImmutable baseline snapshot. Stores changelog, approval metadata, and target benchmarks.
bsc.plan.milestonebsc_plan_milestoneOperational deliverables. Self-referential Many2many for predecessors with DFS cycle validation.
bsc.analysisbsc_analysisMulti-framework diagnostic session (SWOT, PESTLE, Porter, VRIO, General).
bsc.analysis.factorbsc_analysis_factorGranular analytical factor with Impact $\times$ Probability scoring and 1-click conversion links.
bsc.analysis.assumptionbsc_analysis_assumptionStrategic hypotheses with validation status, sensitivity ratings, and review schedules.
bsc.evidence.sourcebsc_evidence_sourceVerifiable empirical proof sources with reliability ratings and reference URLs.
bsc.stakeholderbsc_stakeholderMendelow Power vs. Interest matrix with engagement strategy classifications.
bsc.competitorbsc_competitorCompetitive profiling with tiers, market share %, and moats.
bsc.annual.planbsc_annual_planFiscal execution bridge with Capex/Opex budget envelopes and initiative linkages.
bsc.initiativebsc_initiativeStrategic programs with Capex/Opex allocations, actual costs, and ROI %.
bsc.riskbsc_riskStrategic Risk Registry with $5 \times 5$ Inherent vs. Residual severity scoring and KRI links.
bsc.scenariobsc_scenarioMacro scenario models (Bull, Bear, Stress, Disruption) with revenue/cost variance percentages.
bsc.strategy.reviewbsc_strategy_reviewExecutive review sessions with discussion logs, approved pivots, and decision governance.
bsc.scorecardbsc_scorecardMulti-tier scorecard (Corporate, Department, Team, Individual) tracking 4 perspectives.
bsc.scorecard.perspectivebsc_scorecard_perspectivePerspective container enforcing mathematical 100% weight balance across child KPIs.
bsc.objectivebsc_objectiveQualitative strategic goals linked to perspectives and parent-child cause-and-effect trees.
bsc.kpibsc_kpiQuantitative performance metric with directional scoring modes and ERP connectors.
bsc.kpi.periodbsc_kpi_periodTime-slice period records (Monthly, Quarterly, Annual) storing target, actual, and score.
bsc.themebsc_themeCross-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 ዩኒት እና ሪግሬሽን ሙከራዎችን ያካትታል፡

  1. test_bsc_engine.py (8 Tests): የ P0 ጉድለት ማስተካከያዎችን፣ የ Odoo 19 _read_group የማጠቃለያ ሜካኒክስን፣ የወደፊት ክፍለ ጊዜ ዜሮ ጥበቃዎችን እና የማሳወቂያ ክሮን ባህሪን ያረጋግጣል።
  2. test_bsc_strategic_plan.py (6 Tests): የአድማስ ቀን ስሌትን፣ የፀደቀ የስሪት አለመለወጥ መቆለፊያዎችን፣ የኮድ ልዩነት ገደቦችን እና የ DFS ምእራፍ ዑደት ጥገኝነት ውድቅ ማድረጉን ያረጋግጣል።
  3. test_bsc_analysis_intelligence.py (4 Tests): የ SWOT/PESTLE ቅድሚያ ስሌቶችን፣ የሜንደሎው ማትሪክስ ምደባዎችን እና የ 1-ጠቅታ የፋክተር ለውጦችን ወደ ግቦች እና ስጋቶች ይፈትሻል።
  4. 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 / ExceptionProbable Root CauseCorrective 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