# debuggings/sweethome3d-app-wiki architecture

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

- Interactive diagram: https://gitdiagram.com/debuggings/sweethome3d-app-wiki
- Repository: https://github.com/debuggings/sweethome3d-app-wiki

## Overview

##### Project type and purpose
- This is Sweet Home 3D, a standalone desktop Java application (with optional applet and Java Web Start variants) that provides interior-design functionality.
- Key features: a Swing-based UI, a 3D view rendered via Java3D (and optional Yafaray), project persistence (XML, obj/dae import), and a plugin architecture.

##### File structure
- Top-level:
- build.xml / pom.xml – Ant and Maven build scripts
- install/ – platform installers and scripts
- src/main/java/com/eteks/sweethome3d/… – Java packages (applet, io, j3d, model, plugin, swing, tools, viewcontroller)
- src/main/resources – localized properties, 3D assets, help pages
- src/test – JUnit tests
- Architectural pattern: classic MVC (model + view/controller packages), layered modules (model ↔ controllers ↔ Swing UI and 3D engine), pluggable extensions.

##### README for additional insights
- Confirms Java SE compatibility, Java3D and native‐lib dependencies, Ant/Maven build targets, and packaging steps.

##### Elements
User → UI → Controller → Model → I/O
Controller → 3D Engine → Model
- Presentation (blue)
- Business logic (green)
- Persistence (orange)
- Extensions / tooling (gray)

##### Final advice
- External native dependencies (Java3D binaries, Yafaray) as runtime “side-loaded” modules.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Actor
    User([User]):::external

    %% Presentation Layer
    subgraph "Presentation Layer"
        SwingUI["Swing UI"]:::presentation
        AppletApp["Applet Launcher"]:::presentation
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        Bootstrap["Application Bootstrap"]:::business
        MainApp["Main Application"]:::business
        Controllers["Controllers"]:::business
        Model["Domain Model"]:::business
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        IO["Persistence / I/O"]:::persistence
        Resources["Resources / Localization"]:::persistence
        Disk[(Disk Storage)]:::persistence
    end

    %% Rendering Engine
    subgraph "Rendering Engine"
        Engine["3D Rendering Engine"]:::presentation
        External3D["Java3D & Yafaray"]:::external
    end

    %% Extensions & Tooling
    PluginSubsystem["Plugin Manager"]:::extension
    subgraph "Tooling & Testing"
        Build["Build & Packaging"]:::extension
        Tests["Test Suite (JUnit)"]:::extension
    end

    %% Flows
    User --> SwingUI
    User --> AppletApp
    SwingUI --> Controllers
    AppletApp --> Bootstrap
    Bootstrap --> MainApp
    MainApp --> Controllers
    Controllers --> Model
    Model --> IO
    IO --> Disk
    Controllers --> Engine
    Engine --> Model
    Controllers --> PluginSubsystem
    SwingUI --> PluginSubsystem
    PluginSubsystem --> Controllers
    PluginSubsystem --> SwingUI
    Build --> MainApp
    Build --> Disk
    Tests --> Model
    Tests --> Controllers
    Resources --> SwingUI
    Resources --> Controllers
    Resources --> IO
    MainApp --> ExternalJavaSE["Java SE"]:::external
    Engine --> External3D

    %% Click Events
    click Bootstrap "https://github.com/debuggings/sweethome3d-app-wiki/blob/main/src/main/java/com/eteks/sweethome3d/SweetHome3DBootstrap.java"
    click MainApp "https://github.com/debuggings/sweethome3d-app-wiki/blob/main/src/main/java/com/eteks/sweethome3d/SweetHome3D.java"
    click AppletApp "https://github.com/debuggings/sweethome3d-app-wiki/blob/main/src/main/java/com/eteks/sweethome3d/applet/AppletApplication.java"
    click Controllers "https://github.com/debuggings/sweethome3d-app-wiki/tree/main/src/main/java/com/eteks/sweethome3d/viewcontroller/"
    click Model "https://github.com/debuggings/sweethome3d-app-wiki/tree/main/src/main/java/com/eteks/sweethome3d/model/"
    click IO "https://github.com/debuggings/sweethome3d-app-wiki/tree/main/src/main/java/com/eteks/sweethome3d/io/"
    click SwingUI "https://github.com/debuggings/sweethome3d-app-wiki/tree/main/src/main/java/com/eteks/sweethome3d/swing/"
    click Engine "https://github.com/debuggings/sweethome3d-app-wiki/tree/main/src/main/java/com/eteks/sweethome3d/j3d/"
    click PluginSubsystem "https://github.com/debuggings/sweethome3d-app-wiki/blob/main/src/main/java/com/eteks/sweethome3d/plugin/PluginManager.java"
    click Build "https://github.com/debuggings/sweethome3d-app-wiki/blob/main/build.xml"
    click Build "https://github.com/debuggings/sweethome3d-app-wiki/blob/main/pom.xml"
    click Resources "https://github.com/debuggings/sweethome3d-app-wiki/tree/main/src/main/resources/com/eteks/sweethome3d/"
    click Tests "https://github.com/debuggings/sweethome3d-app-wiki/tree/main/src/test/java/com/eteks/sweethome3d/junit/"

    %% Styles
    classDef presentation fill:#D0E8FF,stroke:#000
    classDef business fill:#D0FFD0,stroke:#000
    classDef persistence fill:#FFE0B2,stroke:#000
    classDef extension fill:#E0E0E0,stroke:#000
    classDef external fill:#F0F0F0,stroke:#000
```
