# wester35/desktop-app-mcc architecture

> Architecture diagram of the GitHub repository wester35/desktop-app-mcc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wester35/desktop-app-mcc
- Repository: https://github.com/wester35/desktop-app-mcc

## Overview

##### Project type and purpose
- This is a standalone Python desktop application (DesktopAppMCC) for statistical analysis, regression modeling, visualization, and forecasting.
- It follows a classic MVC-style layering: a Qt-based UI, controller/business‐logic modules, an analytics “engine,” and a persistence layer.

##### File structure
- Top-level entry: main.py
- MVC directories:
- ui/        → Qt .ui files + generated Python wrappers (ui_auth.py, ui_main.py, ui_register.py)
- views/     → PyQt window-controller classes that bind UI to business logic
- controllers/ → CRUD and analysis controllers (data_crud.py, analysis_crud.py, crud.py)
- models/    → Domain models (User.py, data_models.py)
- analytics/  → Core math and statistical routines (corel_matrix.py, equations.py, predict.py, etc.)
- libs/       → Shared utilities (database.py)
- test_data.py, requirements.txt, spec/deployment files for packaging

##### Review the README for workflows
- User authentication → data input → correlation analysis → integral and interval regression → graphing → forecasting → user management.
- Emphasis on steps: matrix calculation, factor selection, model building, visualizations.

