Architectural Overview

A structured breakdown of the system architecture, development workflow, and automated deployment pipelines for Agentic Coffee.

Infrastructure & Data Flow Diagram

graph TD subgraph "Local Environment" A[Geekom A5 Mini PC] <-->|AI Collaboration| B(Ollama AI Team) end subgraph "Version Control" A -- "git push" --> C[GitHub Repository] end subgraph "CI/CD Pipeline" C -- "Webhook Event" --> D[Coolify Orchestrator] end subgraph "AWS EC2 Production" D -- "Deploy Containers" --> E[Frontend Web App] D -- "Deploy Containers" --> F[Directus CMS API] D -- "Deploy Containers" --> H[(PostgreSQL DB)] F <-->|"Read/Write Data"| H E -- "HTTP GET (Menu/Assets)" --> F end subgraph "End User" G[Customer Browser] -- "Visits coffee.agenticnodes.dev" --> E end
1

Local Development Environment

The foundation of the development lifecycle begins locally on dedicated hardware.

  • Hardware: Geekom A5 Mini PC.
  • Workspace: Primary environment for writing, modifying, and testing code natively.
  • AI Integration: "Ollama AI team" acts as an automated development partner for code generation and infrastructure configurations.
2

Source Control & Versioning

All application logic and configurations are centralized via Git.

  • Platform: GitHub.
  • Workflow: Commits pushed from the local A5 PC to the remote `main` branch trigger the CI/CD pipeline. GitHub is the single remote source of truth.
3

CI/CD Orchestration

Bridging the gap between the repository and production servers.

  • Orchestrator: Coolify.
  • Pipeline: Coolify listens for GitHub webhooks. Upon a push event, it automatically clones the latest codebase, builds Docker containers, and swaps instances without human intervention.
4

Application Components

The architecture runs on AWS EC2, split into an API consumer and a Backend-as-a-Service.

Frontend Interface

coffee.agenticnodes.dev

Built with HTML, Tailwind CSS, and pure JavaScript. Handles state management, shopping cart logic, 3DS checkout simulations, and mini-games. Functions purely as an API consumer without an internal DB.

Backend CMS API

admin-coffee.agenticnodes.dev

Powered by Directus (Node.js framework) backed by an active PostgreSQL Database. Manages the coffee inventory, pricing, digital media assets, and allows for non-technical content administration.