How vedant9912/reworth---retail-wastage-reduction-platform works
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: ReservationService.java Reservation lifecycle · AuthService.java Registration & login · ProductService.java Product discovery & listing · AuditService.java Audit logging
Components 30
Identity & access
- Web interface
nearsave/src/main/resources/static/js/auth.js - Authentication API
nearsave/src/main/java/com/nearsave/auth/AuthController.java - Registration & login
nearsave/src/main/java/com/nearsave/auth/AuthService.java - JWT security
nearsave/src/main/java/com/nearsave/auth/JwtUtil.java - User records
nearsave/src/main/java/com/nearsave/user/User.java - User repository
nearsave/src/main/java/com/nearsave/user/UserRepository.java
Marketplace
- Product API
nearsave/src/main/java/com/nearsave/product/ProductController.java - Product discovery & listing
nearsave/src/main/java/com/nearsave/product/ProductService.java - Product records
nearsave/src/main/java/com/nearsave/product/Product.java - Product repository
nearsave/src/main/java/com/nearsave/product/ProductRepository.java - Favorites
nearsave/src/main/java/com/nearsave/notification/FavoriteRepository.java - Notifications
nearsave/src/main/java/com/nearsave/notification/NotificationRepository.java
Reservations & pickup
- Reservation API
nearsave/src/main/java/com/nearsave/reservation/ReservationController.java - Reservation lifecycle
nearsave/src/main/java/com/nearsave/reservation/ReservationService.java - Reservation records
nearsave/src/main/java/com/nearsave/reservation/Reservation.java - Reservation repository
nearsave/src/main/java/com/nearsave/reservation/ReservationRepository.java - Token expiry scheduler
nearsave/src/main/java/com/nearsave/reservation/TokenExpiryScheduler.java - Pickup events
nearsave/src/main/java/com/nearsave/pickup/PickupEventRepository.java
Shop operations
- Shop API
nearsave/src/main/java/com/nearsave/shop/ShopController.java - Shop management
nearsave/src/main/java/com/nearsave/shop/ShopService.java - Shop records
nearsave/src/main/java/com/nearsave/shop/Shop.java - Shop repository
nearsave/src/main/java/com/nearsave/shop/ShopRepository.java
Administration & insight
- Admin API
nearsave/src/main/java/com/nearsave/admin/AdminController.java - Audit logging
nearsave/src/main/java/com/nearsave/admin/AuditService.java - Audit events
nearsave/src/main/java/com/nearsave/admin/AuditEvent.java - Audit repository
nearsave/src/main/java/com/nearsave/admin/AuditEventRepository.java - Analytics
nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java
Other components
- Customer
- Retailer
- Administrator
Connections 35
- Customer → Web interface: uses
- Retailer → Web interface: uses
- Web interface → Authentication API: requests auth
- Authentication API → Registration & login: delegates to
nearsave/src/main/java/com/nearsave/auth/AuthController.java - Registration & login → User repository: reads and saves
nearsave/src/main/java/com/nearsave/auth/AuthService.java - Registration & login → Shop repository: creates retailer shop
nearsave/src/main/java/com/nearsave/auth/AuthService.java - Registration & login → JWT security: issues token
nearsave/src/main/java/com/nearsave/auth/AuthService.java - Registration & login → Audit logging: logs activity
nearsave/src/main/java/com/nearsave/auth/AuthService.java - Product API → Product discovery & listing: delegates to
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
nearsave/src/main/java/com/nearsave/product/ProductService.java - Product discovery & listing → Shop repository: loads retailer shop
nearsave/src/main/java/com/nearsave/product/ProductService.java - Product discovery & listing → User repository: loads retailer
nearsave/src/main/java/com/nearsave/product/ProductService.java - Product discovery & listing → Audit logging: logs listing
nearsave/src/main/java/com/nearsave/product/ProductService.java - Reservation API → Reservation lifecycle: delegates to
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
nearsave/src/main/java/com/nearsave/reservation/ReservationService.java - Reservation lifecycle → Product repository: locks and updates stock
nearsave/src/main/java/com/nearsave/reservation/ReservationService.java - Reservation lifecycle → User repository: loads participants
nearsave/src/main/java/com/nearsave/reservation/ReservationService.java - Reservation lifecycle → Shop repository: loads shop
nearsave/src/main/java/com/nearsave/reservation/ReservationService.java - Reservation lifecycle → Audit logging: logs lifecycle
nearsave/src/main/java/com/nearsave/reservation/ReservationService.java - Token expiry scheduler → Reservation lifecycle: sweeps expired tokens
- Shop API → Shop management: delegates to
nearsave/src/main/java/com/nearsave/shop/ShopController.java - Shop management → Shop repository: reads and updates
nearsave/src/main/java/com/nearsave/shop/ShopService.java - Shop management → User repository: loads retailer
nearsave/src/main/java/com/nearsave/shop/ShopService.java - Shop management → Audit logging: logs changes
nearsave/src/main/java/com/nearsave/shop/ShopService.java - Administrator → Admin API: administers
nearsave/src/main/java/com/nearsave/admin/AdminController.java - Admin API → Audit repository: reads audit events
nearsave/src/main/java/com/nearsave/admin/AdminController.java - Audit logging → Audit repository: persists events
nearsave/src/main/java/com/nearsave/admin/AuditService.java - Analytics → Reservation repository: queries booking data
nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java - Analytics → Shop repository: queries shop data
nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java - Analytics → User repository: queries user data
nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java - Analytics → Product repository: queries product data
nearsave/src/main/java/com/nearsave/analytics/AnalyticsService.java