# jacobchartier/coursedistribution architecture

> Architecture diagram of the GitHub repository jacobchartier/coursedistribution, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jacobchartier/coursedistribution
- Repository: https://github.com/jacobchartier/coursedistribution

## Overview

This is a console-based course-distribution and professor-assignment application. A user supplies a data directory; the entry point loads professors and courses, then the department processor reads each professor’s request, matches eligible course groups within requested-hour limits, and writes assignment summaries and unassigned courses. The graph reflects the sampled runtime calls and documented file behavior; the README is empty, and unsampled modules are not inferred.

Main entry points: [`src/entities/Department.java`](https://github.com/jacobchartier/coursedistribution/blob/master/src/entities/Department.java) (Assignment processor), [`src/util/file/ProfessorHandler.java`](https://github.com/jacobchartier/coursedistribution/blob/master/src/util/file/ProfessorHandler.java) (Professor loader), [`src/util/file/CourseHandler.java`](https://github.com/jacobchartier/coursedistribution/blob/master/src/util/file/CourseHandler.java) (Course loader), [`src/Main.java`](https://github.com/jacobchartier/coursedistribution/blob/master/src/Main.java) (Console entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_main["Console entry<br/>[Main.java]"]
end

subgraph group_assignment["Assignment domain"]
  node_department["Assignment processor<br/>[Department.java]"]
  node_professor["Professor model<br/>[Professor.java]"]
  node_course["Course model<br/>[Course.java]"]
end

subgraph group_files["File processing"]
  node_profhandler["Professor loader"]
  node_coursehandler["Course loader<br/>[CourseHandler.java]"]
end

subgraph group_support["Shared utilities"]
  node_conversion["Value conversion"]
  node_debug["Console logging<br/>[Debug.java]"]
  node_colors["Console colors<br/>[ConsoleColor.java]"]
end

node_user(("Directory user"))
node_inputfiles["Input files"]
node_requestfiles["Request files"]
node_outputfiles["Assignment outputs"]

node_user -->|"provides directory"| node_main
node_main -->|"loads professors"| node_profhandler
node_main -->|"loads courses"| node_coursehandler
node_main -->|"processes assignments"| node_department
node_profhandler -->|"reads professor data"| node_inputfiles
node_coursehandler -->|"reads course data"| node_inputfiles
node_profhandler -->|"creates models"| node_professor
node_coursehandler -->|"creates models"| node_course
node_department -->|"reads requests"| node_requestfiles
node_department -->|"updates assignments"| node_professor
node_department -->|"matches groups"| node_course
node_department -->|"writes summaries"| node_profhandler
node_department -->|"writes unassigned"| node_coursehandler
node_profhandler -->|"writes summaries"| node_outputfiles
node_coursehandler -->|"writes remaining courses"| node_outputfiles
node_department -->|"validates values"| node_conversion
node_profhandler -->|"validates values"| node_conversion
node_coursehandler -->|"validates values"| node_conversion
node_department -->|"reports processing"| node_debug
node_profhandler -->|"reports loading"| node_debug
node_coursehandler -->|"reports loading"| node_debug
node_debug -->|"formats messages"| node_colors

click node_main "https://github.com/jacobchartier/coursedistribution/blob/master/src/Main.java"
click node_department "https://github.com/jacobchartier/coursedistribution/blob/master/src/entities/Department.java"
click node_professor "https://github.com/jacobchartier/coursedistribution/blob/master/src/entities/Professor.java"
click node_course "https://github.com/jacobchartier/coursedistribution/blob/master/src/entities/Course.java"
click node_profhandler "https://github.com/jacobchartier/coursedistribution/blob/master/src/util/file/ProfessorHandler.java"
click node_coursehandler "https://github.com/jacobchartier/coursedistribution/blob/master/src/util/file/CourseHandler.java"
click node_conversion "https://github.com/jacobchartier/coursedistribution/blob/master/src/util/ConversionHelper.java"
click node_debug "https://github.com/jacobchartier/coursedistribution/blob/master/src/util/Debug.java"
click node_colors "https://github.com/jacobchartier/coursedistribution/blob/master/src/util/ConsoleColor.java"

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_main,node_user toneBlue
class node_department,node_professor,node_course toneAmber
class node_profhandler,node_coursehandler,node_requestfiles toneMint
class node_conversion,node_debug,node_colors toneRose
class node_inputfiles,node_outputfiles toneIndigo
```

## Components

### Application entry

- [Console entry](https://github.com/jacobchartier/coursedistribution/blob/master/src/Main.java): `src/Main.java`

### Assignment domain

- [Assignment processor](https://github.com/jacobchartier/coursedistribution/blob/master/src/entities/Department.java): `src/entities/Department.java`
- [Professor model](https://github.com/jacobchartier/coursedistribution/blob/master/src/entities/Professor.java): `src/entities/Professor.java`
- [Course model](https://github.com/jacobchartier/coursedistribution/blob/master/src/entities/Course.java): `src/entities/Course.java`

### File processing

- [Professor loader](https://github.com/jacobchartier/coursedistribution/blob/master/src/util/file/ProfessorHandler.java): `src/util/file/ProfessorHandler.java`
- [Course loader](https://github.com/jacobchartier/coursedistribution/blob/master/src/util/file/CourseHandler.java): `src/util/file/CourseHandler.java`

### Shared utilities

- [Value conversion](https://github.com/jacobchartier/coursedistribution/blob/master/src/util/ConversionHelper.java): `src/util/ConversionHelper.java`
- [Console logging](https://github.com/jacobchartier/coursedistribution/blob/master/src/util/Debug.java): `src/util/Debug.java`
- [Console colors](https://github.com/jacobchartier/coursedistribution/blob/master/src/util/ConsoleColor.java): `src/util/ConsoleColor.java`

### Other components

- **Directory user**
- **Input files**
- **Request files**
- **Assignment outputs**

## Connections

- Directory user → Console entry: provides directory (evidence: `src/Main.java`)
- Console entry → Professor loader: loads professors (evidence: `src/Main.java`)
- Console entry → Course loader: loads courses (evidence: `src/Main.java`)
- Console entry → Assignment processor: processes assignments (evidence: `src/Main.java`)
- Professor loader → Input files: reads professor data (evidence: `src/util/file/ProfessorHandler.java`)
- Course loader → Input files: reads course data (evidence: `src/util/file/CourseHandler.java`)
- Professor loader → Professor model: creates models (evidence: `src/util/file/ProfessorHandler.java`)
- Course loader → Course model: creates models (evidence: `src/util/file/CourseHandler.java`)
- Assignment processor → Request files: reads requests (evidence: `src/entities/Department.java`)
- Assignment processor → Professor model: updates assignments (evidence: `src/entities/Department.java`)
- Assignment processor → Course model: matches groups (evidence: `src/entities/Department.java`)
- Assignment processor → Professor loader: writes summaries (evidence: `src/entities/Department.java`)
- Assignment processor → Course loader: writes unassigned (evidence: `src/entities/Department.java`)
- Professor loader → Assignment outputs: writes summaries (evidence: `src/util/file/ProfessorHandler.java`)
- Course loader → Assignment outputs: writes remaining courses (evidence: `src/util/file/CourseHandler.java`)
- Assignment processor → Value conversion: validates values (evidence: `src/entities/Department.java`)
- Professor loader → Value conversion: validates values (evidence: `src/util/file/ProfessorHandler.java`)
- Course loader → Value conversion: validates values (evidence: `src/util/file/CourseHandler.java`)
- Assignment processor → Console logging: reports processing (evidence: `src/entities/Department.java`)
- Professor loader → Console logging: reports loading (evidence: `src/util/file/ProfessorHandler.java`)
- Course loader → Console logging: reports loading (evidence: `src/util/file/CourseHandler.java`)
- Console logging → Console colors: formats messages (evidence: `src/util/Debug.java`)
