# gnunn-gitops/petclinic architecture

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

- Interactive diagram: https://gitdiagram.com/gnunn-gitops/petclinic
- Repository: https://github.com/gnunn-gitops/petclinic

## Overview

This repository is a GitOps delivery platform for the Petclinic application. The principal workflow is developer change → CI pipeline → container image and SBOM → GitOps promotion → Argo CD synchronization → environment rollout, with Petclinic and its database deployed to Kubernetes. The tree also shows smoke-test analysis, external secrets, image updating, commit-status reporting, and Slack notifications. No README or source excerpts were provided, so relationships are limited to capabilities clearly indicated by manifest names and paths.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bootstrap["Bootstrap"]
  node_bootstrap_apps["Application Bootstrap<br/>[kustomization.yaml]"]
end

subgraph group_ci["Continuous Integration"]
  node_ci_trigger["CI Trigger<br/>[trigger.yaml]"]
  node_ci_pipeline["Build Pipeline<br/>[pipeline.yaml]"]
  node_image_push["Image Push"]
  node_sbom_export["SBOM Export"]
  node_slack_notify["Slack Notification"]
end

subgraph group_gitops["GitOps Delivery"]
  node_argocd["Argo CD Control<br/>[kustomization.yaml]"]
  node_image_updater["Image Updater<br/>[image-updater.yaml]"]
  node_promotion["Promotion Strategy"]
  node_environments["Environment Overlays"]
end

subgraph group_workloads["Application Workloads"]
  node_petclinic_rollout["Petclinic Rollout"]
  node_petclinic_service["Petclinic Service<br/>[petclinic-svc.yaml]"]
  node_petclinic_route["Petclinic Route"]
  node_smoke_analysis["Smoke Analysis"]
end

subgraph group_data["Application Data"]
  node_petclinic_database[("Petclinic Database<br/>[petclinic-db.yaml]")]
  node_database_service["Database Service"]
end

node_developer(("Developer"))
node_git_provider(("Git Provider"))
node_container_registry[("Container Registry")]
node_slack(("Slack"))

node_developer -->|"commits to"| node_git_provider
node_git_provider -->|"triggers"| node_ci_trigger
node_ci_trigger -->|"dispatches"| node_ci_pipeline
node_ci_pipeline -->|"runs"| node_image_push
node_ci_pipeline -->|"exports"| node_sbom_export
node_image_push -->|"pushes image"| node_container_registry
node_ci_pipeline -.->|"runs"| node_slack_notify
node_slack_notify -.->|"notifies"| node_slack
node_bootstrap_apps -->|"installs"| node_argocd
node_bootstrap_apps -->|"installs"| node_ci_pipeline
node_container_registry -.->|"provides image"| node_image_updater
node_image_updater -.->|"updates"| node_promotion
node_promotion -.->|"writes commits"| node_git_provider
node_git_provider -->|"supplies manifests"| node_argocd
node_argocd -->|"renders"| node_environments
node_argocd -->|"deploys"| node_petclinic_rollout
node_argocd -->|"deploys"| node_petclinic_database
node_petclinic_rollout -->|"runs analysis"| node_smoke_analysis
node_petclinic_route -->|"routes traffic"| node_petclinic_service
node_petclinic_database -->|"provides service"| node_database_service

