Hugging Face's logo

Spaces:
ascentialabs
/
process-aware-ai
Sleeping

App Files Community
process-aware-ai / DOCS /IS_user_guide.md
borndeveloper's picture
borndeveloper
Deploy Process Aware AI Dashboard without binaries
b4a2e7f
preview code
|
Raw
History Blame Contribute Delete
2.34 kB

User Guide: Process-Aware AI Frontend

1. Dashboard (The Control Tower)

The landing page provides a high-level view of manufacturing health.

  • Total Trends: Shows overall volume, yield, and efficiency.
  • Norm Deviations: Highlights articles where actual performance deviates significantly from standard norms.
  • Color Coding:
    • Red: Urgent attention needed (Low yield / High failure).
    • Amber: Warning signs.
    • Green: Performing well.

2. Predictions & Insights Tab

This is the main workspace for Planners to analyze specific articles.

How to use:

  1. Search: Enter an Article ID (e.g., 18006BA) in the search bar.
  2. View Analysis:
    • Norm Rules: See the applicable standard rule (e.g., "4% for >3000m").
    • Success Rate: Check the color-coded indicator.
      • Red (<70%): Be careful! High risk of short-fall.
      • Green (>90%): Reliable article.
    • Median Used: See what buffer actually works in practice.
  3. Generate Recommendation:
    • Enter the Order Quantity in meters.
    • Press Enter.
    • Review the AI Recommended issuance vs. Norm-Based.
    • Read the Explanation to understand why the AI made that suggestion.

Visualizations

  • Waterfall Chart: Shows "Loss Attribution" — where did the material go? (Process loss vs. Planner cuts).
  • Risk Fingerprint: Summary metrics (Reliability, Sensitivity to Policy Changes).

3. Playground (Scenario Simulation)

A sandbox for "What-If" analysis.

Features:

  • Simulate Norm Changes: "What if we increased the standard norm for this article to 6%?"
  • Impact Analysis:
    • Financial: How much would raw material cost increase?
    • Operational: How many shortfalls would be prevented?
  • ROI Calculation: Helps justify policy changes to management.

4. Best Practices

  • Trust the Median: If the AI says "Successful orders used 2.8%," that's a strong signal that 2.8% is sufficient, even if the norm is 5%.
  • Heed the Red: If Success Rate is Red, do NOT under-issue. The AI creates a safety buffer for a reason.
  • Use the Explanation: Copy-paste the AI explanation into your planning notes to document why you chose a specific issuance quantity.