pangolin/server/migrations/sqlite/000017_usage_hourly.up.sql

-- 按 UTC「小时桶」记录账户用量,供 /v1/usage 按客户端时区聚合成「本地日」曲线
-- (修「今天显示昨天数据」的时区 bug:不再服务端按 UTC 预切天,而是存小时、查询时带
--  客户端时区偏移按本地日聚合)。usage_daily 仍保留作配额/今日/解锁。
-- hour = unix 纪元小时数(floor(unix_seconds/3600),UTC),整数无时区歧义、聚合好算。
-- 稀疏:无用量的小时不落行(用户非 24h 在线,实际远少于 24 行/天)。
CREATE TABLE usage_hourly (
  user_id      INTEGER NOT NULL,
  hour         INTEGER NOT NULL,    -- unix 纪元小时(UTC)
  bytes_up     INTEGER NOT NULL DEFAULT 0,
  bytes_down   INTEGER NOT NULL DEFAULT 0,
  minutes_used INTEGER NOT NULL DEFAULT 0,
  PRIMARY KEY (user_id, hour)
);