Technical Documentation

Hybrid SA ForecastIQ User Manual

Complete guide to using the Hybrid SA ForecastIQ Production Planning Platform

Quick Start Demo (10 min)

Follow this step-by-step walkthrough to understand the entire system in 10 minutes.

1
Login as Admin
30 sec
  • Go to the login page
  • Enter: admin@hybridsa.com / password123
  • Click Sign In
2
Load Demo Data
1 min
  • Navigate: Administration → Data Console
  • Click 'Load Demo Data' button
  • Wait for success message
3
Explore Control Tower
2 min
  • Navigate: Operations → Control Tower
  • Observe KPI cards at top (Total OFs, Feasibility %, Alerts)
  • View the Workshop × Week grid
  • Notice color coding: 🟢 Green = OK, 🟡 Amber = Risk, 🔴 Red = Blocked
  • Click on any cell to open the drawer
4
Investigate a Problem
2 min
  • Find a RED cell in the grid
  • Click to open the cell drawer
  • Click on a work order with 🔴 status
  • Review the BOM to see which component is blocking
  • Note the 'Available Date' vs 'Planned Start'
5
Review Alerts
1 min
  • Navigate: Operations → Alerts
  • See all system-generated exceptions
  • Note severity (Critical/Warning) and type (Material/Capacity)
  • Click an alert to see full details
6
Simulate a Delay ⭐ KEY DEMO
3 min
  • Find a GREEN work order (Control Tower → Green cell → Green OF)
  • Open the work order detail
  • Click 'Simulate Delay' button
  • Select a component from dropdown
  • Set new date AFTER the planned start date
  • Click 'Apply & Recompute'
  • WATCH: Status changes from GREEN to RED
  • WATCH: Grid cell color updates
  • WATCH: New alert appears
7
Check Audit Trail
30 sec
  • Navigate: Administration → Audit Logs
  • See the SIMULATE_DELAY action recorded
  • All changes are tracked for governance
Demo Complete!

You now understand how a supply chain change ripples through the entire production plan in real-time.

Overview

Purpose

Hybrid SA ForecastIQ is a production planning visibility platform that provides integrated planning visibility and automated exception alerting. The system connects ERP-like supply/material availability dates, workshop execution plans, and HR-like capacity availability.

Core Capabilities

Control Tower Visibility

Consolidated workshop-by-week planning grid showing plan health across all production areas

Material Alerting

Automatic detection of work orders at risk due to component availability issues

Capacity Signaling

Identification of workshop overload conditions where planned hours exceed capacity

Live Demonstrability

Real-time simulation of supply changes and their impact on the plan

System Access

Login Process

  1. Navigate to the application URL
  2. Enter your email address
  3. Enter your password
  4. Click Sign In

Demo Credentials

RoleEmailPassword
Adminadmin@hybridsa.compassword123
Global Plannerplanner@hybridsa.compassword123
Workshop Plannermeca@hybridsa.compassword123
Viewerviewer@hybridsa.compassword123

User Roles & Permissions

Admin

System administrator with full access to all features, data management, and user administration.

Scope: All workshops, all data

Global Planner

Production manager with factory-wide visibility and ability to run validations and simulations.

Scope: All workshops (read + actions)

Workshop Planner

Workshop-level planning and monitoring for assigned workshop only.

Scope: Assigned workshop only

Viewer

Read-only access for stakeholders who need visibility but cannot make changes.

Scope: All workshops (read-only)

Permission Matrix

FeatureAdminGlobalWorkshopViewer
View Control Tower
View Alerts
View Work Orders
Run Validation
Simulate Delay
Data Console
Manage Users
View Audit Logs

Control Tower Dashboard

The Control Tower is the primary operational view providing consolidated visibility across all workshops and weeks. Access via Operations → Control Tower.

KPI Summary Cards

Total Work Orders

Count of OFs evaluated

Feasibility Rate

Percentage of GREEN OFs

Material Alerts

Component availability issues

Capacity Alerts

Workshop overload conditions

Grid Features

  • Rows: Workshops (WS-MECA, WS-ELEC, WS-WELD, etc.)
  • Columns: Week buckets starting from current week
  • Horizon: Configurable 4, 8, 12, or 16 weeks (default: 8)
  • Cell Click: Opens drawer with work order details

Cell Status Colors

GreenAll OFs feasible, no overload
AmberAt risk or approaching limit
RedBlocked or overloaded

Alerts Management

The Alerts module displays system-generated exceptions for material and capacity issues. Access via Operations → Alerts.

Alert Types

Material Alerts

Component not available by planned start date. Shows blocker component, required quantity, and availability date.

Capacity Alerts

Workshop overloaded (>100% capacity). Shows required hours, available hours, and overload percentage.

Alert Severities

Critical (RED)Immediate action required
Warning (AMBER)Monitor closely

Work Orders

View and manage production orders with material feasibility status. Access via Planning Data → Work Orders.

Work Order Status

Feasible

All components available ≥4 days before planned start.

At Risk

Component available within 3-day risk window.

Blocked

Component not available by planned start date.

Simulate Delay Feature

Demonstrate live impact of supply changes (Admin, Global Planner, Workshop Planner only):

  1. Navigate to a work order detail page
  2. Click Simulate Delay button
  3. Select a component from the BOM
  4. Enter a new availability date
  5. Click Apply & Recompute
  6. View updated status and alerts

Components

View all components and their availability status. Access via Planning Data → Components.

  • KPI cards for total, available, pending, unknown components
  • Search by component code or name
  • Lead time indicators (Ready, X days warning)
  • Work order usage count per component

Workshops

View workshop overview and statistics. Access via Planning Data → Workshops.

  • Card-based workshop display
  • Work order count per workshop
  • Total planned hours
  • Assigned planner information

Data Console (Admin Only)

Administrative functions for managing system data. Access via Administration → Data Console.

Load Demo Dataset

Populate system with demonstration data: 7 workshops, 10 work orders, 15 components, 84 capacity records. Triggers validation automatically.

Clear All Data

Remove all data except users and audit logs. Requires confirmation before proceeding.

Validation Engine

The validation engine evaluates material and capacity feasibility for all work orders.

Trigger Sources

  • Manual: Click "Run Validation" button on dashboard
  • Automatic: After Simulate Delay action
  • Automatic: After Load Demo Dataset

Validation Process

  1. Create validation run record
  2. Evaluate all work orders for material feasibility
  3. Evaluate all workshop/weeks for capacity
  4. Generate alerts for exceptions
  5. Compute grid aggregates
  6. Create audit log entry

Audit Logging (Admin Only)

Records all significant system actions for governance and traceability. Access via Administration → Audit Logs.

Logged Actions

Action TypeDescription
RUN_VALIDATIONValidation engine execution
SIMULATE_DELAYComponent date change
SEED_DATADemo dataset loaded
CLEAR_DATADataset cleared
USER_LOGINUser authenticated

Business Rules Reference

Material Feasibility Status

StatusConditionRule
REDBlocker existsavailable_date > planned_start_date
AMBERRisk windowNo blockers, available within 3 days of start
GREENFeasibleAll components available ≥4 days before start

Capacity Calculation

MetricFormula
Load %(required_hours / available_hours) × 100
OverloadLoad % > 100%
Delta Hoursrequired_hours - available_hours