# cwillr/team-5-senior-project architecture

> Architecture diagram of the GitHub repository cwillr/team-5-senior-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cwillr/team-5-senior-project
- Repository: https://github.com/cwillr/team-5-senior-project

## Overview

##### Main Components
- Application Core: This includes the main entry point (SlideshowApp.java) and core orchestration logic.
- User Interface Panels: Multiple UI panels (e.g., AudioTimelinePanel, FileExplorerPanel, LargeFileViewPanel, TimelinePanel) are used to build the visual interface. Also, separate classes like SlideshowCreator and SlideshowPresenter manage creation and presentation.
- Slide and File Management: Components such as Slide, SlideShowFileManager, and SlideshowSettingsSaver handle the logic for managing slides and saving/loading slideshow settings.

##### Relationships and Interactions
- The Application Core (SlideshowApp) initializes and coordinates the various UI components.
- The UI components interact with file management classes (SlideShowFileManager, SlideshowSettingsSaver) to load, save, and organize slides and settings.
- During playback, controls in the UI panels (e.g., TimelinePanel) trigger transitions and audio synchronization, demonstrating dynamic data flow among components.
- User interactions (drag/drop slide reordering, image selection) move through the UI to the business logic for processing, with file I/O used to persist the slideshow configuration.

##### Architectural Patterns and Design Principles
- The project likely follows a loosely Model-View-Controller (MVC) style, separating the UI (panels and forms) from the underlying data (slides, settings, file management).
- Modularity is evident in how the responsibilities are split across classes (e.g., separate classes for creator and presenter) ensuring reusability and maintainability.
- Dependency Flow: The main app and UI panels depend on the slide management classes, and vice versa concerning data flow from user interactions.

##### Relevant Technologies and Frameworks
- Since there is a pom.xml file, Maven is used as a build tool.
- The application is built in Java and is based on standard Java Swing (or a similar UI framework evidenced by files with .form extensions) for the graphical interface.
- That the project is platform independent (Windows, Mac OS X, Linux) so the design should reflect cross-platform considerations.

##### Element Inclusions
- Clearly label components with descriptive names (e.g., “Main Application”, “UI: Audio Timeline”, “Business Logic: Slide Management”, “File Storage”).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Application Core
    subgraph "Application Core"
        A["SlideshowApp"]:::core
    end

    %% User Interface Layer
    subgraph "User Interface Layer"
        B["AudioTimelinePanel"]:::ui
        C["FileExplorerPanel"]:::ui
        D["LargeFileViewPanel"]:::ui
        E["TimelinePanel"]:::ui
        F["SlideshowCreator"]:::ui
        G["SlideshowPresenter"]:::ui
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        H["Slide"]:::logic
        I["SlideShowFileManager"]:::logic
        J["SlideshowSettingsSaver"]:::logic
    end

    %% Initialization: Core launches UI panels
    A -->|"init"| B
    A -->|"init"| C
    A -->|"init"| D
    A -->|"init"| E
    A -->|"init"| F
    A -->|"init"| G

    %% UI interactions with Business Logic
    F -->|"creates"| H
    F -->|"persists"| I
    C -->|"manages"| I
    B -->|"syncs"| J
    E -->|"syncs"| J
    G -->|"presents"| H

    %% Click Events
    click A "https://github.com/cwillr/team-5-senior-project/blob/main/Senior_Project/src/main/java/com/team5/senior_project/SlideshowApp.java"
    click B "https://github.com/cwillr/team-5-senior-project/blob/main/Senior_Project/src/main/java/com/team5/senior_project/AudioTimelinePanel.java"
    click C "https://github.com/cwillr/team-5-senior-project/blob/main/Senior_Project/src/main/java/com/team5/senior_project/FileExplorerPanel.java"
    click D "https://github.com/cwillr/team-5-senior-project/blob/main/Senior_Project/src/main/java/com/team5/senior_project/LargeFileViewPanel.java"
    click E "https://github.com/cwillr/team-5-senior-project/blob/main/Senior_Project/src/main/java/com/team5/senior_project/TimelinePanel.java"
    click F "https://github.com/cwillr/team-5-senior-project/blob/main/Senior_Project/src/main/java/com/team5/senior_project/SlideshowCreator.java"
    click G "https://github.com/cwillr/team-5-senior-project/blob/main/Senior_Project/src/main/java/com/team5/senior_project/SlideshowPresenter.java"
    click H "https://github.com/cwillr/team-5-senior-project/blob/main/Senior_Project/src/main/java/com/team5/senior_project/Slide.java"
    click I "https://github.com/cwillr/team-5-senior-project/blob/main/Senior_Project/src/main/java/com/team5/senior_project/SlideShowFileManager.java"
    click J "https://github.com/cwillr/team-5-senior-project/blob/main/Senior_Project/src/main/java/com/team5/senior_project/SlideshowSettingsSaver.java"

    %% Styling
    classDef core fill:#f9c,stroke:#333,stroke-width:2px;
    classDef ui fill:#bbf,stroke:#333,stroke-width:2px;
    classDef logic fill:#cfc,stroke:#333,stroke-width:2px;
```
