# radzionc/radzionkit architecture

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

- Interactive diagram: https://gitdiagram.com/radzionc/radzionkit
- Repository: https://github.com/radzionc/radzionkit

## Overview

- Monorepo Shell: Represent the overall monorepo container managed via Yarn Workspaces.
- Library Side (lib): Create a cluster that includes all generic packages:
– UI Library (@lib/ui, @lib/next-ui, @lib/countries-ui, @lib/subscription-ui, @lib/analytics-ui, etc.)
– Utility Packages (@lib/utils, codegen, dynamodb, lambda, chain, dnd, etc.)
– Specialized modules (e.g., authentication types in @lib/auth, blockchain interactions in @lib/chain, country handling in @lib/countries).
– API backend (product/api, product/api-interface, product/api-ui, etc.) which contains further modules for auth, resolvers, database access, and AWS Lambda integration.
– Frontend application (product/app) built on Next.js.
– Auxiliary services (email, email-forwarder, secrets, entities, languages, and a UI demo (product/ui-demo)).
– Also include infrastructure-as-code components (Terraform configuration under infra directories and deployment scripts).

- Integration points with external infrastructure: AWS components (Lambda, DynamoDB, Secrets Manager), Terraform-managed resources (represented as a dedicated “Infra” component that links to both API and email-forwarder services).
- Cross-cutting concerns like “analytics” and “codegen” that might be used in both lib and product clusters.

##### Architectural Patterns and Design Principles
- Modular and reusable architecture: Emphasize the separation of concern between generic “lib” packages and project-specific “product” implementations.
- Monorepo Structure: Illustrate the use of Yarn Workspaces as an enabler of dependency sharing and central version control.
- Full-Stack Cohesion: Separate layers for frontend (UI, pages, Next.js configurations), backend (API, authentication, resolvers), and middleware/infrastructure (deployment scripts, Terraform files).
- Infrastructure as Code: Point out that Terraform configurations (files like main.tf, outputs.tf) work alongside API and email components to provision AWS resources.

##### Relevant Technologies, Frameworks, and Tools
- Yarn Workspaces, Next.js, React (in multiple UI libraries), TypeScript.
- AWS Services: Lambda, DynamoDB, Secrets Manager (with Terraform managing configuration).
- Build tools/configurations: Prettier, ESLint, Husky for git hooks, and code generation utilities.

## Diagram (Mermaid)

