flowchart TB
  subgraph archive["This repo — ai-engineering-portfolio"]
    L["lectures/ 01–11"]
    H["homework/ hw01–hw07"]
    CAP["incident-assistant-rag<br/>FastAPI · OpenAI · FAISS"]
    ITER["incident-rag-bedrock<br/>Bedrock KB iteration"]
  end
  subgraph external["flagships/ → standalone repos"]
    PITER["piter-aiops<br/>Bedrock Agent + tools"]
    HIND["hindsight<br/>n8n + Gemini pipeline"]
    BOT["course-assistant-bot<br/>Telegram HE/EN"]
  end
  L --> H --> CAP
  ITER -.->|evolved into| PITER
  H --> BOT
  CAP -.->|parallel track| PITER
  classDef archive fill:#11233a,stroke:#3b82f6,color:#cfe0ff
  classDef cap fill:#1e1430,stroke:#a855f7,color:#e6d6ff
  classDef ext fill:#2a2010,stroke:#f59e0b,color:#ffe6bf
  class L,H archive
  class CAP,ITER cap
  class PITER,HIND,BOT ext

flowchart LR
  subgraph trackA [Track A — Local FAISS]
    A1[Upload PDF] --> A2[Chunk + embed]
    A2 --> A3[FAISS index]
    A3 --> A4[Similarity search]
    A4 --> A5{Above threshold?}
    A5 -->|yes| A6[OpenAI chat + sources]
    A5 -->|no| A7[Fixed refusal]
  end
  subgraph trackB [Track B — AWS Bedrock]
    B1[S3 corpus] --> B2[Bedrock KB sync]
    B2 --> B3[RetrieveAndGenerate]
    B3 --> B4{Confidence OK?}
    B4 -->|yes| B5[Grounded answer]
    B4 -->|no| B6[Refusal]
    B2 --> B7[Bedrock Agent + Lambda tools]
    B7 --> B8[PITER AiOps]
  end
  trackA --> CAP[incident-assistant-rag]
  trackB --> BED[incident-rag-bedrock]
  BED --> B8

sequenceDiagram
  autonumber
  participant U as Operator
  participant UI as React UI
  participant API as FastAPI
  participant IDX as FAISS index
  participant LLM as OpenAI

  U->>UI: Upload runbook PDF
  UI->>API: POST /documents
  API->>IDX: Chunk + embed + store
  U->>UI: Ask incident question
  UI->>API: POST /chat
  API->>IDX: Similarity search
  alt hits above threshold
    API->>LLM: Prompt + retrieved chunks
    LLM-->>API: Grounded answer
    API-->>UI: Answer + sources + scores
  else no context
    API-->>UI: Fixed refusal — no LLM call
  end

flowchart TB
  subgraph stage1 [Stage 1 Foundations]
    L01[L01 Jupyter Python]
    L02[L02 Python intro]
    L03[L03 OOP NumPy]
    HW01[hw01 Jupyter]
    HW02[hw02 Python scripts]
    HW03[hw03 Titanic CLI]
    L01 --> L02 --> L03
    L01 --> HW01
    L02 --> HW02
    L03 --> HW03
  end

  subgraph stage2 [Stage 2 RAG and Web]
    L04[L04 NLP FAISS RAG]
    L05[L05 Flask]
    L06[L06 Flask SQLite RAG]
    HW04[hw04 RAG app]
    L04 --> L05 --> L06
    L04 --> HW04
    L06 --> HW04
  end

  subgraph stage3 [Stage 3 Ops and Agents]
    L07[L07 Docker AWS]
    L08[L08 MCP]
    L09[L09 Bedrock n8n]
    L10[L10 LangChain LangGraph]
    L11[L11 Open WebUI]
    HW05[hw05 EC2 Nginx]
    HW06[hw06 n8n agent]
    HW07[hw07 Open WebUI tools]
    L07 --> HW05
    L09 --> HW06
    L08 --> L11
    L11 --> HW07
    L10 --> HW07
  end

  subgraph stage4 [Stage 4 Capstone and Flagships]
    CAP[incident-assistant-rag]
    BED[incident-rag-bedrock]
    PITER[piter-aiops external]
    HW04 -.-> CAP
    L06 -.-> CAP
    BED -.-> PITER
  end

  stage1 --> stage2 --> stage3 --> stage4

  classDef foundations fill:#11233a,stroke:#3b82f6,color:#cfe0ff
  classDef rag fill:#1a2e1a,stroke:#22c55e,color:#dcfce7
  classDef ops fill:#2a2010,stroke:#f59e0b,color:#ffe6bf
  classDef cap fill:#1e1430,stroke:#a855f7,color:#e6d6ff
  class L01,L02,L03,HW01,HW02,HW03 foundations
  class L04,L05,L06,HW04 rag
  class L07,L08,L09,L10,L11,HW05,HW06,HW07 ops
  class CAP,BED,PITER cap

Source: docs/diagrams/learning-path.mermaid

flowchart LR
  subgraph ide [Agent IDEs]
    Cursor[Cursor]
    Claude[Claude Code]
  end
  subgraph mcp [MCP layer — .mcp.json]
    CT[course-tools]
    PW[playwright]
    KG[kaggle]
    AWK[aws-knowledge]
    AWA[aws-api]
    BKB[bedrock-kb]
    N8N[n8n-workflows]
    LOV[lovable]
  end
  subgraph use [Used for]
    L08[Lecture 08 demo]
    E2E[hw07 UI capture]
    DS[hw07 datasets]
    DOC[AWS docs Q&A]
    BR[Bedrock KB labs]
    HW6[hw06 workflows]
  end
  Cursor --> mcp
  Claude --> mcp
  CT --> L08
  PW --> E2E
  KG --> DS
  AWK --> DOC
  BKB --> BR
  N8N --> HW6