# che10vec/cleanerschedulemanager architecture

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

- Interactive diagram: https://gitdiagram.com/che10vec/cleanerschedulemanager
- Repository: https://github.com/che10vec/cleanerschedulemanager

## Overview

##### Project Type & Purpose
- A desktop scheduling application built with WPF using the MVVM pattern.
- Manages cleaners, clients, and tasks; reads/writes data via a JSON file.

##### File Structure
- Top-level:
– CleanerScheduleManager (main WPF project)
– CleanerScheduleManager.Tests (unit & integration tests)
- Main WPF project layers:
– Views (XAML UI)
– ViewModels (presentation logic)
– Models (domain objects & enums)
– Services (IDataService, INavigationService, JSON implementation)
– Utilities (RelayCommand for commanding)
– DependencyInjection (Bootstrapper wiring)
- Config & resources: App.xaml for startup, Styles.xaml for theming, AssemblyInfo, project files.

##### Main Components & Their Interactions
a. UI Layer (Views)
– MainView, CleanerView, ClientView, TaskView (XAML + code-behind)
– Binds to properties & commands exposed by ViewModels.
b. Presentation Layer (ViewModels)
– MainViewModel orchestrates navigation and aggregates child VMs.
– CleanerViewModel, ClientViewModel, TaskViewModel handle CRUD and state.
– All inherit from ViewModelBase; implement IPersistable, IHasPendingEdits where needed.
c. Domain Layer (Models)
– Entities: Cleaner, Client, CleaningTask, base Person, enums for status/skill.
d. Service Layer
– IDataService: abstract data operations.
– JsonDataService: concrete JSON file I/O.
– INavigationService: abstract navigation.
– NavigationService: implements window/view transitions.
e. Infrastructure
– DependencyInjection/Bootstrapper: configures DI container, wires interfaces to implementations.
– Utilities/RelayCommand: command pattern implementation.
f. Data Storage
– Local JSON file(s) read/written by JsonDataService.
g. Tests
– Unit tests for JsonDataService, integration tests for NavigationService in CleanerScheduleManager.Tests.

##### Architectural Patterns
- MVVM: separation of concerns between Views, ViewModels, and Models.
- Dependency Injection: Bootstrapper configures service registry for IDataService and INavigationService.
- Command Pattern: RelayCommand decouples UI actions from logic.
- Repository‐like pattern via IDataService abstraction.

## Diagram (Mermaid)

