# hichamzrk/oc_p5_blog architecture

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

- Interactive diagram: https://gitdiagram.com/hichamzrk/oc_p5_blog
- Repository: https://github.com/hichamzrk/oc_p5_blog

## Overview

##### Project type and purpose
- This is a monolithic, full-stack PHP blog application following an MVC (Model-View-Controller) pattern.
- It offers public pages (home, posts, single post view, contact form) and an admin area for creating, updating and deleting posts, plus user management.

##### File structure
- Top-level directories:
- Controllers – orchestrate requests, call models, render views
- Models – represent data entities (User, Post, Comment, Token) and their managers
- Views – presentation templates, one folder per feature (posts, post, comments, login, admin, etc.) plus a default layout
- Core – framework core: Db connection (Core/Db/Db.php) and Main bootstrapper (Core/Main.php)
- Public – webroot: index.php (front controller), assets (CSS, pictures), .htaccess routing
- SQL schema file (blog.sql) and composer files for dependencies

##### README for additional insights
- Confirms MVC model, PHP OOP, local server setup, MySQL database, email/contact settings in MainController.

a. Main components
1. Client (Browser)
2. Webserver / PHP runtime
3. Front Controller (Public/index.php + .htaccess)
4. Router / Core/Main – determines which Controller to invoke
5. Controllers (AdminController, PostsController, UserController, MainController)
6. Models / Managers – DB abstraction (Model classes + *Manager classes)
7. Database (MySQL “blog” schema)
8. Views (PHP templates)
9. External services: SMTP for contact form (via MainController)
10. Assets Server (CSS, images served from Public/css, Public/picture)

b. Relationships and interactions
- Browser → HTTP request → Webserver → index.php (Front Controller)
- index.php → Core/Main loads configuration, invokes Router
- Router → resolves URL → appropriate Controller.method()
- Controller → ModelManager (e.g., PostManager) → executes SQL via Core/Db/Db → returns entity objects
- Controller → passes entities to View → View renders HTML → sent back to Client
- For admin actions: Controller checks session, calls UserManager and TokenManager as needed
- Contact form submission: MainController sends email via SMTP

c. Architectural patterns and design principles
- MVC separation of concerns
- Single Responsibility: Controllers handle HTTP logic, Models handle data, Views handle presentation
- Dependency inversion: Controllers depend on Manager interfaces (via Manager.php base)
- Reusable Db connector (Singleton or static factory in Core/Db/Db.php)

