Example MCP Cursor

🎮 游戏时段 - 魔法师：万智牌项目

使用.NET 9+开发的项目，采用（某种）架构 SOLID（注：SOLID是一个设计原则或概念的缩写，具体含义需根据上下文确定，但在此直接翻译为英文原词以保持其通用性） 用于管理《万智牌：魔法对决》游戏会话的典范。

______________________________________________________________________

📋 描述

支持多种格式的RESTful API，用于创建和管理《万智牌：集结》的对局：

• 决斗 经典1v1格式（2名玩家，20点生命值）
• 指挥官 多人游戏模式（2-6名玩家，40点生命值）

该项目展示了对……的严格应用 SOLID原则 和 整洁代码 其设计具有可扩展的架构。

______________________________________________________________________

🏗️ 建筑学

应用的SOLID原则

• ✅ 单一职责原则 每个班级都有其独特的责任
• ✅ 开闭原则 开放系统便于扩展，封闭系统便于修改
• ✅ 里氏替换原则（Liskov Substitution Principle） 实现之间完全可以互换
• ✅ 接口隔离原则 简洁明了、目标明确的界面
• ✅ 依赖倒置原则 依赖抽象，而非实现

设计模式

• 策略模式 可更换的游戏规则
• 工厂模式 制定适当的规则
• 仓库模式（或存储库模式） 数据访问的封装
• 依赖注入 使用ASP.NET Core的IoC（控制反转）
• 结果模式 优雅地处理错误

______________________________________________________________________

🚀 快速启动

cd game-sessions
dotnet run

API将在以下网址上提供访问： https://localhost:5001

如需了解更多详情，请参阅 game-sessions/QUICKSTART.md 翻译为中文是：游戏会话/快速入门.md

______________________________________________________________________

📚 完整文档

该项目包含一份详尽的文件资料：

______________________________________________________________________

📁 项目结构

game-sessions/
├── Features/Sessions/
│   ├── Controllers/        # API REST endpoints
│   ├── Models/             # Entités métier
│   ├── Rules/              # Règles de jeu (Strategy Pattern)
│   ├── Factories/          # Création d'objets (Factory Pattern)
│   └── Services/           # Logique métier
├── Program.cs              # Configuration et DI
└── [Documentation complète]

______________________________________________________________________

🎯 功能

REST API

• GET /api/sessions - 列出所有会话
• GET /api/sessions/{id} - 获取会话
• POST /api/sessions - 创建一个会话（并进行验证）
• POST /api/sessions/{id}/start - 启动一个会话
• POST /api/sessions/{id}/complete - 以胜者告终
• POST /api/sessions/{id}/cancel - 取消会话
• GET /api/players/random - 获取一个随机玩家
• POST /api/players - 创建一个玩家

自动验证

该系统会根据格式自动验证规则：

• 决斗 仅限2名玩家
• 指挥官 支持2至6名玩家

验证时提供的详细错误消息示例。

______________________________________________________________________

🔧 技术

• .NET 9.0 （兼容 .NET 10 预览版）
• ASP.NET Core Web API
• OpenAPI / Swagger（注：OpenAPI 和 Swagger 通常一起使用，OpenAPI 是一种开放应用程序编程接口规范，而 Swagger 是一种用于描述和展示 RESTful API 的工具，两者常结合使用以提供API的文档和测试功能。）
• 原生依赖注入

______________________________________________________________________

🎓 亮点

代码质量

• ✅ 严格应用清洁代码原则
• ✅ 完整的XML文档
• ✅ 明确且一致的命名
• ✅ 0个编译错误
• ✅ 0 条警告

建筑学

• ✅ 应用了SOLID原则（5/5原则全部符合）
• ✅ 5种设计模式
• ✅ 最大化解耦
• ✅ 非常容易测试

可扩展性

• ✅ 添加新格式于 3个步骤
• ✅ 无需修改现有代码
• ✅ 提供扩展指南

