How sri-dhran/green-circuit works
Green Circuit is an e-waste pickup platform: users authenticate, choose a collection office, submit and track pickup requests, and can redeem reward points. Office and agent dashboards manage requests and collection; administrators have global analytics. The map preserves the README’s major product capabilities, with backend services and frontend role dashboards as the main layers. Several backend controllers and analytics/notification implementations were not sampled, so those subsystem links rely on the README’s module descriptions rather than inspected call sites.
Main entry points: axiosConfig.js Authenticated API client · App.jsx Role dashboards · AuthService.java Authentication · PickupRequestService.java Pickup workflow
Components 20
Identity & Access
- Role dashboards
frontend/src/App.jsx - Authentication
backend/src/main/java/com/greencircuit/backend/modules/user/service/AuthService.java - User profiles
backend/src/main/java/com/greencircuit/backend/modules/user/service/UserService.java - User records
backend/src/main/java/com/greencircuit/backend/modules/user/entity/User.java - Authenticated API client
frontend/src/common/api/axiosConfig.js
Pickup Operations
- Collection offices
backend/src/main/java/com/greencircuit/backend/modules/center/service/OfficeService.java - Office dashboard
frontend/src/modules/center/pages/OfficeDashboard.jsx - User pickup dashboard
frontend/src/modules/pickup/pages/UserDashboard.jsx - Pickup request form
frontend/src/modules/pickup/components/PickupRequestForm.jsx - Pickup workflow
backend/src/main/java/com/greencircuit/backend/modules/pickup/service/PickupRequestService.java - Pickup requests
backend/src/main/java/com/greencircuit/backend/modules/pickup/entity/PickupRequest.java - Agent management
backend/src/main/java/com/greencircuit/backend/modules/agent/service/CollectionAgentService.java - Agent dashboard
frontend/src/modules/agent/pages/AgentDashboard.jsx
Rewards & Messaging
- Reward store
frontend/src/modules/reward/pages/RewardStore.jsx - Reward redemption
backend/src/main/java/com/greencircuit/backend/modules/reward/service/RewardService.java - Reward records
backend/src/main/java/com/greencircuit/backend/modules/reward/entity/RewardRedemption.java - Notifications & email
backend/src/main/java/com/greencircuit/backend/modules/notification
Administration & Analytics
- Admin dashboard
frontend/src/modules/analytics/pages/SuperAdminDashboard.jsx - Global analytics
backend/src/main/java/com/greencircuit/backend/modules/analytics
Other components
- Platform user
Connections 26
- Platform user → Role dashboards: uses
frontend/src/App.jsx - Role dashboards → Authentication: routes to
frontend/src/App.jsx - Role dashboards → Office dashboard: routes to
frontend/src/App.jsx - Role dashboards → User pickup dashboard: routes to
frontend/src/App.jsx - Role dashboards → Agent dashboard: routes to
frontend/src/App.jsx - Role dashboards → Reward store: routes to
frontend/src/App.jsx - Role dashboards → Admin dashboard: routes to
frontend/src/App.jsx - Authentication → User records: reads and writes
backend/src/main/java/com/greencircuit/backend/modules/user/service/AuthService.java - Authentication → Collection offices: looks up office
backend/src/main/java/com/greencircuit/backend/modules/user/service/AuthService.java - User pickup dashboard → Pickup request form: includes
README.md - Pickup request form → Authenticated API client: submits requests
README.md - Office dashboard → Authenticated API client: manages offices
README.md - Agent dashboard → Authenticated API client: manages collections
README.md - Reward store → Authenticated API client: requests rewards
README.md - Admin dashboard → Authenticated API client: requests analytics
README.md - Authenticated API client → Pickup workflow: calls backend
README.md - Authenticated API client → Collection offices: calls backend
README.md - Authenticated API client → Agent management: calls backend
README.md - Authenticated API client → Reward redemption: calls backend
README.md - Authenticated API client → Global analytics: calls backend
README.md - Pickup workflow → Pickup requests: saves requests
backend/src/main/java/com/greencircuit/backend/modules/pickup/service/PickupRequestService.java - Pickup workflow → Notifications & email: creates notifications
backend/src/main/java/com/greencircuit/backend/modules/pickup/service/PickupRequestService.java - Agent management → Notifications & email: creates notifications
backend/src/main/java/com/greencircuit/backend/modules/agent/service/CollectionAgentService.java - Reward redemption → User records: updates points
backend/src/main/java/com/greencircuit/backend/modules/reward/service/RewardService.java - Reward redemption → Reward records: saves redemption
backend/src/main/java/com/greencircuit/backend/modules/reward/service/RewardService.java - Global analytics → Pickup requests: reports on
README.md