# snehalvs30/baseplate architecture

> Architecture diagram of the GitHub repository snehalvs30/baseplate, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/snehalvs30/baseplate
- Repository: https://github.com/snehalvs30/baseplate

## Overview

Baseplate is a GitOps-managed multi-tenant Kubernetes platform for deploying Ledgerline, Footnote, and supporting services locally or on AWS EKS. The principal path is a Git change, ArgoCD reconciliation, platform and tenant configuration, then ingress to tenant workloads and their data services. Separate branches cover tenant isolation, secrets, observability, and AWS infrastructure. Relationships are based on the README’s architecture and capability descriptions; no source excerpts were available, so implementation details beyond the tree are not inferred.

Main entry points: [`platform/bootstrap/root-application.yaml`](https://github.com/snehalvs30/baseplate/blob/main/platform/bootstrap/root-application.yaml) (ArgoCD), [`tenants/ledgerline/templates/deployment.yaml`](https://github.com/snehalvs30/baseplate/blob/main/tenants/ledgerline/templates/deployment.yaml) (Ledgerline), [`infra/modules/eks/main.tf`](https://github.com/snehalvs30/baseplate/blob/main/infra/modules/eks/main.tf) (EKS cluster), [`platform/bootstrap/apps/platform-traefik.yaml`](https://github.com/snehalvs30/baseplate/blob/main/platform/bootstrap/apps/platform-traefik.yaml) (Traefik ingress)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_delivery["GitOps delivery"]
  node_gitrepo[("Baseplate Git<br/>[README.md]")]
  node_argocd["ArgoCD"]
  node_appdefs["Application definitions"]
end

subgraph group_platform["Shared platform"]
  node_tenancy["Tenant policies"]
  node_traefik["Traefik ingress"]
  node_secretsoperator["External Secrets"]
  node_observability["Observability stack"]
end

subgraph group_tenants["Tenant workloads"]
  node_ledgerline["Ledgerline<br/>[deployment.yaml]"]
  node_footnote["Footnote<br/>[deployment.yaml]"]
  node_podinfo["Podinfo tenant"]
  node_tenantdb[("Tenant databases<br/>[postgres.yaml]")]
end

subgraph group_aws["AWS infrastructure"]
  node_nlb["AWS load balancer<br/>[main.tf]"]
  node_network["VPC networking<br/>[main.tf]"]
  node_eks["EKS cluster<br/>[main.tf]"]
  node_rds[("RDS databases<br/>[main.tf]")]
end

node_developer(("Developer"))
node_secretsmanager[("AWS Secrets Manager")]
node_client(("Client"))

node_developer -->|"pushes changes"| node_gitrepo
node_gitrepo -->|"watched by"| node_argocd
node_argocd -->|"reconciles"| node_appdefs
node_argocd -->|"deploys"| node_tenancy
node_argocd -->|"deploys"| node_traefik
node_argocd -->|"deploys"| node_secretsoperator
node_argocd -->|"deploys"| node_observability
node_argocd -->|"deploys"| node_ledgerline
node_argocd -->|"deploys"| node_footnote
node_argocd -->|"deploys"| node_podinfo
node_client -->|"sends requests"| node_nlb
node_nlb -->|"forwards traffic"| node_traefik
node_traefik -->|"routes to"| node_ledgerline
node_traefik -->|"routes to"| node_footnote
node_ledgerline -->|"uses PostgreSQL"| node_rds
node_footnote -->|"uses PostgreSQL"| node_rds
node_secretsoperator -->|"reads secrets"| node_secretsmanager
node_network -->|"hosts"| node_eks
node_eks -->|"exposes through"| node_nlb
node_eks -->|"runs"| node_ledgerline
node_eks -->|"runs"| node_footnote
node_rds -->|"provides cloud databases"| node_tenantdb
node_observability -->|"collects telemetry"| node_ledgerline

click node_gitrepo "https://github.com/snehalvs30/baseplate/blob/main/README.md"
click node_argocd "https://github.com/snehalvs30/baseplate/blob/main/platform/bootstrap/root-application.yaml"
click node_appdefs "https://github.com/snehalvs30/baseplate/tree/main/platform/bootstrap/apps"
click node_tenancy "https://github.com/snehalvs30/baseplate/tree/main/platform/tenancy/templates"
click node_traefik "https://github.com/snehalvs30/baseplate/blob/main/platform/bootstrap/apps/platform-traefik.yaml"
click node_secretsoperator "https://github.com/snehalvs30/baseplate/blob/main/platform/bootstrap/apps/platform-external-secrets.yaml"
click node_observability "https://github.com/snehalvs30/baseplate/tree/main/platform/bootstrap/eks-dev/apps"
click node_ledgerline "https://github.com/snehalvs30/baseplate/blob/main/tenants/ledgerline/templates/deployment.yaml"
click node_footnote "https://github.com/snehalvs30/baseplate/blob/main/tenants/footnote/templates/deployment.yaml"
click node_podinfo "https://github.com/snehalvs30/baseplate/blob/main/platform/bootstrap/apps/tenant-podinfo.yaml"
click node_tenantdb "https://github.com/snehalvs30/baseplate/blob/main/tenants/ledgerline/templates/postgres.yaml"
click node_nlb "https://github.com/snehalvs30/baseplate/blob/main/infra/modules/eks/main.tf"
click node_network "https://github.com/snehalvs30/baseplate/blob/main/infra/modules/network/main.tf"
click node_eks "https://github.com/snehalvs30/baseplate/blob/main/infra/modules/eks/main.tf"
click node_rds "https://github.com/snehalvs30/baseplate/blob/main/infra/modules/rds/main.tf"

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_gitrepo,node_argocd,node_appdefs,node_client toneBlue
class node_tenancy,node_traefik,node_secretsoperator,node_observability,node_secretsmanager toneAmber
class node_ledgerline,node_footnote,node_podinfo,node_tenantdb toneMint
class node_nlb,node_network,node_eks,node_rds toneRose
class node_developer toneIndigo
```

## Components

### GitOps delivery

- [Baseplate Git](https://github.com/snehalvs30/baseplate/blob/main/README.md): `README.md`
- [ArgoCD](https://github.com/snehalvs30/baseplate/blob/main/platform/bootstrap/root-application.yaml): `platform/bootstrap/root-application.yaml`
- [Application definitions](https://github.com/snehalvs30/baseplate/tree/main/platform/bootstrap/apps): `platform/bootstrap/apps`

### Shared platform

- [Tenant policies](https://github.com/snehalvs30/baseplate/tree/main/platform/tenancy/templates): `platform/tenancy/templates`
- [Traefik ingress](https://github.com/snehalvs30/baseplate/blob/main/platform/bootstrap/apps/platform-traefik.yaml): `platform/bootstrap/apps/platform-traefik.yaml`
- [External Secrets](https://github.com/snehalvs30/baseplate/blob/main/platform/bootstrap/apps/platform-external-secrets.yaml): `platform/bootstrap/apps/platform-external-secrets.yaml`
- [Observability stack](https://github.com/snehalvs30/baseplate/tree/main/platform/bootstrap/eks-dev/apps): `platform/bootstrap/eks-dev/apps`

### Tenant workloads

- [Ledgerline](https://github.com/snehalvs30/baseplate/blob/main/tenants/ledgerline/templates/deployment.yaml): `tenants/ledgerline/templates/deployment.yaml`
- [Footnote](https://github.com/snehalvs30/baseplate/blob/main/tenants/footnote/templates/deployment.yaml): `tenants/footnote/templates/deployment.yaml`
- [Podinfo tenant](https://github.com/snehalvs30/baseplate/blob/main/platform/bootstrap/apps/tenant-podinfo.yaml): `platform/bootstrap/apps/tenant-podinfo.yaml`
- [Tenant databases](https://github.com/snehalvs30/baseplate/blob/main/tenants/ledgerline/templates/postgres.yaml): `tenants/ledgerline/templates/postgres.yaml`

### AWS infrastructure

- [AWS load balancer](https://github.com/snehalvs30/baseplate/blob/main/infra/modules/eks/main.tf): `infra/modules/eks/main.tf`
- [VPC networking](https://github.com/snehalvs30/baseplate/blob/main/infra/modules/network/main.tf): `infra/modules/network/main.tf`
- [EKS cluster](https://github.com/snehalvs30/baseplate/blob/main/infra/modules/eks/main.tf): `infra/modules/eks/main.tf`
- [RDS databases](https://github.com/snehalvs30/baseplate/blob/main/infra/modules/rds/main.tf): `infra/modules/rds/main.tf`

### Other components

- **Developer**
- **AWS Secrets Manager**
- **Client**

## Connections

- Developer → Baseplate Git: pushes changes (evidence: `README.md`)
- Baseplate Git → ArgoCD: watched by (evidence: `README.md`)
- ArgoCD → Application definitions: reconciles (evidence: `README.md`)
- ArgoCD → Tenant policies: deploys (evidence: `README.md`)
- ArgoCD → Traefik ingress: deploys (evidence: `README.md`)
- ArgoCD → External Secrets: deploys (evidence: `README.md`)
- ArgoCD → Observability stack: deploys (evidence: `README.md`)
- ArgoCD → Ledgerline: deploys (evidence: `README.md`)
- ArgoCD → Footnote: deploys (evidence: `README.md`)
- ArgoCD → Podinfo tenant: deploys (evidence: `README.md`)
- Client → AWS load balancer: sends requests (evidence: `README.md`)
- AWS load balancer → Traefik ingress: forwards traffic (evidence: `README.md`)
- Traefik ingress → Ledgerline: routes to (evidence: `README.md`)
- Traefik ingress → Footnote: routes to (evidence: `README.md`)
- Ledgerline → RDS databases: uses PostgreSQL (evidence: `README.md`)
- Footnote → RDS databases: uses PostgreSQL (evidence: `README.md`)
- External Secrets → AWS Secrets Manager: reads secrets (evidence: `README.md`)
- VPC networking → EKS cluster: hosts (evidence: `README.md`)
- EKS cluster → AWS load balancer: exposes through (evidence: `README.md`)
- EKS cluster → Ledgerline: runs (evidence: `README.md`)
- EKS cluster → Footnote: runs (evidence: `README.md`)
- RDS databases → Tenant databases: provides cloud databases (evidence: `README.md`)
- Observability stack → Ledgerline: collects telemetry (evidence: `README.md`)
