How e-waste-recycle-guru/recycleguru works
RECYCLEGURU is a multi-channel e-waste collection and reverse-logistics platform, with public and role-specific web/mobile experiences, a Payload CMS, and a FastAPI domain backend. The principal workflow is a customer or business initiating a pickup, followed by operational dispatch and collection, then compliance/certificate handling and material traceability. The graph preserves documented CMS, analytics/intelligence, finance, security, and offline-sync capabilities. Many portal-to-backend integrations are unsampled, so those links are shown as unverified rather than asserted.
Main entry points: app.py FastAPI API · models Domain models · client.ts Typed API client · decision_engine.py Capacity recommendations
Components 26
User channels
- Customer portal
apps/customer/src - Business portal
apps/business/src - Collector mobile
apps/mobile/app - Partner portals
apps/supplier/src - Recycler portal
apps/recycler/src - Operations admin
apps/admin/src - Public website
apps/web/src/app/(marketing)
API interfaces
- Typed API client
packages/api-client/src/client.ts - FastAPI API
backend/reloopx/api/app.py - API v1 entry
apps/web/src/app/api/v1/route.ts - Offline mutation queue
apps/mobile/src/offline/queue.ts - Offline sync
apps/mobile/src/offline/sync-engine.ts
Collection operations
- Pickup booking
apps/customer/src/features/pickup/actions.ts - Dispatch optimization
backend/reloopx/dispatch/optimization_engine.py - Logistics operations
backend/reloopx/logistics - Material traceability
backend/reloopx/traceability
Governance and intelligence
- Eligibility checks
backend/reloopx/compliance/eligibility_engine.py - Certificate handling
apps/admin/src/app/api/operations/certificates/route.ts - Capacity recommendations
backend/reloopx/ai/decision_engine.py - Capacity forecasts
backend/reloopx/ai/forecasting/capacity_forecast.py - Recommendations
backend/reloopx/ai/recommendation_service.py - Access policy
backend/reloopx/security/policy_engine.py
Content and domain data
- Domain models
backend/reloopx/models - Payload CMS
apps/web/payload.config.ts
Other components
- Platform users
- FastAPI service
Connections 28
- Platform users → Customer portal: books pickups
- Platform users → Business portal: requests collections
- Platform users → Collector mobile: handles jobs
- Customer portal → Pickup booking: submits booking
- Pickup booking → Typed API client: uses client
- Business portal → Typed API client: uses client
- Partner portals → Typed API client: uses client
- Recycler portal → Typed API client: uses client
- Collector mobile → Offline mutation queue: queues mutations
- Offline sync → Offline mutation queue: reads and updates
apps/mobile/src/offline/sync-engine.ts - Offline sync → Typed API client: replays mutations
apps/mobile/src/offline/sync-engine.ts - FastAPI API → FastAPI service: serves API
- API v1 entry → FastAPI service: identifies target
apps/web/src/app/api/v1/route.ts - FastAPI API → Domain models: uses domain data
- Dispatch optimization → Domain models: uses dispatch records
- Logistics operations → Domain models: uses operations records
- Material traceability → Domain models: uses material records
- Eligibility checks → Domain models: reads partner and hold data
backend/reloopx/compliance/eligibility_engine.py - Capacity recommendations → Capacity forecasts: requests forecasts
backend/reloopx/ai/decision_engine.py - Capacity recommendations → Recommendations: creates proposals
backend/reloopx/ai/decision_engine.py - Access policy → Domain models: records decisions
backend/reloopx/security/policy_engine.py - Operations admin → Certificate handling: generates certificates
- Certificate handling → Payload CMS: reads pickups; creates certificates
apps/admin/src/app/api/operations/certificates/route.ts - Public website → Payload CMS: publishes CMS content
- FastAPI API → Dispatch optimization: routes domain requests
- FastAPI API → Eligibility checks: routes domain requests
- FastAPI API → Material traceability: routes domain requests
- FastAPI API → Capacity recommendations: routes intelligence requests