DOCS/IS_user_guide.md

# 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.