# iappyx/instrumenta architecture

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

- Interactive diagram: https://gitdiagram.com/iappyx/instrumenta
- Repository: https://github.com/iappyx/instrumenta

## Overview

a. Primary Flow:
- User → Custom Ribbon → Module Controllers → PowerPoint Application

b. Secondary Flows:
- Forms ↔ Module Controllers
- Module Controllers ↔ PowerPoint Object Model
- Module Controllers ↔ External Systems (Word/Outlook via AppleScript on Mac)

##### Key Design Elements to Highlight

a. Modular Architecture:
- Relationships between related modules
- Shared utility functions

b. Cross-Platform Compatibility:
- Windows-specific features
- Mac-specific features (with AppleScript bridge)
- Common core functionality

##### Implementation Details

- Blue: Core PowerPoint integration
- Green: User interface components
- Orange: Platform-specific implementations
- Purple: External system integrations

##### Technical Specifications

Annotations showing:
- VBA as primary technology
- PowerPoint Add-in (.ppam) as deployment format
- Required Office versions/platforms
- External dependencies (AppleScript for Mac)

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph UI["User Interface Layer"]
        Ribbon["Custom Ribbon Interface"]
        Forms["Forms System"]
        Dialog["Dialog Boxes & Controls"]
    end

    subgraph Core["Core Module Layer"]
        direction TB
        subgraph Features["Feature Modules"]
            TextOps["Text Operations"]
            subgraph TextSubOps["Text Sub-Operations"]
                FontOps["Font Operations"]
                ParaOps["Paragraph Operations"]
                StyleOps["Style Operations"]
            end
            TableOps["Table Operations"]
            ShapeOps["Shape Operations"]
            Export["Export Functions"]
        end
        
        subgraph Utility["Utility Modules"]
            CoreFuncs["Core Functions"]
            ProcMgmt["Process Management"]
            Settings["Settings Management"]
        end
        
        subgraph Classes["Class Modules"]
            PosEvents["Position Events"]
        end
    end

    subgraph Integration["Integration Layer"]
        PPT["PowerPoint Application"]
        Office["Office Object Model"]
        Apple["AppleScript Bridge"]
    end

    subgraph Special["Special Features"]
        MailMerge["Mail Merge"]
        SlideLib["Slide Library"]
        TagMgmt["Tag Management"]
    end

    %% Relationships
    Ribbon --> Features
    Forms --> Features
    Dialog --> Features
    Features --> PPT
    Features --> Office
    Features --> Apple
    Utility --> Features
    Classes --> Features
    MailMerge --> PPT
    SlideLib --> PPT
    TagMgmt --> PPT
    TextOps --> TextSubOps
    FontOps --> PPT
    ParaOps --> PPT
    StyleOps --> PPT

    %% Click Events
    click Ribbon "https://github.com/iappyx/Instrumenta/blob/main/src/CustomUI/CustomUI.xml"
    click Forms "https://github.com/iappyx/Instrumenta/tree/main/src/Forms/"
    click TextOps "https://github.com/iappyx/Instrumenta/blob/main/src/Modules/ModuleObjectsText.bas"
    click TableOps "https://github.com/iappyx/Instrumenta/blob/main/src/Modules/ModuleTableFormatting.bas"
    click ShapeOps "https://github.com/iappyx/Instrumenta/blob/main/src/Modules/ModuleShapesAcrossSlides.bas"
    click Export "https://github.com/iappyx/Instrumenta/blob/main/src/Modules/ModuleExport.bas"
    click CoreFuncs "https://github.com/iappyx/Instrumenta/blob/main/src/Modules/ModuleFunctions.bas"
    click ProcMgmt "https://github.com/iappyx/Instrumenta/blob/main/src/Modules/ModuleProcess.bas"
    click Settings "https://github.com/iappyx/Instrumenta/blob/main/src/Modules/ModuleSettings.bas"
    click PosEvents "https://github.com/iappyx/Instrumenta/blob/main/src/Classes/SetPositionEventsClass.cls"
    click Apple "https://github.com/iappyx/Instrumenta/blob/main/bin/InstrumentaAppleScriptPlugin.applescript"
    click MailMerge "https://github.com/iappyx/Instrumenta/blob/main/src/Modules/ModuleMailMerge.bas"
    click SlideLib "https://github.com/iappyx/Instrumenta/blob/main/src/Modules/ModuleSlideLibrary.bas"
    click TagMgmt "https://github.com/iappyx/Instrumenta/blob/main/src/Modules/ModuleManageTags.bas"

    %% Styling
    classDef ui fill:#90EE90
    classDef core fill:#87CEEB
    classDef integration fill:#DDA0DD
    classDef special fill:#FFB6C1
    classDef subops fill:#ADD8E6
    
    class Ribbon,Forms,Dialog ui
    class TextOps,TableOps,ShapeOps,Export,CoreFuncs,ProcMgmt,Settings,PosEvents core
    class PPT,Office,Apple integration
    class MailMerge,SlideLib,TagMgmt special
    class FontOps,ParaOps,StyleOps subops
```
