# mguay22/nestjs-rabbitmq-microservices architecture

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

- Interactive diagram: https://gitdiagram.com/mguay22/nestjs-rabbitmq-microservices
- Repository: https://github.com/mguay22/nestjs-rabbitmq-microservices

## Overview

##### Project Type and Purpose
- This is a NestJS-based microservices monorepo.
- It implements three domain services—Auth, Orders, and Billing—plus a shared library (libs/common) for cross-cutting concerns (database access, RabbitMQ integration, authentication guards).
- Services are containerized via Docker, orchestrated with docker-compose, and communicate via HTTP and RabbitMQ.

##### File-Structure Analysis
- Top-level “apps/” directory holds three services:
- apps/auth
- apps/orders
- apps/billing
- Each service has its own Dockerfile, .env, src/ modules, and e2e tests.
- “libs/common” contains shared Nest modules: database (abstract.repository, schema, DatabaseModule), RMQ (rmq.module, rmq.service), and auth guards/strategies.
- Root holds docker-compose.yml (to spin up RabbitMQ, MongoDBs, and service containers), Nest CLI config, tsconfig files, lint/prettier configs.

##### Detail
- How guards and strategies from libs/common plug into service modules.
- If the compose file spins up multiple MongoDBs or a replica set, reflect that.
- If there’s an API gateway or ingress layer, include it.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External client
    Client("External Client"):::client

    %% Auth Service
    subgraph "Auth Service"
        direction TB
        A_main["main.ts"]:::micro
        A_mod["auth.module.ts"]:::micro
        A_ctrl["auth.controller.ts"]:::micro
        A_svc["auth.service.ts"]:::micro
        A_jwtStr["jwt.strategy.ts"]:::micro
        A_locStr["local.strategy.ts"]:::micro
        A_jwtGuard["jwt-auth.guard.ts"]:::micro
        A_locGuard["local-auth.guard.ts"]:::micro
        A_usersMod["users.module.ts"]:::micro
        A_usersCtrl["users.controller.ts"]:::micro
        A_usersSvc["users.service.ts"]:::micro
        A_usersRepo["users.repository.ts"]:::micro
        A_userSchema["user.schema.ts"]:::micro
    end

    %% Orders Service
    subgraph "Orders Service"
        direction TB
        O_main["main.ts"]:::micro
        O_mod["orders.module.ts"]:::micro
        O_ctrl["orders.controller.ts"]:::micro
        O_svc["orders.service.ts"]:::micro
        O_repo["orders.repository.ts"]:::micro
        O_schema["order.schema.ts"]:::micro
        O_const["constants/services.ts"]:::micro
        O_dto["create-order.request.ts"]:::micro
    end

    %% Billing Service
    subgraph "Billing Service"
        direction TB
        B_main["main.ts"]:::micro
        B_mod["billing.module.ts"]:::micro
        B_ctrl["billing.controller.ts"]:::micro
        B_svc["billing.service.ts"]:::micro
    end

    %% Shared Library
    subgraph "Shared Library"
        direction TB
        style SharedLibrary stroke-dasharray: 5 5,stroke:gray
        S_index["index.ts"]:::shared
        S_authMod["auth.module.ts"]:::shared
        S_jwtGuard["jwt-auth.guard.ts"]:::shared
        S_services["services.ts"]:::shared
        S_dbMod["database.module.ts"]:::shared
        S_abstractRepo["abstract.repository.ts"]:::shared
        S_abstractSchema["abstract.schema.ts"]:::shared
        S_rmqMod["rmq.module.ts"]:::shared
        S_rmqSvc["rmq.service.ts"]:::shared
    end

    %% Message Broker and Databases
    RabbitMQ["RabbitMQ"]:::mq
    subgraph "Databases"
        direction TB
        DB_users["MongoDB (Users)"]:::db
        DB_orders["MongoDB (Orders)"]:::db
        DB_billing["MongoDB (Billing)"]:::db
    end

    %% Relationships
    Client -->|"HTTP (login/signup)"| A_ctrl
    A_ctrl -->|"calls"| A_svc
    A_svc -->|"uses repository"| A_usersRepo
    A_usersRepo -->|"reads/writes"| DB_users
    A_svc -->|"issues JWT"| Client

    Client -->|"HTTP (orders) with JWT"| O_ctrl
    O_ctrl -->|"calls"| O_svc
    O_svc -->|"uses repository"| O_repo
    O_repo -->|"reads/writes"| DB_orders
    O_svc -->|"publishes order_created"| RabbitMQ

    RabbitMQ -->|"order_created event"| B_svc
    B_svc -->|"writes"| DB_billing

    %% Shared imports
    A_mod -->|"imports"| S_dbMod
    A_mod -->|"imports"| S_rmqMod
    A_mod -->|"imports"| S_authMod

    O_mod -->|"imports"| S_dbMod
    O_mod -->|"imports"| S_rmqMod

    B_mod -->|"imports"| S_dbMod
    B_mod -->|"imports"| S_rmqMod

    %% Click Events Auth Service
    click A_main "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/main.ts"
    click A_mod "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/auth.module.ts"
    click A_ctrl "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/auth.controller.ts"
    click A_svc "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/auth.service.ts"
    click A_jwtStr "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/strategies/jwt.strategy.ts"
    click A_locStr "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/strategies/local.strategy.ts"
    click A_jwtGuard "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/guards/jwt-auth.guard.ts"
    click A_locGuard "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/guards/local-auth.guard.ts"
    click A_usersMod "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/users/users.module.ts"
    click A_usersCtrl "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/users/users.controller.ts"
    click A_usersSvc "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/users/users.service.ts"
    click A_usersRepo "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/users/users.repository.ts"
    click A_userSchema "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/auth/src/users/schemas/user.schema.ts"
    click A_main "https://github.com/mguay22/nestjs-rabbitmq-microservices/tree/main/apps/auth/Dockerfile"
    click A_main "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/.env"

    %% Click Events Orders Service
    click O_main "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/orders/src/main.ts"
    click O_mod "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/orders/src/orders.module.ts"
    click O_ctrl "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/orders/src/orders.controller.ts"
    click O_svc "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/orders/src/orders.service.ts"
    click O_repo "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/orders/src/orders.repository.ts"
    click O_schema "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/orders/src/schemas/order.schema.ts"
    click O_const "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/orders/src/constants/services.ts"
    click O_dto "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/orders/src/dto/create-order.request.ts"
    click O_main "https://github.com/mguay22/nestjs-rabbitmq-microservices/tree/main/apps/orders/Dockerfile"
    click O_main "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/.env"

    %% Click Events Billing Service
    click B_main "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/billing/src/main.ts"
    click B_mod "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/billing/src/billing.module.ts"
    click B_ctrl "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/billing/src/billing.controller.ts"
    click B_svc "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/apps/billing/src/billing.service.ts"
    click B_main "https://github.com/mguay22/nestjs-rabbitmq-microservices/tree/main/apps/billing/Dockerfile"
    click B_main "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/.env"

    %% Click Events Shared Library
    click S_index "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/libs/common/src/index.ts"
    click S_authMod "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/libs/common/src/auth/auth.module.ts"
    click S_jwtGuard "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/libs/common/src/auth/jwt-auth.guard.ts"
    click S_services "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/libs/common/src/auth/services.ts"
    click S_dbMod "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/libs/common/src/database/database.module.ts"
    click S_abstractRepo "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/libs/common/src/database/abstract.repository.ts"
    click S_abstractSchema "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/libs/common/src/database/abstract.schema.ts"
    click S_rmqMod "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/libs/common/src/rmq/rmq.module.ts"
    click S_rmqSvc "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/libs/common/src/rmq/rmq.service.ts"

    %% Click Events Infrastructure
    click RabbitMQ "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/docker-compose.yml"
    click DB_users "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/docker-compose.yml"
    click DB_orders "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/docker-compose.yml"
    click DB_billing "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/docker-compose.yml"
    click DB_billing "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/.dockerignore"
    click DB_billing "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/nest-cli.json"
    click DB_billing "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/tsconfig.build.json"
    click DB_billing "https://github.com/mguay22/nestjs-rabbitmq-microservices/blob/main/tsconfig.json"

    %% Styles
    classDef micro fill:#D0E6FF,stroke:#0366D6,color:#0366D6;
    classDef db fill:#DFFFE0,stroke:#28A745,color:#28A745;
    classDef mq fill:#FFEBCD,stroke:#FF8C00,color:#FF8C00;
    classDef shared fill:#F0F0F0,stroke:#999999,color:#333333;
    classDef client fill:#F5E6FF,stroke:#6F42C1,color:#6F42C1;
```
