config

type BaseConfig struct {
	Name        string `json:"name"`
	Description string `json:"description"`

	// PublicURL 站点公网地址（2026-10-22 落地，可选）：用户可访问本柜的对外
	// 地址（如 https://box.example.com）。分享链接与「交付文本」按它拼；
	// 为空 = 未配置 = 前端回退浏览器当前 origin。
	//
	// 为什么需要：分享链接原先按**请求 origin** 拼（frontend-core
	// ShareResultDialog.vue），NAS/内网部署时管理员从内网访问 → 生成的链接
	// 带内网 IP（如 http://10.10.10.3:56789）→ 发给外部用户根本打不开。
	// 这是"多部署方式"下最隐蔽的易用性断点。
	PublicURL string `json:"public_url"`
}

type P2PSection struct {
	// Federation 联邦控制面（overlay → conf.Federation；nil = 保留现状）
	Federation *conf.FederationConfig `json:"federation,omitempty"`
}

type ReconfigureHooks struct {
	// OnNotifyChanged Webhook+SMTP 热重建（mailer 按新 SMTP 段重建，host 空=卸载）
	OnNotifyChanged func(n *conf.NotifyConfig)
	// OnOIDCChanged OIDC service 热重建（按新段；Enabled=false 时 handler 走未启用响应）
	OnOIDCChanged func(o *conf.OIDCConfig)
	// OnP2PFederationChanged federation 运行时热切换（bootstrap 注册；P1 对称节点
	// spec §6）。返回 error 时 UpdateConfig 透传给管理员——切换失败但配置已持久化
	// 的分叉必须响亮（spec §12.4），禁止静默。
	OnP2PFederationChanged func(f *conf.FederationConfig) error
	// OnOverlayApplied SystemConfig 段 overlay 进全局 conf 之后的回调（bootstrap
	// 注册 env 恒覆盖重施器：统一优先级 yaml < DB < env，2026-10-15）。持 configMu
	// 同步调用，实现方只许操作全局 conf/env，不得回调 config service。
	OnOverlayApplied func()
}

type Service struct {
	// contains filtered or unexported fields
}

type StorageSettings struct {
	Type    string `json:"type"`
	MaxSize int64  `json:"max_size"`
}

type SystemConfig struct {
	Base     *BaseConfig       `json:"base,omitempty"`
	Storage  *StorageSettings  `json:"storage,omitempty"`
	Transfer *TransferSettings `json:"transfer,omitempty"`

	// RuntimeStorage 运行时存储配置（存储域经 RuntimePersister 接口读写，
	// 本域只负责持久化不解释其内容；nil 表示管理端从未在线改过存储后端）。
	RuntimeStorage *conf.StorageConfig `json:"runtime_storage,omitempty"`

	// User 用户设置（注册开关/上传限制/存储配额/会话时长）。
	// nil 表示从未在线保存过 → 运行时回退 yaml 全局配置（EffectiveUserSettings）。
	// JSON 键沿用前端 configForm.user 的既有键名，读写端点直传免转换。
	User *UserSettings `json:"user,omitempty"`

	// ===== v0.7.3 扩容的在线设置段（同 User 语义：nil = 未在线设置 → yaml 生效；
	// 非 nil = 保存时整体 overlay 到全局 conf 并热应用，重启由 restoreAdminSettings 恢复）=====
	// 外观（背景图/主题色/管理入口可见性）
	UI *conf.UIConfig `json:"ui,omitempty"`
	// 上传细项（文本上限/扩展名白黑名单/匿名日配额/整文件上限/全局过期上限/过期样式裁剪）
	UploadEx *conf.UploadConfig `json:"upload_ex,omitempty"`
	// 下载（S3 直下/超时/需登录）
	Download *conf.DownloadConfig `json:"download,omitempty"`
	// 通知（Webhook + SMTP；保存经 Reconfigurers 热重建 mailer）
	Notify *conf.NotifyConfig `json:"notify,omitempty"`
	// 本地导入（enabled/roots）
	LocalImport *conf.LocalImportConfig `json:"local_import,omitempty"`
	// OIDC 单点登录
	OIDC *conf.OIDCConfig `json:"oidc,omitempty"`
	// API Key 认证总开关与 per-Key 限流
	APIToken *conf.APITokenConfig `json:"api_token,omitempty"`

	// P2P P2P 能力段（2026-10-14 对称节点 spec §5）：Federation 控制面在线开关；
	// 直传数据面参数（enabled/send_roots/…）随 P2a 落地。nil = 未在线设置。
	P2P *P2PSection `json:"p2p,omitempty"`
}

type TransferSettings struct {
	MaxCount      int `json:"max_count"`
	ExpireDefault int `json:"expire_default"`
}

type UserSettings struct {
	// AllowUserRegistration 是否开放注册（/user/register 与 /api/config 同源读取）
	AllowUserRegistration bool `json:"allowuserregistration"`
	// UserUploadSize 用户单次上传大小默认上限（字节，0 = 不限）
	UserUploadSize int64 `json:"useruploadsize"`
	// UserStorageQuota 用户存储配额默认值（字节，0 = 不限）
	UserStorageQuota int64 `json:"userstoragequota"`
	// SessionExpiryHours 会话时长（小时，0 = auth 包默认 7 天）
	SessionExpiryHours int `json:"sessionexpiryhours"`
}