# anthonymrios/coursescheduler architecture

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

- Interactive diagram: https://gitdiagram.com/anthonymrios/coursescheduler
- Repository: https://github.com/anthonymrios/coursescheduler

## Overview

##### Project Type Analysis
This is a specialized algorithmic application focusing on solving the time-tabling problem using genetic algorithms. The simple structure (two Python files) suggests it's a standalone application rather than a distributed system.

##### Input Components
- Professor Data Store
- Room Data Store
- Constraints Handler

##### Genetic Algorithm Core
- Population Generator
- Fitness Function
- Selection Mechanism
- Crossover Operator
- Mutation Operator

##### Output Processing
- Schedule Generator
- Results Optimizer
- Output Formatter

##### Component Relationship Details

- How input data feeds into the population generator
- The iterative nature of the genetic algorithm (use a circular flow)
- How constraints are checked throughout the process
- The final schedule generation process

##### Technical Details

- Entry point (main.py)
- Separation between the main control flow and the genetic algorithm implementation (project2.py)
- Key data structures used in the process

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Style Definitions
    classDef input fill:#a8d1ff,stroke:#000
    classDef process fill:#90EE90,stroke:#000
    classDef output fill:#FFB347,stroke:#000
    classDef constraint fill:#FF6961,stroke:#000

    %% Input Layer
    subgraph Input
        ProfData[Professor Data Store]:::input
        RoomData[Room Data Store]:::input
        Constraints[Constraints Handler]:::constraint
    end

    %% Genetic Algorithm Core
    subgraph GeneticCore[Genetic Algorithm Core]
        PopGen[Population Generator]:::process
        FitFunc[Fitness Function]:::process
        Select[Selection Mechanism]:::process
        Cross[Crossover Operator]:::process
        Mutate[Mutation Operator]:::process
        
        %% Genetic Algorithm Flow
        PopGen --> FitFunc
        FitFunc --> Select
        Select --> Cross
        Cross --> Mutate
        Mutate -.-> FitFunc
    end

    %% Output Layer
    subgraph Output
        SchedGen[Schedule Generator]:::output
        ResultOpt[Results Optimizer]:::output
        OutFormat[Output Formatter]:::output
    end

    %% Main Connections
    ProfData --> PopGen
    RoomData --> PopGen
    Constraints --> FitFunc
    Mutate --> SchedGen
    SchedGen --> ResultOpt
    ResultOpt --> OutFormat

    %% Constraint Validation
    Constraints -.-> PopGen
    Constraints -.-> Cross
    Constraints -.-> Mutate

    %% Entry Points
    EntryPoint[main.py]:::process
    GAImpl[project2.py]:::process
    
    EntryPoint --> ProfData
    EntryPoint --> RoomData
    EntryPoint --> GeneticCore
    GAImpl --> GeneticCore

    %% Click Events
    click EntryPoint "https://github.com/AnthonyMRios/CourseScheduler/blob/master/main.py"
    click GAImpl "https://github.com/AnthonyMRios/CourseScheduler/blob/master/project2.py"

    %% Legend
    subgraph Legend
        L1[Input Components]:::input
        L2[Processing Components]:::process
        L3[Output Components]:::output
        L4[Constraint Components]:::constraint
    end
```
