# noor-ahmed-12/blood-donation-bank-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/noor-ahmed-12/blood-donation-bank-management-system
- Repository: https://github.com/noor-ahmed-12/blood-donation-bank-management-system

## Overview

##### Project type and purpose
- This is a monolithic, full-stack web application (“Blood Donation Bank Management System”) built on the LAMP stack (Apache + PHP + MySQL).
- It provides a public-facing portal (donor search, registration, requests) and an admin dashboard for managing users, donors, blood groups, donations, and requests.

##### File structure
- Top level:
- index.php, login.php, sign-up.php, search-donor.php, profile.php, contact.php – public-facing PHP pages
- request-received.php, donor-list.php, etc. – public user workflows
- css/, js/, images/, webfonts/ – static assets for the public site
- includes/config.php, includes/header.php, includes/footer.php, includes/slider.php – shared layout & configuration
- admin/ – entire admin module
· admin/index.php, dashboard.php, add-donor.php, manage-pages.php, request-received.php, etc.
· admin/includes/ – admin-specific config, header, left sidebar
· admin/css/, admin/js/, admin/img/, admin/fonts/ – admin assets
- Database script: bbdms.sql (defines MySQL schema for users, donors, recipients, blood groups, requests)

##### README for additional insights
- Confirms features: user registration/login, donor & recipient management, donation & request workflows, admin dashboard.
- Technical stack: PHP 7.4+, MySQL 5.7+, HTML/CSS/JS (Bootstrap, jQuery).

