graph TB
subgraph "DATA LAYER"
A1[Internal Signals
- Daily Sales by Store-SKU-Style-Size
- Inventory Positions
- Stock-outs & Returns
- POS Traffic & Conversion
- PO/ASN Status]
A2[External Signals
- Weather by Store Location
- Local Events Calendar
- Competitive Activity
- Economic Indicators
- Social Media Trends]
A3[Historical Context
- Prior Year Sales
- Forecast Accuracy History
- Seasonality Patterns
- Promotion Impact]
A4[Preseason Forecast
- 3-Month Forecast by Week
- Store-SKU-Style-Size Level
- Assumptions & Drivers]
end
subgraph "MULTI-DIMENSIONAL KNOWLEDGE GRAPH"
B1[Product Dimension<br/>Size → Style → Category<br/>Attributes: Price, Fit, Color]
B2[Store Dimension<br/>Store → Cluster → Region<br/>Attributes: Size, Demo, Performance]
B3[Time Dimension<br/>Week → Month → Season<br/>Attributes: Phase, Promo Calendar]
B4[Customer Dimension<br/>Segment → Cohort → Behavior<br/>Attributes: Loyalty, Basket]
B5[Relationship Edges<br/>- Substitutability<br/>- Cannibalization<br/>- Correlation<br/>- Causality]
B1 -.-> B5
B2 -.-> B5
B3 -.-> B5
B4 -.-> B5
end
subgraph "SENSE ENGINE - Step A"
C1[Data Quality Checker<br/>- Missing data flags<br/>- Outlier detection<br/>- Stock-out impact assessment]
C2[Signal Aggregator<br/>- Normalize metrics<br/>- Time-align data<br/>- Calculate derived KPIs]
C3[Variance Calculator<br/>- Actual vs Forecast<br/>- Week-over-Week trends<br/>- Store cluster comparison]
end
subgraph "UNDERSTAND ENGINE - Step B"
D1[Graph Mapper<br/>Map signals to KG nodes<br/>Identify impacted relationships]
D2[Causal Chain Builder<br/>Event → Driver → Impact<br/>Propagate through graph]
D3[Pattern Recognizer<br/>- Similar historical scenarios<br/>- Anomaly classification<br/>- Trend identification]
D4[Forecast Performance Analyzer<br/>- MAPE by dimension<br/>- Bias detection<br/>- Tracking signals]
end
subgraph "REASON ENGINE - Step C"
E1[Forecast Adjustment Generator<br/>- Magnitude options +/- X%<br/>- Temporal shifts<br/>- Blend weights]
E2[Aggregation Strategy<br/>- Size-level adjustments<br/>- Style-level rollups<br/>- Store cluster amendments]
E3[Supply Chain Action Generator<br/>- Replenishment adjustments<br/>- Allocation changes<br/>- Expedite/delay orders]
E4[Confidence Scorer<br/>- Statistical significance<br/>- Data quality weight<br/>- Historical accuracy]
end
subgraph "DECIDE ENGINE - Step D"
F1[Multi-Criteria Scorer<br/>Service Level Impact<br/>Revenue/Margin Impact<br/>Inventory Cost<br/>Amendment Complexity<br/>Risk Reduction]
F2[Policy Engine<br/>- Threshold rules<br/>- Business constraints<br/>- Authorization levels]
F3[Recommendation Generator<br/>- Ranked options<br/>- Confidence intervals<br/>- Trade-off analysis]
F4[Human Review Queue<br/>- High-impact amendments<br/>- Low-confidence scenarios<br/>- Cross-functional approval]
end
subgraph "EXECUTION LAYER"
G1[Forecast System Update]
G2[Supply Chain System Trigger]
G3[Alert & Notification]
G4[Audit Log & Lineage]
end
A1 --> C1
A2 --> C1
A3 --> C2
A4 --> C3
C1 --> D1
C2 --> D1
C3 --> D4
B1 --> D1
B2 --> D1
B3 --> D1
B4 --> D1
D1 --> D2
D2 --> D3
D3 --> E1
D4 --> E1
E1 --> E2
E2 --> E3
E3 --> E4
E4 --> F1
F1 --> F2
F2 --> F3
F3 --> F4
F4 --> G1
F4 --> G2
F4 --> G3
F4 --> G4
G4 -.Feedback Loop.-> A3
style A1 fill:#e1f5ff
style A2 fill:#e1f5ff
style A3 fill:#fff4e1
style A4 fill:#fff4e1
style B5 fill:#ffe1f5
style C1 fill:#f0f0f0
style D2 fill:#e1ffe1
style E4 fill:#ffe1e1
style F4 fill:#ffebe12. DETAILED DAILY AGENTIC LOOP FLOWCHARTmermaidflowchart TD
Start([Daily Agent Trigger<br/>Time: 6 AM]) --> A1
subgraph "STEP A: SENSE - Collect Signals"
A1[Pull Yesterday's Sales Data<br/>Store-SKU-Style-Size Level]
A2{Data Quality<br/>Check Pass?}
A3[Flag Data Quality Issues<br/>- Missing stores<br/>- Stock-out events<br/>- System errors]
A4[Calculate Daily Metrics<br/>- Units Sold<br/>- Sell-through Rate<br/>- Returns<br/>- Inventory Position]
A5[Pull External Context<br/>- Weather anomalies<br/>- Local events<br/>- Competitor promos]
A6[Aggregate to Evaluation Level<br/>Week-to-Date by Store-SKU]
A1 --> A2
A2 -->|No| A3
A2 -->|Yes| A4
A3 --> A4
A4 --> A5
A5 --> A6
end
subgraph "STEP B: UNDERSTAND - Ground in KG"
B1[Map to Knowledge Graph<br/>Identify affected nodes:<br/>- Which SKUs/Styles<br/>- Which Store Clusters<br/>- Which Week in Season]
B2[Calculate Variance Metrics<br/>Actual vs Forecast:<br/>- Absolute variance<br/>- % variance<br/>- Tracking signal<br/>- MAPE]
B3{Variance > Threshold?<br/>e.g. >15% or<br/>Tracking Signal >4}
B4[Build Causal Chain<br/>Why is variance occurring?<br/>- Demand shift<br/>- Inventory constraint<br/>- External event<br/>- Forecast error]
B5[Compare to Similar Entities<br/>- Same style, other sizes<br/>- Same store, other styles<br/>- Similar stores, same SKU]
B6[Pattern Classification<br/>- Systematic bias<br/>- Random noise<br/>- Structural shift<br/>- Temporary anomaly]
B7[No Action Needed<br/>Continue Monitoring]
A6 --> B1
B1 --> B2
B2 --> B3
B3 -->|No| B7
B3 -->|Yes| B4
B4 --> B5
B5 --> B6
end
subgraph "STEP C: REASON - Generate Candidate Actions"
C1{Pattern Type?}
C2[Generate Forecast Amendments<br/>SYSTEMATIC BIAS:<br/>- Adjust all future weeks<br/>- Apply bias correction<br/>- Update trend parameter]
C3[Generate Forecast Amendments<br/>STRUCTURAL SHIFT:<br/>- Re-forecast remaining weeks<br/>- Apply new demand curve<br/>- Consider cannibalization]
C4[Generate Forecast Amendments<br/>TEMPORARY ANOMALY:<br/>- Adjust next 1-2 weeks only<br/>- Return to baseline after<br/>- Document exception]
C5[For Each Amendment Option<br/>Generate Supply Chain Actions:<br/>- Replenishment qty adjustment<br/>- Allocation rebalancing<br/>- Expedite/delay orders<br/>- Store transfer triggers]
C6[Calculate Confidence Score<br/>Factors:<br/>- Data quality: 0-1<br/>- Historical accuracy: 0-1<br/>- Sample size: 0-1<br/>- Pattern clarity: 0-1<br/>Final: Weighted average]
B6 --> C1
C1 -->|Systematic| C2
C1 -->|Structural| C3
C1 -->|Temporary| C4
C1 -->|Noise| B7
C2 --> C5
C3 --> C5
C4 --> C5
C5 --> C6
end
subgraph "STEP D: DECIDE - Score & Route to Human"
D1[Multi-Criteria Scoring<br/>For each option calculate:<br/>━━━━━━━━━━━━━━━━<br/>• Service Level: 0-100<br/>• Revenue Impact: $$$<br/>• Margin Impact: $$$<br/>• Inventory Cost: $$$<br/>• Complexity: 1-5<br/>• Risk: 1-5]
D2[Apply Policy Rules<br/>Constraints:<br/>- Max amendment: ±40%<br/>- Min confidence: 0.6<br/>- Inventory limits<br/>- Lead time feasibility]
D3{Policy<br/>Violations?}
D4[Filter Invalid Options<br/>Mark as non-viable]
D5[Rank Viable Options<br/>Weighted score:<br/>- Revenue: 35%<br/>- Service: 30%<br/>- Cost: 20%<br/>- Risk: 15%]
D6{Auto-Execute<br/>Criteria Met?<br/>Confidence >0.8<br/>Impact <$50K<br/>Amendment <20%}
D7[Generate Recommendation Package<br/>━━━━━━━━━━━━━━━━<br/>• Top 3 ranked options<br/>• Confidence intervals<br/>• Trade-off matrix<br/>• Risk assessment<br/>• Similar past scenarios<br/>• Recommended action]
D8[Route to Human Review Queue<br/>Priority based on:<br/>- Revenue at stake<br/>- Time sensitivity<br/>- Complexity level]
D9[Auto-Execute Amendment<br/>+ Supply Chain Actions<br/>+ Notify stakeholders<br/>+ Log decision]
C6 --> D1
D1 --> D2
D2 --> D3
D3 -->|Yes| D4
D3 -->|No| D5
D4 --> D5
D5 --> D6
D6 -->|Yes| D9
D6 -->|No| D7
D7 --> D8
end
subgraph "HUMAN DECISION INTERFACE"
H1[Planner Reviews Recommendation<br/>Reviews: Context, Options, Trade-offs]
H2{Decision}
H3[Approve Option 1, 2, or 3]
H4[Modify Parameters]
H5[Reject - Override with Manual]
H6[Request More Analysis]
D8 --> H1
H1 --> H2
H2 --> H3
H2 --> H4
H2 --> H5
H2 --> H6
H6 -.-> C5
end
subgraph "EXECUTION & FEEDBACK"
E1[Execute Approved Action<br/>1. Update forecast system<br/>2. Trigger supply chain changes<br/>3. Set monitoring flags]
E2[Log Complete Lineage<br/>- Input signals<br/>- Reasoning chain<br/>- Decision factors<br/>- Human override reason if any]
E3[Schedule Follow-up Check<br/>Monitor amended SKUs more frequently]
E4[Update Historical Performance<br/>Track amendment accuracy<br/>Feed into learning loop]
H3 --> E1
H4 --> E1
H5 --> E1
D9 --> E1
E1 --> E2
E2 --> E3
E3 --> E4
end
E4 --> End([End Daily Loop<br/>Next run: Tomorrow 6 AM])
B7 --> End
style A2 fill:#ffe1e1
style B3 fill:#ffe1e1
style C1 fill:#fff4e1
style D3 fill:#ffe1e1
style D6 fill:#ffe1e1
style H2 fill:#e1f5ff
style E2 fill:#e1ffe1

