{"id":32880738,"url":"https://github.com/ansinitro/goverment-quiz-app","last_synced_at":"2026-06-25T13:31:11.416Z","repository":{"id":321998060,"uuid":"1087888137","full_name":"ansinitro/goverment-quiz-app","owner":"ansinitro","description":"Government Service Exam Preparation - Kazakhstan","archived":false,"fork":false,"pushed_at":"2025-11-01T22:53:28.000Z","size":268,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-01T23:25:44.150Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/ansinitro.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-01T21:09:54.000Z","updated_at":"2025-11-01T22:53:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ansinitro/goverment-quiz-app","commit_stats":null,"previous_names":["ansinitro/goverment-quiz-app"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ansinitro/goverment-quiz-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansinitro%2Fgoverment-quiz-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansinitro%2Fgoverment-quiz-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansinitro%2Fgoverment-quiz-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansinitro%2Fgoverment-quiz-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ansinitro","download_url":"https://codeload.github.com/ansinitro/goverment-quiz-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansinitro%2Fgoverment-quiz-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34778079,"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-25T02:00:05.521Z","response_time":101,"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-11-09T18:30:44.337Z","updated_at":"2026-06-25T13:31:11.391Z","avatar_url":"https://github.com/ansinitro.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎓 Government Service Exam Preparation - Kazakhstan\n\nInteractive quiz application for preparing for the Government Service examination in the Republic of Kazakhstan.\n\n## 🌟 Features\n\n- **📚 Structured Learning**: Navigate through laws (zakons) and their sections (blocks)\n- **🧠 Two Quiz Modes**: \n  - Practice all questions in order\n  - Review your mistakes to improve weak areas\n- **📊 Progress Tracking**: Automatic statistics tracking with accuracy percentage\n- **✅ Instant Feedback**: Immediate answer validation with explanations\n- **📱 Mobile-Friendly**: Responsive design works on all devices\n- **💾 Persistent Data**: Progress saved locally in browser\n\n## 🚀 Live Demo\n\n**Web Version**: [https://YOUR_USERNAME.github.io/quiz-app/](https://YOUR_USERNAME.github.io/quiz-app/)\n\n**Telegram Mini App**: [https://t.me/YOUR_BOT_NAME/quiz](https://t.me/YOUR_BOT_NAME/quiz)\n\n## 📁 Project Structure\n\n```\nquiz-app/\n├── index.html              # Main web version\n├── telegram.html           # Telegram Mini App version\n├── app.js                  # React application code\n├── all_questions.json      # Questions database\n└── README.md              # This file\n```\n\n## 🛠️ Installation \u0026 Setup\n\n### Prerequisites\n- Git installed on your computer\n- GitHub account\n- Web browser\n\n### Step 1: Clone or Download\n```bash\ngit clone https://github.com/YOUR_USERNAME/quiz-app.git\ncd quiz-app\n```\n\n### Step 2: Add Your Questions\nPlace your `all_questions.json` file in the root directory.\n\n### Step 3: Test Locally\nOpen `index.html` in your web browser to test locally.\n\n### Step 4: Deploy to GitHub Pages\n1. Push to GitHub\n2. Go to repository Settings\n3. Navigate to Pages section\n4. Select branch `main` and folder `/ (root)`\n5. Save and wait for deployment\n\n## 📊 Questions JSON Format\n\nYour `all_questions.json` should follow this structure:\n\n```json\n[\n  {\n    \"theme_id\": \"1\",\n    \"theme_name\": \"Конституция Республики Казахстан\",\n    \"block_id\": \"1\",\n    \"block_name\": \"Раздел I. Общие положения\",\n    \"question_number\": 1,\n    \"question\": \"Вопрос здесь?\",\n    \"answers\": {\n      \"1\": \"Первый вариант\",\n      \"2\": \"Второй вариант\",\n      \"3\": \"Третий вариант\",\n      \"4\": \"Четвертый вариант\"\n    },\n    \"correct_answer\": \"1\",\n    \"article\": \"Статья 15, пункт 2\"\n  }\n]\n```\n\n## 🎮 How to Use\n\n1. **Select Program**: Choose \"Программа 2\"\n2. **Select Law**: Pick a law (zakon) to study\n3. **Select Block**: Choose a specific section\n4. **Choose Mode**: \n   - \"Все вопросы\" - Practice all questions\n   - \"Работа над ошибками\" - Review mistakes\n5. **Take Quiz**: Answer questions and get instant feedback\n6. **Track Progress**: View your statistics and accuracy\n\n## 🔧 Customization\n\n### Change Colors\nEdit `app.js` and modify Tailwind CSS classes:\n- Primary color: `bg-indigo-600` → `bg-blue-600`\n- Gradient: `from-blue-50 to-indigo-100` → your colors\n\n### Add More Programs\nModify the `programs` object in `app.js`:\n```javascript\nconst programs = { \n  'prog1': 'Программа 1',\n  'prog2': 'Программа 2' \n};\n```\n\n## 📱 Telegram Mini App Setup\n\n1. Create bot with @BotFather (`/newbot`)\n2. Create mini app (`/newapp`)\n3. Use URL: `https://YOUR_USERNAME.github.io/quiz-app/telegram.html`\n4. Share the link: `https://t.me/YOUR_BOT_NAME/quiz`\n\n## 🔄 Updating Questions\n\nWhen you have new questions:\n\n```bash\n# Replace all_questions.json with new file\ngit add all_questions.json\ngit commit -m \"Update questions database\"\ngit push\n```\n\nChanges will appear on your website within a few minutes.\n\n## 📈 Statistics Storage\n\n- Statistics are stored in browser's localStorage\n- Data persists between sessions\n- Each block has independent statistics\n- Clear browser data to reset statistics\n\n## 🌐 Browser Support\n\n- ✅ Chrome/Edge (recommended)\n- ✅ Firefox\n- ✅ Safari\n- ✅ Opera\n- ✅ Mobile browsers\n\n## 🤝 Contributing\n\nFeel free to:\n- Report bugs\n- Suggest features\n- Submit pull requests\n\n## 📄 License\n\nThis project is open source and available for educational purposes.\n\n## 👨‍💻 Author\n\nCreated for preparing for Government Service examination in Kazakhstan.\n\n## 📞 Support\n\nIf you encounter issues:\n1. Check browser console (F12) for errors\n2. Ensure `all_questions.json` is in correct format\n3. Verify GitHub Pages is enabled\n4. Try clearing browser cache\n\n## ⭐ Show Your Support\n\nIf this app helped you prepare for the exam, please give it a star on GitHub!\n\n---\n\n**Good luck with your exam preparation! 🎯**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fansinitro%2Fgoverment-quiz-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fansinitro%2Fgoverment-quiz-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fansinitro%2Fgoverment-quiz-app/lists"}