a. Main components
1. Client (Browser)
– Renders HTML/CSS/JS; interacts via HTTP(S).
2. Web Server
– Apache/PHP engine hosting:
- Public module (index.php, sign-up.php, includes/*, css/, js/, images/)
- Admin module (/admin/*)
– Shared PHP libraries/config under includes/config.php
3. Database
– MySQL instance storing:
- users table (donors, recipients, admins)
- blood_groups table
- donation_records
- blood_requests
- etc.
4. External services (optional)
– phpMyAdmin (for DB import)
– Email SMTP (if notifications implemented)

b. Relationships and interactions
– Browser ↔ Web Server: HTTP requests for pages, form submissions.
– Web Server ↔ Database: Server-side PHP issues SQL queries (CRUD) via mysqli/PDO.
– Admin module ↔ Public module: share config and DB but kept in separate URL space (/admin).
– Static assets served directly by web server (CSS, JS, fonts, images).

c. Architectural patterns/design principles
– Modular PHP includes for reuse (header, footer, config).
– Thin server-side presentation: server-rendered pages, minimal JS for interactivity.
– Role separation: public vs. admin modules.
– Single database backing entire application.

d. Key technologies/frameworks
– PHP 7.4+, MySQL 5.7+
– Bootstrap 4 (CSS/JS), jQuery, custom JS (medic.js, main.js)
– Apache (via XAMPP)
– Optional: Node/npm for front-end tooling (package.json present)

##### Detail
- Drill down into important pages (e.g., admin/dashboard.php calling chartData.js, admin/includes/config.php) if necessary.
- CRUD workflows: user management, donor records, blood requests, donations.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Browser["Browser (Client)"]:::client

    subgraph "Web Server (Apache/PHP) [Port 80/443]"
        subgraph "Public Module"
            idx["index.php"]:::public
            login["login.php"]:::public
            logout["logout.php"]:::public
            signup["sign-up.php"]:::public
            search["search-donor.php"]:::public
            search2["saerch-donar.php"]:::public
            reqrec["request-received.php"]:::public
            donorlist["donor-list.php"]:::public
            profile["profile.php"]:::public
            changepw["change-password.php"]:::public
            contact["contact.php"]:::public
            contactb["contact-blood.php"]:::public
            about["about.php"]:::public
        end
        subgraph "Admin Module"
            a_index["admin/index.php"]:::admin
            dashboard["admin/dashboard.php"]:::admin
            add_donor["admin/add-donor.php"]:::admin
            add_bg["admin/add-bloodgroup.php"]:::admin
            mg_bg["admin/manage-bloodgroup.php"]:::admin
            mg_pages["admin/manage-pages.php"]:::admin
            mg_donor["admin/donor-list.php"]:::admin
            req_rec_admin["admin/requests-received.php"]:::admin
            req_by_donar["admin/request-received-bydonar.php"]:::admin
            dl_records["admin/download-records.php"]:::admin
            admin_chpw["admin/change-password.php"]:::admin
            admin_fp["admin/forgot-password.php"]:::admin
            admin_profile["admin/profile.php"]:::admin
            admin_logout["admin/logout.php"]:::admin
        end
        subgraph "Shared Includes"
            s_config["includes/config.php"]:::shared
            s_header["includes/header.php"]:::shared
            s_footer["includes/footer.php"]:::shared
            s_slider["includes/slider.php"]:::shared
        end
        subgraph "Public Static Assets"
            pub_css["css/"]:::asset
            pub_js["js/"]:::asset
            pub_img["images/"]:::asset
            pub_fonts["webfonts/"]:::asset
        end
        subgraph "Admin Static Assets"
            adm_css["admin/css/"]:::asset
            adm_js["admin/js/"]:::asset
            adm_img["admin/img/"]:::asset
            adm_fonts["admin/fonts/"]:::asset
            nic["admin/nicEdit.js"]:::asset
        end
    end

    db["MySQL Database\n(bbdms.sql)"]:::db

    Browser -->|"HTTP GET/POST"| idx
    Browser --> login
    Browser --> signup
    Browser --> search
    Browser --> donorlist
    Browser --> profile
    Browser --> contact

    idx --> s_config
    login --> s_config
    signup --> s_config
    a_index --> s_config
    dashboard --> s_config

    idx -->|SQL Queries| db
    login -->|SQL Queries| db
    search -->|SQL Queries| db
    donorlist -->|SQL Queries| db
    profile -->|SQL Queries| db
    a_index -->|SQL Queries| db
    dashboard -->|SQL Queries| db

    pub_css --> idx
    pub_js --> idx
    pub_img --> idx

    adm_css --> dashboard
    adm_js --> dashboard

    classDef client fill:#E3F2FD,stroke:#64B5F6
    classDef public fill:#BBDEFB,stroke:#1976D2
    classDef admin fill:#C8E6C9,stroke:#388E3C
    classDef shared fill:#FFF9C4,stroke:#FBC02D
    classDef asset fill:#F0F4C3,stroke:#AFB42B
    classDef db fill:#FFE0B2,stroke:#FB8C00

    click idx "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/index.php"
    click login "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/login.php"
    click logout "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/logout.php"
    click signup "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/sign-up.php"
    click search "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/search-donor.php"
    click search2 "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/saerch-donar.php"
    click reqrec "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/request-received.php"
    click donorlist "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/donor-list.php"
    click profile "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/profile.php"
    click changepw "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/change-password.php"
    click contact "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/contact.php"
    click contactb "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/contact-blood.php"
    click about "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/about.php"
    click pub_css "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/tree/main/css/"
    click pub_js "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/tree/main/js/"
    click pub_img "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/tree/main/images/"
    click pub_fonts "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/tree/main/webfonts/"
    click s_config "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/includes/config.php"
    click s_header "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/includes/header.php"
    click s_footer "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/includes/footer.php"
    click s_slider "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/includes/slider.php"
    click a_index "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/index.php"
    click dashboard "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/dashboard.php"
    click add_donor "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/add-donor.php"
    click add_bg "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/add-bloodgroup.php"
    click mg_bg "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/manage-bloodgroup.php"
    click mg_pages "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/manage-pages.php"
    click mg_donor "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/donor-list.php"
    click req_rec_admin "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/requests-received.php"
    click req_by_donar "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/request-received-bydonar.php"
    click dl_records "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/download-records.php"
    click admin_chpw "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/change-password.php"
    click admin_fp "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/forgot-password.php"
    click admin_profile "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/profile.php"
    click admin_logout "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/logout.php"
    click adm_css "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/tree/main/admin/css/"
    click adm_js "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/tree/main/admin/js/"
    click adm_img "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/tree/main/admin/img/"
    click adm_fonts "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/tree/main/admin/fonts/"
    click nic "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/admin/nicEdit.js"
    click db "https://github.com/noor-ahmed-12/blood-donation-bank-management-system/blob/main/bbdms.sql"
```
