mirror of
https://github.com/Wei-Shaw/sub2api.git
synced 2026-10-16 07:33:06 +08:00
shaw
99b357083e
日额度窗口恢复日历日语义（配置时区每天 0 点刷新），修复 v0.1.170 引入的回归： - 手动重置配额后日窗口锚点漂移到重置时刻，此后 0 点不再刷新 - 新建/续费订阅日窗口按购买或首用时刻滚动，而非 0 点刷新 日窗口三处锚点（激活/手动重置/续期）统一写入当天 0 点，自动重置改为跨日历日 边界触发；存量非 0 点锚点在下一个 0 点自愈，无需数据库迁移。周/月窗口保持 期限对齐滚动语义（含到期约束）不变，不回归 issue #5051 的月额度翻倍问题。 日卡一次性额度豁免逻辑保留。
46 lines
2.9 KiB
Go
46 lines
2.9 KiB
Go
package service
|
||
|
||
import (
|
||
"context"
|
||
"time"
|
||
|
||
"github.com/Wei-Shaw/sub2api/internal/pkg/pagination"
|
||
)
|
||
|
||
type UserSubscriptionRepository interface {
|
||
Create(ctx context.Context, sub *UserSubscription) error
|
||
GetByID(ctx context.Context, id int64) (*UserSubscription, error)
|
||
GetByIDForUpdate(ctx context.Context, id int64) (*UserSubscription, error)
|
||
GetByIDIncludeDeleted(ctx context.Context, id int64) (*UserSubscription, error)
|
||
GetByUserIDAndGroupID(ctx context.Context, userID, groupID int64) (*UserSubscription, error)
|
||
GetActiveByUserIDAndGroupID(ctx context.Context, userID, groupID int64) (*UserSubscription, error)
|
||
Update(ctx context.Context, sub *UserSubscription) error
|
||
Delete(ctx context.Context, id int64) error
|
||
Restore(ctx context.Context, subscriptionID int64, restoredStatus string) (*UserSubscription, error)
|
||
|
||
ListByUserID(ctx context.Context, userID int64) ([]UserSubscription, error)
|
||
ListActiveByUserID(ctx context.Context, userID int64) ([]UserSubscription, error)
|
||
ListByGroupID(ctx context.Context, groupID int64, params pagination.PaginationParams) ([]UserSubscription, *pagination.PaginationResult, error)
|
||
List(ctx context.Context, params pagination.PaginationParams, userID, groupID *int64, status, platform, sortBy, sortOrder string) ([]UserSubscription, *pagination.PaginationResult, error)
|
||
|
||
ExistsByUserIDAndGroupID(ctx context.Context, userID, groupID int64) (bool, error)
|
||
ExistsActiveByUserIDAndGroupID(ctx context.Context, userID, groupID int64) (bool, error)
|
||
ExtendExpiry(ctx context.Context, subscriptionID int64, newExpiresAt time.Time) error
|
||
UpdateStatus(ctx context.Context, subscriptionID int64, status string) error
|
||
UpdateNotes(ctx context.Context, subscriptionID int64, notes string) error
|
||
|
||
// ActivateWindows 首次使用时激活用量窗口。日窗口按日历日对齐，锚点为当天 0 点
|
||
// （dailyStart）；周/月窗口为期限对齐滚动窗口，锚点为激活时刻（periodicStart）。
|
||
// 仅当三个窗口均未激活时生效。
|
||
ActivateWindows(ctx context.Context, id int64, dailyStart, periodicStart time.Time) error
|
||
// ResetUsageWindows 手动重置所选窗口的用量。日窗口锚点写入 dailyStart（当天 0 点，
|
||
// 保持 0 点刷新节奏不漂移）；周/月窗口锚点写入 periodicStart（重置时刻）。
|
||
ResetUsageWindows(ctx context.Context, id int64, resetDaily, resetWeekly, resetMonthly bool, dailyStart, periodicStart time.Time) error
|
||
ResetDailyUsage(ctx context.Context, id int64, expectedWindowStart *time.Time, newWindowStart time.Time) error
|
||
ResetWeeklyUsage(ctx context.Context, id int64, expectedWindowStart *time.Time, newWindowStart time.Time) error
|
||
ResetMonthlyUsage(ctx context.Context, id int64, expectedWindowStart *time.Time, newWindowStart time.Time) error
|
||
IncrementUsage(ctx context.Context, id int64, costUSD float64) error
|
||
|
||
BatchUpdateExpiredStatus(ctx context.Context) (int64, error)
|
||
}
|