# digitalservicebund/ris-adm-vwv architecture

> Architecture diagram of the GitHub repository digitalservicebund/ris-adm-vwv, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/digitalservicebund/ris-adm-vwv
- Repository: https://github.com/digitalservicebund/ris-adm-vwv

## Overview

##### Main Components

a) Frontend Layer:
- Vue.js application (evident from App.vue and Vue-related configurations)
- Static assets and components
- End-to-end testing infrastructure (Playwright)

b) Infrastructure Layer:
- Nginx web server (indicated by nginx.conf)
- Docker containerization (multiple Dockerfile presence)
- CI/CD Pipeline (GitHub Actions workflows)

c) Security Layer:
- Security scanning and checks
- License compliance checking
- Secrets management

**[Client Browsers]**
- ↓
**[Frontend Layer (Vue.js)]**
- ↓
**[Nginx Server Layer]**
- ↓
**[Container Layer]**

##### Detailed Component Breakdown

Frontend Layer (Blue):
- Vue.js components
- Static assets
- Testing infrastructure (Playwright)
- Build tools (Vite)

Infrastructure Layer (Green):
- Include:
- Nginx reverse proxy
- Docker containers
- GitHub Actions CI/CD pipeline

Security Layer (Red):
- Show:
- Pre-push hooks
- Secrets checking
- License compliance
- Security scanning

##### Important Relationships to Highlight

- CI/CD pipeline's interaction with all components
- Flow from frontend through Nginx
- Demonstrate security checks' integration points
- Where testing occurs in the pipeline

##### Additional Elements

Annotations for:
- Build and deployment processes
- Security checkpoint locations
- Testing integration points
- Configuration management

##### Technical Stack Callouts

Technologies:
- Vue.js
- TypeScript
- Nginx
- Docker
- GitHub Actions
- Playwright (E2E testing)
- Vite (Build tool)

##### Specific Recommendations

a) Use standardized symbols:
- Rectangles for processing components
- Clouds for external services

- Component types
- Security checkpoints

c) Notes about:
- Development workflow
- Deployment stages
- Security measures
- Testing strategy

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client
        Browser[Browser]
    end

    subgraph "Frontend Layer"
        VueApp["Vue.js Application"]:::frontend
        Components["Frontend Components"]:::frontend
        Assets["Static Assets"]:::frontend
        E2E["E2E Testing"]:::frontend
        BuildTools["Vite Build Tools"]:::frontend
    end

    subgraph "Infrastructure Layer"
        Nginx["Nginx Server"]:::infra
        Docker["Docker Containers"]:::infra
    end

    subgraph "CI/CD Layer"
        CICD["GitHub Actions Pipeline"]:::cicd
        FrontendCI["Frontend CI/CD"]:::cicd
        SecurityCI["Security CI/CD"]:::cicd
    end

    subgraph "Security Layer"
        SecScanning["Security Scanning"]:::security
        LicenseCheck["License Compliance"]:::security
        SecretsCheck["Secrets Management"]:::security
        CodeQuality["Code Quality Checks"]:::security
    end

    subgraph "Testing Layer"
        PlaywrightConfig["Playwright Config"]:::testing
        VitestConfig["Vitest Config"]:::testing
    end

    Browser --> VueApp
    VueApp --> Components
    VueApp --> Assets
    Components --> Nginx
    Assets --> Nginx
    Nginx --> Docker

    CICD --> FrontendCI
    CICD --> SecurityCI
    FrontendCI --> VueApp
    SecurityCI --> SecScanning
    SecurityCI --> LicenseCheck
    SecurityCI --> SecretsCheck
    SecurityCI --> CodeQuality

    E2E --> PlaywrightConfig
    BuildTools --> VitestConfig

    %% Click Events
    click VueApp "https://github.com/digitalservicebund/ris-adm-vwv/blob/main/frontend/src/App.vue"
    click Components "https://github.com/digitalservicebund/ris-adm-vwv/tree/main/frontend/src/components/"
    click Assets "https://github.com/digitalservicebund/ris-adm-vwv/tree/main/frontend/src/assets/"
    click E2E "https://github.com/digitalservicebund/ris-adm-vwv/tree/main/frontend/e2e/"
    click Nginx "https://github.com/digitalservicebund/ris-adm-vwv/blob/main/nginx.conf"
    click Docker "https://github.com/digitalservicebund/ris-adm-vwv/tree/main/Dockerfile"
    click CICD "https://github.com/digitalservicebund/ris-adm-vwv/blob/main/.github/workflows/pipeline.yml"
    click FrontendCI "https://github.com/digitalservicebund/ris-adm-vwv/blob/main/.github/workflows/frontend-jobs.yml"
    click SecurityCI "https://github.com/digitalservicebund/ris-adm-vwv/blob/main/.github/workflows/security-jobs.yml"
    click LicenseCheck "https://github.com/digitalservicebund/ris-adm-vwv/blob/main/allowed-licenses.json"
    click SecretsCheck "https://github.com/digitalservicebund/ris-adm-vwv/blob/main/.lefthook/pre-push/secrets-audit.sh"
    click CodeQuality "https://github.com/digitalservicebund/ris-adm-vwv/blob/main/.lefthook/pre-push/formatting-check.sh"
    click BuildTools "https://github.com/digitalservicebund/ris-adm-vwv/blob/main/frontend/vite.config.ts"
    click PlaywrightConfig "https://github.com/digitalservicebund/ris-adm-vwv/blob/main/frontend/playwright.config.ts"
    click VitestConfig "https://github.com/digitalservicebund/ris-adm-vwv/blob/main/frontend/vitest.config.ts"

    %% Styling
    classDef frontend fill:#2196F3,color:white
    classDef infra fill:#4CAF50,color:white
    classDef cicd fill:#FFC107,color:black
    classDef security fill:#F44336,color:white
    classDef testing fill:#9C27B0,color:white

    %% Legend
    subgraph Legend
        Frontend["Frontend Component"]:::frontend
        Infrastructure["Infrastructure Component"]:::infra
        CICDComponent["CI/CD Component"]:::cicd
        SecurityComponent["Security Component"]:::security
        TestingComponent["Testing Component"]:::testing
    end
```
