# parthasarathyhmh/austria-dash-api architecture

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

- Interactive diagram: https://gitdiagram.com/parthasarathyhmh/austria-dash-api
- Repository: https://github.com/parthasarathyhmh/austria-dash-api

## Overview

This repository is a NestJS Loyalty Dashboard API. Clients call domain controllers, which delegate operations to services; the API covers authentication and access control, workspace/project setup, catalog and pricing, orders and inventory, customer/distributor records, and dashboard content/configuration. The source index confirms many controller-to-service relationships, while excerpts show several directly. Storage and some service internals were not sampled, so the graph avoids inferring their persistence or cross-domain call chains.

Main entry points: [`src/app.module.ts`](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/app.module.ts) (Nest application), [`src/auth/auth.service.ts`](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/auth/auth.service.ts) (Authentication), [`src/distributors/distributors.service.ts`](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/distributors/distributors.service.ts) (Distributor records), [`src/products/products.service.ts`](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/products/products.service.ts) (Product catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_authrepo["Admin repository<br/>[auth.repository.ts]"]
  node_roles["Role management<br/>[roles.service.ts]"]
  node_modules["Permission modules<br/>[modules.service.ts]"]
end

subgraph group_commerce["Commerce operations"]
  node_customers["Customer records"]
  node_distributors["Distributor records"]
  node_products["Product catalog"]
  node_categories["Categories"]
  node_prices["Price management<br/>[prices.service.ts]"]
  node_orders["Order management<br/>[orders.service.ts]"]
  node_inventory["Inventory management"]
  node_rules["Catalog and sales rules"]
  node_taxes["Tax management<br/>[taxes.service.ts]"]
end

subgraph group_setup["Workspace setup"]
  node_workspace["Workspace management"]
  node_project["Project management<br/>[project.service.ts]"]
  node_routing["Routing management<br/>[routing.service.ts]"]
end

subgraph group_content["Dashboard content"]
  node_cms["CMS pages and banners"]
  node_footer["Footer content<br/>[footer.service.ts]"]
  node_banners["Banner content<br/>[banners.service.ts]"]
end

subgraph group_platform["Platform services"]
  node_app["Nest application<br/>[app.module.ts]"]
  node_messages["Message queue API"]
  node_systemconfig["System configuration"]
  node_territory["Territory management"]
end

node_client(("API client"))

node_app -->|"registers module"| node_auth
node_app -->|"registers module"| node_roles
node_app -->|"registers module"| node_modules
node_app -->|"registers module"| node_customers
node_app -->|"registers module"| node_products
node_app -->|"registers module"| node_orders
node_app -->|"registers module"| node_categories
node_app -->|"registers module"| node_rules
node_app -->|"registers module"| node_prices
node_app -->|"registers module"| node_inventory
node_app -->|"registers module"| node_routing
node_app -->|"registers module"| node_taxes
node_app -->|"registers module"| node_territory
node_app -->|"registers module"| node_cms
node_app -->|"registers module"| node_banners
node_app -->|"registers module"| node_footer
node_app -->|"registers module"| node_messages
node_app -->|"registers module"| node_distributors
node_app -->|"registers module"| node_workspace
node_app -->|"registers module"| node_project
node_app -->|"registers module"| node_systemconfig
node_client -->|"submits credentials"| node_auth
node_auth -->|"checks admin role"| node_authrepo
node_auth -->|"loads role data"| node_roles
node_auth -->|"delegates requests"| node_customers
node_client -->|"requests records"| node_customers
node_client -->|"requests records"| node_distributors
node_distributors -->|"returns records"| node_client
node_client -->|"requests catalog"| node_products
node_products -->|"returns catalog"| node_client
node_client -->|"requests categories"| node_categories
node_client -->|"requests orders"| node_orders
node_client -->|"manages workspace"| node_workspace
node_workspace -->|"returns workspace"| node_client
node_client -->|"manages projects"| node_project
node_client -->|"manages messages"| node_messages
node_auth -->|"issues token"| node_client
node_auth -.->|"may verify token"| node_client

click node_app "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/app.module.ts"
click node_auth "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/auth/auth.service.ts"
click node_authrepo "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/auth/auth.repository.ts"
click node_roles "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/role-permission/roles/roles.service.ts"
click node_modules "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/role-permission/modules/modules.service.ts"
click node_customers "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/customer/customer.service.ts"
click node_distributors "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/distributors/distributors.service.ts"
click node_products "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/products/products.service.ts"
click node_categories "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/category/category.service.ts"
click node_prices "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/prices/prices.service.ts"
click node_orders "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/orders/orders.service.ts"
click node_inventory "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/inventory/services/normal-inventory.service.ts"
click node_rules "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/rules/services/catalog-rule.service.ts"
click node_taxes "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/taxes/taxes.service.ts"
click node_workspace "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/workspace/workspace.service.ts"
click node_project "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/project/project.service.ts"
click node_routing "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/routing/routing.service.ts"
click node_cms "https://github.com/parthasarathyhmh/austria-dash-api/tree/main/src/cms/pages"
click node_footer "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/cms/footer/footer.service.ts"
click node_banners "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/cms/banners/banners.service.ts"
click node_messages "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/messagequeue/messagequeue.service.ts"
click node_systemconfig "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/systemconfig/systemconfig.service.ts"
click node_territory "https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/territory/territory.service.ts"

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_auth,node_authrepo,node_roles,node_modules,node_client toneBlue
class node_customers,node_distributors,node_products,node_categories,node_prices,node_orders,node_inventory,node_rules,node_taxes toneAmber
class node_workspace,node_project,node_routing toneMint
class node_cms,node_footer,node_banners toneRose
class node_app,node_messages,node_systemconfig,node_territory toneIndigo
```

## Components

### Identity and access

- [Authentication](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/auth/auth.service.ts): `src/auth/auth.service.ts`
- [Admin repository](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/auth/auth.repository.ts): `src/auth/auth.repository.ts`
- [Role management](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/role-permission/roles/roles.service.ts): `src/role-permission/roles/roles.service.ts`
- [Permission modules](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/role-permission/modules/modules.service.ts): `src/role-permission/modules/modules.service.ts`

### Commerce operations

- [Customer records](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/customer/customer.service.ts): `src/customer/customer.service.ts`
- [Distributor records](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/distributors/distributors.service.ts): `src/distributors/distributors.service.ts`
- [Product catalog](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/products/products.service.ts): `src/products/products.service.ts`
- [Categories](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/category/category.service.ts): `src/category/category.service.ts`
- [Price management](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/prices/prices.service.ts): `src/prices/prices.service.ts`
- [Order management](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/orders/orders.service.ts): `src/orders/orders.service.ts`
- [Inventory management](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/inventory/services/normal-inventory.service.ts): `src/inventory/services/normal-inventory.service.ts`
- [Catalog and sales rules](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/rules/services/catalog-rule.service.ts): `src/rules/services/catalog-rule.service.ts`
- [Tax management](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/taxes/taxes.service.ts): `src/taxes/taxes.service.ts`

### Workspace setup

- [Workspace management](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/workspace/workspace.service.ts): `src/workspace/workspace.service.ts`
- [Project management](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/project/project.service.ts): `src/project/project.service.ts`
- [Routing management](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/routing/routing.service.ts): `src/routing/routing.service.ts`

### Dashboard content

- [CMS pages and banners](https://github.com/parthasarathyhmh/austria-dash-api/tree/main/src/cms/pages): `src/cms/pages`
- [Footer content](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/cms/footer/footer.service.ts): `src/cms/footer/footer.service.ts`
- [Banner content](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/cms/banners/banners.service.ts): `src/cms/banners/banners.service.ts`

### Platform services

- [Nest application](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/app.module.ts): `src/app.module.ts`
- [Message queue API](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/messagequeue/messagequeue.service.ts): `src/messagequeue/messagequeue.service.ts`
- [System configuration](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/systemconfig/systemconfig.service.ts): `src/systemconfig/systemconfig.service.ts`
- [Territory management](https://github.com/parthasarathyhmh/austria-dash-api/blob/main/src/territory/territory.service.ts): `src/territory/territory.service.ts`

### Other components

- **API client**

## Connections

- Nest application → Authentication: registers module (evidence: `src/app.module.ts`)
- Nest application → Role management: registers module (evidence: `src/app.module.ts`)
- Nest application → Permission modules: registers module (evidence: `src/app.module.ts`)
- Nest application → Customer records: registers module (evidence: `src/app.module.ts`)
- Nest application → Product catalog: registers module (evidence: `src/app.module.ts`)
- Nest application → Order management: registers module (evidence: `src/app.module.ts`)
- Nest application → Categories: registers module (evidence: `src/app.module.ts`)
- Nest application → Catalog and sales rules: registers module (evidence: `src/app.module.ts`)
- Nest application → Price management: registers module (evidence: `src/app.module.ts`)
- Nest application → Inventory management: registers module (evidence: `src/app.module.ts`)
- Nest application → Routing management: registers module (evidence: `src/app.module.ts`)
- Nest application → Tax management: registers module (evidence: `src/app.module.ts`)
- Nest application → Territory management: registers module (evidence: `src/app.module.ts`)
- Nest application → CMS pages and banners: registers module (evidence: `src/app.module.ts`)
- Nest application → Banner content: registers module (evidence: `src/app.module.ts`)
- Nest application → Footer content: registers module (evidence: `src/app.module.ts`)
- Nest application → Message queue API: registers module (evidence: `src/app.module.ts`)
- Nest application → Distributor records: registers module (evidence: `src/app.module.ts`)
- Nest application → Workspace management: registers module (evidence: `src/app.module.ts`)
- Nest application → Project management: registers module (evidence: `src/app.module.ts`)
- Nest application → System configuration: registers module (evidence: `src/app.module.ts`)
- API client → Authentication: submits credentials (evidence: `src/auth/auth.service.ts`)
- Authentication → Admin repository: checks admin role (evidence: `src/auth/auth.service.ts`)
- Authentication → Role management: loads role data (evidence: `src/auth/auth.service.ts`)
- Authentication → Customer records: delegates requests
- API client → Customer records: requests records
- API client → Distributor records: requests records
- Distributor records → API client: returns records
- API client → Product catalog: requests catalog
- Product catalog → API client: returns catalog
- API client → Categories: requests categories
- API client → Order management: requests orders
- API client → Workspace management: manages workspace
- Workspace management → API client: returns workspace
- API client → Project management: manages projects
- API client → Message queue API: manages messages
- Authentication → API client: issues token (evidence: `src/auth/auth.service.ts`)
- Authentication → API client: may verify token (evidence: `src/auth/auth.service.ts`)
