bootstrap

type CapabilitySnapshot struct {
	// DeploymentMode 部署模式：standalone | public | admin。
	// 多副本拓扑下前端据此知道「本副本是公开面/管理面」，不再各面各猜。
	DeploymentMode string `json:"deployment_mode"`
	// PublicURLSet 站点公网地址是否已配置（base.public_url 或 server.base_url）。
	// 未配置时分享链接按**请求来源**拼 ⇒ 内网部署会把内网 IP 发给外部用户。
	PublicURLSet bool `json:"public_url_set"`
	// SetupTokenRequired 首启建号是否需要令牌（自动生成的一次性令牌或 PB_SETUP_TOKEN）。
	// true = 未初始化实例的 /setup 会被门禁拦下（前端据此提示「令牌在启动日志里」）。
	SetupTokenRequired bool `json:"setup_token_required"`
	// Federation 联邦是否启用（**生效值**：多副本下自动降级关闭）。
	Federation bool `json:"federation"`
	// FederationDelivery 跨站投递是否可用（联邦前台化，2026-11-01）。
	//
	// 语义 = **联邦启用** 且 **登记了至少一个可投递对端** ⇒ 两者缺一即不可用。
	//
	// ⚠️ 公开面下发这一位**不泄露对端身份**（访客只知道「本站支持跨站投递」，
	// 不知道对端是谁、在哪）⇒ 无害；反之 storage_backend / redis_mode /
	// federation 这几项会泄露部署形态，留在管理面。
	FederationDelivery bool `json:"federation_delivery"`
	// RedisMode redis | memory（redis.host 空 = 单机内存模式）。
	RedisMode string `json:"redis_mode"`
	// StorageBackend 当前存储后端（**生效值**，含远端构造失败后的降级结果）。
	StorageBackend string `json:"storage_backend"`
	// StorageDegraded 是否发生降级（配置的后端 ≠ 生效后端 ⇒ 远端构造失败回落 local）。
	// ⚠️ 这是**真实故障的信号**：用户以为在用 S3，实际全落在本地盘上。
	StorageDegraded bool `json:"storage_degraded"`
}

type Config = conf.AppConfiguration

type DiagnosticsDatabase struct {
	// Driver 驱动名（sqlite / mysql / postgres）。
	Driver string `json:"driver"`
	// Reachable 是否可连通（Ping 成功）。
	Reachable bool `json:"reachable"`
	// Error 连通失败原因（reachable=true 时为空）。
	Error string `json:"error,omitempty"`
}

type DiagnosticsRedis struct {
	// Mode redis | memory。
	Mode string `json:"mode"`
	// Address Redis 地址（mode=memory 时为空）。
	Address string `json:"address,omitempty"`
}

type DiagnosticsReport struct {
	// Version **构建版本**（oekit/core/version.Version，由 ldflags 注入）。
	// ⚠️ 不是 config.App.Version —— 那是 yaml 里的 app.version（缺省 1.0.0，
	// 常年不更新）⇒ 真机上 doctor 会把 4.2.0 的实例报成「1.0.0」。
	// 版本披露用于 CVE 匹配，必须与 /version 端点**同源**。
	Version string `json:"version"`
	// BuildCommit 构建 commit（版本对齐用）。
	BuildCommit string `json:"build_commit,omitempty"`
	// BuildTime 构建时间。
	BuildTime string `json:"build_time,omitempty"`
	// DeploymentMode 部署模式：standalone | public | admin。
	DeploymentMode string `json:"deployment_mode"`
	// ServerTime 服务端当前时间（CLI 用它与本机时钟比对 ⇒ 时钟偏差）。
	ServerTime time.Time `json:"server_time"`
	// Database 数据库连通性。
	Database DiagnosticsDatabase `json:"database"`
	// Storage 存储后端状态。
	Storage DiagnosticsStorage `json:"storage"`
	// Redis 缓存模式。
	Redis DiagnosticsRedis `json:"redis"`
	// Site 站点对外地址状态。
	Site DiagnosticsSite `json:"site"`
	// Setup 首启状态。
	Setup DiagnosticsSetup `json:"setup"`
	// Capabilities 能力快照（生效值）。
	Capabilities CapabilitySnapshot `json:"capabilities"`
}

type DiagnosticsSetup struct {
	// Initialized 是否已初始化（已有 admin）。
	Initialized bool `json:"initialized"`
	// TokenRequired 建号是否需要令牌。
	TokenRequired bool `json:"token_required"`
	// TokenSource 令牌来源：env | auto | none。
	TokenSource string `json:"token_source"`
}

type DiagnosticsSite struct {
	// PublicURL 生效的站点公网地址（未配置时为空）。
	PublicURL string `json:"public_url,omitempty"`
	// PublicURLSet 是否已配置。
	PublicURLSet bool `json:"public_url_set"`
}

type DiagnosticsStorage struct {
	// Backend **生效**后端（远端构造失败会降级 local ⇒ 这里与 Configured 可能不同）。
	Backend string `json:"backend"`
	// Configured 配置里指定的后端。
	Configured string `json:"configured"`
	// Degraded 是否降级（Backend ≠ Configured ⇒ 远端构造失败回落 local）。
	Degraded bool `json:"degraded"`
	// DataPath 本地存储根目录（远端模式下仍承载分片合并副本）。
	DataPath string `json:"data_path,omitempty"`
	// InitError 降级原因（无降级时为空）。
	InitError string `json:"init_error,omitempty"`
}

type Option func(*Options)

type Options struct {
	// StaticDir 是前端构建产物的根目录。
	// 该目录需包含 index.html 与 assets/(Vite 构建产物布局)。
	// 默认 "./static"(相对进程工作目录)。
	// 典型消费者:fnos 单容器部署时把前端内嵌到自定义路径。
	StaticDir string
}

type PublicCapabilities struct {
	// DeploymentMode 部署模式：standalone | public | admin。
	DeploymentMode string `json:"deployment_mode"`
	// PublicURLSet 站点公网地址是否已配置。
	PublicURLSet bool `json:"public_url_set"`
	// SetupTokenRequired 首启建号是否需要令牌。
	SetupTokenRequired bool `json:"setup_token_required"`
	// FederationDelivery 跨站投递是否可用（联邦前台化，2026-11-01）。
	//
	// ⚠️ 只暴露「能不能用」，**不暴露对端身份**（谁、在哪）⇒ 访客看得见
	// 功能入口，但看不到管理员配了对端。
	FederationDelivery bool `json:"federation_delivery"`
}