# vedant9912/reworth---retail-wastage-reduction-platform architecture

> Architecture diagram of the GitHub repository vedant9912/reworth---retail-wastage-reduction-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vedant9912/reworth---retail-wastage-reduction-platform
- Repository: https://github.com/vedant9912/reworth---retail-wastage-reduction-platform

## Overview

NearSave is a hyperlocal marketplace for discounted near-expiry goods. Customers discover nearby stock and reserve it with a time-limited pickup token; retailers list products and manage pickup, while administrators oversee shops and review activity. The graph preserves the documented discovery, booking, expiry, and authentication flow, plus the shop, analytics, and audit subsystems present in the source tree. Some ancillary modules are represented without inferred connections because their wiring was not shown.

Main entry points: [`nearsave/src/main/java/com/nearsave/reservation/ReservationService.java`](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/reservation/ReservationService.java) (Reservation lifecycle), [`nearsave/src/main/java/com/nearsave/auth/AuthService.java`](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/auth/AuthService.java) (Registration & login), [`nearsave/src/main/java/com/nearsave/product/ProductService.java`](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/product/ProductService.java) (Product discovery & listing), [`nearsave/src/main/java/com/nearsave/admin/AuditService.java`](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/admin/AuditService.java) (Audit logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; access"]
  node_web["Web interface<br/>[auth.js]"]
  node_auth_api["Authentication API"]
  node_auth_service["Registration &amp; login<br/>[AuthService.java]"]
  node_jwt["JWT security<br/>[JwtUtil.java]"]
  node_users[("User records<br/>[User.java]")]
  node_user_repo["User repository"]
end

subgraph group_market["Marketplace"]
  node_product_api["Product API"]
  node_product_service["Product discovery &amp; listing"]
  node_product_data[("Product records<br/>[Product.java]")]
  node_product_repo["Product repository"]
  node_favorites["Favorites"]
  node_notifications["Notifications"]
end

subgraph group_booking["Reservations &amp; pickup"]
  node_reservation_api["Reservation API"]
  node_reservation_service["Reservation lifecycle"]
  node_reservation_data[("Reservation records<br/>[Reservation.java]")]
  node_reservation_repo["Reservation repository"]
  node_expiry["Token expiry scheduler"]
  node_pickup_events["Pickup events"]
end

subgraph group_operations["Shop operations"]
  node_shop_api["Shop API"]
  node_shop_service["Shop management<br/>[ShopService.java]"]
  node_shop_data[("Shop records<br/>[Shop.java]")]
  node_shop_repo["Shop repository"]
end

subgraph group_insight["Administration &amp; insight"]
  node_admin_api["Admin API"]
  node_audit_service["Audit logging<br/>[AuditService.java]"]
  node_audit_data[("Audit events<br/>[AuditEvent.java]")]
  node_audit_repo["Audit repository"]
  node_analytics["Analytics"]
end

node_customer(("Customer"))
node_retailer(("Retailer"))
node_admin(("Administrator"))

node_customer -->|"uses"| node_web
node_retailer -->|"uses"| node_web
node_web -->|"requests auth"| node_auth_api
node_auth_api -->|"delegates to"| node_auth_service
node_auth_service -->|"reads and saves"| node_user_repo
node_auth_service -->|"creates retailer shop"| node_shop_repo
node_auth_service -->|"issues token"| node_jwt
node_auth_service -->|"logs activity"| node_audit_service
node_product_api -->|"delegates to"| node_product_service
node_customer -->|"discovers nearby goods"| node_product_api
node_retailer -->|"lists goods"| node_product_api
node_product_service -->|"queries and saves"| node_product_repo
node_product_service -->|"loads retailer shop"| node_shop_repo
node_product_service -->|"loads retailer"| node_user_repo
node_product_service -->|"logs listing"| node_audit_service
node_reservation_api -->|"delegates to"| node_reservation_service
node_customer -->|"reserves goods"| node_reservation_api
node_retailer -->|"verifies pickup"| node_reservation_api
node_reservation_service -->|"reads and saves"| node_reservation_repo
node_reservation_service -->|"locks and updates stock"| node_product_repo
node_reservation_service -->|"loads participants"| node_user_repo
node_reservation_service -->|"loads shop"| node_shop_repo
node_reservation_service -->|"logs lifecycle"| node_audit_service
node_expiry -->|"sweeps expired tokens"| node_reservation_service
node_shop_api -->|"delegates to"| node_shop_service
node_shop_service -->|"reads and updates"| node_shop_repo
node_shop_service -->|"loads retailer"| node_user_repo
node_shop_service -->|"logs changes"| node_audit_service
node_admin -->|"administers"| node_admin_api
node_admin_api -->|"reads audit events"| node_audit_repo
node_audit_service -->|"persists events"| node_audit_repo
node_analytics -->|"queries booking data"| node_reservation_repo
node_analytics -->|"queries shop data"| node_shop_repo
node_analytics -->|"queries user data"| node_user_repo
node_analytics -->|"queries product data"| node_product_repo

click node_web "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/resources/static/js/auth.js"
click node_auth_api "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/auth/AuthController.java"
click node_auth_service "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/auth/AuthService.java"
click node_jwt "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/auth/JwtUtil.java"
click node_users "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/user/User.java"
click node_user_repo "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/user/UserRepository.java"
click node_product_api "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/product/ProductController.java"
click node_product_service "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/product/ProductService.java"
click node_product_data "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/product/Product.java"
click node_product_repo "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/product/ProductRepository.java"
click node_reservation_api "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/reservation/ReservationController.java"
click node_reservation_service "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/reservation/ReservationService.java"
click node_reservation_data "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/reservation/Reservation.java"
click node_reservation_repo "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/reservation/ReservationRepository.java"
click node_expiry "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/reservation/TokenExpiryScheduler.java"
click node_shop_api "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/shop/ShopController.java"
click node_shop_service "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/shop/ShopService.java"
click node_shop_data "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/shop/Shop.java"
click node_shop_repo "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/shop/ShopRepository.java"
click node_admin_api "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/admin/AdminController.java"
click node_audit_service "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/admin/AuditService.java"
click node_audit_data "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/admin/AuditEvent.java"
click node_audit_repo "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/admin/AuditEventRepository.java"
click node_analytics "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java"
click node_favorites "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/notification/FavoriteRepository.java"
click node_notifications "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/notification/NotificationRepository.java"
click node_pickup_events "https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/pickup/PickupEventRepository.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_web,node_auth_api,node_auth_service,node_jwt,node_users,node_user_repo toneBlue
class node_product_api,node_product_service,node_product_data,node_product_repo,node_favorites,node_notifications toneAmber
class node_reservation_api,node_reservation_service,node_reservation_data,node_reservation_repo,node_expiry,node_pickup_events toneMint
class node_shop_api,node_shop_service,node_shop_data,node_shop_repo toneRose
class node_admin_api,node_audit_service,node_audit_data,node_audit_repo,node_analytics,node_customer,node_retailer,node_admin toneIndigo
```

## Components

### Identity & access

- [Web interface](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/resources/static/js/auth.js): `nearsave/src/main/resources/static/js/auth.js`
- [Authentication API](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/auth/AuthController.java): `nearsave/src/main/java/com/nearsave/auth/AuthController.java`
- [Registration & login](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/auth/AuthService.java): `nearsave/src/main/java/com/nearsave/auth/AuthService.java`
- [JWT security](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/auth/JwtUtil.java): `nearsave/src/main/java/com/nearsave/auth/JwtUtil.java`
- [User records](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/user/User.java): `nearsave/src/main/java/com/nearsave/user/User.java`
- [User repository](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/user/UserRepository.java): `nearsave/src/main/java/com/nearsave/user/UserRepository.java`

### Marketplace

- [Product API](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/product/ProductController.java): `nearsave/src/main/java/com/nearsave/product/ProductController.java`
- [Product discovery & listing](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/product/ProductService.java): `nearsave/src/main/java/com/nearsave/product/ProductService.java`
- [Product records](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/product/Product.java): `nearsave/src/main/java/com/nearsave/product/Product.java`
- [Product repository](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/product/ProductRepository.java): `nearsave/src/main/java/com/nearsave/product/ProductRepository.java`
- [Favorites](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/notification/FavoriteRepository.java): `nearsave/src/main/java/com/nearsave/notification/FavoriteRepository.java`
- [Notifications](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/notification/NotificationRepository.java): `nearsave/src/main/java/com/nearsave/notification/NotificationRepository.java`

### Reservations & pickup

- [Reservation API](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/reservation/ReservationController.java): `nearsave/src/main/java/com/nearsave/reservation/ReservationController.java`
- [Reservation lifecycle](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/reservation/ReservationService.java): `nearsave/src/main/java/com/nearsave/reservation/ReservationService.java`
- [Reservation records](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/reservation/Reservation.java): `nearsave/src/main/java/com/nearsave/reservation/Reservation.java`
- [Reservation repository](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/reservation/ReservationRepository.java): `nearsave/src/main/java/com/nearsave/reservation/ReservationRepository.java`
- [Token expiry scheduler](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/reservation/TokenExpiryScheduler.java): `nearsave/src/main/java/com/nearsave/reservation/TokenExpiryScheduler.java`
- [Pickup events](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/pickup/PickupEventRepository.java): `nearsave/src/main/java/com/nearsave/pickup/PickupEventRepository.java`

### Shop operations

- [Shop API](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/shop/ShopController.java): `nearsave/src/main/java/com/nearsave/shop/ShopController.java`
- [Shop management](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/shop/ShopService.java): `nearsave/src/main/java/com/nearsave/shop/ShopService.java`
- [Shop records](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/shop/Shop.java): `nearsave/src/main/java/com/nearsave/shop/Shop.java`
- [Shop repository](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/shop/ShopRepository.java): `nearsave/src/main/java/com/nearsave/shop/ShopRepository.java`

### Administration & insight

- [Admin API](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/admin/AdminController.java): `nearsave/src/main/java/com/nearsave/admin/AdminController.java`
- [Audit logging](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/admin/AuditService.java): `nearsave/src/main/java/com/nearsave/admin/AuditService.java`
- [Audit events](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/admin/AuditEvent.java): `nearsave/src/main/java/com/nearsave/admin/AuditEvent.java`
- [Audit repository](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/admin/AuditEventRepository.java): `nearsave/src/main/java/com/nearsave/admin/AuditEventRepository.java`
- [Analytics](https://github.com/vedant9912/reworth---retail-wastage-reduction-platform/blob/main/nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java): `nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java`

### Other components

- **Customer**
- **Retailer**
- **Administrator**

## Connections

- Customer → Web interface: uses
- Retailer → Web interface: uses
- Web interface → Authentication API: requests auth
- Authentication API → Registration & login: delegates to (evidence: `nearsave/src/main/java/com/nearsave/auth/AuthController.java`)
- Registration & login → User repository: reads and saves (evidence: `nearsave/src/main/java/com/nearsave/auth/AuthService.java`)
- Registration & login → Shop repository: creates retailer shop (evidence: `nearsave/src/main/java/com/nearsave/auth/AuthService.java`)
- Registration & login → JWT security: issues token (evidence: `nearsave/src/main/java/com/nearsave/auth/AuthService.java`)
- Registration & login → Audit logging: logs activity (evidence: `nearsave/src/main/java/com/nearsave/auth/AuthService.java`)
- Product API → Product discovery & listing: delegates to (evidence: `nearsave/src/main/java/com/nearsave/product/ProductController.java`)
- Customer → Product API: discovers nearby goods
- Retailer → Product API: lists goods
- Product discovery & listing → Product repository: queries and saves (evidence: `nearsave/src/main/java/com/nearsave/product/ProductService.java`)
- Product discovery & listing → Shop repository: loads retailer shop (evidence: `nearsave/src/main/java/com/nearsave/product/ProductService.java`)
- Product discovery & listing → User repository: loads retailer (evidence: `nearsave/src/main/java/com/nearsave/product/ProductService.java`)
- Product discovery & listing → Audit logging: logs listing (evidence: `nearsave/src/main/java/com/nearsave/product/ProductService.java`)
- Reservation API → Reservation lifecycle: delegates to (evidence: `nearsave/src/main/java/com/nearsave/reservation/ReservationController.java`)
- Customer → Reservation API: reserves goods
- Retailer → Reservation API: verifies pickup
- Reservation lifecycle → Reservation repository: reads and saves (evidence: `nearsave/src/main/java/com/nearsave/reservation/ReservationService.java`)
- Reservation lifecycle → Product repository: locks and updates stock (evidence: `nearsave/src/main/java/com/nearsave/reservation/ReservationService.java`)
- Reservation lifecycle → User repository: loads participants (evidence: `nearsave/src/main/java/com/nearsave/reservation/ReservationService.java`)
- Reservation lifecycle → Shop repository: loads shop (evidence: `nearsave/src/main/java/com/nearsave/reservation/ReservationService.java`)
- Reservation lifecycle → Audit logging: logs lifecycle (evidence: `nearsave/src/main/java/com/nearsave/reservation/ReservationService.java`)
- Token expiry scheduler → Reservation lifecycle: sweeps expired tokens
- Shop API → Shop management: delegates to (evidence: `nearsave/src/main/java/com/nearsave/shop/ShopController.java`)
- Shop management → Shop repository: reads and updates (evidence: `nearsave/src/main/java/com/nearsave/shop/ShopService.java`)
- Shop management → User repository: loads retailer (evidence: `nearsave/src/main/java/com/nearsave/shop/ShopService.java`)
- Shop management → Audit logging: logs changes (evidence: `nearsave/src/main/java/com/nearsave/shop/ShopService.java`)
- Administrator → Admin API: administers (evidence: `nearsave/src/main/java/com/nearsave/admin/AdminController.java`)
- Admin API → Audit repository: reads audit events (evidence: `nearsave/src/main/java/com/nearsave/admin/AdminController.java`)
- Audit logging → Audit repository: persists events (evidence: `nearsave/src/main/java/com/nearsave/admin/AuditService.java`)
- Analytics → Reservation repository: queries booking data (evidence: `nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java`)
- Analytics → Shop repository: queries shop data (evidence: `nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java`)
- Analytics → User repository: queries user data (evidence: `nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java`)
- Analytics → Product repository: queries product data (evidence: `nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java`)
