# dvizh/shop-skeleton architecture

> Architecture diagram of the GitHub repository dvizh/shop-skeleton, 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/dvizh/shop-skeleton
- Repository: https://github.com/dvizh/shop-skeleton

## Overview

DSS is a Yii2 starter skeleton for assembling an MVP online shop from configurable modules, aspects, and widgets. A visitor enters through the storefront; the README describes assembling shop, filter, cart, and order features from module widgets, with aspects connecting cart contents, discounts, and certificates to order processing. Administrators manage content and users through the backend. The tree includes the app’s content CRUD and bundled user/RBAC modules, but not the documented Dvizh module implementations, so those capabilities are shown as external integrations. Connections involving those integrations reflect README or configuration evidence, not inspected module internals.

Main entry points: [`backend/controllers/SiteController.php`](https://github.com/dvizh/shop-skeleton/blob/master/backend/controllers/SiteController.php) (Admin app), [`frontend/controllers/SiteController.php`](https://github.com/dvizh/shop-skeleton/blob/master/frontend/controllers/SiteController.php) (Storefront), [`common/aspects/OrderFilling.php`](https://github.com/dvizh/shop-skeleton/blob/master/common/aspects/OrderFilling.php) (Order filling), [`backend/controllers/NewsController.php`](https://github.com/dvizh/shop-skeleton/blob/master/backend/controllers/NewsController.php) (News CRUD)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entrypoints"]
  node_storefront["Storefront<br/>[SiteController.php]"]
  node_adminapp["Admin app<br/>[SiteController.php]"]
end

subgraph group_commerce["Shop capabilities"]
  node_shop["Shop catalog"]
  node_filters["Product filters"]
  node_cart["Shopping cart"]
  node_orders["Order management"]
  node_promocodes["Promocodes"]
  node_certificates["Gift certificates"]
  node_orderfill["Order filling<br/>[OrderFilling.php]"]
  node_discount["Discount aspects<br/>[SetDiscount.php]"]
  node_certdiscount["Certificate discount"]
  node_usecert["Certificate use<br/>[UseCertificate.php]"]
  node_gallery["Image gallery"]
  node_customfields["Custom fields"]
  node_seo["SEO fields"]
end

subgraph group_content["Content management"]
  node_news["News CRUD<br/>[NewsController.php]"]
  node_newmodel["News model<br/>[News.php]"]
  node_pages["Page CRUD<br/>[PageController.php]"]
  node_pagemodel["Page model<br/>[Page.php]"]
  node_sliders["Slider CRUD"]
end

subgraph group_identity["Identity and access"]
  node_usermodule["User module<br/>[Module.php]"]
  node_useraccounts["User accounts<br/>[User.php]"]
  node_profiles["User profiles<br/>[Profile.php]"]
  node_useradmin["User admin"]
  node_settings["Account settings"]
  node_rbac["RBAC manager<br/>[DbManager.php]"]
end

node_shopper(("Shopper"))
node_admin(("Administrator"))

node_shopper -->|"browses"| node_storefront
node_admin -->|"manages"| node_adminapp
node_storefront -.->|"uses widgets"| node_shop
node_storefront -.->|"uses widgets"| node_filters
node_storefront -.->|"uses widgets"| node_cart
node_storefront -.->|"places orders"| node_orders
node_adminapp -.->|"manages catalog"| node_shop
node_adminapp -.->|"manages orders"| node_orders
node_adminapp -.->|"manages discounts"| node_promocodes
node_adminapp -.->|"manages certificates"| node_certificates
node_cart -.->|"supplies items"| node_orderfill
node_orderfill -.->|"fills order"| node_orders
node_discount -->|"sets discounts"| node_cart
node_certdiscount -->|"sets discounts"| node_cart
node_orders -->|"uses certificate"| node_usecert
node_orders -->|"applies aspect"| node_orderfill
node_adminapp -.->|"routes requests"| node_news
node_news -->|"loads and saves"| node_newmodel
node_adminapp -.->|"routes requests"| node_pages
node_pages -->|"CRUD operations"| node_pagemodel
node_adminapp -.->|"manages slides"| node_sliders
node_shopper -.->|"registers account"| node_usermodule
node_useradmin -->|"creates users"| node_useraccounts
node_settings -->|"updates profile"| node_profiles
node_usermodule -.->|"configures"| node_useraccounts
node_adminapp -->|"enables access control"| node_rbac
node_shop -.->|"supports images"| node_gallery
node_shop -.->|"extends entities"| node_customfields
node_shop -.->|"adds SEO fields"| node_seo

click node_storefront "https://github.com/dvizh/shop-skeleton/blob/master/frontend/controllers/SiteController.php"
click node_adminapp "https://github.com/dvizh/shop-skeleton/blob/master/backend/controllers/SiteController.php"
click node_orderfill "https://github.com/dvizh/shop-skeleton/blob/master/common/aspects/OrderFilling.php"
click node_discount "https://github.com/dvizh/shop-skeleton/blob/master/common/aspects/SetDiscount.php"
click node_certdiscount "https://github.com/dvizh/shop-skeleton/blob/master/common/aspects/SetCertificateDiscount.php"
click node_usecert "https://github.com/dvizh/shop-skeleton/blob/master/common/aspects/UseCertificate.php"
click node_news "https://github.com/dvizh/shop-skeleton/blob/master/backend/controllers/NewsController.php"
click node_newmodel "https://github.com/dvizh/shop-skeleton/blob/master/common/models/News.php"
click node_pages "https://github.com/dvizh/shop-skeleton/blob/master/backend/controllers/PageController.php"
click node_pagemodel "https://github.com/dvizh/shop-skeleton/blob/master/common/models/Page.php"
click node_sliders "https://github.com/dvizh/shop-skeleton/blob/master/backend/controllers/SliderController.php"
click node_usermodule "https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-user/Module.php"
click node_useraccounts "https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-user/models/User.php"
click node_profiles "https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-user/models/Profile.php"
click node_useradmin "https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-user/controllers/AdminController.php"
click node_settings "https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-user/controllers/SettingsController.php"
click node_rbac "https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-rbac/components/DbManager.php"

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_storefront,node_adminapp toneBlue
class node_shop,node_filters,node_cart,node_orders,node_promocodes,node_certificates,node_orderfill,node_discount,node_certdiscount,node_usecert,node_gallery,node_customfields,node_seo toneAmber
class node_news,node_newmodel,node_pages,node_pagemodel,node_sliders toneMint
class node_usermodule,node_useraccounts,node_profiles,node_useradmin,node_settings,node_rbac toneRose
class node_shopper,node_admin toneIndigo
```

## Components

### App entrypoints

- [Storefront](https://github.com/dvizh/shop-skeleton/blob/master/frontend/controllers/SiteController.php): `frontend/controllers/SiteController.php`
- [Admin app](https://github.com/dvizh/shop-skeleton/blob/master/backend/controllers/SiteController.php): `backend/controllers/SiteController.php`

### Shop capabilities

- **Shop catalog**
- **Product filters**
- **Shopping cart**
- **Order management**
- **Promocodes**
- **Gift certificates**
- [Order filling](https://github.com/dvizh/shop-skeleton/blob/master/common/aspects/OrderFilling.php): `common/aspects/OrderFilling.php`
- [Discount aspects](https://github.com/dvizh/shop-skeleton/blob/master/common/aspects/SetDiscount.php): `common/aspects/SetDiscount.php`
- [Certificate discount](https://github.com/dvizh/shop-skeleton/blob/master/common/aspects/SetCertificateDiscount.php): `common/aspects/SetCertificateDiscount.php`
- [Certificate use](https://github.com/dvizh/shop-skeleton/blob/master/common/aspects/UseCertificate.php): `common/aspects/UseCertificate.php`
- **Image gallery**
- **Custom fields**
- **SEO fields**

### Content management

- [News CRUD](https://github.com/dvizh/shop-skeleton/blob/master/backend/controllers/NewsController.php): `backend/controllers/NewsController.php`
- [News model](https://github.com/dvizh/shop-skeleton/blob/master/common/models/News.php): `common/models/News.php`
- [Page CRUD](https://github.com/dvizh/shop-skeleton/blob/master/backend/controllers/PageController.php): `backend/controllers/PageController.php`
- [Page model](https://github.com/dvizh/shop-skeleton/blob/master/common/models/Page.php): `common/models/Page.php`
- [Slider CRUD](https://github.com/dvizh/shop-skeleton/blob/master/backend/controllers/SliderController.php): `backend/controllers/SliderController.php`

### Identity and access

- [User module](https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-user/Module.php): `common/modules/dektrium/yii2-user/Module.php`
- [User accounts](https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-user/models/User.php): `common/modules/dektrium/yii2-user/models/User.php`
- [User profiles](https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-user/models/Profile.php): `common/modules/dektrium/yii2-user/models/Profile.php`
- [User admin](https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-user/controllers/AdminController.php): `common/modules/dektrium/yii2-user/controllers/AdminController.php`
- [Account settings](https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-user/controllers/SettingsController.php): `common/modules/dektrium/yii2-user/controllers/SettingsController.php`
- [RBAC manager](https://github.com/dvizh/shop-skeleton/blob/master/common/modules/dektrium/yii2-rbac/components/DbManager.php): `common/modules/dektrium/yii2-rbac/components/DbManager.php`

### Other components

- **Shopper**
- **Administrator**

## Connections

- Shopper → Storefront: browses (evidence: `README.md`)
- Administrator → Admin app: manages (evidence: `README.md`)
- Storefront → Shop catalog: uses widgets (evidence: `README.md`)
- Storefront → Product filters: uses widgets (evidence: `README.md`)
- Storefront → Shopping cart: uses widgets (evidence: `README.md`)
- Storefront → Order management: places orders (evidence: `README.md`)
- Admin app → Shop catalog: manages catalog (evidence: `README.md`)
- Admin app → Order management: manages orders (evidence: `README.md`)
- Admin app → Promocodes: manages discounts (evidence: `README.md`)
- Admin app → Gift certificates: manages certificates (evidence: `README.md`)
- Shopping cart → Order filling: supplies items (evidence: `README.md`)
- Order filling → Order management: fills order (evidence: `README.md`)
- Discount aspects → Shopping cart: sets discounts
- Certificate discount → Shopping cart: sets discounts
- Order management → Certificate use: uses certificate
- Order management → Order filling: applies aspect
- Admin app → News CRUD: routes requests (evidence: `README.md`)
- News CRUD → News model: loads and saves (evidence: `backend/controllers/NewsController.php`)
- Admin app → Page CRUD: routes requests (evidence: `README.md`)
- Page CRUD → Page model: CRUD operations (evidence: `backend/controllers/PageController.php`)
- Admin app → Slider CRUD: manages slides (evidence: `README.md`)
- Shopper → User module: registers account (evidence: `README.md`)
- User admin → User accounts: creates users (evidence: `common/modules/dektrium/yii2-user/controllers/AdminController.php`)
- Account settings → User profiles: updates profile (evidence: `common/modules/dektrium/yii2-user/controllers/SettingsController.php`)
- User module → User accounts: configures (evidence: `common/modules/dektrium/yii2-user/models/User.php`)
- Admin app → RBAC manager: enables access control
- Shop catalog → Image gallery: supports images (evidence: `README.md`)
- Shop catalog → Custom fields: extends entities (evidence: `README.md`)
- Shop catalog → SEO fields: adds SEO fields (evidence: `README.md`)
