model

type APIError struct {
	// Code is the HTTP status code.
	Code int
	// Internal is the original error (logged but never sent to clients).
	Internal error
	// Public is the human-readable message sent to clients.
	Public string
}

type APIResponse struct {
	RequestID uuid.UUID `json:"request_id,omitempty"`
	Status    int       `json:"status"`
	Data      any       `json:"data,omitempty"`
	Error     string    `json:"error,omitempty"`
}

type Account struct {
	ID   uuid.UUID
	Code string
	Name string
	Type AccountType
}

type AccountBalance struct {
	AccountCode string
	AccountName string
	AccountType AccountType
	TotalDebit  int64
	TotalCredit int64
}

type AccountType string

type Branch struct {
	ID        uuid.UUID
	CompanyID uuid.UUID
	Name      string
	Address   string
	CreatedAt time.Time
	UpdatedAt time.Time
}

type Company struct {
	ID        uuid.UUID
	OwnerID   uuid.UUID
	Name      string
	Handle    string // URL slug, globally unique, lowercase alphanum + hyphens
	Currency  string // ISO 4217, e.g. "USD", "IDR"
	CreatedAt time.Time
	UpdatedAt time.Time
	// LogoFileID references the company's current logo, if any, in the
	// files table. nil means no logo has been uploaded.
	LogoFileID *uuid.UUID
}

type Customer struct {
	ID        uuid.UUID
	CompanyID uuid.UUID
	Name      string
	Email     string
	Phone     string
	CreatedAt time.Time
	UpdatedAt time.Time
}

type Discount struct {
	ID        uuid.UUID
	CompanyID uuid.UUID
	Name      string
	Type      DiscountType
	// Value is cents for fixed discounts and 1–100 (integer %) for percentage discounts.
	Value     int64
	Active    bool
	CreatedAt time.Time
	// Code, when set, lets this discount be redeemed by a cashier-entered
	// coupon code at POS checkout instead of being picked from the list.
	Code *string
	// ValidFrom/ValidUntil optionally bound when this discount can be
	// applied. Nil means no bound on that side.
	ValidFrom  *time.Time
	ValidUntil *time.Time
	// MaxRedemptions optionally caps how many orders may redeem this
	// discount in total. Nil means unlimited.
	MaxRedemptions *int
}

type DiscountRedemption struct {
	ID         uuid.UUID
	DiscountID uuid.UUID
	OrderID    uuid.UUID
	CompanyID  uuid.UUID
	CreatedAt  time.Time
}

type DiscountType string

type Expense struct {
	ID          uuid.UUID
	CompanyID   uuid.UUID
	Description string
	Amount      int64  // smallest currency unit, > 0
	AccountCode string // COA debit account (default "6000")
	PaidFrom    string // COA credit account representing payment source (default "1000")
	CreatedAt   time.Time
}

type File struct {
	ID         uuid.UUID
	CompanyID  uuid.UUID
	Intent     string
	StorageKey string
	MimeType   string
	SizeBytes  int64
	UploadedBy *uuid.UUID
	CreatedAt  time.Time
}

type InventoryLine struct {
	ProductID         uuid.UUID `json:"product_id"`
	ProductName       string    `json:"product_name"`
	ProductType       string    `json:"product_type"`
	CurrentStock      float64   `json:"current_stock"`
	LastPurchasePrice int64     `json:"last_purchase_price"`
	StockValue        int64     `json:"stock_value"`
	LowStock          bool      `json:"low_stock"`
}

type InventoryReport struct {
	Items []InventoryLine `json:"items"`
}

type JournalEntry struct {
	ID          uuid.UUID
	CompanyID   uuid.UUID
	Description string
	EventName   string // originating domain event, for audit/filtering
	Reference   string // e.g. order_id, expense_id
	Lines       []JournalLine
	CreatedAt   time.Time
}

