# sonukr822800/blood-donation-management architecture

> Architecture diagram of the GitHub repository sonukr822800/blood-donation-management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sonukr822800/blood-donation-management
- Repository: https://github.com/sonukr822800/blood-donation-management

## Overview

##### Project type and purpose
- This is a full-stack PHP web application called “Blood-Bank & Donation Management System.”
- It provides two layouts:
- User-facing pages (home, about us, why donate, become donor, search, contact)
- Admin panel (authentication, donor management, page content management, contact queries).

##### File structure
- Top-level files: home.php, about_us.php, need_blood.php, donate_blood.php, contact_us.php, etc.
- Shared includes: head.php, footer.php, slider.php, ticker.php, conn.php (database connection).
- “admin” directory: all admin PHP scripts (login, dashboard, add/update/delete donor, manage pages, queries), plus nicedit.js.
- “sql” directory: blood_bank_database.sql for MySQL schema.
- “image” and “admin/admin_image” folders: static assets for user and admin pages.

##### README for additional insights
- Technology stack: Apache + PHP + MySQL (XAMPP/WAMP).
- Database schema imported from sql/blood_bank_database.sql.
- Two logical modules: public website and protected admin panel.

##### Main components
a. Client (Web Browser)
- Interacts via HTTP/HTTPS
- Requests user pages or admin pages
b. Web Server Layer
- Apache HTTP Server running PHP
- Hosts all .php files and static assets (images, JS, CSS)
- Contains routing through individual PHP scripts
c. Application Layer (PHP Scripts)
- Public controllers: home.php, about_us.php, need_blood.php, donate_blood.php, contact_us.php, savedata.php, search_blood_group.php
- Admin controllers: admin/login.php, admin/dashboard.php, admin/add_donor.php, admin/delete.php, etc.
- Shared modules: conn.php, session.php, header.php, sidebar.php
d. Persistence Layer
- MySQL database “blood_bank_database” (hosted on local MySQL instance)
- Tables for donors, pages, contact queries, admins, sessions, etc.
e. Static File Storage
- Public images (slider, ticker) under /image
- Admin-uploaded images under /admin/admin_image
f. (Optional) External Services
- Email SMTP for contact us form notifications (if implemented)

##### Relationships and data flows
- Browser → Apache HTTP Server: HTTP Request → routes to specific PHP script
- PHP script → includes conn.php → opens MySQL connection
- PHP script ↔ MySQL: CRUD operations on relevant tables
- PHP script → reads/writes files in /image or /admin/admin_image
- Admin session control: login → session.php sets session cookies → guarded access to admin pages

##### Architectural patterns and design principles
- Layered architecture: Presentation (HTML/PHP templates), Application (business logic in PHP controllers), Data (MySQL)
- Modularization by directory: “admin” vs “public” modules
- Shared include files for cross-cutting concerns (DB connection, header/footer, session management)

