# kunal-kushwaha/dsa-bootcamp-java architecture

> Architecture diagram of the GitHub repository kunal-kushwaha/dsa-bootcamp-java, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kunal-kushwaha/dsa-bootcamp-java
- Repository: https://github.com/kunal-kushwaha/dsa-bootcamp-java

## Overview

#### Purpose and Repository Shape
This is a Java DSA/interview-preparation course repository, not a unified application or library. It combines ordered curriculum material, standalone Java demonstrations, and assignments. The progression is defined by `SYLLABUS.md`, `assignments/`, and sequential `lectures/` directories.

#### Entry Points and Execution Model
Each lecture code folder is independently runnable; many contain a `Main.java` or topic-specific executable such as `StackMain.java` and `QueueMain.java`. There is no root build, package, deployment entry point, or shared runtime. Java code is generally organized under `com.kunal` for IntelliJ-style projects, while later examples are often flat Java source folders.
- `lectures/05-first-java-program/first-idea-program/src/com/kunal/Main.java`
- `lectures/19-stacks-n-queues/code/src/com/kunal/StackMain.java`
- `lectures/20-trees/code/introduction/Main.java`

#### Curriculum and Assignment Boundary
Lecture directories are the canonical instructional sequence: concepts, PDFs/notes, then illustrative implementations. Assignments are separate Markdown problem sets mapped to early/mid-course topics; solutions are intentionally not integrated into the repository.
- `assignments/01-flow-of-program.md`
- `assignments/14-oop.md`
- `assignments/18-heaps.md`

#### Foundational Java and Algorithm Stages
The first stages establish Java syntax, console input/output, branching, methods, arrays, then searching and elementary sorting. Examples are small self-contained programs that accept values or initialize in-memory inputs, run an algorithm, and print results.
- `lectures/05-first-java-program/first-idea-program/src/com/kunal/Inputs.java`
- `lectures/09-linear search/code/src/com/kunal/SearchIn2DArray.java`
- `lectures/10-binary search/code/src/com/kunal/BinarySearch.java`

#### Recursive, Mathematical, and Complexity Techniques
Recursion is the first substantial internal organization: packages separate introductory recursion, arrays, strings, backtracking, and recursive sorting. Later math/bitwise and complexity lessons provide supporting algorithmic techniques rather than reusable shared utilities.
- `lectures/14-recursion/code/src/com/kunal/backtracking/SudokuSolver.java`
- `lectures/14-recursion/code/src/com/kunal/sorting/MergeSort.java`
- `lectures/16-math/code/src/com/kunal/maths/Seive.java`

#### Object Modeling and Core Data Structures
OOP lessons model language mechanisms—inheritance, polymorphism, interfaces, generics, exceptions—through deliberately local example class graphs. Data-structure lessons implement mutable structures and expose operations through their local drivers; this is the principal code dependency boundary within each topic.
- `lectures/17-oop/code/src/com/kunal/properties/inheritance/Box.java`
- `lectures/18-linkedlist/code/src/com/kunal/LL.java`
- `lectures/19-stacks-n-queues/code/src/com/kunal/CustomStack.java`

#### Advanced Structures and Algorithms
The later curriculum expands into trees, heaps, hash maps, advanced sorting, compression, and square-root decomposition. Implementations remain independently scoped per lesson; for example, trees include BST, AVL, segment-tree, traversal, and interview-question variants rather than one common tree package.
- `lectures/20-trees/code/AVL/AVL.java`
- `lectures/20-trees/code/Segment trees/SegmentTree.java`
- `lectures/27-huffman-coding/code/HuffmanCoder.java`

#### Runtime, Infrastructure, and External Services
Material runtime is the Java/JDK standard library, exercised as console programs; IDE metadata indicates IntelliJ modules and some Eclipse/Replit project artifacts. There are no declared third-party dependencies, databases, APIs, CI/CD, cloud infrastructure, or persistent service integrations. The README links externally to YouTube/course content, while repository-local PDFs and notes are the primary learning assets.
- `README.md`
- `lectures/20-trees/code/AVL/.project`
- `lectures/23-file handling/code/Output.java`

