discover

type Machine struct {
	// Name, platformdaki adı. Hedef adı olarak kullanılıyor.
	Name string

	/*
	 * Host, SSH için kullanılacak adres.
	 *
	 * Boş olabilir: Proxmox'ta adresi öğrenmek konuk aracısına
	 * (guest agent) bağlı ve o her makinede kurulu değil. Boşken
	 * makinenin ADI adres olarak deneniyor — kurumların çoğunda
	 * makine adı zaten çözülüyor. Çözülmezse makine ATLANIYOR ve
	 * sebebi raporda yazıyor; uydurma bir adres yazmak, bir gün
	 * başka bir makineye açılan bir hedef bırakırdı.
	 */
	Host string

	// Tags, platformdaki etiketler. Rol bunlardan çıkarılıyor.
	Tags []string

	// Running, makine çalışıyor mu. Kapalı makinenin host anahtarı
	// taranamaz; rapor bunu ayrı bir sebep olarak söylüyor.
	Running bool

	// Ref, platformdaki kimliği (teşhis için: "qemu/101").
	Ref string

	/*
	 * Key, makinenin platformdaki KARARLI kimliği ("qemu/101",
	 * "vsphere/vm-42"). Paneldeki keşif satırı bununla anahtarlanıyor.
	 *
	 * ⚠️ Ref DEĞİL. Proxmox'ta Ref düğümü de taşıyor ("qemu/101@pve2") ve
	 * kümede canlı taşınan bir VM'in düğümü değişiyor: Ref'le
	 * anahtarlasaydık her taşımada makine "yeni" görünür, eskisi "kayıp"
	 * düşerdi. VMID küme içinde tekil; ad da değil, kimlik o — adla
	 * anahtarlamak, VM'i yeniden adlandıranın yeni bir hedef yaratıp
	 * eskisini öksüz bırakması demek.
	 */
	Key string
}

type MachineRef struct {
	SourceID string `json:"source_id"`
	Ref      string `json:"ref"`
}

type Opener func(store.DiscoverySource, string) (Source, error)

type Outcome struct {
	Machine Machine
	Role    string
	// Tagged: rol etiketten mi geldi (yoksa unknown'a mı düştü).
	Tagged bool

	// Skipped doluysa makine için hiçbir şey yazılmadı ve sebebi bu.
	Skipped string

	/*
	 * KeyUnchecked doluysa makine ZATEN KAYITLIYDI ama host anahtarı bu
	 * turda doğrulanamadı (ağ). Rol bağı yine de yenilendi.
	 *
	 * ⚠️ SESSİZ GEÇMİYOR: "kontrol ettim ve aynıydı" ile "kontrol
	 * edemedim" farklı şeyler, ve ikincisini birincisi gibi göstermek
	 * değişmiş bir makineyi değişmemiş sanmaya yol açar.
	 */
	KeyUnchecked string

	// Aşağıdakiler yalnızca uygulama (apply) turunda dolar.
	CreatedRole   bool
	CreatedTarget bool
	Granted       bool
	// Existing: hedef zaten vardı ve DOKUNULMADI.
	Existing bool
}

type Planner struct {
	DB *store.Store
	// TagKey, rol adını taşıyan etiket anahtarı ("role").
	TagKey string
	// Port, hedeflerin SSH portu.
	Port int
	// Actor, denetim kaydına yazılacak kim.
	Actor string
}

type Probe struct {
	Machines    int `json:"machines"`
	Running     int `json:"running"`
	WithAddress int `json:"with_address"`
	// Matching, ad kalıbına uyan makine sayısı (kalıp boşsa hepsi).
	Matching int `json:"matching"`
	// Tagged, etiket anahtarını taşıyan makine sayısı; Roles onlardan
	// çıkan rol adlarının örneği, Tags görülen etiketlerin örneği.
	Tagged int      `json:"tagged"`
	Roles  []string `json:"roles"`
	Tags   []string `json:"tags"`
	TookMS int64    `json:"took_ms"`
}

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

type ProxmoxConfig struct {
	// BaseURL, "https://pve.example:8006" biçiminde.
	BaseURL string

	/*
	 * TokenID ve TokenSecret, API jetonu ("user@pam!keşif").
	 *
	 * ⚠️ PAROLA/TICKET YOLU BİLEREK YOK. Jeton kapsamı daraltılabiliyor
	 * ve iptali tek tıklık; kullanıcı parolası ise hipervizörün tamamına
	 * açılan bir anahtar. postern'in kendi kapısında verdiği kararın
	 * aynısı: makine işi için makine kimliği.
	 */
	TokenID     string
	TokenSecret string

	// CAFile, hipervizörün sertifikasını doğrulayacak kök. Boşsa
	// sistemin kök deposu.
	CAFile string

	// CAPEM, aynı kök PEM metni olarak: panelde kaydedilen kaynak dosya
	// yolu değil metin taşıyor. CAFile doluysa o geçerli.
	CAPEM string

	/*
	 * Insecure, TLS doğrulamasını KAPATIR.
	 *
	 * ⚠️ VARSAYILAN DEĞİL VE OLMAYACAK. Proxmox kurulumlarının çoğu
	 * kendi imzaladığı sertifikayla geliyor, dolayısıyla bunu tamamen
	 * yasaklamak özelliği kullanılamaz yapardı. Ama açık olduğunda
	 * araya giren biri hipervizörün cevabını — yani hangi makinenin
	 * hangi role gideceğini — yazabilir. Bu yüzden açan kişi bunu
	 * komut satırında yazmak zorunda ve denetim kaydına düşüyor.
	 * Doğru yol CAFile.
	 */
	Insecure bool

	// Node boşsa küme genelinde arıyor.
	Node string

	Timeout time.Duration
}

type RegisterRequest struct {
	Machines []MachineRef
	// Roles, her makinenin bağlanacağı var olan roller.
	Roles []string
	// TagRoles: makinenin etiketinin söylediği role de bağla (yoksa aç).
	TagRoles bool
	Labels   map[string]string
	Actor    string
}

type Registered struct {
	SourceID     string   `json:"source_id"`
	Ref          string   `json:"ref"`
	Name         string   `json:"name"`
	Target       string   `json:"target,omitempty"`
	Roles        []string `json:"roles,omitempty"`
	CreatedRoles []string `json:"created_roles,omitempty"`
	Error        string   `json:"error,omitempty"`
}

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

type Source interface {
	// Name, raporda ve denetim kaydında görünen ad ("proxmox").
	Name() string
	// Machines, platformdaki makineleri döner.
	Machines(ctx context.Context) ([]Machine, error)
}

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

type VSphereConfig struct {
	// BaseURL, "https://vcenter.example" biçiminde.
	BaseURL string

	/*
	 * Username ve Password.
	 *
	 * ⚠️ PROXMOX'TAN FARKLI OLARAK JETON YOK ve bu bir tercih değil:
	 * vCenter'ın API jetonu diye ayrı bir kavramı yok, oturum kullanıcı
	 * kimliğiyle açılıyor. Karşılığında kullanılacak hesabın
	 * YALNIZCA OKUMA yetkisi olmalı — bu koddaki hiçbir çağrı
	 * değiştirmiyor, ama yetkiyi daraltmak koda değil operatöre bağlı.
	 */
	Username string
	Password string

	CAFile string

	// CAPEM, aynı kök PEM metni olarak (bkz. ProxmoxConfig.CAPEM).
	CAPEM string
	// Insecure, TLS doğrulamasını kapatır. Gerekçesi ProxmoxConfig'te.
	Insecure bool

	Timeout time.Duration
}