How adithya22115/major-project works
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: api.js HTTP API client · AuthService.java Authentication logic · DonationService.java Donation workflow · App.jsx Role-based application
Components 24
Web experience
- Role-based application
frontend/src/App.jsx - Session context
frontend/src/context/AuthContext.jsx - HTTP API client
frontend/src/services/api.js - Role dashboards
frontend/src/pages - Donation screens
frontend/src/pages/donor/DonateMedicine.jsx
Identity and access
- Authentication endpoints
backend/src/main/java/com/medicycle/controller/AuthController.java - Authentication logic
backend/src/main/java/com/medicycle/service/AuthService.java - JWT handling
backend/src/main/java/com/medicycle/security/JwtService.java
Medicine exchange
- Donation API
backend/src/main/java/com/medicycle/controller/DonationController.java - Donation workflow
backend/src/main/java/com/medicycle/service/DonationService.java - File storage
backend/src/main/java/com/medicycle/service/FileStorageService.java - Donation verification
backend/src/main/java/com/medicycle/service/PharmacyVerificationService.java - Pooled inventory
backend/src/main/java/com/medicycle/service/InventoryService.java - Medicine requests
backend/src/main/java/com/medicycle/service/MedicineRequestService.java - Prescription checks
backend/src/main/java/com/medicycle/service/VerificationService.java
Platform operations
- Notifications
backend/src/main/java/com/medicycle/service/NotificationService.java - Admin management
backend/src/main/java/com/medicycle/service/AdminService.java - Admin smart queries
backend/src/main/java/com/medicycle/service/AdminSmartQueryService.java - Health assistant
backend/src/main/java/com/medicycle/service/HealthAssistantService.java - Activity audit
backend/src/main/java/com/medicycle/service/AuditService.java
Persistence
- User records
backend/src/main/java/com/medicycle/repository/UserRepository.java - Donation records
backend/src/main/java/com/medicycle/entity/MedicineDonation.java - Relational database
Other components
- Platform users
Connections 26
- Platform users → Role-based application: use
- Role-based application → Session context: reads session
frontend/src/App.jsx - Role-based application → Role dashboards: routes to
frontend/src/App.jsx - Session context → HTTP API client: sends auth requests
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
backend/src/main/java/com/medicycle/controller/AuthController.java - Authentication logic → User records: reads users
backend/src/main/java/com/medicycle/service/AuthService.java - Authentication logic → JWT handling: issues tokens
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
backend/src/main/java/com/medicycle/controller/DonationController.java - Donation API → File storage: stores images
backend/src/main/java/com/medicycle/controller/DonationController.java - Donation workflow → Donation records: persists donations
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
backend/src/main/java/com/medicycle/service/AdminSmartQueryService.java - Platform users → Health assistant: ask health questions
- Donation workflow → Activity audit: audit activity
backend/src/main/java/com/medicycle/service/DonationService.java - User records → Relational database: stores users
- Donation records → Relational database: stores donations