# googlecloudplatform/bank-of-anthos architecture

> Architecture diagram of the GitHub repository googlecloudplatform/bank-of-anthos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/googlecloudplatform/bank-of-anthos
- Repository: https://github.com/googlecloudplatform/bank-of-anthos

## Overview

##### Project Type and Purpose
- Bank of Anthos is a full-stack, microservices-based sample web application that simulates a bank’s payment network.
- It demonstrates modernizing enterprise apps on Google Cloud: GKE, Anthos Service Mesh, Cloud SQL, Cloud Build/Deploy, etc.

##### File Structure Analysis
- Top-level “src” folders group microservices:
· src/frontend (Python HTTP server + UI templates + static assets)
· src/accounts/userservice & src/accounts/contacts (Python services for user auth & contact storage)
· src/ledger/ledgerwriter, balancereader, transactionhistory (Java Spring Boot microservices)
· src/accounts/accounts-db & src/ledger/ledger-db (PostgreSQL init scripts + k8s overlays)
· src/loadgenerator (Locust-based load generator)
- kustomize/kubernetes-manifests and skaffold files indicate Kubernetes deployment per environment (dev, staging, prod).
- “extras” / “iac” folders contain alternate deployment patterns (Cloud SQL, multi-cluster, Istio, Terraform).
- README’s “Service architecture” table lists the nine core components (including loadgenerator).

##### Key Insights from README
- Each microservice exposes REST/HTTP endpoints and communicates via JWT authentication.
- frontend ←→ user-service for auth, frontend ←→ contacts for address book, frontend ←→ ledger-writer for transactions, frontend ←→ balance-reader & transaction-history for read-only queries.
- ledger-writer writes to ledger-db, accounts-service and contacts write/read from accounts-db.
- Loadgenerator simulates client traffic against frontend.
- Optional external Cloud SQL can replace in-cluster Postgres.

- External Entity: End User (browser)
- Processes: Frontend, UserService, Contacts, LedgerWriter, BalanceReader, TransactionHistory, LoadGenerator
- Data Stores: Accounts-DB, Ledger-DB
- Infrastructure: Kubernetes Cluster (GKE), Ingress/Gateway, Service Mesh, CI/CD

b. Data Flows & Interactions
- User → Frontend: HTTP(S) requests (login, signup, view, transfer)
- Frontend → UserService: Authenticate, issue JWT → Accounts-DB
- Frontend → Contacts: Retrieve contact list → Accounts-DB
- Frontend → LedgerWriter: Submit transaction (with JWT) → Ledger-DB
- Frontend → BalanceReader & TransactionHistory: Query caches → Ledger-DB
- LoadGenerator → Frontend: Periodic simulation of requests
- (Optional) Ingress/Gateway → All services: TLS termination, routing via Anthos Service Mesh

c. Architectural Patterns & Principles
- Microservices: Small, single-responsibility services
- API Layer: Frontend aggregated API calls
- CQRS-ish: Separate writer (LedgerWriter) vs. readers (BalanceReader, TransactionHistory)
- JWT for stateless auth
- Kubernetes deployments with kustomize overlays per environment
- Service mesh sidecar proxies for secure mTLS

d. Key Technologies/Frameworks
- Python Flask (frontend, user/contacts, loadgenerator)
- Java Spring Boot (ledger services)
- PostgreSQL (in-cluster) or Cloud SQL
- Kubernetes (GKE), Anthos Service Mesh, Ingress, Config Management
- kustomize, skaffold, Cloud Build, Cloud Deploy

