SmartERP Documentation An Ashewa Technology Solutions Platform

Shift Optimization & Automated Workforce Rostering Agent

Mathematical shift scheduling copilot balancing employee availability, labor law restrictions, and operational demand peaks.

1. Overview & Business Value#

The Shift Optimization Agent automates complex multi-shift rostering for 24/7 manufacturing plants, healthcare clinics, and retail stores.

1. Overview & Statutory Constraints#

The optimizer enforces Ethiopian Labour Proclamation No. 1156/2019 rules:

  • Maximum 8 hours per normal working day (48 hours per week).
  • Mandatory minimum 24 consecutive hours of weekly rest.
  • Overtime limits (maximum 2 hours per day, 20 hours per month).

{screenshot:ai-shift-optimization-gantt}

2. Step-by-Step Execution Workflow#

  1. Open Planning → Rostering → AI Shift Generator.
  2. Specify the scheduling window (e.g., Next Month).
  3. Click Solve Shift Optimization. The constraint solver assigns qualified personnel to required shift slots.
  4. Review warnings (highlighted in red for overtime limit risks) and click Publish Schedule.

2. Prerequisites & Security Access Groups#

  • Required Modules: muk_ai, muk_mcp, smarterp_ai_suite
  • Security Group: Ashewa AI / User (Technical ID: muk_ai.group_ai_user)
  • Master Data Dependencies: Configured AI provider credentials, active system prompts, and departmental cost centers.

3. Step-by-Step UI Execution & Verification#

Step 1: Navigating to the Operational Interface#

  1. Log into your SmartERP instance at https://smarterp.et/odoo.
  2. Open the main App Switcher and select Ashewa AI.
  3. Select the operational workspace corresponding to this agent suite.

{screenshot:58-shift-optimization-and-rostering-agent-step1-navigation}

Step 2: Executing Agent Actions#

  1. Review agent prompts and execution parameters.
  2. Trigger the scheduled or on-demand workflow action.
  3. Validate output in the generated operational log.

{screenshot:58-shift-optimization-and-rostering-agent-step2-execution}

4. Advanced Configuration Points#

  • Scheduled Crons: muk_ai.ir_cron_agent_health_check runs every 30 minutes.
  • Multi-Company Isolation: Multi-company record rules ensure agent context is isolated to Company 1 (Ashewa Technology Solutions S.C.).

5. Comprehensive Troubleshooting Matrix#

Symptom / ErrorProbable Root CauseResolution Action
Agent unresponsive or timeoutNetwork latency or API endpoint outage.Verify provider connection in Settings → AI Providers.
Access Denied during agent executionUser lacks assigned operational permissions.Assign user to the designated operational group.
Last updated: 2026-10-30