# pgswork8686-stack/d-n-i-p-12-9 architecture

> Architecture diagram of the GitHub repository pgswork8686-stack/d-n-i-p-12-9, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pgswork8686-stack/d-n-i-p-12-9
- Repository: https://github.com/pgswork8686-stack/d-n-i-p-12-9

## Overview

NEXUSTHEME is a digital-product commerce platform with a public marketplace, customer portal, admin console, modular API, and background worker. The main customer journey is browsing products, placing an order, then managing entitlements, licenses, hosting, and downloads through the portal. Admins manage catalog, content, users, and fulfillment; worker processors support asynchronous domain operations. The README documents PostgreSQL, Redis, and S3-compatible storage. Edges reflect sampled controller-to-service calls and documented system boundaries; unsampled module wiring is not asserted.

Main entry points: [`apps/portal/app`](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/portal/app) (Customer portal), [`apps/admin/app`](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/admin/app) (Admin console), [`apps/api/src/main.ts`](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/main.ts) (API application), [`packages/database/src/client.ts`](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/packages/database/src/client.ts) (Primary database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontends["User applications"]
  node_web["Public marketplace"]
  node_portal["Customer portal"]
  node_admin["Admin console"]
end

subgraph group_api["API domains"]
  node_api_entry["API application<br/>[main.ts]"]
  node_catalog["Catalog management"]
  node_orders["Orders and checkout"]
  node_payments["Payment processing"]
  node_entitlements["Entitlements"]
  node_licenses["License management"]
  node_downloads["Version downloads"]
  node_allocations["Domain allocations"]
  node_hosting["Cloud hosting"]
  node_content["Content publishing"]
  node_accounts["Auth and users"]
  node_admin_products_controller["Admin product routes"]
  node_admin_content_controller["Admin content routes"]
  node_admin_allocations_controller["Admin allocation routes"]
  node_admin_hosting_controller["Admin hosting routes"]
  node_admin_versions_controller["Admin version routes"]
end

subgraph group_operations["Async operations"]
  node_worker["Background worker<br/>[index.ts]"]
  node_worker_processors["Domain processors<br/>[processor.ts]"]
end

subgraph group_platform["Platform services"]
  node_database[("Primary database<br/>[client.ts]")]
  node_storage["S3-compatible storage"]
  node_queue["Queue service<br/>[queue.service.ts]"]
end

node_shopper(("Shopper"))

node_shopper -->|"browses and orders"| node_web
node_web -->|"requests catalog"| node_catalog
node_web -->|"initiates checkout"| node_orders
node_portal -->|"manages access"| node_entitlements
node_portal -->|"manages licenses"| node_licenses
node_portal -->|"requests downloads"| node_downloads
node_portal -->|"manages hosting"| node_hosting
node_portal -->|"requests allocation"| node_allocations
node_admin -->|"manages products"| node_admin_products_controller
node_admin -->|"publishes content"| node_admin_content_controller
node_admin -->|"manages allocations"| node_admin_allocations_controller
node_admin -->|"manages hosting"| node_admin_hosting_controller
node_admin -->|"publishes versions"| node_admin_versions_controller
node_admin_products_controller -->|"calls service"| node_catalog
node_admin_content_controller -->|"calls service"| node_content
node_admin_allocations_controller -->|"calls service"| node_allocations
node_admin_hosting_controller -->|"calls service"| node_hosting
node_admin_versions_controller -->|"calls service"| node_downloads
node_api_entry -->|"routes requests"| node_catalog
node_api_entry -->|"routes requests"| node_orders
node_api_entry -->|"routes requests"| node_payments
node_api_entry -->|"routes requests"| node_accounts
node_api_entry -.->|"starts worker"| node_worker
node_worker -->|"dispatches jobs"| node_worker_processors
node_worker_processors -->|"processes domain state"| node_database
node_catalog -->|"persists catalog"| node_database
node_orders -->|"persists orders"| node_database
node_payments -.->|"supports checkout"| node_orders
node_downloads -->|"verifies and signs files"| node_storage
node_downloads -->|"records grants"| node_database
node_allocations -->|"persists allocations"| node_database
node_hosting -.->|"dispatches provisioning"| node_queue
node_content -->|"persists content"| node_database

click node_web "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/web/app"
click node_portal "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/portal/app"
click node_admin "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/admin/app"
click node_api_entry "https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/main.ts"
click node_catalog "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/catalog"
click node_orders "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/orders"
click node_payments "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/payments"
click node_entitlements "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/entitlements"
click node_licenses "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/licenses"
click node_downloads "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/downloads"
click node_allocations "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/allocations"
click node_hosting "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/hosting"
click node_content "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/content"
click node_accounts "https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/auth"
click node_worker "https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/worker/src/index.ts"
click node_worker_processors "https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/worker/src/processor.ts"
click node_database "https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/packages/database/src/client.ts"
click node_storage "https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/storage/s3-storage.service.ts"
click node_queue "https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/queue/queue.service.ts"
click node_admin_products_controller "https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/catalog/admin-products.controller.ts"
click node_admin_content_controller "https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/content/admin-content.controller.ts"
click node_admin_allocations_controller "https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/allocations/admin-allocations.controller.ts"
click node_admin_hosting_controller "https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/hosting/admin-hosting.controller.ts"
click node_admin_versions_controller "https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/downloads/admin-versions.controller.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_web,node_portal,node_admin toneBlue
class node_api_entry,node_catalog,node_orders,node_payments,node_entitlements,node_licenses,node_downloads,node_allocations,node_hosting,node_content,node_accounts,node_admin_products_controller,node_admin_content_controller,node_admin_allocations_controller,node_admin_hosting_controller,node_admin_versions_controller toneAmber
class node_worker,node_worker_processors toneMint
class node_database,node_storage,node_queue toneRose
class node_shopper toneIndigo
```

## Components

### User applications

- [Public marketplace](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/web/app): `apps/web/app`
- [Customer portal](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/portal/app): `apps/portal/app`
- [Admin console](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/admin/app): `apps/admin/app`

### API domains

- [API application](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/main.ts): `apps/api/src/main.ts`
- [Catalog management](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/catalog): `apps/api/src/modules/catalog`
- [Orders and checkout](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/orders): `apps/api/src/modules/orders`
- [Payment processing](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/payments): `apps/api/src/modules/payments`
- [Entitlements](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/entitlements): `apps/api/src/modules/entitlements`
- [License management](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/licenses): `apps/api/src/modules/licenses`
- [Version downloads](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/downloads): `apps/api/src/modules/downloads`
- [Domain allocations](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/allocations): `apps/api/src/modules/allocations`
- [Cloud hosting](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/hosting): `apps/api/src/modules/hosting`
- [Content publishing](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/content): `apps/api/src/modules/content`
- [Auth and users](https://github.com/pgswork8686-stack/d-n-i-p-12-9/tree/main/apps/api/src/modules/auth): `apps/api/src/modules/auth`
- [Admin product routes](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/catalog/admin-products.controller.ts): `apps/api/src/modules/catalog/admin-products.controller.ts`
- [Admin content routes](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/content/admin-content.controller.ts): `apps/api/src/modules/content/admin-content.controller.ts`
- [Admin allocation routes](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/allocations/admin-allocations.controller.ts): `apps/api/src/modules/allocations/admin-allocations.controller.ts`
- [Admin hosting routes](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/hosting/admin-hosting.controller.ts): `apps/api/src/modules/hosting/admin-hosting.controller.ts`
- [Admin version routes](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/downloads/admin-versions.controller.ts): `apps/api/src/modules/downloads/admin-versions.controller.ts`

### Async operations

- [Background worker](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/worker/src/index.ts): `apps/worker/src/index.ts`
- [Domain processors](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/worker/src/processor.ts): `apps/worker/src/processor.ts`

### Platform services

- [Primary database](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/packages/database/src/client.ts): `packages/database/src/client.ts`
- [S3-compatible storage](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/storage/s3-storage.service.ts): `apps/api/src/modules/storage/s3-storage.service.ts`
- [Queue service](https://github.com/pgswork8686-stack/d-n-i-p-12-9/blob/main/apps/api/src/modules/queue/queue.service.ts): `apps/api/src/modules/queue/queue.service.ts`

### Other components

- **Shopper**

## Connections

- Shopper → Public marketplace: browses and orders
- Public marketplace → Catalog management: requests catalog
- Public marketplace → Orders and checkout: initiates checkout
- Customer portal → Entitlements: manages access
- Customer portal → License management: manages licenses
- Customer portal → Version downloads: requests downloads
- Customer portal → Cloud hosting: manages hosting
- Customer portal → Domain allocations: requests allocation
- Admin console → Admin product routes: manages products
- Admin console → Admin content routes: publishes content
- Admin console → Admin allocation routes: manages allocations
- Admin console → Admin hosting routes: manages hosting
- Admin console → Admin version routes: publishes versions
- Admin product routes → Catalog management: calls service
- Admin content routes → Content publishing: calls service
- Admin allocation routes → Domain allocations: calls service
- Admin hosting routes → Cloud hosting: calls service
- Admin version routes → Version downloads: calls service
- API application → Catalog management: routes requests
- API application → Orders and checkout: routes requests
- API application → Payment processing: routes requests
- API application → Auth and users: routes requests
- API application → Background worker: starts worker
- Background worker → Domain processors: dispatches jobs
- Domain processors → Primary database: processes domain state
- Catalog management → Primary database: persists catalog
- Orders and checkout → Primary database: persists orders
- Payment processing → Orders and checkout: supports checkout
- Version downloads → S3-compatible storage: verifies and signs files
- Version downloads → Primary database: records grants
- Domain allocations → Primary database: persists allocations
- Cloud hosting → Queue service: dispatches provisioning
- Content publishing → Primary database: persists content