# vijaysingdobhal/news-portal architecture

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

- Interactive diagram: https://gitdiagram.com/vijaysingdobhal/news-portal
- Repository: https://github.com/vijaysingdobhal/news-portal

## Overview

##### Project Type and Purpose
- This is a monolithic full-stack web application: a PHP/MySQL-powered “News Portal” with two main user surfaces (public site and admin panel) and a shared backend.
- Purpose: Serve dynamic news pages, enable user interactions (registration, commenting, search), and provide an admin dashboard for CRUD management of content and users.

##### File Structure Analysis
- Top-level directories:
- news_portal/ — root of PHP app
- news_portal/admin/ — admin panel scripts, assets, plugins
- news_portal/assets/ — public CSS, JS, images, fonts
- news_portal/js/, news_portal/css/ — site-wide JS/CSS
- news_portal/flip/ — flip-book library and styles
- news_portal/database/ — raw SQL dumps
- Key config and includes:
- config.php — database connection, global constants
- / (within admin) — header/footer/session logic
- Public vs. Admin separation:
- Public pages (index.php, category.php, article.php, search.php, comment handlers)
- Admin pages (dashboard.php, add_*.php, edit_*.php, delete_*.php, user management)
- Plugins & external libs:
- WYSIWYG (Cazary), CKEditor, jQuery, Morris charts, flipbook (turn.js), nicEdit
- No microservices—everything runs under one PHP/Apache (or similar) server.

##### README Insights
- Stack: HTML5, CSS3, JavaScript (client), PHP (server), MySQL (data)
- Features: Responsive design, session-based auth, SEO URLs, search/filter, commenting, social-share hooks.
- Folder structure described matches file tree: assets/, includes/, admin/, core pages.