##### Diagramming recommendations
- UI → Controller → Analytics / Database → Controller → UI
- Interactions (e.g., “compute_correlation()”, “save_user()”)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Application Startup
    subgraph "Application Startup"
        Main["main.py"]:::startup
        Spec["DesktopAppMCC.spec"]:::startup
    end

    %% UI Layer
    subgraph "UI Layer"
        subgraph ".ui Files"
            AuthUI["auth.ui"]:::ui
            MainUI1["main.ui"]:::ui
            MainUI2["main_main.ui"]:::ui
            RegisterUI["register.ui"]:::ui
            Resources["resources/"]:::ui
        end
        subgraph "Generated Wrappers"
            UIAuth["ui_auth.py"]:::ui
            UIMain["ui_main.py"]:::ui
            UIRegister["ui_register.py"]:::ui
            MainWindowUI["main_window_ui.py"]:::ui
        end
        subgraph "Views"
            AuthView["auth_window.py"]:::ui
            RegisterView["register_window.py"]:::ui
            MainView["main_window.py"]:::ui
            DataInputView["data_input_window.py"]:::ui
            AnalyticsView["analytics_window.py"]:::ui
            IntegralRegView["integral_regression_window.py"]:::ui
            IntervalRegView["interval_regression_window.py"]:::ui
            ProfileView["profile_window.py"]:::ui
            ProkView["prokofiev_window.py"]:::ui
            AppManagerView["app_manager.py"]:::ui
        end
    end

    %% Controller Layer
    subgraph "Controller Layer"
        CRUD["crud.py"]:::controller
        DataCRUD["data_crud.py"]:::controller
        AnalysisCRUD["analysis_crud.py"]:::controller
    end

    %% Analytics Engine
    subgraph "Analytics Engine"
        Constants["constants.py"]:::analytics
        Corel["corel_matrix.py"]:::analytics
        Equations["equations.py"]:::analytics
        Graphics["graphics.py"]:::analytics
        Predict["predict.py"]:::analytics
        ProkAnal["prokofiev.py"]:::analytics
        Ryab["ryab.py"]:::analytics
    end

    %% Data Layer
    subgraph "Data Layer"
        UserModel["User.py"]:::data
        DataModels["data_models.py"]:::data
        Database["database.py"]:::data
    end

    %% Interactions
    Main -->|initializes DB| Database
    Main -->|shows| AuthView

    AuthView -->|invoke| CRUD
    RegisterView -->|invoke| CRUD
    MainView -->|invoke| DataCRUD
    DataInputView -->|invoke| DataCRUD
    ProfileView -->|invoke| CRUD
    AppManagerView -->|invoke| CRUD

    AnalyticsView -->|invoke| AnalysisCRUD
    IntegralRegView -->|invoke| AnalysisCRUD
    IntervalRegView -->|invoke| AnalysisCRUD
    ProkView -->|invoke| AnalysisCRUD

    CRUD -->|uses| Database
    DataCRUD -->|uses| Database
    DataCRUD -->|manages| UserModel
    DataCRUD -->|manages| DataModels

    AnalysisCRUD -->|compute_correlation| Corel
    AnalysisCRUD -->|solve_equation| Equations
    AnalysisCRUD -->|forecast| Predict
    AnalysisCRUD -->|render_plots| Graphics
    AnalysisCRUD -->|method| ProkAnal
    AnalysisCRUD -->|method| Ryab

    %% Click Events
    click Main "https://github.com/wester35/desktop-app-mcc/blob/main/main.py"
    click Spec "https://github.com/wester35/desktop-app-mcc/blob/main/DesktopAppMCC.spec"
    click AuthUI "https://github.com/wester35/desktop-app-mcc/blob/main/ui/auth.ui"
    click MainUI1 "https://github.com/wester35/desktop-app-mcc/blob/main/ui/main.ui"
    click MainUI2 "https://github.com/wester35/desktop-app-mcc/blob/main/ui/main_main.ui"
    click RegisterUI "https://github.com/wester35/desktop-app-mcc/blob/main/ui/register.ui"
    click Resources "https://github.com/wester35/desktop-app-mcc/tree/main/ui/resources/"
    click UIAuth "https://github.com/wester35/desktop-app-mcc/blob/main/ui/ui_auth.py"
    click UIMain "https://github.com/wester35/desktop-app-mcc/blob/main/ui/ui_main.py"
    click UIRegister "https://github.com/wester35/desktop-app-mcc/blob/main/ui/ui_register.py"
    click MainWindowUI "https://github.com/wester35/desktop-app-mcc/blob/main/ui/main_window_ui.py"
    click AuthView "https://github.com/wester35/desktop-app-mcc/blob/main/views/auth_window.py"
    click RegisterView "https://github.com/wester35/desktop-app-mcc/blob/main/views/register_window.py"
    click MainView "https://github.com/wester35/desktop-app-mcc/blob/main/views/main_window.py"
    click DataInputView "https://github.com/wester35/desktop-app-mcc/blob/main/views/data_input_window.py"
    click AnalyticsView "https://github.com/wester35/desktop-app-mcc/blob/main/views/analytics_window.py"
    click IntegralRegView "https://github.com/wester35/desktop-app-mcc/blob/main/views/integral_regression_window.py"
    click IntervalRegView "https://github.com/wester35/desktop-app-mcc/blob/main/views/interval_regression_window.py"
    click ProfileView "https://github.com/wester35/desktop-app-mcc/blob/main/views/profile_window.py"
    click ProkView "https://github.com/wester35/desktop-app-mcc/blob/main/views/prokofiev_window.py"
    click AppManagerView "https://github.com/wester35/desktop-app-mcc/blob/main/views/app_manager.py"
    click CRUD "https://github.com/wester35/desktop-app-mcc/blob/main/controllers/crud.py"
    click DataCRUD "https://github.com/wester35/desktop-app-mcc/blob/main/controllers/data_crud.py"
    click AnalysisCRUD "https://github.com/wester35/desktop-app-mcc/blob/main/controllers/analysis_crud.py"
    click Constants "https://github.com/wester35/desktop-app-mcc/blob/main/analytics/constants.py"
    click Corel "https://github.com/wester35/desktop-app-mcc/blob/main/analytics/corel_matrix.py"
    click Equations "https://github.com/wester35/desktop-app-mcc/blob/main/analytics/equations.py"
    click Graphics "https://github.com/wester35/desktop-app-mcc/blob/main/analytics/graphics.py"
    click Predict "https://github.com/wester35/desktop-app-mcc/blob/main/analytics/predict.py"
    click ProkAnal "https://github.com/wester35/desktop-app-mcc/blob/main/analytics/prokofiev.py"
    click Ryab "https://github.com/wester35/desktop-app-mcc/blob/main/analytics/ryab.py"
    click UserModel "https://github.com/wester35/desktop-app-mcc/blob/main/models/User.py"
    click DataModels "https://github.com/wester35/desktop-app-mcc/blob/main/models/data_models.py"
    click Database "https://github.com/wester35/desktop-app-mcc/blob/main/libs/database.py"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef controller fill:#90EE90,stroke:#333,stroke-width:1px
    classDef analytics fill:#FFA500,stroke:#333,stroke-width:1px
    classDef data fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef startup fill:#DDA0DD,stroke:#333,stroke-width:1px
```
