# rinlit-233-shiroko/class-widgets-2 architecture

> Architecture diagram of the GitHub repository rinlit-233-shiroko/class-widgets-2, 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/rinlit-233-shiroko/class-widgets-2
- Repository: https://github.com/rinlit-233-shiroko/class-widgets-2

## Overview

Class Widgets 2 is a desktop timetable display and management application. Its principal workflow is to load timetable data, let users edit or import schedules, and run/display the resulting schedule; the repository also documents extensible plugins and built-in updating. The graph includes those major product branches and the central application coordinator. Several connections are supported only by the SOURCE INDEX or README rather than inspected implementation excerpts, so unsampled behavior is represented conservatively.

Main entry points: [`src/core/central.py`](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/central.py) (App Coordinator), [`src/core/schedule/manager.py`](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/schedule/manager.py) (Schedule Manager), [`src/core/plugin/manager.py`](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plugin/manager.py) (Plugin Manager), [`src/core/plugin/workers.py`](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plugin/workers.py) (Plugin Workers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Core"]
  node_app_entry["Application Entry<br/>[app.py]"]
  node_central["App Coordinator<br/>[central.py]"]
  node_config["Configuration<br/>[manager.py]"]
end

subgraph group_schedule["Timetable"]
  node_schedule_manager["Schedule Manager<br/>[manager.py]"]
  node_schedule_model["Schedule Data<br/>[model.py]"]
  node_schedule_editor["Schedule Editor<br/>[editor.py]"]
  node_schedule_runtime["Schedule Runtime<br/>[runtime.py]"]
  node_schedule_swap["Class Swaps<br/>[swapper.py]"]
  node_schedule_converter["Schedule Conversion<br/>[converter.py]"]
  node_schedule_parser["Schedule Parsing<br/>[schedule.py]"]
end

subgraph group_extensions["Extensions and Appearance"]
  node_plugin_manager["Plugin Manager<br/>[manager.py]"]
  node_plugin_loader["Plugin Loader<br/>[loader.py]"]
  node_plugin_archive["Plugin Archives<br/>[archive.py]"]
  node_plugin_workers["Plugin Workers<br/>[workers.py]"]
  node_plaza["Plugin Plaza<br/>[client.py]"]
  node_theme_manager["Theme Manager<br/>[manager.py]"]
  node_theme_loader["Theme Loader<br/>[loader.py]"]
end

subgraph group_interaction["User Interaction"]
  node_window_manager["Window Manager<br/>[manager.py]"]
  node_windows["Application Windows<br/>[windows.py]"]
  node_widgets["Timetable Widgets<br/>[core.py]"]
end

subgraph group_services["Application Services"]
  node_automations["Automations<br/>[manager.py]"]
  node_notifications["Notifications<br/>[manager.py]"]
  node_updater["Application Updater<br/>[bridge.py]"]
end

node_user(("User"))

node_user -->|"starts"| node_app_entry
node_app_entry -->|"initializes"| node_central
node_central -->|"coordinates"| node_config
node_central -->|"loads"| node_schedule_manager
node_central -->|"registers"| node_schedule_editor
node_central -->|"loads"| node_schedule_swap
node_central -.->|"loads"| node_schedule_runtime
node_central -->|"loads"| node_plugin_manager
node_central -->|"loads"| node_theme_manager
node_central -->|"loads"| node_notifications
node_central -->|"loads"| node_updater
node_central -->|"loads"| node_widgets
node_central -.->|"creates"| node_window_manager
node_schedule_manager -->|"validates"| node_schedule_model
node_schedule_manager -->|"delegates conversion"| node_schedule_converter
node_schedule_manager -->|"uses parsing"| node_schedule_parser
node_schedule_editor -.->|"edits schedules"| node_schedule_manager
node_schedule_runtime -.->|"uses data"| node_schedule_model
node_schedule_swap -.->|"modifies schedule"| node_schedule_manager
node_plugin_manager -->|"uses archives"| node_plugin_archive
node_plugin_manager -->|"loads plugins"| node_plugin_loader
node_plugin_manager -->|"dispatches work"| node_plugin_workers
node_plugin_workers -->|"requests data"| node_plaza
node_plugin_workers -->|"processes archives"| node_plugin_archive
node_theme_manager -->|"uses loader"| node_theme_loader
node_window_manager -->|"creates windows"| node_windows
node_automations -->|"runs tasks"| node_central
node_automations -.->|"refreshes schedule"| node_schedule_runtime

click node_app_entry "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/app.py"
click node_central "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/central.py"
click node_config "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/config/manager.py"
click node_schedule_manager "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/schedule/manager.py"
click node_schedule_model "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/schedule/model.py"
click node_schedule_editor "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/schedule/editor.py"
click node_schedule_runtime "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/schedule/runtime.py"
click node_schedule_swap "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/schedule/swapper.py"
click node_schedule_converter "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/convertor/converter.py"
click node_schedule_parser "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/parser/schedule.py"
click node_plugin_manager "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plugin/manager.py"
click node_plugin_loader "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plugin/loader.py"
click node_plugin_archive "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plugin/archive.py"
click node_plugin_workers "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plugin/workers.py"
click node_plaza "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plaza/client.py"
click node_theme_manager "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/themes/manager.py"
click node_theme_loader "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/themes/loader.py"
click node_window_manager "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/windows/manager.py"
click node_windows "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/windows/windows.py"
click node_widgets "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/widgets/core.py"
click node_automations "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/automations/manager.py"
click node_notifications "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/notification/manager.py"
click node_updater "https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/updater/bridge.py"

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_app_entry,node_central,node_config,node_user toneBlue
class node_schedule_manager,node_schedule_model,node_schedule_editor,node_schedule_runtime,node_schedule_swap,node_schedule_converter,node_schedule_parser toneAmber
class node_plugin_manager,node_plugin_loader,node_plugin_archive,node_plugin_workers,node_plaza,node_theme_manager,node_theme_loader toneMint
class node_window_manager,node_windows,node_widgets toneRose
class node_automations,node_notifications,node_updater toneIndigo
```

## Components

### Application Core

- [Application Entry](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/app.py): `src/app.py`
- [App Coordinator](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/central.py): `src/core/central.py`
- [Configuration](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/config/manager.py): `src/core/config/manager.py`

### Timetable

- [Schedule Manager](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/schedule/manager.py): `src/core/schedule/manager.py`
- [Schedule Data](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/schedule/model.py): `src/core/schedule/model.py`
- [Schedule Editor](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/schedule/editor.py): `src/core/schedule/editor.py`
- [Schedule Runtime](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/schedule/runtime.py): `src/core/schedule/runtime.py`
- [Class Swaps](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/schedule/swapper.py): `src/core/schedule/swapper.py`
- [Schedule Conversion](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/convertor/converter.py): `src/core/convertor/converter.py`
- [Schedule Parsing](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/parser/schedule.py): `src/core/parser/schedule.py`

### Extensions and Appearance

- [Plugin Manager](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plugin/manager.py): `src/core/plugin/manager.py`
- [Plugin Loader](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plugin/loader.py): `src/core/plugin/loader.py`
- [Plugin Archives](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plugin/archive.py): `src/core/plugin/archive.py`
- [Plugin Workers](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plugin/workers.py): `src/core/plugin/workers.py`
- [Plugin Plaza](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/plaza/client.py): `src/core/plaza/client.py`
- [Theme Manager](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/themes/manager.py): `src/core/themes/manager.py`
- [Theme Loader](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/themes/loader.py): `src/core/themes/loader.py`

### User Interaction

- [Window Manager](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/windows/manager.py): `src/core/windows/manager.py`
- [Application Windows](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/windows/windows.py): `src/core/windows/windows.py`
- [Timetable Widgets](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/widgets/core.py): `src/core/widgets/core.py`

### Application Services

- [Automations](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/automations/manager.py): `src/core/automations/manager.py`
- [Notifications](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/notification/manager.py): `src/core/notification/manager.py`
- [Application Updater](https://github.com/rinlit-233-shiroko/class-widgets-2/blob/main/src/core/updater/bridge.py): `src/core/updater/bridge.py`

### Other components

- **User**

## Connections

- User → Application Entry: starts (evidence: `README.md`)
- Application Entry → App Coordinator: initializes (evidence: `src/app.py`)
- App Coordinator → Configuration: coordinates (evidence: `src/core/central.py`)
- App Coordinator → Schedule Manager: loads (evidence: `src/core/central.py`)
- App Coordinator → Schedule Editor: registers (evidence: `src/core/central.py`)
- App Coordinator → Class Swaps: loads (evidence: `src/core/central.py`)
- App Coordinator → Schedule Runtime: loads
- App Coordinator → Plugin Manager: loads (evidence: `src/core/central.py`)
- App Coordinator → Theme Manager: loads (evidence: `src/core/central.py`)
- App Coordinator → Notifications: loads (evidence: `src/core/central.py`)
- App Coordinator → Application Updater: loads (evidence: `src/core/central.py`)
- App Coordinator → Timetable Widgets: loads (evidence: `src/core/central.py`)
- App Coordinator → Window Manager: creates (evidence: `src/core/central.py`)
- Schedule Manager → Schedule Data: validates (evidence: `src/core/schedule/manager.py`)
- Schedule Manager → Schedule Conversion: delegates conversion (evidence: `src/core/schedule/manager.py`)
- Schedule Manager → Schedule Parsing: uses parsing (evidence: `src/core/schedule/manager.py`)
- Schedule Editor → Schedule Manager: edits schedules
- Schedule Runtime → Schedule Data: uses data
- Class Swaps → Schedule Manager: modifies schedule
- Plugin Manager → Plugin Archives: uses archives (evidence: `src/core/plugin/manager.py`)
- Plugin Manager → Plugin Loader: loads plugins (evidence: `src/core/plugin/manager.py`)
- Plugin Manager → Plugin Workers: dispatches work (evidence: `src/core/plugin/manager.py`)
- Plugin Workers → Plugin Plaza: requests data (evidence: `src/core/plugin/workers.py`)
- Plugin Workers → Plugin Archives: processes archives (evidence: `src/core/plugin/workers.py`)
- Theme Manager → Theme Loader: uses loader (evidence: `src/core/themes/manager.py`)
- Window Manager → Application Windows: creates windows (evidence: `src/core/windows/manager.py`)
- Automations → App Coordinator: runs tasks (evidence: `src/core/automations/manager.py`)
- Automations → Schedule Runtime: refreshes schedule
