# ather-techie/rag-interview-system architecture

> Architecture diagram of the GitHub repository ather-techie/rag-interview-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ather-techie/rag-interview-system
- Repository: https://github.com/ather-techie/rag-interview-system

## Overview

This repository is an interview-prep resource and browser-based practice site, not a deployed RAG application. A learner studies the architecture and production-topic material, drills its question bank with filters and flashcards/MCQs, or takes a configurable assessment and reviews readiness results. The README also documents hands-on Python labs, evaluation guidance, patterns, and Microsoft-stack material. The browser quiz and assessment modules are sampled; documentation branches and lab notebooks are represented at their exact tree paths, but their internal links and implementation details are not inferred.

Main entry points: [`scripts/assessment.js`](https://github.com/ather-techie/rag-interview-system/blob/main/scripts/assessment.js) (Self-Assessment), [`scripts/quiz.js`](https://github.com/ather-techie/rag-interview-system/blob/main/scripts/quiz.js) (Practice Quiz), [`02_interview_bank`](https://github.com/ather-techie/rag-interview-system/tree/main/02_interview_bank) (Architecture Bank), [`03_failure_modes`](https://github.com/ather-techie/rag-interview-system/tree/main/03_failure_modes) (Failure Modes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Study Content"]
  node_overview["Learning Guides"]
  node_concepts["RAG Concepts"]
  node_architectures["Architecture Bank"]
  node_failures["Failure Modes"]
  node_microsoft["Microsoft Stack"]
  node_cheatsheet["RAG Cheatsheet<br/>[CHEATSHEET.md]"]
end

subgraph group_practice["Browser Practice"]
  node_quiz["Practice Quiz<br/>[quiz.js]"]
  node_quiz_helpers["Quiz Helpers<br/>[quiz-common.js]"]
  node_questions["Question Parser<br/>[questions.mjs]"]
  node_assessment["Self-Assessment<br/>[assessment.js]"]
  node_assessment_results["Readiness Results<br/>[assessment.js]"]
end

subgraph group_labs["Labs And Patterns"]
  node_labs["Python Labs"]
  node_patterns["RAG Patterns"]
  node_graph_guides["Graph Guides"]
end

subgraph group_evaluation["Evaluation Resources"]
  node_evaluation_guides["Evaluation Guides"]
  node_tools["Tool Comparisons"]
  node_decisions["Decision System"]
end

node_learner(("Learner"))

node_learner -->|"studies roadmap"| node_overview
node_learner -->|"studies concepts"| node_concepts
node_learner -->|"studies architectures"| node_architectures
node_learner -->|"studies failure modes"| node_failures
node_learner -->|"studies stack"| node_microsoft
node_learner -->|"compares RAG types"| node_cheatsheet
node_learner -->|"drills questions"| node_quiz
node_architectures -->|"supplies Q&amp;A"| node_quiz
node_failures -->|"supplies Q&amp;A"| node_quiz
node_quiz -->|"uses helpers"| node_quiz_helpers
node_learner -->|"starts assessment"| node_assessment
node_assessment -->|"uses helpers"| node_quiz_helpers
node_assessment -->|"calculates results"| node_assessment_results
node_assessment_results -->|"shows readiness"| node_learner
node_learner -->|"runs labs"| node_labs
node_learner -->|"studies patterns"| node_patterns
node_learner -->|"studies graph RAG"| node_graph_guides
node_learner -->|"studies evaluation"| node_evaluation_guides
node_learner -->|"compares tools"| node_tools
node_learner -->|"studies decisions"| node_decisions
node_questions -.->|"parses question format"| node_assessment

click node_overview "https://github.com/ather-techie/rag-interview-system/tree/main/00_overview"
click node_concepts "https://github.com/ather-techie/rag-interview-system/tree/main/01_concepts"
click node_architectures "https://github.com/ather-techie/rag-interview-system/tree/main/02_interview_bank"
click node_failures "https://github.com/ather-techie/rag-interview-system/tree/main/03_failure_modes"
click node_microsoft "https://github.com/ather-techie/rag-interview-system/tree/main/11_microsoft_stack"
click node_cheatsheet "https://github.com/ather-techie/rag-interview-system/blob/main/cheatsheets/CHEATSHEET.md"
click node_quiz "https://github.com/ather-techie/rag-interview-system/blob/main/scripts/quiz.js"
click node_quiz_helpers "https://github.com/ather-techie/rag-interview-system/blob/main/scripts/quiz-common.js"
click node_questions "https://github.com/ather-techie/rag-interview-system/blob/main/scripts/lib/questions.mjs"
click node_assessment "https://github.com/ather-techie/rag-interview-system/blob/main/scripts/assessment.js"
click node_assessment_results "https://github.com/ather-techie/rag-interview-system/blob/main/scripts/assessment.js"
click node_labs "https://github.com/ather-techie/rag-interview-system/tree/main/06_labs_py"
click node_patterns "https://github.com/ather-techie/rag-interview-system/tree/main/04_patterns"
click node_graph_guides "https://github.com/ather-techie/rag-interview-system/tree/main/05_graphs"
click node_evaluation_guides "https://github.com/ather-techie/rag-interview-system/tree/main/08_evaluation"
click node_tools "https://github.com/ather-techie/rag-interview-system/tree/main/09_tools"
click node_decisions "https://github.com/ather-techie/rag-interview-system/tree/main/10_decision_system"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_overview,node_concepts,node_architectures,node_failures,node_microsoft,node_cheatsheet toneBlue
class node_quiz,node_quiz_helpers,node_questions,node_assessment,node_assessment_results toneAmber
class node_labs,node_patterns,node_graph_guides toneMint
class node_evaluation_guides,node_tools,node_decisions toneRose
class node_learner toneIndigo
```

## Components

### Study Content

- [Learning Guides](https://github.com/ather-techie/rag-interview-system/tree/main/00_overview): `00_overview`
- [RAG Concepts](https://github.com/ather-techie/rag-interview-system/tree/main/01_concepts): `01_concepts`
- [Architecture Bank](https://github.com/ather-techie/rag-interview-system/tree/main/02_interview_bank): `02_interview_bank`
- [Failure Modes](https://github.com/ather-techie/rag-interview-system/tree/main/03_failure_modes): `03_failure_modes`
- [Microsoft Stack](https://github.com/ather-techie/rag-interview-system/tree/main/11_microsoft_stack): `11_microsoft_stack`
- [RAG Cheatsheet](https://github.com/ather-techie/rag-interview-system/blob/main/cheatsheets/CHEATSHEET.md): `cheatsheets/CHEATSHEET.md`

### Browser Practice

- [Practice Quiz](https://github.com/ather-techie/rag-interview-system/blob/main/scripts/quiz.js): `scripts/quiz.js`
- [Quiz Helpers](https://github.com/ather-techie/rag-interview-system/blob/main/scripts/quiz-common.js): `scripts/quiz-common.js`
- [Question Parser](https://github.com/ather-techie/rag-interview-system/blob/main/scripts/lib/questions.mjs): `scripts/lib/questions.mjs`
- [Self-Assessment](https://github.com/ather-techie/rag-interview-system/blob/main/scripts/assessment.js): `scripts/assessment.js`
- [Readiness Results](https://github.com/ather-techie/rag-interview-system/blob/main/scripts/assessment.js): `scripts/assessment.js`

### Labs And Patterns

- [Python Labs](https://github.com/ather-techie/rag-interview-system/tree/main/06_labs_py): `06_labs_py`
- [RAG Patterns](https://github.com/ather-techie/rag-interview-system/tree/main/04_patterns): `04_patterns`
- [Graph Guides](https://github.com/ather-techie/rag-interview-system/tree/main/05_graphs): `05_graphs`

### Evaluation Resources

- [Evaluation Guides](https://github.com/ather-techie/rag-interview-system/tree/main/08_evaluation): `08_evaluation`
- [Tool Comparisons](https://github.com/ather-techie/rag-interview-system/tree/main/09_tools): `09_tools`
- [Decision System](https://github.com/ather-techie/rag-interview-system/tree/main/10_decision_system): `10_decision_system`

### Other components

- **Learner**

## Connections

- Learner → Learning Guides: studies roadmap (evidence: `README.md`)
- Learner → RAG Concepts: studies concepts (evidence: `README.md`)
- Learner → Architecture Bank: studies architectures (evidence: `README.md`)
- Learner → Failure Modes: studies failure modes (evidence: `README.md`)
- Learner → Microsoft Stack: studies stack (evidence: `README.md`)
- Learner → RAG Cheatsheet: compares RAG types (evidence: `README.md`)
- Learner → Practice Quiz: drills questions (evidence: `README.md`)
- Architecture Bank → Practice Quiz: supplies Q&A (evidence: `README.md`)
- Failure Modes → Practice Quiz: supplies Q&A (evidence: `README.md`)
- Practice Quiz → Quiz Helpers: uses helpers (evidence: `scripts/quiz.js`)
- Learner → Self-Assessment: starts assessment (evidence: `README.md`)
- Self-Assessment → Quiz Helpers: uses helpers (evidence: `scripts/quiz-common.js`)
- Self-Assessment → Readiness Results: calculates results (evidence: `scripts/assessment.js`)
- Readiness Results → Learner: shows readiness (evidence: `README.md`)
- Learner → Python Labs: runs labs (evidence: `README.md`)
- Learner → RAG Patterns: studies patterns (evidence: `README.md`)
- Learner → Graph Guides: studies graph RAG (evidence: `README.md`)
- Learner → Evaluation Guides: studies evaluation (evidence: `README.md`)
- Learner → Tool Comparisons: compares tools (evidence: `README.md`)
- Learner → Decision System: studies decisions (evidence: `README.md`)
- Question Parser → Self-Assessment: parses question format
