Skip to content
  •  
  •  
  •  
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@
* Wrapper 生成器崩溃止血与不可编译产物清理(C431,GFX-1171,GitHub #917):`[TimeOut]` 实参防御式解析(仅数值字面量可静态求值——常量名/缺参/空参/表达式/下划线开头的常量名输出 Error 诊断并降级为框架默认超时,不再令生成器整体崩溃丢失全部 wrapper);`GetFullName` 重写为向上收集命名空间与嵌套类型段(无命名空间代理返回类型链短名,顺带覆盖 struct/enum 容器形态);`Tools.GetNameSpace` 取真命名空间(首个 `+` 前最后一个 `.`,无命名空间返回空串且不发射空 using),嵌套代理基类改容器限定名 `Outer.Inner`、wrapper 类名携带容器链(同命名空间同名代理不再碰撞);partial 合并键升为完全限定名(跨命名空间同名无关类不再产生幽灵 Wrapper);async 被包装方法统一 `return await`(修复非泛型 `async Task`/`async ValueTask` 生成体不可编译);含 `ref/out/in` 参数与 `[Discard]` 返回类型非 Task/ValueTask(按类型名最后一段比较,全限定名不误报)的方法报 Error 且不进入生成面(校验先行);`[Discard]` 非 ThreadSafe 入队 lambda 改 `async ()=> await` 统一绑定 `EnqueueAsync(Func<Task>)` 重载(ValueTask 一次性消费契约不再被违反)。新增 16 例生成器测试(含独立审查 R1/R2/R3 修复钉住),既有 3 例 Discard lambda 断言随契约更新。

### Added
* 黄金路径默认开箱即通(C460,GFX-1195,GitHub #959):`OnlineLeaderboardProjectionOptions.MatchSettledBoardId` 默认值由空白(不投影)改为默认榜常量 `match-settled`(`OnlineLeaderboardProjectionOptions.DefaultMatchSettledBoardId`)——零 Online JSON 配置起服即装配 Match.Settled 投影、激活期预建默认榜,RPS 对局→结算→Grant 发奖→上榜全链默认贯通;显式置空白 / null 或配置段覆盖为空白仍可关闭投影(不装配、不预建、不报错)。`OnlineCompetitionOptions.Validate` 补投影组合校验:`LeaderboardProjection` 须为非 null 对象,榜单标识非空白(投影开启)时长度 ≤128 且不得含空白字符(装配期 fail-fast,全部问题一次报全)。端到端验收以可重跑 xunit 钉住(GameFrameX.Tests 零 Settings 组合全链 + Hotfix.Tests 桥断言:好友桥→撮合桥→对局桥→默认榜条目),`Configs/app_config.json` Game 角色移除 `Online.Settings` 空节依赖。
* 行版本条件写内存管线收口共享助手(C409,GFX-1117):新增 `GameFrameX.DataBase/Abstractions/RowVersionCasWriteHelper` 与 `RowVersionBackfillWriteHelper`——`UpdateIfRowVersionAsync`(CAS)与 `UpdateIfRowVersionIsNullAsync`(回填)两原语在 Mongo/PostgreSQL/SQLite 三 Provider 重复的内存侧样板(Id 一致性校验、版本对齐 + checked 递增、写库前 `ToBytes()` 快照、失败回滚 / 成功精确提交)收敛为单一事实源,Provider 仅保留谓词 / 语句 / 重试外壳等写库差异;语义零变化(失败回滚、异常不回滚、`long.MaxValue` 溢出写库前抛出、SQLite null 守卫现状均冻结),回归依托 `DatabaseConditionalWritePrimitivesTests` 既有套件。
* 服务器间 RPC 端点改由心跳注册表解析并退役静态引导(C304,GitHub #643):`RemoteServiceTarget`(ServerType + 可选 InstanceId)结构化拨号取代 `{Role}_{InstanceId}` 字符串拼接;`DiscoveryServiceEndpointResolver` 成为唯一端点解析器(指定实例走 Instance 视图含 Draining 并校验 Role 一致,ServerType 级取 Active 中 InstanceId 序数最小者,端点集合 = TCP 主端点 + 附加端点,偏好 kcp > ws > wss > tcp);`RemoteMessagingBuilder.WithRouteTable(IRoleRouteTableProvider)` 绑定路由表、生产注册 KCP 拨号适配器(`IsEnableInnerKcp` 时,服务器间 KCP 首次生产可用);心跳新增附加广播端点(`InstanceDescriptor.AdditionalAdvertiseEndpoints`,监听器装配成功的实例级闸门后才广播,多 ServerType 进程非首选类型披露 Warning);`UnifiedMessageSender` 实例列表改读路由表 Active 视图且仅 InstanceId 集合变化才重建哈希环;玩家路由实例直达——`player_route.InstanceId` 写真实发现层实例 Id(`PlayerRouteResolverBootstrap` 同源注入),`ForwardToRemoteServerAsync` 按 `TargetInstanceId` 投递(Instance 视图含 Draining)、`IsCurrentServer` 改 InstanceId 比较;Mongo 心跳 class map 显式忽略未知字段(含继承传递)、写路径空集合归一化为 null(默认配置文档与旧版本逐字节同形);PostgreSQL 幂等补列 `additional_advertise_endpoints text[]`(命名经 `DiscoveryStorageNaming` 推导);删除 `services__*` 环境变量契约、`EnvironmentVariableEndpointResolver`、`EnvironmentServiceInstanceDiscovery`、`docker-compose.multi.legacy.yml` 与生成器静态引导映射。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -33,21 +33,11 @@ namespace GameFrameX.Capability.Hosting.Abstractions;
/// 能力宿主装配选项(本进程的运行时授权作用域身份 + 调度壳驱动参数;
/// 原 OnlineRuntimeOptions 作用域半边的机制承接位,admin 监听参数归 AdminApiOptions)。
/// <para>
/// 维护约束:三元组是本进程的服务端权威作用域(请求体作用域字段不可覆盖,跨租户/App/服请求拒绝)。
/// 维护约束:单键化 D4 后区服键是本进程的服务端权威作用域(请求体作用域字段不可覆盖,跨服请求拒绝)。
/// </para>
/// </summary>
public sealed class CapabilityHostOptions
{
/// <summary>
/// 获取或设置授权租户标识(必须为正数)。
/// </summary>
public long TenantId { get; set; }

/// <summary>
/// 获取或设置授权应用标识(必须为正数)。
/// </summary>
public long AppId { get; set; }

/// <summary>
/// 获取或设置授权区服标识(必须为正数)。
/// </summary>
Expand All @@ -59,12 +49,12 @@ public sealed class CapabilityHostOptions
public int SchedulerIntervalMilliseconds { get; set; } = 1000;

/// <summary>
/// 校验选项合法性(作用域三元组与调度间隔)。
/// 校验选项合法性(作用域区服键与调度间隔)。
/// </summary>
/// <returns>合法返回 <c>true</c>;否则 <c>false</c>(宿主不应在非法配置下启动)。</returns>
public bool IsValid()
{
if (TenantId <= 0 || AppId <= 0 || ServerId <= 0)
if (ServerId <= 0)
{
return false;
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,33 +30,19 @@
namespace GameFrameX.Capability.Hosting.AdminApi;

/// <summary>
/// admin 请求的声称作用域三元组(机制层不解释语义,判定由组合根注入的作用域适配器完成)。
/// admin 请求的声称作用域区服键(机制层不解释语义,判定由组合根注入的作用域适配器完成;单键化 D4 后仅区服位)。
/// </summary>
public sealed class AdminApiClaimedScope
{
/// <summary>
/// 初始化 <see cref="AdminApiClaimedScope"/>。
/// </summary>
/// <param name="tenantId">租户标识。</param>
/// <param name="appId">应用标识。</param>
/// <param name="serverId">区服标识。</param>
public AdminApiClaimedScope(long tenantId, long appId, long serverId)
public AdminApiClaimedScope(long serverId)
{
TenantId = tenantId;
AppId = appId;
ServerId = serverId;
}

/// <summary>
/// 获取租户标识。
/// </summary>
public long TenantId { get; }

/// <summary>
/// 获取应用标识。
/// </summary>
public long AppId { get; }

/// <summary>
/// 获取区服标识。
/// </summary>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -101,7 +101,7 @@ public static ICapabilityAdminApiPlane CreateAdminApiPlane(CapabilityHost host,
registry,
errorCodes,
scopeAdapter,
new AdminApiClaimedScope(host.TenantId, host.AppId, host.ServerId),
new AdminApiClaimedScope(host.ServerId),
idempotencyAdapter,
host.Report,
host.Services);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -167,13 +167,13 @@ public async Task<string> DispatchAsync(string action, string bodyJson)

if (!_scopeAdapter.TryReadClaimedScope(request, out var claimedScope))
{
return WriteFail(_errorCodes.ScopeMissing, "Scope triple (TenantId/AppId/ServerId) missing or invalid in request body.", requestId);
return WriteFail(_errorCodes.ScopeMissing, "Scope key (ServerId) missing or invalid in request body.", requestId);
}

var deniedCode = _scopeAdapter.ValidateClaimed(claimedScope, _authorizedScope);
if (deniedCode != null)
{
return WriteFail(deniedCode, "Scope denied for tenant " + claimedScope.TenantId + ", app " + claimedScope.AppId + ", server " + claimedScope.ServerId + ".", requestId);
return WriteFail(deniedCode, "Scope denied for server " + claimedScope.ServerId + ".", requestId);
}

if (registration.WrapIdempotency && _idempotencyAdapter != null)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -106,26 +106,20 @@ public string ReadIdempotencyKey()
}

/// <summary>
/// 提取客户端声称的作用域三元组(POST 请求体顶层 <c>TenantId</c>/<c>AppId</c>/<c>ServerId</c>,大小写不敏感)。
/// 提取客户端声称的作用域区服键(POST 请求体顶层 <c>ServerId</c>,大小写不敏感;单键化 D4 后仅区服位,
/// 客户端携带的租户位/App 位遗留字段一律忽略)。
/// </summary>
/// <param name="tenantId">输出:声称租户标识。</param>
/// <param name="appId">输出:声称应用标识。</param>
/// <param name="serverId">输出:声称区服标识。</param>
/// <returns>三元组完整提取返回 true;任一字段缺失或格式非法返回 false(由调用方按作用域缺失拒绝)。</returns>
public bool TryReadClaimedScope(out long tenantId, out long appId, out long serverId)
/// <returns>区服键完整提取返回 true;字段缺失或格式非法返回 false(由调用方按作用域缺失拒绝)。</returns>
public bool TryReadClaimedScope(out long serverId)
{
tenantId = 0;
appId = 0;
serverId = 0;
if (Root.ValueKind != JsonValueKind.Object)
{
return false;
}

var hasTenant = TryReadInt64("TenantId", out tenantId);
var hasApp = TryReadInt64("AppId", out appId);
var hasServer = TryReadInt64("ServerId", out serverId);
return hasTenant && hasApp && hasServer;
return TryReadInt64("ServerId", out serverId);
}

/// <summary>
Expand Down
15 changes: 0 additions & 15 deletions Capability/GameFrameX.Capability.Hosting.Core/CapabilityHost.cs
Original file line number Diff line number Diff line change
Expand Up @@ -102,21 +102,6 @@ public sealed class CapabilityHost
/// </summary>
private readonly SemaphoreSlim _lifecycleGate = new(1, 1);

/// <summary>
/// 获取授权租户标识。
/// </summary>
public long TenantId
{
get { return Options.TenantId; }
}

/// <summary>
/// 获取授权应用标识。
/// </summary>
public long AppId
{
get { return Options.AppId; }
}

/// <summary>
/// 获取授权区服标识。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,8 @@ namespace GameFrameX.Capability.Online.Abstractions.Audit;
/// 统一审计内存存储(单进程默认实现;生产持久化实现归运行时装配)。
/// <para>
/// 维护约束:「EventId 判重 + 落档」在 <see cref="_gate"/> 锁内**同一临界区**完成(幂等半边的
/// 结构性保证);作用域索引键为 (TenantId, AppId) 两键——审计是跨区服检索域,区服过滤随查询载荷下推;
/// 每作用域维护按跨域检索全序(OccurredTime 倒序, EventId 序数升序)排列的有序索引,
/// 结构性保证);单键化(D4)后为单桶全序索引(无作用域分片键)——审计是跨区服检索域,区服过滤随查询载荷下推;
/// 维护按跨域检索全序(OccurredTime 倒序, EventId 序数升序)排列的有序索引,
/// <see cref="AppendAsync"/> 在同一临界区内同步插入(只插不删——记录只追加不淘汰,
/// EventId 全局唯一保证键无重复);出入参防御性拷贝(持久化行语义,调用方引用不得别名存储内部状态)。
/// </para>
Expand Down Expand Up @@ -69,10 +69,11 @@ public sealed class InMemoryOnlineAuditStore : IOnlineAuditStore
private readonly HashSet<string> _knownEventIds = new(StringComparer.Ordinal);

/// <summary>
/// 作用域级有序索引(键 = "TenantId|AppId";值 = 按跨域检索全序排列的落档记录,
/// 正序枚举即 (OccurredTime 倒序, EventId 序数升序)——检索与游标定位的唯一排序事实来源)。
/// 全序有序索引(按跨域检索全序排列的落档记录,
/// 正序枚举即 (OccurredTime 倒序, EventId 序数升序)——检索与游标定位的唯一排序事实来源;
/// 单键化 D4 后无作用域分片键,单桶承载全部落档记录)。
/// </summary>
private readonly Dictionary<string, SortedList<OnlineAuditSortKey, OnlineAuditRecord>> _recordsByScope = new(StringComparer.Ordinal);
private readonly SortedList<OnlineAuditSortKey, OnlineAuditRecord> _records = new(OnlineAuditSortKeyComparer.Instance);

/// <summary>
/// 追加一条审计记录(锁内判重 + 落档 + 有序索引插入同一临界区)。
Expand All @@ -94,24 +95,17 @@ public Task<bool> AppendAsync(OnlineAuditRecord record, CancellationToken cancel
return Task.FromResult(false);
}

var scopeKey = BuildScopeKey(record.TenantId, record.AppId);
if (!_recordsByScope.TryGetValue(scopeKey, out var bucket))
{
bucket = new SortedList<OnlineAuditSortKey, OnlineAuditRecord>(OnlineAuditSortKeyComparer.Instance);
_recordsByScope[scopeKey] = bucket;
}

bucket.Add(new OnlineAuditSortKey(record.OccurredTime, record.EventId), CloneRecord(record));
_records.Add(new OnlineAuditSortKey(record.OccurredTime, record.EventId), CloneRecord(record));
return Task.FromResult(true);
}
}

/// <summary>
/// 按查询载荷检索审计页:索引上二分定位起点后有界扫描,过滤 + keyset 游标 + 全序 + 页大小全部在本实现内完成。
/// </summary>
/// <param name="query">存储层查询载荷(作用域 / 过滤维度 / 已解码游标 / 页大小已由调用方校验)。</param>
/// <param name="query">存储层查询载荷(过滤维度 / 已解码游标 / 页大小已由调用方校验)。</param>
/// <param name="cancellationToken">取消令牌(内存实现无异步等待,令牌仅契约对齐)。</param>
/// <returns>按全序排列、至多 PageSize 行的结果页(行集为防御性拷贝);作用域外结构性不可见。</returns>
/// <returns>按全序排列、至多 PageSize 行的结果页(行集为防御性拷贝)。</returns>
public Task<OnlineAuditStorePage> QueryAsync(OnlineAuditStoreQuery query, CancellationToken cancellationToken = default)
{
if (query == null)
Expand All @@ -124,17 +118,14 @@ public Task<OnlineAuditStorePage> QueryAsync(OnlineAuditStoreQuery query, Cancel
var hasMore = false;
lock (_gate)
{
if (_recordsByScope.TryGetValue(BuildScopeKey(query.TenantId, query.AppId), out var bucket))
{
hasMore = CollectPageFromBucket(bucket, query, pageSize, records);
}
hasMore = CollectPageFromBucket(_records, query, pageSize, records);
}

return Task.FromResult(new OnlineAuditStorePage(records, hasMore));
}

/// <summary>
/// 在作用域索引上有界顺序扫描一页:游标起点定位后命中过滤即收,页满后再探到一行命中即判
/// 在全序索引上有界顺序扫描一页:游标起点定位后命中过滤即收,页满后再探到一行命中即判
/// HasMore 并停止;OccurredTime 低于时间窗起点即提前终止(全序倒序保证其后更旧,其后无更多行)。
/// 须在 <see cref="_gate"/> 临界区内调用(与追加共用同一索引快照);收入页行的均为防御性拷贝。
/// </summary>
Expand Down Expand Up @@ -174,17 +165,6 @@ private static bool CollectPageFromBucket(SortedList<OnlineAuditSortKey, OnlineA
return false;
}

/// <summary>
/// 构造作用域索引键("TenantId|AppId";审计是跨区服检索域,区服维度不进作用域键)。
/// </summary>
/// <param name="tenantId">租户标识。</param>
/// <param name="appId">App 标识。</param>
/// <returns>作用域索引键。</returns>
private static string BuildScopeKey(long tenantId, long appId)
{
return tenantId.ToString(System.Globalization.CultureInfo.InvariantCulture) + "|" + appId.ToString(System.Globalization.CultureInfo.InvariantCulture);
}

/// <summary>
/// 二分定位「严格位于游标位之后」的首个索引下标(keyset 语义;游标行自身若仍在档则被跳过)。
/// </summary>
Expand Down Expand Up @@ -311,8 +291,6 @@ private static OnlineAuditRecord CloneRecord(OnlineAuditRecord record)
Domain = record.Domain,
EventType = record.EventType,
OccurredTime = record.OccurredTime,
TenantId = record.TenantId,
AppId = record.AppId,
ServerId = record.ServerId,
PlayerId = record.PlayerId,
OperatorId = record.OperatorId,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -76,17 +76,7 @@ public sealed class OnlineAuditEntry
public long OccurredTime { get; set; }

/// <summary>
/// 获取或设置租户标识(必填,必须大于 0)。
/// </summary>
public long TenantId { get; set; }

/// <summary>
/// 获取或设置 App 标识(必填,必须大于 0)。
/// </summary>
public long AppId { get; set; }

/// <summary>
/// 获取或设置区服标识(0 表示 App 级操作——支付、远程配置等无区服维度的审计)。
/// 获取或设置区服标识(0 表示全局级操作——支付、远程配置等无区服维度的审计)。
/// </summary>
public long ServerId { get; set; }

Expand Down
Loading
Loading