# fomainspi/two-tier-devops-app architecture

> Architecture diagram of the GitHub repository fomainspi/two-tier-devops-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fomainspi/two-tier-devops-app
- Repository: https://github.com/fomainspi/two-tier-devops-app

## Overview

This repository demonstrates a two-tier web app and its documented delivery workflow. A browser loads the React interface, which requests a message from the Express API and displays the response. Separately, the README describes a developer-to-GitHub-to-Jenkins workflow that builds Docker images and deploys the frontend and backend with Docker Compose. The application call path is visible in the sampled source; deployment links reflect README statements because the deployment files were not sampled.

Main entry points: [`Jenkinsfile`](https://github.com/fomainspi/two-tier-devops-app/blob/main/Jenkinsfile) (Jenkins Pipeline), [`docker-compose.yml`](https://github.com/fomainspi/two-tier-devops-app/blob/main/docker-compose.yml) (Compose Deployment), [`frontend/src/App.js`](https://github.com/fomainspi/two-tier-devops-app/blob/main/frontend/src/App.js) (Message UI), [`frontend/src/index.js`](https://github.com/fomainspi/two-tier-devops-app/blob/main/frontend/src/index.js) (React Entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_react_entry["React Entry<br/>[index.js]"]
  node_react_ui["Message UI<br/>[App.js]"]
  node_express_api["Express API<br/>[server.js]"]
end

subgraph group_delivery["Delivery Workflow"]
  node_github["GitHub Repository"]
  node_jenkins["Jenkins Pipeline"]
  node_frontend_image["Frontend Image"]
  node_backend_image["Backend Image"]
  node_compose["Compose Deployment<br/>[docker-compose.yml]"]
end

node_browser(("User Browser"))
node_developer(("Developer"))

node_browser -->|"loads app"| node_react_entry
node_react_entry -->|"renders"| node_react_ui
node_react_ui -->|"requests message"| node_express_api
node_express_api -->|"returns JSON"| node_react_ui
node_developer -->|"pushes code"| node_github
node_github -->|"triggers pipeline"| node_jenkins
node_jenkins -->|"builds image"| node_frontend_image
node_jenkins -->|"builds image"| node_backend_image
node_jenkins -->|"deploys services"| node_compose
node_compose -->|"runs service"| node_frontend_image
node_compose -->|"runs service"| node_backend_image

click node_react_entry "https://github.com/fomainspi/two-tier-devops-app/blob/main/frontend/src/index.js"
click node_react_ui "https://github.com/fomainspi/two-tier-devops-app/blob/main/frontend/src/App.js"
click node_express_api "https://github.com/fomainspi/two-tier-devops-app/blob/main/backend/server.js"
click node_jenkins "https://github.com/fomainspi/two-tier-devops-app/blob/main/Jenkinsfile"
click node_frontend_image "https://github.com/fomainspi/two-tier-devops-app/blob/main/frontend/Dockerfile"
click node_backend_image "https://github.com/fomainspi/two-tier-devops-app/blob/main/backend/Dockerfile"
click node_compose "https://github.com/fomainspi/two-tier-devops-app/blob/main/docker-compose.yml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_react_entry,node_react_ui,node_express_api,node_browser toneBlue
class node_github,node_jenkins,node_frontend_image,node_backend_image,node_compose toneAmber
class node_developer toneIndigo
```

## Components

### Application

- [React Entry](https://github.com/fomainspi/two-tier-devops-app/blob/main/frontend/src/index.js): `frontend/src/index.js`
- [Message UI](https://github.com/fomainspi/two-tier-devops-app/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Express API](https://github.com/fomainspi/two-tier-devops-app/blob/main/backend/server.js): `backend/server.js`

### Delivery Workflow

- **GitHub Repository**
- [Jenkins Pipeline](https://github.com/fomainspi/two-tier-devops-app/blob/main/Jenkinsfile): `Jenkinsfile`
- [Frontend Image](https://github.com/fomainspi/two-tier-devops-app/blob/main/frontend/Dockerfile): `frontend/Dockerfile`
- [Backend Image](https://github.com/fomainspi/two-tier-devops-app/blob/main/backend/Dockerfile): `backend/Dockerfile`
- [Compose Deployment](https://github.com/fomainspi/two-tier-devops-app/blob/main/docker-compose.yml): `docker-compose.yml`

### Other components

- **User Browser**
- **Developer**

## Connections

- User Browser → React Entry: loads app (evidence: `README.md`)
- React Entry → Message UI: renders (evidence: `frontend/src/index.js`)
- Message UI → Express API: requests message (evidence: `frontend/src/App.js`)
- Express API → Message UI: returns JSON (evidence: `backend/server.js`)
- Developer → GitHub Repository: pushes code (evidence: `README.md`)
- GitHub Repository → Jenkins Pipeline: triggers pipeline (evidence: `README.md`)
- Jenkins Pipeline → Frontend Image: builds image (evidence: `README.md`)
- Jenkins Pipeline → Backend Image: builds image (evidence: `README.md`)
- Jenkins Pipeline → Compose Deployment: deploys services (evidence: `README.md`)
- Compose Deployment → Frontend Image: runs service (evidence: `README.md`)
- Compose Deployment → Backend Image: runs service (evidence: `README.md`)
