Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

Split the order detail page into per-card components

Damian Legawiec5fe68bf75b8c
diff --git a/packages/dashboard/src/components/spree/orders/order-adjustments-cards.tsx b/packages/dashboard/src/components/spree/orders/order-adjustments-cards.tsx
new file mode 100644
index 0000000000..09e68ce5ad
--- /dev/null
+++ b/packages/dashboard/src/components/spree/orders/order-adjustments-cards.tsx
@@ -0,0 +1,615 @@
+import type { Discount, Fee, Order } from '@spree/admin-sdk'
+import { adminClient, formatPrice } from '@spree/dashboard-core'
+import {
+ Badge,
+ Button,
+ Card,
+ CardAction,
+ CardContent,
+ CardHeader,
+ CardTitle,
+ Dialog,
+ DialogBody,
+ DialogContent,
+ DialogDescription,
+ DialogFooter,
+ DialogHeader,
+ DialogTitle,
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuItem,
+ DropdownMenuTrigger,
+ Field,
+ FieldGroup,
+ FieldLabel,
+ Input,
+ Select,
+ SelectContent,
+ SelectItem,
+ SelectTrigger,
+ SelectValue,
+ Table,
+ TableBody,
+ TableCell,
+ TableHead,
+ TableHeader,
+ TableRow,
+ useConfirm,
+} from '@spree/dashboard-ui'
+import i18n from 'i18next'
+import { EllipsisVerticalIcon, PlusIcon, TrashIcon } from 'lucide-react'
+import { type FormEvent, useState } from 'react'
+import { useTranslation } from 'react-i18next'
+import {
+ useOrderAdjustmentLinesMutation,
+ useOrderDiscounts,
+ useOrderFees,
+ useOrderTaxLines,
+} from '../../../hooks/use-order'
+import { FEE_KINDS } from '../../../schemas/order'
+
+/** The API accepts any kind string, so unknown values fall back to the raw value. */
+function feeKindLabel(kind: string) {
+ return (FEE_KINDS as readonly string[]).includes(kind)
+ ? i18n.t(`admin.orders.detail.adjustment_lines.fee_kind_${kind}`)
+ : kind
+}
+
+/** Trailing action cell — renders empty (keeping column width) for undeletable rows. */
+function AdjustmentDeleteCell({
+ onDelete,
+ deleting,
+}: {
+ onDelete?: () => void
+ deleting?: boolean
+}) {
+ return (
+ <TableCell className="w-10 text-right">
+ {onDelete && (
+ <DropdownMenu>
+ <DropdownMenuTrigger asChild>
+ <Button
+ variant="ghost"
+ size="icon-xs"
+ disabled={deleting}
+ aria-label={i18n.t('admin.actions.actions_menu')}
+ >
+ <EllipsisVerticalIcon className="size-4" />
+ </Button>
+ </DropdownMenuTrigger>
+ <DropdownMenuContent align="end">
+ <DropdownMenuItem
+ className="text-destructive focus:text-destructive"
+ onClick={onDelete}
+ >
+ <TrashIcon className="size-4" />
+ {i18n.t('admin.actions.delete')}
+ </DropdownMenuItem>
+ </DropdownMenuContent>
+ </DropdownMenu>
+ )}
+ </TableCell>
+ )
+}
+
+export function TaxLinesCard({ order }: { order: Order }) {
+ const { t } = useTranslation()
+ const orderId = order.id
+ const { data: taxLines } = useOrderTaxLines(orderId)
+
+ // Tax rows grouped by label so a rate charged on many lines reads as one row.
+ const taxGroups = new Map<string, { label: string; amount: number }>()
+ for (const row of taxLines?.data ?? []) {
+ const existing = taxGroups.get(row.label)
+ if (existing) {
+ existing.amount += Number.parseFloat(row.amount)
+ } else {
+ taxGroups.set(row.label, { label: row.label, amount: Number.parseFloat(row.amount) })
+ }
+ }
+
+ return (
+ <Card>
+ <CardHeader>
+ <CardTitle>{t('admin.orders.detail.adjustment_lines.taxes')}</CardTitle>
+ </CardHeader>
+
+ {taxGroups.size === 0 ? (
+ <CardContent>
+ <p className="text-sm text-muted-foreground">
+ {t('admin.orders.detail.adjustment_lines.taxes_empty')}
+ </p>
+ </CardContent>
+ ) : (
+ <Table>
+ <TableHeader>
+ <TableRow>
+ <TableHead>{t('admin.orders.detail.adjustment_lines.column_label')}</TableHead>
+ <TableHead className="text-right">
+ {t('admin.orders.detail.adjustment_lines.column_amount')}
+ </TableHead>
+ </TableRow>
+ </TableHeader>
+ <TableBody className="border-t border-border">
+ {[...taxGroups.values()].map((group) => (
+ <TableRow key={group.label}>
+ <TableCell>{group.label}</TableCell>
+ <TableCell className="text-right tabular-nums">
+ {formatPrice({
+ amount: group.amount.toFixed(2),
+ currency: order.currency,
+ display_amount: null,
+ })}
+ </TableCell>
+ </TableRow>
+ ))}
+ </TableBody>
+ </Table>
+ )}
+ </Card>
+ )
+}
+
+export function OrderDiscountsCard({ order }: { order: Order }) {
+ const { t } = useTranslation()
+ const orderId = order.id
+ const confirm = useConfirm()
+ const [addDiscountOpen, setAddDiscountOpen] = useState(false)
+
+ const { data: discounts } = useOrderDiscounts(orderId)
+ const deleteDiscountMutation = useOrderAdjustmentLinesMutation(orderId, (id: string) =>
+ adminClient.orders.discounts.delete(orderId, id),
+ )
+
+ // Only promotion rows are system-owned; anything else is admin-entered and deletable.
+ const discountRows = discounts?.data ?? []
+
+ async function handleDeleteDiscount(row: Discount) {
+ const confirmed = await confirm({
+ title: t('admin.orders.detail.adjustment_lines.delete_discount_title'),
+ message: t('admin.orders.detail.adjustment_lines.delete_discount_message', {
+ label: row.label,
+ }),
+ confirmLabel: t('admin.actions.delete'),
+ variant: 'destructive',
+ })
+ if (confirmed) deleteDiscountMutation.mutate(row.id)
+ }
+
+ return (
+ <Card>
+ <CardHeader>
+ <CardTitle>{t('admin.orders.detail.adjustment_lines.discounts')}</CardTitle>
+ <CardAction>
+ <Button variant="outline" size="sm" onClick={() => setAddDiscountOpen(true)}>
+ <PlusIcon className="size-4" />
+ {t('admin.orders.detail.adjustment_lines.add_discount')}
+ </Button>
+ </CardAction>
+ </CardHeader>
+
+ {discountRows.length === 0 ? (
+ <CardContent>
+ <p className="text-sm text-muted-foreground">
+ {t('admin.orders.detail.adjustment_lines.discounts_empty')}
+ </p>
+ </CardContent>
+ ) : (
+ <Table>
+ <TableHeader>
+ <TableRow>
+ <TableHead>{t('admin.orders.detail.adjustment_lines.column_label')}</TableHead>
+ <TableHead>{t('admin.orders.detail.adjustment_lines.column_source')}</TableHead>
+ <TableHead>{t('admin.orders.detail.adjustment_lines.column_code')}</TableHead>
+ <TableHead className="text-right">
+ {t('admin.orders.detail.adjustment_lines.column_amount')}
+ </TableHead>
+ <TableHead className="w-10" />
+ </TableRow>
+ </TableHeader>
+ <TableBody className="border-t border-border">
+ {discountRows.map((row) => (
+ <TableRow key={row.id}>
+ <TableCell>{row.label}</TableCell>
+ <TableCell>
+ <Badge variant="secondary">
+ {row.kind === 'promotion'
+ ? t('admin.orders.detail.adjustment_lines.kind_promotion')
+ : t('admin.orders.detail.adjustment_lines.kind_manual')}
+ </Badge>
+ </TableCell>
+ <TableCell className="text-muted-foreground">
+ {row.code ? <Badge variant="outline">{row.code}</Badge> : '—'}
+ </TableCell>
+ <TableCell className="text-right tabular-nums">{row.display_amount}</TableCell>
+ <AdjustmentDeleteCell
+ onDelete={row.kind === 'promotion' ? undefined : () => handleDeleteDiscount(row)}
+ deleting={deleteDiscountMutation.isPending}
+ />
+ </TableRow>
+ ))}
+ </TableBody>
+ </Table>
+ )}
+
+ <AddDiscountDialog order={order} open={addDiscountOpen} onOpenChange={setAddDiscountOpen} />
+ </Card>
+ )
+}
+
+export function FeesCard({ order }: { order: Order }) {
+ const { t } = useTranslation()
+ const orderId = order.id
+ const confirm = useConfirm()
+ const [addFeeOpen, setAddFeeOpen] = useState(false)
+
+ const { data: fees } = useOrderFees(orderId)
+ const deleteFeeMutation = useOrderAdjustmentLinesMutation(orderId, (id: string) =>
+ adminClient.orders.fees.delete(orderId, id),
+ )
+
+ const feeRows = fees?.data ?? []
+
+ async function handleDeleteFee(row: Fee) {
+ const confirmed = await confirm({
+ title: t('admin.orders.detail.adjustment_lines.delete_fee_title'),
+ message: t('admin.orders.detail.adjustment_lines.delete_fee_message', { label: row.label }),
+ confirmLabel: t('admin.actions.delete'),
+ variant: 'destructive',
+ })
+ if (confirmed) deleteFeeMutation.mutate(row.id)
+ }
+
+ return (
+ <Card>
+ <CardHeader>
+ <CardTitle>{t('admin.orders.detail.adjustment_lines.fees')}</CardTitle>
+ <CardAction>
+ <Button variant="outline" size="sm" onClick={() => setAddFeeOpen(true)}>
+ <PlusIcon className="size-4" />
+ {t('admin.orders.detail.adjustment_lines.add_fee')}
+ </Button>
+ </CardAction>
+ </CardHeader>
+
+ {feeRows.length === 0 ? (
+ <CardContent>
+ <p className="text-sm text-muted-foreground">
+ {t('admin.orders.detail.adjustment_lines.fees_empty')}
+ </p>
+ </CardContent>
+ ) : (
+ <Table>
+ <TableHeader>
+ <TableRow>
+ <TableHead>{t('admin.orders.detail.adjustment_lines.column_label')}</TableHead>
+ <TableHead>{t('admin.orders.detail.adjustment_lines.column_kind')}</TableHead>
+ <TableHead className="text-right">
+ {t('admin.orders.detail.adjustment_lines.column_amount')}
+ </TableHead>
+ <TableHead className="w-10" />
+ </TableRow>
+ </TableHeader>
+ <TableBody className="border-t border-border">
+ {feeRows.map((row) => (
+ <TableRow key={row.id}>
+ <TableCell>{row.label}</TableCell>
+ <TableCell className="text-muted-foreground">
+ {row.kind ? <Badge variant="outline">{feeKindLabel(row.kind)}</Badge> : '—'}
+ </TableCell>
+ <TableCell className="text-right tabular-nums">{row.display_amount}</TableCell>
+ <AdjustmentDeleteCell
+ onDelete={() => handleDeleteFee(row)}
+ deleting={deleteFeeMutation.isPending}
+ />
+ </TableRow>
+ ))}
+ </TableBody>
+ </Table>
+ )}
+
+ <AddFeeDialog order={order} open={addFeeOpen} onOpenChange={setAddFeeOpen} />
+ </Card>
+ )
+}
+
+function AddDiscountDialog({
+ order,
+ open,
+ onOpenChange,
+}: {
+ order: Order
+ open: boolean
+ onOpenChange: (open: boolean) => void
+}) {
+ const { t, i18n } = useTranslation()
+ const orderId = order.id
+ const [target, setTarget] = useState('order')
+ const [valueType, setValueType] = useState('flat')
+ const [value, setValue] = useState('')
+
+ const mutation = useOrderAdjustmentLinesMutation(
+ orderId,
+ (params: {
+ label: string
+ value: string
+ value_type: 'flat' | 'percent'
+ line_item_id?: string
+ }) => adminClient.orders.discounts.create(orderId, params),
+ )
+
+ const targetOptions = [
+ { value: 'order', label: t('admin.orders.detail.adjustment_lines.target_order') },
+ ...(order.items ?? []).map((item) => ({ value: item.id, label: item.name ?? item.id })),
+ ]
+ const valueTypeOptions = [
+ { value: 'flat', label: t('admin.orders.detail.adjustment_lines.value_type_flat') },
+ { value: 'percent', label: t('admin.orders.detail.adjustment_lines.value_type_percent') },
+ ]
+
+ function handleSubmit(e: FormEvent<HTMLFormElement>) {
+ e.preventDefault()
+ const fd = new FormData(e.currentTarget)
+ mutation.mutate(
+ {
+ label: fd.get('label') as string,
+ value,
+ value_type: valueType as 'flat' | 'percent',
+ ...(target !== 'order' ? { line_item_id: target } : {}),
+ },
+ {
+ onSuccess: () => {
+ setValue('')
+ onOpenChange(false)
+ },
+ },
+ )
+ }
+
+ // Mirrors Orders::AddManualDiscount: percent applies to the already-
+ // discounted line amounts, clamped so no line goes below zero.
+ const numericValue = Number.parseFloat(value)
+ let previewAmount: number | null = null
+ if (valueType === 'percent' && Number.isFinite(numericValue) && numericValue > 0) {
+ const items = order.items ?? []
+ const base =
+ target === 'order'
+ ? items.reduce(
+ (sum, item) => sum + Math.max(Number.parseFloat(item.discounted_amount), 0),
+ 0,
+ )
+ : Math.max(
+ Number.parseFloat(items.find((item) => item.id === target)?.discounted_amount ?? '0'),
+ 0,
+ )
+ if (base > 0) previewAmount = Math.min((base * numericValue) / 100, base)
+ }
+
+ return (
+ <Dialog open={open} onOpenChange={onOpenChange}>
+ <DialogContent>
+ <DialogHeader>
+ <DialogTitle>{t('admin.orders.detail.adjustment_lines.add_discount')}</DialogTitle>
+ <DialogDescription>
+ {t('admin.orders.detail.adjustment_lines.add_discount_description')}
+ </DialogDescription>
+ </DialogHeader>
+ <form onSubmit={handleSubmit}>
+ <DialogBody>
+ <FieldGroup>
+ <Field>
+ <FieldLabel htmlFor="discount-label">
+ {t('admin.orders.detail.adjustment_lines.label_field')}
+ </FieldLabel>
+ <Input id="discount-label" name="label" required />
+ </Field>
+ <div className="grid grid-cols-2 gap-3">
+ <Field>
+ <FieldLabel htmlFor="discount-value">
+ {t('admin.orders.detail.adjustment_lines.value_field')}
+ </FieldLabel>
+ <Input
+ id="discount-value"
+ name="value"
+ type="number"
+ step="0.01"
+ min="0.01"
+ value={value}
+ onChange={(e) => setValue(e.target.value)}
+ required
+ />
+ </Field>
+ <Field>
+ <FieldLabel>
+ {t('admin.orders.detail.adjustment_lines.value_type_field')}
+ </FieldLabel>
+ <Select
+ items={valueTypeOptions}
+ value={valueType}
+ onValueChange={(v) => setValueType(v as string)}
+ >
+ <SelectTrigger>
+ <SelectValue />
+ </SelectTrigger>
+ <SelectContent>
+ {valueTypeOptions.map((option) => (
+ <SelectItem key={option.value} value={option.value}>
+ {option.label}
+ </SelectItem>
+ ))}
+ </SelectContent>
+ </Select>
+ </Field>
+ </div>
+ <Field>
+ <FieldLabel>{t('admin.orders.detail.adjustment_lines.target_field')}</FieldLabel>
+ <Select
+ items={targetOptions}
+ value={target}
+ onValueChange={(v) => setTarget(v as string)}
+ >
+ <SelectTrigger>
+ <SelectValue />
+ </SelectTrigger>
+ <SelectContent>
+ {targetOptions.map((option) => (
+ <SelectItem key={option.value} value={option.value}>
+ {option.label}
+ </SelectItem>
+ ))}
+ </SelectContent>
+ </Select>
+ </Field>
+ {previewAmount !== null && (
+ <p className="text-sm text-muted-foreground">
+ {t('admin.orders.detail.adjustment_lines.percent_preview', {
+ amount: new Intl.NumberFormat(i18n.language, {
+ style: 'currency',
+ currency: order.currency,
+ }).format(previewAmount),
+ })}
+ </p>
+ )}
+ </FieldGroup>
+ </DialogBody>
+ <DialogFooter>
+ <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
+ {t('admin.actions.cancel')}
+ </Button>
+ <Button type="submit" disabled={mutation.isPending}>
+ {mutation.isPending
+ ? t('admin.actions.saving')
+ : t('admin.orders.detail.adjustment_lines.add_discount')}
+ </Button>
+ </DialogFooter>
+ </form>
+ </DialogContent>
+ </Dialog>
+ )
+}
+
+function AddFeeDialog({
+ order,
+ open,
+ onOpenChange,
+}: {
+ order: Order
+ open: boolean
+ onOpenChange: (open: boolean) => void
+}) {
+ const { t } = useTranslation()
+ const orderId = order.id
+ const [target, setTarget] = useState('order')
+ const [kind, setKind] = useState<string>('surcharge')
+
+ const mutation = useOrderAdjustmentLinesMutation(
+ orderId,
+ (params: { label: string; amount: string; kind?: string; line_item_id?: string }) =>
+ adminClient.orders.fees.create(orderId, params),
+ )
+
+ const targetOptions = [
+ { value: 'order', label: t('admin.orders.detail.adjustment_lines.target_order') },
+ ...(order.items ?? []).map((item) => ({ value: item.id, label: item.name ?? item.id })),
+ ]
+
+ const kindOptions = FEE_KINDS.map((value) => ({
+ value,
+ label: t(`admin.orders.detail.adjustment_lines.fee_kind_${value}`),
+ }))
+
+ function handleSubmit(e: FormEvent<HTMLFormElement>) {
+ e.preventDefault()
+ const fd = new FormData(e.currentTarget)
+ mutation.mutate(
+ {
+ label: fd.get('label') as string,
+ amount: fd.get('amount') as string,
+ kind,
+ ...(target !== 'order' ? { line_item_id: target } : {}),
+ },
+ { onSuccess: () => onOpenChange(false) },
+ )
+ }
+
+ return (
+ <Dialog open={open} onOpenChange={onOpenChange}>
+ <DialogContent>
+ <DialogHeader>
+ <DialogTitle>{t('admin.orders.detail.adjustment_lines.add_fee')}</DialogTitle>
+ <DialogDescription>
+ {t('admin.orders.detail.adjustment_lines.add_fee_description')}
+ </DialogDescription>
+ </DialogHeader>
+ <form onSubmit={handleSubmit}>
+ <DialogBody>
+ <FieldGroup>
+ <Field>
+ <FieldLabel htmlFor="fee-label">
+ {t('admin.orders.detail.adjustment_lines.label_field')}
+ </FieldLabel>
+ <Input id="fee-label" name="label" required />
+ </Field>
+ <div className="grid grid-cols-2 gap-3">
+ <Field>
+ <FieldLabel htmlFor="fee-amount">
+ {t('admin.orders.detail.adjustment_lines.amount_field')}
+ </FieldLabel>
+ <Input id="fee-amount" name="amount" type="number" step="0.01" min="0" required />
+ </Field>
+ <Field>
+ <FieldLabel>{t('admin.orders.detail.adjustment_lines.kind_field')}</FieldLabel>
+ <Select
+ items={kindOptions}
+ value={kind}
+ onValueChange={(v) => setKind(v as string)}
+ >
+ <SelectTrigger>
+ <SelectValue />
+ </SelectTrigger>
+ <SelectContent>
+ {kindOptions.map((option) => (
+ <SelectItem key={option.value} value={option.value}>
+ {option.label}
+ </SelectItem>
+ ))}
+ </SelectContent>
+ </Select>
+ </Field>
+ </div>
+ <Field>
+ <FieldLabel>{t('admin.orders.detail.adjustment_lines.target_field')}</FieldLabel>
+ <Select
+ items={targetOptions}
+ value={target}
+ onValueChange={(v) => setTarget(v as string)}
+ >
+ <SelectTrigger>
+ <SelectValue />
+ </SelectTrigger>
+ <SelectContent>
+ {targetOptions.map((option) => (
+ <SelectItem key={option.value} value={option.value}>
+ {option.label}
+ </SelectItem>
+ ))}
+ </SelectContent>
+ </Select>
+ </Field>
+ </FieldGroup>
+ </DialogBody>
+ <DialogFooter>
+ <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
+ {t('admin.actions.cancel')}
+ </Button>
+ <Button type="submit" disabled={mutation.isPending}>
+ {mutation.isPending
+ ? t('admin.actions.saving')
+ : t('admin.orders.detail.adjustment_lines.add_fee')}
+ </Button>
+ </DialogFooter>
+ </form>
+ </DialogContent>
+ </Dialog>
+ )
+}
diff --git a/packages/dashboard/src/components/spree/orders/order-customer-card.tsx b/packages/dashboard/src/components/spree/orders/order-customer-card.tsx
new file mode 100644
index 0000000000..01812d5921
--- /dev/null
+++ b/packages/dashboard/src/components/spree/orders/order-customer-card.tsx
@@ -0,0 +1,123 @@
+import type { Order } from '@spree/admin-sdk'
+import {
+ AddressFormDialog,
+ type AddressParams,
+ adminClient,
+ getInitials,
+} from '@spree/dashboard-core'
+import {
+ AddressBlock,
+ Avatar,
+ AvatarFallback,
+ Button,
+ Card,
+ CardAction,
+ CardContent,
+ CardHeader,
+ CardTitle,
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuItem,
+ DropdownMenuTrigger,
+} from '@spree/dashboard-ui'
+import { useMutation, useQueryClient } from '@tanstack/react-query'
+import { EllipsisVerticalIcon, PencilIcon } from 'lucide-react'
+import { useState } from 'react'
+import { useTranslation } from 'react-i18next'
+
+export function CustomerCard({ order }: { order: Order }) {
+ const { t } = useTranslation()
+ const orderId = order.id
+ const queryClient = useQueryClient()
+ const customer = order.customer
+ const [editAddress, setEditAddress] = useState<'shipping_address' | 'billing_address' | null>(
+ null,
+ )
+
+ const addressMutation = useMutation({
+ mutationFn: (params: {
+ type: 'shipping_address' | 'billing_address'
+ address: AddressParams
+ }) => adminClient.orders.update(orderId, { [params.type]: params.address } as any),
+ onSuccess: () => {
+ queryClient.invalidateQueries({ queryKey: ['order', orderId] })
+ setEditAddress(null)
+ },
+ })
+
+ const editTitle =
+ editAddress === 'shipping_address'
+ ? t('admin.orders.detail.address_edit.shipping_title')
+ : t('admin.orders.detail.address_edit.billing_title')
+
+ return (
+ <>
+ <Card>
+ <CardHeader>
+ <CardTitle>{t('admin.pages.orders.detail.section_customer')}</CardTitle>
+ <CardAction>
+ <DropdownMenu>
+ <DropdownMenuTrigger asChild>
+ <Button variant="ghost" size="icon-xs">
+ <EllipsisVerticalIcon className="size-4" />
+ </Button>
+ </DropdownMenuTrigger>
+ <DropdownMenuContent align="end">
+ <DropdownMenuItem onClick={() => setEditAddress('shipping_address')}>
+ <PencilIcon className="size-4" />
+ {t('admin.orders.detail.address_edit.shipping_title')}
+ </DropdownMenuItem>
+ <DropdownMenuItem onClick={() => setEditAddress('billing_address')}>
+ <PencilIcon className="size-4" />
+ {t('admin.orders.detail.address_edit.billing_title')}
+ </DropdownMenuItem>
+ </DropdownMenuContent>
+ </DropdownMenu>
+ </CardAction>
+ </CardHeader>
+ <CardContent className="flex flex-col gap-5">
+ {/* Contact info */}
+ {customer ? (
+ <div className="flex items-center gap-3 rounded-xl bg-muted p-3">
+ <Avatar>
+ <AvatarFallback>{getInitials(customer.full_name, customer.email)}</AvatarFallback>
+ </Avatar>
+ <div className="min-w-0 flex-1">
+ <div className="truncate text-sm font-medium">{customer.full_name}</div>
+ <div className="truncate text-xs text-muted-foreground">{customer.email}</div>
+ </div>
+ </div>
+ ) : order.email ? (
+ <div className="text-sm text-blue-600">{order.email}</div>
+ ) : (
+ <span className="text-sm text-muted-foreground">
+ {t('admin.orders.detail.no_customer')}
+ </span>
+ )}
+
+ <AddressBlock
+ title={t('admin.pages.orders.detail.section_shipping_address')}
+ address={order.shipping_address}
+ />
+ <AddressBlock
+ title={t('admin.pages.orders.detail.section_billing_address')}
+ address={order.billing_address}
+ />
+ </CardContent>
+ </Card>
+
+ {editAddress && (
+ <AddressFormDialog
+ title={editTitle}
+ address={
+ editAddress === 'shipping_address' ? order.shipping_address : order.billing_address
+ }
+ open={!!editAddress}
+ onOpenChange={(open) => !open && setEditAddress(null)}
+ onSave={(address) => addressMutation.mutate({ type: editAddress, address })}
+ isPending={addressMutation.isPending}
+ />
+ )}
+ </>
+ )
+}
diff --git a/packages/dashboard/src/components/spree/orders/order-discounts-sidebar-card.tsx b/packages/dashboard/src/components/spree/orders/order-discounts-sidebar-card.tsx
new file mode 100644
index 0000000000..85799f182c
--- /dev/null
+++ b/packages/dashboard/src/components/spree/orders/order-discounts-sidebar-card.tsx
@@ -0,0 +1,374 @@
+import type { Order } from '@spree/admin-sdk'
+import { adminClient, useResourceKey } from '@spree/dashboard-core'
+import {
+ Button,
+ Card,
+ CardContent,
+ CardHeader,
+ CardTitle,
+ cn,
+ Dialog,
+ DialogBody,
+ DialogContent,
+ DialogDescription,
+ DialogFooter,
+ DialogHeader,
+ DialogTitle,
+ Field,
+ FieldGroup,
+ FieldLabel,
+ Input,
+ Separator,
+ useConfirm,
+} from '@spree/dashboard-ui'
+import { useQuery } from '@tanstack/react-query'
+import { PlusIcon } from 'lucide-react'
+import { type FormEvent, useState } from 'react'
+import { useTranslation } from 'react-i18next'
+import { useOrderMutation } from '../../../hooks/use-order'
+
+export function DiscountsCard({ order }: { order: Order }) {
+ const { t } = useTranslation()
+ const orderId = order.id
+ const confirm = useConfirm()
+ const [giftCardOpen, setGiftCardOpen] = useState(false)
+ const [couponOpen, setCouponOpen] = useState(false)
+
+ const removeGiftCardMutation = useOrderMutation(orderId, () =>
+ adminClient.orders.giftCards.remove(orderId, order.gift_card?.id ?? ''),
+ )
+ const removeCouponMutation = useOrderMutation(orderId, () =>
+ adminClient.orders.discountCodes.delete(orderId, order.coupon_code ?? ''),
+ )
+ const applyStoreCreditMutation = useOrderMutation(orderId, () =>
+ adminClient.orders.storeCredits.apply(orderId),
+ )
+ const removeStoreCreditMutation = useOrderMutation(orderId, () =>
+ adminClient.orders.storeCredits.remove(orderId),
+ )
+
+ const hasStoreCredit = Number.parseFloat(order.store_credit_total) > 0
+ const hasCustomer = Boolean(order.customer_id)
+ const isEditable = !order.completed_at
+ const couponPending = Boolean(order.coupon_code) && Number.parseFloat(order.discount_total) === 0
+
+ return (
+ <>
+ <Card>
+ <CardHeader>
+ <CardTitle>{t('admin.orders.detail.gift_card_section.title')}</CardTitle>
+ </CardHeader>
+ <CardContent className="flex flex-col gap-3">
+ {/* Discount code — editable on drafts; frozen after completion */}
+ <div className="flex items-center justify-between gap-2">
+ <div className="flex flex-col">
+ <span className="text-sm font-medium">
+ {t('admin.orders.detail.discount_section.label')}
+ </span>
+ {order.coupon_code ? (
+ <span className="font-mono text-xs text-muted-foreground">
+ {order.coupon_code}
+ {couponPending && ` · ${t('admin.orders.detail.discount_section.pending_hint')}`}
+ </span>
+ ) : (
+ <span className="text-xs text-muted-foreground">
+ {t('admin.orders.detail.gift_card_section.none_applied')}
+ </span>
+ )}
+ </div>
+ {isEditable &&
+ (order.coupon_code ? (
+ <Button
+ size="sm"
+ variant="outline"
+ onClick={async () => {
+ if (
+ await confirm({
+ message: t('admin.orders.detail.discount_section.remove_confirm_message'),
+ confirmLabel: t('admin.actions.remove'),
+ })
+ ) {
+ removeCouponMutation.mutate(undefined)
+ }
+ }}
+ disabled={removeCouponMutation.isPending}
+ >
+ {t('admin.actions.remove')}
+ </Button>
+ ) : (
+ <Button size="sm" variant="outline" onClick={() => setCouponOpen(true)}>
+ <PlusIcon className="size-4" />
+ {t('admin.actions.apply')}
+ </Button>
+ ))}
+ </div>
+
+ <Separator />
+
+ {/* Gift card */}
+ <div className="flex items-center justify-between gap-2">
+ <div className="flex flex-col">
+ <span className="text-sm font-medium">
+ {t('admin.orders.detail.gift_card_section.gift_card_label')}
+ </span>
+ {order.gift_card ? (
+ <span className="text-xs text-muted-foreground">
+ {order.gift_card.code} · {order.display_gift_card_total}
+ </span>
+ ) : (
+ <span className="text-xs text-muted-foreground">
+ {t('admin.orders.detail.gift_card_section.none_applied')}
+ </span>
+ )}
+ </div>
+ {order.gift_card ? (
+ <Button
+ size="sm"
+ variant="outline"
+ onClick={async () => {
+ if (
+ await confirm({
+ message: t('admin.orders.detail.confirm.remove_gift_card_message'),
+ confirmLabel: t('admin.actions.remove'),
+ })
+ ) {
+ removeGiftCardMutation.mutate(undefined)
+ }
+ }}
+ disabled={removeGiftCardMutation.isPending}
+ >
+ {t('admin.actions.remove')}
+ </Button>
+ ) : (
+ <Button size="sm" variant="outline" onClick={() => setGiftCardOpen(true)}>
+ <PlusIcon className="size-4" />
+ {t('admin.actions.apply')}
+ </Button>
+ )}
+ </div>
+
+ <Separator />
+
+ {/* Store credit */}
+ <div className="flex items-center justify-between gap-2">
+ <div className="flex flex-col">
+ <span className="text-sm font-medium">
+ {t('admin.orders.detail.gift_card_section.store_credit_label')}
+ </span>
+ {hasStoreCredit ? (
+ <span className="text-xs text-muted-foreground">
+ {order.display_store_credit_total}{' '}
+ {t('admin.orders.detail.gift_card_section.applied_suffix')}
+ </span>
+ ) : (
+ <span className="text-xs text-muted-foreground">
+ {hasCustomer
+ ? t('admin.orders.detail.gift_card_section.apply_balance')
+ : t('admin.orders.detail.gift_card_section.requires_customer')}
+ </span>
+ )}
+ </div>
+ {hasStoreCredit ? (
+ <Button
+ size="sm"
+ variant="outline"
+ onClick={async () => {
+ if (
+ await confirm({
+ message: t('admin.orders.detail.confirm.remove_store_credit_message'),
+ confirmLabel: t('admin.actions.remove'),
+ })
+ ) {
+ removeStoreCreditMutation.mutate(undefined)
+ }
+ }}
+ disabled={removeStoreCreditMutation.isPending}
+ >
+ {t('admin.actions.remove')}
+ </Button>
+ ) : (
+ <Button
+ size="sm"
+ variant="outline"
+ disabled={!hasCustomer || applyStoreCreditMutation.isPending}
+ onClick={() => applyStoreCreditMutation.mutate(undefined)}
+ >
+ <PlusIcon className="size-4" />
+ {t('admin.actions.apply')}
+ </Button>
+ )}
+ </div>
+ </CardContent>
+ </Card>
+
+ <ApplyGiftCardDialog orderId={orderId} open={giftCardOpen} onOpenChange={setGiftCardOpen} />
+ <CouponCodeDialog orderId={orderId} open={couponOpen} onOpenChange={setCouponOpen} />
+ </>
+ )
+}
+
+function CouponCodeDialog({
+ orderId,
+ open,
+ onOpenChange,
+}: {
+ orderId: string
+ open: boolean
+ onOpenChange: (open: boolean) => void
+}) {
+ const { t } = useTranslation()
+ const [code, setCode] = useState('')
+
+ const promotionsQuery = useQuery({
+ queryKey: useResourceKey('promotions', 'coupon-options'),
+ queryFn: () => adminClient.promotions.list({ q: { kind_eq: 'coupon_code' }, per_page: 100 }),
+ enabled: open,
+ })
+ const couponPromotions = (promotionsQuery.data?.data ?? []).filter((promotion) => promotion.code)
+
+ const mutation = useOrderMutation(orderId, (params: { code: string }) =>
+ adminClient.orders.discountCodes.create(orderId, params),
+ )
+
+ function handleSubmit(e: FormEvent<HTMLFormElement>) {
+ e.preventDefault()
+ const trimmed = code.trim()
+ if (!trimmed) return
+ mutation.mutate(
+ { code: trimmed },
+ {
+ onSuccess: () => {
+ setCode('')
+ onOpenChange(false)
+ },
+ },
+ )
+ }
+
+ return (
+ <Dialog open={open} onOpenChange={onOpenChange}>
+ <DialogContent>
+ <DialogHeader>
+ <DialogTitle>{t('admin.orders.detail.discount_section.apply_dialog_title')}</DialogTitle>
+ <DialogDescription>
+ {t('admin.orders.detail.discount_section.apply_dialog_description')}
+ </DialogDescription>
+ </DialogHeader>
+ <form onSubmit={handleSubmit}>
+ <DialogBody>
+ <FieldGroup>
+ <Field>
+ <FieldLabel htmlFor="coupon-code">{t('admin.fields.code.label')}</FieldLabel>
+ <Input
+ id="coupon-code"
+ name="code"
+ value={code}
+ onChange={(e) => setCode(e.target.value)}
+ placeholder={t('admin.orders.detail.discount_section.code_placeholder')}
+ required
+ autoFocus
+ />
+ </Field>
+ {couponPromotions.length > 0 && (
+ <Field>
+ <FieldLabel>
+ {t('admin.orders.detail.discount_section.promotions_label')}
+ </FieldLabel>
+ <div className="flex max-h-48 flex-col gap-1 overflow-y-auto">
+ {couponPromotions.map((promotion) => (
+ <button
+ type="button"
+ key={promotion.id}
+ onClick={() => setCode(promotion.code ?? '')}
+ className={cn(
+ 'flex items-center justify-between rounded-md border px-3 py-2 text-left text-sm hover:bg-accent',
+ code === promotion.code && 'border-primary',
+ )}
+ >
+ <span className="truncate">{promotion.name}</span>
+ <span className="ml-2 shrink-0 font-mono text-xs text-muted-foreground">
+ {promotion.code}
+ </span>
+ </button>
+ ))}
+ </div>
+ </Field>
+ )}
+ {mutation.isError && (
+ <p className="text-sm text-destructive">{(mutation.error as Error).message}</p>
+ )}
+ </FieldGroup>
+ </DialogBody>
+ <DialogFooter>
+ <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
+ {t('admin.actions.cancel')}
+ </Button>
+ <Button type="submit" disabled={mutation.isPending}>
+ {t('admin.actions.apply')}
+ </Button>
+ </DialogFooter>
+ </form>
+ </DialogContent>
+ </Dialog>
+ )
+}
+
+function ApplyGiftCardDialog({
+ orderId,
+ open,
+ onOpenChange,
+}: {
+ orderId: string
+ open: boolean
+ onOpenChange: (open: boolean) => void
+}) {
+ const { t } = useTranslation()
+ const mutation = useOrderMutation(orderId, (params: { code: string }) =>
+ adminClient.orders.giftCards.apply(orderId, params),
+ )
+
+ function handleSubmit(e: FormEvent<HTMLFormElement>) {
+ e.preventDefault()
+ const fd = new FormData(e.currentTarget)
+ const code = (fd.get('code') as string).trim()
+ if (!code) return
+ mutation.mutate({ code }, { onSuccess: () => onOpenChange(false) })
+ }
+
+ return (
+ <Dialog open={open} onOpenChange={onOpenChange}>
+ <DialogContent>
+ <DialogHeader>
+ <DialogTitle>{t('admin.orders.detail.gift_card_section.apply_dialog_title')}</DialogTitle>
+ <DialogDescription>
+ {t('admin.orders.detail.gift_card_section.apply_dialog_description')}
+ </DialogDescription>
+ </DialogHeader>
+ <form onSubmit={handleSubmit}>
+ <DialogBody>
+ <FieldGroup>
+ <Field>
+ <FieldLabel htmlFor="gift-card-code">{t('admin.fields.code.label')}</FieldLabel>
+ <Input
+ id="gift-card-code"
+ name="code"
+ placeholder={t('admin.orders.detail.gift_card_section.code_placeholder')}
+ required
+ autoFocus
+ />
+ </Field>
+ </FieldGroup>
+ </DialogBody>
+ <DialogFooter>
+ <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
+ {t('admin.actions.cancel')}
+ </Button>
+ <Button type="submit" disabled={mutation.isPending}>
+ {mutation.isPending ? t('admin.actions.saving') : t('admin.actions.add')}
+ </Button>
+ </DialogFooter>
+ </form>
+ </DialogContent>
+ </Dialog>
+ )
+}
diff --git a/packages/dashboard/src/components/spree/orders/order-header.tsx b/packages/dashboard/src/components/spree/orders/order-header.tsx
new file mode 100644
index 0000000000..829e6e046b
--- /dev/null
+++ b/packages/dashboard/src/components/spree/orders/order-header.tsx
@@ -0,0 +1,195 @@
+import type { Order } from '@spree/admin-sdk'
+import { adminClient, PageHeader, useResourceMutation, useStore } from '@spree/dashboard-core'
+import {
+ Button,
+ DropdownMenuItem,
+ DropdownMenuSeparator,
+ RelativeTime,
+ StatusBadge,
+ useConfirm,
+} from '@spree/dashboard-ui'
+import { Link } from '@tanstack/react-router'
+import {
+ CheckCircleIcon,
+ ExternalLinkIcon,
+ MailIcon,
+ PencilIcon,
+ RotateCcwIcon,
+ ShieldCheckIcon,
+ XCircleIcon,
+} from 'lucide-react'
+import { useTranslation } from 'react-i18next'
+import { orderQueryKey } from '../../../hooks/use-order'
+import { spreeJsonLinkResolver } from '../../../lib/json-link-resolver'
+
+export function OrderHeader({ order }: { order: Order }) {
+ const { t } = useTranslation()
+ const orderId = order.id
+ const { storeId } = useStore()
+ const confirm = useConfirm()
+
+ const backFallback = order.completed_at ? 'orders' : 'orders/drafts'
+
+ const cancelMutation = useResourceMutation({
+ mutationFn: () => adminClient.orders.cancel(orderId),
+ invalidate: [orderQueryKey(orderId)],
+ successMessage: t('admin.orders.detail.messages.canceled'),
+ errorMessage: t('admin.orders.detail.errors.cancel_failed'),
+ })
+ const completeMutation = useResourceMutation({
+ mutationFn: () => adminClient.orders.complete(orderId),
+ invalidate: [orderQueryKey(orderId)],
+ successMessage: t('admin.orders.detail.messages.completed'),
+ errorMessage: t('admin.orders.detail.errors.complete_failed'),
+ })
+ const approveMutation = useResourceMutation({
+ mutationFn: () => adminClient.orders.approve(orderId),
+ invalidate: [orderQueryKey(orderId)],
+ successMessage: t('admin.orders.detail.messages.approved'),
+ errorMessage: t('admin.orders.detail.errors.approve_failed'),
+ })
+ const resumeMutation = useResourceMutation({
+ mutationFn: () => adminClient.orders.resume(orderId),
+ invalidate: [orderQueryKey(orderId)],
+ successMessage: t('admin.orders.detail.messages.resumed'),
+ errorMessage: t('admin.orders.detail.errors.resume_failed'),
+ })
+ const resendMutation = useResourceMutation({
+ mutationFn: () => adminClient.orders.resendConfirmation(orderId, {}),
+ successMessage: t('admin.orders.detail.messages.confirmation_sent'),
+ errorMessage: t('admin.orders.detail.errors.confirmation_send_failed'),
+ })
+
+ const badges = (
+ <>
+ {order.payment_status && <StatusBadge status={order.payment_status} />}
+ {order.fulfillment_status && <StatusBadge status={order.fulfillment_status} />}
+ </>
+ )
+
+ const subtitle = order.completed_at ? (
+ <RelativeTime iso={order.completed_at} prefix={t('admin.orders.detail.completed_prefix')} />
+ ) : undefined
+
+ const dropdownItems = (
+ <>
+ {order.status === 'draft' && (
+ <DropdownMenuItem
+ onClick={async () => {
+ if (
+ await confirm({
+ message: t('admin.orders.detail.confirm.complete_message'),
+ confirmLabel: t('admin.orders.detail.dropdown.complete_order'),
+ })
+ ) {
+ completeMutation.mutate(undefined)
+ }
+ }}
+ disabled={completeMutation.isPending}
+ >
+ <CheckCircleIcon className="size-4" />
+ {t('admin.orders.detail.dropdown.complete_order')}
+ </DropdownMenuItem>
+ )}
+ {order.considered_risky && !order.approved_at && (
+ <DropdownMenuItem
+ onClick={async () => {
+ if (
+ await confirm({
+ title: t('admin.pages.orders.detail.dialogs.approve_title'),
+ message: t('admin.orders.detail.confirm.approve_message'),
+ confirmLabel: t('admin.pages.orders.detail.actions.approve'),
+ })
+ ) {
+ approveMutation.mutate(undefined)
+ }
+ }}
+ disabled={approveMutation.isPending}
+ >
+ <ShieldCheckIcon className="size-4" />
+ {t('admin.pages.orders.detail.actions.approve')}
+ </DropdownMenuItem>
+ )}
+ {order.status === 'canceled' && (
+ <DropdownMenuItem
+ onClick={async () => {
+ if (
+ await confirm({
+ message: t('admin.orders.detail.confirm.resume_message'),
+ confirmLabel: t('admin.pages.orders.detail.actions.resume'),
+ })
+ ) {
+ resumeMutation.mutate(undefined)
+ }
+ }}
+ disabled={resumeMutation.isPending}
+ >
+ <RotateCcwIcon className="size-4" />
+ {t('admin.pages.orders.detail.actions.resume')}
+ </DropdownMenuItem>
+ )}
+ {order.completed_at && (
+ <>
+ <DropdownMenuItem>
+ <ExternalLinkIcon className="size-4" />
+ {t('admin.orders.detail.dropdown.preview_order')}
+ </DropdownMenuItem>
+ <DropdownMenuItem
+ onClick={() => resendMutation.mutate(undefined)}
+ disabled={resendMutation.isPending}
+ >
+ <MailIcon className="size-4" />
+ {t('admin.orders.detail.dropdown.resend_confirmation')}
+ </DropdownMenuItem>
+ <DropdownMenuSeparator />
+ </>
+ )}
+ {order.status !== 'canceled' && (
+ <DropdownMenuItem
+ variant="destructive"
+ onClick={async () => {
+ if (
+ await confirm({
+ title: t('admin.pages.orders.detail.dialogs.cancel_title'),
+ message: t('admin.orders.detail.confirm.cancel_message'),
+ variant: 'destructive',
+ confirmLabel: t('admin.pages.orders.detail.actions.cancel'),
+ })
+ ) {
+ cancelMutation.mutate(undefined)
+ }
+ }}
+ disabled={cancelMutation.isPending}
+ >
+ <XCircleIcon className="size-4" />
+ {t('admin.pages.orders.detail.actions.cancel')}
+ </DropdownMenuItem>
+ )}
+ </>
+ )
+
+ return (
+ <PageHeader
+ title={order.number}
+ subtitle={subtitle}
+ backTo={backFallback}
+ badges={badges}
+ actions={
+ <Button asChild variant="outline">
+ <Link to="/$storeId/orders/$orderId/edit" params={{ storeId, orderId }}>
+ <PencilIcon className="size-4" />
+ {t('admin.orders.edit.action_label')}
+ </Link>
+ </Button>
+ }
+ dropdownItems={dropdownItems}
+ resource={{ id: order.id, number: order.number }}
+ jsonPreview={{
+ title: `Order ${order.number}`,
+ fetch: () => adminClient.orders.get(orderId),
+ endpoint: `/api/v3/admin/orders/${orderId}`,
+ resolveLink: spreeJsonLinkResolver(storeId),
+ }}
+ />
+ )
+}
diff --git a/packages/dashboard/src/components/spree/orders/order-notes-cards.tsx b/packages/dashboard/src/components/spree/orders/order-notes-cards.tsx
new file mode 100644
index 0000000000..c610240c8d
--- /dev/null
+++ b/packages/dashboard/src/components/spree/orders/order-notes-cards.tsx
@@ -0,0 +1,203 @@
+import type { Order } from '@spree/admin-sdk'
+import { adminClient, TagCombobox } from '@spree/dashboard-core'
+import {
+ Badge,
+ Button,
+ Card,
+ CardAction,
+ CardContent,
+ CardHeader,
+ CardTitle,
+ RichTextEditor,
+ Textarea,
+} from '@spree/dashboard-ui'
+import { PencilIcon } from 'lucide-react'
+import { type FormEvent, useEffect, useState } from 'react'
+import { useTranslation } from 'react-i18next'
+import { useOrderMutation } from '../../../hooks/use-order'
+
+export function SpecialInstructionsCard({ order }: { order: Order }) {
+ const { t } = useTranslation()
+ const orderId = order.id
+
+ const [editing, setEditing] = useState(false)
+ const mutation = useOrderMutation(orderId, (params: { customer_note: string }) =>
+ adminClient.orders.update(orderId, params),
+ )
+
+ function handleSubmit(e: FormEvent<HTMLFormElement>) {
+ e.preventDefault()
+ const fd = new FormData(e.currentTarget)
+ mutation.mutate(
+ { customer_note: fd.get('customer_note') as string },
+ { onSuccess: () => setEditing(false) },
+ )
+ }
+
+ return (
+ <Card>
+ <CardHeader>
+ <CardTitle>{t('admin.orders.detail.section_customer_note')}</CardTitle>
+ <CardAction>
+ <Button variant="ghost" size="icon-xs" onClick={() => setEditing(!editing)}>
+ <PencilIcon className="size-4" />
+ </Button>
+ </CardAction>
+ </CardHeader>
+ <CardContent>
+ {editing ? (
+ <form onSubmit={handleSubmit} className="flex flex-col gap-3">
+ <Textarea name="customer_note" defaultValue={order.customer_note ?? ''} />
+ <div className="flex justify-end gap-2">
+ <Button type="button" variant="outline" size="sm" onClick={() => setEditing(false)}>
+ {t('admin.actions.cancel')}
+ </Button>
+ <Button type="submit" size="sm" disabled={mutation.isPending}>
+ {mutation.isPending ? t('admin.actions.saving') : t('admin.actions.save')}
+ </Button>
+ </div>
+ </form>
+ ) : order.customer_note ? (
+ <p className="text-sm text-muted-foreground whitespace-pre-wrap">{order.customer_note}</p>
+ ) : (
+ <p className="text-sm text-muted-foreground">{t('admin.common.none')}</p>
+ )}
+ </CardContent>
+ </Card>
+ )
+}
+
+export function TagsCard({ order }: { order: Order }) {
+ const { t } = useTranslation()
+ const orderId = order.id
+ const [editing, setEditing] = useState(false)
+ const [tags, setTags] = useState<string[]>(order.tags ?? [])
+
+ const mutation = useOrderMutation(orderId, (params: { tags: string[] }) =>
+ adminClient.orders.update(orderId, params),
+ )
+
+ return (
+ <Card>
+ <CardHeader>
+ <CardTitle>{t('admin.pages.customers.detail.section_tags')}</CardTitle>
+ <CardAction>
+ <Button
+ variant="ghost"
+ size="icon-xs"
+ onClick={() => {
+ setTags(order.tags ?? [])
+ setEditing(!editing)
+ }}
+ >
+ <PencilIcon className="size-4" />
+ </Button>
+ </CardAction>
+ </CardHeader>
+ <CardContent>
+ {editing ? (
+ <div className="flex flex-col gap-3">
+ <TagCombobox taggableType="Spree::Order" value={tags} onChange={setTags} />
+ <div className="flex justify-end gap-2">
+ <Button type="button" variant="outline" size="sm" onClick={() => setEditing(false)}>
+ {t('admin.actions.cancel')}
+ </Button>
+ <Button
+ type="button"
+ size="sm"
+ disabled={mutation.isPending}
+ onClick={() => mutation.mutate({ tags }, { onSuccess: () => setEditing(false) })}
+ >
+ {mutation.isPending ? t('admin.actions.saving') : t('admin.actions.save')}
+ </Button>
+ </div>
+ </div>
+ ) : order.tags?.length ? (
+ <div className="flex flex-wrap gap-1">
+ {order.tags.map((tag) => (
+ <Badge key={tag}>{tag}</Badge>
+ ))}
+ </div>
+ ) : (
+ <p className="text-sm text-muted-foreground">{t('admin.common.none')}</p>
+ )}
+ </CardContent>
+ </Card>
+ )
+}
+
+export function InternalNoteCard({ order }: { order: Order }) {
+ const { t } = useTranslation()
+ const orderId = order.id
+
+ const [editing, setEditing] = useState(false)
+ // Edit the HTML, not the plain-text projection: `internal_note` has its
+ // markup stripped, so round-tripping it through the `internal_note_html`
+ // write would flatten an existing note on a save that changed nothing.
+ const [note, setNote] = useState(order.internal_note_html ?? '')
+ const serverNote = order.internal_note_html ?? ''
+
+ // Track the server value only while the editor is closed. Any order mutation
+ // refetches this record, and adopting the incoming value mid-edit would throw
+ // away whatever the user is part-way through typing.
+ useEffect(() => {
+ if (!editing) setNote(serverNote)
+ }, [editing, serverNote])
+
+ const mutation = useOrderMutation(orderId, (params: { internal_note: string }) =>
+ adminClient.orders.update(orderId, params),
+ )
+
+ function handleSubmit(e: FormEvent<HTMLFormElement>) {
+ e.preventDefault()
+ mutation.mutate({ internal_note: note }, { onSuccess: () => setEditing(false) })
+ }
+
+ return (
+ <Card>
+ <CardHeader>
+ <CardTitle>{t('admin.orders.detail.section_internal_note')}</CardTitle>
+ <CardAction>
+ <Button variant="ghost" size="icon-xs" onClick={() => setEditing(!editing)}>
+ <PencilIcon className="size-4" />
+ </Button>
+ </CardAction>
+ </CardHeader>
+ <CardContent>
+ {editing ? (
+ <form onSubmit={handleSubmit} className="flex flex-col gap-3">
+ <RichTextEditor
+ ariaLabel={t('admin.orders.detail.section_internal_note')}
+ value={note}
+ onChange={setNote}
+ />
+ <div className="flex justify-end gap-2">
+ <Button
+ type="button"
+ variant="outline"
+ size="sm"
+ onClick={() => {
+ setNote(serverNote)
+ setEditing(false)
+ }}
+ >
+ {t('admin.actions.cancel')}
+ </Button>
+ <Button type="submit" size="sm" disabled={mutation.isPending}>
+ {mutation.isPending ? t('admin.actions.saving') : t('admin.actions.save')}
+ </Button>
+ </div>
+ </form>
+ ) : order.internal_note_html ? (
+ <div
+ className="prose prose-sm max-w-none text-muted-foreground dark:prose-invert"
+ // biome-ignore lint/security/noDangerouslySetInnerHtml: HTML is sanitized server-side via the rich-text pipeline
+ dangerouslySetInnerHTML={{ __html: order.internal_note_html }}
+ />
+ ) : (
+ <p className="text-sm text-muted-foreground">{t('admin.common.none')}</p>
+ )}
+ </CardContent>
+ </Card>
+ )
+}
diff --git a/packages/dashboard/src/components/spree/orders/order-payments-card.tsx b/packages/dashboard/src/components/spree/orders/order-payments-card.tsx
new file mode 100644
index 0000000000..098cb4be2f
--- /dev/null
+++ b/packages/dashboard/src/components/spree/orders/order-payments-card.tsx
@@ -0,0 +1,380 @@
+import type { Order } from '@spree/admin-sdk'
+import { adminClient } from '@spree/dashboard-core'
+import {
+ Badge,
+ Button,
+ Card,
+ CardAction,
+ CardContent,
+ CardHeader,
+ CardTitle,
+ Dialog,
+ DialogBody,
+ DialogContent,
+ DialogDescription,
+ DialogFooter,
+ DialogHeader,
+ DialogTitle,
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuItem,
+ DropdownMenuTrigger,
+ Field,
+ FieldGroup,
+ FieldLabel,
+ Input,
+ Select,
+ SelectContent,
+ SelectItem,
+ SelectTrigger,
+ SelectValue,
+ StatusBadge,
+ Switch,
+ useConfirm,
+} from '@spree/dashboard-ui'
+import { useQuery } from '@tanstack/react-query'
+import { CreditCardIcon, EllipsisVerticalIcon, PlusIcon, XCircleIcon } from 'lucide-react'
+import { type FormEvent, useEffect, useState } from 'react'
+import { useTranslation } from 'react-i18next'
+import { useOrderMutation } from '../../../hooks/use-order'
+
+export function PaymentsCard({ order }: { order: Order }) {
+ const { t } = useTranslation()
+ const orderId = order.id
+ const confirm = useConfirm()
+ const [addOpen, setAddOpen] = useState(false)
+
+ const payments = order.payments ?? []
+
+ const captureMutation = useOrderMutation(orderId, (paymentId: string) =>
+ adminClient.orders.payments.capture(orderId, paymentId, {}),
+ )
+ const voidMutation = useOrderMutation(orderId, (paymentId: string) =>
+ adminClient.orders.payments.void(orderId, paymentId, {}),
+ )
+
+ return (
+ <Card>
+ <CardHeader>
+ <CardTitle>
+ <CreditCardIcon className="size-4" />
+ {t('admin.pages.orders.detail.section_payments')}
+ {payments.length > 0 && <Badge variant="outline">{payments.length}</Badge>}
+ </CardTitle>
+ <CardAction className="flex items-center gap-2">
+ {order.payment_status && <StatusBadge status={order.payment_status} />}
+ <Button size="sm" variant="outline" onClick={() => setAddOpen(true)}>
+ <PlusIcon data-icon="inline-start" />
+ {t('admin.actions.add')}
+ </Button>
+ </CardAction>
+ </CardHeader>
+ {payments.length === 0 ? (
+ <CardContent>
+ <p className="text-center text-muted-foreground py-8">
+ {t('admin.pages.orders.detail.empty_payments')}
+ </p>
+ </CardContent>
+ ) : (
+ <div className="overflow-x-auto">
+ <table className="w-full text-sm">
+ <thead>
+ <tr className="border-b bg-muted/50 text-muted-foreground">
+ <th className="p-3 pl-5 text-left font-normal">
+ {t('admin.orders.detail.payments_table.number')}
+ </th>
+ <th className="p-3 text-left font-normal">
+ {t('admin.orders.detail.payments_table.method')}
+ </th>
+ <th className="p-3 text-left font-normal">
+ {t('admin.orders.detail.payments_table.state')}
+ </th>
+ <th className="p-3 text-right font-normal">{t('admin.fields.amount.label')}</th>
+ <th className="p-3 pr-5 w-10" />
+ </tr>
+ </thead>
+ <tbody>
+ {payments.map((payment) => (
+ <tr key={payment.id} className="border-b last:border-b-0">
+ <td className="p-3 pl-5 font-medium">{payment.number}</td>
+ <td className="p-3 text-muted-foreground">
+ {payment.payment_method?.name ?? '—'}
+ </td>
+ <td className="p-3">
+ <StatusBadge status={payment.status} />
+ </td>
+ <td className="p-3 text-right font-medium whitespace-nowrap">
+ {payment.display_amount}
+ </td>
+ <td className="p-3 pr-5">
+ {(payment.status === 'checkout' ||
+ payment.status === 'pending' ||
+ payment.status === 'completed') && (
+ <DropdownMenu>
+ <DropdownMenuTrigger asChild>
+ <Button variant="ghost" size="icon-xs">
+ <EllipsisVerticalIcon className="size-4" />
+ </Button>
+ </DropdownMenuTrigger>
+ <DropdownMenuContent align="end">
+ {(payment.status === 'checkout' || payment.status === 'pending') && (
+ <DropdownMenuItem
+ onClick={async () => {
+ if (
+ await confirm({
+ message: t('admin.orders.detail.confirm.capture_message'),
+ variant: 'default',
+ confirmLabel: t('admin.pages.orders.detail.actions.capture'),
+ })
+ ) {
+ captureMutation.mutate(payment.id)
+ }
+ }}
+ >
+ <CreditCardIcon className="size-4" />
+ {t('admin.pages.orders.detail.actions.capture')}
+ </DropdownMenuItem>
+ )}
+ {(payment.status === 'checkout' ||
+ payment.status === 'pending' ||
+ payment.status === 'completed') && (
+ <DropdownMenuItem
+ className="text-destructive focus:text-destructive"
+ onClick={async () => {
+ if (
+ await confirm({
+ message: t('admin.orders.detail.confirm.void_message'),
+ variant: 'destructive',
+ confirmLabel: t('admin.pages.orders.detail.actions.void'),
+ })
+ ) {
+ voidMutation.mutate(payment.id)
+ }
+ }}
+ >
+ <XCircleIcon className="size-4" />
+ {t('admin.pages.orders.detail.actions.void')}
+ </DropdownMenuItem>
+ )}
+ </DropdownMenuContent>
+ </DropdownMenu>
+ )}
+ </td>
+ </tr>
+ ))}
+ </tbody>
+ </table>
+ </div>
+ )}
+ <AddPaymentDialog order={order} open={addOpen} onOpenChange={setAddOpen} />
+ </Card>
+ )
+}
+
+function AddPaymentDialog({
+ order,
+ open,
+ onOpenChange,
+}: {
+ order: Order
+ open: boolean
+ onOpenChange: (open: boolean) => void
+}) {
+ const { t } = useTranslation()
+ const orderId = order.id
+ const customerId = order.customer_id ?? undefined
+ const [paymentMethodId, setPaymentMethodId] = useState<string>('')
+ const [sourceId, setSourceId] = useState<string>('')
+ const [amount, setAmount] = useState<string>(order.amount_due ?? '')
+ const [capture, setCapture] = useState(false)
+
+ // Re-seed amount from outstanding balance whenever the dialog opens.
+ useEffect(() => {
+ if (open) setAmount(order.amount_due ?? '')
+ }, [open, order.amount_due])
+
+ const { data: methodsData } = useQuery({
+ queryKey: ['payment-methods'],
+ queryFn: () => adminClient.paymentMethods.list({ limit: 50 }),
+ enabled: open,
+ staleTime: 60_000,
+ })
+ const paymentMethods = methodsData?.data ?? []
+ const selectedMethod = paymentMethods.find((m) => m.id === paymentMethodId)
+ const sourceRequired = selectedMethod?.source_required ?? false
+
+ const { data: cardsData } = useQuery({
+ queryKey: ['customer-credit-cards', customerId],
+ queryFn: () =>
+ customerId
+ ? adminClient.customers.creditCards.list(customerId, { limit: 50 })
+ : Promise.resolve(null),
+ enabled: open && Boolean(customerId) && sourceRequired,
+ staleTime: 30_000,
+ })
+ const savedCards = cardsData?.data ?? []
+ const canSubmit = Boolean(paymentMethodId) && (!sourceRequired || Boolean(sourceId))
+
+ const mutation = useOrderMutation(orderId, () =>
+ adminClient.orders.payments.create(orderId, {
+ payment_method_id: paymentMethodId,
+ ...(sourceId ? { source_id: sourceId } : {}),
+ // Ship raw merchant input; `Spree::LocalizedNumber.parse` on the
+ // backend handles locale-aware decoding (comma decimals etc.).
+ ...(amount ? { amount } : {}),
+ }),
+ )
+
+ const captureMutation = useOrderMutation(orderId, (paymentId: string) =>
+ adminClient.orders.payments.capture(orderId, paymentId, {}),
+ )
+
+ function reset() {
+ setPaymentMethodId('')
+ setSourceId('')
+ setAmount('')
+ setCapture(false)
+ }
+
+ function handleSubmit(e: FormEvent<HTMLFormElement>) {
+ e.preventDefault()
+ if (!canSubmit) return
+
+ mutation.mutate(undefined, {
+ onSuccess: (payment) => {
+ if (capture && payment && (payment as { id?: string }).id) {
+ captureMutation.mutate((payment as { id: string }).id, {
+ onSuccess: () => {
+ onOpenChange(false)
+ reset()
+ },
+ })
+ } else {
+ onOpenChange(false)
+ reset()
+ }
+ },
+ })
+ }
+
+ return (
+ <Dialog open={open} onOpenChange={onOpenChange}>
+ <DialogContent>
+ <DialogHeader>
+ <DialogTitle>{t('admin.orders.detail.payment_form.title')}</DialogTitle>
+ <DialogDescription>{t('admin.orders.detail.payment_form.description')}</DialogDescription>
+ </DialogHeader>
+ <form onSubmit={handleSubmit}>
+ <DialogBody>
+ <FieldGroup>
+ <Field>
+ <FieldLabel htmlFor="pay-method">
+ {t('admin.orders.detail.payment_form.method_label')}
+ </FieldLabel>
+ <Select
+ value={paymentMethodId}
+ onValueChange={(v) => {
+ setPaymentMethodId(v)
+ setSourceId('')
+ }}
+ >
+ <SelectTrigger id="pay-method">
+ <SelectValue
+ placeholder={t('admin.orders.detail.payment_form.method_placeholder')}
+ >
+ {(value) =>
+ paymentMethods.find((m) => m.id === value)?.name ??
+ t('admin.orders.detail.payment_form.method_placeholder')
+ }
+ </SelectValue>
+ </SelectTrigger>
+ <SelectContent>
+ {paymentMethods.map((m) => (
+ <SelectItem key={m.id} value={m.id}>
+ {m.name}
+ </SelectItem>
+ ))}
+ </SelectContent>
+ </Select>
+ </Field>
+
+ {sourceRequired && (
+ <Field>
+ <FieldLabel htmlFor="pay-source">
+ {t('admin.orders.detail.payment_form.source_label')}
+ </FieldLabel>
+ {!customerId ? (
+ <p className="text-sm text-destructive">
+ {t('admin.orders.detail.payment_form.source_requires_customer')}
+ </p>
+ ) : savedCards.length === 0 ? (
+ <p className="text-sm text-muted-foreground">
+ {t('admin.orders.detail.payment_form.no_saved_cards')}
+ </p>
+ ) : (
+ <Select value={sourceId} onValueChange={setSourceId}>
+ <SelectTrigger id="pay-source">
+ <SelectValue
+ placeholder={t('admin.orders.detail.payment_form.source_placeholder')}
+ >
+ {(value) => {
+ const card = savedCards.find((c) => c.id === value)
+ return card
+ ? `${card.brand} •••• ${card.last4} (${card.month}/${card.year})`
+ : t('admin.orders.detail.payment_form.source_placeholder')
+ }}
+ </SelectValue>
+ </SelectTrigger>
+ <SelectContent>
+ {savedCards.map((c) => (
+ <SelectItem key={c.id} value={c.id}>
+ {c.brand} •••• {c.last4} ({c.month}/{c.year})
+ </SelectItem>
+ ))}
+ </SelectContent>
+ </Select>
+ )}
+ </Field>
+ )}
+
+ <Field>
+ <FieldLabel htmlFor="pay-amount">{t('admin.fields.amount.label')}</FieldLabel>
+ <Input
+ id="pay-amount"
+ type="number"
+ step="0.01"
+ placeholder={order.amount_due ?? '0.00'}
+ value={amount}
+ onChange={(e) => setAmount(e.target.value)}
+ />
+ <p className="text-xs text-muted-foreground mt-1">
+ {t('admin.orders.detail.payment_form.amount_help')}
+ </p>
+ </Field>
+
+ <Field>
+ <label className="flex items-center gap-2 text-sm" htmlFor="pay-capture">
+ <Switch id="pay-capture" checked={capture} onCheckedChange={setCapture} />
+ {t('admin.orders.detail.payment_form.capture_immediately')}
+ </label>
+ </Field>
+ </FieldGroup>
+ </DialogBody>
+ <DialogFooter>
+ <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
+ {t('admin.actions.cancel')}
+ </Button>
+ <Button
+ type="submit"
+ disabled={!canSubmit || mutation.isPending || captureMutation.isPending}
+ >
+ {mutation.isPending || captureMutation.isPending
+ ? t('admin.actions.saving')
+ : t('admin.actions.add')}
+ </Button>
+ </DialogFooter>
+ </form>
+ </DialogContent>
+ </Dialog>
+ )
+}
diff --git a/packages/dashboard/src/components/spree/orders/order-skeleton.tsx b/packages/dashboard/src/components/spree/orders/order-skeleton.tsx
new file mode 100644
index 0000000000..e89f28d133
--- /dev/null
+++ b/packages/dashboard/src/components/spree/orders/order-skeleton.tsx
@@ -0,0 +1,24 @@
+import { Skeleton } from '@spree/dashboard-ui'
+
+export function OrderSkeleton() {
+ return (
+ <div className="flex flex-col gap-6">
+ <div className="flex items-center gap-3">
+ <Skeleton className="size-8 rounded-lg" />
+ <Skeleton className="h-8 w-40" />
+ <Skeleton className="h-5 w-16 rounded-md" />
+ <Skeleton className="h-5 w-16 rounded-md" />
+ </div>
+ <div className="grid grid-cols-12 gap-6">
+ <div className="col-span-12 lg:col-span-8 flex flex-col gap-6">
+ <Skeleton className="h-64 w-full rounded-xl" />
+ <Skeleton className="h-48 w-full rounded-xl" />
+ <Skeleton className="h-48 w-full rounded-xl" />
+ </div>
+ <div className="col-span-12 lg:col-span-4 flex flex-col gap-6">
+ <Skeleton className="h-64 w-full rounded-xl" />
+ </div>
+ </div>
+ </div>
+ )
+}
diff --git a/packages/dashboard/src/components/spree/orders/order-summary-card.tsx b/packages/dashboard/src/components/spree/orders/order-summary-card.tsx
new file mode 100644
index 0000000000..573267f3cd
--- /dev/null
+++ b/packages/dashboard/src/components/spree/orders/order-summary-card.tsx
@@ -0,0 +1,194 @@
+import type { Order } from '@spree/admin-sdk'
+import { LocaleLabel, useStore } from '@spree/dashboard-core'
+import { Card, CardHeader, CardTitle, cn, Separator } from '@spree/dashboard-ui'
+import { Link } from '@tanstack/react-router'
+import i18n from 'i18next'
+import type { ReactNode } from 'react'
+import { useTranslation } from 'react-i18next'
+
+function formatDate(iso: string | null) {
+ if (!iso) return '—'
+ return new Date(iso).toLocaleDateString(i18n.language, {
+ month: 'short',
+ day: 'numeric',
+ year: 'numeric',
+ hour: 'numeric',
+ minute: '2-digit',
+ })
+}
+
+function SummaryRow({
+ label,
+ value,
+ bold,
+ danger,
+ highlight,
+}: {
+ label: string
+ value: ReactNode
+ bold?: boolean
+ danger?: boolean
+ highlight?: boolean
+}) {
+ return (
+ <div
+ className={cn('flex items-center justify-between px-5 py-2.5', highlight && 'bg-muted/50')}
+ >
+ <span className="text-sm">{label}</span>
+ <span className={cn('text-sm', bold && 'font-bold', danger && 'text-destructive')}>
+ {value}
+ </span>
+ </div>
+ )
+}
+
+export function OrderSummaryCard({ order }: { order: Order }) {
+ const { t } = useTranslation()
+ const { storeId } = useStore()
+ const outstandingBalance = Number.parseFloat(order.amount_due)
+
+ return (
+ <Card>
+ <CardHeader>
+ <CardTitle>{t('admin.pages.orders.detail.section_summary')}</CardTitle>
+ </CardHeader>
+ <div className="py-1">
+ {order.created_by && (
+ <SummaryRow
+ label={t('admin.pages.orders.detail.summary.created_by')}
+ value={order.created_by.full_name || order.created_by.email}
+ />
+ )}
+ <SummaryRow
+ label={t('admin.fields.created_at.label')}
+ value={formatDate(order.created_at)}
+ />
+
+ {order.completed_at && (
+ <SummaryRow
+ label={t('admin.fields.completed_at.label')}
+ value={formatDate(order.completed_at)}
+ />
+ )}
+
+ {order.canceled_at && (
+ <>
+ <SummaryRow
+ label={t('admin.orders.detail.summary.canceled_at')}
+ value={formatDate(order.canceled_at)}
+ />
+ {order.canceler && (
+ <SummaryRow
+ label={t('admin.orders.detail.summary.canceler')}
+ value={order.canceler.full_name || order.canceler.email}
+ />
+ )}
+ </>
+ )}
+
+ {order.approved_at && order.approver && (
+ <SummaryRow
+ label={t('admin.orders.detail.summary.approved_by')}
+ value={order.approver.full_name || order.approver.email}
+ />
+ )}
+
+ <Separator />
+
+ {order.channel && (
+ <SummaryRow
+ label={t('admin.pages.orders.detail.summary.channel')}
+ value={
+ <Link
+ to="/$storeId/settings/channels"
+ params={{ storeId }}
+ search={{ edit: order.channel.id }}
+ className="text-foreground hover:underline"
+ >
+ {order.channel.name}
+ </Link>
+ }
+ />
+ )}
+
+ {order.market && (
+ <SummaryRow
+ label={t('admin.pages.orders.detail.summary.market')}
+ value={
+ <Link
+ to="/$storeId/settings/markets"
+ params={{ storeId }}
+ search={{ edit: order.market.id }}
+ className="text-foreground hover:underline"
+ >
+ {order.market.name}
+ </Link>
+ }
+ />
+ )}
+ <SummaryRow
+ label={t('admin.pages.orders.detail.summary.locale')}
+ value={order.locale ? <LocaleLabel code={order.locale} /> : '—'}
+ />
+ <SummaryRow label={t('admin.fields.currency.label')} value={order.currency} />
+
+ <Separator />
+
+ <SummaryRow label={t('admin.fields.subtotal.label')} value={order.display_item_total} />
+
+ {Number.parseFloat(order.delivery_total) > 0 && (
+ <SummaryRow
+ label={t('admin.fields.shipping.label')}
+ value={order.display_delivery_total}
+ />
+ )}
+
+ {Number.parseFloat(order.discount_total) !== 0 && (
+ <SummaryRow
+ label={t('admin.orders.detail.summary.promotions')}
+ value={order.display_discount_total}
+ />
+ )}
+
+ {Number.parseFloat(order.adjustment_total) !== 0 && (
+ <SummaryRow
+ label={t('admin.orders.detail.summary.adjustments')}
+ value={order.display_adjustment_total}
+ />
+ )}
+
+ {Number.parseFloat(order.included_tax_total) > 0 && (
+ <SummaryRow
+ label={t('admin.orders.detail.summary.tax_included')}
+ value={order.display_included_tax_total}
+ />
+ )}
+
+ {Number.parseFloat(order.additional_tax_total) > 0 && (
+ <SummaryRow
+ label={t('admin.orders.detail.summary.tax_additional')}
+ value={order.display_additional_tax_total}
+ />
+ )}
+
+ <Separator />
+
+ <SummaryRow label={t('admin.fields.total.label')} value={order.display_total} bold />
+
+ <Separator />
+
+ <SummaryRow
+ label={t('admin.orders.detail.summary.payment_total')}
+ value={order.display_payment_total}
+ highlight
+ />
+ <SummaryRow
+ label={t('admin.orders.detail.summary.outstanding_balance')}
+ value={order.display_amount_due}
+ highlight
+ danger={outstandingBalance > 0}
+ />
+ </div>
+ </Card>
+ )
+}
diff --git a/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId/index.tsx b/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId/index.tsx
index d485f2238b..ec1632017c 100644
--- a/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId/index.tsx
+++ b/packages/dashboard/src/routes/_authenticated/$storeId/orders/$orderId/index.tsx
@@ -1,85 +1,6 @@
-import type { Discount, Fee, Order } from '@spree/admin-sdk'
-import {
- AddressFormDialog,
- type AddressParams,
- adminClient,
- formatPrice,
- getInitials,
- LocaleLabel,
- PageHeader,
- Slot,
- TagCombobox,
- useResourceKey,
- useResourceMutation,
-} from '@spree/dashboard-core'
-import {
- AddressBlock,
- Avatar,
- AvatarFallback,
- Badge,
- Button,
- Card,
- CardAction,
- CardContent,
- CardHeader,
- CardTitle,
- cn,
- Dialog,
- DialogBody,
- DialogContent,
- DialogDescription,
- DialogFooter,
- DialogHeader,
- DialogTitle,
- DropdownMenu,
- DropdownMenuContent,
- DropdownMenuItem,
- DropdownMenuSeparator,
- DropdownMenuTrigger,
- ErrorState,
- Field,
- FieldGroup,
- FieldLabel,
- Input,
- MetadataCard,
- RelativeTime,
- ResourceLayout,
- RichTextEditor,
- Select,
- SelectContent,
- SelectItem,
- SelectTrigger,
- SelectValue,
- Separator,
- Skeleton,
- StatusBadge,
- Switch,
- Table,
- TableBody,
- TableCell,
- TableHead,
- TableHeader,
- TableRow,
- Textarea,
- useConfirm,
-} from '@spree/dashboard-ui'
-import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
-import { createFileRoute, Link } from '@tanstack/react-router'
-import i18n from 'i18next'
-import {
- CheckCircleIcon,
- CreditCardIcon,
- EllipsisVerticalIcon,
- ExternalLinkIcon,
- MailIcon,
- PencilIcon,
- PlusIcon,
- RotateCcwIcon,
- ShieldCheckIcon,
- TrashIcon,
- XCircleIcon,
-} from 'lucide-react'
-import { type FormEvent, type ReactNode, useEffect, useState } from 'react'
+import { Slot } from '@spree/dashboard-core'
+import { ErrorState, MetadataCard, ResourceLayout } from '@spree/dashboard-ui'
+import { createFileRoute } from '@tanstack/react-router'
import { useTranslation } from 'react-i18next'
import {
CustomFieldsInlineCard,
@@ -92,40 +13,27 @@ import {
import { OrderReturnsCard } from '../../../../../components/spree/order-returns-card'
import { FulfillmentsCard } from '../../../../../components/spree/orders/fulfillments-card'
import {
- orderQueryKey,
- useOrder,
- useOrderAdjustmentLinesMutation,
- useOrderDiscounts,
- useOrderFees,
- useOrderMutation,
- useOrderTaxLines,
-} from '../../../../../hooks/use-order'
-import { spreeJsonLinkResolver } from '../../../../../lib/json-link-resolver'
-import { FEE_KINDS } from '../../../../../schemas/order'
+ FeesCard,
+ OrderDiscountsCard,
+ TaxLinesCard,
+} from '../../../../../components/spree/orders/order-adjustments-cards'
+import { CustomerCard } from '../../../../../components/spree/orders/order-customer-card'
+import { DiscountsCard } from '../../../../../components/spree/orders/order-discounts-sidebar-card'
+import { OrderHeader } from '../../../../../components/spree/orders/order-header'
+import {
+ InternalNoteCard,
+ SpecialInstructionsCard,
+ TagsCard,
+} from '../../../../../components/spree/orders/order-notes-cards'
+import { PaymentsCard } from '../../../../../components/spree/orders/order-payments-card'
+import { OrderSkeleton } from '../../../../../components/spree/orders/order-skeleton'
+import { OrderSummaryCard } from '../../../../../components/spree/orders/order-summary-card'
+import { useOrder } from '../../../../../hooks/use-order'
export const Route = createFileRoute('/_authenticated/$storeId/orders/$orderId/')({
component: OrderDetailPage,
})
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-function formatDate(iso: string | null) {
- if (!iso) return '—'
- return new Date(iso).toLocaleDateString(i18n.language, {
- month: 'short',
- day: 'numeric',
- year: 'numeric',
- hour: 'numeric',
- minute: '2-digit',
- })
-}
-
-// ---------------------------------------------------------------------------
-// Page
-// ---------------------------------------------------------------------------
-
function OrderDetailPage() {
const { t } = useTranslation()
const { orderId } = Route.useParams()
@@ -186,1949 +94,3 @@ function OrderDetailPage() {
/>
)
}
-
-// ---------------------------------------------------------------------------
-// Header
-// ---------------------------------------------------------------------------
-
-function OrderHeader({ order }: { order: Order }) {
- const { t } = useTranslation()
- const { orderId, storeId } = Route.useParams()
- const confirm = useConfirm()
-
- const backFallback = order.completed_at ? 'orders' : 'orders/drafts'
-
- const cancelMutation = useResourceMutation({
- mutationFn: () => adminClient.orders.cancel(orderId),
- invalidate: [orderQueryKey(orderId)],
- successMessage: t('admin.orders.detail.messages.canceled'),
- errorMessage: t('admin.orders.detail.errors.cancel_failed'),
- })
- const completeMutation = useResourceMutation({
- mutationFn: () => adminClient.orders.complete(orderId),
- invalidate: [orderQueryKey(orderId)],
- successMessage: t('admin.orders.detail.messages.completed'),
- errorMessage: t('admin.orders.detail.errors.complete_failed'),
- })
- const approveMutation = useResourceMutation({
- mutationFn: () => adminClient.orders.approve(orderId),
- invalidate: [orderQueryKey(orderId)],
- successMessage: t('admin.orders.detail.messages.approved'),
- errorMessage: t('admin.orders.detail.errors.approve_failed'),
- })
- const resumeMutation = useResourceMutation({
- mutationFn: () => adminClient.orders.resume(orderId),
- invalidate: [orderQueryKey(orderId)],
- successMessage: t('admin.orders.detail.messages.resumed'),
- errorMessage: t('admin.orders.detail.errors.resume_failed'),
- })
- const resendMutation = useResourceMutation({
- mutationFn: () => adminClient.orders.resendConfirmation(orderId, {}),
- successMessage: t('admin.orders.detail.messages.confirmation_sent'),
- errorMessage: t('admin.orders.detail.errors.confirmation_send_failed'),
- })
-
- const badges = (
- <>
- {order.payment_status && <StatusBadge status={order.payment_status} />}
- {order.fulfillment_status && <StatusBadge status={order.fulfillment_status} />}
- </>
- )
-
- const subtitle = order.completed_at ? (
- <RelativeTime iso={order.completed_at} prefix={t('admin.orders.detail.completed_prefix')} />
- ) : undefined
-
- const dropdownItems = (
- <>
- {order.status === 'draft' && (
- <DropdownMenuItem
- onClick={async () => {
- if (
- await confirm({
- message: t('admin.orders.detail.confirm.complete_message'),
- confirmLabel: t('admin.orders.detail.dropdown.complete_order'),
- })
- ) {
- completeMutation.mutate(undefined)
- }
- }}
- disabled={completeMutation.isPending}
- >
- <CheckCircleIcon className="size-4" />
- {t('admin.orders.detail.dropdown.complete_order')}
- </DropdownMenuItem>
- )}
- {order.considered_risky && !order.approved_at && (
- <DropdownMenuItem
- onClick={async () => {
- if (
- await confirm({
- title: t('admin.pages.orders.detail.dialogs.approve_title'),
- message: t('admin.orders.detail.confirm.approve_message'),
- confirmLabel: t('admin.pages.orders.detail.actions.approve'),
- })
- ) {
- approveMutation.mutate(undefined)
- }
- }}
- disabled={approveMutation.isPending}
- >
- <ShieldCheckIcon className="size-4" />
- {t('admin.pages.orders.detail.actions.approve')}
- </DropdownMenuItem>
- )}
- {order.status === 'canceled' && (
- <DropdownMenuItem
- onClick={async () => {
- if (
- await confirm({
- message: t('admin.orders.detail.confirm.resume_message'),
- confirmLabel: t('admin.pages.orders.detail.actions.resume'),
- })
- ) {
- resumeMutation.mutate(undefined)
- }
- }}
- disabled={resumeMutation.isPending}
- >
- <RotateCcwIcon className="size-4" />
- {t('admin.pages.orders.detail.actions.resume')}
- </DropdownMenuItem>
- )}
- {order.completed_at && (
- <>
- <DropdownMenuItem>
- <ExternalLinkIcon className="size-4" />
- {t('admin.orders.detail.dropdown.preview_order')}
- </DropdownMenuItem>
- <DropdownMenuItem
- onClick={() => resendMutation.mutate(undefined)}
- disabled={resendMutation.isPending}
- >
- <MailIcon className="size-4" />
- {t('admin.orders.detail.dropdown.resend_confirmation')}
- </DropdownMenuItem>
- <DropdownMenuSeparator />
- </>
- )}
- {order.status !== 'canceled' && (
- <DropdownMenuItem
- variant="destructive"
- onClick={async () => {
- if (
- await confirm({
- title: t('admin.pages.orders.detail.dialogs.cancel_title'),
- message: t('admin.orders.detail.confirm.cancel_message'),
- variant: 'destructive',
- confirmLabel: t('admin.pages.orders.detail.actions.cancel'),
- })
- ) {
- cancelMutation.mutate(undefined)
- }
- }}
- disabled={cancelMutation.isPending}
- >
- <XCircleIcon className="size-4" />
- {t('admin.pages.orders.detail.actions.cancel')}
- </DropdownMenuItem>
- )}
- </>
- )
-
- return (
- <PageHeader
- title={order.number}
- subtitle={subtitle}
- backTo={backFallback}
- badges={badges}
- actions={
- <Button asChild variant="outline">
- <Link to="/$storeId/orders/$orderId/edit" params={{ storeId, orderId }}>
- <PencilIcon className="size-4" />
- {t('admin.orders.edit.action_label')}
- </Link>
- </Button>
- }
- dropdownItems={dropdownItems}
- resource={{ id: order.id, number: order.number }}
- jsonPreview={{
- title: `Order ${order.number}`,
- fetch: () => adminClient.orders.get(orderId),
- endpoint: `/api/v3/admin/orders/${orderId}`,
- resolveLink: spreeJsonLinkResolver(storeId),
- }}
- />
- )
-}
-
-// ---------------------------------------------------------------------------
-// Payments
-// ---------------------------------------------------------------------------
-
-function PaymentsCard({ order }: { order: Order }) {
- const { t } = useTranslation()
- const { orderId } = Route.useParams()
- const confirm = useConfirm()
- const [addOpen, setAddOpen] = useState(false)
-
- const payments = order.payments ?? []
-
- const captureMutation = useOrderMutation(orderId, (paymentId: string) =>
- adminClient.orders.payments.capture(orderId, paymentId, {}),
- )
- const voidMutation = useOrderMutation(orderId, (paymentId: string) =>
- adminClient.orders.payments.void(orderId, paymentId, {}),
- )
-
- return (
- <Card>
- <CardHeader>
- <CardTitle>
- <CreditCardIcon className="size-4" />
- {t('admin.pages.orders.detail.section_payments')}
- {payments.length > 0 && <Badge variant="outline">{payments.length}</Badge>}
- </CardTitle>
- <CardAction className="flex items-center gap-2">
- {order.payment_status && <StatusBadge status={order.payment_status} />}
- <Button size="sm" variant="outline" onClick={() => setAddOpen(true)}>
- <PlusIcon data-icon="inline-start" />
- {t('admin.actions.add')}
- </Button>
- </CardAction>
- </CardHeader>
- {payments.length === 0 ? (
- <CardContent>
- <p className="text-center text-muted-foreground py-8">
- {t('admin.pages.orders.detail.empty_payments')}
- </p>
- </CardContent>
- ) : (
- <div className="overflow-x-auto">
- <table className="w-full text-sm">
- <thead>
- <tr className="border-b bg-muted/50 text-muted-foreground">
- <th className="p-3 pl-5 text-left font-normal">
- {t('admin.orders.detail.payments_table.number')}
- </th>
- <th className="p-3 text-left font-normal">
- {t('admin.orders.detail.payments_table.method')}
- </th>
- <th className="p-3 text-left font-normal">
- {t('admin.orders.detail.payments_table.state')}
- </th>
- <th className="p-3 text-right font-normal">{t('admin.fields.amount.label')}</th>
- <th className="p-3 pr-5 w-10" />
- </tr>
- </thead>
- <tbody>
- {payments.map((payment) => (
- <tr key={payment.id} className="border-b last:border-b-0">
- <td className="p-3 pl-5 font-medium">{payment.number}</td>
- <td className="p-3 text-muted-foreground">
- {payment.payment_method?.name ?? '—'}
- </td>
- <td className="p-3">
- <StatusBadge status={payment.status} />
- </td>
- <td className="p-3 text-right font-medium whitespace-nowrap">
- {payment.display_amount}
- </td>
- <td className="p-3 pr-5">
- {(payment.status === 'checkout' ||
- payment.status === 'pending' ||
- payment.status === 'completed') && (
- <DropdownMenu>
- <DropdownMenuTrigger asChild>
- <Button variant="ghost" size="icon-xs">
- <EllipsisVerticalIcon className="size-4" />
- </Button>
- </DropdownMenuTrigger>
- <DropdownMenuContent align="end">
- {(payment.status === 'checkout' || payment.status === 'pending') && (
- <DropdownMenuItem
- onClick={async () => {
- if (
- await confirm({
- message: t('admin.orders.detail.confirm.capture_message'),
- variant: 'default',
- confirmLabel: t('admin.pages.orders.detail.actions.capture'),
- })
- ) {
- captureMutation.mutate(payment.id)
- }
- }}
- >
- <CreditCardIcon className="size-4" />
- {t('admin.pages.orders.detail.actions.capture')}
- </DropdownMenuItem>
- )}
- {(payment.status === 'checkout' ||
- payment.status === 'pending' ||
- payment.status === 'completed') && (
- <DropdownMenuItem
- className="text-destructive focus:text-destructive"
- onClick={async () => {
- if (
- await confirm({
- message: t('admin.orders.detail.confirm.void_message'),
- variant: 'destructive',
- confirmLabel: t('admin.pages.orders.detail.actions.void'),
- })
- ) {
- voidMutation.mutate(payment.id)
- }
- }}
- >
- <XCircleIcon className="size-4" />
- {t('admin.pages.orders.detail.actions.void')}
- </DropdownMenuItem>
- )}
- </DropdownMenuContent>
- </DropdownMenu>
- )}
- </td>
- </tr>
- ))}
- </tbody>
- </table>
- </div>
- )}
- <AddPaymentDialog order={order} open={addOpen} onOpenChange={setAddOpen} />
- </Card>
- )
-}
-
-function AddPaymentDialog({
- order,
- open,
- onOpenChange,
-}: {
- order: Order
- open: boolean
- onOpenChange: (open: boolean) => void
-}) {
- const { t } = useTranslation()
- const orderId = order.id
- const customerId = order.customer_id ?? undefined
- const [paymentMethodId, setPaymentMethodId] = useState<string>('')
- const [sourceId, setSourceId] = useState<string>('')
- const [amount, setAmount] = useState<string>(order.amount_due ?? '')
- const [capture, setCapture] = useState(false)
-
- // Re-seed amount from outstanding balance whenever the dialog opens.
- useEffect(() => {
- if (open) setAmount(order.amount_due ?? '')
- }, [open, order.amount_due])
-
- const { data: methodsData } = useQuery({
- queryKey: ['payment-methods'],
- queryFn: () => adminClient.paymentMethods.list({ limit: 50 }),
- enabled: open,
- staleTime: 60_000,
- })
- const paymentMethods = methodsData?.data ?? []
- const selectedMethod = paymentMethods.find((m) => m.id === paymentMethodId)
- const sourceRequired = selectedMethod?.source_required ?? false
-
- const { data: cardsData } = useQuery({
- queryKey: ['customer-credit-cards', customerId],
- queryFn: () =>
- customerId
- ? adminClient.customers.creditCards.list(customerId, { limit: 50 })
- : Promise.resolve(null),
- enabled: open && Boolean(customerId) && sourceRequired,
- staleTime: 30_000,
- })
- const savedCards = cardsData?.data ?? []
- const canSubmit = Boolean(paymentMethodId) && (!sourceRequired || Boolean(sourceId))
-
- const mutation = useOrderMutation(orderId, () =>
- adminClient.orders.payments.create(orderId, {
- payment_method_id: paymentMethodId,
- ...(sourceId ? { source_id: sourceId } : {}),
- // Ship raw merchant input; `Spree::LocalizedNumber.parse` on the
- // backend handles locale-aware decoding (comma decimals etc.).
- ...(amount ? { amount } : {}),
- }),
- )
-
- const captureMutation = useOrderMutation(orderId, (paymentId: string) =>
- adminClient.orders.payments.capture(orderId, paymentId, {}),
- )
-
- function reset() {
- setPaymentMethodId('')
- setSourceId('')
- setAmount('')
- setCapture(false)
- }
-
- function handleSubmit(e: FormEvent<HTMLFormElement>) {
- e.preventDefault()
- if (!canSubmit) return
-
- mutation.mutate(undefined, {
- onSuccess: (payment) => {
- if (capture && payment && (payment as { id?: string }).id) {
- captureMutation.mutate((payment as { id: string }).id, {
- onSuccess: () => {
- onOpenChange(false)
- reset()
- },
- })
- } else {
- onOpenChange(false)
- reset()
- }
- },
- })
- }
-
- return (
- <Dialog open={open} onOpenChange={onOpenChange}>
- <DialogContent>
- <DialogHeader>
- <DialogTitle>{t('admin.orders.detail.payment_form.title')}</DialogTitle>
- <DialogDescription>{t('admin.orders.detail.payment_form.description')}</DialogDescription>
- </DialogHeader>
- <form onSubmit={handleSubmit}>
- <DialogBody>
- <FieldGroup>
- <Field>
- <FieldLabel htmlFor="pay-method">
- {t('admin.orders.detail.payment_form.method_label')}
- </FieldLabel>
- <Select
- value={paymentMethodId}
- onValueChange={(v) => {
- setPaymentMethodId(v)
- setSourceId('')
- }}
- >
- <SelectTrigger id="pay-method">
- <SelectValue
- placeholder={t('admin.orders.detail.payment_form.method_placeholder')}
- >
- {(value) =>
- paymentMethods.find((m) => m.id === value)?.name ??
- t('admin.orders.detail.payment_form.method_placeholder')
- }
- </SelectValue>
- </SelectTrigger>
- <SelectContent>
- {paymentMethods.map((m) => (
- <SelectItem key={m.id} value={m.id}>
- {m.name}
- </SelectItem>
- ))}
- </SelectContent>
- </Select>
- </Field>
-
- {sourceRequired && (
- <Field>
- <FieldLabel htmlFor="pay-source">
- {t('admin.orders.detail.payment_form.source_label')}
- </FieldLabel>
- {!customerId ? (
- <p className="text-sm text-destructive">
- {t('admin.orders.detail.payment_form.source_requires_customer')}
- </p>
- ) : savedCards.length === 0 ? (
- <p className="text-sm text-muted-foreground">
- {t('admin.orders.detail.payment_form.no_saved_cards')}
- </p>
- ) : (
- <Select value={sourceId} onValueChange={setSourceId}>
- <SelectTrigger id="pay-source">
- <SelectValue
- placeholder={t('admin.orders.detail.payment_form.source_placeholder')}
- >
- {(value) => {
- const card = savedCards.find((c) => c.id === value)
- return card
- ? `${card.brand} •••• ${card.last4} (${card.month}/${card.year})`
- : t('admin.orders.detail.payment_form.source_placeholder')
- }}
- </SelectValue>
- </SelectTrigger>
- <SelectContent>
- {savedCards.map((c) => (
- <SelectItem key={c.id} value={c.id}>
- {c.brand} •••• {c.last4} ({c.month}/{c.year})
- </SelectItem>
- ))}
- </SelectContent>
- </Select>
- )}
- </Field>
- )}
-
- <Field>
- <FieldLabel htmlFor="pay-amount">{t('admin.fields.amount.label')}</FieldLabel>
- <Input
- id="pay-amount"
- type="number"
- step="0.01"
- placeholder={order.amount_due ?? '0.00'}
- value={amount}
- onChange={(e) => setAmount(e.target.value)}
- />
- <p className="text-xs text-muted-foreground mt-1">
- {t('admin.orders.detail.payment_form.amount_help')}
- </p>
- </Field>
-
- <Field>
- <label className="flex items-center gap-2 text-sm" htmlFor="pay-capture">
- <Switch id="pay-capture" checked={capture} onCheckedChange={setCapture} />
- {t('admin.orders.detail.payment_form.capture_immediately')}
- </label>
- </Field>
- </FieldGroup>
- </DialogBody>
- <DialogFooter>
- <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
- {t('admin.actions.cancel')}
- </Button>
- <Button
- type="submit"
- disabled={!canSubmit || mutation.isPending || captureMutation.isPending}
- >
- {mutation.isPending || captureMutation.isPending
- ? t('admin.actions.saving')
- : t('admin.actions.add')}
- </Button>
- </DialogFooter>
- </form>
- </DialogContent>
- </Dialog>
- )
-}
-
-// ---------------------------------------------------------------------------
-// Adjustment lines: taxes, discounts & fees (typed rows)
-// ---------------------------------------------------------------------------
-
-/** The API accepts any kind string, so unknown values fall back to the raw value. */
-function feeKindLabel(kind: string) {
- return (FEE_KINDS as readonly string[]).includes(kind)
- ? i18n.t(`admin.orders.detail.adjustment_lines.fee_kind_${kind}`)
- : kind
-}
-
-/** Trailing action cell — renders empty (keeping column width) for undeletable rows. */
-function AdjustmentDeleteCell({
- onDelete,
- deleting,
-}: {
- onDelete?: () => void
- deleting?: boolean
-}) {
- return (
- <TableCell className="w-10 text-right">
- {onDelete && (
- <DropdownMenu>
- <DropdownMenuTrigger asChild>
- <Button
- variant="ghost"
- size="icon-xs"
- disabled={deleting}
- aria-label={i18n.t('admin.actions.actions_menu')}
- >
- <EllipsisVerticalIcon className="size-4" />
- </Button>
- </DropdownMenuTrigger>
- <DropdownMenuContent align="end">
- <DropdownMenuItem
- className="text-destructive focus:text-destructive"
- onClick={onDelete}
- >
- <TrashIcon className="size-4" />
- {i18n.t('admin.actions.delete')}
- </DropdownMenuItem>
- </DropdownMenuContent>
- </DropdownMenu>
- )}
- </TableCell>
- )
-}
-
-function TaxLinesCard({ order }: { order: Order }) {
- const { t } = useTranslation()
- const { orderId } = Route.useParams()
- const { data: taxLines } = useOrderTaxLines(orderId)
-
- // Tax rows grouped by label so a rate charged on many lines reads as one row.
- const taxGroups = new Map<string, { label: string; amount: number }>()
- for (const row of taxLines?.data ?? []) {
- const existing = taxGroups.get(row.label)
- if (existing) {
- existing.amount += Number.parseFloat(row.amount)
- } else {
- taxGroups.set(row.label, { label: row.label, amount: Number.parseFloat(row.amount) })
- }
- }
-
- return (
- <Card>
- <CardHeader>
- <CardTitle>{t('admin.orders.detail.adjustment_lines.taxes')}</CardTitle>
- </CardHeader>
-
- {taxGroups.size === 0 ? (
- <CardContent>
- <p className="text-sm text-muted-foreground">
- {t('admin.orders.detail.adjustment_lines.taxes_empty')}
- </p>
- </CardContent>
- ) : (
- <Table>
- <TableHeader>
- <TableRow>
- <TableHead>{t('admin.orders.detail.adjustment_lines.column_label')}</TableHead>
- <TableHead className="text-right">
- {t('admin.orders.detail.adjustment_lines.column_amount')}
- </TableHead>
- </TableRow>
- </TableHeader>
- <TableBody className="border-t border-border">
- {[...taxGroups.values()].map((group) => (
- <TableRow key={group.label}>
- <TableCell>{group.label}</TableCell>
- <TableCell className="text-right tabular-nums">
- {formatPrice({
- amount: group.amount.toFixed(2),
- currency: order.currency,
- display_amount: null,
- })}
- </TableCell>
- </TableRow>
- ))}
- </TableBody>
- </Table>
- )}
- </Card>
- )
-}
-
-function OrderDiscountsCard({ order }: { order: Order }) {
- const { t } = useTranslation()
- const { orderId } = Route.useParams()
- const confirm = useConfirm()
- const [addDiscountOpen, setAddDiscountOpen] = useState(false)
-
- const { data: discounts } = useOrderDiscounts(orderId)
- const deleteDiscountMutation = useOrderAdjustmentLinesMutation(orderId, (id: string) =>
- adminClient.orders.discounts.delete(orderId, id),
- )
-
- // Only promotion rows are system-owned; anything else is admin-entered and deletable.
- const discountRows = discounts?.data ?? []
-
- async function handleDeleteDiscount(row: Discount) {
- const confirmed = await confirm({
- title: t('admin.orders.detail.adjustment_lines.delete_discount_title'),
- message: t('admin.orders.detail.adjustment_lines.delete_discount_message', {
- label: row.label,
- }),
- confirmLabel: t('admin.actions.delete'),
- variant: 'destructive',
- })
- if (confirmed) deleteDiscountMutation.mutate(row.id)
- }
-
- return (
- <Card>
- <CardHeader>
- <CardTitle>{t('admin.orders.detail.adjustment_lines.discounts')}</CardTitle>
- <CardAction>
- <Button variant="outline" size="sm" onClick={() => setAddDiscountOpen(true)}>
- <PlusIcon className="size-4" />
- {t('admin.orders.detail.adjustment_lines.add_discount')}
- </Button>
- </CardAction>
- </CardHeader>
-
- {discountRows.length === 0 ? (
- <CardContent>
- <p className="text-sm text-muted-foreground">
- {t('admin.orders.detail.adjustment_lines.discounts_empty')}
- </p>
- </CardContent>
- ) : (
- <Table>
- <TableHeader>
- <TableRow>
- <TableHead>{t('admin.orders.detail.adjustment_lines.column_label')}</TableHead>
- <TableHead>{t('admin.orders.detail.adjustment_lines.column_source')}</TableHead>
- <TableHead>{t('admin.orders.detail.adjustment_lines.column_code')}</TableHead>
- <TableHead className="text-right">
- {t('admin.orders.detail.adjustment_lines.column_amount')}
- </TableHead>
- <TableHead className="w-10" />
- </TableRow>
- </TableHeader>
- <TableBody className="border-t border-border">
- {discountRows.map((row) => (
- <TableRow key={row.id}>
- <TableCell>{row.label}</TableCell>
- <TableCell>
- <Badge variant="secondary">
- {row.kind === 'promotion'
- ? t('admin.orders.detail.adjustment_lines.kind_promotion')
- : t('admin.orders.detail.adjustment_lines.kind_manual')}
- </Badge>
- </TableCell>
- <TableCell className="text-muted-foreground">
- {row.code ? <Badge variant="outline">{row.code}</Badge> : '—'}
- </TableCell>
- <TableCell className="text-right tabular-nums">{row.display_amount}</TableCell>
- <AdjustmentDeleteCell
- onDelete={row.kind === 'promotion' ? undefined : () => handleDeleteDiscount(row)}
- deleting={deleteDiscountMutation.isPending}
- />
- </TableRow>
- ))}
- </TableBody>
- </Table>
- )}
-
- <AddDiscountDialog order={order} open={addDiscountOpen} onOpenChange={setAddDiscountOpen} />
- </Card>
- )
-}
-
-function FeesCard({ order }: { order: Order }) {
- const { t } = useTranslation()
- const { orderId } = Route.useParams()
- const confirm = useConfirm()
- const [addFeeOpen, setAddFeeOpen] = useState(false)
-
- const { data: fees } = useOrderFees(orderId)
- const deleteFeeMutation = useOrderAdjustmentLinesMutation(orderId, (id: string) =>
- adminClient.orders.fees.delete(orderId, id),
- )
-
- const feeRows = fees?.data ?? []
-
- async function handleDeleteFee(row: Fee) {
- const confirmed = await confirm({
- title: t('admin.orders.detail.adjustment_lines.delete_fee_title'),
- message: t('admin.orders.detail.adjustment_lines.delete_fee_message', { label: row.label }),
- confirmLabel: t('admin.actions.delete'),
- variant: 'destructive',
- })
- if (confirmed) deleteFeeMutation.mutate(row.id)
- }
-
- return (
- <Card>
- <CardHeader>
- <CardTitle>{t('admin.orders.detail.adjustment_lines.fees')}</CardTitle>
- <CardAction>
- <Button variant="outline" size="sm" onClick={() => setAddFeeOpen(true)}>
- <PlusIcon className="size-4" />
- {t('admin.orders.detail.adjustment_lines.add_fee')}
- </Button>
- </CardAction>
- </CardHeader>
-
- {feeRows.length === 0 ? (
- <CardContent>
- <p className="text-sm text-muted-foreground">
- {t('admin.orders.detail.adjustment_lines.fees_empty')}
- </p>
- </CardContent>
- ) : (
- <Table>
- <TableHeader>
- <TableRow>
- <TableHead>{t('admin.orders.detail.adjustment_lines.column_label')}</TableHead>
- <TableHead>{t('admin.orders.detail.adjustment_lines.column_kind')}</TableHead>
- <TableHead className="text-right">
- {t('admin.orders.detail.adjustment_lines.column_amount')}
- </TableHead>
- <TableHead className="w-10" />
- </TableRow>
- </TableHeader>
- <TableBody className="border-t border-border">
- {feeRows.map((row) => (
- <TableRow key={row.id}>
- <TableCell>{row.label}</TableCell>
- <TableCell className="text-muted-foreground">
- {row.kind ? <Badge variant="outline">{feeKindLabel(row.kind)}</Badge> : '—'}
- </TableCell>
- <TableCell className="text-right tabular-nums">{row.display_amount}</TableCell>
- <AdjustmentDeleteCell
- onDelete={() => handleDeleteFee(row)}
- deleting={deleteFeeMutation.isPending}
- />
- </TableRow>
- ))}
- </TableBody>
- </Table>
- )}
-
- <AddFeeDialog order={order} open={addFeeOpen} onOpenChange={setAddFeeOpen} />
- </Card>
- )
-}
-
-function AddDiscountDialog({
- order,
- open,
- onOpenChange,
-}: {
- order: Order
- open: boolean
- onOpenChange: (open: boolean) => void
-}) {
- const { t, i18n } = useTranslation()
- const { orderId } = Route.useParams()
- const [target, setTarget] = useState('order')
- const [valueType, setValueType] = useState('flat')
- const [value, setValue] = useState('')
-
- const mutation = useOrderAdjustmentLinesMutation(
- orderId,
- (params: {
- label: string
- value: string
- value_type: 'flat' | 'percent'
- line_item_id?: string
- }) => adminClient.orders.discounts.create(orderId, params),
- )
-
- const targetOptions = [
- { value: 'order', label: t('admin.orders.detail.adjustment_lines.target_order') },
- ...(order.items ?? []).map((item) => ({ value: item.id, label: item.name ?? item.id })),
- ]
- const valueTypeOptions = [
- { value: 'flat', label: t('admin.orders.detail.adjustment_lines.value_type_flat') },
- { value: 'percent', label: t('admin.orders.detail.adjustment_lines.value_type_percent') },
- ]
-
- function handleSubmit(e: FormEvent<HTMLFormElement>) {
- e.preventDefault()
- const fd = new FormData(e.currentTarget)
- mutation.mutate(
- {
- label: fd.get('label') as string,
- value,
- value_type: valueType as 'flat' | 'percent',
- ...(target !== 'order' ? { line_item_id: target } : {}),
- },
- {
- onSuccess: () => {
- setValue('')
- onOpenChange(false)
- },
- },
- )
- }
-
- // Mirrors Orders::AddManualDiscount: percent applies to the already-
- // discounted line amounts, clamped so no line goes below zero.
- const numericValue = Number.parseFloat(value)
- let previewAmount: number | null = null
- if (valueType === 'percent' && Number.isFinite(numericValue) && numericValue > 0) {
- const items = order.items ?? []
- const base =
- target === 'order'
- ? items.reduce(
- (sum, item) => sum + Math.max(Number.parseFloat(item.discounted_amount), 0),
- 0,
- )
- : Math.max(
- Number.parseFloat(items.find((item) => item.id === target)?.discounted_amount ?? '0'),
- 0,
- )
- if (base > 0) previewAmount = Math.min((base * numericValue) / 100, base)
- }
-
- return (
- <Dialog open={open} onOpenChange={onOpenChange}>
- <DialogContent>
- <DialogHeader>
- <DialogTitle>{t('admin.orders.detail.adjustment_lines.add_discount')}</DialogTitle>
- <DialogDescription>
- {t('admin.orders.detail.adjustment_lines.add_discount_description')}
- </DialogDescription>
- </DialogHeader>
- <form onSubmit={handleSubmit}>
- <DialogBody>
- <FieldGroup>
- <Field>
- <FieldLabel htmlFor="discount-label">
- {t('admin.orders.detail.adjustment_lines.label_field')}
- </FieldLabel>
- <Input id="discount-label" name="label" required />
- </Field>
- <div className="grid grid-cols-2 gap-3">
- <Field>
- <FieldLabel htmlFor="discount-value">
- {t('admin.orders.detail.adjustment_lines.value_field')}
- </FieldLabel>
- <Input
- id="discount-value"
- name="value"
- type="number"
- step="0.01"
- min="0.01"
- value={value}
- onChange={(e) => setValue(e.target.value)}
- required
- />
- </Field>
- <Field>
- <FieldLabel>
- {t('admin.orders.detail.adjustment_lines.value_type_field')}
- </FieldLabel>
- <Select
- items={valueTypeOptions}
- value={valueType}
- onValueChange={(v) => setValueType(v as string)}
- >
- <SelectTrigger>
- <SelectValue />
- </SelectTrigger>
- <SelectContent>
- {valueTypeOptions.map((option) => (
- <SelectItem key={option.value} value={option.value}>
- {option.label}
- </SelectItem>
- ))}
- </SelectContent>
- </Select>
- </Field>
- </div>
- <Field>
- <FieldLabel>{t('admin.orders.detail.adjustment_lines.target_field')}</FieldLabel>
- <Select
- items={targetOptions}
- value={target}
- onValueChange={(v) => setTarget(v as string)}
- >
- <SelectTrigger>
- <SelectValue />
- </SelectTrigger>
- <SelectContent>
- {targetOptions.map((option) => (
- <SelectItem key={option.value} value={option.value}>
- {option.label}
- </SelectItem>
- ))}
- </SelectContent>
- </Select>
- </Field>
- {previewAmount !== null && (
- <p className="text-sm text-muted-foreground">
- {t('admin.orders.detail.adjustment_lines.percent_preview', {
- amount: new Intl.NumberFormat(i18n.language, {
- style: 'currency',
- currency: order.currency,
- }).format(previewAmount),
- })}
- </p>
- )}
- </FieldGroup>
- </DialogBody>
- <DialogFooter>
- <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
- {t('admin.actions.cancel')}
- </Button>
- <Button type="submit" disabled={mutation.isPending}>
- {mutation.isPending
- ? t('admin.actions.saving')
- : t('admin.orders.detail.adjustment_lines.add_discount')}
- </Button>
- </DialogFooter>
- </form>
- </DialogContent>
- </Dialog>
- )
-}
-
-function AddFeeDialog({
- order,
- open,
- onOpenChange,
-}: {
- order: Order
- open: boolean
- onOpenChange: (open: boolean) => void
-}) {
- const { t } = useTranslation()
- const { orderId } = Route.useParams()
- const [target, setTarget] = useState('order')
- const [kind, setKind] = useState<string>('surcharge')
-
- const mutation = useOrderAdjustmentLinesMutation(
- orderId,
- (params: { label: string; amount: string; kind?: string; line_item_id?: string }) =>
- adminClient.orders.fees.create(orderId, params),
- )
-
- const targetOptions = [
- { value: 'order', label: t('admin.orders.detail.adjustment_lines.target_order') },
- ...(order.items ?? []).map((item) => ({ value: item.id, label: item.name ?? item.id })),
- ]
-
- const kindOptions = FEE_KINDS.map((value) => ({
- value,
- label: t(`admin.orders.detail.adjustment_lines.fee_kind_${value}`),
- }))
-
- function handleSubmit(e: FormEvent<HTMLFormElement>) {
- e.preventDefault()
- const fd = new FormData(e.currentTarget)
- mutation.mutate(
- {
- label: fd.get('label') as string,
- amount: fd.get('amount') as string,
- kind,
- ...(target !== 'order' ? { line_item_id: target } : {}),
- },
- { onSuccess: () => onOpenChange(false) },
- )
- }
-
- return (
- <Dialog open={open} onOpenChange={onOpenChange}>
- <DialogContent>
- <DialogHeader>
- <DialogTitle>{t('admin.orders.detail.adjustment_lines.add_fee')}</DialogTitle>
- <DialogDescription>
- {t('admin.orders.detail.adjustment_lines.add_fee_description')}
- </DialogDescription>
- </DialogHeader>
- <form onSubmit={handleSubmit}>
- <DialogBody>
- <FieldGroup>
- <Field>
- <FieldLabel htmlFor="fee-label">
- {t('admin.orders.detail.adjustment_lines.label_field')}
- </FieldLabel>
- <Input id="fee-label" name="label" required />
- </Field>
- <div className="grid grid-cols-2 gap-3">
- <Field>
- <FieldLabel htmlFor="fee-amount">
- {t('admin.orders.detail.adjustment_lines.amount_field')}
- </FieldLabel>
- <Input id="fee-amount" name="amount" type="number" step="0.01" min="0" required />
- </Field>
- <Field>
- <FieldLabel>{t('admin.orders.detail.adjustment_lines.kind_field')}</FieldLabel>
- <Select
- items={kindOptions}
- value={kind}
- onValueChange={(v) => setKind(v as string)}
- >
- <SelectTrigger>
- <SelectValue />
- </SelectTrigger>
- <SelectContent>
- {kindOptions.map((option) => (
- <SelectItem key={option.value} value={option.value}>
- {option.label}
- </SelectItem>
- ))}
- </SelectContent>
- </Select>
- </Field>
- </div>
- <Field>
- <FieldLabel>{t('admin.orders.detail.adjustment_lines.target_field')}</FieldLabel>
- <Select
- items={targetOptions}
- value={target}
- onValueChange={(v) => setTarget(v as string)}
- >
- <SelectTrigger>
- <SelectValue />
- </SelectTrigger>
- <SelectContent>
- {targetOptions.map((option) => (
- <SelectItem key={option.value} value={option.value}>
- {option.label}
- </SelectItem>
- ))}
- </SelectContent>
- </Select>
- </Field>
- </FieldGroup>
- </DialogBody>
- <DialogFooter>
- <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
- {t('admin.actions.cancel')}
- </Button>
- <Button type="submit" disabled={mutation.isPending}>
- {mutation.isPending
- ? t('admin.actions.saving')
- : t('admin.orders.detail.adjustment_lines.add_fee')}
- </Button>
- </DialogFooter>
- </form>
- </DialogContent>
- </Dialog>
- )
-}
-
-// ---------------------------------------------------------------------------
-// Order Summary
-// ---------------------------------------------------------------------------
-
-function SummaryRow({
- label,
- value,
- bold,
- danger,
- highlight,
-}: {
- label: string
- value: ReactNode
- bold?: boolean
- danger?: boolean
- highlight?: boolean
-}) {
- return (
- <div
- className={cn('flex items-center justify-between px-5 py-2.5', highlight && 'bg-muted/50')}
- >
- <span className="text-sm">{label}</span>
- <span className={cn('text-sm', bold && 'font-bold', danger && 'text-destructive')}>
- {value}
- </span>
- </div>
- )
-}
-
-function OrderSummaryCard({ order }: { order: Order }) {
- const { t } = useTranslation()
- const { storeId } = Route.useParams()
- const outstandingBalance = Number.parseFloat(order.amount_due)
-
- return (
- <Card>
- <CardHeader>
- <CardTitle>{t('admin.pages.orders.detail.section_summary')}</CardTitle>
- </CardHeader>
- <div className="py-1">
- {order.created_by && (
- <SummaryRow
- label={t('admin.pages.orders.detail.summary.created_by')}
- value={order.created_by.full_name || order.created_by.email}
- />
- )}
- <SummaryRow
- label={t('admin.fields.created_at.label')}
- value={formatDate(order.created_at)}
- />
-
- {order.completed_at && (
- <SummaryRow
- label={t('admin.fields.completed_at.label')}
- value={formatDate(order.completed_at)}
- />
- )}
-
- {order.canceled_at && (
- <>
- <SummaryRow
- label={t('admin.orders.detail.summary.canceled_at')}
- value={formatDate(order.canceled_at)}
- />
- {order.canceler && (
- <SummaryRow
- label={t('admin.orders.detail.summary.canceler')}
- value={order.canceler.full_name || order.canceler.email}
- />
- )}
- </>
- )}
-
- {order.approved_at && order.approver && (
- <SummaryRow
- label={t('admin.orders.detail.summary.approved_by')}
- value={order.approver.full_name || order.approver.email}
- />
- )}
-
- <Separator />
-
- {order.channel && (
- <SummaryRow
- label={t('admin.pages.orders.detail.summary.channel')}
- value={
- <Link
- to="/$storeId/settings/channels"
- params={{ storeId }}
- search={{ edit: order.channel.id }}
- className="text-foreground hover:underline"
- >
- {order.channel.name}
- </Link>
- }
- />
- )}
-
- {order.market && (
- <SummaryRow
- label={t('admin.pages.orders.detail.summary.market')}
- value={
- <Link
- to="/$storeId/settings/markets"
- params={{ storeId }}
- search={{ edit: order.market.id }}
- className="text-foreground hover:underline"
- >
- {order.market.name}
- </Link>
- }
- />
- )}
- <SummaryRow
- label={t('admin.pages.orders.detail.summary.locale')}
- value={order.locale ? <LocaleLabel code={order.locale} /> : '—'}
- />
- <SummaryRow label={t('admin.fields.currency.label')} value={order.currency} />
-
- <Separator />
-
- <SummaryRow label={t('admin.fields.subtotal.label')} value={order.display_item_total} />
-
- {Number.parseFloat(order.delivery_total) > 0 && (
- <SummaryRow
- label={t('admin.fields.shipping.label')}
- value={order.display_delivery_total}
- />
- )}
-
- {Number.parseFloat(order.discount_total) !== 0 && (
- <SummaryRow
- label={t('admin.orders.detail.summary.promotions')}
- value={order.display_discount_total}
- />
- )}
-
- {Number.parseFloat(order.adjustment_total) !== 0 && (
- <SummaryRow
- label={t('admin.orders.detail.summary.adjustments')}
- value={order.display_adjustment_total}
- />
- )}
-
- {Number.parseFloat(order.included_tax_total) > 0 && (
- <SummaryRow
- label={t('admin.orders.detail.summary.tax_included')}
- value={order.display_included_tax_total}
- />
- )}
-
- {Number.parseFloat(order.additional_tax_total) > 0 && (
- <SummaryRow
- label={t('admin.orders.detail.summary.tax_additional')}
- value={order.display_additional_tax_total}
- />
- )}
-
- <Separator />
-
- <SummaryRow label={t('admin.fields.total.label')} value={order.display_total} bold />
-
- <Separator />
-
- <SummaryRow
- label={t('admin.orders.detail.summary.payment_total')}
- value={order.display_payment_total}
- highlight
- />
- <SummaryRow
- label={t('admin.orders.detail.summary.outstanding_balance')}
- value={order.display_amount_due}
- highlight
- danger={outstandingBalance > 0}
- />
- </div>
- </Card>
- )
-}
-
-// ---------------------------------------------------------------------------
-// Discounts: Gift Card + Store Credit
-// ---------------------------------------------------------------------------
-
-function DiscountsCard({ order }: { order: Order }) {
- const { t } = useTranslation()
- const { orderId } = Route.useParams()
- const confirm = useConfirm()
- const [giftCardOpen, setGiftCardOpen] = useState(false)
- const [couponOpen, setCouponOpen] = useState(false)
-
- const removeGiftCardMutation = useOrderMutation(orderId, () =>
- adminClient.orders.giftCards.remove(orderId, order.gift_card?.id ?? ''),
- )
- const removeCouponMutation = useOrderMutation(orderId, () =>
- adminClient.orders.discountCodes.delete(orderId, order.coupon_code ?? ''),
- )
- const applyStoreCreditMutation = useOrderMutation(orderId, () =>
- adminClient.orders.storeCredits.apply(orderId),
- )
- const removeStoreCreditMutation = useOrderMutation(orderId, () =>
- adminClient.orders.storeCredits.remove(orderId),
- )
-
- const hasStoreCredit = Number.parseFloat(order.store_credit_total) > 0
- const hasCustomer = Boolean(order.customer_id)
- const isEditable = !order.completed_at
- const couponPending = Boolean(order.coupon_code) && Number.parseFloat(order.discount_total) === 0
-
- return (
- <>
- <Card>
- <CardHeader>
- <CardTitle>{t('admin.orders.detail.gift_card_section.title')}</CardTitle>
- </CardHeader>
- <CardContent className="flex flex-col gap-3">
- {/* Discount code — editable on drafts; frozen after completion */}
- <div className="flex items-center justify-between gap-2">
- <div className="flex flex-col">
- <span className="text-sm font-medium">
- {t('admin.orders.detail.discount_section.label')}
- </span>
- {order.coupon_code ? (
- <span className="font-mono text-xs text-muted-foreground">
- {order.coupon_code}
- {couponPending && ` · ${t('admin.orders.detail.discount_section.pending_hint')}`}
- </span>
- ) : (
- <span className="text-xs text-muted-foreground">
- {t('admin.orders.detail.gift_card_section.none_applied')}
- </span>
- )}
- </div>
- {isEditable &&
- (order.coupon_code ? (
- <Button
- size="sm"
- variant="outline"
- onClick={async () => {
- if (
- await confirm({
- message: t('admin.orders.detail.discount_section.remove_confirm_message'),
- confirmLabel: t('admin.actions.remove'),
- })
- ) {
- removeCouponMutation.mutate(undefined)
- }
- }}
- disabled={removeCouponMutation.isPending}
- >
- {t('admin.actions.remove')}
- </Button>
- ) : (
- <Button size="sm" variant="outline" onClick={() => setCouponOpen(true)}>
- <PlusIcon className="size-4" />
- {t('admin.actions.apply')}
- </Button>
- ))}
- </div>
-
- <Separator />
-
- {/* Gift card */}
- <div className="flex items-center justify-between gap-2">
- <div className="flex flex-col">
- <span className="text-sm font-medium">
- {t('admin.orders.detail.gift_card_section.gift_card_label')}
- </span>
- {order.gift_card ? (
- <span className="text-xs text-muted-foreground">
- {order.gift_card.code} · {order.display_gift_card_total}
- </span>
- ) : (
- <span className="text-xs text-muted-foreground">
- {t('admin.orders.detail.gift_card_section.none_applied')}
- </span>
- )}
- </div>
- {order.gift_card ? (
- <Button
- size="sm"
- variant="outline"
- onClick={async () => {
- if (
- await confirm({
- message: t('admin.orders.detail.confirm.remove_gift_card_message'),
- confirmLabel: t('admin.actions.remove'),
- })
- ) {
- removeGiftCardMutation.mutate(undefined)
- }
- }}
- disabled={removeGiftCardMutation.isPending}
- >
- {t('admin.actions.remove')}
- </Button>
- ) : (
- <Button size="sm" variant="outline" onClick={() => setGiftCardOpen(true)}>
- <PlusIcon className="size-4" />
- {t('admin.actions.apply')}
- </Button>
- )}
- </div>
-
- <Separator />
-
- {/* Store credit */}
- <div className="flex items-center justify-between gap-2">
- <div className="flex flex-col">
- <span className="text-sm font-medium">
- {t('admin.orders.detail.gift_card_section.store_credit_label')}
- </span>
- {hasStoreCredit ? (
- <span className="text-xs text-muted-foreground">
- {order.display_store_credit_total}{' '}
- {t('admin.orders.detail.gift_card_section.applied_suffix')}
- </span>
- ) : (
- <span className="text-xs text-muted-foreground">
- {hasCustomer
- ? t('admin.orders.detail.gift_card_section.apply_balance')
- : t('admin.orders.detail.gift_card_section.requires_customer')}
- </span>
- )}
- </div>
- {hasStoreCredit ? (
- <Button
- size="sm"
- variant="outline"
- onClick={async () => {
- if (
- await confirm({
- message: t('admin.orders.detail.confirm.remove_store_credit_message'),
- confirmLabel: t('admin.actions.remove'),
- })
- ) {
- removeStoreCreditMutation.mutate(undefined)
- }
- }}
- disabled={removeStoreCreditMutation.isPending}
- >
- {t('admin.actions.remove')}
- </Button>
- ) : (
- <Button
- size="sm"
- variant="outline"
- disabled={!hasCustomer || applyStoreCreditMutation.isPending}
- onClick={() => applyStoreCreditMutation.mutate(undefined)}
- >
- <PlusIcon className="size-4" />
- {t('admin.actions.apply')}
- </Button>
- )}
- </div>
- </CardContent>
- </Card>
-
- <ApplyGiftCardDialog orderId={orderId} open={giftCardOpen} onOpenChange={setGiftCardOpen} />
- <CouponCodeDialog orderId={orderId} open={couponOpen} onOpenChange={setCouponOpen} />
- </>
- )
-}
-
-function CouponCodeDialog({
- orderId,
- open,
- onOpenChange,
-}: {
- orderId: string
- open: boolean
- onOpenChange: (open: boolean) => void
-}) {
- const { t } = useTranslation()
- const [code, setCode] = useState('')
-
- const promotionsQuery = useQuery({
- queryKey: useResourceKey('promotions', 'coupon-options'),
- queryFn: () => adminClient.promotions.list({ q: { kind_eq: 'coupon_code' }, per_page: 100 }),
- enabled: open,
- })
- const couponPromotions = (promotionsQuery.data?.data ?? []).filter((promotion) => promotion.code)
-
- const mutation = useOrderMutation(orderId, (params: { code: string }) =>
- adminClient.orders.discountCodes.create(orderId, params),
- )
-
- function handleSubmit(e: FormEvent<HTMLFormElement>) {
- e.preventDefault()
- const trimmed = code.trim()
- if (!trimmed) return
- mutation.mutate(
- { code: trimmed },
- {
- onSuccess: () => {
- setCode('')
- onOpenChange(false)
- },
- },
- )
- }
-
- return (
- <Dialog open={open} onOpenChange={onOpenChange}>
- <DialogContent>
- <DialogHeader>
- <DialogTitle>{t('admin.orders.detail.discount_section.apply_dialog_title')}</DialogTitle>
- <DialogDescription>
- {t('admin.orders.detail.discount_section.apply_dialog_description')}
- </DialogDescription>
- </DialogHeader>
- <form onSubmit={handleSubmit}>
- <DialogBody>
- <FieldGroup>
- <Field>
- <FieldLabel htmlFor="coupon-code">{t('admin.fields.code.label')}</FieldLabel>
- <Input
- id="coupon-code"
- name="code"
- value={code}
- onChange={(e) => setCode(e.target.value)}
- placeholder={t('admin.orders.detail.discount_section.code_placeholder')}
- required
- autoFocus
- />
- </Field>
- {couponPromotions.length > 0 && (
- <Field>
- <FieldLabel>
- {t('admin.orders.detail.discount_section.promotions_label')}
- </FieldLabel>
- <div className="flex max-h-48 flex-col gap-1 overflow-y-auto">
- {couponPromotions.map((promotion) => (
- <button
- type="button"
- key={promotion.id}
- onClick={() => setCode(promotion.code ?? '')}
- className={cn(
- 'flex items-center justify-between rounded-md border px-3 py-2 text-left text-sm hover:bg-accent',
- code === promotion.code && 'border-primary',
- )}
- >
- <span className="truncate">{promotion.name}</span>
- <span className="ml-2 shrink-0 font-mono text-xs text-muted-foreground">
- {promotion.code}
- </span>
- </button>
- ))}
- </div>
- </Field>
- )}
- {mutation.isError && (
- <p className="text-sm text-destructive">{(mutation.error as Error).message}</p>
- )}
- </FieldGroup>
- </DialogBody>
- <DialogFooter>
- <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
- {t('admin.actions.cancel')}
- </Button>
- <Button type="submit" disabled={mutation.isPending}>
- {t('admin.actions.apply')}
- </Button>
- </DialogFooter>
- </form>
- </DialogContent>
- </Dialog>
- )
-}
-
-function ApplyGiftCardDialog({
- orderId,
- open,
- onOpenChange,
-}: {
- orderId: string
- open: boolean
- onOpenChange: (open: boolean) => void
-}) {
- const { t } = useTranslation()
- const mutation = useOrderMutation(orderId, (params: { code: string }) =>
- adminClient.orders.giftCards.apply(orderId, params),
- )
-
- function handleSubmit(e: FormEvent<HTMLFormElement>) {
- e.preventDefault()
- const fd = new FormData(e.currentTarget)
- const code = (fd.get('code') as string).trim()
- if (!code) return
- mutation.mutate({ code }, { onSuccess: () => onOpenChange(false) })
- }
-
- return (
- <Dialog open={open} onOpenChange={onOpenChange}>
- <DialogContent>
- <DialogHeader>
- <DialogTitle>{t('admin.orders.detail.gift_card_section.apply_dialog_title')}</DialogTitle>
- <DialogDescription>
- {t('admin.orders.detail.gift_card_section.apply_dialog_description')}
- </DialogDescription>
- </DialogHeader>
- <form onSubmit={handleSubmit}>
- <DialogBody>
- <FieldGroup>
- <Field>
- <FieldLabel htmlFor="gift-card-code">{t('admin.fields.code.label')}</FieldLabel>
- <Input
- id="gift-card-code"
- name="code"
- placeholder={t('admin.orders.detail.gift_card_section.code_placeholder')}
- required
- autoFocus
- />
- </Field>
- </FieldGroup>
- </DialogBody>
- <DialogFooter>
- <Button type="button" variant="outline" onClick={() => onOpenChange(false)}>
- {t('admin.actions.cancel')}
- </Button>
- <Button type="submit" disabled={mutation.isPending}>
- {mutation.isPending ? t('admin.actions.saving') : t('admin.actions.add')}
- </Button>
- </DialogFooter>
- </form>
- </DialogContent>
- </Dialog>
- )
-}
-
-// ---------------------------------------------------------------------------
-// Customer Sidebar
-// ---------------------------------------------------------------------------
-
-function CustomerCard({ order }: { order: Order }) {
- const { t } = useTranslation()
- const { orderId } = Route.useParams()
- const queryClient = useQueryClient()
- const customer = order.customer
- const [editAddress, setEditAddress] = useState<'shipping_address' | 'billing_address' | null>(
- null,
- )
-
- const addressMutation = useMutation({
- mutationFn: (params: {
- type: 'shipping_address' | 'billing_address'
- address: AddressParams
- }) => adminClient.orders.update(orderId, { [params.type]: params.address } as any),
- onSuccess: () => {
- queryClient.invalidateQueries({ queryKey: ['order', orderId] })
- setEditAddress(null)
- },
- })
-
- const editTitle =
- editAddress === 'shipping_address'
- ? t('admin.orders.detail.address_edit.shipping_title')
- : t('admin.orders.detail.address_edit.billing_title')
-
- return (
- <>
- <Card>
- <CardHeader>
- <CardTitle>{t('admin.pages.orders.detail.section_customer')}</CardTitle>
- <CardAction>
- <DropdownMenu>
- <DropdownMenuTrigger asChild>
- <Button variant="ghost" size="icon-xs">
- <EllipsisVerticalIcon className="size-4" />
- </Button>
- </DropdownMenuTrigger>
- <DropdownMenuContent align="end">
- <DropdownMenuItem onClick={() => setEditAddress('shipping_address')}>
- <PencilIcon className="size-4" />
- {t('admin.orders.detail.address_edit.shipping_title')}
- </DropdownMenuItem>
- <DropdownMenuItem onClick={() => setEditAddress('billing_address')}>
- <PencilIcon className="size-4" />
- {t('admin.orders.detail.address_edit.billing_title')}
- </DropdownMenuItem>
- </DropdownMenuContent>
- </DropdownMenu>
- </CardAction>
- </CardHeader>
- <CardContent className="flex flex-col gap-5">
- {/* Contact info */}
- {customer ? (
- <div className="flex items-center gap-3 rounded-xl bg-muted p-3">
- <Avatar>
- <AvatarFallback>{getInitials(customer.full_name, customer.email)}</AvatarFallback>
- </Avatar>
- <div className="min-w-0 flex-1">
- <div className="truncate text-sm font-medium">{customer.full_name}</div>
- <div className="truncate text-xs text-muted-foreground">{customer.email}</div>
- </div>
- </div>
- ) : order.email ? (
- <div className="text-sm text-blue-600">{order.email}</div>
- ) : (
- <span className="text-sm text-muted-foreground">
- {t('admin.orders.detail.no_customer')}
- </span>
- )}
-
- <AddressBlock
- title={t('admin.pages.orders.detail.section_shipping_address')}
- address={order.shipping_address}
- />
- <AddressBlock
- title={t('admin.pages.orders.detail.section_billing_address')}
- address={order.billing_address}
- />
- </CardContent>
- </Card>
-
- {editAddress && (
- <AddressFormDialog
- title={editTitle}
- address={
- editAddress === 'shipping_address' ? order.shipping_address : order.billing_address
- }
- open={!!editAddress}
- onOpenChange={(open) => !open && setEditAddress(null)}
- onSave={(address) => addressMutation.mutate({ type: editAddress, address })}
- isPending={addressMutation.isPending}
- />
- )}
- </>
- )
-}
-
-// ---------------------------------------------------------------------------
-// Special Instructions
-// ---------------------------------------------------------------------------
-
-function SpecialInstructionsCard({ order }: { order: Order }) {
- const { t } = useTranslation()
- const { orderId } = Route.useParams()
-
- const [editing, setEditing] = useState(false)
- const mutation = useOrderMutation(orderId, (params: { customer_note: string }) =>
- adminClient.orders.update(orderId, params),
- )
-
- function handleSubmit(e: FormEvent<HTMLFormElement>) {
- e.preventDefault()
- const fd = new FormData(e.currentTarget)
- mutation.mutate(
- { customer_note: fd.get('customer_note') as string },
- { onSuccess: () => setEditing(false) },
- )
- }
-
- return (
- <Card>
- <CardHeader>
- <CardTitle>{t('admin.orders.detail.section_customer_note')}</CardTitle>
- <CardAction>
- <Button variant="ghost" size="icon-xs" onClick={() => setEditing(!editing)}>
- <PencilIcon className="size-4" />
- </Button>
- </CardAction>
- </CardHeader>
- <CardContent>
- {editing ? (
- <form onSubmit={handleSubmit} className="flex flex-col gap-3">
- <Textarea name="customer_note" defaultValue={order.customer_note ?? ''} />
- <div className="flex justify-end gap-2">
- <Button type="button" variant="outline" size="sm" onClick={() => setEditing(false)}>
- {t('admin.actions.cancel')}
- </Button>
- <Button type="submit" size="sm" disabled={mutation.isPending}>
- {mutation.isPending ? t('admin.actions.saving') : t('admin.actions.save')}
- </Button>
- </div>
- </form>
- ) : order.customer_note ? (
- <p className="text-sm text-muted-foreground whitespace-pre-wrap">{order.customer_note}</p>
- ) : (
- <p className="text-sm text-muted-foreground">{t('admin.common.none')}</p>
- )}
- </CardContent>
- </Card>
- )
-}
-
-// ---------------------------------------------------------------------------
-// Tags
-// ---------------------------------------------------------------------------
-
-function TagsCard({ order }: { order: Order }) {
- const { t } = useTranslation()
- const { orderId } = Route.useParams()
- const [editing, setEditing] = useState(false)
- const [tags, setTags] = useState<string[]>(order.tags ?? [])
-
- const mutation = useOrderMutation(orderId, (params: { tags: string[] }) =>
- adminClient.orders.update(orderId, params),
- )
-
- return (
- <Card>
- <CardHeader>
- <CardTitle>{t('admin.pages.customers.detail.section_tags')}</CardTitle>
- <CardAction>
- <Button
- variant="ghost"
- size="icon-xs"
- onClick={() => {
- setTags(order.tags ?? [])
- setEditing(!editing)
- }}
- >
- <PencilIcon className="size-4" />
- </Button>
- </CardAction>
- </CardHeader>
- <CardContent>
- {editing ? (
- <div className="flex flex-col gap-3">
- <TagCombobox taggableType="Spree::Order" value={tags} onChange={setTags} />
- <div className="flex justify-end gap-2">
- <Button type="button" variant="outline" size="sm" onClick={() => setEditing(false)}>
- {t('admin.actions.cancel')}
- </Button>
- <Button
- type="button"
- size="sm"
- disabled={mutation.isPending}
- onClick={() => mutation.mutate({ tags }, { onSuccess: () => setEditing(false) })}
- >
- {mutation.isPending ? t('admin.actions.saving') : t('admin.actions.save')}
- </Button>
- </div>
- </div>
- ) : order.tags?.length ? (
- <div className="flex flex-wrap gap-1">
- {order.tags.map((tag) => (
- <Badge key={tag}>{tag}</Badge>
- ))}
- </div>
- ) : (
- <p className="text-sm text-muted-foreground">{t('admin.common.none')}</p>
- )}
- </CardContent>
- </Card>
- )
-}
-
-// ---------------------------------------------------------------------------
-// Internal Note
-// ---------------------------------------------------------------------------
-
-function InternalNoteCard({ order }: { order: Order }) {
- const { t } = useTranslation()
- const { orderId } = Route.useParams()
-
- const [editing, setEditing] = useState(false)
- // Edit the HTML, not the plain-text projection: `internal_note` has its
- // markup stripped, so round-tripping it through the `internal_note_html`
- // write would flatten an existing note on a save that changed nothing.
- const [note, setNote] = useState(order.internal_note_html ?? '')
- const serverNote = order.internal_note_html ?? ''
-
- // Track the server value only while the editor is closed. Any order mutation
- // refetches this record, and adopting the incoming value mid-edit would throw
- // away whatever the user is part-way through typing.
- useEffect(() => {
- if (!editing) setNote(serverNote)
- }, [editing, serverNote])
-
- const mutation = useOrderMutation(orderId, (params: { internal_note: string }) =>
- adminClient.orders.update(orderId, params),
- )
-
- function handleSubmit(e: FormEvent<HTMLFormElement>) {
- e.preventDefault()
- mutation.mutate({ internal_note: note }, { onSuccess: () => setEditing(false) })
- }
-
- return (
- <Card>
- <CardHeader>
- <CardTitle>{t('admin.orders.detail.section_internal_note')}</CardTitle>
- <CardAction>
- <Button variant="ghost" size="icon-xs" onClick={() => setEditing(!editing)}>
- <PencilIcon className="size-4" />
- </Button>
- </CardAction>
- </CardHeader>
- <CardContent>
- {editing ? (
- <form onSubmit={handleSubmit} className="flex flex-col gap-3">
- <RichTextEditor
- ariaLabel={t('admin.orders.detail.section_internal_note')}
- value={note}
- onChange={setNote}
- />
- <div className="flex justify-end gap-2">
- <Button
- type="button"
- variant="outline"
- size="sm"
- onClick={() => {
- setNote(serverNote)
- setEditing(false)
- }}
- >
- {t('admin.actions.cancel')}
- </Button>
- <Button type="submit" size="sm" disabled={mutation.isPending}>
- {mutation.isPending ? t('admin.actions.saving') : t('admin.actions.save')}
- </Button>
- </div>
- </form>
- ) : order.internal_note_html ? (
- <div
- className="prose prose-sm max-w-none text-muted-foreground dark:prose-invert"
- // biome-ignore lint/security/noDangerouslySetInnerHtml: HTML is sanitized server-side via the rich-text pipeline
- dangerouslySetInnerHTML={{ __html: order.internal_note_html }}
- />
- ) : (
- <p className="text-sm text-muted-foreground">{t('admin.common.none')}</p>
- )}
- </CardContent>
- </Card>
- )
-}
-
-// ---------------------------------------------------------------------------
-// Loading skeleton
-// ---------------------------------------------------------------------------
-
-function OrderSkeleton() {
- return (
- <div className="flex flex-col gap-6">
- <div className="flex items-center gap-3">
- <Skeleton className="size-8 rounded-lg" />
- <Skeleton className="h-8 w-40" />
- <Skeleton className="h-5 w-16 rounded-md" />
- <Skeleton className="h-5 w-16 rounded-md" />
- </div>
- <div className="grid grid-cols-12 gap-6">
- <div className="col-span-12 lg:col-span-8 flex flex-col gap-6">
- <Skeleton className="h-64 w-full rounded-xl" />
- <Skeleton className="h-48 w-full rounded-xl" />
- <Skeleton className="h-48 w-full rounded-xl" />
- </div>
- <div className="col-span-12 lg:col-span-4 flex flex-col gap-6">
- <Skeleton className="h-64 w-full rounded-xl" />
- </div>
- </div>
- </div>
- )
-}