groupsync

type Config struct {
	Interval time.Duration
	Timeout  time.Duration
	DryRun   bool
	Limits   Limits
}

type Directory interface {
	Lookup(context.Context, auth.Identity) (ldap.LookupResult, error)
	Probe(context.Context) error
}

type InvalidSettingError struct{ Key, Got, Want string }

type Limits struct {
	// Grace, kullanıcı dizinde bulunamadıktan sonra iptal için beklenen
	// süre. Kısa bir çoğaltma gecikmesi ya da bakım penceresi yetkileri
	// silmesin diye.
	Grace time.Duration

	// MaxZeroFraction / MinZeroFloor, "kaç kişi sıfır SSO rolüne
	// düşerse bu bir kesintidir" eşiği. İkisi BİRLİKTE aşılmalı: küçük
	// kurumlarda oran tek kişiyle aşılır, büyüklerinde taban tek başına
	// anlamsız kalır.
	MaxZeroFraction float64
	MinZeroFloor    int

	// MaxUnknownFraction, dizinin cevaplayamadığı kullanıcı oranı için
	// tavan. Aşılırsa dizin sağlıklı değildir ve hiçbir karar verilmez.
	MaxUnknownFraction float64

	// MaxRevokePerRun, tek koşuda iptal edilebilecek kullanıcı sayısı.
	MaxRevokePerRun int
}

type Observation struct {
	Username string

	// Presence, dizinin bu kullanıcı hakkında söylediği (üç değerli).
	Presence ldap.Presence

	// MappedRoles, dizindeki gruplarının karşılığı olan roller.
	// Presence != PresencePresent iken anlamsızdır.
	MappedRoles []string

	// MissingSince, bu kullanıcının İLK kez dizinde bulunamadığı an.
	// Sıfır ise şu ana kadar hep bulunmuş.
	MissingSince time.Time

	// ManualRoles, elle verilmiş rol sayısı. Senkronizasyon bunlara
	// DOKUNMAZ (bkz. göç 005) — ama rapor bunu ayrıca söylemeli, yoksa
	// operatör "iptal edildi" okuyup erişimin tamamen bittiğini sanar.
	ManualRoles int

	/*
	 * SSORoles, kullanıcının ŞU AN sahip olduğu SSO kaynaklı rol sayısı.
	 *
	 * ⚠️ TAVANLARIN DOĞRU SAYMASI İÇİN ŞART. Bu alan yokken "sıfıra
	 * düşecek" sayacı, dizinde bulunamayan HERKESİ sayıyordu — çoktan
	 * iptal edilmiş, yıllar önce ayrılmış kullanıcılar dahil. Onlar
	 * users tablosundan hiç çıkmıyor (DeleteUser oturum kaydı olanı
	 * reddediyor, sso_only hiç temizlenmiyor), yani her koşuda yeniden
	 * sayılıyorlardı.
	 *
	 * Sonucu ölçüldü: mezun sayısı MinZeroFloor'u ve MaxZeroFraction'ı
	 * geçtiği anda koşu iptal ediliyor — ve bir daha ASLA geçmiyor,
	 * çünkü sayı yalnızca büyüyor. Patlama yarıçapı koruması, kalıcı ve
	 * sessiz bir "hiç kimse iptal edilemez" moduna dönüşüyordu.
	 */
	SSORoles int
}

type Plan struct {
	// Apply, uygulanacak rol kümeleri.
	Apply []UserRoles

	// Hold, dizinde bulunamayan ama Grace süresi dolmamış kullanıcılar.
	Hold []string

	// Unknown, dizinin cevaplayamadığı kullanıcılar. Bunlara DOKUNULMAZ.
	Unknown []string

	// Abort boş değilse HİÇBİR ŞEY uygulanmaz ve sebebi budur.
	Abort string
}

type Report struct {
	Outcome string
	Reason  string

	Considered, Present, Absent, Unknown, Revoked, RolesChanged int

	// KeptManual, iptal edilmiş ama elle verilmiş rolleri DURAN
	// kullanıcılar. Ayrı raporlanıyor çünkü "iptal edildi" okuyup
	// erişimin tamamen bittiğini sanmak kolay.
	KeptManual []string

	/*
	 * StampErrors, yazılamayan varlık damgası sayısı.
	 *
	 * ⚠️ "ok" ÇIKTISI TAM OLMAYABİLİR ve bunu söylemek gerekiyor.
	 * Yazılamayan bir damga, bir sonraki koşunun zamanı yanlış
	 * okuması demek: grace penceresi baştan başlar (iptal hiç
	 * gelmez) ya da dizinde duran biri doğrulanmamış sayılır.
	 * Sıfırdan büyükse koşu "bir şey yapmadım" değil, "bir kısmını
	 * kaydedemedim" demektir.
	 */
	StampErrors int
}

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

type Settings struct {
	Enabled bool
	Config  Config

	/*
	 * IgnoredKeys, ayarlar tablosunda duran ama ARTIK OKUNMAYAN
	 * anahtarlar (patlama yarıçapı tavanları; gerekçe LoadSettings'te).
	 *
	 * ⚠️ Çağıranın bunu bildirmesi ŞART. Bir değeri yok saymak ile
	 * yok saydığını söylemek arasındaki fark, operatörün yürürlükte
	 * sandığı bir ayarla çalışıp çalışmadığıdır.
	 */
	IgnoredKeys []string
}

type UserRoles struct {
	Username string
	Roles    []string

	// Revoking, bu uygulamanın kullanıcıyı SIFIR SSO rolüne düşürdüğünü
	// söyler — rapor ve denetim için.
	Revoking bool

	// ManualRoles, iptalden SONRA elinde kalan elle verilmiş rol sayısı.
	ManualRoles int
}