微信小程序页面迁移校验之前 P5任务处理之前

db/etl_feiqiu/migrations/2026-02-27__add_biz_date_function.sql

@@ -0,0 +1,34 @@
+-- 新增 dws.biz_date() 函数：将 timestamptz 按营业日分割点归属到对应日期
+-- 原因：全系统统计时间口径从自然日切换为营业日（默认 08:00 分割），
+--       数据库层需要与 Python 侧 business_date() 等价的 SQL 函数，
+--       供物化视图和直接查询使用。
+-- 影响：物化视图 mv_dws_finance_daily_summary_l1..l4、
+--       mv_dws_assistant_daily_detail_l1..l4 的时间过滤条件将依赖此函数
+-- 关联需求：Requirements 9.2, 9.4
+
+CREATE OR REPLACE FUNCTION dws.biz_date(
+    ts timestamptz,
+    cutoff_hour int DEFAULT 8
+)
+RETURNS date
+LANGUAGE sql
+IMMUTABLE
+PARALLEL SAFE
+AS $$
+    SELECT (ts - make_interval(hours => cutoff_hour))::date;
+$$;
+
+COMMENT ON FUNCTION dws.biz_date(timestamptz, int) IS
+    '营业日归属函数：将时间戳减去 cutoff_hour 小时后取日期。'
+    '默认 cutoff_hour=8，即 08:00 前的时间戳归属前一天。'
+    '等价于 Python 侧 neozqyy_shared.datetime_utils.business_date()。';
+
+-- 验证 SQL：
+-- SELECT dws.biz_date('2026-01-15 07:59:59+08'::timestamptz);        -- 预期：2026-01-14
+-- SELECT dws.biz_date('2026-01-15 08:00:00+08'::timestamptz);        -- 预期：2026-01-15
+-- SELECT dws.biz_date('2026-01-15 23:59:59+08'::timestamptz);        -- 预期：2026-01-15
+-- SELECT dws.biz_date('2026-02-01 07:00:00+08'::timestamptz, 8);     -- 预期：2026-01-31（月末边界）
+-- SELECT dws.biz_date(NOW());                                         -- 预期：当前营业日
+
+-- 回滚：
+-- DROP FUNCTION IF EXISTS dws.biz_date(timestamptz, int);