runtime

type AppConfig struct {
	// Addr 是 HTTP 面（框架 healthz 端点 + grpc-gateway 挂载的 REST /v1/**）
	// 的监听地址。
	Addr string `mapstructure:"addr"`
	// GRPC 是 gRPC 面配置（server.v1 服务承载于此，gateway 反向代理目标）。
	GRPC GRPCConfig `mapstructure:"grpc"`
	// State 是状态层配置（config 键 state.*）。
	State StateConfig `mapstructure:"state"`
	// Secrets 是平台密钥配置（config 键 secrets.*，architecture §2.3：
	// envelope 主密钥存控制面主机文件、权限保护、与备份数据分离）。
	Secrets SecretsConfig `mapstructure:"secrets"`
	// Build 是构建管线配置（config 键 build.*，T2.8）。
	Build BuildConfig `mapstructure:"build"`
	// Engine 是发布引擎配置（config 键 engine.*，T2.10/T2.11；治理参数
	// v0.1 平台默认——文件缺省即文档默认，见 engine.Config.Normalize）。
	Engine EngineConfig `mapstructure:"engine"`
	// Ingress 是入口/证书配置节（config 键 ingress.*，T2.15/T2.16；
	// Traefik 部署 + 配置端点 + 集中 ACME——缺省值经 ingress.Config.
	// Normalize 回落，单一事实源在 internal/ingress）。
	Ingress IngressConfig `mapstructure:"ingress"`
	// Logs 是日志管线配置节（config 键 logs.*，T2.20；缺省值经 logs.
	// Config.Normalize 回落——单一事实源在 internal/logs）。
	Logs LogsConfig `mapstructure:"logs"`
	// Git 是 git push(SSH) 触发入口配置节（config 键 git.*，T2.19；缺省值
	// 经 gitserver.Config.Normalize 回落——单一事实源在 internal/gitserver）。
	Git GitConfig `mapstructure:"git"`
	// Webhook 是 webhook 触发入口配置节（config 键 webhook.*，T2.19）。
	Webhook WebhookConfig `mapstructure:"webhook"`
	// Console 是 Console 端静态托管配置节（config 键 console.*，T2.21）。
	Console ConsoleConfig `mapstructure:"console"`
	// Backup 是状态备份配置节（config 键 backup.*，T2.22；缺省值经
	// statebackup.Config.Normalize 回落——单一事实源在 internal/statebackup）。
	Backup BackupConfig `mapstructure:"backup"`
}

type BackupConfig struct {
	// Dir 是备份根目录（backup.dir）。主密钥（fleetly.key）绝不进备份目录
	// ——manifest 只记密钥文件 sha256 指纹；配置把密钥放进备份目录会被
	// statebackup.NewManager 构造期拒绝（fail-fast）。
	Dir string `mapstructure:"dir"`
	// Keep 是保留份数上限（backup.keep；非正值回落 DefaultKeep=7）。
	Keep int `mapstructure:"keep"`
}

type BuildConfig struct {
	// BuildkitHost 是 buildkit 端点（build.buildkit_host）；空 = 缺省
	// docker-container://fleetly-buildkit（平台自管容器）。指向外部
	// buildkitd（tcp://…）时应把 manage_daemon 置 false。
	BuildkitHost string `mapstructure:"buildkit_host"`
	// ManageDaemon 报告平台是否自管 buildkitd 容器（build.manage_daemon，
	// 缺省 true；外部端点形态置 false）。
	ManageDaemon *bool `mapstructure:"manage_daemon"`
	// DaemonContainerName 是自管 buildkitd 容器名（build.daemon_container_name）。
	DaemonContainerName string `mapstructure:"daemon_container_name"`
	// CacheVolume 是 buildkitd 内部工作缓存的持久化命名卷
	// （build.cache_volume，挂 /var/lib/buildkit）。
	CacheVolume string `mapstructure:"cache_volume"`
	// CacheDir 是 local cache 导入/导出的宿主目录（build.cache_dir；
	// 客户端侧数据根，缺省 ./build-cache）。
	CacheDir string `mapstructure:"cache_dir"`
	// ArtifactsDir 是 plan JSON / 构建日志归档根目录（build.artifacts_dir）。
	ArtifactsDir string `mapstructure:"artifacts_dir"`
	// Concurrency 是构建队列并发上限（build.concurrency；缺省 2，天花板 8）。
	Concurrency int `mapstructure:"concurrency"`
	// MemoryBytes 是 buildkitd 容器内存限额（build.memory_bytes；缺省 1GiB）。
	MemoryBytes int64 `mapstructure:"memory_bytes"`
	// CPUS 是 buildkitd 容器 CPU 限额（build.cpus；缺省 1.5）。
	CPUS float64 `mapstructure:"cpus"`
	// PollSeconds 是队列扫描周期秒数（build.poll_seconds；缺省 2）。
	PollSeconds int `mapstructure:"poll_seconds"`
	// TimeoutSeconds 是单条构建执行超时预算秒数（build.timeout_seconds；
	// 缺省 1800=30min。超时 → 终态 failed（E_BUILD_FAILED）——挂起构建
	// 不永久占用并发槽）。
	TimeoutSeconds int `mapstructure:"timeout_seconds"`
	// ArtifactsRetentionDays 是产物归档目录保留天数（build.artifacts_
	// retention_days；缺省 30，A10/S18——janitor 按 mtime 清理）。非正值
	// 回落默认（不允许误配成 0 静默关闭清理）。
	ArtifactsRetentionDays int `mapstructure:"artifacts_retention_days"`
	// ContextRoots 是构建上下文受管根的额外配置根（build.context_roots；
	// H14 宿主目录信任边界：context_dir 必须位于受管根内，越界构建终态
	// 失败）。缺省集合 = 系统 temp 根（build.Config.Normalize 恒并入）+
	// git 裸仓库根（GitSettings 装配并入）；单机同宿主形态下 CLI 构建目录
	// 在此显式扩根接入（信任由 TriggerBuild 的 admin scope 把门）。
	ContextRoots []string `mapstructure:"context_roots"`
}

