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

Enterprise ERP Integrations & Data Connectors

የቀጥታ የERP ዳታ አገናኞች፣ የ Odoo 19 _read_group ሞተር፣ የሞዴል ደህንነት ፈቃድ ዝርዝር እና አውቶማቲክ የክሮን ማመሳሰል።

1. Overview & Business Value#

ይህ አጠቃላይ የአሰራር መመሪያ በ SmartERP ውስጥ ለEnterprise ERP Integrations & Data Connectors የሚያስፈልጉትን የስርዓት አርክቴክቸር፣ የንግድ የስራ ፍሰቶች፣ የማዋቀሪያ መለኪያዎች እና የአፈጻጸም እርምጃዎችን በዝርዝር ያብራራል።

የስትራቴጂ ካስኬዲንግ ዲያግራም፤ ራዕይን ከስትራቴጂ ካርታ፣ ከክፍል ስኮርካርዶች እና ከሰራተኛ ግቦች ጋር ማስተሳሰር።
የባላንስድ ስኮርካርድ የስትራቴጂ አፈፃፀም እና የውጤት ግምገማ ሂደት።

የስትራቴጂክ አመራር ዳሽቦርድ እና የውጤት መለኪያ

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 የጠቅላላ ሂሳብ መዝገብ ቀሪዎችን፣ የገቢ እድገት መለኪያዎችን እና የወጪ ጥምርታዎችን በቀጥታ ከሂሳብ አያያዝ ሞተር ያነባሉ።
  • የኦዲት ማረጋገጫ: የፈጣሪ መለያ፣ የጊዜ ማህተም እና የማይለወጥ የክለሳ ታሪክ በራስ-ሰር መመዝገብ።

Odoo 19 Native Dynamic Aggregation Engine#

በቀደሙት Odoo 17 እና 18 ስሪቶች የሞዴሎች ስሌት ጊዜ ያለፈበትን read_group() ይጠቀም ነበር፣ ይህም በተጠየቀው ቀመር ምትክ የመስኩን ነባሪ ኦፕሬተር ሊጠቀም ይችላል።

BSC V3 የ Odoo 19 ኦሪጅናል _read_group() ኤፒአይን ይጠቀማል፡

# Native Odoo 19 Dynamic Aggregation Pipeline:
domain = safe_eval(kpi.source_domain or "[]")
# Automatically injects period calendar boundaries:
domain += [
    (date_field, ">=", period.date_start),
    (date_field, "<=", period.date_end),
]

# Executes dynamic aggregation query:
results = env[kpi.source_model_id.model]._read_group(
    domain=domain,
    aggregates=[f"{measure_field}:{aggregator}"],  # e.g. "price_subtotal:sum"
)
actual_value = results[0][0] if results else 0.0

የሚደገፉ ማጠቃለያዎች የሚከተሉትን ያካትታሉ፡

  • sum: አጠቃላይ መጠን (ለምሳሌ ጠቅላላ የሽያጭ ገቢ፣ ጠቅላላ የጭነት ክብደት)።
  • avg: አማካይ አፈጻጸም (ለምሳሌ አማካይ የደረሰኝ ሂደት ቆይታ፣ አማካይ የተግባር እርካታ)።
  • count: የመዝገብ ብዛት (ለምሳሌ ያሸነፉ የድርጅት እድሎች ብዛት፣ ንቁ የተማሪዎች ምዝገባ)።
  • min / max: የወሰን መለኪያዎች (ለምሳሌ ዝቅተኛ የSLA ዝግጁነት፣ ከፍተኛ የማስረከቢያ መዘግየት)።

Security Model: Positive Model Allowlist#

የKPI ሞተሩ በመረጃ ቋት ሠንጠረዦች ላይ መጠይቆችን ስለሚያከናውን ደህንነት እጅግ ወሳኝ ነው። በቀደሙት ረቂቆች ያልተገደቡ የ sudo() ፍለጋዎች ያልተፈቀደ ተጠቃሚ ሚስጥራዊ የደመወዝ ወይም የማረጋገጫ ሠንጠረዦችን እንዲጠይቅ ሊፈቅዱ ይችሉ ነበር።

BSC V3 ጥብቅ የፍቃድ ዝርዝርን ያስገድዳል (Strict Positive Allowlist & Deny Guard)፡

# Safe Model Security Allowlist:
ALLOWED_SOURCE_MODELS = {
    "account.move", "account.move.line",
    "sale.order", "sale.order.line",
    "crm.lead",
    "project.project", "project.task",
    "hr.employee", "hr.department", "hr.leave",
    "stock.picking", "stock.move",
    "mrp.production",
    "fleet.vehicle", "freight.booking",
    "sacco.loan", "sacco.member",
}

