efrilmandClaude Opus 5.5
cf5332c281
Adds the system payment method for paying with EnakPoint (docs/prd-point-coin.md F9, §8, §10.5, PC-303). Migration 000094 allows the point type, keeps one per organization with a partial unique index, creates it for every existing organization, and adds a trigger that creates it for new ones, as the walk-in customer is. It adds payments.points_used and point_value. Their CHECK is written so it can never be NULL: the PRD form, (both NULL) OR (both > 0), is NULL for points_used with a NULL point_value, which a CHECK lets through, so a payment could have lost the value a refund depends on. A test caught it. The API cannot create, delete or retype the EnakPoint method, nor turn another method into one; that answers 400. Renaming it is allowed. The method list takes the outlet from ?outlet_id= or the user's outlet and leaves EnakPoint out when that outlet does not accept it, filtered in the query so the count stays right. The organization-wide active list is unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
109 lines
4.6 KiB
Go
109 lines
4.6 KiB
Go
package entities
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/google/uuid"
|
|
"gorm.io/gorm"
|
|
)
|
|
|
|
type PaymentMethodType string
|
|
|
|
const (
|
|
PaymentMethodTypeCash PaymentMethodType = "cash"
|
|
PaymentMethodTypeCard PaymentMethodType = "card"
|
|
PaymentMethodTypeDigitalWallet PaymentMethodType = "digital_wallet"
|
|
// The system method for paying with EnakPoint (docs/prd-point-coin.md F9). One per
|
|
// organization; it cannot be created, deleted or retyped through the API.
|
|
PaymentMethodTypePoint PaymentMethodType = "point"
|
|
)
|
|
|
|
type PaymentMethod struct {
|
|
ID uuid.UUID `gorm:"type:uuid;primary_key;default:gen_random_uuid()" json:"id"`
|
|
OrganizationID uuid.UUID `gorm:"type:uuid;not null;index" json:"organization_id" validate:"required"`
|
|
Name string `gorm:"not null;size:100" json:"name" validate:"required,min=1,max=100"`
|
|
Type PaymentMethodType `gorm:"not null;size:50" json:"type" validate:"required,oneof=cash card digital_wallet point"`
|
|
Processor *string `gorm:"size:100" json:"processor"`
|
|
Configuration Metadata `gorm:"type:jsonb;default:'{}'" json:"configuration"`
|
|
IsActive bool `gorm:"default:true" json:"is_active"`
|
|
CreatedAt time.Time `gorm:"autoCreateTime" json:"created_at"`
|
|
UpdatedAt time.Time `gorm:"autoUpdateTime" json:"updated_at"`
|
|
|
|
Organization Organization `gorm:"foreignKey:OrganizationID" json:"organization,omitempty"`
|
|
Payments []Payment `gorm:"foreignKey:PaymentMethodID" json:"payments,omitempty"`
|
|
}
|
|
|
|
func (pm *PaymentMethod) BeforeCreate(tx *gorm.DB) error {
|
|
if pm.ID == uuid.Nil {
|
|
pm.ID = uuid.New()
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (PaymentMethod) TableName() string {
|
|
return "payment_methods"
|
|
}
|
|
|
|
type PaymentTransactionStatus string
|
|
|
|
const (
|
|
PaymentTransactionStatusPending PaymentTransactionStatus = "pending"
|
|
PaymentTransactionStatusCompleted PaymentTransactionStatus = "completed"
|
|
PaymentTransactionStatusFailed PaymentTransactionStatus = "failed"
|
|
PaymentTransactionStatusRefunded PaymentTransactionStatus = "refunded"
|
|
)
|
|
|
|
type SplitType string
|
|
|
|
const (
|
|
SplitTypeAmount SplitType = "AMOUNT"
|
|
SplitTypeItem SplitType = "ITEM"
|
|
)
|
|
|
|
type Payment struct {
|
|
ID uuid.UUID `gorm:"type:uuid;primary_key;default:gen_random_uuid()" json:"id"`
|
|
OrderID uuid.UUID `gorm:"type:uuid;not null;index" json:"order_id" validate:"required"`
|
|
PaymentMethodID uuid.UUID `gorm:"type:uuid;not null;index" json:"payment_method_id" validate:"required"`
|
|
Amount float64 `gorm:"type:decimal(10,2);not null" json:"amount" validate:"required,min=0"`
|
|
Status PaymentTransactionStatus `gorm:"default:'pending';size:50" json:"status"`
|
|
TransactionID *string `gorm:"size:255" json:"transaction_id"`
|
|
SplitNumber int `gorm:"default:1" json:"split_number"`
|
|
SplitTotal int `gorm:"default:1" json:"split_total"`
|
|
SplitType *SplitType `gorm:"size:20" json:"split_type,omitempty"`
|
|
SplitDescription *string `gorm:"size:255" json:"split_description,omitempty"`
|
|
RefundAmount float64 `gorm:"type:decimal(10,2);default:0.00" json:"refund_amount"`
|
|
// Set only for a payment with EnakPoint: how many were used, and the rupiah value of
|
|
// one then, frozen so a refund returns exactly what was used.
|
|
PointsUsed *int64 `json:"points_used,omitempty"`
|
|
PointValue *float64 `gorm:"type:decimal(10,2)" json:"point_value,omitempty"`
|
|
RefundReason *string `gorm:"size:255" json:"refund_reason,omitempty"`
|
|
RefundedAt *time.Time `gorm:"" json:"refunded_at,omitempty"`
|
|
RefundedBy *uuid.UUID `gorm:"type:uuid" json:"refunded_by,omitempty"`
|
|
Metadata Metadata `gorm:"type:jsonb;default:'{}'" json:"metadata"`
|
|
CreatedAt time.Time `gorm:"autoCreateTime" json:"created_at"`
|
|
UpdatedAt time.Time `gorm:"autoUpdateTime" json:"updated_at"`
|
|
|
|
Order Order `gorm:"foreignKey:OrderID" json:"order,omitempty"`
|
|
PaymentMethod PaymentMethod `gorm:"foreignKey:PaymentMethodID" json:"payment_method,omitempty"`
|
|
PaymentOrderItems []PaymentOrderItem `gorm:"foreignKey:PaymentID" json:"payment_order_items,omitempty"`
|
|
}
|
|
|
|
func (p *Payment) BeforeCreate(tx *gorm.DB) error {
|
|
if p.ID == uuid.Nil {
|
|
p.ID = uuid.New()
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (Payment) TableName() string {
|
|
return "payments"
|
|
}
|
|
|
|
func (p *Payment) CanBeRefunded() bool {
|
|
return p.Status == PaymentTransactionStatusCompleted
|
|
}
|
|
|
|
func (p *Payment) IsSuccessful() bool {
|
|
return p.Status == PaymentTransactionStatusCompleted
|
|
}
|