SAKURA FRAMEWORK · ENGINEERING HUB

从模块展示走向架构证据

以 Engine-Agnostic Core、显式生命周期、模块治理、工具链与 Consumer 验证为主线,展示 Sakura Framework 的架构判断与证据边界。

公开边界这里是 Engineering Portfolio、Architecture Case Study 与 Adoption Portal 的导航层;内容路由已闭合,但本地验证、Runner、Release 与 Production 仍按各自证据独立呈现。

D0 → D3

四层深度模型

先建立信号,再解释系统、架构取舍与证据边界。深度模型是阅读路径,不把未交付的深页包装成现状。

01

D0 · Signal

让访客在 10–30 秒内知道 Sakura Framework 是什么。

它解决什么问题?当前成熟入口与证据状态是什么?

Implemented
02

D1 · System

让读者在 1–3 分钟内理解 Framework 如何组成。

Core、Adapter、Runtime Services、Gameplay Kernel、Tooling、Governance 与 Consumer 如何连接?

Implemented
03

D2 · Architecture

解释关键设计为什么采用当前边界。

Ownership、Lifecycle、Dependency、Failure、Compatibility 与 Extension 的取舍是什么?

Implemented
04

D3 · Evidence

让读者区分代码存在、测试通过、Consumer 使用与 Production 证据。

哪些事实已在本地闭环?哪些 Runner、Release 或 Production 结论仍 Unknown?

Implemented

TEN ARCHITECTURE DOMAINS

从模块目录走向工程领域

十个领域均已连接真实深度页面;页面内容完成不改变其中 Framework 能力各自的 Local、Runner、Release 或 Production 状态。

01Implemented

Architecture & Governance

Package Identity、Layer、Dependency Policy、Capability Matrix 与验证入口。

打开深度页面

交付证据治理页已生成,并公开 Architecture as Code、失败模式、代价和适用边界。

02Implemented

Cross-Engine Architecture

Portable Core 与 Adapter 边界;Unity 是成熟路线,Godot 保持明确的 Preview / Deferred 边界。

打开深度页面

交付证据跨引擎页已生成,并保持 Foundation maturity 与专项 Adapter evidence 分离。

03Implemented

Runtime Lifecycle & Ownership

所有权、Scope、取消、清理与失败回退是运行时可维护性的主线。

打开深度页面

交付证据Runtime 页与 Lifecycle 旗舰案例共同覆盖正常、失败、取消和清理路径。

04Implemented

UI / Presentation Architecture

把 UI Core、Binding 与 Unity Presentation 的职责边界保持可解释。

打开深度页面

交付证据UI 页与 Paradigm-Neutral UI 案例已生成,证据保持 local-passed / runner-pending。

05Implemented

Gameplay Kernel & Semantic Systems

能力、规则、输入快照、存档与玩法语义优先以可迁移 Core 表达。

打开深度页面

交付证据Gameplay 页已生成,明确最小 Kernel 与 Consumer-owned content 边界。

06Implemented

Tooling / Developer Experience

安装、配置、诊断、校验与文档工具降低正确采用的成本。

打开深度页面

交付证据Tooling 页已生成,并连接 Card Balance、Runtime Console 与公开投影工作流。

07Implemented

Evidence Engineering

把本地测试、Runner、Consumer、Release 与 Production 分层,不跨级声明。

打开深度页面

交付证据Evidence 页已生成,八级 Ladder 与主题证据保持独立。

08Implemented

Consumer Validation

独立项目消费映射用于验证真实引用,不替代 Framework 自身成熟度。

打开深度页面

交付证据Consumer Matrix 由现有七个 reviewed snapshots 与七个架构假设生成。

09Implemented

Architecture Decisions / Trade-offs

每个高级案例应同时说明 What This Solves、What This Costs 与 Where It Does Not Apply。

打开深度页面

交付证据十项 Decision 已按统一七段模板生成,并公开成本和不适用范围。

10Implemented

Framework Evolution

用版本、迁移、冻结与恢复入口解释 Framework 如何在真实证据下演进。

打开深度页面

交付证据Evolution 页已策展六阶段变化,不公开内部 PLAN/TODO。

SOURCE → STATUS → PROOF

证据权威各自负责,不跨级声明

本页合同、生成器与站点测试已在本地通过;Runner 与 Production 证据不在本批次内。

local-passed / runner-pendingProduction: unknown

Designed

Designed

designed

权威来源Framework Work Status / spec-plan

可以声明
  • 已审阅的设计意图、范围、非目标与恢复条件
不能声明
  • 代码已经存在
  • 本地或 Runner 已通过
  • Consumer 或 Production 已采用

Implemented

Implemented

implemented

权威来源Framework snapshot / committed code

可以声明
  • 已提交代码或快照中存在的结构与能力事实
不能声明
  • 测试已经通过
  • Runner、Consumer、Release 或 Production 已验证

Local Verification

Local Verification

local-verification

权威来源site local evidence records

可以声明
  • 当前本地工作树中已执行并通过的验证范围
不能声明
  • 同一 SHA Runner 已通过
  • Consumer 已验证
  • Production 已上线

CI / Runner

CI / Runner

ci-runner

权威来源same-SHA Runner artifacts

可以声明
  • 绑定同一 Framework commit SHA 的 Runner 验证结果
不能声明
  • 用本地测试代替 Runner
  • 用旧 SHA 或无 SHA 日志代替 Production

Consumer Validation

Consumer Validation

consumer-validation

权威来源consumer registry

可以声明
  • 独立 Consumer 的引用、测试或可玩验证范围
不能声明
  • Framework 全部模块均已生产采用
  • Consumer 验证自动证明 Framework 成熟

Release

Release

release

权威来源release metadata

可以声明
  • 同一提交绑定的 Release metadata 与附件校验结果
不能声明
  • Release 自动等同 Production
  • Candidate 或镜像状态是正式发布

Production

Production

production

权威来源production record

可以声明
  • 明确项目范围内有记录的 Production 事实
不能声明
  • 缺少真实生产证据时声称 production-ready 或上线
  • 把本地、Runner、Consumer 或 Release 证据升级为 Production

Unknown / Deferred

Unknown / Deferred

unknown-deferred

权威来源explicit boundary

可以声明
  • Unknown
  • Deferred
  • runner-pending 或未验证边界
不能声明
  • 用空白或推测填补 Production 状态
  • 跨级推断成熟度
  • Designed 与 Implemented 说明意图和存在,不替代验证证据。
  • Local Verification 与 CI / Runner 是独立等级,必须分别绑定自己的来源。
  • Consumer Validation、Release 与 Production 各自需要对应权威记录,不能跨级升级。
  • 缺少权威来源时必须公开 Unknown / Deferred,并保留恢复入口。