# bartczernicki/decisionintelligence.genai.workshop architecture

> Architecture diagram of the GitHub repository bartczernicki/decisionintelligence.genai.workshop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bartczernicki/decisionintelligence.genai.workshop
- Repository: https://github.com/bartczernicki/decisionintelligence.genai.workshop

## Overview

##### Project type and purpose
- The project is an interactive workshop course designed to demonstrate and experiment with Decision Intelligence concepts using Generative AI.
- Its purpose is to guide diverse users (from non-technical readers to AI engineers) through decision-making frameworks by integrating interactive Jupyter notebooks (via VS Code and .NET Interactive), C# plugins, ML models, and generative AI orchestration (Semantic Kernel, OpenAI).

##### File structure
- Top-level directories include:
- Classes: Contains C# code such as “BaseballHallOfFamePlugin.cs,” which likely extends decision-making functionality.
- Data: Hosts datasets (e.g., the CSV file for MLB batters) used in decision examples.
- Models: Contains ML model files (e.g., an ML.NET file for a generalized additive model) that might be used to support decision analysis.
- Notebooks: Contains all the interactive workshop modules written as Jupyter notebooks that guide users through decision intelligence workflows. They range from introductory decision-making frameworks to deep dives using Semantic Kernel and OpenAI.
- README: Describes the workshop methodology, prerequisites, and module details.
- The structure reflects a modular, layered design where educational content (Notebooks) ties together practical code (Classes), data/model resources (Data, Models), and supporting visuals (Images).

##### README for additional insights
- The README reveals several personas (read, technical, Decision Intelligence AI Engineer), indicating that the design should accommodate both interactive learning (notebooks) and extension points (modifying C# code, decision prompts, and integration with AI APIs).
- There is a significant emphasis on interactive execution in VS Code using .NET Interactive and requirements like Azure OpenAI and Semantic Kernel orchestration.
- The workshop modules are organized sequentially, offering both a conceptual and hands-on approach to decision intelligence.

##### Final advice
- Be as detailed as possible, ensuring every relevant component is represented.

## Diagram (Mermaid)

```mermaid
flowchart TD
    N1["Interactive Notebooks"]:::frontend
    N2["Orchestration Engine (VS Code + .NET Interactive)"]:::orchestration
    N3["C# Plugin Layer"]:::backend
    N4["Data Store (CSV)"]:::backend
    N5["ML Model Store"]:::backend
    N6["External AI Services (Azure OpenAI/Bing Search)"]:::external
    N7["Visual & Documentation Assets"]:::docs

    N1 -->|"executes"| N2
    N2 -->|"invokes"| N3
    N2 -->|"queries"| N4
    N2 -->|"queries"| N5
    N2 -->|"calls"| N6
    N7 -->|"supports"| N1

    click N1 "https://github.com/bartczernicki/decisionintelligence.genai.workshop/tree/main/Notebooks"
    click N2 "https://github.com/bartczernicki/decisionintelligence.genai.workshop/blob/main/Notebooks/local.settings.json"
    click N3 "https://github.com/bartczernicki/decisionintelligence.genai.workshop/blob/main/Classes/BaseballHallOfFamePlugin.cs"
    click N4 "https://github.com/bartczernicki/decisionintelligence.genai.workshop/blob/main/Data/MLBBaseballBattersPositionPlayers.csv"
    click N5 "https://github.com/bartczernicki/decisionintelligence.genai.workshop/blob/main/Models/InductedToHoF-GeneralizedAdditiveModels.mlnet"
    click N7 "https://github.com/bartczernicki/decisionintelligence.genai.workshop/tree/main/Images"

    classDef frontend fill:#8ecae6,stroke:#023047,stroke-width:2px;
    classDef orchestration fill:#ffb703,stroke:#fb8500,stroke-width:2px;
    classDef backend fill:#219ebc,stroke:#023047,stroke-width:2px;
    classDef external fill:#ff4800,stroke:#d62828,stroke-width:2px;
    classDef docs fill:#a8dadc,stroke:#457b9d,stroke-width:2px;
```