type JournalLine struct {
	ID        uuid.UUID
	EntryID   uuid.UUID
	AccountID uuid.UUID
	Debit     int64 // amount in smallest currency unit; 0 when this is a credit leg
	Credit    int64 // amount in smallest currency unit; 0 when this is a debit leg
}

type MovementReason string

type Order struct {
	ID             uuid.UUID
	CompanyID      uuid.UUID
	BranchID       uuid.UUID // denormalized from session at create time
	StationID      uuid.UUID // denormalized from session at create time
	SessionID      uuid.UUID
	CustomerID     *uuid.UUID
	ReceiptNumber  string // stamped during checkout; empty while open
	Status         OrderStatus
	Total          int64      // net total = ∑(item.Subtotal) − DiscountAmount
	DiscountAmount int64      // order-level discount in smallest currency unit; 0 when none
	DiscountID     *uuid.UUID // optional reference to the named Discount applied at order level
	VoidedBy       *uuid.UUID
	VoidedAt       *time.Time
	CreatedAt      time.Time
	UpdatedAt      time.Time
}

type OrderItem struct {
	ID             uuid.UUID
	OrderID        uuid.UUID
	ProductID      uuid.UUID
	Quantity       int64      // whole units only
	UnitPrice      int64      // snapshot of Product.BasePrice at AddItem time
	DiscountAmount int64      // item-level discount in smallest currency unit; 0 when none
	DiscountID     *uuid.UUID // optional reference to the named Discount applied at item level
	Subtotal       int64      // (UnitPrice × Quantity) − DiscountAmount
}

type OrderReturn struct {
	ID              uuid.UUID
	CompanyID       uuid.UUID
	OriginalOrderID uuid.UUID
	RefundAmount    int64
	RefundMethod    PaymentMethod
	Reason          string
	CreatedBy       uuid.UUID
	CreatedAt       time.Time
}

type OrderReturnItem struct {
	ID          uuid.UUID
	ReturnID    uuid.UUID
	OrderItemID uuid.UUID
	ProductID   uuid.UUID
	Quantity    int64
	UnitPrice   int64
	Subtotal    int64
}

type OrderStatus string

type PLReport struct {
	Summary PLSummary `json:"summary"`
}

type PLSummary struct {
	Revenue   int64 `json:"revenue"`
	Expenses  int64 `json:"expenses"`
	NetProfit int64 `json:"net_profit"`
}

type POSSession struct {
	ID          uuid.UUID
	CompanyID   uuid.UUID
	BranchID    uuid.UUID // denormalized from station at open time
	StationID   uuid.UUID
	UserID      uuid.UUID // user who opened the session
	Status      SessionStatus
	OpeningCash int64 // cash float placed in drawer before trading; default 0
	OpenedAt    time.Time
	ClosedAt    *time.Time
}

type POSStation struct {
	ID        uuid.UUID
	CompanyID uuid.UUID // denormalized from branch for efficient queries
	BranchID  uuid.UUID
	Name      string
	CreatedAt time.Time
	UpdatedAt time.Time
}

type Payment struct {
	ID        uuid.UUID
	OrderID   uuid.UUID
	Amount    int64
	Method    PaymentMethod
	Status    PaymentStatus
	CreatedAt time.Time
	// TenderedAmount is what the customer physically handed over for a cash
	// payment (nil for card/transfer, or for a cash leg submitted without
	// one). Change given = TenderedAmount - Amount.
	TenderedAmount *int64
}

type PaymentMethod string

type PaymentMethodRevenue struct {
	Method  string `json:"method"`
	Revenue int64  `json:"revenue"`
}

type PaymentStatus string