Main entry points: [`lectures/20-trees/code/introduction/Main.java`](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/20-trees/code/introduction/Main.java) (Trees), [`lectures/05-first-java-program/first-idea-program/src/com/kunal/Main.java`](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/05-first-java-program/first-idea-program/src/com/kunal/Main.java) (Java basics), [`SYLLABUS.md`](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/SYLLABUS.md) (Course syllabus), [`assignments/01-flow-of-program.md`](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/assignments/01-flow-of-program.md) (Assignments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_curriculum["Curriculum"]
  node_syllabus["Course syllabus<br/>curriculum index<br/>[SYLLABUS.md]"]
  node_lecture_sequence["Lecture sequence<br/>lesson directories"]
  node_assignments["Assignments<br/>Markdown problem sets"]
  node_oop_assignment["OOP assignment<br/>problem set<br/>[14-oop.md]"]
  node_heaps_assignment["Heaps assignment<br/>problem set<br/>[18-heaps.md]"]
  node_readme["Repository README<br/>course links<br/>[README.md]"]
end

subgraph group_foundations["Foundations"]
  node_java_basics["Java basics<br/>console example<br/>[Main.java]"]
  node_console_input["Input examples<br/>console example<br/>[Inputs.java]"]
  node_searching["Searching<br/>algorithm examples"]
  node_binary_search["Binary search<br/>algorithm example<br/>[BinarySearch.java]"]
  node_recursion["Recursion and backtracking<br/>package-organized algorithms<br/>[SudokuSolver.java]"]
  node_merge_sort["Recursive sorting<br/>algorithm example<br/>[MergeSort.java]"]
  node_math["Math and bitwise<br/>algorithm examples<br/>[Seive.java]"]
end

subgraph group_structures["Data Structures"]
  node_oop["OOP modeling<br/>local class graphs<br/>[Box.java]"]
  node_linked_lists["Linked lists<br/>mutable structure<br/>[LL.java]"]
  node_stacks_queues["Stacks and queues<br/>structure and driver<br/>[CustomStack.java]"]
  node_stack_driver["Stack driver<br/>Java entry point<br/>[StackMain.java]"]
end

subgraph group_advanced["Advanced Topics"]
  node_trees["Trees<br/>structure implementations<br/>[Main.java]"]
  node_avl["AVL tree<br/>balanced tree<br/>[AVL.java]"]
  node_segment_tree["Segment tree<br/>range-query structure<br/>[SegmentTree.java]"]
  node_huffman["Huffman coding<br/>compression algorithm<br/>[HuffmanCoder.java]"]
end

node_java_runtime(("Java/JDK runtime<br/>standard library and console"))

node_readme -->|"orients learners"| node_syllabus
node_syllabus -->|"orders"| node_lecture_sequence
node_syllabus -->|"maps topics to"| node_assignments
node_assignments -->|"includes"| node_oop_assignment
node_assignments -->|"includes"| node_heaps_assignment
node_lecture_sequence -->|"begins with"| node_java_basics
node_java_basics -->|"includes"| node_console_input
node_java_basics -->|"progresses to"| node_searching
node_searching -->|"includes"| node_binary_search
node_searching -->|"precedes"| node_recursion
node_recursion -->|"implements"| node_merge_sort
node_recursion -->|"precedes"| node_math
node_math -->|"precedes"| node_oop
node_oop -->|"precedes"| node_linked_lists
node_linked_lists -->|"precedes"| node_stacks_queues
node_stacks_queues -->|"exercised by"| node_stack_driver
node_stacks_queues -->|"precedes"| node_trees
node_trees -->|"includes"| node_avl
node_trees -->|"includes"| node_segment_tree
node_trees -->|"leads to"| node_huffman
node_java_runtime -.->|"runs"| node_java_basics
node_java_runtime -.->|"runs"| node_stack_driver
node_java_runtime -.->|"runs"| node_trees
node_java_runtime -.->|"runs"| node_huffman

click node_syllabus "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/SYLLABUS.md"
click node_assignments "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/assignments/01-flow-of-program.md"
click node_oop_assignment "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/assignments/14-oop.md"
click node_heaps_assignment "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/assignments/18-heaps.md"
click node_java_basics "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/05-first-java-program/first-idea-program/src/com/kunal/Main.java"
click node_console_input "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/05-first-java-program/first-idea-program/src/com/kunal/Inputs.java"
click node_searching "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/09-linear%20search/code/src/com/kunal/SearchIn2DArray.java"
click node_binary_search "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/10-binary%20search/code/src/com/kunal/BinarySearch.java"
click node_recursion "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/14-recursion/code/src/com/kunal/backtracking/SudokuSolver.java"
click node_merge_sort "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/14-recursion/code/src/com/kunal/sorting/MergeSort.java"
click node_math "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/16-math/code/src/com/kunal/maths/Seive.java"
click node_oop "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/17-oop/code/src/com/kunal/properties/inheritance/Box.java"
click node_linked_lists "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/18-linkedlist/code/src/com/kunal/LL.java"
click node_stacks_queues "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/19-stacks-n-queues/code/src/com/kunal/CustomStack.java"
click node_stack_driver "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/19-stacks-n-queues/code/src/com/kunal/StackMain.java"
click node_trees "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/20-trees/code/introduction/Main.java"
click node_avl "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/20-trees/code/AVL/AVL.java"
click node_segment_tree "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/20-trees/code/Segment%20trees/SegmentTree.java"
click node_huffman "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/27-huffman-coding/code/HuffmanCoder.java"
click node_readme "https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/README.md"

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_syllabus,node_lecture_sequence,node_assignments,node_oop_assignment,node_heaps_assignment,node_readme toneBlue
class node_java_basics,node_console_input,node_searching,node_binary_search,node_recursion,node_merge_sort,node_math toneAmber
class node_oop,node_linked_lists,node_stacks_queues,node_stack_driver toneMint
class node_trees,node_avl,node_segment_tree,node_huffman toneRose
class node_java_runtime toneNeutral
```

## Components

### Curriculum

Ordered learning materials and problem sets.

- [Course syllabus](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/SYLLABUS.md): curriculum index · Defines the instructional progression. · `SYLLABUS.md`
- **Lecture sequence**: lesson directories · Concept notes, PDFs, and runnable demonstrations.
- [Assignments](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/assignments/01-flow-of-program.md): Markdown problem sets · Standalone exercises with no integrated solutions. · `assignments/01-flow-of-program.md`
- [OOP assignment](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/assignments/14-oop.md): problem set · `assignments/14-oop.md`
- [Heaps assignment](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/assignments/18-heaps.md): problem set · `assignments/18-heaps.md`
- [Repository README](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/README.md): course links · Links to external course content. · `README.md`

### Foundations

Early standalone Java and algorithm examples.

- [Java basics](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/05-first-java-program/first-idea-program/src/com/kunal/Main.java): console example · Syntax and input/output foundations. · `lectures/05-first-java-program/first-idea-program/src/com/kunal/Main.java`
- [Input examples](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/05-first-java-program/first-idea-program/src/com/kunal/Inputs.java): console example · `lectures/05-first-java-program/first-idea-program/src/com/kunal/Inputs.java`
- [Searching](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/09-linear%20search/code/src/com/kunal/SearchIn2DArray.java): algorithm examples · Linear and binary search programs. · `lectures/09-linear search/code/src/com/kunal/SearchIn2DArray.java`
- [Binary search](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/10-binary%20search/code/src/com/kunal/BinarySearch.java): algorithm example · `lectures/10-binary search/code/src/com/kunal/BinarySearch.java`
- [Recursion and backtracking](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/14-recursion/code/src/com/kunal/backtracking/SudokuSolver.java): package-organized algorithms · Includes recursive arrays, strings, sorting, and solvers. · `lectures/14-recursion/code/src/com/kunal/backtracking/SudokuSolver.java`
- [Recursive sorting](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/14-recursion/code/src/com/kunal/sorting/MergeSort.java): algorithm example · `lectures/14-recursion/code/src/com/kunal/sorting/MergeSort.java`
- [Math and bitwise](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/16-math/code/src/com/kunal/maths/Seive.java): algorithm examples · `lectures/16-math/code/src/com/kunal/maths/Seive.java`

### Data Structures

Local implementations and topic drivers.

- [OOP modeling](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/17-oop/code/src/com/kunal/properties/inheritance/Box.java): local class graphs · Inheritance, polymorphism, interfaces, generics, and exceptions. · `lectures/17-oop/code/src/com/kunal/properties/inheritance/Box.java`
- [Linked lists](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/18-linkedlist/code/src/com/kunal/LL.java): mutable structure · Lesson-local linked-list implementation. · `lectures/18-linkedlist/code/src/com/kunal/LL.java`
- [Stacks and queues](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/19-stacks-n-queues/code/src/com/kunal/CustomStack.java): structure and driver · Local stack implementation exercised by a runnable driver. · `lectures/19-stacks-n-queues/code/src/com/kunal/CustomStack.java`
- [Stack driver](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/19-stacks-n-queues/code/src/com/kunal/StackMain.java): Java entry point · `lectures/19-stacks-n-queues/code/src/com/kunal/StackMain.java`

### Advanced Topics

Later independently scoped algorithms.

- [Trees](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/20-trees/code/introduction/Main.java): structure implementations · Includes BST, AVL, segment trees, traversals, and variants. · `lectures/20-trees/code/introduction/Main.java`
- [AVL tree](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/20-trees/code/AVL/AVL.java): balanced tree · `lectures/20-trees/code/AVL/AVL.java`
- [Segment tree](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/20-trees/code/Segment%20trees/SegmentTree.java): range-query structure · `lectures/20-trees/code/Segment trees/SegmentTree.java`
- [Huffman coding](https://github.com/kunal-kushwaha/dsa-bootcamp-java/blob/main/lectures/27-huffman-coding/code/HuffmanCoder.java): compression algorithm · `lectures/27-huffman-coding/code/HuffmanCoder.java`

### Other components

- **Java/JDK runtime**: standard library and console · Each example runs independently without shared build or services.

## Connections

- Repository README → Course syllabus: orients learners
- Course syllabus → Lecture sequence: orders
- Course syllabus → Assignments: maps topics to
- Assignments → OOP assignment: includes
- Assignments → Heaps assignment: includes
- Lecture sequence → Java basics: begins with
- Java basics → Input examples: includes
- Java basics → Searching: progresses to
- Searching → Binary search: includes
- Searching → Recursion and backtracking: precedes
- Recursion and backtracking → Recursive sorting: implements
- Recursion and backtracking → Math and bitwise: precedes
- Math and bitwise → OOP modeling: precedes
- OOP modeling → Linked lists: precedes
- Linked lists → Stacks and queues: precedes
- Stacks and queues → Stack driver: exercised by
- Stacks and queues → Trees: precedes
- Trees → AVL tree: includes
- Trees → Segment tree: includes
- Trees → Huffman coding: leads to
- Java/JDK runtime → Java basics: runs
- Java/JDK runtime → Stack driver: runs
- Java/JDK runtime → Trees: runs
- Java/JDK runtime → Huffman coding: runs