```mermaid
flowchart TD
    monorepoShell["Monorepo Shell"]:::monorepo

    monorepoShell -->|"contains"| libCluster[/"Lib (Reusable Libraries)"/] 
    monorepoShell -->|"contains"| productCluster[/"Product (Concrete Implementations)"/] 

    subgraph libCluster
        subgraph "UI Libraries"
            ui["@lib/ui – Reusable UI components"]:::lib
            next_ui["@lib/next-ui – Next.js-specific UI components"]:::lib
            countries_ui["@lib/countries-ui – Country UI components"]:::lib
            subscription_ui["@lib/subscription-ui – Subscription UI components"]:::lib
            analytics_ui["@lib/analytics-ui – Analytics UI components"]:::lib
        end

        subgraph "Utility Packages"
            utils["@lib/utils – General utilities"]:::lib
            codegen["codegen – Code generation utilities"]:::lib
            dnd["dnd – Drag and Drop utilities"]:::lib
        end

        subgraph "Domain-Specific Modules"
            chain["chain – Blockchain modules"]:::lib
            auth["@lib/auth – Authentication helpers"]:::lib
            dynamodb["dynmodb utilities – DynamoDB helpers"]:::lib
            lambda["lambda – AWS Lambda integrations"]:::lib
        end
    end

    subgraph productCluster
        subgraph "API Backend"
            api["API Backend – Core API service"]:::product
            api_interface["API Interface"]:::product
            api_ui["API UI"]:::product
            api_infra["API Infra (Terraform)"]:::infra
        end

        subgraph "Frontend"
            app["Frontend Application – Next.js app"]:::product
            app_infra["App Infra (Terraform)"]:::infra
        end

        subgraph "Auxiliary Services"
            email_fw["Email Forwarder Service"]:::product
            email["Email Service"]:::product
            ui_demo["UI Demo"]:::product
            email_fw_infra["Email Forwarder Infra (Terraform)"]:::infra
            secrets_infra["Secrets Infra (Terraform)"]:::infra
        end

        subgraph "Other Product Packages"
            db["Database utilities"]:::product
            languages_next_ui["Languages Next UI"]:::product
            languages["Languages"]:::product
            entities["Entities utilities"]:::product
            entities_utils["Entities utils"]:::product
            secrets["Secrets service"]:::product
        end
    end

    subgraph "External Services"
        aws["AWS Services (Lambda, DynamoDB, Secrets Manager)"]:::external
        terraform["Terraform-managed Infra"]:::external
    end

    %% Dependencies from API service to Lib modules
    api -->|"depends_on"| dynamodb
    api -->|"depends_on"| lambda
    api -->|"depends_on"| chain
    api -->|"depends_on"| auth

    %% Frontend dependencies
    app -->|"uses"| ui
    app -->|"uses"| next_ui

    %% Cross-cutting concerns via codegen and analytics_ui
    app -->|"builds_with"| codegen
    api_ui -->|"builds_with"| codegen
    app -->|"monitors_with"| analytics_ui
    api_ui -->|"monitors_with"| analytics_ui

    %% Infrastructure integration with external AWS and Terraform
    api_infra -->|"provisions"| aws
    email_fw_infra -->|"provisions"| aws
    secrets_infra -->|"provisions"| aws

    api_infra -->|"managed_by"| terraform
    app_infra -->|"managed_by"| terraform
    email_fw_infra -->|"managed_by"| terraform
    secrets_infra -->|"managed_by"| terraform

    %% Click Events
    click monorepoShell "https://github.com/radzionc/radzionkit/blob/main/package.json"
    click ui "https://github.com/radzionc/radzionkit/tree/main/lib/ui"
    click next_ui "https://github.com/radzionc/radzionkit/tree/main/lib/next-ui"
    click countries_ui "https://github.com/radzionc/radzionkit/tree/main/lib/countries-ui"
    click subscription_ui "https://github.com/radzionc/radzionkit/tree/main/lib/subscription-ui"
    click analytics_ui "https://github.com/radzionc/radzionkit/tree/main/lib/analytics-ui"
    click utils "https://github.com/radzionc/radzionkit/tree/main/lib/utils"
    click codegen "https://github.com/radzionc/radzionkit/tree/main/lib/codegen"
    click dnd "https://github.com/radzionc/radzionkit/tree/main/lib/dnd"
    click chain "https://github.com/radzionc/radzionkit/tree/main/lib/chain"
    click auth "https://github.com/radzionc/radzionkit/tree/main/lib/auth"
    click dynamodb "https://github.com/radzionc/radzionkit/tree/main/lib/dynamodb"
    click lambda "https://github.com/radzionc/radzionkit/tree/main/lib/lambda"
    click api "https://github.com/radzionc/radzionkit/tree/main/product/api"
    click api_interface "https://github.com/radzionc/radzionkit/tree/main/product/api-interface"
    click api_ui "https://github.com/radzionc/radzionkit/tree/main/product/api-ui"
    click app "https://github.com/radzionc/radzionkit/tree/main/product/app"
    click email_fw "https://github.com/radzionc/radzionkit/tree/main/product/email-forwarder"
    click email "https://github.com/radzionc/radzionkit/tree/main/product/email"
    click ui_demo "https://github.com/radzionc/radzionkit/tree/main/product/ui-demo"
    click api_infra "https://github.com/radzionc/radzionkit/tree/main/product/api/infra"
    click app_infra "https://github.com/radzionc/radzionkit/tree/main/product/app/infra"
    click email_fw_infra "https://github.com/radzionc/radzionkit/tree/main/product/email-forwarder/infra"
    click secrets_infra "https://github.com/radzionc/radzionkit/tree/main/product/secrets/infra"
    click db "https://github.com/radzionc/radzionkit/tree/main/product/db"
    click languages_next_ui "https://github.com/radzionc/radzionkit/tree/main/product/languages-next-ui"
    click languages "https://github.com/radzionc/radzionkit/tree/main/product/languages"
    click entities "https://github.com/radzionc/radzionkit/tree/main/product/entities"
    click entities_utils "https://github.com/radzionc/radzionkit/tree/main/product/entities-utils"
    click secrets "https://github.com/radzionc/radzionkit/tree/main/product/secrets"

    %% Class Definitions for styling
    classDef monorepo fill:#f7c6c7,stroke:#8b0000,stroke-width:2px;
    classDef lib fill:#bbdefb,stroke:#0d47a1,stroke-width:2px;
    classDef product fill:#c8e6c9,stroke:#1b5e20,stroke-width:2px;
    classDef infra fill:#fff9c4,stroke:#f57f17,stroke-width:2px;
    classDef external fill:#ffe0b2,stroke:#e65100,stroke-width:2px;
```