文档

• ✅ 8个文档文件
• ✅ 500+ 行文档
• ✅ 视觉图表
• ✅ 具体示例

______________________________________________________________________

📊 指标

______________________________________________________________________

🔄 已证明的可扩展性

添加新格式（例如：Brawl）

3个简单步骤 :

1. 添加到枚举中 GameType
2. 创建类 BrawlRules : IGameTypeRules
3. 保存到 GameTypeRulesFactory

✅ 无需修改现有代码！

看 扩展说明.md 以获取完整指南。

______________________________________________________________________

🧪 测试

完整的HTTP测试集合已提供在 game-sessions-v2.http（可译为“游戏会话-v2.http”或根据上下文简化为“游戏会话版本2.http”，但直接保留原英文形式在技术语境中更为常见）

示例：

• ✅ 创建决斗和指挥模式
• ✅ 验证时玩家数量无效
• ✅ 完整生命周期（创建 → 启动 → 完成）
• ✅ 错误处理

______________________________________________________________________

🎯 快速导航

刚加入这个项目吗？\ → 首先开始 游戏会话/INDEX.md

需要启动API吗？\ → 查看 游戏会话/快速入门指南.md

对建筑感兴趣吗？\ → 阅读 game-sessions/ARCHITECTURE.md 翻译为中文是：游戏会话/架构.md

想扩展这个系统吗？\ → 关注 game-sessions/EXTENDING.md（可译为：游戏会话/扩展指南.md 或 根据上下文具体翻译为“游戏会话/扩展说明.md”等）

______________________________________________________________________

✨ 亮点

典范建筑

• 游戏规则的模式策略
• 图案工厂用于创作
• 到处都是依赖注入
• 职责划分完美

职业品质规范

• 完整的XML文档
• 强大的错误处理能力
• 集中业务验证
• 确保线程安全

详尽的文件记录

• 8份文件文档
• 视觉图表（流程图、类图、序列图）
• 实用指南（启动、扩展）
• 具体实例

______________________________________________________________________

🎓 学习

这个项目是一个 参考；引用 为了：

• 在实践中应用SOLID原则
• 构建专业的REST API
• 使用现代设计模式
• 编写可维护和可扩展的代码
• 全面记录一个项目

______________________________________________________________________

🏆 结果

与（某人/某组织）共同开发的项目 典范建筑 展示对原则的掌握 SOLID（注：SOLID通常指的是一组面向对象编程的原则，即单一职责原则、开闭原则、里氏替换原则、接口隔离原则和依赖倒置原则，但在此处作为独立词汇翻译时，可保持原样或根据上下文具体解释） 和 清洁代码。

✅ 准备好投入生产\ ✅ 易于维护\ ✅ 翻译为中文是：“✅”（这个符号本身在中文中没有特定的含义，通常用于表示正确、确认或完成，具体含义需根据上下文判断）。如果直接翻译这个符号，可以保持原样，或者根据上下文解释其含义。例如，在表示正确或确认时，可以说“正确”或“已确认”。 易于扩展\ ✅ 完全记录在案

______________________________________________________________________

📞 更多信息

1. 查阅 INDEX.md（文件名，可译为“索引文件”或保持原样，根据上下文决定是否需要翻译文件名） 以进行完整浏览
2. 阅读 ARCHITECTURE.md 翻译为中文是：“架构.md”（文件名，表示这是一个关于架构的Markdown文件） 为了理解技术选择
3. 探索 DIAGRAMS.md 翻译为中文是：“图表.md”（其中，“.md”表示这是Markdown格式的文件） 以可视化架构
4. 关注 扩展说明.md 以添加您自己的格式

______________________________________________________________________

🎉 准备好开始编码了！

该项目是 编译， 测试过的 和 有文件记录的。\ 利用SOLID架构，轻松实现扩展！ 🚀

首先开始 游戏会话/INDEX.md 以便在整个文档中进行导航。