# zenpharma/gitops architecture

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

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

## Overview

This repository is deployment configuration for a pharma application: it defines Argo CD applications, environment-specific Helm values, a shared Kubernetes chart, and some direct Kubernetes manifests. The intended workflow is Argo CD reconciliation of application definitions into Kubernetes workloads. The tree suggests service-to-values mappings, but no README or source excerpts were available to verify manifest references, chart settings, database use, or runtime service interactions.

Main entry points: [`argocd/apps/dev/api-gateway-app.yaml`](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/api-gateway-app.yaml) (API gateway app), [`argocd/apps/dev/auth-service-app.yaml`](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/auth-service-app.yaml) (Auth app), [`argocd/apps/dev/catalog-service-app.yaml`](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/catalog-service-app.yaml) (Catalog app), [`argocd/apps/dev/inventory-service-app.yaml`](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/inventory-service-app.yaml) (Inventory app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Argo CD apps"]
  node_api_app["API gateway app"]
  node_auth_app["Auth app"]
  node_catalog_app["Catalog app"]
  node_inventory_app["Inventory app"]
  node_manufacturing_app["Manufacturing app"]
  node_notification_app["Notification app"]
  node_ui_dev_app["Pharma UI dev app<br/>[pharma-ui-app.yaml]"]
  node_qc_app["QC app"]
  node_supplier_app["Supplier app"]
  node_ui_qa_app["Pharma UI QA app<br/>[pharma-ui-app.yaml]"]
end

subgraph group_config["Environment values"]
  node_api_values["API values"]
  node_auth_values["Auth values"]
  node_catalog_values["Catalog values"]
  node_inventory_values["Inventory values"]
  node_manufacturing_values["Manufacturing values"]
  node_notification_values["Notification values"]
  node_ui_dev_values["Pharma UI dev values"]
  node_qc_values["QC values"]
  node_supplier_values["Supplier values"]
  node_ui_qa_values["Pharma UI QA values"]
end

subgraph group_deploy["Kubernetes deployment"]
  node_chart["Shared Helm chart"]
  node_raw_ui["Direct UI manifests"]
  node_db_init["Database schema init<br/>[01-schemas.sql]"]
end

node_argocd(("Argo CD"))
node_cluster["Kubernetes cluster"]

node_argocd -->|"reads"| node_api_app
node_argocd -->|"reads"| node_auth_app
node_argocd -->|"reads"| node_catalog_app
node_argocd -->|"reads"| node_inventory_app
node_argocd -->|"reads"| node_manufacturing_app
node_argocd -->|"reads"| node_notification_app
node_argocd -->|"reads"| node_ui_dev_app
node_argocd -->|"reads"| node_qc_app
node_argocd -->|"reads"| node_supplier_app
node_argocd -->|"reads"| node_ui_qa_app
node_api_app -->|"uses values"| node_api_values
node_auth_app -->|"uses values"| node_auth_values
node_catalog_app -->|"uses values"| node_catalog_values
node_inventory_app -->|"uses values"| node_inventory_values
node_manufacturing_app -->|"uses values"| node_manufacturing_values
node_notification_app -->|"uses values"| node_notification_values
node_ui_dev_app -->|"uses values"| node_ui_dev_values
node_qc_app -->|"uses values"| node_qc_values
node_supplier_app -->|"uses values"| node_supplier_values
node_ui_qa_app -->|"uses values"| node_ui_qa_values
node_argocd -->|"renders"| node_chart
node_argocd -->|"reconciles"| node_cluster

click node_api_app "https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/api-gateway-app.yaml"
click node_auth_app "https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/auth-service-app.yaml"
click node_catalog_app "https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/catalog-service-app.yaml"
click node_inventory_app "https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/inventory-service-app.yaml"
click node_manufacturing_app "https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/manufacturing-service-app.yaml"
click node_notification_app "https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/notification-service-app.yaml"
click node_ui_dev_app "https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/pharma-ui-app.yaml"
click node_qc_app "https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/qc-service-app.yaml"
click node_supplier_app "https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/supplier-service-app.yaml"
click node_ui_qa_app "https://github.com/zenpharma/gitops/blob/main/argocd/apps/qa/pharma-ui-app.yaml"
click node_api_values "https://github.com/zenpharma/gitops/blob/main/envs/dev/values-api-gateway.yaml"
click node_auth_values "https://github.com/zenpharma/gitops/blob/main/envs/dev/values-auth-service.yaml"
click node_catalog_values "https://github.com/zenpharma/gitops/blob/main/envs/dev/values-catalog-service.yaml"
click node_inventory_values "https://github.com/zenpharma/gitops/blob/main/envs/dev/values-inventory-service.yaml"
click node_manufacturing_values "https://github.com/zenpharma/gitops/blob/main/envs/dev/values-manufacturing-service.yaml"
click node_notification_values "https://github.com/zenpharma/gitops/blob/main/envs/dev/values-notification-service.yaml"
click node_ui_dev_values "https://github.com/zenpharma/gitops/blob/main/envs/dev/values-pharma-ui.yaml"
click node_qc_values "https://github.com/zenpharma/gitops/blob/main/envs/dev/values-qc-service.yaml"
click node_supplier_values "https://github.com/zenpharma/gitops/blob/main/envs/dev/values-supplier-service.yaml"
click node_ui_qa_values "https://github.com/zenpharma/gitops/blob/main/envs/qa/values-pharma-ui.yaml"
click node_chart "https://github.com/zenpharma/gitops/tree/main/helm-charts"
click node_raw_ui "https://github.com/zenpharma/gitops/tree/main/k8s/raw-manifests/dev"
click node_db_init "https://github.com/zenpharma/gitops/blob/main/db-init/01-schemas.sql"

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_api_app,node_auth_app,node_catalog_app,node_inventory_app,node_manufacturing_app,node_notification_app,node_ui_dev_app,node_qc_app,node_supplier_app,node_ui_qa_app toneBlue
class node_api_values,node_auth_values,node_catalog_values,node_inventory_values,node_manufacturing_values,node_notification_values,node_ui_dev_values,node_qc_values,node_supplier_values,node_ui_qa_values toneAmber
class node_chart,node_raw_ui,node_db_init toneMint
class node_argocd,node_cluster toneIndigo
```

## Components

### Argo CD apps

- [API gateway app](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/api-gateway-app.yaml): `argocd/apps/dev/api-gateway-app.yaml`
- [Auth app](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/auth-service-app.yaml): `argocd/apps/dev/auth-service-app.yaml`
- [Catalog app](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/catalog-service-app.yaml): `argocd/apps/dev/catalog-service-app.yaml`
- [Inventory app](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/inventory-service-app.yaml): `argocd/apps/dev/inventory-service-app.yaml`
- [Manufacturing app](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/manufacturing-service-app.yaml): `argocd/apps/dev/manufacturing-service-app.yaml`
- [Notification app](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/notification-service-app.yaml): `argocd/apps/dev/notification-service-app.yaml`
- [Pharma UI dev app](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/pharma-ui-app.yaml): `argocd/apps/dev/pharma-ui-app.yaml`
- [QC app](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/qc-service-app.yaml): `argocd/apps/dev/qc-service-app.yaml`
- [Supplier app](https://github.com/zenpharma/gitops/blob/main/argocd/apps/dev/supplier-service-app.yaml): `argocd/apps/dev/supplier-service-app.yaml`
- [Pharma UI QA app](https://github.com/zenpharma/gitops/blob/main/argocd/apps/qa/pharma-ui-app.yaml): `argocd/apps/qa/pharma-ui-app.yaml`

### Environment values

- [API values](https://github.com/zenpharma/gitops/blob/main/envs/dev/values-api-gateway.yaml): `envs/dev/values-api-gateway.yaml`
- [Auth values](https://github.com/zenpharma/gitops/blob/main/envs/dev/values-auth-service.yaml): `envs/dev/values-auth-service.yaml`
- [Catalog values](https://github.com/zenpharma/gitops/blob/main/envs/dev/values-catalog-service.yaml): `envs/dev/values-catalog-service.yaml`
- [Inventory values](https://github.com/zenpharma/gitops/blob/main/envs/dev/values-inventory-service.yaml): `envs/dev/values-inventory-service.yaml`
- [Manufacturing values](https://github.com/zenpharma/gitops/blob/main/envs/dev/values-manufacturing-service.yaml): `envs/dev/values-manufacturing-service.yaml`
- [Notification values](https://github.com/zenpharma/gitops/blob/main/envs/dev/values-notification-service.yaml): `envs/dev/values-notification-service.yaml`
- [Pharma UI dev values](https://github.com/zenpharma/gitops/blob/main/envs/dev/values-pharma-ui.yaml): `envs/dev/values-pharma-ui.yaml`
- [QC values](https://github.com/zenpharma/gitops/blob/main/envs/dev/values-qc-service.yaml): `envs/dev/values-qc-service.yaml`
- [Supplier values](https://github.com/zenpharma/gitops/blob/main/envs/dev/values-supplier-service.yaml): `envs/dev/values-supplier-service.yaml`
- [Pharma UI QA values](https://github.com/zenpharma/gitops/blob/main/envs/qa/values-pharma-ui.yaml): `envs/qa/values-pharma-ui.yaml`

### Kubernetes deployment

- [Shared Helm chart](https://github.com/zenpharma/gitops/tree/main/helm-charts): `helm-charts`
- [Direct UI manifests](https://github.com/zenpharma/gitops/tree/main/k8s/raw-manifests/dev): `k8s/raw-manifests/dev`
- [Database schema init](https://github.com/zenpharma/gitops/blob/main/db-init/01-schemas.sql): `db-init/01-schemas.sql`

### Other components

- **Argo CD**
- **Kubernetes cluster**

## Connections

- Argo CD → API gateway app: reads
- Argo CD → Auth app: reads
- Argo CD → Catalog app: reads
- Argo CD → Inventory app: reads
- Argo CD → Manufacturing app: reads
- Argo CD → Notification app: reads
- Argo CD → Pharma UI dev app: reads
- Argo CD → QC app: reads
- Argo CD → Supplier app: reads
- Argo CD → Pharma UI QA app: reads
- API gateway app → API values: uses values
- Auth app → Auth values: uses values
- Catalog app → Catalog values: uses values
- Inventory app → Inventory values: uses values
- Manufacturing app → Manufacturing values: uses values
- Notification app → Notification values: uses values
- Pharma UI dev app → Pharma UI dev values: uses values
- QC app → QC values: uses values
- Supplier app → Supplier values: uses values
- Pharma UI QA app → Pharma UI QA values: uses values
- Argo CD → Shared Helm chart: renders
- Argo CD → Kubernetes cluster: reconciles