# yurikrupnik/mussia33 architecture

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

- Interactive diagram: https://gitdiagram.com/yurikrupnik/mussia33
- Repository: https://github.com/yurikrupnik/mussia33

## Overview

##### Project type and purpose
- This is a polyglot, monorepo‐style full-stack workspace managed by Nx.
- It contains multiple “apps” (SolidJS frontend, REST/gRPC back-ends in Deno, Go, Node, Rust), shared “libs,” and infrastructure definitions (Pulumi/IaC, Kubernetes manifests, Crossplane/CUE packages).
- CI/CD is driven by CircleCI and GitHub Actions; Tilt and Taskfile.yaml scripts orchestrate local dev environments.

##### File structure
- Top-level folders:
– apps/: each subfolder is a deployable microservice or front-end (apps/deno, apps/frontend, apps/go, apps/node, apps/rust, apps/iac).
– libs/: shared code and gRPC/Proto bindings used by multiple services.
– platform/ & k8s/: cluster definition, GitOps (ArgoCD/Flux), Crossplane compositions, CUE modules.
– .github/ & .circleci/: CI pipelines for build, lint, test, Docker image lifecycle.
– clusters/: Flux-managed cluster bootstrap config.
– Tiltfile, Taskfile.yaml: developer environment orchestration.
- Configuration: Dockerfiles (multiple runtimes), Tiltfiles, Pulumi configs (apps/iac), Crossplane YAMLs, Kubernetes Kustomize overlays.

##### README
- Confirms it is an Nx workspace for large “mono-repo” with dependency graphing (nx graph).
- Encourages remote caching and explains that Nx is the orchestrator.

