# sachink23/hics architecture

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

- Interactive diagram: https://gitdiagram.com/sachink23/hics
- Repository: https://github.com/sachink23/hics

## Overview

##### Project type and purpose
- This is a monolithic, PHP-based full-stack web application called “Hospital Information Collection System,” developed for NIC Parbhani.
- It provides two primary user-facing portals:
- An admin portal (under /admin) where higher-level users can manage hospitals, view/modify reports, handle user accounts, etc.
- A hospital portal (under /hospital) where individual hospitals submit their data and view reporting forms.

##### File structure
- Top-level directories:
- /admin – contains all admin-side pages, backend PHP scripts, and UI chunks (top.php, bottom.php).
- /hospital – contains the hospital-side analogue.
- /assets – static assets (CSS/JS/images), including Materialize framework and custom theme.
- /classes – likely houses PHP classes used across both portals.
- Key files:
- .php – central bootstrap script (DB connection, constants, session init).
- template.php – shared layout logic.
- index.php, register.php, saveRegisterData.php, logout.php – entry points for authentication and registration.
- MVC hints:
- “chunks” directories hold view fragments.
- “backend” directories house controller-style scripts.
- Data access is probably in include.php or classes.

##### README for additional insights
- README is minimal but confirms the intended audience (NIC Parbhani) and the core use case: collecting and reporting hospital information.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Clients
    Browser["Web Browser"]:::frontend

    %% Web Server
    subgraph "Web Server"
        direction TB

        subgraph "Presentation Layer"
            direction TB
            AdminPortal["Admin Portal (/admin)"]:::frontend
            HospitalPortal["Hospital Portal (/hospital)"]:::frontend
            AuthIndex["index.php"]:::frontend
            AuthRegister["register.php"]:::frontend
            AuthSave["saveRegisterData.php"]:::frontend
            AuthLogout["logout.php"]:::frontend
            StaticAssets["Static Assets\n(/assets)"]:::frontend
        end

        subgraph "Business Logic Layer"
            direction TB
            AdminBL["Admin Business Logic\n(/admin/backend)"]:::business
            HospitalBL["Hospital Business Logic\n(/hospital/backend)"]:::business
        end

        subgraph "Shared Components"
            direction TB
            Bootstrap["Shared Bootstrap\n(include.php)"]:::shared
            Template["Shared Layout/Template\n(template.php)"]:::shared
            Classes["Shared PHP Classes\n(/classes)"]:::shared
            ChunksAdmin["Admin View Chunks\n(/admin/chunks)"]:::shared
            ChunksHospital["Hospital View Chunks\n(/hospital/chunks)"]:::shared
            Status["Site Status Checker\n(site_status)"]:::shared
            ErrorHandler["Global Error Handler\n(error.php)"]:::shared
        end
    end

    %% Data & External
    DB["Database Server\n(MySQL)"]:::data
    Email["Email Service"]:::external

    %% Connections
    Browser -->|"HTTP(S) requests"| AdminPortal
    Browser -->|"HTTP(S) requests"| HospitalPortal
    Browser -->|"HTTP(S) requests"| AuthIndex
    Browser -->|"HTTP(S) requests"| AuthRegister
    Browser -->|"HTTP(S) requests"| AuthSave
    Browser -->|"HTTP(S) requests"| AuthLogout
    Browser -->|"loads assets"| StaticAssets

    AdminPortal -->|"calls"| AdminBL
    HospitalPortal -->|"calls"| HospitalBL
    AuthIndex -->|"calls"| AdminBL
    AuthIndex -->|"calls"| HospitalBL
    AuthRegister -->|"calls"| AdminBL
    AuthRegister -->|"calls"| HospitalBL
    AuthSave -->|"calls"| AdminBL
    AuthSave -->|"calls"| HospitalBL
    AuthLogout -->|"calls"| AdminBL
    AuthLogout -->|"calls"| HospitalBL

    AdminBL -->|"uses"| Bootstrap
    AdminBL -->|"uses"| Template
    AdminBL -->|"uses"| Classes
    AdminBL -->|"uses"| ChunksAdmin
    AdminBL -->|"uses"| ErrorHandler
    AdminBL -->|"checks status"| Status
    AdminBL -->|"queries"| DB
    AdminBL -->|"sends alerts"| Email

    HospitalBL -->|"uses"| Bootstrap
    HospitalBL -->|"uses"| Template
    HospitalBL -->|"uses"| Classes
    HospitalBL -->|"uses"| ChunksHospital
    HospitalBL -->|"uses"| ErrorHandler
    HospitalBL -->|"checks status"| Status
    HospitalBL -->|"queries"| DB
    HospitalBL -->|"sends alerts"| Email

    StaticAssets -->|"serves"| Browser

    %% Click Events
    click AdminPortal "https://github.com/sachink23/hics/tree/master//admin"
    click AdminBL "https://github.com/sachink23/hics/tree/master//admin/backend"
    click ChunksAdmin "https://github.com/sachink23/hics/tree/master//admin/chunks"
    click HospitalPortal "https://github.com/sachink23/hics/tree/master//hospital"
    click HospitalBL "https://github.com/sachink23/hics/tree/master//hospital/backend"
    click ChunksHospital "https://github.com/sachink23/hics/tree/master//hospital/chunks"
    click Bootstrap "https://github.com/sachink23/hics/blob/master/include.php"
    click Template "https://github.com/sachink23/hics/blob/master/template.php"
    click Classes "https://github.com/sachink23/hics/tree/master//classes"
    click AuthIndex "https://github.com/sachink23/hics/blob/master/index.php"
    click AuthRegister "https://github.com/sachink23/hics/blob/master/register.php"
    click AuthSave "https://github.com/sachink23/hics/blob/master/saveRegisterData.php"
    click AuthLogout "https://github.com/sachink23/hics/blob/master/logout.php"
    click StaticAssets "https://github.com/sachink23/hics/tree/master//assets"
    click Status "https://github.com/sachink23/hics/tree/master/site_status"
    click ErrorHandler "https://github.com/sachink23/hics/blob/master/error.php"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#000
    classDef business fill:#90EE90,stroke:#000
    classDef shared fill:#FFFFE0,stroke:#000
    classDef data fill:#FFA500,stroke:#000
    classDef external fill:#FFC0CB,stroke:#000
```
