{"id":30078614,"url":"https://github.com/snickerjp/aws_architecture_quiz","last_synced_at":"2025-10-11T02:11:13.317Z","repository":{"id":298874706,"uuid":"1000793213","full_name":"snickerjp/aws_architecture_quiz","owner":"snickerjp","description":"Amazon Q CLIで作成した、AWSアーキテクチャQUIZ","archived":false,"fork":false,"pushed_at":"2025-06-13T10:50:49.000Z","size":74,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-08T17:50:46.072Z","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/snickerjp.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-06-12T10:28:36.000Z","updated_at":"2025-06-13T10:15:57.000Z","dependencies_parsed_at":"2025-06-13T11:38:10.433Z","dependency_job_id":null,"html_url":"https://github.com/snickerjp/aws_architecture_quiz","commit_stats":null,"previous_names":["snickerjp/aws_architecture_quiz"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/snickerjp/aws_architecture_quiz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snickerjp%2Faws_architecture_quiz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snickerjp%2Faws_architecture_quiz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snickerjp%2Faws_architecture_quiz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snickerjp%2Faws_architecture_quiz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/snickerjp","download_url":"https://codeload.github.com/snickerjp/aws_architecture_quiz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snickerjp%2Faws_architecture_quiz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279005916,"owners_count":26083995,"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-10-11T02:00:06.511Z","response_time":55,"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-08T17:29:53.501Z","updated_at":"2025-10-11T02:11:13.267Z","avatar_url":"https://github.com/snickerjp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS Architecture Quiz Master / AWS アーキテクチャ・クイズマスター\n\nA multilingual AWS architecture learning game using Strands Agent.  \nStrands Agentを使用した多言語対応AWSアーキテクチャ学習ゲームです。\n\n## Overview / 概要\n\nThis game helps you improve your AWS service knowledge and architecture design skills by designing optimal AWS architectures for various scenarios. Now available in multiple languages!\n\nこのゲームでは、様々なシナリオに対して最適なAWSアーキテクチャを設計することで、AWSサービスの知識とアーキテクチャ設計スキルを向上させることができます。多言語対応になりました！\n\n## Features / 特徴\n\n- 🌍 **Multilingual Support**: English and Japanese / **多言語対応**: 英語と日本語\n- 🎯 **3 Difficulty Levels**: Beginner, Intermediate, Advanced / **3つの難易度レベル**: 初級、中級、上級\n- 💰 **Cost Analysis**: Automatic cost calculation for selected services / **コスト分析**: 選択したサービス構成の概算コストを自動計算\n- 📊 **Detailed Evaluation**: Accuracy, improvement points, and best practices / **詳細な評価**: 正解率、改善点、ベストプラクティスを提示\n- 🤖 **AI Quiz Master**: Strands Agent provides friendly guidance / **AI クイズマスター**: Strands Agentが親切にガイド\n- 🏆 **Scoring System**: Performance-based scoring / **スコアリングシステム**: パフォーマンスに基づいた採点\n- 👤 **User Authentication**: Required player name input / **ユーザー認証**: プレイヤー名の必須入力\n- ✅ **Input Validation**: Confirmation for non-suggested services / **入力検証**: 提案外サービスの確認機能\n\n## Supported Languages / 対応言語\n\n- **English** - Full support for English interface and scenarios\n- **日本語** - 日本語インターフェースとシナリオの完全サポート\n\n## Scenarios / シナリオ\n\n### 1. Startup Web Application / スタートアップのWebアプリケーション (Beginner/初級)\n- **English**: Web application with 100K monthly page views, focusing on cost efficiency and scalability\n- **日本語**: 月間10万PVのWebアプリケーション、コスト効率と拡張性を重視\n- **Max Score / 最大スコア**: 100 points / 100点\n\n### 2. Enterprise Microservices / エンタープライズのマイクロサービス (Advanced/上級)  \n- **English**: Large-scale microservices architecture with critical security and monitoring requirements\n- **日本語**: 大規模なマイクロサービスアーキテクチャ、セキュリティとモニタリングが重要\n- **Max Score / 最大スコア**: 200 points / 200点\n\n### 3. Data Analytics Platform / データ分析プラットフォーム (Intermediate/中級)\n- **English**: Analytics platform combining real-time and batch processing\n- **日本語**: リアルタイムデータ処理とバッチ処理を組み合わせた分析基盤\n- **Max Score / 最大スコア**: 150 points / 150点\n\n## Setup / セットアップ\n\n### Prerequisites / 前提条件\n\n- Python 3.8 or higher / Python 3.8以上\n- AWS credentials configured (AWS CLI or environment variables) / AWS認証情報の設定（AWS CLI または環境変数）\n- Amazon Bedrock access permissions / Amazon Bedrock へのアクセス権限\n\n### Installation / インストール\n\n```bash\n# Install dependencies / 依存関係のインストール\npip install -r requirements.txt\n\n# Configure AWS credentials (if not already set) / AWS認証情報の設定（未設定の場合）\naws configure\n```\n\n⚠️ **AWS認証情報について / About AWS Credentials**:\n- フルゲーム機能にはAWS認証情報が必要です / AWS credentials are required for full game features\n- 詳細な設定方法は `AWS_CREDENTIALS_SETUP.md` をご覧ください / See `AWS_CREDENTIALS_SETUP.md` for detailed setup instructions\n- 認証情報なしでも `offline_demo.py` で基本機能をお試しいただけます / You can try basic features with `offline_demo.py` without credentials\n\n### Amazon Bedrock Model Access / Amazon Bedrock モデルアクセスの有効化\n\n1. Access Amazon Bedrock in AWS Console / AWS コンソールで Amazon Bedrock にアクセス\n2. Enable access to Claude 3.7 Sonnet model in \"Model access\" / 「Model access」で Claude 3.7 Sonnet モデルへのアクセスを有効化\n3. Optionally enable access to image generation models / 必要に応じて画像生成モデルへのアクセスも有効化\n\n## Usage / 使用方法\n\n### Option 1: Full Game with AI Agent (Requires AWS credentials)\n### オプション1: AIエージェント付きフルゲーム（AWS認証情報必要）\n```bash\npython multilingual_quiz_game.py\n```\n\n### Option 2: Simple Demo (No AWS credentials required)\n### オプション2: 簡単デモ（AWS認証情報不要）\n```bash\npython simple_multilingual_demo.py\n```\n\n### Option 3: Offline Demo with Mock AI (No AWS credentials required)\n### オプション3: モックAI付きオフラインデモ（AWS認証情報不要）\n```bash\npython offline_demo.py\n```\n\n### Game Flow / ゲームの流れ\n\n1. **Select Language / 言語選択**\n   - Choose between English and Japanese / 英語と日本語から選択\n2. **Enter Player Name / プレイヤー名を入力** (Required / 必須)\n   - Error message displayed if empty / 空の場合はエラーメッセージが表示され再入力\n3. **Select Scenario / シナリオを選択** (1-3)\n4. **Review Requirements / 要件を確認**\n5. **Select Appropriate AWS Services / 適切なAWSサービスを選択**\n   - Yes/No confirmation for services not in suggestions / 提案リスト外のサービスがある場合はYes/No確認\n   - Re-input on No, evaluation on Yes / No選択時は再入力、Yes選択時は評価実行\n6. **Review Evaluation Results and Feedback / 評価結果とフィードバックを確認**\n7. **Challenge Next Scenario or Exit / 次のシナリオに挑戦または終了**\n\n### Input Examples / 入力例\n\n```\n# Language Selection / 言語選択\n言語を選択してください / Please select your language:\n1. 日本語 (ja)\n2. English (en)\nSelect language (1-2): 2\n\n# Player Name (Required) / プレイヤー名（必須）\nPlease enter your player name: John Smith\n\n# Service Selection / サービス選択\nPlease enter your selected services separated by commas:\nExample: EC2, RDS, S3, CloudFront\nSelection: EC2, ALB, Auto Scaling, RDS, S3, CloudFront, ACM\n\n# Non-suggested Services Warning / 提案外サービスがある場合\n⚠️  The following services are not in the suggested list:\n  • CustomService\nDo you want to continue with these services? (Yes/No): No\nPlease retry service selection.\n```\n\n## Evaluation System / 評価システム\n\n### Score Calculation / スコア計算\n- **Base Score / 基本スコア** = Scenario Max Score × Accuracy Rate / シナリオの最大スコア × 正解率\n- **Penalty / ペナルティ** = Number of Unnecessary Services × 10 points / 不要なサービス数 × 10点\n- **Final Score / 最終スコア** = Base Score - Penalty / 基本スコア - ペナルティ\n\n### Grades / グレード\n- **S**: 90%+ accuracy / 90%以上の正解率\n- **A**: 70-89% accuracy / 70-89%の正解率  \n- **B**: 50-69% accuracy / 50-69%の正解率\n- **C**: 30-49% accuracy / 30-49%の正解率\n- **D**: Under 30% accuracy / 30%未満の正解率\n\n## Customization / カスタマイズ\n\n### Adding New Languages / 新しい言語の追加\n\nAdd new language configurations to `languages.py`:\n\n```python\nLANGUAGES[\"es\"] = {\n    \"name\": \"Español\",\n    \"code\": \"es\",\n    \"messages\": {\n        # Add Spanish messages here\n    },\n    \"scenarios\": [\n        # Add Spanish scenarios here\n    ]\n}\n```\n\n### Adding New Scenarios / 新しいシナリオの追加\n\nAdd new scenarios to the `scenarios` list in each language configuration in `languages.py`:\n\n```python\n{\n    \"id\": 4,\n    \"title\": \"New Scenario Title\",\n    \"description\": \"Scenario description\",\n    \"requirements\": [\"Requirement 1\", \"Requirement 2\"],\n    \"correct_services\": [\"Service1\", \"Service2\"],\n    \"difficulty\": \"Intermediate\",\n    \"max_score\": 120\n}\n```\n\n### Updating Cost Information / コスト情報の更新\n\nUpdate the `service_costs` dictionary in the `check_architecture_cost` function to reflect the latest pricing information.\n\n## File Structure / ファイル構成\n\n```\naws_architecture_quiz/\n├── multilingual_quiz_game.py    # Main multilingual game file\n├── languages.py                 # Language configurations\n├── quiz_game.py                # Original Japanese-only version\n├── requirements.txt            # Python dependencies\n└── README_multilingual.md      # This file\n```\n\n## Troubleshooting / トラブルシューティング\n\n### Common Issues / よくある問題\n\n1. **Bedrock Access Error / Bedrock アクセスエラー**\n   - Verify model access is enabled in Amazon Bedrock / Amazon Bedrock でモデルアクセスが有効化されているか確認\n   - Check AWS credentials are properly configured / AWS認証情報が正しく設定されているか確認\n\n2. **Module Not Found Error / モジュールが見つからないエラー**\n   - Run `pip install -r requirements.txt` / `pip install -r requirements.txt` を実行\n   - Verify Python environment is properly configured / Python環境が正しく設定されているか確認\n\n3. **Inaccurate Cost Calculation / コスト計算が不正確**\n   - Actual AWS pricing varies by region and usage / 実際のAWS料金は地域や使用量により変動します\n   - Use AWS Pricing Calculator for more accurate estimates / より正確な見積もりには AWS Pricing Calculator を使用してください\n\n## Future Enhancements / 今後の拡張予定\n\n- [ ] More language support (Spanish, French, German, etc.) / より多くの言語サポート（スペイン語、フランス語、ドイツ語など）\n- [ ] More scenarios / より多くのシナリオの追加\n- [ ] Integration with actual AWS Pricing API / 実際のAWS Pricing APIとの連携\n- [ ] Automatic architecture diagram generation / アーキテクチャ図の自動生成\n- [ ] Multiplayer support / マルチプレイヤー対応\n- [ ] Learning progress saving / 学習進捗の保存機能\n- [ ] Custom scenario creation / カスタムシナリオの作成機能\n\n## License / ライセンス\n\nMIT License\n\n## Contributing / 貢献\n\nPull requests and issue reports are welcome!  \nプルリクエストやイシューの報告を歓迎します！\n\n---\n\n## Quick Start / クイックスタート\n\n1. **Clone and setup / クローンとセットアップ**:\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd aws_architecture_quiz\n   pip install -r requirements.txt\n   ```\n\n2. **Configure AWS / AWS設定**:\n   ```bash\n   aws configure\n   ```\n\n3. **Run the game / ゲーム実行**:\n   ```bash\n   python multilingual_quiz_game.py\n   ```\n\n4. **Select your language and start playing! / 言語を選択してプレイ開始！**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnickerjp%2Faws_architecture_quiz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsnickerjp%2Faws_architecture_quiz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsnickerjp%2Faws_architecture_quiz/lists"}