# paukpysharp/exportifcfromrevit-csharp architecture

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

- Interactive diagram: https://gitdiagram.com/paukpysharp/exportifcfromrevit-csharp
- Repository: https://github.com/paukpysharp/exportifcfromrevit-csharp

## Overview

ExportIFCFromRevit-CSharp is a batch IFC-export system: an external .NET orchestrator selects and groups Revit models, launches Revit, and an in-process add-in performs exports. The README documents workbook/history/freshness selection, mapped and optional no-map routes, dry-run, multi-version Revit, and diagnostics. The graph follows the principal control flow and documented subsystem capabilities; unsampled workbook, planning, and export internals are linked only where README or indexed references support them.

Main entry points: [`src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs`](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs) (Export coordinator), [`src/ExportIfc.RevitAddin.Shared/Batch/Runtime/RunnerEngine.cs`](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Batch/Runtime/RunnerEngine.cs) (Runner engine), [`src/ExportIfc.Orchestrator/Export/Selection/ExportModelSelectionService.cs`](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/Selection/ExportModelSelectionService.cs) (Export selection), [`src/ExportIfc.Orchestrator/Program.cs`](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Program.cs) (CLI entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ops["Orchestration"]
  node_program["CLI entry<br/>[Program.cs]"]
  node_orchestrator["Export coordinator"]
  node_planning["Batch planning"]
  node_runner["Batch runner"]
  node_diagnostics["Run diagnostics"]
  node_dryrun["Dry-run mode"]
end

subgraph group_state["Selection and state"]
  node_manage["Manage workbook"]
  node_parser["Path row parser"]
  node_history["History manager<br/>[HistoryManager.cs]"]
  node_historybook[("History workbook")]
  node_freshness["IFC freshness"]
  node_selection["Export selection"]
end

subgraph group_launch["Revit launch"]
  node_launcher["Revit launcher<br/>[RevitLauncher.cs]"]
  node_revit(("Revit process"))
end

subgraph group_addin["In-Revit export"]
  node_addinapp["Add-in startup<br/>[App.cs]"]
  node_context["Batch context reader"]
  node_engine["Runner engine<br/>[RunnerEngine.cs]"]
  node_input["Batch input loader"]
  node_executor["Batch executor<br/>[BatchExecutor.cs]"]
  node_export["Model IFC export"]
  node_options48["IFC options 2022–24"]
  node_options8["IFC options 2025–26"]
end

subgraph group_shared["Shared runtime"]
  node_settings["Settings loader"]
  node_model["Model records<br/>[RevitModel.cs]"]
  node_transfer["Transfer store<br/>[TransferStore.cs]"]
  node_logs["Logging<br/>[AddinLogs.cs]"]
end

node_operator(("BIM operator"))

node_operator -->|"starts"| node_program
node_program -->|"loads settings"| node_settings
node_program -->|"runs"| node_orchestrator
node_orchestrator -->|"loads models"| node_manage
node_manage -->|"parses rows"| node_parser
node_parser -->|"creates"| node_model
node_orchestrator -->|"loads history"| node_historybook
node_historybook -.->|"provides records"| node_history
node_orchestrator -->|"selects models"| node_selection
node_selection -->|"checks state"| node_history
node_selection -->|"checks IFCs"| node_freshness
node_selection -->|"plans selected"| node_planning
node_orchestrator -->|"executes plan"| node_runner
node_runner -.->|"starts Revit"| node_launcher
node_launcher -.->|"launches"| node_revit
node_orchestrator -->|"writes batch files"| node_transfer
node_revit -->|"loads add-in"| node_addinapp
node_addinapp -->|"queues runner"| node_engine
node_engine -->|"reads context"| node_context
node_engine -->|"loads tasks"| node_input
node_engine -->|"reads transfer"| node_transfer
node_engine -->|"executes batch"| node_executor
node_executor -.->|"dispatches exports"| node_export
node_export -.->|"uses options"| node_options48
node_export -.->|"uses options"| node_options8
node_orchestrator -->|"writes diagnostics"| node_diagnostics
node_engine -->|"records status"| node_logs
node_orchestrator -->|"supports dry-run"| node_dryrun

click node_program "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Program.cs"
click node_settings "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Common/Settings/Loading/AppSettingsLoader.cs"
click node_orchestrator "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs"
click node_manage "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Manage/Workbook/ManageWorkbookLoader.cs"
click node_parser "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Manage/PathRows/ManagePathRowParser.cs"
click node_model "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Common/Models/RevitModel.cs"
click node_history "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/History/State/HistoryManager.cs"
click node_historybook "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/History/Workbook/HistoryWorkbookStore.cs"
click node_freshness "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Validation/IfcFreshnessChecker.cs"
click node_selection "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/Selection/ExportModelSelectionService.cs"
click node_planning "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/Planning/RevitBatchPlanBuilder.cs"
click node_runner "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/Runtime/RevitBatchRunner.cs"
click node_launcher "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Revit/RevitLauncher.cs"
click node_transfer "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Common/Transfer/TransferStore.cs"
click node_addinapp "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/App.cs"
click node_context "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Batch/Context/BatchRunContextReader.cs"
click node_engine "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Batch/Runtime/RunnerEngine.cs"
click node_input "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Batch/Input/BatchRunInputLoader.cs"
click node_executor "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Batch/Export/BatchExecutor.cs"
click node_export "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Batch/Export/ModelExportExecutor.cs"
click node_options48 "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Net48/Revit/IfcExportOptionsFactory.cs"
click node_options8 "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Net8/Revit/IfcExportOptionsFactory.cs"
click node_diagnostics "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/Diagnostics/ExportDiagnosticsWriter.cs"
click node_logs "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Logging/AddinLogs.cs"
click node_dryrun "https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/ExportOrchestrator.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_program,node_orchestrator,node_planning,node_runner,node_diagnostics,node_dryrun toneBlue
class node_manage,node_parser,node_history,node_historybook,node_freshness,node_selection toneAmber
class node_launcher,node_revit toneMint
class node_addinapp,node_context,node_engine,node_input,node_executor,node_export,node_options48,node_options8 toneRose
class node_settings,node_model,node_transfer,node_logs,node_operator toneIndigo
```

## Components

### Orchestration

- [CLI entry](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Program.cs): `src/ExportIfc.Orchestrator/Program.cs`
- [Export coordinator](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs): `src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs`
- [Batch planning](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/Planning/RevitBatchPlanBuilder.cs): `src/ExportIfc.Orchestrator/Export/Planning/RevitBatchPlanBuilder.cs`
- [Batch runner](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/Runtime/RevitBatchRunner.cs): `src/ExportIfc.Orchestrator/Export/Runtime/RevitBatchRunner.cs`
- [Run diagnostics](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/Diagnostics/ExportDiagnosticsWriter.cs): `src/ExportIfc.Orchestrator/Export/Diagnostics/ExportDiagnosticsWriter.cs`
- [Dry-run mode](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs): `src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs`

### Selection and state

- [Manage workbook](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Manage/Workbook/ManageWorkbookLoader.cs): `src/ExportIfc.Orchestrator/Manage/Workbook/ManageWorkbookLoader.cs`
- [Path row parser](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Manage/PathRows/ManagePathRowParser.cs): `src/ExportIfc.Orchestrator/Manage/PathRows/ManagePathRowParser.cs`
- [History manager](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/History/State/HistoryManager.cs): `src/ExportIfc.Orchestrator/History/State/HistoryManager.cs`
- [History workbook](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/History/Workbook/HistoryWorkbookStore.cs): `src/ExportIfc.Orchestrator/History/Workbook/HistoryWorkbookStore.cs`
- [IFC freshness](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Validation/IfcFreshnessChecker.cs): `src/ExportIfc.Orchestrator/Validation/IfcFreshnessChecker.cs`
- [Export selection](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Export/Selection/ExportModelSelectionService.cs): `src/ExportIfc.Orchestrator/Export/Selection/ExportModelSelectionService.cs`

### Revit launch

- [Revit launcher](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Orchestrator/Revit/RevitLauncher.cs): `src/ExportIfc.Orchestrator/Revit/RevitLauncher.cs`
- **Revit process**

### In-Revit export

- [Add-in startup](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/App.cs): `src/ExportIfc.RevitAddin.Shared/App.cs`
- [Batch context reader](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Batch/Context/BatchRunContextReader.cs): `src/ExportIfc.RevitAddin.Shared/Batch/Context/BatchRunContextReader.cs`
- [Runner engine](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Batch/Runtime/RunnerEngine.cs): `src/ExportIfc.RevitAddin.Shared/Batch/Runtime/RunnerEngine.cs`
- [Batch input loader](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Batch/Input/BatchRunInputLoader.cs): `src/ExportIfc.RevitAddin.Shared/Batch/Input/BatchRunInputLoader.cs`
- [Batch executor](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Batch/Export/BatchExecutor.cs): `src/ExportIfc.RevitAddin.Shared/Batch/Export/BatchExecutor.cs`
- [Model IFC export](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Batch/Export/ModelExportExecutor.cs): `src/ExportIfc.RevitAddin.Shared/Batch/Export/ModelExportExecutor.cs`
- [IFC options 2022–24](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Net48/Revit/IfcExportOptionsFactory.cs): `src/ExportIfc.RevitAddin.Net48/Revit/IfcExportOptionsFactory.cs`
- [IFC options 2025–26](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Net8/Revit/IfcExportOptionsFactory.cs): `src/ExportIfc.RevitAddin.Net8/Revit/IfcExportOptionsFactory.cs`

### Shared runtime

- [Settings loader](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Common/Settings/Loading/AppSettingsLoader.cs): `src/ExportIfc.Common/Settings/Loading/AppSettingsLoader.cs`
- [Model records](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Common/Models/RevitModel.cs): `src/ExportIfc.Common/Models/RevitModel.cs`
- [Transfer store](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.Common/Transfer/TransferStore.cs): `src/ExportIfc.Common/Transfer/TransferStore.cs`
- [Logging](https://github.com/paukpysharp/exportifcfromrevit-csharp/blob/main/src/ExportIfc.RevitAddin.Shared/Logging/AddinLogs.cs): `src/ExportIfc.RevitAddin.Shared/Logging/AddinLogs.cs`

### Other components

- **BIM operator**

## Connections

- BIM operator → CLI entry: starts (evidence: `src/ExportIfc.Orchestrator/Program.cs`)
- CLI entry → Settings loader: loads settings (evidence: `src/ExportIfc.Orchestrator/Program.cs`)
- CLI entry → Export coordinator: runs (evidence: `src/ExportIfc.Orchestrator/Program.cs`)
- Export coordinator → Manage workbook: loads models (evidence: `src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs`)
- Manage workbook → Path row parser: parses rows (evidence: `src/ExportIfc.Orchestrator/Manage/PathRows/ManagePathRowParser.cs`)
- Path row parser → Model records: creates (evidence: `src/ExportIfc.Orchestrator/Manage/PathRows/ManagePathRowParser.cs`)
- Export coordinator → History workbook: loads history (evidence: `README.md`)
- History workbook → History manager: provides records
- Export coordinator → Export selection: selects models (evidence: `src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs`)
- Export selection → History manager: checks state (evidence: `src/ExportIfc.Orchestrator/Export/Selection/ExportModelSelectionService.cs`)
- Export selection → IFC freshness: checks IFCs (evidence: `src/ExportIfc.Orchestrator/Export/Selection/ExportModelSelectionService.cs`)
- Export selection → Batch planning: plans selected (evidence: `src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs`)
- Export coordinator → Batch runner: executes plan (evidence: `src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs`)
- Batch runner → Revit launcher: starts Revit
- Revit launcher → Revit process: launches
- Export coordinator → Transfer store: writes batch files (evidence: `README.md`)
- Revit process → Add-in startup: loads add-in (evidence: `README.md`)
- Add-in startup → Runner engine: queues runner (evidence: `src/ExportIfc.RevitAddin.Shared/App.cs`)
- Runner engine → Batch context reader: reads context (evidence: `src/ExportIfc.RevitAddin.Shared/Batch/Runtime/RunnerEngine.cs`)
- Runner engine → Batch input loader: loads tasks (evidence: `src/ExportIfc.RevitAddin.Shared/Batch/Runtime/RunnerEngine.cs`)
- Runner engine → Transfer store: reads transfer (evidence: `src/ExportIfc.RevitAddin.Shared/Batch/Runtime/RunnerEngine.cs`)
- Runner engine → Batch executor: executes batch (evidence: `src/ExportIfc.RevitAddin.Shared/Batch/Runtime/RunnerEngine.cs`)
- Batch executor → Model IFC export: dispatches exports
- Model IFC export → IFC options 2022–24: uses options
- Model IFC export → IFC options 2025–26: uses options
- Export coordinator → Run diagnostics: writes diagnostics (evidence: `src/ExportIfc.Orchestrator/Export/ExportOrchestrator.cs`)
- Runner engine → Logging: records status (evidence: `src/ExportIfc.RevitAddin.Shared/Batch/Runtime/RunnerEngine.cs`)
- Export coordinator → Dry-run mode: supports dry-run (evidence: `README.md`)
