How riteshkumar-devs/greeen-track works
GreenTrack is a campus waste-management app whose main workflow runs from bin registration and citizen check-in/reporting through admin dispatch to collector inspection and pickup. The React frontend defaults to browser-based mock data; the FastAPI backend currently exposes only health, and PostgreSQL is prepared for future tables rather than used by the demo workflows. Some frontend feature-to-service connections are supported by the SOURCE INDEX; unsampled implementation details are left out.
Main entry points: apiClient.ts API Client · AppShell.tsx Workspace Shell · AdminPortal.tsx Admin Portal · CollectorPortal.tsx Collector Portal
Components 24
Role Workspaces
- Workspace Shell
frontend/src/app/AppShell.tsx - Role Authentication
frontend/src/app/AuthContext.tsx - Role Login
frontend/src/features/auth/RoleLoginPanel.tsx
Campus Operations
- Citizen Portal
frontend/src/features/citizen/CitizenPortal.tsx - Condition Reports
frontend/src/features/citizen/BinFeedback.tsx - Admin Portal
frontend/src/features/admin/AdminPortal.tsx - Zones & Bins
frontend/src/features/admin/ZonesAndBinsView.tsx - Collectors & Tasks
frontend/src/features/admin/CollectorsAndTasksView.tsx - Collector Portal
frontend/src/features/collector/CollectorPortal.tsx
Routing & Insights
- Route Operations
frontend/src/features/routes/RoutesView.tsx - Activity Analytics
frontend/src/features/analytics/AnalyticsView.tsx - Routing Service
frontend/src/services/routingService.ts - OSRM Routing
- Google Maps
Frontend Core
- API Client
frontend/src/services/apiClient.ts - Browser Mock API
frontend/src/mocks/mockApi.ts - API Data Types
frontend/src/types/api.ts - Shared UI Components
frontend/src/components
Backend Health
- Health Endpoint
backend/app/api/v1/health.py - Health Schema
backend/app/schemas/health.py - FastAPI App
backend/app/main.py
Other components
- Citizen
- Collector
- Administrator
Connections 32
- Citizen → Workspace Shell: opens workspace
README.md - Collector → Workspace Shell: opens workspace
README.md - Administrator → Workspace Shell: opens workspace
README.md - Workspace Shell → Role Login: renders
frontend/src/app/AppShell.tsx - Workspace Shell → Citizen Portal: renders
frontend/src/app/AppShell.tsx - Workspace Shell → Collector Portal: renders
frontend/src/app/AppShell.tsx - Workspace Shell → Admin Portal: renders
frontend/src/app/AppShell.tsx - Role Login → Role Authentication: authenticates via
frontend/src/features/auth/RoleLoginPanel.tsx - Citizen Portal → Condition Reports: renders
frontend/src/features/citizen/CitizenPortal.tsx - Admin Portal → Zones & Bins: renders
frontend/src/features/admin/AdminPortal.tsx - Admin Portal → Collectors & Tasks: renders
frontend/src/features/admin/AdminPortal.tsx - Admin Portal → Activity Analytics: renders
frontend/src/features/admin/AdminPortal.tsx - Admin Portal → Route Operations: renders
frontend/src/features/admin/AdminPortal.tsx - Collector Portal → Route Operations: opens
- Route Operations → Routing Service: requests routing
frontend/src/features/routes/RoutesView.tsx - Routing Service → OSRM Routing: gets road distances
README.md - Collector Portal → Google Maps: opens directions
README.md - Citizen Portal → API Client: sends requests
frontend/src/features/citizen/CitizenPortal.tsx - Condition Reports → API Client: sends requests
- Collector Portal → API Client: sends requests
frontend/src/features/collector/CollectorPortal.tsx - Collectors & Tasks → API Client: sends requests
- Activity Analytics → API Client: sends requests
frontend/src/features/analytics/AnalyticsView.tsx - Route Operations → API Client: sends requests
- Role Authentication → API Client: sends requests
frontend/src/app/AuthContext.tsx - API Client → Browser Mock API: dispatches locally
frontend/src/services/apiClient.ts - API Client → FastAPI App: sends HTTP requests
README.md - FastAPI App → Health Endpoint: registers route
backend/app/main.py - Health Endpoint → Health Schema: returns schema
backend/app/api/v1/health.py - Citizen Portal → Shared UI Components: uses UI
frontend/src/features/citizen/CitizenPortal.tsx - Collector Portal → Shared UI Components: uses UI
frontend/src/features/collector/CollectorPortal.tsx - Zones & Bins → Shared UI Components: uses UI
frontend/src/features/admin/ZonesAndBinsView.tsx - API Client → API Data Types: uses contracts
frontend/src/services/apiClient.ts