```mermaid
graph TB
    %% UI Layer
    subgraph "UI Layer"
        direction TB
        MainView["MainView"]:::ui
        CleanerView["CleanerView"]:::ui
        ClientView["ClientView"]:::ui
        TaskView["TaskView"]:::ui
    end

    %% ViewModel Layer
    subgraph "ViewModels Layer"
        direction TB
        ViewModelBase["ViewModelBase"]:::vm
        IPersistable["IPersistable"]:::vm
        IHasPendingEdits["IHasPendingEdits"]:::vm
        MainViewModel["MainViewModel"]:::vm
        CleanerViewModel["CleanerViewModel"]:::vm
        ClientViewModel["ClientViewModel"]:::vm
        TaskViewModel["TaskViewModel"]:::vm
    end

    %% Models Layer
    subgraph "Models Layer"
        direction TB
        Person["Person (Base)"]:::model
        Cleaner["Cleaner"]:::model
        Client["Client"]:::model
        CleaningTask["CleaningTask"]:::model
        CleanerSkillLevel["CleanerSkillLevel (Enum)"]:::model
        TaskStatus["TaskStatus (Enum)"]:::model
    end

    %% Services & DI Layer
    subgraph "Services & DI"
        direction TB
        IDataService["IDataService"]:::service
        JsonDataService["JsonDataService"]:::service
        INavigationService["INavigationService"]:::service
        NavigationService["NavigationService"]:::service
        Bootstrapper["Bootstrapper"]:::service
    end

    %% Data Store
    JSONFile[(JSON File)]:::data

    %% Tests
    subgraph "Tests" 
        direction TB
        JsonDataServiceTests["JsonDataServiceTests"]:::tests
        NavigationServiceIntegrationTests["NavigationServiceIntegrationTests"]:::tests
    end

    %% Connections: UI -> ViewModels
    MainView -->|"Bind"| MainViewModel
    CleanerView -->|"Bind"| CleanerViewModel
    ClientView -->|"Bind"| ClientViewModel
    TaskView -->|"Bind"| TaskViewModel

    %% ViewModels inherit/implement
    MainViewModel -->|inherits| ViewModelBase
    CleanerViewModel -->|inherits| ViewModelBase
    ClientViewModel -->|inherits| ViewModelBase
    TaskViewModel -->|inherits| ViewModelBase
    MainViewModel -->|implements| IPersistable
    MainViewModel -->|implements| IHasPendingEdits

    %% ViewModel -> Models
    MainViewModel -->|uses| Person
    CleanerViewModel -->|uses| Cleaner
    ClientViewModel -->|uses| Client
    TaskViewModel -->|uses| CleaningTask
    TaskViewModel -->|uses| TaskStatus
    CleanerViewModel -->|uses| CleanerSkillLevel

    %% ViewModels -> Services
    MainViewModel -->|"Navigate()"| INavigationService
    CleanerViewModel -->|"GetCleaners() / SaveCleaner()"| IDataService
    ClientViewModel -->|"GetClients() / SaveClient()"| IDataService
    TaskViewModel -->|"LoadTasks() / SaveTask()"| IDataService

    %% DI: Bootstrapper
    Bootstrapper -->|wires| IDataService
    Bootstrapper -->|wires| INavigationService
    Bootstrapper -->|injects| MainViewModel
    Bootstrapper -->|injects| CleanerViewModel
    Bootstrapper -->|injects| ClientViewModel
    Bootstrapper -->|injects| TaskViewModel

    %% Services -> Data Store
    JsonDataService -->|"Read/Write JSON"| JSONFile
    IDataService -->|implemented by| JsonDataService
    INavigationService -->|implemented by| NavigationService

    %% Tests relations
    JsonDataServiceTests -->|tests| JsonDataService
    NavigationServiceIntegrationTests -->|tests| NavigationService

    %% Click Events
    click MainView "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Views/MainView.xaml"
    click CleanerView "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Views/CleanerView.xaml"
    click ClientView "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Views/ClientView.xaml"
    click TaskView "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Views/TaskView.xaml"
    click MainViewModel "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/ViewModels/MainViewModel.cs"
    click CleanerViewModel "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/ViewModels/CleanerViewModel.cs"
    click ClientViewModel "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/ViewModels/ClientViewModel.cs"
    click TaskViewModel "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/ViewModels/TaskViewModel.cs"
    click ViewModelBase "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/ViewModels/Base/ViewModelBase.cs"
    click IPersistable "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/ViewModels/Interfaces/IPersistable.cs"
    click IHasPendingEdits "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/ViewModels/Interfaces/IHasPendingEdits.cs"
    click Person "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Models/Base/Person.cs"
    click Cleaner "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Models/Cleaner.cs"
    click Client "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Models/Client.cs"
    click CleaningTask "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Models/CleaningTask.cs"
    click CleanerSkillLevel "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Models/Enums/CleanerSkillLevel.cs"
    click TaskStatus "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Models/Enums/TaskStatus.cs"
    click IDataService "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Services/Interfaces/IDataService.cs"
    click JsonDataService "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Services/JsonDataService.cs"
    click INavigationService "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Services/Interfaces/INavigationService.cs"
    click NavigationService "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Services/NavigationService.cs"
    click Bootstrapper "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/DependencyInjection/Bootstrapper.cs"
    click JSONFile "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager/Services/JsonDataService.cs"
    click JsonDataServiceTests "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager.Tests/JsonDataServiceTests.cs"
    click NavigationServiceIntegrationTests "https://github.com/che10vec/cleanerschedulemanager/blob/master/CleanerScheduleManager.Tests/NavigationServiceIntegrationTests.cs"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#000
    classDef vm fill:#D5F5E3,stroke:#000
    classDef service fill:#FAD7A0,stroke:#000
    classDef model fill:#E5E7E9,stroke:#000
    classDef data fill:#FCF3CF,stroke:#000
    classDef tests fill:#FFFFFF,stroke:#000,stroke-dasharray: 5 5
```