type ConsoleConfig struct {
	// StaticDir 是 Console SPA 构建产物的静态根目录（console.static_dir）。
	// 空 = 关闭（/ui/ 前缀不分派——豁免面 = 分派面，缺省零暴露）。指向
	// console/dist（`pnpm build` 产物）时 gateway 在 /ui/ 前缀托管静态文件
	// 并做 SPA 回退（未命中文件的路径一律回 index.html）。
	StaticDir string `mapstructure:"static_dir"`
}

type EngineConfig struct {
	// DeployTimeoutSeconds 是 L2 发布看门狗秒数（engine.deploy_timeout_seconds；
	// 缺省 300——含 PENDING/停滞，有效值 ≥ health 预算）。
	DeployTimeoutSeconds int `mapstructure:"deploy_timeout_seconds"`
	// ObserveSeconds 是 L3 观察窗秒数（engine.observe_seconds；缺省 60）。
	ObserveSeconds int `mapstructure:"observe_seconds"`
	// ReplicasBelowSeconds 是观察窗副本水位不足判定的持续秒数
	//（engine.replicas_below_seconds；缺省 10）。
	ReplicasBelowSeconds int `mapstructure:"replicas_below_seconds"`
	// PollSeconds 是引擎轮询周期秒数（engine.poll_seconds；缺省 2）。
	PollSeconds int `mapstructure:"poll_seconds"`
	// DriftIntervalSeconds 是运行域漂移检测扫描周期秒数
	//（engine.drift_interval_seconds；缺省 30，T2.13）。
	DriftIntervalSeconds int `mapstructure:"drift_interval_seconds"`
}

type GRPCConfig struct {
	// Addr 是 gRPC 监听地址（grpc.addr）。
	Addr string `mapstructure:"addr"`
}

type GitConfig struct {
	// Enabled 报告是否启用 SSH git 面（git.enabled；缺省 true。false =
	// 显式关闭位——webhook 拉源不依赖 SSH 面，但 bare 仓库根共用）。
	Enabled *bool `mapstructure:"enabled"`
	// Addr 是 SSH 监听地址（git.addr；缺省 127.0.0.1:8424）。
	Addr string `mapstructure:"addr"`
	// Root 是 bare 仓库根目录（git.root；空 = <state 库同目录>/git）。
	Root string `mapstructure:"root"`
	// HostKeyFile 是 SSH host key 文件（git.host_key_file；空 =
	// <root>/host_ed25519。ed25519 首启生成持久化，绝不打印私钥）。
	HostKeyFile string `mapstructure:"host_key_file"`
}

