49 lines
2.6 KiB
Go
49 lines
2.6 KiB
Go
package domain
|
||
|
||
import "context"
|
||
|
||
/*
|
||
Repository 是 radar module 的持久化介面。實作有兩份：mongo（正式）與 memory（測試），
|
||
兩份行為必須一致，尤其是「找不到」一律回 ErrNotFound 而非 nil。
|
||
*/
|
||
type Repository interface {
|
||
// ServiceProfile：每會員一份
|
||
GetServiceProfile(ctx context.Context, ownerUID int64) (*ServiceProfile, error)
|
||
SaveServiceProfile(ctx context.Context, p *ServiceProfile) error
|
||
|
||
// RadarWatch
|
||
SaveWatch(ctx context.Context, w *RadarWatch) error
|
||
GetWatch(ctx context.Context, id string) (*RadarWatch, error)
|
||
ListWatches(ctx context.Context, ownerUID int64, f WatchListFilter) ([]*RadarWatch, int64, error)
|
||
// ListActiveWatches 是每日排程的來源，只回 active。
|
||
ListActiveWatches(ctx context.Context, ownerUID int64) ([]*RadarWatch, error)
|
||
// ListAllActiveWatches 跨會員列出全部 active watch，供 worker 每日排程 tick 使用。
|
||
ListAllActiveWatches(ctx context.Context) ([]*RadarWatch, error)
|
||
CountActiveWatches(ctx context.Context, ownerUID int64) (int64, error)
|
||
TouchWatchSweptAt(ctx context.Context, id string, at int64) error
|
||
|
||
// Opportunity
|
||
// UpsertByExternalID：同 owner+external_id 只留一筆；命中則併 matched_terms，不重跑判定。
|
||
UpsertByExternalID(ctx context.Context, o *Opportunity) (*Opportunity, error)
|
||
GetOpportunity(ctx context.Context, id string) (*Opportunity, error)
|
||
GetByExternalID(ctx context.Context, ownerUID int64, externalID string) (*Opportunity, error)
|
||
ListOpportunities(ctx context.Context, ownerUID int64, f OpportunityListFilter) ([]*Opportunity, int64, error)
|
||
// CountToday 回傳 UTC 當日建立的商機數（每日配額池）。
|
||
CountToday(ctx context.Context, ownerUID int64, at int64) (int64, error)
|
||
UpdateOpportunityStatus(ctx context.Context, id string, status string) error
|
||
SetOpportunityOverride(ctx context.Context, id string, ov *OpportunityOverride, newBand, newStatus string) error
|
||
|
||
// RadarSweep
|
||
CreateSweep(ctx context.Context, s *RadarSweep) error
|
||
// UpdateSweep 累加計數與 judged_external_ids（去重），供 Job 中途進度與續跑。
|
||
UpdateSweep(ctx context.Context, id string, delta SweepDelta) (*RadarSweep, error)
|
||
GetSweep(ctx context.Context, id string) (*RadarSweep, error)
|
||
GetSweepByJobID(ctx context.Context, jobID string) (*RadarSweep, error)
|
||
ListSweeps(ctx context.Context, ownerUID int64, f SweepListFilter) ([]*RadarSweep, int64, error)
|
||
|
||
// ReplyVariant
|
||
SaveReply(ctx context.Context, r *ReplyVariant) error
|
||
ListReplies(ctx context.Context, ownerUID int64, opportunityID string) ([]*ReplyVariant, error)
|
||
GetReply(ctx context.Context, id string) (*ReplyVariant, error)
|
||
}
|