DENIED_MODELS = {
    "res.users", "res.company", "ir.model", "hr.payslip", "hr.contract"
}

አንድ አስተዳዳሪ ወይም ተጠቃሚ የKPI ምንጭ ሞዴልን ወደ ተከለከለ ወይም ፍቃድ ወደሌለው ሠንጠረዥ ለማመልከት ከሞከረ ስርዓቱ ማስቀመጥን ያግዳል እንዲሁም ግልጽ የደህንነት ማሳወቂያ ያሳያል፡

"Access Denied: The requested model is restricted from automated BSC KPI queries for data governance and privacy."


Standard SmartERP App Connectors#

1. Financial & Invoicing Integration (account.move.line)#

  • KPI መለኪያዎች: ወርሃዊ ጠቅላላ ገቢ፣ የስራ ማስኬጃ ወጪዎች፣ አጠቃላይ የትርፍ ህዳግ %፣ የገንዘብ ገቢ ደረሰኞች።
  • Filter Domain: [('move_id.state', '=', 'posted'), ('account_id.account_type', '=', 'income')]
  • Measure Field: credit - debit (ወይም balance)
  • የቀጥታ ጥቅም: የሂሳብ ባለሙያው ደረሰኝ ባስመዘገበበት ቅጽበት ወርሃዊ የፋይናንስ ውጤቶች ኦዲት ከተደረጉ የጠቅላላ ሂሳብ መስመሮች በቀጥታ ይንጸባረቃሉ፣ ይህም የተመን ሉህ ድጋሚ ስሌቶችን ያስቀራል።

2. Commercial Sales & CRM (sale.order, crm.lead)#

  • KPI መለኪያዎች: የተጣራ አዲስ አመታዊ ተደጋጋሚ ገቢ (ARR)፣ የማሸነፍ መጠን %፣ አማካይ የውል መጠን፣ የእርሳስ ፍጥነት።
  • Filter Domain: [('state', 'in', ['sale', 'done']), ('team_id.name', '=', 'Enterprise Sales')]
  • Measure Field: amount_untaxed ከ sum አጠቃላይ ጋር።

3. Project Management & Engineering Delivery (project.task)#

  • KPI መለኪያዎች: ስትራቴጂካዊ የምእራፍ ፍጥነት፣ የስፕሪንት ማቅረቢያ መጠን %፣ ክፍት ከፍተኛ ቅድሚያ የስህተት ብዛት።
  • Filter Domain: [('project_id.is_strategic', '=', True), ('state', '=', '1_done')]
  • Measure Field: effective_hours ወይም count።

4. Human Resources & Talent (hr.employee)#

  • KPI መለኪያዎች: የሰራተኞች እድገት፣ በፈቃደኝነት መልቀቅ %፣ የስልጠና ማጠናቀቂያ መጠን።
  • Filter Domain: [('active', '=', True), ('department_id', '=', dept_id)]
  • Measure Field: id:count።

5. Fleet & Logistics Operations (freight.booking, fleet.vehicle)#

  • KPI መለኪያዎች: በሰዓቱ የማጓጓዣ ኮሪደር ማድረስ %፣ የሞጆ ደረቅ ወደብ ማጽጃ ፍጥነት፣ የከባድ መኪናዎች አጠቃቀም።
  • Filter Domain: [('stage', '=', 'delivered')]

Automated Data Synchronization Cron#

የKPI ዋጋዎች በእጅ የአዝራር ጠቅታዎችን አይፈልጉም። SmartERP BSC V3 ከሁለት አስቀድመው ከተዋቀሩ የጀርባ ክሮን ሰራተኞች ጋር ይላካል፡

  1. KPI Data Connector Sync (ir.cron.bsc.kpi.fetch):
    • በየምሽቱ በ 00:00 ይሰራል::
    • ሁሉንም ንቁ የውጤት ካርዶች ይቃኛል፣ የአሁኑን ያለፈ የቀን መቁጠሪያ ክፍለ ጊዜ ይለያል፣ የተዋቀረውን ጎራ በመጠቀም የቀጥታ ERP ሠንጠረዦችን ይጠይቃል፣ እና የ actual_value መስክን ያዘምናል።
  2. Red-KPI Escalation Monitor (ir.cron.bsc.escalation):
    • አዲስ የተለኩ ክፍለ ጊዜዎችን ይገመግማል።
    • ወሳኝ የሆነ KPI $< 70.0\%$ (ቀይ ዞን) ካስመዘገበ ስርዓቱ በተጠያቂው ስራ አስፈፃሚ ዳሽቦርድ ላይ አውቶማቲክ ተግባር ይፈጥራል እንዲሁም ተጠያቂውን ስራ አስኪያጅ የሚያሳውቅ የቻተር ማስጠንቀቂያ ይመዘግባል።

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