payout runs/payout periods split

apps/labrinth/migrations/20260817120000_payout-period-revenue.sql

@@ -0,0 +1,60 @@
+CREATE TABLE payout_periods (
+	period DATE PRIMARY KEY
+		CHECK (EXTRACT(DAY FROM period) = 1),
+	raw_actual_aditude_revenue_usd NUMERIC(40, 20) NOT NULL
+		CHECK (raw_actual_aditude_revenue_usd >= 0),
+	adjustments JSONB NOT NULL
+);
+
+CREATE TABLE payout_period_days (
+	period DATE NOT NULL REFERENCES payout_periods(period),
+	date DATE NOT NULL,
+	raw_estimated_aditude_revenue_usd NUMERIC(40, 20) NOT NULL
+		CHECK (raw_estimated_aditude_revenue_usd >= 0),
+	aditude_impressions BIGINT NOT NULL
+		CHECK (aditude_impressions >= 0),
+	CHECK (date >= period AND date < period + INTERVAL '1 month'),
+	PRIMARY KEY (period, date)
+);
+
+CREATE TABLE payout_runs (
+	id BIGINT PRIMARY KEY,
+	period DATE NOT NULL REFERENCES payout_periods(period),
+	status TEXT NOT NULL,
+	started_at TIMESTAMPTZ NOT NULL,
+	started_by BIGINT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+	execute_at TIMESTAMPTZ NOT NULL,
+	processing_started_at TIMESTAMPTZ,
+	finished_at TIMESTAMPTZ,
+	cancelled_at TIMESTAMPTZ,
+	cancelled_by BIGINT REFERENCES users(id) ON DELETE CASCADE,
+	error JSONB,
+	CHECK (execute_at >= started_at),
+	CHECK (
+		processing_started_at IS NULL
+		OR processing_started_at >= started_at
+	),
+	CHECK (finished_at IS NULL OR finished_at >= started_at),
+	CHECK (cancelled_at IS NULL OR cancelled_at >= started_at)
+);
+
+CREATE UNIQUE INDEX payout_runs_active_period
+	ON payout_runs (period)
+	WHERE status IN ('scheduled', 'running');
+
+CREATE UNIQUE INDEX payout_runs_succeeded_period
+	ON payout_runs (period)
+	WHERE status = 'succeeded';
+
+CREATE INDEX payout_runs_scheduled_execute_at
+	ON payout_runs (execute_at)
+	WHERE status = 'scheduled';
+
+CREATE TABLE payouts_variance (
+	applied_on DATE PRIMARY KEY,
+	variance NUMERIC(40, 20) NOT NULL
+		CHECK (variance BETWEEN 0 AND 1)
+);
+
+INSERT INTO payouts_variance (applied_on, variance)
+VALUES ('1970-01-01', 0.1);