config

type Config struct {
	// LogLevel is the slog threshold, one of DEBUG, INFO, WARN, or ERROR.
	LogLevel string `env:"TALLY_LOG_LEVEL" envDefault:"INFO"`
	// DBURL is the PostgreSQL connection string of the engine's own database,
	// which holds the runs and their records. It has no default because a
	// guessed database is worse than none. Supports the *_FILE convention.
	DBURL string `env:"TALLY_ENGINE_DB_URL"`
	// ReportingDBURL is the PostgreSQL connection string of the Reporting API's
	// database, which the engine reads events and resources from. It has no
	// default for the same reason as DBURL. Migration 0008 of the reporting
	// chain creates the group role tally_engine_reader and grants it SELECT on
	// the four tables metering reads; a deployment connects as a login role that
	// is a member of it. Supports the *_FILE convention.
	ReportingDBURL string `env:"TALLY_ENGINE_REPORTING_DB_URL"`
	// VMURL is the base URL of the VictoriaMetrics instance the metricsql
	// counter sources are queried against. It is needed only when the counter
	// sources file declares metricsql sources. It has no default because the
	// endpoint differs per deployment, and no gate here: the first subcommand
	// that queries VictoriaMetrics adds its own.
	VMURL string `env:"TALLY_ENGINE_VM_URL"`
	// GraceHours is how long a run waits after its billing period ends before it
	// executes, so events that arrive late still reach the run that bills them.
	// Zero is a grace window of no hours, which runs the period the moment it
	// closes.
	GraceHours int `env:"TALLY_ENGINE_GRACE_HOURS" envDefault:"72"`
	// AutoFinalize lets a completed run finalize itself. It defaults to false
	// because a finalized run is immutable and its data may reach an ERP, so the
	// step gets a human gate.
	AutoFinalize bool `env:"TALLY_ENGINE_AUTO_FINALIZE" envDefault:"false"`
	// AttributingRelationTypes are the relation types attribution walks when it
	// bills a project under its attributor; an empty list bills every project on
	// its own. Setting the variable to the empty string yields that empty list.
	// "member_of" and "managed_by" reach a virtual project and attribute no cost,
	// so a list naming either is refused.
	AttributingRelationTypes []string `env:"TALLY_ENGINE_ATTRIBUTING_RELATION_TYPES" envDefault:"infrastructure_tenant"`
	// AdjustmentRelationTypes are the relation types adjustment resolution walks
	// from a statement's project to collect the pricing adjustments that apply
	// to it, "managed_by" and "member_of" by default. Setting the variable to
	// the empty string yields the empty list, which turns adjustments off. A
	// type in both lists is walked by attribution and by adjustment resolution.
	AdjustmentRelationTypes []string `env:"TALLY_ENGINE_ADJUSTMENT_RELATION_TYPES" envDefault:"managed_by,member_of"`
	// AdjustmentDepth is how many relation levels the walk follows from the
	// statement's project; 1 is the project's own relations. It is at least 1.
	AdjustmentDepth int `env:"TALLY_ENGINE_ADJUSTMENT_DEPTH" envDefault:"3"`
	// CounterSourcesPath is the path to the counter sources YAML, the file that
	// declares which counters exist and how each one is measured;
	// cmd/tally-engine/counter-sources.example.yaml shows the format. Setting
	// the variable to the empty string means no counter sources, which
	// counters.Load reads as the zero configuration; a path to a file that does
	// not exist is an error when the file is read, not a run without counters.
	// It has no *_FILE companion because the value is a path already, not a
	// secret. Whether the file parses is checked by the package that reads it,
	// not here.
	CounterSourcesPath string `env:"TALLY_ENGINE_COUNTER_SOURCES" envDefault:"/etc/tally/counter-sources.yaml"`
}