# itsjupiter000/meditrack architecture

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

- Interactive diagram: https://gitdiagram.com/itsjupiter000/meditrack
- Repository: https://github.com/itsjupiter000/meditrack

## Overview

##### Project type and purpose
- Project type: Java EE web application (Servlet-based full-stack web app).
- Purpose: MediTrack is an online medicine management system that lets users add, update, delete, and display medicine records per patient. It uses Java Servlets for backend logic, HTML/CSS for the UI, MySQL for persistence, and runs in a Tomcat container.

##### File structure
- Top-level directories/files:
- src/main/java – Servlet classes and data-access code
- src/main/webapp – Static HTML pages, WEB-INF (web.xml, libraries)
- build/classes – Compiled .class files
- README.md – High-level project description and tech stack
- In src/main/java:
- Home.java, Display.java, AddMedicine.java, UpdateMedicine.java, DeleteMedicine.java – act as Controllers
- DBHandler.java – data-access object (DAO) using JDBC
- Medicines.java – model/entity class
- In src/main/webapp:
- HTML pages mapped to each servlet action
- WEB-INF/web.xml – servlet mappings, context params
- WEB-INF/lib/mysql-connector-j.jar – JDBC driver

##### README for additional insights
- Confirms MVC-style separation: HTML views, Servlets as controllers, DBHandler+MySQL as model/persistence.
- Technical stack: Java Servlets, MySQL, HTML/CSS, Tomcat, JDBC.

##### Detail and coverage
- Servlet mappings (from web.xml) if desired.
- Medicines entity class bridging DB rows ↔ Java objects.
- Call out the JDBC driver as a dependency in WEB-INF/lib.
- CRUD operations as separate flows or annotate the Add/Update/Delete/Display paths.
- Be explicit about configuration files (web.xml) and where they reside in the deployment.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Define nodes
    Browser["Web Browser"]:::external

    subgraph "Web UI Layer"
        direction TB
        HomeHTML["Home.html"]:::ui
        AddHTML["AddMedicine.html"]:::ui
        UpdateHTML["UpdateMedicine.html"]:::ui
        DeleteHTML["DeleteMedicine.html"]:::ui
        DisplayHTML["Display.html"]:::ui
    end

    subgraph "Tomcat Servlet Container"
        direction TB
        subgraph "Controllers" 
            direction TB
            HomeServlet["Home Servlet"]:::controller
            DisplayServlet["Display Servlet"]:::controller
            AddServlet["AddMedicine Servlet"]:::controller
            UpdateServlet["UpdateMedicine Servlet"]:::controller
            DeleteServlet["DeleteMedicine Servlet"]:::controller
        end
        subgraph "Services / DAO"
            direction TB
            DBHandler["DBHandler (DAO)"]:::dao
            JDBCDriver["mysql-connector-j-8.3.0.jar"]:::lib
        end
        subgraph "Model"
            direction TB
            Medicines["Medicines Entity"]:::model
        end
        subgraph "Configuration"
            direction TB
            WebXML["web.xml"]:::config
        end
    end

    MySQL["MySQL Database"]:::db

    %% Connections
    Browser -->|"HTTP GET/POST"| HomeHTML
    Browser -->|"HTTP GET/POST"| AddHTML
    Browser -->|"HTTP GET/POST"| UpdateHTML
    Browser -->|"HTTP GET/POST"| DeleteHTML
    Browser -->|"HTTP GET/POST"| DisplayHTML

    HomeHTML -->|"submit to /home"| HomeServlet
    AddHTML -->|"submit to /addMedicine"| AddServlet
    UpdateHTML -->|"submit to /updateMedicine"| UpdateServlet
    DeleteHTML -->|"submit to /deleteMedicine"| DeleteServlet
    DisplayHTML -->|"submit to /display"| DisplayServlet

    HomeServlet -->|"calls"| DBHandler
    AddServlet -->|"calls"| DBHandler
    UpdateServlet -->|"calls"| DBHandler
    DeleteServlet -->|"calls"| DBHandler
    DisplayServlet -->|"calls"| DBHandler

    DBHandler -->|"loads entity"| Medicines
    DBHandler -->|"uses JDBC"| JDBCDriver
    DBHandler -->|"executes SQL"| MySQL

    WebXML -->|"maps servlets"| HomeServlet
    WebXML -->|"maps servlets"| AddServlet
    WebXML -->|"maps servlets"| UpdateServlet
    WebXML -->|"maps servlets"| DeleteServlet
    WebXML -->|"maps servlets"| DisplayServlet

    HomeServlet -->|"HTTP Response"| HomeHTML
    AddServlet -->|"HTTP Response"| AddHTML
    UpdateServlet -->|"HTTP Response"| UpdateHTML
    DeleteServlet -->|"HTTP Response"| DeleteHTML
    DisplayServlet -->|"HTTP Response"| DisplayHTML

    %% Click Events
    click HomeHTML "https://github.com/itsjupiter000/meditrack/blob/master/src/main/webapp/Home.html"
    click AddHTML "https://github.com/itsjupiter000/meditrack/blob/master/src/main/webapp/AddMedicine.html"
    click UpdateHTML "https://github.com/itsjupiter000/meditrack/blob/master/src/main/webapp/UpdateMedicine.html"
    click DeleteHTML "https://github.com/itsjupiter000/meditrack/blob/master/src/main/webapp/DeleteMedicine.html"
    click DisplayHTML "https://github.com/itsjupiter000/meditrack/blob/master/src/main/webapp/WEB-INF/Display.html"
    click HomeServlet "https://github.com/itsjupiter000/meditrack/blob/master/src/main/java/Home.java"
    click DisplayServlet "https://github.com/itsjupiter000/meditrack/blob/master/src/main/java/Display.java"
    click AddServlet "https://github.com/itsjupiter000/meditrack/blob/master/src/main/java/AddMedicine.java"
    click UpdateServlet "https://github.com/itsjupiter000/meditrack/blob/master/src/main/java/UpdateMedicine.java"
    click DeleteServlet "https://github.com/itsjupiter000/meditrack/blob/master/src/main/java/DeleteMedicine.java"
    click DBHandler "https://github.com/itsjupiter000/meditrack/blob/master/src/main/java/DBHandler.java"
    click Medicines "https://github.com/itsjupiter000/meditrack/blob/master/src/main/java/Medicines.java"
    click WebXML "https://github.com/itsjupiter000/meditrack/blob/master/src/main/webapp/WEB-INF/web.xml"
    click JDBCDriver "https://github.com/itsjupiter000/meditrack/blob/master/src/main/webapp/WEB-INF/lib/mysql-connector-j-8.3.0.jar"

    %% Styles
    classDef external fill:#e0f7fa,stroke:#006064,color:#006064
    classDef ui fill:#bbdefb,stroke:#0d47a1,color:#0d47a1
    classDef controller fill:#c8e6c9,stroke:#1b5e20,color:#1b5e20
    classDef dao fill:#fff9c4,stroke:#f57f17,color:#f57f17
    classDef model fill:#ffe0b2,stroke:#e65100,color:#e65100
    classDef config fill:#eeeeee,stroke:#424242,color:#424242
    classDef lib fill:#f3e5f5,stroke:#4a148c,color:#4a148c
    classDef db fill:#ffccbc,stroke:#bf360c,color:#bf360c
```