##### Key reminders
– Be exhaustive: include every app, every lib, and each infra component.
– Show data flows clearly (which service calls which).
– Capture all essential architectural elements; monorepo, polyglot microservices, IaC, GitOps, and developer tooling.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Control Plane
    subgraph "Nx Workspace (Control Plane)"
        direction TB
        NX["Nx Workspace"]:::control
    end
    click NX "https://github.com/yurikrupnik/mussia33/blob/main/nx.json"

    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        FE["SolidJS App"]:::frontend
    end
    click FE "https://github.com/yurikrupnik/mussia33/tree/main/apps/frontend/solid-app"

    %% Backend Services
    subgraph "Backend Services"
        direction TB
        DENO["Deno NestJS Service"]:::backend
        GO["Go Fiber API"]:::backend
        NODE_NEST["Node NestJS API"]:::backend
        NODE_PUB["Node Pub/Sub Microservice"]:::backend
        NODE_GRPC["Node Users gRPC Service"]:::backend
        NODE_RED["Node Users Redis Service"]:::backend
        RUST_ACTIX["Rust Actix Service"]:::backend
        RUST_AXUM["Rust Axum Service"]:::backend
        RUST_SALVO["Rust Salvo Service"]:::backend
    end
    click DENO "https://github.com/yurikrupnik/mussia33/tree/main/apps/deno/nest-app"
    click GO "https://github.com/yurikrupnik/mussia33/tree/main/apps/go/fiber-app"
    click NODE_NEST "https://github.com/yurikrupnik/mussia33/tree/main/apps/node/nest-app"
    click NODE_PUB "https://github.com/yurikrupnik/mussia33/tree/main/apps/node/node-pubsub"
    click NODE_GRPC "https://github.com/yurikrupnik/mussia33/tree/main/apps/node/node-users-grpc"
    click NODE_RED "https://github.com/yurikrupnik/mussia33/tree/main/apps/node/node-users-redis"
    click RUST_ACTIX "https://github.com/yurikrupnik/mussia33/tree/main/apps/rust/actix_app"
    click RUST_AXUM "https://github.com/yurikrupnik/mussia33/tree/main/apps/rust/axum_app"
    click RUST_SALVO "https://github.com/yurikrupnik/mussia33/tree/main/apps/rust/salvo_app"

    %% Shared Libraries & Proto
    subgraph "Shared Libraries & Proto"
        direction TB
        PROTO["_proto Definitions"]:::shared
        LIB_GO["Go Helpers & gRPC"]:::shared
        LIB_NODE["Node Bindings & gRPC"]:::shared
        LIB_RUST["Rust Shared Crates"]:::shared
    end
    click PROTO "https://github.com/yurikrupnik/mussia33/tree/main/_proto"
    click LIB_GO "https://github.com/yurikrupnik/mussia33/tree/main/libs/go"
    click LIB_NODE "https://github.com/yurikrupnik/mussia33/tree/main/libs/node/bindings"
    click LIB_RUST "https://github.com/yurikrupnik/mussia33/tree/main/libs/rust/grpc"

    %% Infrastructure & Platform
    subgraph "Infrastructure & Platform"
        direction TB
        PULUMI["Pulumi IaC"]:::infra
        CROSSPLANE["Crossplane Compositions"]:::infra
        CUE["CUE Kubernetes Modules"]:::infra
        K8S_BASE["K8s Base & Overlays"]:::infra
    end
    click PULUMI "https://github.com/yurikrupnik/mussia33/tree/main/apps/iac"
    click CROSSPLANE "https://github.com/yurikrupnik/mussia33/tree/main/platform/crossplane-package"
    click CUE "https://github.com/yurikrupnik/mussia33/tree/main/platform/cue"
    click K8S_BASE "https://github.com/yurikrupnik/mussia33/tree/main/k8s/base"

    %% Kubernetes Clusters
    subgraph "Kubernetes Clusters"
        direction TB
        CLUSTER["FluxCD Bootstrap"]:::infra
    end
    click CLUSTER "https://github.com/yurikrupnik/mussia33/tree/main/clusters/main/flux-system"

    %% CI/CD Pipelines
    subgraph "CI/CD Pipelines"
        direction TB
        GH["GitHub Actions"]:::ci
        CC["CircleCI"]:::ci
        REG["Docker Registry"]:::ci
    end
    click GH "https://github.com/yurikrupnik/mussia33/tree/main/.github/workflows/"
    click CC "https://github.com/yurikrupnik/mussia33/blob/main/.circleci/config.yml"

    %% Developer Tools
    subgraph "Developer Tools"
        direction TB
        TILT["Tiltfile"]:::tool
        TASK["Taskfile.yaml"]:::tool
    end
    click TILT "https://github.com/yurikrupnik/mussia33/tree/main/Tiltfile"
    click TASK "https://github.com/yurikrupnik/mussia33/blob/main/Taskfile.yaml"

    %% External Services
    subgraph "External Services"
        direction TB
        REDIS["Redis"]:::external
        PG["Postgres"]:::external
        MONGO["MongoDB"]:::external
        PUBSUB["GCP Pub/Sub"]:::external
        CP_PROV["Crossplane Providers"]:::external
    end

    %% Relationships
    NX --> FE
    NX --> DENO
    NX --> GO
    NX --> NODE_NEST
    NX --> RUST_ACTIX

    FE -->|HTTP/gRPC| DENO
    FE -->|HTTP| GO
    FE -->|HTTP| NODE_NEST

    DENO -->|imports| PROTO
    GO -->|imports| PROTO
    NODE_NEST -->|imports| PROTO
    NODE_PUB -->|imports| PROTO
    NODE_GRPC -->|imports| PROTO
    NODE_RED -->|imports| PROTO
    RUST_ACTIX -->|imports| PROTO
    RUST_AXUM -->|imports| PROTO
    RUST_SALVO -->|imports| PROTO

    PROTO --> LIB_GO
    PROTO --> LIB_NODE
    PROTO --> LIB_RUST

    PULUMI --> CLUSTER
    CROSSPLANE --> CLUSTER
    CUE --> CLUSTER
    K8S_BASE --> CLUSTER

    GH --> REG
    CC --> REG
    REG --> CLUSTER

    TILT --> CLUSTER
    TASK --> CLUSTER

    DENO -->|DB| PG
    GO -->|DB| MONGO
    NODE_RED -->|Cache| REDIS
    NODE_PUB -->|pub/sub| PUBSUB
    CROSSPLANE --> CP_PROV

    %% Styles
    classDef control fill:#f2f2f2,stroke:#333,stroke-width:2px;
    classDef frontend fill:#cce5ff,stroke:#004085;
    classDef backend fill:#d4edda,stroke:#155724;
    classDef shared fill:#fff3cd,stroke:#856404;
    classDef infra fill:#ffe5b4,stroke:#cc8400;
    classDef ci fill:#e2e3e5,stroke:#6c757d;
    classDef tool fill:#ececec,stroke:#888;
    classDef external fill:#f8d7da,stroke:#721c24;
```
