# sephyron/angelcolberg-bu-1 architecture

> Architecture diagram of the GitHub repository sephyron/angelcolberg-bu-1, 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/sephyron/angelcolberg-bu-1
- Repository: https://github.com/sephyron/angelcolberg-bu-1

## Overview

##### Main Components and Layers
- Frontend Application – This is the heart of the portfolio website. Emphasize:
– The Angular application (located in the “app” folder) that contains app.js, config.js, and different controller files (main.controller.js, contact.controller.js, work.controller.js).
– The “components” folder which includes Angular directives (e.g., for main navigation, footer, responsive navigation, owl slider) and services (for local storage and query management).
– The “views” folder where your HTML templates (pages for home, projects, contact, work, error 404, etc.) are stored.
- Assets and Prototypes – The “assets” folder (and similar copies in “_build” and “images”) houses all the static resources. These include:
– Fonts (e.g. DepartureMono-Regular.otf)
– Style sheets (organized in “styles” and “styles/partials” and “styles/static”) and skins.
– Multiple project prototypes (e.g., “assets/prototypes/cloudon”, “assets/prototypes/fi-gps-?”, “assets/prototypes/unity”) that likely serve as interactive demos.
- Build and Deployment Infrastructure – This layer includes:
– Build tooling with “gulpfile.js”, package.json, and associated configuration files.
– The “_build” folder that contains the final built assets, minified styles, compiled HTML views, and processed JavaScript.

##### Data Flow and Interactions
- Lifecycle flow from source code to production: sources (app, components, assets, styles, js) → build system (gulp) → output (the _build folder and distribution files).
- Within the application layer, show that the Angular app configuration loads controllers and services, which interact with the views through data binding.

##### Architectural Patterns & Design Principles
- Follow the Model-View-Controller (MVC) or MVVM pattern common in Angular applications. Indicate clearly the “app” layer (controllers, services) and how the “views” present the data.
- The build process is separated from the runtime application; show the pipeline from source to the production bundle.
- Provide labels for third-party dependencies such as jQuery (which is slated for removal) and AngularJS, along with the legacy libraries in the “js/nonangular” folder.

##### Relevant Technologies
- AngularJS (with future upgrade in mind), JavaScript (both Angular and non-Angular parts).
- SCSS/CSS for styling (with a modular SCSS structure under “styles”).
- Gulp for build automation and dependency management (along with package.json for npm-managed dependencies).
- Rich multimedia/interactive prototypes that showcase project work.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Source Code Layer
    subgraph "Source Code"
        %% Application Layer
        subgraph "Application Layer"
            AngularApp["Angular App Module"]
            Components["Components (Directives & Services)"]
        end
        %% Presentation Layer
        subgraph "Presentation Layer"
            Views["Views / Templates"]
        end
        %% Assets Layer
        subgraph "Assets Layer"
            Assets["Assets & Prototypes"]
            Styles["Styles & Fonts"]
        end
        %% Third-Party Dependencies Layer
        subgraph "Third-Party Dependencies"
            Legacy["Legacy & Non-Angular"]
        end
    end

    %% Build & Deployment Layer
    subgraph "Build & Deployment"
        BuildTools["Build Pipeline (gulpfile.js & package.json)"]
        Distribution["Distribution (_build)"]
    end

    %% Internal Application Interactions
    Components -->|"injects"| AngularApp
    AngularApp -->|"binds to"| Views
    Assets -->|"interactive demos"| Views

    %% Flow from Source to Build
    AngularApp --- BuildTools
    Components --- BuildTools
    Views --- BuildTools
    Assets --- BuildTools
    Styles --- BuildTools
    Legacy --- BuildTools
    BuildTools -->|"produces"| Distribution

    %% Click Events
    click AngularApp "https://github.com/sephyron/angelcolberg-bu-1/blob/master/app/app.js"
    click Components "https://github.com/sephyron/angelcolberg-bu-1/tree/master/components/"
    click Views "https://github.com/sephyron/angelcolberg-bu-1/tree/master/views/"
    click Assets "https://github.com/sephyron/angelcolberg-bu-1/tree/master/assets/prototypes/"
    click Styles "https://github.com/sephyron/angelcolberg-bu-1/tree/master/assets/fonts"
    click BuildTools "https://github.com/sephyron/angelcolberg-bu-1/blob/master/gulpfile.js"
    click Distribution "https://github.com/sephyron/angelcolberg-bu-1/tree/master/_build/"
    click Legacy "https://github.com/sephyron/angelcolberg-bu-1/tree/master/js/nonangular/"

    %% Styles and Colors
    classDef appLayer fill:#cce5ff,stroke:#004085,stroke-width:2px;
    classDef presentation fill:#d4edda,stroke:#155724,stroke-width:2px;
    classDef assets fill:#fff3cd,stroke:#856404,stroke-width:2px;
    classDef build fill:#f8d7da,stroke:#721c24,stroke-width:2px;
    classDef legacy fill:#d1ecf1,stroke:#0c5460,stroke-width:2px;

    class AngularApp,Components appLayer
    class Views presentation
    class Assets,Styles assets
    class BuildTools,Distribution build
    class Legacy legacy
```
