# samseralikhan/medicine-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/samseralikhan/medicine-tracker
- Repository: https://github.com/samseralikhan/medicine-tracker

## Overview

##### Project Type and Purpose
- This is a full-stack web application called “Medicine-Tracker.”
- Frontend: React single-page app for users to sign up, log in, view/add medicines.
- Backend: Spring Boot microservice exposing REST APIs for auth, user data, medicine CRUD.
- Persistence: Relational database accessed via JPA repositories (UserRepository, MedicineRepository).
- Deployment: Docker containers for client and server orchestrated by docker-compose.

##### File Structure
- Top-level:
- client/ – React app (src, public, build artifacts, Dockerfile)
- server/medtracker/ – Spring Boot service (pom.xml, Dockerfile, Java packages)
- docker-compose.yml – defines multi-container setup
- Frontend follows component/context/page organization.
- Backend uses layered pattern: controller → service → repository → model, plus security (JWT filter, config).
- Config files: client/.env, server src/main/resources/application.properties, Dockerfiles, Maven wrapper.

##### README
- Minimal, only project name. We infer features from code: JWT auth, protected routes (PrivateRoute.jsx), medicine management.

##### Detail
- Don’t stop at “Frontend” and “Backend.”
- Drill into sub-components: e.g., AuthController vs. MedicineController, Context providers in React, JWT utils, exception handler.
- Environment/config concerns: Docker Compose network, .env, application.properties.

Summary
- Within each container, break out modules/packages.
- Technologies, protocols, and data formats (JSON Web Token, JSON Payloads).

## Diagram (Mermaid)

