# iheb98/storiom architecture

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

- Interactive diagram: https://gitdiagram.com/iheb98/storiom
- Repository: https://github.com/iheb98/storiom

## Overview

Stock-Management is a multi-tenant inventory and storefront product, with an Angular client and an Express/Sequelize backend. Users can browse and order products or request store services; store operators manage inventory, orders, workers, services, and reporting, while platform administrators manage users and payments. The tree also shows custom-domain storefronts, subscriptions, promotions, and file uploads. The excerpts confirm app bootstrapping, domain-aware routing, and service-request persistence; many other feature connections are inferred from module structure and are therefore left unlinked or marked unverified.

Main entry points: [`stock-mngt-backend/app.js`](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/app.js) (HTTP application), [`stock-mngt-backend/routes/service-requests.js`](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/service-requests.js) (Service request API), [`stock-mngt/src/app/features/admin/pages`](https://github.com/iheb98/storiom/tree/main/stock-mngt/src/app/features/admin/pages) (Admin console), [`stock-mngt/src/app/features/public/pages`](https://github.com/iheb98/storiom/tree/main/stock-mngt/src/app/features/public/pages) (Public storefront)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_bootstrap["Client bootstrap<br/>[main.ts]"]
  node_admin["Admin console"]
  node_public["Public storefront"]
  node_superadmin["Platform admin"]
  node_domain["Domain resolution<br/>[domain.service.ts]"]
  node_adminrouting["Admin routing"]
  node_publicrouting["Store routing"]
  node_services["Client API services"]
end

subgraph group_backend["Backend API"]
  node_server["HTTP application<br/>[app.js]"]
  node_productroutes["Product and catalog API<br/>[products.js]"]
  node_publicroutes["Public API<br/>[public.js]"]
  node_analyticsroutes["Analytics API<br/>[stats.js]"]
  node_paymentroutes["Payment orders API<br/>[payment-orders.js]"]
  node_requestroutes["Service request API"]
  node_serviceroutes["Store services API<br/>[store-services.js]"]
  node_userroutes["Accounts API<br/>[users.js]"]
  node_utility["Auth and query helpers<br/>[utility.js]"]
  node_cache["Response caching<br/>[cacheService.js]"]
end

subgraph group_data["Persistence and integrations"]
  node_models[("Domain models")]
end

subgraph group_edge["Edge services"]
  node_mailer["Transactional email<br/>[mailService.js]"]
  node_r2config["Object storage config<br/>[r2.js]"]
  node_worker["R2 upload worker<br/>[index.js]"]
end

node_user(("Store user"))

node_user -.->|"browses and orders"| node_public
node_user -.->|"manages store"| node_admin
node_bootstrap -->|"initializes"| node_domain
node_publicrouting -->|"checks domain"| node_domain
node_adminrouting -->|"routes to"| node_admin
node_publicrouting -->|"routes to"| node_public
node_admin -.->|"uses API"| node_services
node_public -.->|"uses API"| node_services
node_services -.->|"HTTP requests"| node_server
node_server -.->|"dispatches"| node_productroutes
node_server -.->|"dispatches"| node_publicroutes
node_server -.->|"dispatches"| node_analyticsroutes
node_server -.->|"dispatches"| node_paymentroutes
node_server -.->|"dispatches"| node_requestroutes
node_server -.->|"dispatches"| node_serviceroutes
node_server -.->|"dispatches"| node_userroutes
node_requestroutes -->|"reads and writes"| node_models
node_requestroutes -->|"authenticates"| node_utility
node_serviceroutes -->|"reads and writes"| node_models
node_utility -->|"stores refresh tokens"| node_models
node_worker -.->|"uses storage config"| node_r2config
node_server -.->|"sends mail"| node_mailer

click node_bootstrap "https://github.com/iheb98/storiom/blob/main/stock-mngt/src/main.ts"
click node_admin "https://github.com/iheb98/storiom/tree/main/stock-mngt/src/app/features/admin/pages"
click node_public "https://github.com/iheb98/storiom/tree/main/stock-mngt/src/app/features/public/pages"
click node_superadmin "https://github.com/iheb98/storiom/tree/main/stock-mngt/src/app/features/superadmin/pages"
click node_domain "https://github.com/iheb98/storiom/blob/main/stock-mngt/src/app/core/services/domain.service.ts"
click node_adminrouting "https://github.com/iheb98/storiom/blob/main/stock-mngt/src/app/features/admin/admin-routing.module.ts"
click node_publicrouting "https://github.com/iheb98/storiom/blob/main/stock-mngt/src/app/features/public/public-routing.module.ts"
click node_services "https://github.com/iheb98/storiom/tree/main/stock-mngt/src/app/core/services"
click node_server "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/app.js"
click node_productroutes "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/products.js"
click node_publicroutes "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/public.js"
click node_analyticsroutes "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/stats.js"
click node_paymentroutes "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/payment-orders.js"
click node_requestroutes "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/service-requests.js"
click node_serviceroutes "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/store-services.js"
click node_userroutes "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/users.js"
click node_models "https://github.com/iheb98/storiom/tree/main/stock-mngt-backend/models"
click node_utility "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/utility.js"
click node_cache "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/cacheService.js"
click node_mailer "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/mailService.js"
click node_r2config "https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/config/r2.js"
click node_worker "https://github.com/iheb98/storiom/blob/main/cloudflare-r2-worker/src/index.js"

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_admin,node_public,node_superadmin,node_domain,node_adminrouting,node_publicrouting,node_services,node_user toneBlue
class node_server,node_productroutes,node_publicroutes,node_analyticsroutes,node_paymentroutes,node_requestroutes,node_serviceroutes,node_userroutes,node_utility,node_cache toneAmber
class node_models toneMint
class node_mailer,node_r2config,node_worker toneRose
```

## Components

### Angular client

- [Client bootstrap](https://github.com/iheb98/storiom/blob/main/stock-mngt/src/main.ts): `stock-mngt/src/main.ts`
- [Admin console](https://github.com/iheb98/storiom/tree/main/stock-mngt/src/app/features/admin/pages): `stock-mngt/src/app/features/admin/pages`
- [Public storefront](https://github.com/iheb98/storiom/tree/main/stock-mngt/src/app/features/public/pages): `stock-mngt/src/app/features/public/pages`
- [Platform admin](https://github.com/iheb98/storiom/tree/main/stock-mngt/src/app/features/superadmin/pages): `stock-mngt/src/app/features/superadmin/pages`
- [Domain resolution](https://github.com/iheb98/storiom/blob/main/stock-mngt/src/app/core/services/domain.service.ts): `stock-mngt/src/app/core/services/domain.service.ts`
- [Admin routing](https://github.com/iheb98/storiom/blob/main/stock-mngt/src/app/features/admin/admin-routing.module.ts): `stock-mngt/src/app/features/admin/admin-routing.module.ts`
- [Store routing](https://github.com/iheb98/storiom/blob/main/stock-mngt/src/app/features/public/public-routing.module.ts): `stock-mngt/src/app/features/public/public-routing.module.ts`
- [Client API services](https://github.com/iheb98/storiom/tree/main/stock-mngt/src/app/core/services): `stock-mngt/src/app/core/services`

### Backend API

- [HTTP application](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/app.js): `stock-mngt-backend/app.js`
- [Product and catalog API](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/products.js): `stock-mngt-backend/routes/products.js`
- [Public API](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/public.js): `stock-mngt-backend/routes/public.js`
- [Analytics API](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/stats.js): `stock-mngt-backend/routes/stats.js`
- [Payment orders API](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/payment-orders.js): `stock-mngt-backend/routes/payment-orders.js`
- [Service request API](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/service-requests.js): `stock-mngt-backend/routes/service-requests.js`
- [Store services API](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/store-services.js): `stock-mngt-backend/routes/store-services.js`
- [Accounts API](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/routes/users.js): `stock-mngt-backend/routes/users.js`
- [Auth and query helpers](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/utility.js): `stock-mngt-backend/utility.js`
- [Response caching](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/cacheService.js): `stock-mngt-backend/cacheService.js`

### Persistence and integrations

- [Domain models](https://github.com/iheb98/storiom/tree/main/stock-mngt-backend/models): `stock-mngt-backend/models`

### Edge services

- [Transactional email](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/mailService.js): `stock-mngt-backend/mailService.js`
- [Object storage config](https://github.com/iheb98/storiom/blob/main/stock-mngt-backend/config/r2.js): `stock-mngt-backend/config/r2.js`
- [R2 upload worker](https://github.com/iheb98/storiom/blob/main/cloudflare-r2-worker/src/index.js): `cloudflare-r2-worker/src/index.js`

### Other components

- **Store user**

## Connections

- Store user → Public storefront: browses and orders
- Store user → Admin console: manages store
- Client bootstrap → Domain resolution: initializes
- Store routing → Domain resolution: checks domain (evidence: `stock-mngt/src/app/features/public/public-routing.module.ts`)
- Admin routing → Admin console: routes to (evidence: `stock-mngt/src/app/features/admin/admin-routing.module.ts`)
- Store routing → Public storefront: routes to (evidence: `stock-mngt/src/app/features/public/public-routing.module.ts`)
- Admin console → Client API services: uses API
- Public storefront → Client API services: uses API
- Client API services → HTTP application: HTTP requests
- HTTP application → Product and catalog API: dispatches (evidence: `stock-mngt-backend/app.js`)
- HTTP application → Public API: dispatches (evidence: `stock-mngt-backend/app.js`)
- HTTP application → Analytics API: dispatches (evidence: `stock-mngt-backend/app.js`)
- HTTP application → Payment orders API: dispatches (evidence: `stock-mngt-backend/app.js`)
- HTTP application → Service request API: dispatches (evidence: `stock-mngt-backend/app.js`)
- HTTP application → Store services API: dispatches (evidence: `stock-mngt-backend/app.js`)
- HTTP application → Accounts API: dispatches (evidence: `stock-mngt-backend/app.js`)
- Service request API → Domain models: reads and writes (evidence: `stock-mngt-backend/routes/service-requests.js`)
- Service request API → Auth and query helpers: authenticates (evidence: `stock-mngt-backend/routes/service-requests.js`)
- Store services API → Domain models: reads and writes (evidence: `stock-mngt-backend/routes/store-services.js`)
- Auth and query helpers → Domain models: stores refresh tokens (evidence: `stock-mngt-backend/utility.js`)
- R2 upload worker → Object storage config: uses storage config
- HTTP application → Transactional email: sends mail (evidence: `stock-mngt-backend/app.js`)
