# web-dev-ruchi/news architecture

> Architecture diagram of the GitHub repository web-dev-ruchi/news, 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/web-dev-ruchi/news
- Repository: https://github.com/web-dev-ruchi/news

## Overview

This is a PHP news CMS: visitors browse and search published posts, while authenticated administrators manage posts and site content. Public listing, category, author, search, and single-post pages form the reader workflow; admin pages provide post, category, user, and settings management. The shared templates render navigation and page chrome, and both sides query a MySQL database. Several admin subsystems are identified from the file tree and SOURCE INDEX; their internal calls are not inferred where excerpts do not show them.

Main entry points: [`admin/config.php`](https://github.com/web-dev-ruchi/news/blob/main/admin/config.php) (Admin DB config), [`config.php`](https://github.com/web-dev-ruchi/news/blob/main/config.php) (Public DB config), [`admin/header.php`](https://github.com/web-dev-ruchi/news/blob/main/admin/header.php) (Admin access and menu), [`admin/post.php`](https://github.com/web-dev-ruchi/news/blob/main/admin/post.php) (Post management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public news"]
  node_public_pages["News browsing<br/>[index.php]"]
  node_category_view["Category news<br/>[category.php]"]
  node_author_view["Author news<br/>[author.php]"]
  node_search_view["Post search<br/>[search.php]"]
  node_single_view["Single post<br/>[single.php]"]
end

subgraph group_admin["Admin CMS"]
  node_login["Admin login<br/>[index.php]"]
  node_admin_posts["Post management<br/>[post.php]"]
  node_post_edit["Post editing<br/>[add-post.php]"]
  node_post_update["Post updates<br/>[update-post.php]"]
  node_post_delete["Post deletion<br/>[delete-post.php]"]
  node_categories["Category management<br/>[category.php]"]
  node_users["User management<br/>[users.php]"]
  node_settings["Site settings<br/>[setting.php]"]
end

subgraph group_shared["Shared runtime"]
  node_public_header["Public header<br/>[header.php]"]
  node_public_sidebar["Search and recent<br/>[sidebar.php]"]
  node_public_footer["Public footer<br/>[footer.php]"]
  node_admin_header["Admin access and menu<br/>[header.php]"]
  node_public_config["Public DB config<br/>[config.php]"]
  node_admin_config["Admin DB config<br/>[config.php]"]
end

subgraph group_data["Persistence"]
  node_database[("News database<br/>[news-cms.sql]")]
end

node_visitor(("Visitor"))
node_admin_user(("Administrator"))

node_visitor -->|"browses"| node_public_pages
node_visitor -.->|"opens category"| node_category_view
node_visitor -.->|"opens author"| node_author_view
node_visitor -->|"searches"| node_search_view
node_visitor -.->|"opens post"| node_single_view
node_public_pages -->|"includes"| node_public_header
node_public_pages -->|"includes"| node_public_sidebar
node_public_pages -->|"includes"| node_public_footer
node_public_pages -->|"queries"| node_public_config
node_category_view -->|"includes"| node_public_header
node_category_view -->|"includes"| node_public_sidebar
node_category_view -->|"includes"| node_public_footer
node_category_view -->|"queries"| node_public_config
node_author_view -->|"includes"| node_public_header
node_author_view -->|"includes"| node_public_sidebar
node_author_view -->|"includes"| node_public_footer
node_author_view -->|"queries"| node_public_config
node_search_view -->|"includes"| node_public_header
node_search_view -->|"includes"| node_public_sidebar
node_search_view -->|"includes"| node_public_footer
node_search_view -->|"queries"| node_public_config
node_single_view -->|"includes"| node_public_header
node_single_view -->|"includes"| node_public_sidebar
node_single_view -->|"includes"| node_public_footer
node_single_view -->|"queries"| node_public_config
node_public_header -->|"queries"| node_public_config
node_public_sidebar -->|"queries"| node_public_config
node_public_footer -->|"queries"| node_public_config
node_admin_user -->|"signs in"| node_login
node_admin_user -.->|"manages content"| node_admin_posts
node_login -->|"authenticates"| node_admin_config
node_admin_posts -->|"includes"| node_admin_header
node_admin_posts -->|"queries"| node_admin_config
node_admin_posts -->|"links to"| node_post_edit
node_admin_posts -->|"links to"| node_post_update
node_admin_posts -->|"links to"| node_post_delete
node_post_edit -->|"includes"| node_admin_header
node_post_edit -->|"uses"| node_admin_config
node_post_update -->|"includes"| node_admin_header
node_post_update -->|"uses"| node_admin_config
node_post_delete -->|"uses"| node_admin_config
node_categories -->|"includes"| node_admin_header
node_categories -->|"queries"| node_admin_config
node_users -->|"includes"| node_admin_header
node_users -->|"queries"| node_admin_config
node_settings -->|"includes"| node_admin_header
node_settings -->|"queries"| node_admin_config
node_admin_header -->|"checks session"| node_admin_config

click node_public_pages "https://github.com/web-dev-ruchi/news/blob/main/index.php"
click node_category_view "https://github.com/web-dev-ruchi/news/blob/main/category.php"
click node_author_view "https://github.com/web-dev-ruchi/news/blob/main/author.php"
click node_search_view "https://github.com/web-dev-ruchi/news/blob/main/search.php"
click node_single_view "https://github.com/web-dev-ruchi/news/blob/main/single.php"
click node_login "https://github.com/web-dev-ruchi/news/blob/main/admin/index.php"
click node_admin_posts "https://github.com/web-dev-ruchi/news/blob/main/admin/post.php"
click node_post_edit "https://github.com/web-dev-ruchi/news/blob/main/admin/add-post.php"
click node_post_update "https://github.com/web-dev-ruchi/news/blob/main/admin/update-post.php"
click node_post_delete "https://github.com/web-dev-ruchi/news/blob/main/admin/delete-post.php"
click node_categories "https://github.com/web-dev-ruchi/news/blob/main/admin/category.php"
click node_users "https://github.com/web-dev-ruchi/news/blob/main/admin/users.php"
click node_settings "https://github.com/web-dev-ruchi/news/blob/main/admin/setting.php"
click node_public_header "https://github.com/web-dev-ruchi/news/blob/main/header.php"
click node_public_sidebar "https://github.com/web-dev-ruchi/news/blob/main/sidebar.php"
click node_public_footer "https://github.com/web-dev-ruchi/news/blob/main/footer.php"
click node_admin_header "https://github.com/web-dev-ruchi/news/blob/main/admin/header.php"
click node_public_config "https://github.com/web-dev-ruchi/news/blob/main/config.php"
click node_admin_config "https://github.com/web-dev-ruchi/news/blob/main/admin/config.php"
click node_database "https://github.com/web-dev-ruchi/news/blob/main/database/news-cms.sql"

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_public_pages,node_category_view,node_author_view,node_search_view,node_single_view toneBlue
class node_login,node_admin_posts,node_post_edit,node_post_update,node_post_delete,node_categories,node_users,node_settings toneAmber
class node_public_header,node_public_sidebar,node_public_footer,node_admin_header,node_public_config,node_admin_config toneMint
class node_database toneRose
class node_visitor,node_admin_user toneIndigo
```

## Components

### Public news

- [News browsing](https://github.com/web-dev-ruchi/news/blob/main/index.php): `index.php`
- [Category news](https://github.com/web-dev-ruchi/news/blob/main/category.php): `category.php`
- [Author news](https://github.com/web-dev-ruchi/news/blob/main/author.php): `author.php`
- [Post search](https://github.com/web-dev-ruchi/news/blob/main/search.php): `search.php`
- [Single post](https://github.com/web-dev-ruchi/news/blob/main/single.php): `single.php`

### Admin CMS

- [Admin login](https://github.com/web-dev-ruchi/news/blob/main/admin/index.php): `admin/index.php`
- [Post management](https://github.com/web-dev-ruchi/news/blob/main/admin/post.php): `admin/post.php`
- [Post editing](https://github.com/web-dev-ruchi/news/blob/main/admin/add-post.php): `admin/add-post.php`
- [Post updates](https://github.com/web-dev-ruchi/news/blob/main/admin/update-post.php): `admin/update-post.php`
- [Post deletion](https://github.com/web-dev-ruchi/news/blob/main/admin/delete-post.php): `admin/delete-post.php`
- [Category management](https://github.com/web-dev-ruchi/news/blob/main/admin/category.php): `admin/category.php`
- [User management](https://github.com/web-dev-ruchi/news/blob/main/admin/users.php): `admin/users.php`
- [Site settings](https://github.com/web-dev-ruchi/news/blob/main/admin/setting.php): `admin/setting.php`

### Shared runtime

- [Public header](https://github.com/web-dev-ruchi/news/blob/main/header.php): `header.php`
- [Search and recent](https://github.com/web-dev-ruchi/news/blob/main/sidebar.php): `sidebar.php`
- [Public footer](https://github.com/web-dev-ruchi/news/blob/main/footer.php): `footer.php`
- [Admin access and menu](https://github.com/web-dev-ruchi/news/blob/main/admin/header.php): `admin/header.php`
- [Public DB config](https://github.com/web-dev-ruchi/news/blob/main/config.php): `config.php`
- [Admin DB config](https://github.com/web-dev-ruchi/news/blob/main/admin/config.php): `admin/config.php`

### Persistence

- [News database](https://github.com/web-dev-ruchi/news/blob/main/database/news-cms.sql): `database/news-cms.sql`

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → News browsing: browses (evidence: `index.php`)
- Visitor → Category news: opens category
- Visitor → Author news: opens author
- Visitor → Post search: searches
- Visitor → Single post: opens post
- News browsing → Public header: includes (evidence: `index.php`)
- News browsing → Search and recent: includes (evidence: `index.php`)
- News browsing → Public footer: includes (evidence: `index.php`)
- News browsing → Public DB config: queries (evidence: `index.php`)
- Category news → Public header: includes (evidence: `category.php`)
- Category news → Search and recent: includes (evidence: `category.php`)
- Category news → Public footer: includes (evidence: `category.php`)
- Category news → Public DB config: queries (evidence: `category.php`)
- Author news → Public header: includes (evidence: `author.php`)
- Author news → Search and recent: includes (evidence: `author.php`)
- Author news → Public footer: includes (evidence: `author.php`)
- Author news → Public DB config: queries (evidence: `author.php`)
- Post search → Public header: includes (evidence: `search.php`)
- Post search → Search and recent: includes (evidence: `search.php`)
- Post search → Public footer: includes (evidence: `search.php`)
- Post search → Public DB config: queries (evidence: `search.php`)
- Single post → Public header: includes (evidence: `single.php`)
- Single post → Search and recent: includes (evidence: `single.php`)
- Single post → Public footer: includes (evidence: `single.php`)
- Single post → Public DB config: queries (evidence: `single.php`)
- Public header → Public DB config: queries (evidence: `header.php`)
- Search and recent → Public DB config: queries (evidence: `sidebar.php`)
- Public footer → Public DB config: queries (evidence: `footer.php`)
- Administrator → Admin login: signs in (evidence: `admin/index.php`)
- Administrator → Post management: manages content
- Admin login → Admin DB config: authenticates (evidence: `admin/index.php`)
- Post management → Admin access and menu: includes (evidence: `admin/post.php`)
- Post management → Admin DB config: queries (evidence: `admin/post.php`)
- Post management → Post editing: links to (evidence: `admin/post.php`)
- Post management → Post updates: links to (evidence: `admin/post.php`)
- Post management → Post deletion: links to (evidence: `admin/post.php`)
- Post editing → Admin access and menu: includes (evidence: `admin/add-post.php`)
- Post editing → Admin DB config: uses (evidence: `admin/add-post.php`)
- Post updates → Admin access and menu: includes (evidence: `admin/update-post.php`)
- Post updates → Admin DB config: uses (evidence: `admin/update-post.php`)
- Post deletion → Admin DB config: uses (evidence: `admin/delete-post.php`)
- Category management → Admin access and menu: includes (evidence: `admin/category.php`)
- Category management → Admin DB config: queries (evidence: `admin/category.php`)
- User management → Admin access and menu: includes (evidence: `admin/users.php`)
- User management → Admin DB config: queries (evidence: `admin/users.php`)
- Site settings → Admin access and menu: includes (evidence: `admin/setting.php`)
- Site settings → Admin DB config: queries (evidence: `admin/setting.php`)
- Admin access and menu → Admin DB config: checks session (evidence: `admin/header.php`)
