GigLens is a web-based platform that analyzes gig‑economy data (earnings, ratings, penalties) to identify potential fairness issues.
The system provides an automated audit, a fairness score, and a complete appeal submission and review workflow.
GigLens allows gig workers to upload their earnings, ratings, and penalties CSV files.
The backend processes these files, runs fairness checks, and returns a summary of issues along with a fairness score.
Users can also submit appeals when they identify mistakes or unfair penalties.
Admins can review, update, and resolve appeals.
- Upload Earnings, Ratings, and Penalties CSV files.
- Automatic validation and parsing.
- Detects unusual penalties.
- Identifies rating inconsistencies.
- Highlights low or missing earnings.
- Computes a fairness score based on rule-based analysis.
- Displays fairness score.
- Provides a summary of flagged issues.
- Links to the appeals system.
- Users can submit appeals with messages and attachments.
- Appeals stored with timestamps and status.
- Admins can review and update appeals.
- Upload API
- Audit API
- Appeal create/read/update APIs
- Upload Page
- Dashboard (ScoreCard + IssuesList)
- Appeals UI
- Communicates with backend via REST APIs
- File upload handling
- CSV parsing utilities
- Rule-based fairness engine
- Appeal storage and management
appeals.jsonfor appeals- Temporary storage for uploaded CSVs
- React
- Vite
- JavaScript (ES6)
- CSS
- Axios
- Node.js
- Express.js
- Multer (for uploads)
- Custom CSV parser
- Custom rule engine
Both servers must run simultaneously.
- Open the frontend UI.
- Upload Earnings, Ratings, and Penalties CSV files.
- Click Analyze.
- View Fairness Score and flagged issues.
- Submit an appeal if needed.
- Admin can update appeal status.
- Managing different CSV formats.
- Designing consistent rule-based fairness detection logic.
- Solving merge conflicts in JSON storage.
- Integrating React Router without breaking layout.
- Ensuring stable communication between frontend and backend.
- Machine learning-based fairness scoring.
- Cloud storage for uploads and appeals.
- Real database integration (MongoDB, PostgreSQL).
- Multi-language support.
- Advanced analytics dashboards.
- Manosh Suresh
- Ruhani Raman
- Eesha Hemani
This project is for educational purposes.