# adithya22115/major-project architecture

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

- Interactive diagram: https://gitdiagram.com/adithya22115/major-project
- Repository: https://github.com/adithya22115/major-project

## Overview

MediCycle is a medicine donation and redistribution platform. Donors submit unused medicines; pharmacies or NGOs verify donations and manage pooled inventory; recipients search and request medicines, with prescription checks where required. Admins oversee users, medicines, verifications, and reports. The frontend routes role-specific interactions through REST services to Spring controllers and business services, which persist application records. The graph preserves documented verification, inventory, requests, notifications, and health assistance; several domain links use README documentation because their implementation excerpts were not supplied.

Main entry points: [`frontend/src/services/api.js`](https://github.com/adithya22115/major-project/blob/main/frontend/src/services/api.js) (HTTP API client), [`backend/src/main/java/com/medicycle/service/AuthService.java`](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/AuthService.java) (Authentication logic), [`backend/src/main/java/com/medicycle/service/DonationService.java`](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/DonationService.java) (Donation workflow), [`frontend/src/App.jsx`](https://github.com/adithya22115/major-project/blob/main/frontend/src/App.jsx) (Role-based application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Role-based application<br/>[App.jsx]"]
  node_authui["Session context<br/>[AuthContext.jsx]"]
  node_webapi["HTTP API client<br/>[api.js]"]
  node_rolepages["Role dashboards"]
  node_donationui["Donation screens<br/>[DonateMedicine.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_authcontroller["Authentication endpoints"]
  node_authservice["Authentication logic<br/>[AuthService.java]"]
  node_jwt["JWT handling<br/>[JwtService.java]"]
end

subgraph group_medicine["Medicine exchange"]
  node_donationapi["Donation API"]
  node_donationservice["Donation workflow"]
  node_files["File storage"]
  node_verification["Donation verification"]
  node_inventory["Pooled inventory"]
  node_requests["Medicine requests"]
  node_prescriptions["Prescription checks"]
end

subgraph group_operations["Platform operations"]
  node_notices["Notifications"]
  node_admin["Admin management<br/>[AdminService.java]"]
  node_smartquery["Admin smart queries"]
  node_health["Health assistant"]
  node_audit["Activity audit<br/>[AuditService.java]"]
end

subgraph group_persistence["Persistence"]
  node_userrepo[("User records")]
  node_donationrecord[("Donation records")]
  node_database[("Relational database")]
end

node_people(("Platform users"))

node_people -->|"use"| node_app
node_app -->|"reads session"| node_authui
node_app -->|"routes to"| node_rolepages
node_authui -->|"sends auth requests"| node_webapi
node_rolepages -.->|"call API"| node_webapi
node_webapi -->|"REST requests"| node_authcontroller
node_webapi -->|"REST requests"| node_donationapi
node_authcontroller -->|"delegates"| node_authservice
node_authservice -->|"reads users"| node_userrepo
node_authservice -->|"issues tokens"| node_jwt
node_authservice -->|"authenticate"| node_people
node_donationui -.->|"submit donation"| node_webapi
node_donationapi -->|"delegates"| node_donationservice
node_donationapi -->|"stores images"| node_files
node_donationservice -.->|"persists donations"| node_donationrecord
node_donationservice -->|"verification workflow"| node_verification
node_verification -->|"releases verified stock"| node_inventory
node_inventory -->|"supplies requests"| node_requests
node_requests -->|"checks restricted medicines"| node_prescriptions
node_requests -->|"notifies participants"| node_notices
node_people -->|"administer platform"| node_admin
node_smartquery -->|"filters overview"| node_admin
node_people -->|"ask health questions"| node_health
node_donationservice -.->|"audit activity"| node_audit
node_userrepo -->|"stores users"| node_database
node_donationrecord -->|"stores donations"| node_database

click node_app "https://github.com/adithya22115/major-project/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/adithya22115/major-project/blob/main/frontend/src/context/AuthContext.jsx"
click node_webapi "https://github.com/adithya22115/major-project/blob/main/frontend/src/services/api.js"
click node_rolepages "https://github.com/adithya22115/major-project/tree/main/frontend/src/pages"
click node_authcontroller "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/controller/AuthController.java"
click node_authservice "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/AuthService.java"
click node_jwt "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/security/JwtService.java"
click node_userrepo "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/repository/UserRepository.java"
click node_donationui "https://github.com/adithya22115/major-project/blob/main/frontend/src/pages/donor/DonateMedicine.jsx"
click node_donationapi "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/controller/DonationController.java"
click node_donationservice "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/DonationService.java"
click node_files "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/FileStorageService.java"
click node_donationrecord "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/entity/MedicineDonation.java"
click node_verification "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/PharmacyVerificationService.java"
click node_inventory "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/InventoryService.java"
click node_requests "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/MedicineRequestService.java"
click node_prescriptions "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/VerificationService.java"
click node_notices "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/NotificationService.java"
click node_admin "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/AdminService.java"
click node_smartquery "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/AdminSmartQueryService.java"
click node_health "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/HealthAssistantService.java"
click node_audit "https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/AuditService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_authui,node_webapi,node_rolepages,node_donationui,node_people toneBlue
class node_authcontroller,node_authservice,node_jwt toneAmber
class node_donationapi,node_donationservice,node_files,node_verification,node_inventory,node_requests,node_prescriptions toneMint
class node_notices,node_admin,node_smartquery,node_health,node_audit toneRose
class node_userrepo,node_donationrecord,node_database toneIndigo
```

## Components

### Web experience

- [Role-based application](https://github.com/adithya22115/major-project/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session context](https://github.com/adithya22115/major-project/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [HTTP API client](https://github.com/adithya22115/major-project/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Role dashboards](https://github.com/adithya22115/major-project/tree/main/frontend/src/pages): `frontend/src/pages`
- [Donation screens](https://github.com/adithya22115/major-project/blob/main/frontend/src/pages/donor/DonateMedicine.jsx): `frontend/src/pages/donor/DonateMedicine.jsx`

### Identity and access

- [Authentication endpoints](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/controller/AuthController.java): `backend/src/main/java/com/medicycle/controller/AuthController.java`
- [Authentication logic](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/AuthService.java): `backend/src/main/java/com/medicycle/service/AuthService.java`
- [JWT handling](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/security/JwtService.java): `backend/src/main/java/com/medicycle/security/JwtService.java`

### Medicine exchange

- [Donation API](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/controller/DonationController.java): `backend/src/main/java/com/medicycle/controller/DonationController.java`
- [Donation workflow](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/DonationService.java): `backend/src/main/java/com/medicycle/service/DonationService.java`
- [File storage](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/FileStorageService.java): `backend/src/main/java/com/medicycle/service/FileStorageService.java`
- [Donation verification](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/PharmacyVerificationService.java): `backend/src/main/java/com/medicycle/service/PharmacyVerificationService.java`
- [Pooled inventory](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/InventoryService.java): `backend/src/main/java/com/medicycle/service/InventoryService.java`
- [Medicine requests](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/MedicineRequestService.java): `backend/src/main/java/com/medicycle/service/MedicineRequestService.java`
- [Prescription checks](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/VerificationService.java): `backend/src/main/java/com/medicycle/service/VerificationService.java`

### Platform operations

- [Notifications](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/NotificationService.java): `backend/src/main/java/com/medicycle/service/NotificationService.java`
- [Admin management](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/AdminService.java): `backend/src/main/java/com/medicycle/service/AdminService.java`
- [Admin smart queries](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/AdminSmartQueryService.java): `backend/src/main/java/com/medicycle/service/AdminSmartQueryService.java`
- [Health assistant](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/HealthAssistantService.java): `backend/src/main/java/com/medicycle/service/HealthAssistantService.java`
- [Activity audit](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/service/AuditService.java): `backend/src/main/java/com/medicycle/service/AuditService.java`

### Persistence

- [User records](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/repository/UserRepository.java): `backend/src/main/java/com/medicycle/repository/UserRepository.java`
- [Donation records](https://github.com/adithya22115/major-project/blob/main/backend/src/main/java/com/medicycle/entity/MedicineDonation.java): `backend/src/main/java/com/medicycle/entity/MedicineDonation.java`
- **Relational database**

### Other components

- **Platform users**

## Connections

- Platform users → Role-based application: use
- Role-based application → Session context: reads session (evidence: `frontend/src/App.jsx`)
- Role-based application → Role dashboards: routes to (evidence: `frontend/src/App.jsx`)
- Session context → HTTP API client: sends auth requests (evidence: `frontend/src/context/AuthContext.jsx`)
- Role dashboards → HTTP API client: call API
- HTTP API client → Authentication endpoints: REST requests
- HTTP API client → Donation API: REST requests
- Authentication endpoints → Authentication logic: delegates (evidence: `backend/src/main/java/com/medicycle/controller/AuthController.java`)
- Authentication logic → User records: reads users (evidence: `backend/src/main/java/com/medicycle/service/AuthService.java`)
- Authentication logic → JWT handling: issues tokens (evidence: `backend/src/main/java/com/medicycle/service/AuthService.java`)
- Authentication logic → Platform users: authenticate
- Donation screens → HTTP API client: submit donation
- Donation API → Donation workflow: delegates (evidence: `backend/src/main/java/com/medicycle/controller/DonationController.java`)
- Donation API → File storage: stores images (evidence: `backend/src/main/java/com/medicycle/controller/DonationController.java`)
- Donation workflow → Donation records: persists donations (evidence: `backend/src/main/java/com/medicycle/service/DonationService.java`)
- Donation workflow → Donation verification: verification workflow
- Donation verification → Pooled inventory: releases verified stock
- Pooled inventory → Medicine requests: supplies requests
- Medicine requests → Prescription checks: checks restricted medicines
- Medicine requests → Notifications: notifies participants
- Platform users → Admin management: administer platform
- Admin smart queries → Admin management: filters overview (evidence: `backend/src/main/java/com/medicycle/service/AdminSmartQueryService.java`)
- Platform users → Health assistant: ask health questions
- Donation workflow → Activity audit: audit activity (evidence: `backend/src/main/java/com/medicycle/service/DonationService.java`)
- User records → Relational database: stores users
- Donation records → Relational database: stores donations
