# deliciousnesquik/mini-pdm-system architecture

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

- Interactive diagram: https://gitdiagram.com/deliciousnesquik/mini-pdm-system
- Repository: https://github.com/deliciousnesquik/mini-pdm-system

## Overview

MiniPdm is a desktop product-data system for importing CAD exports, validating and versioning product objects in PostgreSQL, and browsing and calculating their bill of materials (BOM). The main workflow runs from the Avalonia UI through import orchestration and a JSON CAD adapter, then analysis and transactional persistence; users can subsequently search, browse object cards and BOM trees, manage object states, and view mass and summary results. The README documents these capabilities; edges involving unsampled UI or persistence details are limited to documented or indexed relationships.

Main entry points: [`src/MiniPdm.Data/Services/ImportService.cs`](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Services/ImportService.cs) (Import orchestration), [`src/MiniPdm.App/ViewModels/MainWindowViewModel.cs`](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/ViewModels/MainWindowViewModel.cs) (Main window VM), [`src/MiniPdm.App/AppServices.cs`](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/AppServices.cs) (App composition), [`src/MiniPdm.App/Views/MainWindow.axaml.cs`](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/Views/MainWindow.axaml.cs) (Main window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop interface"]
  node_app["App composition<br/>[AppServices.cs]"]
  node_mainvm["Main window VM"]
  node_mainview["Main window"]
  node_importreport["Import report"]
  node_summary["Summary view"]
end

subgraph group_import["CAD import"]
  node_cadfiles["CAD export files"]
  node_reader["JSON CAD reader"]
  node_cadmodel["CAD document model<br/>[CadDocument.cs]"]
end

subgraph group_domain["Domain logic"]
  node_analyzer["Import analyzer<br/>[ImportAnalyzer.cs]"]
  node_reimport["Re-import rules<br/>[ReImportRules.cs]"]
  node_bomcalc["BOM calculations<br/>[BomCalculator.cs]"]
end

subgraph group_data["Data services"]
  node_importservice["Import orchestration<br/>[ImportService.cs]"]
  node_objects["Object repository"]
  node_snapshots["Import snapshots"]
  node_bomlinks["BOM links"]
  node_versions["Version service<br/>[VersionService.cs]"]
  node_state["State service<br/>[PdmStateService.cs]"]
  node_uiread["UI read facade<br/>[UiReadService.cs]"]
  node_bomrepo["BOM repository<br/>[BomRepository.cs]"]
end

node_user(("Engineer"))
node_postgres[("PostgreSQL")]

node_user -->|"uses"| node_mainview
node_mainview -->|"presents"| node_mainvm
node_app -->|"registers"| node_reader
node_app -->|"registers"| node_importservice
node_app -->|"registers"| node_uiread
node_app -->|"registers"| node_state
node_mainvm -->|"invokes"| node_importservice
node_mainvm -->|"invokes"| node_uiread
node_mainvm -->|"invokes"| node_state
node_cadfiles -->|"reads"| node_reader
node_importservice -->|"reads documents"| node_reader
node_reader -->|"produces"| node_cadmodel
node_importservice -->|"analyzes"| node_analyzer
node_analyzer -->|"validates"| node_cadmodel
node_importservice -->|"applies rules"| node_reimport
node_importservice -->|"writes objects"| node_objects
node_importservice -->|"writes versions"| node_versions
node_importservice -->|"loads snapshots"| node_snapshots
node_importservice -->|"writes links"| node_bomlinks
node_importservice -->|"commits transaction"| node_postgres
node_objects -->|"queries"| node_postgres
node_versions -->|"updates versions"| node_postgres
node_state -->|"delegates"| node_versions
node_uiread -->|"reads objects"| node_objects
node_uiread -->|"reads BOM"| node_bomrepo
node_bomrepo -->|"loads tree"| node_postgres
node_mainvm -->|"calculates mass"| node_bomcalc
node_bomcalc -.->|"provides summary"| node_summary
node_mainview -->|"shows report"| node_importreport
node_mainview -->|"shows summary"| node_summary

click node_app "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/AppServices.cs"
click node_mainvm "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/ViewModels/MainWindowViewModel.cs"
click node_mainview "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/Views/MainWindow.axaml.cs"
click node_importreport "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/ViewModels/ImportReportViewModel.cs"
click node_summary "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/ViewModels/SummaryViewModel.cs"
click node_reader "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Cad.Json/JsonCadDocumentReader.cs"
click node_cadmodel "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Core/Cad/CadDocument.cs"
click node_analyzer "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Core/Import/ImportAnalyzer.cs"
click node_reimport "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Core/Import/ReImportRules.cs"
click node_importservice "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Services/ImportService.cs"
click node_objects "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Repositories/PdmObjectRepository.cs"
click node_snapshots "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Repositories/PdmObjectSnapshotRepository.cs"
click node_bomlinks "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Repositories/BomLinkRepository.cs"
click node_versions "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Services/VersionService.cs"
click node_state "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Services/PdmStateService.cs"
click node_uiread "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Services/UiReadService.cs"
click node_bomrepo "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Repositories/BomRepository.cs"
click node_bomcalc "https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Core/Bom/BomCalculator.cs"

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,node_mainvm,node_mainview,node_importreport,node_summary toneBlue
class node_cadfiles,node_reader,node_cadmodel,node_postgres toneAmber
class node_analyzer,node_reimport,node_bomcalc toneMint
class node_importservice,node_objects,node_snapshots,node_bomlinks,node_versions,node_state,node_uiread,node_bomrepo toneRose
class node_user toneIndigo
```

## Components

### Desktop interface

- [App composition](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/AppServices.cs): `src/MiniPdm.App/AppServices.cs`
- [Main window VM](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/ViewModels/MainWindowViewModel.cs): `src/MiniPdm.App/ViewModels/MainWindowViewModel.cs`
- [Main window](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/Views/MainWindow.axaml.cs): `src/MiniPdm.App/Views/MainWindow.axaml.cs`
- [Import report](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/ViewModels/ImportReportViewModel.cs): `src/MiniPdm.App/ViewModels/ImportReportViewModel.cs`
- [Summary view](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.App/ViewModels/SummaryViewModel.cs): `src/MiniPdm.App/ViewModels/SummaryViewModel.cs`

### CAD import

- **CAD export files**
- [JSON CAD reader](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Cad.Json/JsonCadDocumentReader.cs): `src/MiniPdm.Cad.Json/JsonCadDocumentReader.cs`
- [CAD document model](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Core/Cad/CadDocument.cs): `src/MiniPdm.Core/Cad/CadDocument.cs`

### Domain logic

- [Import analyzer](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Core/Import/ImportAnalyzer.cs): `src/MiniPdm.Core/Import/ImportAnalyzer.cs`
- [Re-import rules](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Core/Import/ReImportRules.cs): `src/MiniPdm.Core/Import/ReImportRules.cs`
- [BOM calculations](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Core/Bom/BomCalculator.cs): `src/MiniPdm.Core/Bom/BomCalculator.cs`

### Data services

- [Import orchestration](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Services/ImportService.cs): `src/MiniPdm.Data/Services/ImportService.cs`
- [Object repository](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Repositories/PdmObjectRepository.cs): `src/MiniPdm.Data/Repositories/PdmObjectRepository.cs`
- [Import snapshots](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Repositories/PdmObjectSnapshotRepository.cs): `src/MiniPdm.Data/Repositories/PdmObjectSnapshotRepository.cs`
- [BOM links](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Repositories/BomLinkRepository.cs): `src/MiniPdm.Data/Repositories/BomLinkRepository.cs`
- [Version service](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Services/VersionService.cs): `src/MiniPdm.Data/Services/VersionService.cs`
- [State service](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Services/PdmStateService.cs): `src/MiniPdm.Data/Services/PdmStateService.cs`
- [UI read facade](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Services/UiReadService.cs): `src/MiniPdm.Data/Services/UiReadService.cs`
- [BOM repository](https://github.com/deliciousnesquik/mini-pdm-system/blob/main/src/MiniPdm.Data/Repositories/BomRepository.cs): `src/MiniPdm.Data/Repositories/BomRepository.cs`

### Other components

- **Engineer**
- **PostgreSQL**

## Connections

- Engineer → Main window: uses
- Main window → Main window VM: presents (evidence: `src/MiniPdm.App/Views/MainWindow.axaml.cs`)
- App composition → JSON CAD reader: registers (evidence: `src/MiniPdm.App/AppServices.cs`)
- App composition → Import orchestration: registers (evidence: `src/MiniPdm.App/AppServices.cs`)
- App composition → UI read facade: registers (evidence: `src/MiniPdm.App/AppServices.cs`)
- App composition → State service: registers (evidence: `src/MiniPdm.App/AppServices.cs`)
- Main window VM → Import orchestration: invokes (evidence: `src/MiniPdm.App/ViewModels/MainWindowViewModel.cs`)
- Main window VM → UI read facade: invokes (evidence: `src/MiniPdm.App/ViewModels/MainWindowViewModel.cs`)
- Main window VM → State service: invokes (evidence: `src/MiniPdm.App/ViewModels/MainWindowViewModel.cs`)
- CAD export files → JSON CAD reader: reads (evidence: `src/MiniPdm.Cad.Json/JsonCadDocumentReader.cs`)
- Import orchestration → JSON CAD reader: reads documents (evidence: `src/MiniPdm.Data/Services/ImportService.cs`)
- JSON CAD reader → CAD document model: produces (evidence: `src/MiniPdm.Cad.Json/JsonCadDocumentReader.cs`)
- Import orchestration → Import analyzer: analyzes (evidence: `src/MiniPdm.Data/Services/ImportService.cs`)
- Import analyzer → CAD document model: validates (evidence: `src/MiniPdm.Core/Import/ImportAnalyzer.cs`)
- Import orchestration → Re-import rules: applies rules (evidence: `src/MiniPdm.Data/Services/ImportService.cs`)
- Import orchestration → Object repository: writes objects (evidence: `src/MiniPdm.Data/Services/ImportService.cs`)
- Import orchestration → Version service: writes versions (evidence: `src/MiniPdm.Data/Services/ImportService.cs`)
- Import orchestration → Import snapshots: loads snapshots (evidence: `src/MiniPdm.Data/Services/ImportService.cs`)
- Import orchestration → BOM links: writes links (evidence: `src/MiniPdm.Data/Services/ImportService.cs`)
- Import orchestration → PostgreSQL: commits transaction (evidence: `src/MiniPdm.Data/Services/ImportService.cs`)
- Object repository → PostgreSQL: queries (evidence: `src/MiniPdm.Data/Repositories/PdmObjectRepository.cs`)
- Version service → PostgreSQL: updates versions (evidence: `src/MiniPdm.Data/Services/VersionService.cs`)
- State service → Version service: delegates (evidence: `src/MiniPdm.Data/Services/PdmStateService.cs`)
- UI read facade → Object repository: reads objects (evidence: `src/MiniPdm.Data/Services/UiReadService.cs`)
- UI read facade → BOM repository: reads BOM (evidence: `src/MiniPdm.Data/Services/UiReadService.cs`)
- BOM repository → PostgreSQL: loads tree (evidence: `src/MiniPdm.Data/Repositories/BomRepository.cs`)
- Main window VM → BOM calculations: calculates mass (evidence: `src/MiniPdm.App/ViewModels/MainWindowViewModel.cs`)
- BOM calculations → Summary view: provides summary
- Main window → Import report: shows report (evidence: `src/MiniPdm.App/Views/MainWindow.axaml.cs`)
- Main window → Summary view: shows summary (evidence: `src/MiniPdm.App/Views/MainWindow.axaml.cs`)