```mermaid
graph TB
    Browser["Web Browser"]:::external

    subgraph "Docker Compose"
        direction TB

        subgraph "React Frontend Container"
            direction TB
            App["App.js"]:::frontend
            API["axiosInstance.js"]:::frontend

            subgraph "Contexts"
                AuthCtx["AuthContext.jsx"]:::frontend
                ThemeCtx["ThemeContext.jsx"]:::frontend
            end

            subgraph "Components"
                PrivateRoute["PrivateRoute.js"]:::frontend
                Navbar["Navbar.jsx"]:::frontend
                MedicineCard["MedicineCard.jsx"]:::frontend
                EditModal["EditMedicineModal.jsx"]:::frontend
                PageTrans["PageTransition.js"]:::frontend
            end

            subgraph "Pages"
                Login["Login.jsx"]:::frontend
                Signup["Signup.jsx"]:::frontend
                Dashboard["Dashboard.jsx"]:::frontend
                AddMed["AddMedicine.jsx"]:::frontend
            end

            Styles["index.css & App.css & tailwind.config.js"]:::frontend
            DockerClient["Dockerfile"]:::frontend
        end

        subgraph "Spring Boot Backend Container"
            direction TB
            Entry["MedtrackerApplication.java"]:::backend

            subgraph "Controllers"
                AuthCtl["AuthController.java"]:::backend
                MedCtl["MedicineController.java"]:::backend
                UserCtl["UserController.java"]:::backend
            end

            subgraph "Services"
                AuthSvc["AuthService.java"]:::backend
            end

            subgraph "Repositories"
                UserRepo["UserRepository.java"]:::backend
                MedRepo["MedicineRepository.java"]:::backend
            end

            subgraph "Models & DTOs"
                UserModel["User.java"]:::backend
                MedModel["Medicine.java"]:::backend
                LoginReq["LoginRequest.java"]:::backend
                SignupReq["SignupRequest.java"]:::backend
                UserDTO["UserDTO.java"]:::backend
            end

            subgraph "Security"
                SecConfig["SecurityConfig.java"]:::backend
                JwtFilter["JwtAuthenticationFilter.java"]:::backend
                JwtUtils["JwtUtils.java"]:::backend
                KeyGen["KeyGenration.java"]:::backend
                CustomUser["CustomUserDetails.java"]:::backend
                CurrUserAnnot["CurrentUser.java"]:::backend
                AuthEntry["JwtAuthenticationEntryPoint.java"]:::backend
            end

            Exception["GlobalExceptionHandler.java"]:::backend
            AppProps["application.properties"]:::backend
            DockerServer["Dockerfile"]:::backend
        end

        DB["MySQL/PostgreSQL"]:::database
    end

    Browser -->|"loads SPA"| App
    App -->|"calls"| API
    API -->|"REST API"| AuthCtl
    API -->|"REST API"| MedCtl
    API -->|"REST API"| UserCtl

    AuthCtl -->|"authenticate"| AuthSvc
    MedCtl -->|"business logic"| AuthSvc
    UserCtl -->|"business logic"| AuthSvc

    AuthSvc -->|"uses"| UserRepo
    AuthSvc -->|"uses"| MedRepo
    MedCtl -->|"data access"| MedRepo
    UserCtl -->|"data access"| UserRepo

    UserRepo -->|JDBC| DB
    MedRepo -->|JDBC| DB

    AuthSvc -->|"JWT operations"| JwtUtils
    JwtFilter -.->|"validates token"| AuthCtl
    JwtFilter -->|"verifies"| JwtUtils
    AuthEntry -.->|"handles errors"| JwtFilter

    AuthCtl -->|"handles exceptions"| Exception

    AuthCtl --> AppProps
    MedCtl --> AppProps
    UserCtl --> AppProps

    classDef external fill:#ffa500,stroke:#333,stroke-width:1px
    classDef frontend fill:#a0c4ff,stroke:#0366d6,stroke-width:1px
    classDef backend fill:#caffbf,stroke:#2b9348,stroke-width:1px
    classDef database fill:#bde0fe,stroke:#0077b6,stroke-width:1px

    click App "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/App.js"
    click API "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/API/axiosInstance.js"
    click AuthCtx "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/context/AuthContext.jsx"
    click ThemeCtx "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/context/ThemeContext.jsx"
    click PrivateRoute "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/components/PrivateRoute.js"
    click Navbar "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/components/Navbar.jsx"
    click MedicineCard "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/components/MedicineCard.jsx"
    click EditModal "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/components/EditMedicineModal.jsx"
    click PageTrans "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/components/PageTransition.js"
    click Login "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/pages/Login.jsx"
    click Signup "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/pages/Signup.jsx"
    click Dashboard "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/pages/Dashboard.jsx"
    click AddMed "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/pages/AddMedicine.jsx"
    click Styles "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/index.css"
    click Styles "https://github.com/samseralikhan/medicine-tracker/blob/main/client/src/App.css"
    click Styles "https://github.com/samseralikhan/medicine-tracker/blob/main/client/tailwind.config.js"
    click DockerClient "https://github.com/samseralikhan/medicine-tracker/tree/main/client/dockerfile"

    click Entry "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/MedtrackerApplication.java"
    click AuthCtl "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/controller/AuthController.java"
    click MedCtl "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/controller/MedicineController.java"
    click UserCtl "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/controller/UserController.java"
    click AuthSvc "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/service/AuthService.java"
    click UserRepo "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/repository/UserRepository.java"
    click MedRepo "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/repository/MedicineRepository.java"
    click UserModel "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/models/User.java"
    click MedModel "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/models/Medicine.java"
    click LoginReq "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/dot/LoginRequest.java"
    click SignupReq "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/dot/SignupRequest.java"
    click UserDTO "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/dot/UserDTO.java"
    click Exception "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/exception/GlobalExceptionHandler.java"
    click SecConfig "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/security/config/SecurityConfig.java"
    click JwtFilter "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/security/config/JwtAuthenticationFilter.java"
    click JwtUtils "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/security/jwt/JwtUtils.java"
    click KeyGen "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/security/jwt/KeyGenration.java"
    click CustomUser "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/security/jwt/CustomUserDetails.java"
    click CurrUserAnnot "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/security/jwt/CurrentUser.java"
    click AuthEntry "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/java/com/medicare/medtracker/security/jwt/JwtAuthenticationEntryPoint.java"
    click AppProps "https://github.com/samseralikhan/medicine-tracker/blob/main/server/medtracker/src/main/resources/application.properties"
    click DockerServer "https://github.com/samseralikhan/medicine-tracker/tree/main/server/medtracker/dockerfile"
    click DB "https://github.com/samseralikhan/medicine-tracker/blob/main/docker-compose.yml"
```
