ingress

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

type CertificatePair struct {
	App     string
	Domains []string
	// CertPEM 是证书链 PEM（leaf + 中间；lego Bundle=true 形态）。
	CertPEM []byte
	// KeyPEM 是私钥 PEM（ECDSA P256）。
	KeyPEM []byte
	// NotAfter 是叶证书到期时间（UTC）。
	NotAfter time.Time
	// SHA256 是 CertPEM 内容摘要（台账登记；变更即重发布 TLS 段）。
	SHA256 string
}

type CertificateRef struct {
	App      string
	SHA256   string
	NotAfter int64 // UnixNano
}

type Config struct {
	// TraefikImage 是入口镜像（钉版；traefik_image）。
	TraefikImage string
	// HTTPPort / HTTPSPort 是宿主发布端口（host 模式 80/443；http_port/
	// https_port）。
	HTTPPort  int
	HTTPSPort int
	// ConfigAddr 是控制面配置端点监听地址（config_addr）。默认 0.0.0.0
	// ——Traefik 任务（容器 netns）须经宿主 IP 访问；鉴权 token 强制，
	// 非回环绑定的暴露面由 token 承担（取舍见 provider.go 注释）。
	ConfigAddr string
	// ConfigAdvertiseIP 是下发给 Traefik 的控制面可达 IP
	//（config_advertise_ip；空 = 自动探测：Swarm advertise addr 优先，
	// 出口本地地址兜底）。Docker Desktop 形态 advertise addr 是 VM 内部
	// IP，须显式配置为宿主可达地址。
	ConfigAdvertiseIP string
	// TokenFile 是配置端点 bearer token 的持久化文件（token_file；首启
	// 生成，与 Traefik 静态配置 --providers.http.headers 同步传递）。
	TokenFile string
	// CertDir 是证书存储根目录（cert_dir；控制面侧明文 PEM，文件权限
	// 0600）。state-model §2.1：证书材料属控制面、独立备份目录。Traefik
	// 经平台自管命名卷（CertVolume）消费证书——控制面签发后经 seed 容器
	// 复制进卷（swarm 不接受 Windows 宿主路径 bind 挂载，实机验证结论；
	// Linux 单机 bind 亦被卷方案统一替代——一条代码路径）。
	CertDir string
	// CertVolume 是 Traefik 证书只读挂载的命名卷（cert_volume）。
	CertVolume string
	// CertSeedImage 是证书 seed 容器镜像（cert_seed_image；stopped 容器 +
	// docker API 拷贝，卷的持久化让 Traefik 重启不丢证书）。
	CertSeedImage string
	// ACME 是集中签发器配置。
	ACME ACMEConfig
	// RenewBefore 是续期窗口（到期前；renew_before_days）。
	RenewBefore time.Duration
	// RenewScanInterval 是续期扫描周期（renew_scan_seconds）。
	RenewScanInterval time.Duration
	// PollInterval 是 Traefik 拉取配置的轮询周期（静态配置参数；供收敛
	// 等待逻辑对齐节奏）。
	PollInterval time.Duration
}

type DomainCheck struct {
	Domain string   `json:"domain"`
	IPs    []string `json:"ips"`
	// Resolved 报告本机是否解析得到至少一个地址。
	Resolved bool `json:"resolved"`
	// HTTP80 是配置 HTTP 端口的探测结果（"" = 不可达；否则记录响应状态行）。
	HTTP80 string `json:"http_80,omitempty"`
	// HTTPS443 是配置 HTTPS 端口的 TLS 握手结果（"" = 不可达）。
	HTTPS443 string `json:"https_443,omitempty"`
	// CertSubject / CertNotAfter 是 443 端口实收证书的诚实记录
	//（不经信任判定——私有 CA/临期证书照实呈现）。
	CertSubject  string   `json:"cert_subject,omitempty"`
	CertDNSNames []string `json:"cert_dns_names,omitempty"`
	CertNotAfter string   `json:"cert_not_after,omitempty"`
	Err          string   `json:"error,omitempty"`
}

type DynamicConfig struct {
	HTTP *HTTPDynamic `json:"http,omitempty"`
	TLS  *TLSDynamic  `json:"tls,omitempty"`
}

type DynamicService struct {
	LoadBalancer *LoadBalancer `json:"loadBalancer"`
}

type FileEntry struct {
	Name string
	Data []byte
	Mode int64
}

type ForwardingTimeouts struct {
	DialTimeout     string `json:"dialTimeout,omitempty"`
	IdleConnTimeout string `json:"idleConnTimeout,omitempty"`
}

type HTTPDynamic struct {
	Routers           map[string]*Router           `json:"routers"`
	Services          map[string]*DynamicService   `json:"services"`
	ServersTransports map[string]*ServersTransport `json:"serversTransports,omitempty"`
}

type LoadBalancer struct {
	Servers          []Server `json:"servers"`
	ServersTransport string   `json:"serversTransport,omitempty"`
}

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

type PublishInput struct {
	AppID   string
	AppName string
	// Services 是入口服务集（有 fleetly.domains label 的服务）。
	Services []ServiceRoutes
}

type Route struct {
	App     string
	Service string
	// Port 是后端目标端口（compose expose 首端口）。
	Port string
	// Domains 是该服务的域名集（归一化 compose spec 产出）。
	Domains []string
	// Cert 标记该 app 证书是否已就绪（就绪则 443 路由 + tls.certificates
	// 下发；未就绪只发 80 路由）。
	Cert *CertificateRef
}

type Router struct {
	Rule        string   `json:"rule"`
	EntryPoints []string `json:"entryPoints"`
	Service     string   `json:"service"`
	// Priority 显式优先级（ACME 挑战路由用——压过 host 路由的默认
	// 规则长度优先级）。
	Priority int        `json:"priority,omitempty"`
	TLS      *RouterTLS `json:"tls,omitempty"`
}

type RouterTLS struct{}

type Server struct {
	URL string `json:"url"`
}

type ServersTransport struct {
	MaxIdleConnsPerHost int                 `json:"maxIdleConnsPerHost,omitempty"`
	ForwardingTimeouts  *ForwardingTimeouts `json:"forwardingTimeouts,omitempty"`
}

type ServiceRoutes struct {
	Service string
	// Port 是后端端口（compose expose 首端口）。
	Port    string
	Domains []string
}

type Status struct {
	Traefik     ingressServiceState
	AdvertiseIP string
	Responder   string
}

type TLSCertificate struct {
	CertFile string `json:"certFile"`
	KeyFile  string `json:"keyFile"`
}

type TLSDynamic struct {
	Certificates []TLSCertificate `json:"certificates,omitempty"`
}