01 / BEFORE START

把「自架測試」與
「production 營運」分開看。

目前 local Alpha profile 是供開發與 integration 使用的 loopback-only 架構。可以在自己的 PC、測試設備或受管理伺服器上體驗目前的 MachiVerse,但不能取代 production security profile。

目前請勿以前提為對外公開

production OIDC / TLS deployment acceptance 是 Alpha 1.0 之後的工作項目。目前也沒有保證只要自行補上認證、TLS 與公開設定,就能視為 production-ready。

02 / QUICK START — WINDOWS

三行指令,
走到啟動。

目前主專案的 Quick Start 以 Windows 為主,需具備相當於 .NET SDK 10.0.400 的環境與最新 develop

git checkout develop
git pull
start-alpha.bat

如果已完成 build,之後可以略過重新編譯。

start-alpha.bat --no-build

03 / WHAT STARTS

不只 Core,
而是一整套四個元件。

標準 Alpha 1.0 啟動會連接 Simulation Core、Gateway、General View 與 Administration View。

Simulation Core權威 WorldState / Simulation / Persistence
GatewayAuth / Cache / Operation / Publication
General View一般使用者瀏覽器 UI
Administration View營運與 Config 瀏覽器 UI

04 / PERSISTENCE & RECOVERY

不只啟動,
也能測試重新啟動。

Alpha 1.0 已連接 Core / Gateway 的 persistence、停止、restart、recovery 與 resync,可以檢查目前的復原流程。

NEXT STEP

世界跑起來之後,
再來理解它的結構。

手動啟動、Linux / macOS 對應指令、Golden Demo 與已知限制,請以主專案的 Alpha 1.0 Integration Runbook 為準。若要理解整體架構,請前往架構・規格頁。

引導前往下一步的南雲澪