app-cloudep-product-service/pkg/domain/usecase/product.go

package usecase

import (
	"context"

	"code.30cm.net/digimon/app-cloudep-product-service/pkg/domain/product"
)

type ProductUseCase interface {
	Base
	// IncOrders 新增訂單數
	IncOrders(ctx context.Context, productID string, count int64) error
	// DecOrders 減少訂單數。-> 退貨時專用
	DecOrders(ctx context.Context, productID string, count int64) error
	// UpdateAverageRating 只更新綜合評價及其更新時間
	UpdateAverageRating(ctx context.Context, productID string, averageRating float64) error
	// IncFansCount 新增粉絲數
	IncFansCount(ctx context.Context, productID string, fansCount uint64) error
	// DecFansCount 減少粉絲數。
	DecFansCount(ctx context.Context, productID string, fansCount uint64) error
	// BindTag 建立一筆 tag 與其他資料（例如專案）的綁定關係
	BindTag(ctx context.Context, binding TagsBindingTable) error
	// UnbindTag 刪除一筆綁定資料
	UnbindTag(ctx context.Context, binding TagsBindingTable) error
	// GetBindingsByReference 根據參照 ID 取得所有綁定資料
	GetBindingsByReference(ctx context.Context, referenceID string) ([]TagsBindingTableResp, error)
	// ListTagBinding 根據查詢條件取得 tag binding 的資料列表
	ListTagBinding(ctx context.Context, params TagBindingQueryParams) ([]TagsBindingTableResp, int64, error)
}
type Base interface {
	Create(ctx context.Context, product *Product) error
	Update(ctx context.Context, id string, product *Product) error
	Delete(ctx context.Context, id string) error
	Get(ctx context.Context, id string) (*ProductResp, error)
	List(ctx context.Context, data ProductQueryParams) ([]*ProductResp, int64, error)
}

type Product struct {
	UID              *string        // 專案擁有者 UID
	Title            *string        // 專案名稱
	ShortTitle       *string        // 計畫簡短標題 -> 不一定要有
	Details          *string        // 詳細內容
	ShortDescription *string        // 簡短描述
	Media            []Media        // 專案動態內容(圖片或者影片)
	Slug             *string        // URL 後綴(查詢用)
	IsPublished      *bool          // 是否已上架
	Amount           uint64         // 目標金額
	StartTime        *string        // 專案開始時間
	EndTime          *string        // 專案結束時間
	Category         *string        // 類別
	CustomFields     []CustomFields // 自定義屬性
	Tags             []string       // 這個專案專屬的 tagID
}

type ProductResp struct {
	ID                      string
	UID                     string         // 專案擁有者 UID
	Title                   string         // 專案名稱
	ShortTitle              string         // 計畫簡短標題 -> 不一定要有
	Details                 string         // 詳細內容
	ShortDescription        string         // 簡短描述
	Media                   []Media        // 專案動態內容(圖片或者影片)
	Slug                    string         // URL 後綴(查詢用)
	IsPublished             bool           // 是否已上架
	Amount                  uint64         // 目標金額
	StartTime               string         // 專案開始時間
	EndTime                 string         // 專案結束時間
	Category                string         // 類別
	CustomFields            []CustomFields // 自定義屬性
	Tags                    []Tags         // 這個專案專屬的 tagID
	Orders                  uint64         // 總接單數
	OrdersUpdateTime        string         // 更新總接單數的時間
	AverageRating           float64        // 綜合評價（如：4.5 顆星）
	AverageRatingUpdateTime string         // 更新評價的時間
	FansCount               uint64         // 追蹤數量
	FansCountUpdateTime     string         // 更新追蹤的時間
	UpdatedAt               string         // 更新時間
	CreatedAt               string         // 建立時間
}

type Media struct {
	Sort uint64
	Type string
	URL  string
}

type CustomFields struct {
	Key   string `bson:"key"`
	Value string `bson:"value"`
}

type ProductQueryParams struct {
	UID         *string // 專案擁有者 UID
	IsPublished *bool   // 是否已上架
	Category    *string // 類別
	StartTime   *int64  // 起始時間（Unix 時間戳）
	EndTime     *int64  // 結束時間（Unix 時間戳）
	Slug        *string // URL 後綴

	PageIndex int64 // 頁碼
	PageSize  int64 // 每頁數量
}

type Tags struct {
	ID        string           // 專案 ID
	Types     product.ItemType // Tag 類型
	Name      string           // tag 名稱
	ShowType  product.ShowType // 顯示筐
	Cover     string           // 封面圖片
	UpdatedAt string           // 更新時間
	CreatedAt string           // 創建時間
}

type TagsBindingTable struct {
	ReferenceID string // 參照 id (可能為專案或其他的東西）
	TagID       string // tag id
}

type TagsBindingTableResp struct {
	ID          string
	ReferenceID string // 參照 id (可能為專案或其他的東西）
	TagID       string // tag id
	UpdatedAt   string // 更新時間
	CreatedAt   string // 創建時間
}

// TagBindingQueryParams 為查詢 TagBindingTable 時的參數結構
type TagBindingQueryParams struct {
	ReferenceID *string // 過濾參照 ID
	TagID       *string // 過濾 Tag ID
	PageSize    int64
	PageIndex   int64
}