adminorder

type ActivationEnqueuer ¶

type ActivationEnqueuer interface {
	EnqueueActivation(ctx context.Context, orderNo string) error
}

ActivationEnqueuer mirrors the facade's activation queue port.

type DailyReport ¶ added in v1.15.16

type DailyReport struct {
	Date     time.Time
	Orders   int64
	Amount   int64
	ByPlan   []DailyReportLine
	ByMethod []DailyReportLine
}

DailyReport summarises the orders settled on one day. Amounts stay in minor units; formatting belongs to whoever renders the report.

type DailyReportLine ¶ added in v1.15.16

type DailyReportLine struct {
	Name   string
	Orders int64
	Amount int64
}

DailyReportLine is one plan or payment-method row of the daily report.

type Deps ¶ added in v1.21.0

type Deps struct {
	Orders   Orders
	Payments gateway.MethodFinder
	// Coupons resolves the coupon an administrator's order names; UserSubs
	// the subscription a renewal or traffic reset applies to; Inventory
	// holds the plan unit of a new subscription order. An order that needs
	// one of them is refused when it is not configured.
	Coupons   pricing.CouponFinder
	UserSubs  UserSubscriptionReader
	Inventory Inventory
	Tx        Transactor
	Queue     ActivationEnqueuer
	// Plans resolves plan names for the daily report; optional so callers
	// that only manage orders need not provide it.
	Plans  PlanNameReader
	Closer OrderCloser
}

type Inventory ¶ added in v1.21.0

type Inventory interface {
	Reserve(ctx context.Context, orderNo string, subscribeID int64) error
}

Inventory reserves a plan unit for a new subscription order, as the buyer's own purchase reserves it (ADR-001 step 2).

type OrderCloser ¶ added in v1.21.0

type OrderCloser interface {
	CloseByAdmin(ctx context.Context, orderNo string, adminID int64) (bool, error)
}

OrderCloser is the checkout close flow shared with owner and expiry closes; it reports whether the call closed the order.

type Orders ¶ added in v1.21.0

type Orders interface {
	FindOne(ctx context.Context, id int64) (*order.Order, error)
	QueryOrderListByPage(ctx context.Context, page, size int, status uint8, user, subscribe int64, search string) (int64, []*order.Details, error)
	QueryDailyReport(ctx context.Context, date time.Time) (*order.DailyReport, error)
}

Orders is the order persistence administration reads outside a transaction.

type PlanNameReader ¶ added in v1.15.16

type PlanNameReader interface {
	FindOne(ctx context.Context, id int64) (*subscribe.Subscribe, error)
}

PlanNameReader is the read port onto the subscription domain's plan catalogue, used to label the daily report's plan breakdown.

type Service ¶

type Service struct {
	// contains filtered or unexported fields
}

func NewService(deps Deps) *Service

func (s *Service) Create(ctx context.Context, req *dto.CreateOrderRequest) error

func (s *Service) DailyReport(ctx context.Context, date time.Time) (*DailyReport, error)

func (s *Service) List(ctx context.Context, req *dto.GetOrderListRequest) (*dto.GetOrderListResponse, error)

func (s *Service) UpdateStatus(ctx context.Context, req *dto.UpdateOrderStatusRequest) error

type Transactor ¶

type Transactor interface {
	InBillingTx(ctx context.Context, fn func(repository.BillingStore) error) error
}

Transactor mirrors the facade's billing-scoped transaction port.

type UserSubscriptionReader ¶ added in v1.21.0

type UserSubscriptionReader interface {
	FindOneUserSubscribe(ctx context.Context, id int64) (*usersub.SubscribeDetails, error)
}

UserSubscriptionReader resolves the user subscription a renewal or traffic-reset order an administrator creates applies to.