surfaceroster

type Roster struct {
	Surfaces []Surface
	// FilesRead — сколько файлов прочитано. «Ноль находок» обязано быть
	// отличимо от «ноль прочитанного».
	FilesRead int
	// DefaultsRead — сколько умолчаний адресов прочитано.
	DefaultsRead int
}

type Surface struct {
	// Name — имя, которым процесс называет её сам (журнал, текст отказа).
	Name string
	// Reach — досягаемость: "external" либо "cluster-internal".
	Reach string
	// ReachFromProcess — досягаемость объявлена САМИМ ПРОЦЕССОМ (ось
	// `Surface.Reach`), а не названа здесь.
	//
	// Различать обязательно. У gRPC-ног оси досягаемости не существует вовсе,
	// поэтому их значение ниже — утверждение ЭТОГО пакета. Сверять чужой
	// документ с собственным утверждением значит проверять себя собой: такой
	// гейт краснеет на верном тексте и молчит на неверном ровно тогда, когда
	// ошибётся автор перечня.
	ReachFromProcess bool
	// SettingKey — ключ конфигурации, задающий её адрес.
	SettingKey string
	// DefaultAddr — адрес по умолчанию. Пустой означает «умолчания нет»:
	// поверхность поднимается, только если посадка назвала адрес.
	DefaultAddr string
	// DefaultPort — порт из DefaultAddr. Пустой, если умолчания нет.
	DefaultPort string
	// GRPC — поверхность является gRPC-слушателем.
	GRPC bool
	// PostureAddr — адрес, который объявляет ПОСТАВЛЯЕМЫЙ боевой профиль.
	// Заполняется у поверхностей без умолчания: их поднимает посадка, и вне
	// профиля порт у них не определён ничем.
	PostureAddr string
	// PosturePort — порт из [Surface.PostureAddr].
	PosturePort string
}