a. Start by placing the Client (Browser) at the left or top.
– Public controllers (home.php, about_us.php, etc.)
– Admin controllers (/admin/*.php)
h. Optionally, show “Session Store” if sessions are persisted.

##### Clarity and detail
- Notes about key frameworks/libraries (e.g., nicedit.js for rich text editing in admin).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client
    Browser["Web Browser"]:::client

    %% Server
    subgraph "Apache HTTP Server + PHP"
        direction TB

        subgraph "Public Module"
            direction TB
            Home["home.php"]:::server
            About["about_us.php"]:::server
            Need["need_blood.php"]:::server
            Why["why_donate_blood.php"]:::server
            Donate["donate_blood.php"]:::server
            Contact["contact_us.php"]:::server
            Search["search_blood_group.php"]:::server
            SaveData["savedata.php"]:::server
        end

        subgraph "Admin Module"
            direction TB
            Login["login.php"]:::server
            Logout["logout.php"]:::server
            Dashboard["dashboard.php"]:::server
            AddDonor["add_donor.php"]:::server
            SaveDonor["save_donor_data.php"]:::server
            Delete["delete.php"]:::server
            DeleteQuery["delete_query.php"]:::server
            DonorList["donor_list.php"]:::server
            Pages["pages.php"]:::server
            UpdatePage["update_page_details.php"]:::server
            PendingQuery["pending_query.php"]:::server
            Query["query.php"]:::server
            UpdateContact["update_contact.php"]:::server
            ChangePwd["change_password.php"]:::server
            AdminHeader["header.php"]:::server
            Sidebar["sidebar.php"]:::server
            Sess["session.php"]:::server
            ConnAdmin["conn.php"]:::server
        end

        subgraph "Shared Modules"
            direction TB
            Conn["conn.php"]:::server
            Head["head.php"]:::server
            Footer["footer.php"]:::server
            Slider["slider.php"]:::server
            Ticker["ticker.php"]:::server
        end
    end

    %% Database and Storage
    MySQLDB["blood_bank_database"]:::db
    ImagePublic["/image"]:::storage
    ImageAdmin["/admin/admin_image"]:::storage

    %% Connections
    Browser -->|"HTTP GET/POST"| Home
    Browser -->|"HTTP GET/POST"| About
    Browser -->|"HTTP GET/POST"| Need
    Browser -->|"HTTP GET/POST"| Why
    Browser -->|"HTTP GET/POST"| Donate
    Browser -->|"HTTP GET/POST"| Contact
    Browser -->|"HTTP GET/POST"| Search
    Browser -->|"HTTP POST"| SaveData
    Browser -->|"HTTP GET/POST"| Login
    Browser -->|"HTTP GET/POST"| Dashboard

    Home -->|"includes"| Conn
    About -->|"includes"| Conn
    Need -->|"includes"| Conn
    Why -->|"includes"| Conn
    Donate -->|"includes"| Conn
    Contact -->|"includes"| Conn
    Search -->|"includes"| Conn
    SaveData -->|"includes"| Conn

    Login -->|"includes"| ConnAdmin
    Logout -->|"includes"| ConnAdmin
    Dashboard -->|"includes"| ConnAdmin
    AddDonor -->|"includes"| ConnAdmin
    SaveDonor -->|"includes"| ConnAdmin
    Delete -->|"includes"| ConnAdmin
    DeleteQuery -->|"includes"| ConnAdmin
    DonorList -->|"includes"| ConnAdmin
    Pages -->|"includes"| ConnAdmin
    UpdatePage -->|"includes"| ConnAdmin
    PendingQuery -->|"includes"| ConnAdmin
    Query -->|"includes"| ConnAdmin
    UpdateContact -->|"includes"| ConnAdmin
    ChangePwd -->|"includes"| ConnAdmin
    AdminHeader -->|"includes"| ConnAdmin
    Sidebar -->|"includes"| ConnAdmin
    Sess -->|"session"| Dashboard

    Conn -->|"SQL queries via conn.php"| MySQLDB
    ConnAdmin -->|"SQL queries via conn.php"| MySQLDB

    Home -->|"read/write images"| ImagePublic
    About -->|"read/write images"| ImagePublic
    Need -->|"read/write images"| ImagePublic
    Why -->|"read/write images"| ImagePublic
    Donate -->|"read/write images"| ImagePublic
    Contact -->|"read/write images"| ImagePublic
    Slider -->|"read"| ImagePublic
    Ticker -->|"read"| ImagePublic

    AddDonor -->|"upload images"| ImageAdmin
    UpdatePage -->|"upload images"| ImageAdmin

    %% Click Events Public Controllers
    click Home "https://github.com/sonukr822800/blood-donation-management/blob/main/home.php"
    click About "https://github.com/sonukr822800/blood-donation-management/blob/main/about_us.php"
    click Need "https://github.com/sonukr822800/blood-donation-management/blob/main/need_blood.php"
    click Why "https://github.com/sonukr822800/blood-donation-management/blob/main/why_donate_blood.php"
    click Donate "https://github.com/sonukr822800/blood-donation-management/blob/main/donate_blood.php"
    click Contact "https://github.com/sonukr822800/blood-donation-management/blob/main/contact_us.php"
    click Search "https://github.com/sonukr822800/blood-donation-management/blob/main/search_blood_group.php"
    click SaveData "https://github.com/sonukr822800/blood-donation-management/blob/main/savedata.php"

    %% Click Events Shared Modules
    click Conn "https://github.com/sonukr822800/blood-donation-management/blob/main/conn.php"
    click Head "https://github.com/sonukr822800/blood-donation-management/blob/main/head.php"
    click Footer "https://github.com/sonukr822800/blood-donation-management/blob/main/footer.php"
    click Slider "https://github.com/sonukr822800/blood-donation-management/blob/main/slider.php"
    click Ticker "https://github.com/sonukr822800/blood-donation-management/blob/main/ticker.php"

    %% Click Events Admin Controllers
    click Login "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/login.php"
    click Logout "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/logout.php"
    click Dashboard "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/dashboard.php"
    click AddDonor "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/add_donor.php"
    click SaveDonor "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/save_donor_data.php"
    click Delete "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/delete.php"
    click DeleteQuery "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/delete_query.php"
    click DonorList "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/donor_list.php"
    click Pages "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/pages.php"
    click UpdatePage "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/update_page_details.php"
    click PendingQuery "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/pending_query.php"
    click Query "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/query.php"
    click UpdateContact "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/update_contact.php"
    click ChangePwd "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/change_password.php"
    click AdminHeader "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/header.php"
    click Sidebar "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/sidebar.php"
    click Sess "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/session.php"
    click ConnAdmin "https://github.com/sonukr822800/blood-donation-management/blob/main/admin/conn.php"

    %% Click Events Storage & DB
    click MySQLDB "https://github.com/sonukr822800/blood-donation-management/blob/main/sql/blood_bank_database.sql"
    click ImagePublic "https://github.com/sonukr822800/blood-donation-management/tree/main//image"
    click ImageAdmin "https://github.com/sonukr822800/blood-donation-management/tree/main//admin/admin_image"

    %% Styles
    classDef client fill:#cccccc,stroke:#333,stroke-width:1px;
    classDef server fill:#bbdefb,stroke:#1e88e5,stroke-width:1px;
    classDef db fill:#c8e6c9,stroke:#388e3c,stroke-width:1px,stroke-dasharray: 5 5;
    classDef storage fill:#fff59d,stroke:#fbc02d,stroke-width:1px;
```
