feat(friend): 添加好友关系状态实体

新增 FriendRelationState 持久化实体，用于存储玩家间的好友关系。
采用双向设计（PlayerIdA < PlayerIdB）保证唯一性，支持软删除。

Author: AlianBlank

GameFrameX.Apps/Player/Friend/Entity/FriendRelationState.cs

@@ -0,0 +1,62 @@
+// ==========================================================================================
+//   GameFrameX 组织及其衍生项目的版权、商标、专利及其他相关权利
+//   GameFrameX organization and its derivative projects' copyrights, trademarks, patents, and related rights
+//   均受中华人民共和国及相关国际法律法规保护。
+//   are protected by the laws of the People's Republic of China and relevant international regulations.
+//   使用本项目须严格遵守相应法律法规及开源许可证之规定。
+//   Usage of this project must strictly comply with applicable laws, regulations, and open-source licenses.
+//   本项目采用 MIT 许可证与 Apache License 2.0 双许可证分发，
+//   This project is dual-licensed under the MIT License and Apache License 2.0,
+//   完整许可证文本请参见源代码根目录下的 LICENSE 文件。
+//   please refer to the LICENSE file in the root directory of the source code for the full license text.
+//   禁止利用本项目实施任何危害国家安全、破坏社会秩序、
+//   It is prohibited to use this project to engage in any activities that endanger national security, disrupt social order,
+//   侵犯他人合法权益等法律法规所禁止的行为！
+//   or infringe upon the legitimate rights and interests of others, as prohibited by laws and regulations!
+//   因基于本项目二次开发所产生的一切法律纠纷与责任，
+//   Any legal disputes and liabilities arising from secondary development based on this project
+//   本项目组织与贡献者概不承担。
+//   shall be borne solely by the developer; the project organization and contributors assume no responsibility.
+//   GitHub 仓库：https://github.com/GameFrameX
+//   GitHub Repository: https://github.com/GameFrameX
+//   Gitee  仓库：https://gitee.com/GameFrameX
+//   Gitee Repository:  https://gitee.com/GameFrameX
+//   CNB  仓库：https://cnb.cool/GameFrameX
+//   CNB Repository:  https://cnb.cool/GameFrameX
+//   官方文档：https://gameframex.doc.alianblank.com/
+//   Official Documentation: https://gameframex.doc.alianblank.com/
+//  ==========================================================================================
+
+namespace GameFrameX.Apps.Player.Friend.Entity;
+
+/// <summary>
+/// 好友关系状态。
+/// 存储两个玩家之间的好友关系，采用双向存储设计（PlayerIdA &lt; PlayerIdB 确保唯一性）。
+/// </summary>
+public sealed class FriendRelationState : CacheState
+{
+    /// <summary>
+    /// 玩家A的ID（较小者作为主键的一部分，确保同一对玩家只有一条记录）
+    /// </summary>
+    public long PlayerIdA { get; set; }
+
+    /// <summary>
+    /// 玩家B的ID
+    /// </summary>
+    public long PlayerIdB { get; set; }
+
+    /// <summary>
+    /// 关系创建时间
+    /// </summary>
+    public DateTime CreateTime { get; set; }
+
+    /// <summary>
+    /// 创建者ID（发起加好友的那个人）
+    /// </summary>
+    public long CreatedBy { get; set; }
+
+    /// <summary>
+    /// 关系状态：0=正常，1=被删除
+    /// </summary>
+    public int Status { get; set; }
+}