type IngressACMEConfig struct {
	// Enabled 报告是否启用集中签发（enabled；缺省 true。false = 只发布
	// HTTP 路由——无域名/离线环境的显式关闭位）。
	Enabled *bool `mapstructure:"enabled"`
	// CADirURL 是 ACME 目录端点（ca_dir_url；默认 LE production，测试用
	// Pebble URL）。
	CADirURL string `mapstructure:"ca_dir_url"`
	// Email 是 ACME 账号邮箱（email）。
	Email string `mapstructure:"email"`
	// CAPoolFile 是 CA 根证书池 PEM（ca_pool_file；Pebble/私有 CA 信任）。
	CAPoolFile string `mapstructure:"ca_pool_file"`
	// AccountKeyFile 是 ACME 账号私钥文件（account_key_file；空 =
	// <cert_dir>/acme-account.key）。
	AccountKeyFile string `mapstructure:"account_key_file"`
}

type IngressConfig struct {
	// TraefikImage 是入口镜像（traefik_image；钉版，升级 = 改配置 +
	// 回归，不追 latest）。
	TraefikImage string `mapstructure:"traefik_image"`
	// HTTPPort / HTTPSPort 是宿主发布端口（host 模式）。
	HTTPPort  int `mapstructure:"http_port"`
	HTTPSPort int `mapstructure:"https_port"`
	// ConfigAddr 是控制面配置端点监听地址（config_addr；默认 0.0.0.0:8422
	// ——Traefik 任务经宿主 IP 访问，鉴权 token 强制）。
	ConfigAddr string `mapstructure:"config_addr"`
	// ConfigAdvertiseIP 是下发给 Traefik 的控制面可达 IP
	//（config_advertise_ip；空 = 自动探测。Docker Desktop 形态 advertise
	// addr 是 VM 内部 IP，须显式配置宿主可达地址）。
	ConfigAdvertiseIP string `mapstructure:"config_advertise_ip"`
	// TokenFile 是配置端点 bearer token 文件（token_file；首启生成）。
	TokenFile string `mapstructure:"token_file"`
	// CertDir 是证书存储根目录（cert_dir；控制面侧明文 PEM，独立备份目录
	// ——state-model §2.1；bind 挂载进 Traefik 只读）。
	CertDir string `mapstructure:"cert_dir"`
	// ACME 是集中签发器配置。
	ACME IngressACMEConfig `mapstructure:"acme"`
	// RenewBeforeDays 是续期窗口天数（renew_before_days；缺省 30）。
	RenewBeforeDays int `mapstructure:"renew_before_days"`
	// RenewScanSeconds 是续期扫描周期秒数（renew_scan_seconds；缺省 12h）。
	RenewScanSeconds int `mapstructure:"renew_scan_seconds"`
}

type LogsConfig struct {
	// Dir 是落盘根目录（logs.dir；缺省 ./fleetly-logs）。
	Dir string `mapstructure:"dir"`
	// RetentionDays 是落盘保留天数（logs.retention_days；缺省 7——架构
	// §2.3 数据保留：应用日志 7 天轮转）。
	RetentionDays int `mapstructure:"retention_days"`
	// ScanIntervalMillis 是采集轮询周期毫秒数（logs.scan_interval_millis；
	// 缺省 2000）。
	ScanIntervalMillis int `mapstructure:"scan_interval_millis"`
	// RingSize 是 per app-service 内存环形缓冲深度（logs.ring_size；缺省
	// 1000）。
	RingSize int `mapstructure:"ring_size"`
}

type SecretsConfig struct {
	// KeyPath 是 envelope 主密钥文件路径（secrets.key_path）；空 = 缺省
	// ./fleetly.key。首启不存在则生成并日志提示妥善保存。
	KeyPath string `mapstructure:"key_path"`
}

type StateConfig struct {
	// DBPath 是 SQLite 状态库文件路径（state.db_path）。
	DBPath string `mapstructure:"db_path"`
	// EventRetentionDays 是事件保留天数（state.event_retention_days）。
	EventRetentionDays int `mapstructure:"event_retention_days"`
	// AuditRetentionDays 是审计保留天数（state.audit_retention_days）。
	AuditRetentionDays int `mapstructure:"audit_retention_days"`
	// BuildRetentionDays 是 builds 终态行保留天数（state.build_retention_
	// days；缺省 90，A10/S18——janitor 清理终态构建台账行）。
	BuildRetentionDays int `mapstructure:"build_retention_days"`
	// DockerHost 是底座连接地址（state.docker_host）；空 = DOCKER_HOST
	// 环境变量，再缺省本机套接字。
	DockerHost string `mapstructure:"docker_host"`
}

type Version string

type WebhookConfig struct {
	// ReplayTTLSecs 是 delivery ID 防重放窗口秒数
	//（webhook.replay_ttl_seconds；缺省 900 = 15 分钟）。
	ReplayTTLSecs int `mapstructure:"replay_ttl_seconds"`
}