# ghassenbz/vikunja architecture

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

- Interactive diagram: https://gitdiagram.com/ghassenbz/vikunja
- Repository: https://github.com/ghassenbz/vikunja

## Overview

This repository provisions a private-network AWS deployment of Vikunja, rather than implementing the Vikunja application itself. The user-facing path is browser → public ALB → static frontend, with API, DAV, and CalDAV requests routed to backend instances; Vikunja uses private RDS for application data and a dedicated S3 bucket for uploads. Terraform modules define the infrastructure, while a first-boot seed populates demo accounts and workspaces through the Vikunja API. The README documents these runtime relationships; Terraform source was not sampled, so edges rely on that documentation.

Main entry points: [`infra/modules/compute/main.tf`](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/compute/main.tf) (Vikunja backend), [`infra/main.tf`](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/main.tf) (Terraform root), [`infra/modules/network/main.tf`](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/network/main.tf) (Application load balancer), [`scripts/backup-data.ps1`](https://github.com/ghassenbz/vikunja/blob/vikunja/scripts/backup-data.ps1) (Backup helper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Ingress and application"]
  node_alb["Application load balancer<br/>[main.tf]"]
  node_frontend["Frontend instances<br/>[main.tf]"]
  node_backend["Vikunja backend<br/>[main.tf]"]
  node_vikunja["Vikunja server"]
end

subgraph group_compute["Compute and bootstrap"]
  node_artifacts[("Release and runtime bucket<br/>[main.tf]")]
  node_profile["Lab instance profile<br/>[main.tf]"]
  node_seed["Demo data seeder<br/>[seed-demo.py]"]
end

subgraph group_data["Persistence"]
  node_rds[("MySQL database<br/>[main.tf]")]
  node_uploads[("Vikunja uploads bucket<br/>[main.tf]")]
  node_backup["Backup helper<br/>[backup-data.ps1]"]
end

subgraph group_provision["Infrastructure definition"]
  node_network["VPC and subnets<br/>[main.tf]"]
  node_security["Security groups<br/>[main.tf]"]
  node_compute_config["Compute configuration<br/>[main.tf]"]
  node_database_config["Database configuration<br/>[main.tf]"]
  node_root["Terraform root<br/>[main.tf]"]
end

node_user(("Browser user"))
node_aws["AWS services"]

node_user -->|"opens app"| node_alb
node_alb -->|"serves default"| node_frontend
node_alb -->|"routes API and DAV"| node_backend
node_frontend -->|"serves static UI"| node_user
node_backend -->|"runs API"| node_vikunja
node_backend -->|"stores app data"| node_rds
node_backend -->|"stores uploads"| node_uploads
node_frontend -->|"downloads bundle and config"| node_artifacts
node_backend -->|"downloads bundle and config"| node_artifacts
node_profile -->|"grants object access"| node_artifacts
node_seed -->|"seeds through API"| node_vikunja
node_backup -->|"snapshots database"| node_rds
node_backup -->|"copies upload data"| node_uploads
node_root -->|"configures"| node_network
node_root -->|"configures"| node_security
node_root -->|"configures"| node_compute_config
node_root -->|"configures"| node_database_config
node_network -->|"provisions network"| node_aws
node_security -->|"provisions controls"| node_aws
node_compute_config -->|"provisions compute"| node_aws
node_database_config -->|"provisions storage"| node_aws

click node_alb "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/network/main.tf"
click node_frontend "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/compute/main.tf"
click node_backend "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/compute/main.tf"
click node_network "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/network/main.tf"
click node_security "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/security/main.tf"
click node_compute_config "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/compute/main.tf"
click node_database_config "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/database/main.tf"
click node_root "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/main.tf"
click node_artifacts "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/compute/main.tf"
click node_profile "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/compute/main.tf"
click node_seed "https://github.com/ghassenbz/vikunja/blob/vikunja/vikunja/seed-demo.py"
click node_rds "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/database/main.tf"
click node_uploads "https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/database/main.tf"
click node_backup "https://github.com/ghassenbz/vikunja/blob/vikunja/scripts/backup-data.ps1"

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_alb,node_frontend,node_backend,node_vikunja,node_user toneBlue
class node_artifacts,node_profile,node_seed toneAmber
class node_rds,node_uploads,node_backup toneMint
class node_network,node_security,node_compute_config,node_database_config,node_root toneRose
class node_aws toneIndigo
```

## Components

### Ingress and application

- [Application load balancer](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/network/main.tf): `infra/modules/network/main.tf`
- [Frontend instances](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/compute/main.tf): `infra/modules/compute/main.tf`
- [Vikunja backend](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/compute/main.tf): `infra/modules/compute/main.tf`
- **Vikunja server**

### Compute and bootstrap

- [Release and runtime bucket](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/compute/main.tf): `infra/modules/compute/main.tf`
- [Lab instance profile](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/compute/main.tf): `infra/modules/compute/main.tf`
- [Demo data seeder](https://github.com/ghassenbz/vikunja/blob/vikunja/vikunja/seed-demo.py): `vikunja/seed-demo.py`

### Persistence

- [MySQL database](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/database/main.tf): `infra/modules/database/main.tf`
- [Vikunja uploads bucket](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/database/main.tf): `infra/modules/database/main.tf`
- [Backup helper](https://github.com/ghassenbz/vikunja/blob/vikunja/scripts/backup-data.ps1): `scripts/backup-data.ps1`

### Infrastructure definition

- [VPC and subnets](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/network/main.tf): `infra/modules/network/main.tf`
- [Security groups](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/security/main.tf): `infra/modules/security/main.tf`
- [Compute configuration](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/compute/main.tf): `infra/modules/compute/main.tf`
- [Database configuration](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/modules/database/main.tf): `infra/modules/database/main.tf`
- [Terraform root](https://github.com/ghassenbz/vikunja/blob/vikunja/infra/main.tf): `infra/main.tf`

### Other components

- **Browser user**
- **AWS services**

## Connections

- Browser user → Application load balancer: opens app (evidence: `README.md`)
- Application load balancer → Frontend instances: serves default (evidence: `README.md`)
- Application load balancer → Vikunja backend: routes API and DAV (evidence: `README.md`)
- Frontend instances → Browser user: serves static UI (evidence: `README.md`)
- Vikunja backend → Vikunja server: runs API (evidence: `README.md`)
- Vikunja backend → MySQL database: stores app data (evidence: `README.md`)
- Vikunja backend → Vikunja uploads bucket: stores uploads (evidence: `README.md`)
- Frontend instances → Release and runtime bucket: downloads bundle and config (evidence: `README.md`)
- Vikunja backend → Release and runtime bucket: downloads bundle and config (evidence: `README.md`)
- Lab instance profile → Release and runtime bucket: grants object access (evidence: `README.md`)
- Demo data seeder → Vikunja server: seeds through API (evidence: `README.md`)
- Backup helper → MySQL database: snapshots database (evidence: `README.md`)
- Backup helper → Vikunja uploads bucket: copies upload data (evidence: `README.md`)
- Terraform root → VPC and subnets: configures (evidence: `README.md`)
- Terraform root → Security groups: configures (evidence: `README.md`)
- Terraform root → Compute configuration: configures (evidence: `README.md`)
- Terraform root → Database configuration: configures (evidence: `README.md`)
- VPC and subnets → AWS services: provisions network (evidence: `README.md`)
- Security groups → AWS services: provisions controls (evidence: `README.md`)
- Compute configuration → AWS services: provisions compute (evidence: `README.md`)
- Database configuration → AWS services: provisions storage (evidence: `README.md`)
