# utoyvo/crud-mvc-oop-pdo architecture

> Architecture diagram of the GitHub repository utoyvo/crud-mvc-oop-pdo, 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/utoyvo/crud-mvc-oop-pdo
- Repository: https://github.com/utoyvo/crud-mvc-oop-pdo

## Overview

This is a PHP MVC CRUD application for posts and user accounts. A request enters through the application bootstrap, which configures the database and session, selects a controller, and relies on controller routing to invoke an action. Actions call models for persistence and render views; account workflows also cover sign-up, sign-in, role-based access, and profile changes. The README documents MySQL/MariaDB storage. The graph reflects sampled controller and framework calls; unsampled model and view behavior is represented conservatively from the source index and README.

Main entry points: [`app/models/UsersModel.php`](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/models/UsersModel.php) (User data), [`app/controllers/PostsController.php`](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/controllers/PostsController.php) (Post actions), [`core/classes/Controller.php`](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/classes/Controller.php) (Controller routing), [`app/models/PostsModel.php`](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/models/PostsModel.php) (Post data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Request handling"]
  node_app["Application bootstrap<br/>[App.php]"]
  node_router["Controller routing<br/>[Controller.php]"]
  node_main["Main page<br/>[MainController.php]"]
end

subgraph group_content["Post management"]
  node_posts_controller["Post actions"]
  node_posts_model["Post data<br/>[PostsModel.php]"]
  node_post_views["Post pages"]
end

subgraph group_accounts["Accounts"]
  node_users_controller["User actions"]
  node_users_model["User data<br/>[UsersModel.php]"]
  node_user_views["Account pages"]
end

subgraph group_framework["Shared framework"]
  node_database[("MySQL database<br/>[database.sql]")]
  node_model_base["Model base<br/>[Model.php]"]
  node_sql_builder["SQL builder<br/>[Sql.php]"]
  node_validation["Validation errors"]
  node_string_helper["String validation<br/>[Str.php]"]
  node_email_helper["Email validation<br/>[Email.php]"]
  node_file_helper["Upload handling<br/>[File.php]"]
  node_user_helper["Session and roles<br/>[User.php]"]
  node_site_helper["Site utilities<br/>[Site.php]"]
  node_time_helper["Date formatting<br/>[Time.php]"]
end

node_browser(("Visitor"))

node_browser -->|"requests page"| node_app
node_app -->|"loads fallback"| node_main
node_app -->|"instantiates controller"| node_router
node_router -.->|"dispatches action"| node_posts_controller
node_router -.->|"dispatches action"| node_users_controller
node_router -->|"dispatches action"| node_main
node_posts_controller -->|"calls model"| node_posts_model
node_posts_controller -->|"renders pages"| node_post_views
node_users_controller -->|"calls model"| node_users_model
node_users_controller -->|"renders pages"| node_user_views
node_model_base -->|"uses queries"| node_sql_builder
node_posts_model -->|"extends"| node_model_base
node_users_model -->|"extends"| node_model_base
node_users_model -.->|"reads and writes"| node_database
node_posts_model -.->|"reads and writes"| node_database
node_users_model -->|"validates input"| node_string_helper
node_users_model -->|"validates email"| node_email_helper
node_users_model -->|"throws errors"| node_validation
node_posts_model -->|"handles covers"| node_file_helper
node_posts_controller -->|"checks access"| node_user_helper
node_users_controller -->|"checks access"| node_user_helper
node_users_model -->|"redirects"| node_site_helper
node_posts_controller -->|"redirects"| node_site_helper
node_user_views -->|"formats dates"| node_time_helper
node_post_views -->|"formats dates"| node_time_helper

click node_app "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/App.php"
click node_router "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/classes/Controller.php"
click node_main "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/controllers/MainController.php"
click node_posts_controller "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/controllers/PostsController.php"
click node_posts_model "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/models/PostsModel.php"
click node_post_views "https://github.com/utoyvo/crud-mvc-oop-pdo/tree/master/app/views/posts"
click node_users_controller "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/controllers/UsersController.php"
click node_users_model "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/models/UsersModel.php"
click node_user_views "https://github.com/utoyvo/crud-mvc-oop-pdo/tree/master/app/views/users"
click node_database "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/database.sql"
click node_model_base "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/classes/Model.php"
click node_sql_builder "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/classes/Sql.php"
click node_validation "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/classes/ValidationException.php"
click node_string_helper "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/Str.php"
click node_email_helper "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/Email.php"
click node_file_helper "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/File.php"
click node_user_helper "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/User.php"
click node_site_helper "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/Site.php"
click node_time_helper "https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/Time.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_app,node_router,node_main toneBlue
class node_posts_controller,node_posts_model,node_post_views toneAmber
class node_users_controller,node_users_model,node_user_views toneMint
class node_database,node_model_base,node_sql_builder,node_validation,node_string_helper,node_email_helper,node_file_helper,node_user_helper,node_site_helper,node_time_helper toneRose
class node_browser toneIndigo
```

## Components

### Request handling

- [Application bootstrap](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/App.php): `core/App.php`
- [Controller routing](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/classes/Controller.php): `core/classes/Controller.php`
- [Main page](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/controllers/MainController.php): `app/controllers/MainController.php`

### Post management

- [Post actions](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/controllers/PostsController.php): `app/controllers/PostsController.php`
- [Post data](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/models/PostsModel.php): `app/models/PostsModel.php`
- [Post pages](https://github.com/utoyvo/crud-mvc-oop-pdo/tree/master/app/views/posts): `app/views/posts`

### Accounts

- [User actions](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/controllers/UsersController.php): `app/controllers/UsersController.php`
- [User data](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/app/models/UsersModel.php): `app/models/UsersModel.php`
- [Account pages](https://github.com/utoyvo/crud-mvc-oop-pdo/tree/master/app/views/users): `app/views/users`

### Shared framework

- [MySQL database](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/database.sql): `database.sql`
- [Model base](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/classes/Model.php): `core/classes/Model.php`
- [SQL builder](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/classes/Sql.php): `core/classes/Sql.php`
- [Validation errors](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/classes/ValidationException.php): `core/classes/ValidationException.php`
- [String validation](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/Str.php): `core/helpers/Str.php`
- [Email validation](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/Email.php): `core/helpers/Email.php`
- [Upload handling](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/File.php): `core/helpers/File.php`
- [Session and roles](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/User.php): `core/helpers/User.php`
- [Site utilities](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/Site.php): `core/helpers/Site.php`
- [Date formatting](https://github.com/utoyvo/crud-mvc-oop-pdo/blob/master/core/helpers/Time.php): `core/helpers/Time.php`

### Other components

- **Visitor**

## Connections

- Visitor → Application bootstrap: requests page (evidence: `README.md`)
- Application bootstrap → Main page: loads fallback (evidence: `core/App.php`)
- Application bootstrap → Controller routing: instantiates controller (evidence: `core/App.php`)
- Controller routing → Post actions: dispatches action (evidence: `app/controllers/PostsController.php`)
- Controller routing → User actions: dispatches action (evidence: `app/controllers/UsersController.php`)
- Controller routing → Main page: dispatches action (evidence: `core/classes/Controller.php`)
- Post actions → Post data: calls model (evidence: `app/controllers/PostsController.php`)
- Post actions → Post pages: renders pages (evidence: `app/controllers/PostsController.php`)
- User actions → User data: calls model (evidence: `app/controllers/UsersController.php`)
- User actions → Account pages: renders pages (evidence: `app/controllers/UsersController.php`)
- Model base → SQL builder: uses queries (evidence: `core/classes/Model.php`)
- Post data → Model base: extends (evidence: `app/models/PostsModel.php`)
- User data → Model base: extends (evidence: `app/models/UsersModel.php`)
- User data → MySQL database: reads and writes
- Post data → MySQL database: reads and writes
- User data → String validation: validates input (evidence: `app/models/UsersModel.php`)
- User data → Email validation: validates email (evidence: `app/models/UsersModel.php`)
- User data → Validation errors: throws errors (evidence: `app/models/UsersModel.php`)
- Post data → Upload handling: handles covers (evidence: `app/models/PostsModel.php`)
- Post actions → Session and roles: checks access (evidence: `app/controllers/PostsController.php`)
- User actions → Session and roles: checks access (evidence: `app/controllers/UsersController.php`)
- User data → Site utilities: redirects (evidence: `app/models/UsersModel.php`)
- Post actions → Site utilities: redirects (evidence: `app/controllers/PostsController.php`)
- Account pages → Date formatting: formats dates (evidence: `app/views/users/user.php`)
- Post pages → Date formatting: formats dates (evidence: `app/views/posts/post.php`)
