← Back to Portfolio

Technical Architecture: The Golden Apiary & Pet Hotel

This document outlines the high-performance, 100% static architecture used to deliver live beekeeping telemetry and a multi-version design portfolio.

graph TD
    %% External Data Sources
    IMGW("IMGW-PIB\n(Weather API)")
    RSS("RSS Feeds\n(Bee Journals)")
    GNews("Google News\n(Local Alerts)")

    %% Automation Layer (GitHub Actions)
    subgraph GitHub_Actions [Automation & ETL]
        WeatherSync("Weather Sync\n(Every 3h)")
        NewsSync("News Sync\n(Daily)")
        AstroBuild("Astro Static Build")
    end

    %% Data Layer
    subgraph Data_Storage [Static Data Layer]
        TelemetryJSON("telemetry.json\n(30-day High-Res)")
        ArchiveJSON("archive.json\n(2-year Seasonal)")
        NewsJSON("news.json\n(Aggregated Feed)")
    end

    %% Frontend Layer
    subgraph Frontend [Astro SSG]
        V1_V3("V1-V3 Portfolios\n(Clean / Forest / Artistic)")
        V4("V4 Golden Apiary\n(Live Dashboard)")
        Charts("Chart.js\n(Beekeeping Metrics)")
    end

    %% Hosting
    GH_Pages("GitHub Pages\n(Static Hosting)")

    %% Flows
    IMGW -->|JSON| WeatherSync
    RSS -->|XML| NewsSync
    GNews -->|XML| NewsSync
    
    WeatherSync -->|Python ETL| TelemetryJSON
    WeatherSync -->|Midnight Rollover| ArchiveJSON
    NewsSync -->|Python Aggregator| NewsJSON
    
    TelemetryJSON --> AstroBuild
    ArchiveJSON --> AstroBuild
    NewsJSON --> AstroBuild
    
    AstroBuild -->|Build Artifacts| GH_Pages
    
    GH_Pages -->|Delivers| Frontend

1. The Data Pipeline (ETL)

The application uses a “Static-Dynamic” pattern. While the site is 100% static, it is rebuilt frequently to reflect fresh data.

2. Multi-Version Design Core

The project serves four distinct design identities from a single codebase:

3. Beekeeping Intelligence (V4)

The V4 dashboard implements specific biological logic:

4. Technical Stack