click node_bootstrap_apps "https://github.com/gnunn-gitops/petclinic/blob/main/bootstrap/base/kustomization.yaml"
click node_ci_trigger "https://github.com/gnunn-gitops/petclinic/blob/main/apps/ci/base/trigger.yaml"
click node_ci_pipeline "https://github.com/gnunn-gitops/petclinic/blob/main/apps/ci/base/pipeline.yaml"
click node_image_push "https://github.com/gnunn-gitops/petclinic/blob/main/apps/ci/base/push-image-task.yaml"
click node_sbom_export "https://github.com/gnunn-gitops/petclinic/blob/main/apps/ci/base/export-sbom-task.yaml"
click node_slack_notify "https://github.com/gnunn-gitops/petclinic/blob/main/apps/ci/base/send-to-slack-task.yaml"
click node_argocd "https://github.com/gnunn-gitops/petclinic/blob/main/apps/argocd/base/kustomization.yaml"
click node_image_updater "https://github.com/gnunn-gitops/petclinic/blob/main/apps/argocd/base/image-updater.yaml"
click node_promotion "https://github.com/gnunn-gitops/petclinic/blob/main/apps/argocd/overlays/dual-ps/promotion-strategy.yaml"
click node_environments "https://github.com/gnunn-gitops/petclinic/tree/main/environments/overlays"
click node_petclinic_rollout "https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic/base/petclinic-rollout.yaml"
click node_petclinic_service "https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic/base/petclinic-svc.yaml"
click node_petclinic_route "https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic/base/petclinic-route.yaml"
click node_smoke_analysis "https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic/base/smoke-test-analysis.yaml"
click node_petclinic_database "https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic-db/base/petclinic-db.yaml"
click node_database_service "https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic-db/base/petclinic-db-es.yaml"

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_bootstrap_apps toneBlue
class node_ci_trigger,node_ci_pipeline,node_image_push,node_sbom_export,node_slack_notify,node_container_registry toneAmber
class node_argocd,node_image_updater,node_promotion,node_environments toneMint
class node_petclinic_rollout,node_petclinic_service,node_petclinic_route,node_smoke_analysis toneRose
class node_petclinic_database,node_database_service,node_developer,node_git_provider,node_slack toneIndigo
```

## Components

### Bootstrap

- [Application Bootstrap](https://github.com/gnunn-gitops/petclinic/blob/main/bootstrap/base/kustomization.yaml): `bootstrap/base/kustomization.yaml`

### Continuous Integration

- [CI Trigger](https://github.com/gnunn-gitops/petclinic/blob/main/apps/ci/base/trigger.yaml): `apps/ci/base/trigger.yaml`
- [Build Pipeline](https://github.com/gnunn-gitops/petclinic/blob/main/apps/ci/base/pipeline.yaml): `apps/ci/base/pipeline.yaml`
- [Image Push](https://github.com/gnunn-gitops/petclinic/blob/main/apps/ci/base/push-image-task.yaml): `apps/ci/base/push-image-task.yaml`
- [SBOM Export](https://github.com/gnunn-gitops/petclinic/blob/main/apps/ci/base/export-sbom-task.yaml): `apps/ci/base/export-sbom-task.yaml`
- [Slack Notification](https://github.com/gnunn-gitops/petclinic/blob/main/apps/ci/base/send-to-slack-task.yaml): `apps/ci/base/send-to-slack-task.yaml`

### GitOps Delivery

- [Argo CD Control](https://github.com/gnunn-gitops/petclinic/blob/main/apps/argocd/base/kustomization.yaml): `apps/argocd/base/kustomization.yaml`
- [Image Updater](https://github.com/gnunn-gitops/petclinic/blob/main/apps/argocd/base/image-updater.yaml): `apps/argocd/base/image-updater.yaml`
- [Promotion Strategy](https://github.com/gnunn-gitops/petclinic/blob/main/apps/argocd/overlays/dual-ps/promotion-strategy.yaml): `apps/argocd/overlays/dual-ps/promotion-strategy.yaml`
- [Environment Overlays](https://github.com/gnunn-gitops/petclinic/tree/main/environments/overlays): `environments/overlays`

### Application Workloads

- [Petclinic Rollout](https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic/base/petclinic-rollout.yaml): `apps/petclinic/base/petclinic-rollout.yaml`
- [Petclinic Service](https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic/base/petclinic-svc.yaml): `apps/petclinic/base/petclinic-svc.yaml`
- [Petclinic Route](https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic/base/petclinic-route.yaml): `apps/petclinic/base/petclinic-route.yaml`
- [Smoke Analysis](https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic/base/smoke-test-analysis.yaml): `apps/petclinic/base/smoke-test-analysis.yaml`

### Application Data

- [Petclinic Database](https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic-db/base/petclinic-db.yaml): `apps/petclinic-db/base/petclinic-db.yaml`
- [Database Service](https://github.com/gnunn-gitops/petclinic/blob/main/apps/petclinic-db/base/petclinic-db-es.yaml): `apps/petclinic-db/base/petclinic-db-es.yaml`

### Other components

- **Developer**
- **Git Provider**
- **Container Registry**
- **Slack**

## Connections

- Developer → Git Provider: commits to
- Git Provider → CI Trigger: triggers
- CI Trigger → Build Pipeline: dispatches
- Build Pipeline → Image Push: runs
- Build Pipeline → SBOM Export: exports
- Image Push → Container Registry: pushes image
- Build Pipeline → Slack Notification: runs
- Slack Notification → Slack: notifies
- Application Bootstrap → Argo CD Control: installs
- Application Bootstrap → Build Pipeline: installs
- Container Registry → Image Updater: provides image
- Image Updater → Promotion Strategy: updates
- Promotion Strategy → Git Provider: writes commits
- Git Provider → Argo CD Control: supplies manifests
- Argo CD Control → Environment Overlays: renders
- Argo CD Control → Petclinic Rollout: deploys
- Argo CD Control → Petclinic Database: deploys
- Petclinic Rollout → Smoke Analysis: runs analysis
- Petclinic Route → Petclinic Service: routes traffic
- Petclinic Database → Database Service: provides service