a. Main components
- Clients (Web Browser on Desktop/Mobile)
- Load Balancer (optional in larger deployment)
- Web Server (Apache/Nginx) with PHP-FPM
- Application Layer (News Portal PHP code)
– Public Module
– Admin Module
– Shared Libraries & Plugins
- Database Server (MySQL)
- File Storage (Local disk or CDN for assets/images/uploads)
- External Services (Social Media APIs for sharing)
b. Relationships & Interactions
- Browser → HTTP(S) → Web Server
- Web Server → PHP interpreter → loads appropriate module (public or admin)
- PHP code → SQL queries → MySQL → returns data
- PHP code → read/write → file system (uploads, images, flip pages)
- PHP code → include → static assets served or forwarded to CDN
- PHP code (comment-handler) → push data → MySQL; → return JSON/html response to client
- Social Share buttons → call external social APIs
c. Architectural Patterns & Principles
- Layered architecture: Presentation (HTML/CSS/JS), Application (PHP scripts), Data (MySQL)
- Modular separation: Public vs Admin modules share common includes/plugins
- Reusable components: header/footer includes, config, session management
- Progressive enhancement: fall back to legacy flipbook support
d. Key Technologies & Libraries
- PHP (vanilla, no framework)
- MySQL
- jQuery, CKEditor, nicEdit, Cazary WYSIWYG, Morris.js charts
- turn.js flipbook

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Clients
    Browser["Client Browser"]:::frontend

    %% Optional Load Balancer
    LB["Load Balancer"]:::backend

    %% Web Server Layer
    WebServer["Web Server + PHP-FPM"]:::backend

    %% Application Layer
    subgraph "Application Layer" 
        direction TB
        PublicModule["Public Module\n(PHP Pages)"]:::backend
        AdminModule["Admin Module\n(Admin Dashboard)"]:::backend
        Config["Config & Bootstrap"]:::backend
        SharedPublic["Shared Includes & Layouts\n(Public)"]:::backend
        SharedAdmin["Shared Includes & Layouts\n(Admin)"]:::backend
        subgraph "Plugins & Libraries"
            direction TB
            FlipBook["Flip-book Library"]:::backend
            Cazary["Cazary WYSIWYG"]:::backend
            CKEditor["CKEditor"]:::backend
            NicEdit["nicEdit"]:::backend
            MorrisJS["Morris.js Charts"]:::backend
            UIWidgets["UI Widgets & Datepickers"]:::backend
        end
        AuthPublic["Public Auth Scripts"]:::backend
        AdminSession["Admin Session Management"]:::backend
    end

    %% Data Storage
    MySQL[(MySQL Database)]:::data
    FileStorage["File Storage / CDN"]:::storage

    %% External Services
    SocialAPI["Social Media APIs"]:::external

    %% Connections
    Browser -->|HTTPS Request| LB
    LB -->|Forward Request| WebServer
    WebServer -->|Invoke PHP| PublicModule
    WebServer -->|Invoke PHP| AdminModule
    PublicModule -->|include| SharedPublic
    AdminModule -->|include| SharedAdmin
    PublicModule -->|use| Config
    AdminModule -->|use| Config
    PublicModule -->|query| MySQL
    AdminModule -->|query| MySQL
    PublicModule -->|read/write| FileStorage
    AdminModule -->|read/write| FileStorage
    PublicModule -->|call| FlipBook
    AdminModule -->|call| Cazary
    AdminModule -->|call| CKEditor
    PublicModule -->|call| NicEdit
    AdminModule -->|call| MorrisJS
    AdminModule -->|call| UIWidgets
    PublicModule -->|use| AuthPublic
    AdminModule -->|use| AdminSession
    PublicModule -->|share buttons| SocialAPI
    AdminModule -->|share buttons| SocialAPI

    MySQL -->|response| PublicModule
    MySQL -->|response| AdminModule

    %% Click Events
    click PublicModule "https://github.com/vijaysingdobhal/news-portal/tree/main/news_portal/"
    click AdminModule "https://github.com/vijaysingdobhal/news-portal/tree/main/news_portal/admin/"
    click Config "https://github.com/vijaysingdobhal/news-portal/blob/main/news_portal/config.php"
    click MySQL "https://github.com/vijaysingdobhal/news-portal/blob/main/news_portal/database/online_news.sql"
    click SharedPublic "https://github.com/vijaysingdobhal/news-portal/blob/main/news_portal/header.php"
    click SharedAdmin "https://github.com/vijaysingdobhal/news-portal/blob/main/news_portal/admin/include/header.php"
    click FlipBook "https://github.com/vijaysingdobhal/news-portal/tree/main/news_portal/flip/"
    click Cazary "https://github.com/vijaysingdobhal/news-portal/tree/main/news_portal/admin/Simple-Html-WYSIWYG-Editor-Plugin-with-jQuery-Cazary/"
    click CKEditor "https://github.com/vijaysingdobhal/news-portal/blob/main/news_portal/admin/js/ckeditor/ckeditor.js"
    click NicEdit "https://github.com/vijaysingdobhal/news-portal/blob/main/news_portal/nicEdit/nicEdit.js"
    click MorrisJS "https://github.com/vijaysingdobhal/news-portal/blob/main/news_portal/admin/js/plugins/morris/morris.js"
    click UIWidgets "https://github.com/vijaysingdobhal/news-portal/blob/main/news_portal/admin/css/datepicker.css"
    click AuthPublic "https://github.com/vijaysingdobhal/news-portal/blob/main/news_portal/registration.php"
    click AdminSession "https://github.com/vijaysingdobhal/news-portal/blob/main/news_portal/admin/include/session_check.php"

    %% Styles
    classDef frontend fill:#D0E6FF,stroke:#0366D6,color:#0366D6;
    classDef backend fill:#DFF2D8,stroke:#22863A,color:#22863A;
    classDef data fill:#FFF5B1,stroke:#735C0F,color:#735C0F,stroke-width:2px;
    classDef storage fill:#E1E4E8,stroke:#6A737D,color:#6A737D;
    classDef external fill:#FFE4C4,stroke:#D73A49,color:#D73A49;
```