type Product struct {
	ID        uuid.UUID
	CompanyID uuid.UUID
	Type      ProductType
	Name      string
	BasePrice int64  // smallest currency unit; must be 0 for ingredients
	Unit      string // "kg", "ml", "pcs" — must be used consistently throughout
	// LowStockThreshold flags CurrentStock at or below this level (but above
	// zero) as "low" on the Inventory page and dashboard. Not meaningful for
	// recipe products, which have no stock of their own.
	LowStockThreshold int64
	// SKU is the barcode/lookup code used at the POS. Unique per company.
	// Defaults to the product's own ID (as a string) when not explicitly set.
	SKU         string
	CreatedAt   time.Time
	UpdatedAt   time.Time
	ImageFileID *uuid.UUID // nil = no image
}

type ProductType string

type RecipeComponent struct {
	ID           uuid.UUID
	RecipeID     uuid.UUID
	IngredientID uuid.UUID
	Quantity     float64 // NUMERIC(12,4); same unit as the ingredient's Unit field
}

type RecipeOverhead struct {
	ID          uuid.UUID
	RecipeID    uuid.UUID
	Description string
	Cost        int64 // smallest currency unit
}

type SalesPeriod struct {
	Period  string `json:"period"` // "2026-01-15" | "2026-W03" | "2026-01"
	Revenue int64  `json:"revenue"`
	Orders  int64  `json:"orders"`
}

type SalesReport struct {
	Summary         SalesSummary           `json:"summary"`
	ByPeriod        []SalesPeriod          `json:"by_period"`
	ByPaymentMethod []PaymentMethodRevenue `json:"by_payment_method"`
	TopProducts     []TopProduct           `json:"top_products"`
}

type SalesSummary struct {
	TotalRevenue int64 `json:"total_revenue"`
	TotalOrders  int64 `json:"total_orders"`
	TotalReturns int64 `json:"total_returns"`
	NetRevenue   int64 `json:"net_revenue"`
}

type SessionReconciliation struct {
	SessionID    uuid.UUID
	CompanyID    uuid.UUID
	ExpectedCash int64 // OpeningCash + SUM of cash-method payments in the session
	DeclaredCash int64 // physically counted by the cashier at close
	Difference   int64 // DeclaredCash − ExpectedCash; negative = shortage
	ReconciledBy uuid.UUID
	ReconciledAt time.Time
}

type SessionStatus string

type StockMovement struct {
	ID         uuid.UUID
	CompanyID  uuid.UUID
	ProductID  uuid.UUID
	Reason     MovementReason
	Delta      float64 // signed quantity in the product's unit
	UnitCost   *int64  // smallest currency unit; non-nil only for procurement/opening_balance
	Notes      string
	CreatedAt  time.Time  // immutable; no UpdatedAt
	SupplierID *uuid.UUID // optional; set only for procurement movements

	// ReversesMovementID is set only when Reason is ReasonCorrection, pointing
	// at the movement this one cancels out.
	ReversesMovementID *uuid.UUID
}

type Supplier struct {
	ID        uuid.UUID
	CompanyID uuid.UUID
	Name      string
	Contact   string
	Phone     string
	Email     string
	Address   string
	CreatedAt time.Time
	UpdatedAt time.Time
}

type SupplierPayment struct {
	ID         uuid.UUID
	CompanyID  uuid.UUID
	SupplierID uuid.UUID
	Amount     int64 // smallest currency unit, > 0
	Notes      string
	PaidFrom   string // COA credit account representing payment source (default "1000")
	CreatedAt  time.Time
}

type TopProduct struct {
	ProductID   uuid.UUID `json:"product_id"`
	ProductName string    `json:"product_name"`
	Revenue     int64     `json:"revenue"`
	UnitsSold   int64     `json:"units_sold"`
}

type User struct {
	ID           uuid.UUID
	Email        string
	Name         string
	Role         auth.UserRole
	PasswordHash string
	CompanyID    *uuid.UUID // nil for owners; required for managers and cashiers
	CreatedAt    time.Time
	UpdatedAt    time.Time
	// TokenValidAfter, when set, invalidates any JWT issued (iat) before this
	// time for this user — checked in handler.JWTParserMiddleware and
	// AuthService.RefreshTokens. nil means no restriction.
	TokenValidAfter *time.Time
}