# mubashermajeed/capes-cartel architecture

> Architecture diagram of the GitHub repository mubashermajeed/capes-cartel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mubashermajeed/capes-cartel
- Repository: https://github.com/mubashermajeed/capes-cartel

## Overview

This is a NestJS API for managing catalog categories, products, attributes and Muqeet records, with separate image/video upload and deletion endpoints. The usual request path is an external client reaching a domain controller, which delegates to its service; services use Mongoose models for persistence. The graph also shows application registration and file handling. Product, Muqeet and several service internals are represented from the source index rather than inspected excerpts, so uncertain implementation links are omitted.

Main entry points: [`src/app.module.ts`](https://github.com/mubashermajeed/capes-cartel/blob/main/src/app.module.ts) (Application module), [`src/module/master-category/master-category.service.ts`](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/master-category/master-category.service.ts) (Master category service), [`src/module/main-category/main-category.service.ts`](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/main-category/main-category.service.ts) (Main category service), [`src/module/sub-category/sub-category.service.ts`](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/sub-category/sub-category.service.ts) (Subcategory service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and files"]
  node_bootstrap["Nest bootstrap<br/>[main.ts]"]
  node_appmodule["Application module<br/>[app.module.ts]"]
  node_fileapi["File endpoints<br/>[app.controller.ts]"]
  node_imageutils["Image utilities<br/>[image-utils.ts]"]
  node_dbconfig["Database configuration"]
end

subgraph group_categories["Category management"]
  node_masterapi["Master category API"]
  node_masterservice["Master category service"]
  node_masterschema["Master category model"]
  node_mainapi["Main category API"]
  node_mainservice["Main category service"]
  node_mainschema["Main category model"]
  node_subapi["Subcategory API"]
  node_subservice["Subcategory service"]
  node_subschema["Subcategory model"]
end

subgraph group_catalog["Products"]
  node_productapi["Product API"]
  node_productservice["Product service<br/>[product.service.ts]"]
  node_productschema["Product model<br/>[product.schema.ts]"]
end

subgraph group_support["Attributes and Muqeet"]
  node_attributeapi["Attribute API"]
  node_attributeservice["Attribute service"]
  node_attributeschema["Attribute model"]
  node_muqeetapi["Muqeet API"]
  node_muqeetservice["Muqeet service<br/>[muqeet.service.ts]"]
  node_muqeetschema["Muqeet model<br/>[muqeet.schema.ts]"]
end

node_client(("API client"))
node_mongo[("MongoDB")]

node_client -->|"sends file requests"| node_fileapi
node_client -.->|"sends category requests"| node_masterapi
node_client -.->|"sends category requests"| node_mainapi
node_client -.->|"sends category requests"| node_subapi
node_client -.->|"sends product requests"| node_productapi
node_client -.->|"sends attribute requests"| node_attributeapi
node_client -.->|"sends Muqeet requests"| node_muqeetapi
node_bootstrap -->|"starts"| node_appmodule
node_appmodule -->|"registers"| node_fileapi
node_appmodule -->|"registers module"| node_masterapi
node_appmodule -->|"registers module"| node_mainapi
node_appmodule -->|"registers module"| node_subapi
node_appmodule -->|"registers module"| node_productapi
node_appmodule -->|"registers module"| node_attributeapi
node_appmodule -->|"registers module"| node_muqeetapi
node_fileapi -->|"deletes via"| node_imageutils
node_masterapi -->|"delegates to"| node_masterservice
node_mainapi -->|"delegates to"| node_mainservice
node_subapi -->|"delegates to"| node_subservice
node_productapi -->|"delegates to"| node_productservice
node_attributeapi -->|"delegates to"| node_attributeservice
node_muqeetapi -->|"delegates to"| node_muqeetservice
node_masterservice -->|"queries model"| node_masterschema
node_mainservice -->|"queries model"| node_mainschema
node_subservice -->|"queries model"| node_subschema
node_productservice -->|"uses model"| node_productschema
node_attributeservice -->|"uses model"| node_attributeschema
node_muqeetservice -->|"uses model"| node_muqeetschema
node_masterservice -.->|"reads and writes"| node_mongo
node_mainservice -.->|"reads and writes"| node_mongo
node_subservice -->|"reads and writes"| node_mongo
node_productservice -.->|"reads and writes"| node_mongo
node_attributeservice -.->|"reads and writes"| node_mongo
node_muqeetservice -.->|"reads and writes"| node_mongo
node_appmodule -->|"imports database module"| node_dbconfig
node_dbconfig -.->|"configures connection"| node_mongo

click node_bootstrap "https://github.com/mubashermajeed/capes-cartel/blob/main/src/main.ts"
click node_appmodule "https://github.com/mubashermajeed/capes-cartel/blob/main/src/app.module.ts"
click node_fileapi "https://github.com/mubashermajeed/capes-cartel/blob/main/src/app.controller.ts"
click node_imageutils "https://github.com/mubashermajeed/capes-cartel/blob/main/src/common/lib/image-utils.ts"
click node_dbconfig "https://github.com/mubashermajeed/capes-cartel/blob/main/src/common/db/mongoose-config.service.ts"
click node_masterapi "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/master-category/master-category.controller.ts"
click node_masterservice "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/master-category/master-category.service.ts"
click node_masterschema "https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/master.categories.ts"
click node_mainapi "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/main-category/main-category.controller.ts"
click node_mainservice "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/main-category/main-category.service.ts"
click node_mainschema "https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/main.catergory.schema.ts"
click node_subapi "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/sub-category/sub-category.controller.ts"
click node_subservice "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/sub-category/sub-category.service.ts"
click node_subschema "https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/sub.category.schema.ts"
click node_productapi "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/product/product.controller.ts"
click node_productservice "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/product/product.service.ts"
click node_productschema "https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/product.schema.ts"
click node_attributeapi "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/attribute/attribute.controller.ts"
click node_attributeservice "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/attribute/attribute.service.ts"
click node_attributeschema "https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/attribute.schema.ts"
click node_muqeetapi "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/muqeet/muqeet.controller.ts"
click node_muqeetservice "https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/muqeet/muqeet.service.ts"
click node_muqeetschema "https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/muqeet.schema.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_bootstrap,node_appmodule,node_fileapi,node_imageutils,node_dbconfig,node_client toneBlue
class node_masterapi,node_masterservice,node_masterschema,node_mainapi,node_mainservice,node_mainschema,node_subapi,node_subservice,node_subschema,node_mongo toneAmber
class node_productapi,node_productservice,node_productschema toneMint
class node_attributeapi,node_attributeservice,node_attributeschema,node_muqeetapi,node_muqeetservice,node_muqeetschema toneRose
```

## Components

### Application and files

- [Nest bootstrap](https://github.com/mubashermajeed/capes-cartel/blob/main/src/main.ts): `src/main.ts`
- [Application module](https://github.com/mubashermajeed/capes-cartel/blob/main/src/app.module.ts): `src/app.module.ts`
- [File endpoints](https://github.com/mubashermajeed/capes-cartel/blob/main/src/app.controller.ts): `src/app.controller.ts`
- [Image utilities](https://github.com/mubashermajeed/capes-cartel/blob/main/src/common/lib/image-utils.ts): `src/common/lib/image-utils.ts`
- [Database configuration](https://github.com/mubashermajeed/capes-cartel/blob/main/src/common/db/mongoose-config.service.ts): `src/common/db/mongoose-config.service.ts`

### Category management

- [Master category API](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/master-category/master-category.controller.ts): `src/module/master-category/master-category.controller.ts`
- [Master category service](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/master-category/master-category.service.ts): `src/module/master-category/master-category.service.ts`
- [Master category model](https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/master.categories.ts): `src/data/schemas/master.categories.ts`
- [Main category API](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/main-category/main-category.controller.ts): `src/module/main-category/main-category.controller.ts`
- [Main category service](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/main-category/main-category.service.ts): `src/module/main-category/main-category.service.ts`
- [Main category model](https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/main.catergory.schema.ts): `src/data/schemas/main.catergory.schema.ts`
- [Subcategory API](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/sub-category/sub-category.controller.ts): `src/module/sub-category/sub-category.controller.ts`
- [Subcategory service](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/sub-category/sub-category.service.ts): `src/module/sub-category/sub-category.service.ts`
- [Subcategory model](https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/sub.category.schema.ts): `src/data/schemas/sub.category.schema.ts`

### Products

- [Product API](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/product/product.controller.ts): `src/module/product/product.controller.ts`
- [Product service](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/product/product.service.ts): `src/module/product/product.service.ts`
- [Product model](https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/product.schema.ts): `src/data/schemas/product.schema.ts`

### Attributes and Muqeet

- [Attribute API](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/attribute/attribute.controller.ts): `src/module/attribute/attribute.controller.ts`
- [Attribute service](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/attribute/attribute.service.ts): `src/module/attribute/attribute.service.ts`
- [Attribute model](https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/attribute.schema.ts): `src/data/schemas/attribute.schema.ts`
- [Muqeet API](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/muqeet/muqeet.controller.ts): `src/module/muqeet/muqeet.controller.ts`
- [Muqeet service](https://github.com/mubashermajeed/capes-cartel/blob/main/src/module/muqeet/muqeet.service.ts): `src/module/muqeet/muqeet.service.ts`
- [Muqeet model](https://github.com/mubashermajeed/capes-cartel/blob/main/src/data/schemas/muqeet.schema.ts): `src/data/schemas/muqeet.schema.ts`

### Other components

- **API client**
- **MongoDB**

## Connections

- API client → File endpoints: sends file requests (evidence: `src/app.controller.ts`)
- API client → Master category API: sends category requests
- API client → Main category API: sends category requests
- API client → Subcategory API: sends category requests
- API client → Product API: sends product requests
- API client → Attribute API: sends attribute requests
- API client → Muqeet API: sends Muqeet requests
- Nest bootstrap → Application module: starts (evidence: `src/main.ts`)
- Application module → File endpoints: registers (evidence: `src/app.module.ts`)
- Application module → Master category API: registers module (evidence: `src/app.module.ts`)
- Application module → Main category API: registers module (evidence: `src/app.module.ts`)
- Application module → Subcategory API: registers module (evidence: `src/app.module.ts`)
- Application module → Product API: registers module (evidence: `src/app.module.ts`)
- Application module → Attribute API: registers module (evidence: `src/app.module.ts`)
- Application module → Muqeet API: registers module (evidence: `src/app.module.ts`)
- File endpoints → Image utilities: deletes via (evidence: `src/app.controller.ts`)
- Master category API → Master category service: delegates to (evidence: `src/module/master-category/master-category.controller.ts`)
- Main category API → Main category service: delegates to (evidence: `src/module/main-category/main-category.controller.ts`)
- Subcategory API → Subcategory service: delegates to (evidence: `src/module/sub-category/sub-category.controller.ts`)
- Product API → Product service: delegates to (evidence: `src/module/product/product.controller.ts`)
- Attribute API → Attribute service: delegates to (evidence: `src/module/attribute/attribute.controller.ts`)
- Muqeet API → Muqeet service: delegates to (evidence: `src/module/muqeet/muqeet.controller.ts`)
- Master category service → Master category model: queries model (evidence: `src/module/master-category/master-category.service.ts`)
- Main category service → Main category model: queries model (evidence: `src/module/main-category/main-category.service.ts`)
- Subcategory service → Subcategory model: queries model (evidence: `src/module/sub-category/sub-category.service.ts`)
- Product service → Product model: uses model (evidence: `src/module/product/product.service.ts`)
- Attribute service → Attribute model: uses model (evidence: `src/module/attribute/attribute.service.ts`)
- Muqeet service → Muqeet model: uses model (evidence: `src/module/muqeet/muqeet.service.ts`)
- Master category service → MongoDB: reads and writes
- Main category service → MongoDB: reads and writes
- Subcategory service → MongoDB: reads and writes (evidence: `src/module/sub-category/sub-category.service.ts`)
- Product service → MongoDB: reads and writes
- Attribute service → MongoDB: reads and writes
- Muqeet service → MongoDB: reads and writes
- Application module → Database configuration: imports database module (evidence: `src/app.module.ts`)
- Database configuration → MongoDB: configures connection