##### Detailed Elements to Capture
- External User → Ingress/Gateway → Frontend
- Frontend ↔ UserService & Contacts (Accounts-DB)
- Frontend ↔ LedgerWriter → Ledger-DB
- Frontend ↔ BalanceReader & TransactionHistory → Ledger-DB
- LoadGenerator → Frontend
- Service Mesh sidecars around each pod
- Distinct k8s namespace or overlay boundaries for dev/staging/prod

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Entities and Infra
    User("End User (Browser)"):::external
    LoadGen("Load Generator"):::load
    CI_CD("CI/CD Pipeline"):::infra
    K8sManifests("Kubernetes Manifests"):::infra

    %% Cluster Boundary
    subgraph "Kubernetes Cluster" 
        direction TB
        Mesh("Service Mesh / Sidecars"):::infra
        Ingress("Ingress / Gateway"):::infra

        %% Processes
        Frontend["Frontend (Python Flask)"]:::frontend
        UserSvc["UserService (Python)"]:::python
        Contacts["Contacts (Python)"]:::python
        LedgerW["LedgerWriter (Java)"]:::java
        BalanceR["BalanceReader (Java)"]:::java
        TransHist["TransactionHistory (Java)"]:::java

        %% Data Stores
        AccountsDB["Accounts-DB (Postgres)"]:::datastore
        LedgerDB["Ledger-DB (Postgres)"]:::datastore
    end

    %% Flows from External Entities
    User -->|"HTTPS Request"| Ingress
    LoadGen -->|"Simulated Traffic"| Ingress

    %% CI/CD to Infra
    CI_CD -->|"Deploy definitions"| K8sManifests
    K8sManifests -->|"Apply to cluster"| Mesh

    %% Ingress to Frontend
    Ingress -->|"Route/API Call"| Frontend

    %% Frontend interactions
    Frontend -->|"Authenticate / JWT"| UserSvc
    Frontend -->|"Manage Contacts"| Contacts
    Frontend -->|"Submit Transaction"| LedgerW
    Frontend -->|"Fetch Balances"| BalanceR
    Frontend -->|"Fetch History"| TransHist

    %% Microservices to Databases
    UserSvc -->|"Read/Write User Data"| AccountsDB
    Contacts -->|"Read/Write Contact Data"| AccountsDB
    LedgerW -->|"Write Transactions"| LedgerDB
    BalanceR -->|"Query Balances"| LedgerDB
    TransHist -->|"Query History"| LedgerDB

    %% Mesh sidecars representation (envelope)
    Mesh --> Frontend
    Mesh --> UserSvc
    Mesh --> Contacts
    Mesh --> LedgerW
    Mesh --> BalanceR
    Mesh --> TransHist

    %% Click Events
    click Frontend "https://github.com/googlecloudplatform/bank-of-anthos/tree/main/src/frontend"
    click UserSvc "https://github.com/googlecloudplatform/bank-of-anthos/tree/main/src/accounts/userservice"
    click Contacts "https://github.com/googlecloudplatform/bank-of-anthos/tree/main/src/accounts/contacts"
    click LedgerW "https://github.com/googlecloudplatform/bank-of-anthos/tree/main/src/ledger/ledgerwriter"
    click BalanceR "https://github.com/googlecloudplatform/bank-of-anthos/tree/main/src/ledger/balancereader"
    click TransHist "https://github.com/googlecloudplatform/bank-of-anthos/tree/main/src/ledger/transactionhistory"
    click LoadGen "https://github.com/googlecloudplatform/bank-of-anthos/tree/main/src/loadgenerator"
    click AccountsDB "https://github.com/googlecloudplatform/bank-of-anthos/tree/main/src/accounts/accounts-db"
    click LedgerDB "https://github.com/googlecloudplatform/bank-of-anthos/tree/main/src/ledger/ledger-db"
    click K8sManifests "https://github.com/googlecloudplatform/bank-of-anthos/tree/main/kubernetes-manifests/"
    click CI_CD "https://github.com/googlecloudplatform/bank-of-anthos/blob/main/.github/cloudbuild/ci-pr.yaml"

    %% Styles
    classDef external fill:#ffffff,stroke:#333,stroke-width:1px
    classDef frontend fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef python fill:#d4edda,stroke:#333,stroke-width:1px
    classDef java fill:#ffe5b4,stroke:#333,stroke-width:1px
    classDef datastore fill:#e2e3e5,stroke:#333,stroke-width:1px
    classDef load fill:#f5e6ff,stroke:#333,stroke-width:1px
    classDef infra fill:#f0f0f0,stroke:#333,stroke-width:1px
```
