{"id":29827526,"url":"https://github.com/wms784/composite_hunter","last_synced_at":"2026-04-09T21:59:40.356Z","repository":{"id":303642478,"uuid":"1016050821","full_name":"WMs784/composite_hunter","owner":"WMs784","description":"game application for learning math","archived":false,"fork":false,"pushed_at":"2025-07-28T12:39:44.000Z","size":1055,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-28T14:39:01.156Z","etag":null,"topics":["android","dart","flutter","game","ios","math"],"latest_commit_sha":null,"homepage":"https://play.google.com/store/apps/details?id=com.wms784.composite_hunter","language":"Dart","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/WMs784.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-07-08T12:18:04.000Z","updated_at":"2025-07-28T12:39:48.000Z","dependencies_parsed_at":"2025-07-28T14:23:04.211Z","dependency_job_id":"bf2c2b44-5139-41a8-8664-e8cabbb557e9","html_url":"https://github.com/WMs784/composite_hunter","commit_stats":null,"previous_names":["wms784/composite_hunter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/WMs784/composite_hunter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WMs784%2Fcomposite_hunter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WMs784%2Fcomposite_hunter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WMs784%2Fcomposite_hunter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WMs784%2Fcomposite_hunter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WMs784","download_url":"https://codeload.github.com/WMs784/composite_hunter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WMs784%2Fcomposite_hunter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267639161,"owners_count":24119769,"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-07-29T02:00:12.549Z","response_time":2574,"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":["android","dart","flutter","game","ios","math"],"created_at":"2025-07-29T06:12:08.404Z","updated_at":"2026-04-09T21:59:35.332Z","avatar_url":"https://github.com/WMs784.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 合成数ハンター (Composite Hunter)\n\n素因数分解を楽しく学べる教育ゲームアプリです。\n\n## 📱 アプリについて\n\n「合成数ハンター」は、素数を武器として合成数の敵と戦う戦略的バトルゲームです。プレイヤーは素因数分解を駆使して敵を倒し、数学的思考力を楽しみながら身に付けることができます。\n\n### 🎯 主な特徴\n\n- 📚 **教育的**: 素因数分解と素数の概念を実践的に学習\n- 🎮 **ゲーム性**: 戦略的バトルシステムで楽しく学習\n- 📈 **段階的学習**: レベルに応じた難易度調整\n- 🏆 **実績システム**: 達成感を高める各種アチーブメント\n- 🌐 **多言語対応**: 日本語・英語対応\n\n### 📋 ゲームモード\n\n- **練習モード**: 基本的な操作と概念を学習\n- **ステージモード**: 4つの難易度レベルでスキルアップ\n- **アチーブメント**: 様々な達成条件で長期的なモチベーション維持\n\n## 🛠️ 技術仕様\n\n### 開発環境\n- **フレームワーク**: Flutter 3.32.0+\n- **言語**: Dart\n- **状態管理**: Riverpod\n- **データベース**: SQLite (sqflite)\n- **ローカライゼーション**: flutter_localizations\n\n### アーキテクチャ\n- **設計パターン**: Clean Architecture\n- **レイヤー構造**: Presentation / Domain / Data\n- **状態管理**: StateNotifier + Riverpod\n- **データ永続化**: Repository Pattern\n\n## 🚀 セットアップ\n\n### 前提条件\n- Flutter SDK 3.32.0 以上\n- Dart SDK 3.8.0 以上\n- Android Studio / VS Code\n- iOS: Xcode 14.0+ (iOS開発の場合)\n\n### インストール手順\n\n```bash\n# 1. リポジトリをクローン\ngit clone https://github.com/WMs784/composite_hunter.git\ncd composite_hunter\n\n# 2. 依存関係をインストール\nflutter pub get\n\n# 3. コード生成\ndart run build_runner build\n\n# 4. アプリを実行\nflutter run\n```\n\n### 開発用コマンド\n\n```bash\n# コード解析\nflutter analyze\n\n# コードフォーマット\nflutter format .\n\n# テスト実行\nflutter test\n\n# APKビルド\nflutter build apk\n\n# iOSビルド (macOS環境)\nflutter build ios\n```\n\n## 📁 プロジェクト構造\n\n```\nlib/\n├── main.dart                 # アプリエントリーポイント\n├── core/                     # 共有ユーティリティ\n│   ├── constants/           # 定数定義\n│   ├── exceptions/          # カスタム例外\n│   ├── extensions/          # Dart拡張\n│   └── utils/               # ユーティリティ関数\n├── data/                    # データ層\n│   ├── models/             # データモデル\n│   ├── repositories/       # リポジトリ実装\n│   └── datasources/        # データソース\n├── domain/                  # ビジネスロジック層\n│   ├── entities/           # エンティティ\n│   ├── usecases/           # ユースケース\n│   └── services/           # ドメインサービス\n└── presentation/            # プレゼンテーション層\n    ├── providers/          # 状態管理\n    ├── screens/            # 画面ウィジェット\n    ├── widgets/            # 再利用可能ウィジェット\n    └── theme/              # テーマ設定\n```\n\n## 🎮 ゲームプレイ\n\n### 基本ルール\n1. 合成数の敵が出現します\n2. 素数を選択して敵を攻撃します\n3. 敵の値が素数になったら「素数宣言」で勝利\n4. 制限時間内にできるだけ多くの敵を倒します\n\n### 戦略のポイント\n- 効率的な素因数分解を考える\n- 限られた素数を賢く使用する\n- 時間配分を意識した戦略\n\n## 🏗️ 開発\n\n### コーディング規約\n- [Flutter Style Guide](https://docs.flutter.dev/development/tools/formatting)に準拠\n- [Effective Dart](https://dart.dev/guides/language/effective-dart)を遵守\n- コミット前に`flutter analyze`と`flutter test`を実行\n\n### Git Hooks\nプロジェクトには自動品質チェックが設定されています：\n\n```bash\n# Git Hooksを有効化\ngit config core.hooksPath .githooks\n```\n\n### コントリビューション\n1. Issuesで議論してください\n2. フィーチャーブランチを作成してください\n3. テストを追加してください\n4. Pull Requestを送信してください\n\n## 📄 ドキュメント\n\n### 公式ドキュメント\n- [プライバシーポリシー](https://wms784.github.io/composite_hunter/privacy-policy.html)\n- [利用規約](https://wms784.github.io/composite_hunter/terms-of-service.html)\n\n### 設計ドキュメント\n- [要件定義書](docs/requirements.md)\n- [アーキテクチャ設計](docs/architecture.md)\n- [詳細設計書](docs/detailed_class_design.md)\n- [データベース設計](docs/database_design.md)\n\n## 📱 動作環境\n\n### Android\n- Android API Level 21 (Android 5.0) 以上\n- RAM: 2GB以上推奨\n- ストレージ: 100MB以上の空き容量\n\n### iOS\n- iOS 11.0 以上\n- iPhone 6以降 / iPad (第5世代) 以降\n- ストレージ: 100MB以上の空き容量\n\n## 🧪 テスト\n\n### テスト構成\n- **Unit Tests**: ビジネスロジックのテスト\n- **Widget Tests**: UIコンポーネントのテスト\n- **Integration Tests**: エンドツーエンドのテスト\n\n### テスト実行\n```bash\n# 全テスト実行\nflutter test\n\n# 特定のテスト実行\nflutter test test/unit/math_utils_test.dart\n\n# カバレッジ取得\nflutter test --coverage\n```\n\n## 📊 パフォーマンス\n\n### 最適化項目\n- メモリ使用量の最適化\n- アニメーション性能\n- データベースクエリの効率化\n- アプリ起動時間の短縮\n\n## 🔧 トラブルシューティング\n\n### よくある問題\n\n**1. ビルドエラーが発生する**\n```bash\nflutter clean\nflutter pub get\ndart run build_runner build --delete-conflicting-outputs\n```\n\n**2. アイコンが表示されない**\n```bash\nflutter pub run flutter_launcher_icons\nflutter clean\nflutter run\n```\n\n**3. 多言語化が反映されない**\n```bash\nflutter gen-l10n\nflutter run\n```\n\n## 📈 ロードマップ\n\n### 近期予定\n- [ ] オンライン対戦機能\n- [ ] より多くの素数パズル\n- [ ] 達成度分析機能\n\n### 将来計画\n- [ ] VR/AR対応\n- [ ] 他の数学分野への拡張\n- [ ] 教師向け管理機能\n\n## 📄 ライセンス\n\nこのプロジェクトは MIT License の下で公開されています。詳細は [LICENSE](LICENSE) ファイルをご覧ください。\n\n## 👥 貢献者\n\n### 開発チーム\n- **プロジェクトリード**: WMs784\n- **技術アーキテクト**: WMs784\n- **UI/UXデザイナー**: WMs784\n\n### 謝辞\nこのプロジェクトは以下のオープンソースプロジェクトを利用しています：\n- [Flutter](https://flutter.dev/)\n- [Riverpod](https://riverpod.dev/)\n- [sqflite](https://pub.dev/packages/sqflite)\n\n## 📞 お問い合わせ\n\n- **Issues**: [GitHub Issues](https://github.com/WMs784/composite_hunter/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/WMs784/composite_hunter/discussions)\n- **Security**: セキュリティに関する問題は [SECURITY.md](SECURITY.md) をご覧ください\n\n---\n\n© 2025 Composite Hunter Development Team. All rights reserved.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwms784%2Fcomposite_hunter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwms784%2Fcomposite_hunter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwms784%2Fcomposite_hunter/lists"}