Repository navigation
全栈:全面移除租户与 AppId,收敛为单游戏 ServerId 后台(C406 / GFX-1232) - #26
Merged
Merged
Conversation
按 C406 D8 删除仅服务旧库迁移的工具目录;slnx 未引用该项目,无需调整。 Linear: GFX-1232
按契约 §3/D2 执行:Token 删除 Tenant 成分并修正大小写;命名空间段 Tenant→Business; 边界 Attribute 改 BusinessTable;删除撞名零引用的 TenantFileResponse、TenantRoleResponse。 本提交点 build 尚未修复(BusinessTableAttribute 待 D3 批次新增),已按契约 §3 通知节点提交。 Linear: GFX-1232
C406 D10:移除 TenantReadActionClassifier 及其测试(租户过期读放行 门禁已退场,仅剩测试在用);MiddlewareResponseWriter 删除无调用方 的 errorCode 可选参数(唯一消费者 TenantErrorCode.TenantDisabled 已 随租户机制退场),Code 恒为 HTTP 状态码,并改写 XML 注释中的租户 中间件列举。 Linear: GFX-1232
删除前端数据库 TenantId 列入口、租户绑定显示和租户生命周期选项,清理请求表单中的 AppId 语义。同步五语登录、策略、活动和首页文案,保留区服与 GameApp 业务语义。\n\nLinear: GFX-1232
移除已退场的 Client.Api 租户与应用关联正向测试,并同步登录夹具和落地页注释。\n\nLinear: GFX-1232
C406:删除多租户与应用作用域描述,改为超管/管理员两套身份、
ServerId 唯一运营范围、单主库(system_/global_/无前缀)、
{packageId} 回调、旧库拒绝启动与无迁移工具的断代口径;
快速开始登录去掉租户号,移除租户管理与已退场机制的功能行与截图引用。
Linear: GFX-1232
新增 GameFrameX.Entity.Routing.BusinessTableAttribute;SqlSugarEntityBoundary 业务前缀改为空并跳过空前缀剥离,删除 IsExternalSpecificTable、RequiresTenantContext 与 SqlSugar [Tenant] 分支;修复撞名:defaultRow、Id 重复成员、tenantId 参数、 RequiresContext 断言、globalChannel 变量。 Linear: GFX-1232
依赖流与目录改为 Application.Business;删除 migrate-default-instance 升级说明(D8 已删迁移工具);服务清单与机器通道中间件按 C406 终态 改写;短 ID 发布口径收敛为单主库清空重灌。 Linear: GFX-1232
删除已退场的 useCurrentApp / appWorkspace / targetTenant / config-app-scope-picker / appCenter 等陈旧目录树条目与 「应用作用域(多租户)」整节;请求拦截改为全局区服选择器 ServerId。 Linear: GFX-1232
GFX_TENANT_SECRET_ENC_KEY → GAMEFRAMEX_SECRET_ENCRYPTION_KEY (D2.3),移除默认租户库自动推导注释;docker compose config -q 校验通过。 Linear: GFX-1232
示例整体围绕 HubTenantMiddleware 与 GameFrameX-Tenant-Id 头构建, 对应机制已随 C406 删除,无法去租户化改写。 Linear: GFX-1232
C406 D9:删除 TenantErrorCode 全枚举(30600001-30600015,生产代码 零引用);ErrorSegmentRegistry 段 306 注销并标记号段永久保留禁止 复用(同 308/315/316 先例);AdminEnumVisibilityTests 豁免清单同步 收缩。EnumContractTests 哈希无需更新:该契约只覆盖 Entity 程序集 公开枚举,错误码枚举位于 Core 程序集,不在其扫描范围。 Linear: GFX-1232
组织与岗位机制已退场且枚举零生产引用,删除 OrganizationErrorCode (段 307)与 PositionErrorCode(段 309)并注销号段;删除零引用的 GameHomeErrorCode.TenantContextRequired(60500001,纯租户上下文 语义)与 OpenAccessErrorCode.AppNotFoundOrNotOwned(31300002, 租户归属语义);BoundUserNotFoundOrNotOwned 文案收敛为纯存在性 语义。AdminEnumVisibilityTests 豁免清单同步收缩。 Linear: GFX-1232
CacheConst.KeyTenant 与 KeyUserOrganization 无任何消费方(组织机制 已退场),按 D1 处理原则删除。 Linear: GFX-1232
C406 D2.3:GmCenter 五处注释中的「仅同步 TenantAdmin」统一改为 「仅同步管理员角色」;核查确认无逻辑依赖租户管理员角色概念 (ShouldSyncToRole 无生产定义、无 TenantAdmin 角色种子)。 Linear: GFX-1232
删除 GlobalMenuEntity.AppScope、MenuAppScopeEnum、全部种子 AppScope 赋值、 MenuSeedDefinition/Catalog 校验、GlobalMenuResponse 与 SystemMenuMetaResponse 输出; 删除 LogDiffFields/LogVisitFields 的历史租户标识列(原 TenantId,机械改名后为 Id); 对应 schema 演进与初始化测试同步收口。EnumContractTests 哈希随后统一重算。 Linear: GFX-1232
C406 D7:新增 LegacySchemaStartupGuard,AddSqlSugar 初始化循环内在 建库建表种子之前 fail-closed 检查旧 schema 标志(tenant_ 前缀表或旧 租户登记表 system_tenant_entity),命中即抛中文错误终止启动(2.0 不支持旧库升级,只能用新库或整体回滚),不建表不写数据。守卫覆盖 仅 Web.Api 装配路径;Client/Hub 不建表无需守卫(设计说明见 notes-core.md §3)。测试:预建 tenant_ 表初始化抛错且无新表、登记 表标志抛错、空库正常初始化、装配顺序源码守护。 Linear: GFX-1232
C406 身份收口:真实 PlatformJwtTokenService 签发链路(SQLite 配置行 + PlatformJwtRuntimeProvider)签发 AccessToken 并解码,断言 claim 全集 恰好为身份四项(UserId/Account/RealName/AccountType)加签发框架项 (iat/nbf/exp/iss/aud/platform_jwt_version),防止签发层私自加回 租户或应用作用域 claim。 Linear: GFX-1232
删除旧回调路由兼容重建,统一单分包回调地址;请求旧作用域字段按未知字段处理并改用出站业务白名单。移除校验器旧参数和测试数据库替身,配置读取统一使用主库客户端。\n\nLinear: GFX-1232
Web.Api 隔离实例(SQLite / 端口 21104)导出 swagger.json; pnpm gen:api 重新生成 src/api/**:tenant* 目录更名为去前缀目录 (tenantUser→user 等 3 组 6 删 6 增),88 文件同步。 Linear: GFX-1232
重算 EnumContractTests 哈希;重生成端点金标(仅命名空间段变化,路由条数不变); 边界测试改业务表无前缀口径;删除 TenantId/AppScope 主题消失的断言; 修正 defaultRow 关键字撞名与 GFX741 清理顺序期望。 Linear: GFX-1232
恢复 userId 与 accountId 身份覆盖字段的拒绝逻辑,忽略租户和应用旧字段并验证刷新请求线缆。\n\nLinear: GFX-1232
将旧回调路由测试改为只验证三段路径 404 与旧上下文字段不解析,移除已经失去主题的正向租户路由用例。\n\nLinear: GFX-1232
为改名脚本保留公开回调、登录令牌、商城和游戏服线缆测试中的旧字段断言。\n\nLinear: GFX-1232
为 Hub HMAC、解密、配置响应和旧上下文安全测试标记有意保留的旧字段样本。\n\nLinear: GFX-1232
v2 按 R1 a-f:泛化词守卫(TenantId/tenantDb/KeyTenant 等剩余部分为泛化词的 token 不改并登记 semantic-residue.tsv)、循环删除并转移大小写、token 边界 精确覆盖、c406-keep 与 keep-paths 豁免、小写裸词只报不改、双跑幂等。 经临时基点 worktree(689ceda8 + v2 = T2)构造 v1→v2 修正补丁三方应用, 9 个冲突文件取本分支版本(D10 已删的日志字段与已改写的测试); 重新删除撞名死代码 TenantFileResponse/TenantRoleResponse,清理 .gitignore 迁移目录反排除残留。生产语义残留(tenantDb/TenantId 等)移交 H/C 处理。 Linear: GFX-1232
Application 四个文件的 tenantDb 局部变量改为 mainDb(R1-a 泛化词守卫命中项, P0 按归属消歧);SystemDatabaseService 边界错误文案改为无前缀业务表口径。 Linear: GFX-1232
清理支付配置测试中指向已删除回调测试类的说明,避免保留失效的测试名称引用。\n\nLinear: GFX-1232
记录游戏服请求完整 URI,确保身份覆盖回归同时验证 body 与 query 不含旧作用域字段。\n\nLinear: GFX-1232
为 userId 与 accountId 身份覆盖字段补充逐项安全语义说明。\n\nLinear: GFX-1232
AdvertisementCallbackConfigEntity 新增必填 PackageId(引用 GameAppPackageEntity.Id), 同一 (PackageId, Provider) 未删除配置唯一性由服务层强制(软删除不加库级唯一约束); 表行数量级为分包数×平台数,解析查询全表扫描成本可忽略,不另建查询索引。 GameAdvertisementRewardEntity / GameRoleAdvertisementEntity 同步新增 PackageId, 记录验签所选配置与回调命中的分包,保证奖励与审计的 packageId 一致可追溯; 仅新装生效,不回填历史行(默认 0)。 新增段 318 广告回调配置错误码与 PackageProviderAlreadyExists(31800001,中英双语文案)。 Linear: GFX-1232
新增/更新必填 PackageId(正数守卫且分包必须存在并启用),重复 (PackageId, Provider) 以新错误码 31800001 拒绝;分页支持按 PackageId 过滤,Response 回带 PackageId。 包名不在 Response 投影:沿用本页惯例由前端用分包下拉数据源解析标签,避免服务端联表。 Linear: GFX-1232
- 新增 InitialAdminBootstrap:sys_admin 角色创建 + 非超管种子菜单只补不删授权 + 双环境变量引导首个 UserEntity(Argon2id) - Web.Api 仅在主库守卫/建表/种子之后经 HostedService 执行(密码策略加载后注册) - 弱密码 fail-closed,日志不含口令;账号已存在/变量单设/全未设输出对应警告
- docker-compose.yml / docker-compose.admin.yml web-api 环境透传 GAMEFRAMEX_ADMIN_INITIAL_ACCOUNT / _PASSWORD(无默认口令) - .env.example 增加成对变量注释段 - Api README 部署章新增「首次部署:超管密码与首个业务管理员」小节;Vue README 快速开始说明首装账号来源
四条广告回调路由改为必填 {packageId:long},缺段请求路由层 404;解析器保留
「广告回调必须包含 packageId」纵深防御分支。GetAdvertisementCallbackOptionsAsync
按「路由 packageId + provider + IsEnabled」取配置,零条或多条命中一律拒绝(fail-closed),
不回退最新一条也不回退全局。奖励账本与角色广告事实的 PackageId 与所选配置一致,
缺路由 packageId 时跳写不落 0 哨兵。补 31800002/31800003 错误码并按 S6 规范
替换服务内两处裸中文抛错(快照 7→6);实体列补 DefaultValue;新增六场景
分包绑定闭环测试与端点矩阵路由同步。
Linear: GFX-1232
两宿主在数据库客户端建立后立即调用 LegacySchemaStartupGuard.EnsureNotLegacySchema, 与 Web.Api 同口径 fail-fast(三宿主统一,Medium 修复)。守卫只读表清单, 两宿主不做 CodeFirst。补组合级测试:按宿主真实组合 AddSqlSugarClientService + 守卫,旧 schema 抛错终止、干净库放行; 生产装配顺序以源码顺序断言守护(端到端装配在测试进程不可行, 雪花单例拒绝二次初始化,与 Web.Api 守卫测试同口径)。 Linear: GFX-1232
- notes-core.md(新建):F3 设计、只补不删依据、改动文件、测试清单、闸门 1728/0/6、集成轮接线说明 - D13 残留白名单登记 InitialAdminBootstrap.cs 的 SqlSugar 原生 AsTenant API(同 D2.5 先例)
错误码枚举按 C263 口径属协议层内部契约(服务端出站 + 码表由本地化 JSON 导出), 不进 Admin 前端业务枚举下拉,登记 NonAdminEnums 白名单。 Linear: GFX-1232
EditDialog 加必填分包选择器(复用 gameAppPackage Select 接口,选项 value 取响应 id), 列表页加分包列与分包搜索条件,提交与编辑回显带 packageId。 crud-roundtrips 新增广告配置专项闭环:先选分包再提交,编辑断言分包与回调 URL 回显。 重新导出 openapi 并生成客户端;318 段错误码五语文案同步 (zh-tw/ja/ko 覆盖层 + sync:errorCodes 产物)。 跨页选择器权限沿用既有约定(协调者裁定):不补按钮不加白名单, 系统性 403 问题登记 notes-hosts F2 后续项。 Linear: GFX-1232
Linear: GFX-1232
Linear: GFX-1232
Payment/** 目录级 glob 违反 R2-a,按实际命中收窄为 8 个具体文件(微信/支付宝协议原生 AppId/appId);residual-scan 在最终树上 174 处命中全部登记(第 1 轮收尾提交晚于最终扫描,e2e 专项与协议用例 12 处未登记,按 D12 负向断言口径补 c406-keep 登记)。 Linear: GFX-1232
G 复验指出 2 处中文残留未登记(channelDefinition.ts:1、useDashboardData.ts:39),语义上并非旧作用域概念,直接改写而非登记例外。 Linear: GFX-1232
R6:sys_admin 角色与全部非超管菜单授权由 Web.Api 首启种子引导完成,删除 admin-menu-fixture 的 role/grantMenu 主动授权例外(AGENTS.md 描述随后同步);文件更名 admin-stack.ts,只保留隔离栈守卫与信封字段读取。合服复核人改为引导出来的 admin 在「账号管理」真实界面创建并重置口令(产品路径),凭证经 setup 写入 state 文件,不再直接写库建号。 Linear: GFX-1232
#21:删除第 1 轮遗留的未用 API 录制导入(eslint no-unused-vars 两处),e2e 静态检查自本提交起真实全绿。新增 (h) 引导管理员首启表单登录九根、(i) 广告回调验签页界面选分包与编辑回显加回调地址单 packageId 形态、(j) 同 provider 双分包跨包密钥 601 拒绝与缺分包 404。crud 广告闭环菜单标签改为侧边栏实际文案「广告回调验签」(F2 引入时按种子 Title 写成「广告回调配置」,浏览器回归才会暴露)。 Linear: GFX-1232
重新生成 text-baseline:238 → 242,新增 4 条全部来自 F2 广告回调验签页分包选择器文案,与 30cbf14 对比逐条对应 R5。 Linear: GFX-1232
F3 只同步了 zh-CN;en/ja/ko/zh-TW 的 Api 部署章与 Vue 快速开始各补 GFX_SUPERADMIN_INITIAL_PASSWORD 与 GAMEFRAMEX_ADMIN_INITIAL_ACCOUNT/_PASSWORD 的职责与生效条件说明。 Linear: GFX-1232
F4 #22:provider 为空时不再跳过 provider 过滤退化为「该分包唯一配置」兜底选取,直接返回 null;补「packageId 有值 + provider 为空 → null」用例。 Linear: GFX-1232
F4 #24:S2 Probe9 证实 sys_admin 被删除的种子菜单授权会在重启时补回(模板角色手工授权不持久,C353 口径)。改正 XML 注释与日志措辞:需要收窄权限时新建自定义角色,不要直接改 sys_admin。 Linear: GFX-1232
F4 #23:WechatReturnCodeEnum 的 5 处原生 APPID/Appid 字段(D2.5)与 errors 五语 99999999 镜像译文(R3-a)登记备查;大小写变体与中文译文不在 ASCII token 扫描范围,登记为文档性例外(D13 仅收录 en.ts 的原因同此)。 Linear: GFX-1232
浏览器回归暴露(F2 引入):后端 long 序列化为字符串(openapi packageId type=string),分包选项 value 为数字,回显时 v-model 字符串匹配不到选项、选择器显示占位符。beforeOpen 统一 Number 归一化。 Linear: GFX-1232
浏览器回归暴露:分包 Select 选项 label 是「包名 / 版本」而非实体 Name;(PackageId,Provider) 唯一约束要求失败重跑前清理残留配置;缺 packageId 的 404 需带 X-Proto-Ver(协议守卫先于路由);开放接入绑定用户选项文本随引导账号真实姓名变化,改按账号前缀匹配。 Linear: GFX-1232
F4 #26:新装 platform_password_policy_config 默认 strongPassword=false(不做强度校验);开启后要求 6–16 位且含大小写字母、数字与特殊字符。五种语言的首次部署章节与 Vue 快速开始各补一句,建议初始密码按该规则设置并在上线前开启策略。 Linear: GFX-1232
R6/R7:admin 账号与 sys_admin 菜单授权改由首启种子引导,删除 admin-menu-fixture 的 role/grantMenu 授权例外描述,改为 admin-stack 守卫与信封读取、复核人经账号管理界面创建;crud-roundtrips 补 F2 广告分包闭环说明;e2e-integration-checks 补 h/i/j 三项断言。仅同步 e2e 用例文件名与条目数,定位描述归 D。 Linear: GFX-1232
WalkthroughWarning Review details and warnings were omitted to fit the comment limit. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
问题与变更概要
GameFrameX Admin 此前已收敛为单游戏管理后台,但仓库内仍完整保留租户系统与
AppId作用域:身份模型带租户 Claim,数据库带租户库登记与tenant_前缀业务表,接口契约(登录 / JWT / OpenAPI / 回调 URL)带租户与应用段,Client.Api / Hub.Api 的线缆与验签按租户/应用选配置,前端残留租户与应用切换面。这部分 SaaS 复杂度没有业务价值,却持续抬高权限边界、选库逻辑与回调契约的出错面。本 PR 执行一次破坏性收口:物理删除租户与
AppId的产品面、运行时、数据结构、接口契约和前端内容,只保留ServerId作为唯一的运营范围。不提供旧版本兼容层,不迁移旧租户数据,不保留历史租户记录。核心结果:
ServerId及各业务确实需要的资源标识(PackageId仅在版本、资源包、支付或回调业务仍需要时保留,不再表示应用归属)。system_user_entity([PlatformTable]),管理员user_entity([BusinessTable])。登录表单仅账号 + 密码,登录与 JWT 不再包含租户和应用字段。tenant_前缀;表归属由三种边界 Attribute 决定——system_([PlatformTable])、global_([GlobalTable])、业务表不加前缀([BusinessTable])。tenant_前缀表或旧租户登记表system_tenant_entity),命中即拒绝启动、不建表不写种子;没有迁移脚本,回滚只能整体恢复数据库备份与部署产物。GAMEFRAMEX_ADMIN_INITIAL_ACCOUNT/_PASSWORD),绑定sys_admin并授予全部非超管种子菜单;sys_admin的种子授权只补不删。AdvertisementCallbackConfigEntity.PackageId必填、(PackageId, Provider)服务层唯一;回调按「路由 packageId + provider + 启用」精确命中,零条或多条一律拒绝,provider 为空失败关闭;公开回调地址只有{packageId}一种形态。LegacyScopeResidualGuardTests(内容扫描 + git 路径扫描 + 白名单格式),白名单LegacyScopeResidualWhitelist.tsv逐 token 精确放行。执行方式
本 change 采用六角色并行 + 分轮集成 + 分批修复的方式执行,跨角色边界与合并协议在
gfx-doc/dev/version-2-0/archived/C406-tenant-appid-total-removal/orchestration/parallel-contract.md中固化。关键提交与合并点
合并点:
1b00d15192a17cc3ebc5568e4aa1d9c737ff5297938ecf9c关键提交:
ed0072c1(处置生产 residue)、6beae9d9(旧库拒绝启动守卫)、9b913f34(删菜单AppScope列与日志TenantId字段)、63078fdd(D3 业务归属与物理表名收口)、689ceda8(删除db/single-main旧库迁移工具)、74e897f5/4fe31c04/ea7e4110/2561cc48(死代码与退场错误码清理)。5d30f913(后端全量机械去 Tenant)、84350812(改名脚本 v2 修正 v1 泛化词损伤)、88addcbc/8b9dcc91/8c9d3b78(Vue 与 H 侧改名脚本)、d7daa623(R4 目录遗留迁移)、b764ddf6(回调与游戏服线缆语义收敛)。53bf358c(清除租户与应用作用域语义)、ff9d9568(清理旧 e2e 夹具)、56c0390e/766bc842(重导 openapi 并重新生成 API 客户端)、0185cd13(错误码 overlay 补齐与五语同步)、da187498(合并后检查项收口)。64cecc73(落地 D13 残留阻断测试)、0cea583d(守卫旧表名行加c406-keep标注)、701e8308(平台 JWT 签发 claim 集合精确断言)。f939bd0a(仓根 README 与 AGENTS 改写为单游戏后台定位)、4d57c7c0/e69de1aa(前后端五语 README)、d2aedb00(凭证加密密钥改名并删除租户库注释)、9ad7565d(删除依赖已退场租户中间件的 Tapd 示例)。30cbf141(集成第 1 轮终态)、144c9416(开放接入 scope 选项对齐 Hub 路由前缀)、cdc8809a(集成第 2 轮)、09303e20/0c68243b/eaf1f6cd/506e76cc/b9f90e29(F2 广告分包绑定与三宿主旧库守卫)、d7e5897a/ab744a55(F3 种子引导)、5b96e1ed/b695adaa/0570e822/12618b1d/cb7988fc(F4 收尾五项)、a1339f56/c8e6deab(回归暴露的广告编辑回显与 e2e 夹具修正)。4dd0afe0(doc(agents): 同步 e2e 夹具与集成断言描述)。验收结论
协调者独立验收共 3 轮,第 3 轮 PASS(记录:
gfx-doc/dev/version-2-0/archived/C406-tenant-appid-total-removal/orchestration/verify-record.md,唯一结论来源)。c406-<字母>-*截图dotnet buildRC=0;dotnet test共 1750,通过 1744 / 失败 0 / 跳过 6check-permission-keys/check-i18n-keys/check-error-codes全 RC=0git ls-files | grep -i tenant0 命中2026-11-06T15:28:23Z晚于最后一个代码提交 15:24:26Z;被测 SHA =4dd0afe0范围补充及依据
f92b915f就存在。经 B佬裁定在本 change 内修复:AdvertisementCallbackConfigEntity.PackageId必填、(PackageId, Provider)服务层唯一、回调按「路由 packageId + provider + 启用」精确命中、零条或多条一律拒绝、provider 为空失败关闭;同时统一三宿主旧库守卫。37ff5297;浏览器 (i)(j)GAMEFRAMEX_ADMIN_INITIAL_ACCOUNT/_PASSWORD首次启动创建业务管理员并绑定sys_admin、授予全部非超管菜单;e2e 删除直接写库建 admin 的例外。938ecf9c;浏览器 (h)gameAppPackageSelect 接口,沿用 9 个既有页面的跨页选择器约定(不加种子按钮、不加[AuthenticatedOnly]、不建代理端点),靠管理员角色拥有全部非超管菜单放行。「自定义角色只授予部分页面时跨页选择器 403」属系统性问题(影响 10 个页面),记为 C406 外后续项。PackageBuildReport/FeatureSwitchSync)。144c9416升级影响(破坏性)
tenant_前缀表或旧租户登记表system_tenant_entity即 fail-fast,输出中文提示「检测到旧版多租户数据库架构…2.0 不支持旧库升级,只能用新库或整体回滚」,不建表、不写种子、不写数据。tenant_前缀:如tenant_game_user_entity→game_user_entity;global_menu删app_scope列;system_log_*删tenant_id列。Code First 仅对新库初始化。GFX_TENANT_SECRET_ENC_KEY→GAMEFRAMEX_SECRET_ENCRYPTION_KEY(代码 / compose /.env.example/ CI 四处一致)。GAMEFRAMEX_ADMIN_INITIAL_ACCOUNT/GAMEFRAMEX_ADMIN_INITIAL_PASSWORD(成对设置才生效,用于新装引导首个业务管理员);GFX_SUPERADMIN_INITIAL_PASSWORD保持不变。{packageId},广告配置必须选分包:广告回调路由的{packageId}段必填,缺段 404;验签配置必须绑定分包,同一(分包, Provider)唯一。{tenantId}/{appId}/...回调路径一律 404:不重建、不静默兼容;旧的tenantId/appId/gameAppId请求字段一律按未知字段忽略。X-Proto-Ver协议头(缺失 400),旧GameFrameX-Tenant-Id/GameFrameX-App-Id/GameFrameX-App-Secret头无读取方;Hub 机器通道只认Signature: v2;{accessKey};{ts};{nonce};{sig}HMAC 单头。sys_admin的种子授权只补不删:运营在管理端删掉的种子授权,下次重启会被补回(模板角色的手工授权不持久)。需要收窄权限时新建自定义角色,不要直接改sys_admin。platform_password_policy_config默认strongPassword=false(不校验);开启后要求 6–16 位且含大小写字母、数字与特殊字符,建议初始密码按该规则设置并在上线前开启。后续项(不阻断)
OnlineErrorCode镜像码收口:CrossTenantDenied/CrossAppDenied(32200002 / 32200003)由游戏服协议方收口。GAMEFRAMEX_*,存量是GFX_*(GFX_SUPERADMIN_INITIAL_PASSWORD、GFX_MAIN_DB_*、GFX_HUB_*)。sys_admin的种子授权「只补不删」:需要收窄权限时请用自定义角色,不要直接改sys_admin。StrongPassword开关(已在 README 写明默认状态)。samples/下的 Tapd 示例已删除:可从f92b915f:samples/取回。Refs: GFX-1232
Closes #24