{"id":30537764,"url":"https://github.com/ake144/exam-center","last_synced_at":"2025-08-27T19:34:52.961Z","repository":{"id":310723687,"uuid":"1040920192","full_name":"ake144/exam-center","owner":"ake144","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-19T20:01:59.000Z","size":106,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-19T22:07:54.852Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/ake144.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":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-19T17:48:43.000Z","updated_at":"2025-08-19T20:02:02.000Z","dependencies_parsed_at":"2025-08-19T22:18:21.799Z","dependency_job_id":null,"html_url":"https://github.com/ake144/exam-center","commit_stats":null,"previous_names":["ake144/exam-center"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ake144/exam-center","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ake144%2Fexam-center","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ake144%2Fexam-center/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ake144%2Fexam-center/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ake144%2Fexam-center/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ake144","download_url":"https://codeload.github.com/ake144/exam-center/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ake144%2Fexam-center/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272368116,"owners_count":24922230,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-27T02:00:09.397Z","response_time":76,"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":[],"created_at":"2025-08-27T19:34:52.117Z","updated_at":"2025-08-27T19:34:52.946Z","avatar_url":"https://github.com/ake144.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ExamCenter - Online Test Platform\n\nA comprehensive online exam center application built with Next.js, TypeScript, and Tailwind CSS. This platform allows schools and educational institutions to create, manage, and administer online tests with various question types.\n\n## 🚀 Features\n\n### For Students\n- **Dashboard**: View available tests, recent results, and performance statistics\n- **Test Taking**: Interactive test interface with timer and question navigation\n- **Multiple Question Types**: Support for multiple choice, true/false, short answer, and essay questions\n- **Real-time Progress**: Track completion progress and time remaining\n- **Results Review**: Detailed breakdown of test results with correct answers and explanations\n\n### For Teachers \u0026 Administrators\n- **Test Management**: Create and manage tests with different subjects and topics\n- **Question Bank**: Comprehensive question database with difficulty levels\n- **Performance Analytics**: View student performance and test statistics\n- **User Management**: Manage students, teachers, and administrators\n\n### Core Features\n- **Responsive Design**: Works seamlessly on desktop, tablet, and mobile devices\n- **Modern UI**: Clean, intuitive interface built with Tailwind CSS\n- **Type Safety**: Full TypeScript support for better development experience\n- **Mock Data**: Comprehensive mock data for testing and demonstration\n\n## 🛠️ Technology Stack\n\n- **Framework**: Next.js 14 with App Router\n- **Language**: TypeScript\n- **Styling**: Tailwind CSS\n- **UI Components**: Custom component library\n- **State Management**: React hooks and local state\n- **Development**: ESLint, PostCSS\n\n## 📁 Project Structure\n\n```\nexam-center/\n├── src/\n│   ├── app/                    # Next.js app router pages\n│   │   ├── page.tsx           # Dashboard\n│   │   ├── tests/             # Tests pages\n│   │   ├── results/           # Results page\n│   │   └── layout.tsx         # Root layout\n│   ├── components/            # React components\n│   │   ├── ui/               # Reusable UI components\n│   │   ├── Header.tsx        # Navigation header\n│   │   ├── TestCard.tsx      # Test display card\n│   │   └── QuestionDisplay.tsx # Question rendering\n│   ├── data/                 # Mock data\n│   │   └── mockData.ts       # Schools, tests, users, results\n│   ├── types/                # TypeScript type definitions\n│   │   └── index.ts          # Interface definitions\n│   └── utils/                # Utility functions\n│       └── helpers.ts        # Helper functions\n├── public/                   # Static assets\n└── package.json             # Dependencies and scripts\n```\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- Node.js 18+ \n- npm or yarn\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd exam-center\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Run the development server**\n   ```bash\n   npm run dev\n   ```\n\n4. **Open your browser**\n   Navigate to [http://localhost:3000](http://localhost:3000)\n\n### Available Scripts\n\n- `npm run dev` - Start development server\n- `npm run build` - Build for production\n- `npm run start` - Start production server\n- `npm run lint` - Run ESLint\n- `npx tsc --noEmit` - Type checking\n\n## 📊 Mock Data\n\nThe application includes comprehensive mock data for demonstration:\n\n### Schools\n- Lincoln High School (Springfield, IL)\n- Riverside Academy (Chicago, IL)\n- Central Middle School (Peoria, IL)\n\n### Subjects\n- **Mathematics**: Algebra, Geometry, Number Theory\n- **Science**: Chemistry, Astronomy, Biology\n- **English**: Grammar, Literature, Writing\n\n### Question Types\n- **Multiple Choice**: Standard multiple choice questions\n- **True/False**: Binary choice questions\n- **Short Answer**: Text-based answers\n- **Essay**: Long-form written responses\n\n### Users\n- **Students**: John Smith, Mike Davis\n- **Teachers**: Sarah Johnson\n- **Administrators**: Dr. Emily Wilson\n\n## 🎯 Usage Guide\n\n### For Students\n\n1. **Dashboard**: View your test statistics and available tests\n2. **Browse Tests**: Use filters to find specific tests by subject or difficulty\n3. **Take Tests**: \n   - Review test information and instructions\n   - Answer questions with the interactive interface\n   - Navigate between questions using the question navigator\n   - Submit when complete or when time runs out\n4. **View Results**: Check your performance and review correct answers\n\n### For Teachers/Administrators\n\n1. **Admin Panel**: Access administrative features (coming soon)\n2. **Test Creation**: Create new tests with various question types\n3. **Question Management**: Add questions to the question bank\n4. **Performance Monitoring**: Track student performance and analytics\n\n## 🎨 UI Components\n\nThe application includes a custom component library:\n\n- **Button**: Multiple variants (primary, secondary, outline, danger)\n- **Card**: Flexible card layouts with header, content, and footer\n- **Badge**: Status indicators and labels\n- **QuestionDisplay**: Interactive question rendering for all question types\n\n## 🔧 Customization\n\n### Adding New Question Types\n\n1. Update the `Question` interface in `src/types/index.ts`\n2. Add rendering logic in `QuestionDisplay.tsx`\n3. Update validation in `src/utils/helpers.ts`\n\n### Adding New Subjects\n\n1. Add subject data to `src/data/mockData.ts`\n2. Update the subject color mapping in `TestCard.tsx`\n\n### Styling\n\nThe application uses Tailwind CSS for styling. Custom styles can be added to:\n- `src/app/globals.css` for global styles\n- Component-specific classes for component styling\n\n## 🚧 Future Enhancements\n\n- [ ] User authentication and authorization\n- [ ] Database integration (PostgreSQL/MongoDB)\n- [ ] Real-time collaboration features\n- [ ] Advanced analytics and reporting\n- [ ] Mobile app (React Native)\n- [ ] API endpoints for external integrations\n- [ ] Bulk test import/export\n- [ ] Advanced question types (matching, ordering, etc.)\n- [ ] Proctoring features\n- [ ] Certificate generation\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🆘 Support\n\nFor support and questions:\n- Create an issue in the repository\n- Contact the development team\n- Check the documentation\n\n---\n\n**Built with ❤️ using Next.js, TypeScript, and Tailwind CSS**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fake144%2Fexam-center","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fake144%2Fexam-center","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fake144%2Fexam-center/lists"}