d. Key technologies, frameworks, libraries
- PHP 7+ OOP
- Apache/Nginx with .htaccess routing
- MySQL database
- Composer for autoloading
- Native PHP mail or SMTP library for contact form

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Entities
    Browser["Browser"]:::external
    Webserver_PHP["Webserver / PHP"]:::external
    SMTP["SMTP Service"]:::external

    %% Public Boundary
    subgraph "Public (Webroot)"
        indexPublic["Front Controller"]:::controllers
        htaccess[".htaccess"]:::controllers
        assetsCSS["CSS Assets"]:::external
        assetsIMG["Image Assets"]:::external
    end

    Browser -->|"HTTP request"| Webserver_PHP
    Webserver_PHP -->|"serve index.php"| indexPublic
    Browser --> assetsCSS
    Browser --> assetsIMG

    indexPublic -->|".htaccess routing"| htaccess
    indexPublic -->|"invoke Router"| Main
    htaccess --> Main

    click indexPublic "https://github.com/hichamzrk/oc_p5_blog/blob/master/Public/index.php"
    click htaccess "https://github.com/hichamzrk/oc_p5_blog/blob/master/Public/.htaccess"
    click assetsCSS "https://github.com/hichamzrk/oc_p5_blog/blob/master/Public/css/style.css"
    click assetsIMG "https://github.com/hichamzrk/oc_p5_blog/tree/master/Public/picture/"

    %% Core Layer
    subgraph "Core"
        Main["Router / Bootstrapper"]:::controllers
        DbConnector["Db Connector"]:::models
    end

    click Main "https://github.com/hichamzrk/oc_p5_blog/blob/master/Core/Main.php"
    click DbConnector "https://github.com/hichamzrk/oc_p5_blog/blob/master/Core/Db/Db.php"

    %% Controllers Layer
    subgraph "Controllers"
        ControllerBase["BaseController"]:::controllers
        MainController["MainController"]:::controllers
        PostsController["PostsController"]:::controllers
        AdminController["AdminController"]:::controllers
        UserController["UserController"]:::controllers
    end

    click ControllerBase "https://github.com/hichamzrk/oc_p5_blog/blob/master/Controllers/Controller.php"
    click MainController "https://github.com/hichamzrk/oc_p5_blog/blob/master/Controllers/MainController.php"
    click PostsController "https://github.com/hichamzrk/oc_p5_blog/blob/master/Controllers/PostsController.php"
    click AdminController "https://github.com/hichamzrk/oc_p5_blog/blob/master/Controllers/AdminController.php"
    click UserController "https://github.com/hichamzrk/oc_p5_blog/blob/master/Controllers/UserController.php"

    Main -->|"resolve URL"| MainController
    Main -->|"resolve URL"| PostsController
    Main -->|"resolve URL"| AdminController
    Main -->|"resolve URL"| UserController

    %% Models Layer
    subgraph "Models"
        ModelBase["BaseModel"]:::models
        Post["Post Entity"]:::models
        PostManager["PostManager"]:::models
        Comment["Comment Entity"]:::models
        CommentManager["CommentManager"]:::models
        User["User Entity"]:::models
        UserManager["UserManager"]:::models
        TokenManager["TokenManager"]:::models
    end

    click ModelBase "https://github.com/hichamzrk/oc_p5_blog/blob/master/Models/Manager.php"
    click Post "https://github.com/hichamzrk/oc_p5_blog/blob/master/Models/Post.php"
    click PostManager "https://github.com/hichamzrk/oc_p5_blog/blob/master/Models/PostManager.php"
    click Comment "https://github.com/hichamzrk/oc_p5_blog/blob/master/Models/Comment.php"
    click CommentManager "https://github.com/hichamzrk/oc_p5_blog/blob/master/Models/CommentManager.php"
    click User "https://github.com/hichamzrk/oc_p5_blog/blob/master/Models/User.php"
    click UserManager "https://github.com/hichamzrk/oc_p5_blog/blob/master/Models/UserManager.php"
    click TokenManager "https://github.com/hichamzrk/oc_p5_blog/blob/master/Models/TokenManager.php"

    %% Database
    Database["MySQL Database"]:::external

    %% Views Layer
    subgraph "Views"
        DefaultLayout["Default Layout"]:::views
        PostsView["Posts Listing View"]:::views
        SinglePostView["Single Post View"]:::views
        CommentsView["Comments View"]:::views
        LoginView["Login View"]:::views
        AdminDashboardView["Admin Dashboard View"]:::views
        CreatePostView["Create Post View"]:::views
        UpdatePostView["Update Post View"]:::views
        HomeView["Home Page View"]:::views
    end

    click DefaultLayout "https://github.com/hichamzrk/oc_p5_blog/blob/master/Views/default.php"
    click PostsView "https://github.com/hichamzrk/oc_p5_blog/blob/master/Views/posts/index.php"
    click SinglePostView "https://github.com/hichamzrk/oc_p5_blog/blob/master/Views/post/index.php"
    click CommentsView "https://github.com/hichamzrk/oc_p5_blog/blob/master/Views/comments/index.php"
    click LoginView "https://github.com/hichamzrk/oc_p5_blog/blob/master/Views/login/index.php"
    click AdminDashboardView "https://github.com/hichamzrk/oc_p5_blog/blob/master/Views/admin/index.php"
    click CreatePostView "https://github.com/hichamzrk/oc_p5_blog/blob/master/Views/createPost/index.php"
    click UpdatePostView "https://github.com/hichamzrk/oc_p5_blog/blob/master/Views/updatePost/index.php"
    click HomeView "https://github.com/hichamzrk/oc_p5_blog/blob/master/Views/Main/index.php"

    %% Controller to Model interactions
    PostsController -->|"calls"| PostManager
    PostsController -->|"calls"| CommentManager
    AdminController -->|"calls"| PostManager
    AdminController -->|"calls"| UserManager
    AdminController -->|"calls"| TokenManager
    UserController -->|"calls"| UserManager
    UserController -->|"calls"| TokenManager
    MainController -->|"uses"| UserManager
    MainController -->|"sends email"| SMTP

    %% Models to Database
    PostManager -->|"executes SQL"| DbConnector
    CommentManager -->|"executes SQL"| DbConnector
    UserManager -->|"executes SQL"| DbConnector
    TokenManager -->|"executes SQL"| DbConnector
    DbConnector -->|"connects to"| Database

    %% Controllers to Views
    PostsController -->|"render template"| PostsView
    PostsController -->|"render template"| SinglePostView
    PostsController -->|"render template"| CommentsView
    AdminController -->|"render template"| AdminDashboardView
    AdminController -->|"render template"| CreatePostView
    AdminController -->|"render template"| UpdatePostView
    UserController -->|"render template"| LoginView
    MainController -->|"render template"| HomeView

    %% Views back to Browser
    PostsView --> Browser
    SinglePostView --> Browser
    CommentsView --> Browser
    AdminDashboardView --> Browser
    CreatePostView --> Browser
    UpdatePostView --> Browser
    LoginView --> Browser
    HomeView --> Browser

    %% Styles
    classDef controllers fill:#c8e6c9,stroke:#2e7d32,color:#2e7d32
    classDef models fill:#bbdefb,stroke:#1565c0,color:#1565c0
    classDef views fill:#ffe0b2,stroke:#ef6c00,color:#e65100
    classDef external fill:#eeeeee,stroke:#757575,color:#212121
```
