How hari-preetham-b/ecosphere works
EcoSphere is a role-based enterprise ESG platform. Users authenticate, configure organizational data, record environmental and social activity, manage governance work, and participate in gamification; backend APIs persist those operations and provide scoring, reports, and notifications. The README documents the major product modules, while sampled route and service code confirms selected backend responsibilities. Many page implementations and route modules were not sampled, so some product capabilities are represented at subsystem level and unverified connections are omitted.
Main entry points: app.py Flask API · carbon_transaction_routes.py Environmental tracking · scoring_routes.py Scoring and reports · governance_routes.py Governance work
Components 23
Web experience
- Web app
frontend/src/App.jsx - Auth context
frontend/src/context/AuthContext.jsx - API client
frontend/src/lib/api.js
Identity and setup
- Master data
backend/routes/department_routes.py - Auth and roles
backend/auth.py
ESG operations
- Environmental tracking
backend/routes/carbon_transaction_routes.py - Emission factors
backend/routes/emission_factor_routes.py - ERP records
backend/routes/erp_routes.py - Sustainability goals
backend/routes/sustainability_goal_routes.py - CSR participation
backend/routes/csr_routes.py - Diversity metrics
backend/routes/diversity_routes.py - Training tracking
backend/routes/training_routes.py - Governance work
backend/routes/governance_routes.py
Scoring and engagement
- Gamification
backend/routes/gamification_routes.py - Scoring and reports
backend/routes/scoring_routes.py - Notifications
backend/services/notification_service.py - ESG settings
backend/routes/settings_routes.py
Backend platform
- Flask API
backend/app.py - SQL database
backend/database.py - Domain models
backend/models.py
Other components
- User
- Supabase Auth
- Brevo SMTP
Connections 38
- User → Web app: uses
frontend/src/App.jsx - Web app → Auth context: provides auth
frontend/src/App.jsx - Auth context → Supabase Auth: authenticates
frontend/src/context/AuthContext.jsx - Auth context → API client: fetches profile
frontend/src/context/AuthContext.jsx - Web app → Environmental tracking: routes to
frontend/src/App.jsx - User → Environmental tracking: records activity
README.md - Environmental tracking → Emission factors: converts activity
README.md - ERP records → Environmental tracking: auto-calculates
README.md - User → CSR participation: participates
README.md - User → Governance work: acknowledges policies
README.md - CSR participation → Gamification: awards points
backend/routes/csr_routes.py - Gamification → Notifications: sends updates
backend/routes/gamification_routes.py - Governance work → Notifications: sends updates
backend/routes/governance_routes.py - User → Scoring and reports: views results
README.md - Environmental tracking → Scoring and reports: contributes data
README.md - CSR participation → Scoring and reports: contributes data
README.md - Governance work → Scoring and reports: contributes data
README.md - Scoring and reports → User: reports results
README.md - User → API client: requests data
- API client → Flask API: calls API
- Flask API → Master data: registers routes
backend/app.py - Flask API → Environmental tracking: registers routes
backend/app.py - Flask API → CSR participation: registers routes
backend/app.py - Flask API → Governance work: registers routes
backend/app.py - Flask API → Gamification: registers routes
backend/app.py - Flask API → Scoring and reports: registers routes
backend/app.py - Auth and roles → Supabase Auth: verifies token
backend/auth.py - Auth and roles → Domain models: syncs profile
backend/auth.py - Environmental tracking → SQL database: persists records
backend/routes/carbon_transaction_routes.py - Governance work → SQL database: persists records
backend/routes/governance_routes.py - Gamification → SQL database: persists records
backend/routes/gamification_routes.py - Scoring and reports → SQL database: queries data
backend/routes/scoring_routes.py - Notifications → SQL database: stores notices
backend/services/notification_service.py - Notifications → Brevo SMTP: sends email
backend/services/notification_service.py - User → Diversity metrics: views metrics
README.md - User → Training tracking: tracks completion
README.md - User → Sustainability goals: tracks progress
README.md - User → ESG settings: configures ESG
README.md