# ramenofficialgovpatsy/floors-manufacturing-system architecture

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

- Interactive diagram: https://gitdiagram.com/ramenofficialgovpatsy/floors-manufacturing-system
- Repository: https://github.com/ramenofficialgovpatsy/floors-manufacturing-system

## Overview

##### Project type and purpose
- This is a full-stack, cross-platform desktop application (“Floors Manufacturing Management System”) built with Avalonia UI (.NET/C#) using the MVVM pattern.
- It automates CRM, product catalog, order processing (with progressive discounts), warehouse inventory, and a multi-stage workflow.

##### File structure
- Top-level artifacts
- Program.cs, App.axaml(.cs), MainWindow.axaml(.cs): application and startup
- Master_Floor_Project.sln / .csproj: solution and project files
- Data/AppDbContext.cs: EF Core DbContext
- Models/: domain entities
- Services/: business logic and abstractions
- ViewModels/: presentation logic
- Views/ & Windows/: XAML UI definitions
- Converters/: UI value converters
- Assets/: images, resources
- Architectural hints
- MVVM layers (Views ↔ ViewModels ↔ Models + Services)
- Dependency Injection is used (I*Service interfaces)
- EventAggregator for event-driven module communication
- Entity Framework Core + Npgsql talking to PostgreSQL

##### README for additional insights
- Confirms technology stack: Avalonia UI (frontend), .NET 9.0/C# 11 (backend), EF Core, PostgreSQL
- Architectural patterns: MVVM, DI, event-driven communication

a. Main components
1. Client/UI Layer
- Views & Windows (XAML)
- Converters
2. Presentation Layer
- ViewModels
- NavigationService & EventAggregator
3. Domain/Business Layer
- Services (ApplicationService, ProductService, DiscountService, PartnerService, WarehouseService)
- Service Interfaces (IApplicationService, etc.)
4. Data Access Layer
- AppDbContext (EF Core)
- Models/entities
5. Database
- PostgreSQL (hosted externally or locally)
6. External Libraries/Frameworks
- Avalonia UI, CommunityToolkit.MVVM, EF Core, Npgsql

b. Relationships & interactions
- UI binds to ViewModels (two-way data binding)
- ViewModels call Services via injected interfaces
- Services orchestrate business logic and use DbContext to query/update Models
- DbContext uses EF Core + Npgsql to communicate with PostgreSQL
- EventAggregator publishes/subscribes events among ViewModels/Services
- NavigationService orchestrates view/window transitions

c. Architectural patterns/design principles
- MVVM: separation of UI (Views) and presentation logic (ViewModels)
- Dependency Injection: ViewModels depend on I*Service abstractions, resolved at startup
- Repository-style Data Access via EF Core
- Event-driven communication for decoupling

d. Key technologies/frameworks
- Avalonia UI for cross-platform desktop UI
- XAML for layout + Converters
- CommunityToolkit.MVVM for INotifyPropertyChanged, RelayCommands
- EF Core (AppDbContext) and Npgsql for ORM and DB connectivity
- PostgreSQL as the relational database

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Startup & DI Configuration
    subgraph "Startup & DI Configuration"
        direction TB
        Program["Program.cs"]:::startup
        AppXaml["App.axaml/cs"]:::startup
        MainWindowStart["MainWindow.axaml/cs"]:::startup
    end

    %% UI Layer
    subgraph "Client/UI Layer"
        direction TB
        Views["Views/"]:::ui
        Windows["Windows/"]:::ui
        Converters["Converters/"]:::ui
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        ViewModels["ViewModels/"]:::vm
        NavService["NavigationService"]:::vm
        EventBus["EventAggregator"]:::vm
    end

    %% Domain/Business Layer
    subgraph "Domain/Business Layer"
        direction TB
        AppService["ApplicationService"]:::svc
        IAppService["IApplicationService"]:::svc
        ProdService["ProductService"]:::svc
        IProdService["IProductService"]:::svc
        DiscService["DiscountService"]:::svc
        IDiscService["IDiscountService"]:::svc
        PartnerService["PartnerService"]:::svc
        IPartnerService["IPartnerService"]:::svc
        WarehouseService["WarehouseService"]:::svc
        IWarehouseService["IWarehouseService"]:::svc
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        direction TB
        AppDbContext["AppDbContext"]:::data
        Models["Models/"]:::data
    end

    %% Database
    PostgreSQL[("PostgreSQL")]:::db

    %% Connections
    Program -->|configures DI| ViewModels
    Program -->|configures DI| AppService
    Program -->|configures DI| ProdService
    Program -->|configures DI| DiscService
    Program -->|configures DI| PartnerService
    Program -->|configures DI| WarehouseService
    MainWindowStart -->|starts UI| Views

    Views <-->|two-way binding| ViewModels
    Windows <-->|two-way binding| ViewModels
    Converters -->|used by| Views

    ViewModels -->|injects & calls| AppService
    ViewModels -->|injects & calls| ProdService
    ViewModels -->|injects & calls| DiscService
    ViewModels -->|injects & calls| PartnerService
    ViewModels -->|injects & calls| WarehouseService

    AppService -->|uses| AppDbContext
    ProdService -->|uses| AppDbContext
    DiscService -->|uses| AppDbContext
    PartnerService -->|uses| AppDbContext
    WarehouseService -->|uses| AppDbContext

    AppDbContext -->|manages| Models
    AppDbContext -->|connects via Npgsql| PostgreSQL

    EventBus -->|publishes/subscribes events| ViewModels
    EventBus -->|publishes/subscribes events| AppService
    EventBus -->|publishes/subscribes events| ProdService

    %% Click Events
    click Views "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/tree/main/Views/"
    click Windows "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/tree/main/Windows/"
    click Converters "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/tree/main/Converters/"
    click ViewModels "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/tree/main/ViewModels/"
    click NavService "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/NavigationService.cs"
    click EventBus "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/EventAggregator.cs"
    click AppService "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/ApplicationService.cs"
    click IAppService "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/IApplicationService.cs"
    click ProdService "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/ProductService.cs"
    click IProdService "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/IProductService.cs"
    click DiscService "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/DiscountService.cs"
    click IDiscService "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/IDiscountService.cs"
    click PartnerService "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/PartnerService.cs"
    click IPartnerService "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/IPartnerService.cs"
    click WarehouseService "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/WarehouseService.cs"
    click IWarehouseService "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Services/IWarehouseService.cs"
    click AppDbContext "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Data/AppDbContext.cs"
    click Models "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/tree/main/Models/"
    click Program "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/Program.cs"
    click AppXaml "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/App.axaml.cs"
    click MainWindowStart "https://github.com/ramenofficialgovpatsy/floors-manufacturing-system/blob/main/MainWindow.axaml.cs"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0091EA,stroke-width:1px
    classDef vm fill:#E0F7FA,stroke:#006064,stroke-width:1px
    classDef svc fill:#FFF3E0,stroke:#E65100,stroke-width:1px
    classDef data fill:#FFF9C4,stroke:#F57F17,stroke-width:1px
    classDef db fill:#E8F5E9,stroke:#2E7D32,stroke-width:1px,shape:cylinder
    classDef startup fill:#ECEFF1,stroke:#455A64,stroke-width:1px
```
