{"id":51005496,"url":"https://github.com/ibnu-umer/bubble-sheet-evaluator-web","last_synced_at":"2026-06-20T20:02:10.300Z","repository":{"id":319051605,"uuid":"1077397182","full_name":"ibnu-umer/bubble-sheet-evaluator-web","owner":"ibnu-umer","description":"A Django-based web application that automates the evaluation of OMR sheets.","archived":false,"fork":false,"pushed_at":"2025-10-16T07:52:10.000Z","size":2952,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-17T10:07:42.654Z","etag":null,"topics":["css","djagno","evaluator","html","html-css-javascript","javascript","omr-sheet","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ibnu-umer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-16T07:42:40.000Z","updated_at":"2025-10-16T07:52:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"2a28ee0b-2fc7-4339-a001-57f74df4c40d","html_url":"https://github.com/ibnu-umer/bubble-sheet-evaluator-web","commit_stats":null,"previous_names":["ibnu-umer/bubble-sheet-evaluator-web"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ibnu-umer/bubble-sheet-evaluator-web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibnu-umer%2Fbubble-sheet-evaluator-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibnu-umer%2Fbubble-sheet-evaluator-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibnu-umer%2Fbubble-sheet-evaluator-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibnu-umer%2Fbubble-sheet-evaluator-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ibnu-umer","download_url":"https://codeload.github.com/ibnu-umer/bubble-sheet-evaluator-web/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibnu-umer%2Fbubble-sheet-evaluator-web/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34583589,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-20T02:00:06.407Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["css","djagno","evaluator","html","html-css-javascript","javascript","omr-sheet","python"],"created_at":"2026-06-20T20:02:01.036Z","updated_at":"2026-06-20T20:02:10.288Z","avatar_url":"https://github.com/ibnu-umer.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧑‍🏫 OMR Evaluation System\n\n**Author:** Muhammad Riyas\n**Date:** 20/09/2025\n\n\n## ⚙️ Overview\n\nThe **OMR Evaluation System** is a Django-based web application that automates the evaluation of OMR sheets. It is designed to save teachers and exam administrators time and reduce errors in scoring large batches of exam sheets.\n\nKey features:\n- Upload scanned OMR sheets (PDF/ZIP) in bulk\n- Upload answer keys (CSV or form input)\n- Detect filled bubbles using OpenCV\n- Extract student information via OCR\n- Score sheets automatically and flag ambiguities\n- Export results to Excel or CSV\n- Minimal, clean web interface\n- Local storage by default (privacy-focused)\n\n\n## 📄 Project Documentation\n\nThe `/docs` folder contains all key project documents:\n\n| File | Purpose |\n|------|---------|\n| `vision.md` | Problem statement, target users, goals |\n| `functional_spec.md` | Features, MVP, user stories, future roadmap |\n| `technical_design.md` | Architecture, data model, processing engine, endpoints |\n| `folder_structure.md` | Project folder hierarchy and structure |\n| `workflow.md` | Step-by-step system workflow |\n| `roadmap.md` | MVP development plan (day-by-day) |\n\n\n## 📂 Folder Structure\n\nThe main project structure is available in [`docs/folder_structure.md`](docs/folder_structure.md).\n\n\n## 💫 Getting Started\n\n### Prerequisites\n- Python 3.9+\n- pip or poetry\n- Virtual environment recommended\n\n### Installation\n```bash\n# Clone the repository\ngit clone \u003crepo_url\u003e\ncd omr_evaluator\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate  # Linux / Mac\nvenv\\Scripts\\activate     # Windows\n\n# Install dependencies\npip install -r requirements.txt\n```\n\n### Running the app\n```bash\n# Apply migrations\npython manage.py migrate\n\n# Run development server\npython manage.py runserver\n```\n\nAccess the app at http://127.0.0.1:8000/.\n\n\n## 🧪 Testing\n\n- **Unit tests** for processing modules: `/processing/tests/`\n- **Django app tests**: `/omr/tests/`\n- **Integration tests** for end-to-end workflow\n\nRun all tests with:\n\n```bash\npython manage.py test\n```\n\n\n## ⏳ Future Enhancements\n\n- Multi-template OMR support\n- Student login portal\n- Analytics dashboards\n- Cloud/SaaS deployment\n\n\n## 🪪 License\n\nThis project is for **personal/educational use**. Commercial use requires explicit permission from the author.\n\n\n## ☎️ Contact\n\n**Author:** Muhammad Riyas\n**Email:** `muhammadriyask11@gmail.com`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibnu-umer%2Fbubble-sheet-evaluator-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fibnu-umer%2Fbubble-sheet-evaluator-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibnu-umer%2Fbubble-sheet-evaluator-web/lists"}