{"id":16625219,"url":"https://github.com/shunmakk/frontend-coliseum","last_synced_at":"2026-04-02T01:49:57.228Z","repository":{"id":254902185,"uuid":"847902878","full_name":"shunmakk/frontend-coliseum","owner":"shunmakk","description":null,"archived":false,"fork":false,"pushed_at":"2024-10-11T09:50:19.000Z","size":7725,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-18T02:15:56.008Z","etag":null,"topics":["expressjs","firebase","mongodb","react"],"latest_commit_sha":null,"homepage":"","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/shunmakk.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}},"created_at":"2024-08-26T19:04:48.000Z","updated_at":"2024-10-11T09:50:23.000Z","dependencies_parsed_at":"2024-10-12T04:13:34.034Z","dependency_job_id":null,"html_url":"https://github.com/shunmakk/frontend-coliseum","commit_stats":{"total_commits":41,"total_committers":1,"mean_commits":41.0,"dds":0.0,"last_synced_commit":"1a6bbdf4474f1627627218442463347c920d23d8"},"previous_names":["shunmakk/frontend-quiz-app","shunmakk/frontend_coliseum","shunmakk/frontend-coliseum"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shunmakk%2Ffrontend-coliseum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shunmakk%2Ffrontend-coliseum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shunmakk%2Ffrontend-coliseum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shunmakk%2Ffrontend-coliseum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shunmakk","download_url":"https://codeload.github.com/shunmakk/frontend-coliseum/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243030813,"owners_count":20224666,"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","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":["expressjs","firebase","mongodb","react"],"created_at":"2024-10-12T04:03:38.428Z","updated_at":"2025-12-26T03:32:52.005Z","avatar_url":"https://github.com/shunmakk.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# フロントエンドに関するクイズアプリ\n\nフロントエンドに関する知識の実力試しができたらいいなと思って作ってみた。\n\n## 開発期間\n\n2024/08 ~ 2024/10\n\n## URL\n\n※まだデプロイしてない\n\n## 使用技術\n\n### フロントエンド\n\n- React\n- TypeScript\n- Chakra UI\n- Tailwind CSS\n\n### バックエンド\n\n- Node.js\n- Express.js\n\n### データベース\n\n- MongoDB\n- Firebase Firestore\n\n### デプロイ 予定\n\n- Firebase\n- Vercel\n- MongoDB Atlas\n\n### その他\n\n- 認証: Firebase Authentication\n- 状態管理: React Context API\n\n## 主な機能\n\n1. **認証機能**\n   - ユーザー登録\n   - ログイン/ログアウト\n2. **難易度選択**\n   - Easy\n   - Medium\n   - Hard\n3. **解説機能**\n   - 各問題の詳細な解説\n4. **プロフィール機能**\n   - ユーザーの成績表示\n5. **ランキング機能**\n   - 総スコアランキング\n   - 平均スコアランキング\n\n## データベース構造\n\n### MongoDB (問題データ)\n\nコレクション: 'questions'\n\n```json\n{\n  \"_id\": \"ObjectId\",\n  \"text\": \"String\",\n  \"options\": [\"String\", \"String\", \"String\", \"String\"],\n  \"correctAnswer\": \"Number\",\n  \"difficulty\": \"String ('easy', 'medium', 'hard')\",\n  \"explanation\": \"String\"\n}\n```\n\nコレクション: 'users'\n\n```json\n{\n  \"uid\": \"String\",\n  \"name\": \"String\",\n  \"email\": \"String\",\n  \"totalScore\": \"Number\",\n  \"totalGames\": \"Number\",\n  \"averageScore\": \"Number\"\n}\n```\n\n## ディレクトリ\n```\nfrontend-colosseum/\n├── client/  \n│ ├── public/\n│ │ ├── index.html\n│ ├── src/\n│ │ ├── components/\n│ │ ├── context/\n│ │ ├── page/\n│ │ ├── hooks/\n│ │ ├── lib/\n│ │ ├── App.ts\n│ │ ├── index.ts\n│ │ └── firebase.ts\n│ ├── package.json\n│ ├── tailwind.config.js\n│  \n│\n├── server/  \n│ ├── src/\n│ │ ├── models/\n│ │ ├── scripts/\n│ │ ├── db.ts\n│ │ └── server.js  \n│ ├── tsconfig.json\n└── README.md\n```\n\n## 工夫点\n\n### FireStore と MongoDB の併用　(それぞれの選定理由)\n- MongoDB: 大量の問題データを効率的に管理・クエリ\n- Firestore: リアルタイムでのユーザーデータ更新\n\n### パフォーマンス最適化\n- useCallbackの使用。難易度が変更された場合にのみ関数が再生成されるようにしたので、不要な再レンダリングを防ぐことができた。\n- 質問のフェッチ時にキャッシュを無効化し、常に最新のデータを取得\n\n### ユーザー体験の向上\n- クイズの進行状態をローカルストレージに保存し、ページリロード時に復元できるようにした\n- カスタムフックを使用した非同期処理の管理\n- ローディング表示\n\n### セキュリティ\n- Firebase Authentication と連携した Protected Routes\n- クライアントサイドでの入力バリデーション\n- クイズ完了時にユーザーのスコアを更新する際、整合性を保つためにFirestoreのincrement関数を使用した\n\n## 懸念点と改善点\n\n### ランキング機能の最適化\n\n- \u003cb\u003e現状\u003c/b\u003e: フロントエンド側で Firestore への複数クエリによるセキュリティ、パフォーマンス低下\n- \u003cb\u003e改善案\u003c/b\u003e: サーバー側でnode-cron や agenda などのバックグラウンドジョブでランキング計算と定期更新を検討\n\n## 今後の展望\n\n### 機能拡張\n- カテゴリ別クイズモードの追加\n- 問題数の拡充\n- ユーザー自身が問題を作れる機能\n\n### 全体的なリファクタリング\n- エラーハンドリングの改善\n- アクセシビリティの改善\n- パフォーマンスの最適化\n\n### テストケースの追加\n\n## 参考記事\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshunmakk%2Ffrontend-coliseum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshunmakk%2Ffrontend-coliseum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshunmakk%2Ffrontend-coliseum/lists"}