90 lines
3.1 KiB
Go
90 lines
3.1 KiB
Go
// Copyright (C) 2019 Storj Labs, Inc.
|
|
// See LICENSE for copying information.
|
|
|
|
package payments
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
|
|
"github.com/skyrings/skyring-common/tools/uuid"
|
|
|
|
"storj.io/common/memory"
|
|
)
|
|
|
|
// Coupons exposes all needed functionality to manage coupons.
|
|
//
|
|
// architecture: Service
|
|
type Coupons interface {
|
|
// ListByUserID return list of all coupons of specified payment account.
|
|
ListByUserID(ctx context.Context, userID uuid.UUID) ([]Coupon, error)
|
|
|
|
// Create attaches a coupon for payment account.
|
|
Create(ctx context.Context, coupon Coupon) (err error)
|
|
|
|
// AddPromotionalCoupon is used to add a promotional coupon for specified users who already have
|
|
// a project and do not have a promotional coupon yet.
|
|
// And updates project limits to selected size.
|
|
AddPromotionalCoupon(ctx context.Context, userID uuid.UUID, duration int, amount int64, projectLimit memory.Size) error
|
|
|
|
// PopulatePromotionalCoupons is used to populate promotional coupons through all active users who already have
|
|
// a project, payment method and do not have a promotional coupon yet.
|
|
// And updates project limits to selected size.
|
|
PopulatePromotionalCoupons(ctx context.Context, duration int, amount int64, projectLimit memory.Size) error
|
|
}
|
|
|
|
// Coupon is an entity that adds some funds to Accounts balance for some fixed period.
|
|
// Coupon is attached to the project.
|
|
// At the end of the period, the entire remaining coupon amount will be returned from the account balance.
|
|
type Coupon struct {
|
|
ID uuid.UUID `json:"id"`
|
|
UserID uuid.UUID `json:"userId"`
|
|
ProjectID uuid.UUID `json:"projectId"`
|
|
Amount int64 `json:"amount"` // Amount is stored in cents.
|
|
Duration int `json:"duration"` // Duration is stored in number ob billing periods.
|
|
Description string `json:"description"`
|
|
Type CouponType `json:"type"`
|
|
Status CouponStatus `json:"status"`
|
|
Created time.Time `json:"created"`
|
|
}
|
|
|
|
// IsExpired checks if coupon is not after its rollup period.
|
|
func (coupon *Coupon) IsExpired() bool {
|
|
expirationDate := time.Date(coupon.Created.Year(), coupon.Created.Month(), 0, 0, 0, 0, 0, coupon.Created.Location())
|
|
expirationDate.AddDate(0, coupon.Duration, 0)
|
|
|
|
now := time.Now().UTC()
|
|
now = time.Date(now.Year(), now.Month(), 0, 0, 0, 0, 0, coupon.Created.Location())
|
|
|
|
return expirationDate.Before(now)
|
|
}
|
|
|
|
// CouponType indicates the type of the coupon.
|
|
type CouponType int
|
|
|
|
const (
|
|
// CouponTypePromotional defines that this coupon is a promotional coupon.
|
|
// Promotional coupon is added only once per account.
|
|
CouponTypePromotional CouponType = 0
|
|
)
|
|
|
|
// CouponStatus indicates the state of the coupon.
|
|
type CouponStatus int
|
|
|
|
const (
|
|
// CouponActive is a default coupon state.
|
|
CouponActive CouponStatus = 0
|
|
// CouponUsed status indicates that coupon was used.
|
|
CouponUsed CouponStatus = 1
|
|
// CouponExpired status indicates that coupon is expired and unavailable.
|
|
CouponExpired CouponStatus = 2
|
|
)
|
|
|
|
// CouponsPage holds set of coupon and indicates if
|
|
// there are more coupons to fetch.
|
|
type CouponsPage struct {
|
|
Coupons []Coupon
|
|
Next bool
|
|
NextOffset int64
|
|
}
|