# remetulla17771/tiny-mvc-js architecture

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

- Interactive diagram: https://gitdiagram.com/remetulla17771/tiny-mvc-js
- Repository: https://github.com/remetulla17771/tiny-mvc-js

## Overview

Tiny-MVC JS is a Node.js MVC framework and sample web application. Its main user workflow maps an HTTP request to a controller action, which uses user/ORM and presentation components to return a rendered response; the sample includes user listing, login, and CRUD actions. Separate branches cover configured modules, sessions, assets, and the Gii code generator. Some subsystems are represented from the README or source index because their implementation excerpts were not provided; those links are documented rather than inferred from unsampled code.

Main entry points: [`framework/BaseController.js`](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/BaseController.js) (Base controller), [`controllers/SiteController.js`](https://github.com/remetulla17771/tiny-mvc-js/blob/main/controllers/SiteController.js) (Site controller), [`framework/Application.js`](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/Application.js) (Application), [`modules/gii/controllers/DefaultController.js`](https://github.com/remetulla17771/tiny-mvc-js/blob/main/modules/gii/controllers/DefaultController.js) (Gii controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["HTTP and MVC"]
  node_application["Application<br/>[Application.js]"]
  node_router["Router<br/>[Router.js]"]
  node_site["Site controller<br/>[SiteController.js]"]
  node_basecontroller["Base controller<br/>[BaseController.js]"]
  node_http_errors["HTTP exceptions<br/>[HttpException.js]"]
  node_session["Session component<br/>[Session.js]"]
  node_user_component["User component<br/>[UserComponent.js]"]
end

subgraph group_data["Models and persistence"]
  node_user_model["User model<br/>[User.js]"]
  node_active_record["ActiveRecord<br/>[ActiveRecord.js]"]
  node_active_query["ActiveQuery<br/>[ActiveQuery.js]"]
  node_database[("Database component<br/>[main.js]")]
end

subgraph group_presentation["Views and assets"]
  node_view_manager["View manager<br/>[ViewManager.js]"]
  node_templates["Nunjucks templates"]
  node_asset_bundles["Asset bundles<br/>[AssetBundle.js]"]
  node_data_provider["Data provider"]
  node_grid["Grid view<br/>[GridView.js]"]
  node_detail["Detail view<br/>[DetailView.js]"]
  node_active_form["Active form<br/>[ActiveForm.js]"]
end

subgraph group_extensions["Modules and tools"]
  node_modules["Application modules<br/>[Module.js]"]
  node_admin_module["Admin module"]
  node_shop_module["Shop module"]
  node_gii_controller["Gii controller"]
  node_model_generator["Model generator<br/>[ModelGenerator.js]"]
  node_controller_generator["Controller generator"]
  node_crud_generator["CRUD generator<br/>[CrudGenerator.js]"]
  node_module_generator["Module generator<br/>[ModuleGenerator.js]"]
  node_generated_files["Generated app code"]
end

node_browser(("HTTP client"))

node_browser -->|"requests routes"| node_router
node_router -->|"dispatches actions"| node_site
node_application -->|"initializes routing"| node_router
node_application -->|"creates modules"| node_modules
node_application -->|"configures components"| node_database
node_application -->|"configures components"| node_session
node_application -->|"configures components"| node_user_component
node_site -->|"queries and saves"| node_user_model
node_site -->|"builds listing"| node_data_provider
node_site -->|"renders listing"| node_grid
node_site -->|"renders profile"| node_detail
node_site -->|"sets flash messages"| node_session
node_site -->|"authenticates users"| node_user_component
node_user_model -->|"extends"| node_active_record
node_active_record -->|"builds queries"| node_active_query
node_active_query -.->|"executes queries"| node_database
node_data_provider -.->|"consumes query"| node_active_query
node_site -->|"extends"| node_basecontroller
node_basecontroller -->|"registers assets"| node_view_manager
node_basecontroller -->|"renders templates"| node_templates
node_basecontroller -->|"exposes to templates"| node_active_form
node_basecontroller -->|"exposes to templates"| node_grid
node_basecontroller -->|"exposes to templates"| node_detail
node_basecontroller -->|"registers bundles"| node_asset_bundles
node_basecontroller -->|"throws not found"| node_http_errors
node_admin_module -->|"extends"| node_modules
node_shop_module -->|"extends"| node_modules
node_gii_controller -->|"extends"| node_basecontroller
node_gii_controller -->|"invokes generator"| node_model_generator
node_gii_controller -->|"invokes generator"| node_controller_generator
node_gii_controller -.->|"invokes generator"| node_crud_generator
node_gii_controller -->|"invokes generator"| node_module_generator
node_model_generator -->|"generates model"| node_generated_files
node_controller_generator -->|"writes controller and views"| node_generated_files
node_module_generator -->|"generates module"| node_generated_files

click node_application "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/Application.js"
click node_router "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/Router.js"
click node_site "https://github.com/remetulla17771/tiny-mvc-js/blob/main/controllers/SiteController.js"
click node_basecontroller "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/BaseController.js"
click node_http_errors "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/exceptions/HttpException.js"
click node_user_model "https://github.com/remetulla17771/tiny-mvc-js/blob/main/models/User.js"
click node_active_record "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/ActiveRecord.js"
click node_active_query "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/ActiveQuery.js"
click node_database "https://github.com/remetulla17771/tiny-mvc-js/blob/main/config/main.js"
click node_session "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/Session.js"
click node_user_component "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/web/UserComponent.js"
click node_view_manager "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/web/ViewManager.js"
click node_templates "https://github.com/remetulla17771/tiny-mvc-js/tree/main/views"
click node_asset_bundles "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/web/AssetBundle.js"
click node_data_provider "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/ActiveDataProvider.js"
click node_grid "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/widgets/GridView.js"
click node_detail "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/widgets/DetailView.js"
click node_active_form "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/widgets/ActiveForm.js"
click node_modules "https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/base/Module.js"
click node_admin_module "https://github.com/remetulla17771/tiny-mvc-js/tree/main/modules/admin"
click node_shop_module "https://github.com/remetulla17771/tiny-mvc-js/tree/main/modules/shop"
click node_gii_controller "https://github.com/remetulla17771/tiny-mvc-js/blob/main/modules/gii/controllers/DefaultController.js"
click node_model_generator "https://github.com/remetulla17771/tiny-mvc-js/blob/main/modules/gii/generators/ModelGenerator.js"
click node_controller_generator "https://github.com/remetulla17771/tiny-mvc-js/blob/main/modules/gii/generators/ControllerGenerator.js"
click node_crud_generator "https://github.com/remetulla17771/tiny-mvc-js/blob/main/modules/gii/generators/CrudGenerator.js"
click node_module_generator "https://github.com/remetulla17771/tiny-mvc-js/blob/main/modules/gii/generators/ModuleGenerator.js"
click node_generated_files "https://github.com/remetulla17771/tiny-mvc-js/tree/main/controllers"

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_application,node_router,node_site,node_basecontroller,node_http_errors,node_session,node_user_component,node_browser toneBlue
class node_user_model,node_active_record,node_active_query,node_database toneAmber
class node_view_manager,node_templates,node_asset_bundles,node_data_provider,node_grid,node_detail,node_active_form toneMint
class node_modules,node_admin_module,node_shop_module,node_gii_controller,node_model_generator,node_controller_generator,node_crud_generator,node_module_generator,node_generated_files toneRose
```

## Components

### HTTP and MVC

- [Application](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/Application.js): `framework/Application.js`
- [Router](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/Router.js): `framework/Router.js`
- [Site controller](https://github.com/remetulla17771/tiny-mvc-js/blob/main/controllers/SiteController.js): `controllers/SiteController.js`
- [Base controller](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/BaseController.js): `framework/BaseController.js`
- [HTTP exceptions](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/exceptions/HttpException.js): `framework/exceptions/HttpException.js`
- [Session component](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/Session.js): `framework/Session.js`
- [User component](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/web/UserComponent.js): `framework/web/UserComponent.js`

### Models and persistence

- [User model](https://github.com/remetulla17771/tiny-mvc-js/blob/main/models/User.js): `models/User.js`
- [ActiveRecord](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/ActiveRecord.js): `framework/ActiveRecord.js`
- [ActiveQuery](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/ActiveQuery.js): `framework/ActiveQuery.js`
- [Database component](https://github.com/remetulla17771/tiny-mvc-js/blob/main/config/main.js): `config/main.js`

### Views and assets

- [View manager](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/web/ViewManager.js): `framework/web/ViewManager.js`
- [Nunjucks templates](https://github.com/remetulla17771/tiny-mvc-js/tree/main/views): `views`
- [Asset bundles](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/web/AssetBundle.js): `framework/web/AssetBundle.js`
- [Data provider](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/ActiveDataProvider.js): `framework/ActiveDataProvider.js`
- [Grid view](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/widgets/GridView.js): `framework/widgets/GridView.js`
- [Detail view](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/widgets/DetailView.js): `framework/widgets/DetailView.js`
- [Active form](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/widgets/ActiveForm.js): `framework/widgets/ActiveForm.js`

### Modules and tools

- [Application modules](https://github.com/remetulla17771/tiny-mvc-js/blob/main/framework/base/Module.js): `framework/base/Module.js`
- [Admin module](https://github.com/remetulla17771/tiny-mvc-js/tree/main/modules/admin): `modules/admin`
- [Shop module](https://github.com/remetulla17771/tiny-mvc-js/tree/main/modules/shop): `modules/shop`
- [Gii controller](https://github.com/remetulla17771/tiny-mvc-js/blob/main/modules/gii/controllers/DefaultController.js): `modules/gii/controllers/DefaultController.js`
- [Model generator](https://github.com/remetulla17771/tiny-mvc-js/blob/main/modules/gii/generators/ModelGenerator.js): `modules/gii/generators/ModelGenerator.js`
- [Controller generator](https://github.com/remetulla17771/tiny-mvc-js/blob/main/modules/gii/generators/ControllerGenerator.js): `modules/gii/generators/ControllerGenerator.js`
- [CRUD generator](https://github.com/remetulla17771/tiny-mvc-js/blob/main/modules/gii/generators/CrudGenerator.js): `modules/gii/generators/CrudGenerator.js`
- [Module generator](https://github.com/remetulla17771/tiny-mvc-js/blob/main/modules/gii/generators/ModuleGenerator.js): `modules/gii/generators/ModuleGenerator.js`
- [Generated app code](https://github.com/remetulla17771/tiny-mvc-js/tree/main/controllers): `controllers`

### Other components

- **HTTP client**

## Connections

- HTTP client → Router: requests routes (evidence: `README.md`)
- Router → Site controller: dispatches actions (evidence: `README.md`)
- Application → Router: initializes routing (evidence: `index.js`)
- Application → Application modules: creates modules (evidence: `framework/Application.js`)
- Application → Database component: configures components (evidence: `config/main.js`)
- Application → Session component: configures components (evidence: `framework/Session.js`)
- Application → User component: configures components (evidence: `framework/web/UserComponent.js`)
- Site controller → User model: queries and saves (evidence: `controllers/SiteController.js`)
- Site controller → Data provider: builds listing (evidence: `controllers/SiteController.js`)
- Site controller → Grid view: renders listing (evidence: `controllers/SiteController.js`)
- Site controller → Detail view: renders profile (evidence: `controllers/SiteController.js`)
- Site controller → Session component: sets flash messages (evidence: `controllers/SiteController.js`)
- Site controller → User component: authenticates users (evidence: `controllers/SiteController.js`)
- User model → ActiveRecord: extends (evidence: `models/User.js`)
- ActiveRecord → ActiveQuery: builds queries (evidence: `framework/ActiveRecord.js`)
- ActiveQuery → Database component: executes queries
- Data provider → ActiveQuery: consumes query
- Site controller → Base controller: extends (evidence: `controllers/SiteController.js`)
- Base controller → View manager: registers assets (evidence: `framework/BaseController.js`)
- Base controller → Nunjucks templates: renders templates (evidence: `framework/BaseController.js`)
- Base controller → Active form: exposes to templates (evidence: `framework/BaseController.js`)
- Base controller → Grid view: exposes to templates (evidence: `framework/BaseController.js`)
- Base controller → Detail view: exposes to templates (evidence: `framework/BaseController.js`)
- Base controller → Asset bundles: registers bundles (evidence: `framework/BaseController.js`)
- Base controller → HTTP exceptions: throws not found (evidence: `framework/BaseController.js`)
- Admin module → Application modules: extends (evidence: `modules/admin/Module.js`)
- Shop module → Application modules: extends (evidence: `modules/shop/Module.js`)
- Gii controller → Base controller: extends (evidence: `modules/gii/controllers/DefaultController.js`)
- Gii controller → Model generator: invokes generator (evidence: `modules/gii/controllers/DefaultController.js`)
- Gii controller → Controller generator: invokes generator (evidence: `modules/gii/controllers/DefaultController.js`)
- Gii controller → CRUD generator: invokes generator
- Gii controller → Module generator: invokes generator (evidence: `modules/gii/controllers/DefaultController.js`)
- Model generator → Generated app code: generates model (evidence: `README.md`)
- Controller generator → Generated app code: writes controller and views (evidence: `modules/gii/generators/ControllerGenerator.js`)
- Module generator → Generated app code: generates module (evidence: `README.md`)
