loopable / web /src /apps /restock-planner /AppView.tsx
fsanyoto's picture
Deploy AIOS web (React glide grid + FastAPI slice)
b2aa446 verified
Raw History Blame Contribute Delete
62.8 kB
import { useCallback, useEffect, useRef, useState, type ComponentType } from "react"; import { Dashboard } from "./Dashboard"; import type { DashboardKit } from "./Dashboard"; import { API_V1, CREDENTIALS } from "../../apiContract"; import { ConfirmDialog } from "../../ui/ConfirmDialog"; import { AppGrid } from "../AppGrid"; import { ActionCadence } from "../actions/ActionCadence"; import { SkuActions } from "../actions/SkuActions"; import { Kpi, KpiStrip } from "../../viz/kit/Kpi"; import type { KpiProps } from "../../viz/kit/Kpi"; import "../../styles/sdlc79/restock-planner.css"; import "../../styles/sdlc81/restock-loop.css"; import "../../styles/sdlc81/restock-reorder.css"; import "../../styles/sdlc82/restock-grid.css"; // The App frame owns navigation. This view shares Dashboard, the SKU Grid and the SKU drawer. /** C2: the App as the dispatcher passes it. Structurally equal to lane A's TemplateApplication. */ interface RestockApplication { id: string; name: string; templateKind?: string; templateView?: string; templateMark?: string; templateConnector?: string; capabilities?: Record<string, boolean>; } interface RestockAppViewProps { application: RestockApplication; canEdit: boolean } // C6 fixture compilers replace this glob with injected module loaders, never substitute the inbound UI kit. const dashboardModules = import.meta.glob("../App{Tabs,Dashboard}.tsx"); function useDashboardKit() { const [kit, setKit] = useState<DashboardKit | null | undefined>(undefined); useEffect(() => { let alive = true; const tabs = dashboardModules["../AppTabs.tsx"]; const dashboard = dashboardModules["../AppDashboard.tsx"]; if (!tabs || !dashboard) { setKit(null); return; } void Promise.all([tabs(), dashboard()]).then(([tabModule, dashboardModule]) => { const t = tabModule as { AppTabs?: DashboardKit["AppTabs"]; default?: DashboardKit["AppTabs"] }; const d = dashboardModule as { AppDashboard?: DashboardKit["AppDashboard"]; default?: DashboardKit["AppDashboard"] }; const AppTabs = t.AppTabs ?? t.default; const AppDashboard = d.AppDashboard ?? d.default; if (alive) setKit(AppTabs && AppDashboard ? { AppTabs, AppDashboard } : null); }).catch(() => { if (alive) setKit(null); }); return () => { alive = false; }; }, []); return kit; } interface Item { id: string; sku: string; asin: string; title: string; band: string; reason: string; status: string; owner: string; due: string; fbaAvailable: number | null; daysOfSupply: number | null; units30d: number | null; recommendedQty: number | null; recommendedShipDate: string; odooOnHand: number | null; odooFba: number | null; odooNote: string; openPurchaseQty: number | null; inReport: boolean; label_owner: string; prep_owner: string; amazonRecommendedQty: number | null; odooNonFbaOnHand: number | null; sentQty: number | null; inboundPlanId: string; sendToAmazonUrl: string; inboundState: string; inboundReason: string; cancelledPlanId: string; cancelledBy: string; cancelledAt: string; } interface Warehouse { warehouse: string; fba: boolean; onHand: number | null } interface PurchaseOrder { order: string; vendor: string; openQty: number | null; expected: string } interface Point { date: string; fbaAvailable: number | null; daysOfSupply: number | null; units30d: number | null; inbound: number | null; band: string; } /** The two band thresholds in days of supply, from the App settings (R49). */ interface Thresholds { sendToFbaDays: number; overstockDays: number } type InboundOwner = "Seller" | "Amazon"; interface ShipFromAddress { name: string; addressLine1: string; addressLine2: string; city: string; stateOrProvinceCode: string; postalCode: string; countryCode: string; phoneNumber: string; } interface RestockSettings extends Thresholds { label_owner: InboundOwner; prep_owner: InboundOwner; ship_from: ShipFromAddress; fba_capacity: { value: number; unit: string } | null; } interface CapacityCause { cause: string; count: number; skus: string[] } interface CapacitySummary { unit: string | null; fba_capacity: RestockSettings["fba_capacity"]; remaining: number | null; storageVolume: number | null; plannedVolume: number | null; plannedSkuCount: number; capacityReason: string; quantityBasis: string; storageCauses: CapacityCause[]; plannedCauses: CapacityCause[]; } interface FeeCoverage { coverage: string; basis: string; source: string } type AppUrl = (path: string, params?: Record<string, string>) => string; interface Detail { item: Item; warehouses: Warehouse[]; openPurchaseOrders: PurchaseOrder[]; points: Point[]; thresholds: Thresholds | null; offset: number; limit: number; total: number; totals: Record<string, number>; } interface ListPage { items: Item[]; cursor: string | null; previousCursor: string | null; offset: number; total: number; ready: boolean; message: string; notices: string[]; refreshedAt: string; lastError: string; statuses: string[]; owners: string[]; thresholds: Thresholds | null; canEdit: boolean; lowInventoryFee: FeeCoverage | null; } type Load<T> = { phase: "loading" } | { phase: "error"; message: string } | { phase: "ready"; value: T }; interface RestockTile extends KpiProps { id: string; trend: number[] } // C4: lane C adds the optional trend prop. The current kit still shows value and change. const RestockKpi: ComponentType<KpiProps & { trend?: number[] }> = Kpi; function RestockTiles({ url, revision }: { url: AppUrl; revision: unknown }) { const [state, setState] = useState<Load<RestockTile[]>>({ phase: "loading" }); const [attempt, setAttempt] = useState(0); useEffect(() => { const controller = new AbortController(); setState({ phase: "loading" }); void fetch(url("/tiles"), { credentials: CREDENTIALS, signal: controller.signal }) .then((response) => readJson(response, "Restock tiles could not be loaded")) .then((body) => { const entries = list((body as { tiles?: unknown } | null)?.tiles); const tiles = entries.map((entry): RestockTile => { const tile = entry as RestockTile; return { id: text(tile.id), label: text(tile.label), value: num(tile.value), unit: text(tile.unit), validated: tile.validated === true, reason: text(tile.reason), trend: list(tile.trend).filter((point): point is number => num(point) !== null), change: tile.change }; }); if (tiles.length !== 3 || new Set(tiles.map((tile) => tile.id)).size !== 3) { throw new Error("Restock tiles could not be loaded"); } if (!controller.signal.aborted) setState({ phase: "ready", value: tiles }); }) .catch((reason: unknown) => { if (!controller.signal.aborted) setState({ phase: "error", message: failure(reason, "Restock tiles could not be loaded") }); }); return () => controller.abort(); }, [url, revision, attempt]); if (state.phase === "loading") return <p className="rp-muted" role="status">Loading restock tiles</p>; if (state.phase === "error") return <Failed message={state.message} onRetry={() => setAttempt((n) => n + 1)} />; return <KpiStrip label="Restock figures"> {state.value.map((tile) => <RestockKpi key={tile.id} {...tile} />)} </KpiStrip>; } /** S82-T26: the work tab lists every SKU in this module table. Band and Status are pill columns there. */ const RESTOCK_TABLE = "ut_amazon_restock"; const WORK_TAB = "skus"; const STATUSES = ["Open", "Accepted", "Ordered", "Sent to FBA", "Watching", "Done", "Dismissed"]; /** The server's page bound. A SKU lookup follows the cursor past it, so no SKU is out of reach (rule 1). */ const LOOKUP_PAGE = 200; const EMPTY_PLAN = "Nothing to restock"; /** Used only when an answer carries no thresholds; the server's settings win. */ const FALLBACK_THRESHOLDS: Thresholds = { sendToFbaDays: 30, overstockDays: 90 }; const text = (value: unknown) => (typeof value === "string" ? value : ""); const num = (value: unknown) => (typeof value === "number" && Number.isFinite(value) ? value : null); const list = (value: unknown) => (Array.isArray(value) ? value : []); const words = (value: unknown) => list(value).map(text).filter(Boolean); const pageButtonStyle = (disabled: boolean) => disabled ? { opacity: "var(--lp-home-disabled-opacity)", cursor: "not-allowed" } : undefined; async function readJson(response: Response, fallback: string): Promise<unknown> { const body: unknown = await response.json().catch(() => null); if (response.ok) return body; // The server sends a refusal as top-level {error}; a bare router sends it under {detail: {error}}. const shaped = body as { error?: { message?: unknown }; detail?: { error?: { message?: unknown } } } | null; throw new Error(text(shaped?.error?.message) || text(shaped?.detail?.error?.message) || fallback); } const failure = (reason: unknown, fallback: string) => (reason instanceof Error && reason.message ? reason.message : fallback); function parseItem(raw: unknown): Item | null { const row = (raw ?? {}) as Record<string, unknown>; const id = text(row.id); if (!id) return null; return { id, sku: text(row.sku), asin: text(row.asin), title: text(row.title) || text(row.sku), band: text(row.band), reason: text(row.reason), status: text(row.status), owner: text(row.owner), due: text(row.due), fbaAvailable: num(row.fbaAvailable), daysOfSupply: num(row.daysOfSupply), units30d: num(row.units30d), recommendedQty: num(row.recommendedQty), recommendedShipDate: text(row.recommendedShipDate), odooOnHand: num(row.odooOnHand), odooFba: num(row.odooFba), odooNote: text(row.odooNote), openPurchaseQty: num(row.openPurchaseQty), inReport: row.inReport !== false, label_owner: text(row.label_owner), prep_owner: text(row.prep_owner), amazonRecommendedQty: num(row.amazonRecommendedQty), odooNonFbaOnHand: num(row.odooNonFbaOnHand), sentQty: num(row.sentQty), inboundPlanId: text(row.inboundPlanId), sendToAmazonUrl: text(row.sendToAmazonUrl), inboundState: text(row.inboundState), inboundReason: text(row.inboundReason), cancelledPlanId: text(row.cancelledPlanId), cancelledBy: text(row.cancelledBy), cancelledAt: text(row.cancelledAt), }; } function parseThresholds(raw: unknown): Thresholds | null { const body = (raw ?? {}) as Record<string, unknown>; const send = num(body.sendToFbaDays); const over = num(body.overstockDays); return send !== null && over !== null && send > 0 && over > send ? { sendToFbaDays: send, overstockDays: over } : null; } function parseSettings(raw: unknown): RestockSettings { const body = (raw ?? {}) as Record<string, unknown>; const thresholds = parseThresholds(body); if (!thresholds || !["Seller", "Amazon"].includes(text(body.label_owner)) || !["Seller", "Amazon"].includes(text(body.prep_owner))) throw new Error("Restock settings could not be loaded."); const address = (body.ship_from ?? {}) as Record<string, unknown>; const capacity = body.fba_capacity as { value?: unknown; unit?: unknown } | null | undefined; if (capacity && (num(capacity.value) === null || !["cu ft", "cu m"].includes(text(capacity.unit)))) { throw new Error("FBA capacity needs a value and volume unit."); } return { ...thresholds, label_owner: body.label_owner as InboundOwner, prep_owner: body.prep_owner as InboundOwner, fba_capacity: capacity ? { value: Number(capacity.value), unit: text(capacity.unit) } : null, ship_from: { name: text(address.name), addressLine1: text(address.addressLine1), addressLine2: text(address.addressLine2), city: text(address.city), stateOrProvinceCode: text(address.stateOrProvinceCode), postalCode: text(address.postalCode), countryCode: text(address.countryCode), phoneNumber: text(address.phoneNumber) } }; } function parsePage(raw: unknown): ListPage { const body = (raw ?? {}) as Record<string, unknown>; const statuses = words(body.statuses); return { items: list(body.items).map(parseItem).filter((row): row is Item => row !== null), cursor: text(body.cursor) || null, ready: body.ready === true, message: text(body.message), previousCursor: text(body.previousCursor) || null, offset: num(body.offset) ?? 0, total: num(body.total) ?? 0, notices: words(body.notices), refreshedAt: text(body.refreshedAt), lastError: text(body.lastError), statuses: statuses.length ? statuses : STATUSES, owners: words(body.owners), thresholds: parseThresholds(body.thresholds), canEdit: body.canEdit === true, lowInventoryFee: body.lowInventoryFee ? body.lowInventoryFee as FeeCoverage : null, }; } function parseDetail(raw: unknown, fallback: Item): Detail { const body = (raw ?? {}) as Record<string, unknown>; const rawTotals = (body.detailTotals ?? {}) as Record<string, unknown>; const totals: Record<string, number> = {}; for (const field of ["warehouses", "openPurchaseOrders", "events", "points"]) totals[field] = num(rawTotals[field]) ?? 0; return { item: parseItem(body) ?? fallback, thresholds: parseThresholds(body.thresholds), offset: num(body.detailOffset) ?? 0, limit: num(body.detailLimit) ?? 50, total: num(body.detailTotal) ?? 0, totals, warehouses: list(body.warehouses).map((entry) => { const row = (entry ?? {}) as Record<string, unknown>; return { warehouse: text(row.warehouse), fba: row.fba === true, onHand: num(row.onHand) }; }), openPurchaseOrders: list(body.openPurchaseOrders).map((entry) => { const row = (entry ?? {}) as Record<string, unknown>; return { order: text(row.order), vendor: text(row.vendor), openQty: num(row.openQty), expected: text(row.expected) }; }), points: list(body.points).map((entry) => { const row = (entry ?? {}) as Record<string, unknown>; return { date: text(row.date), fbaAvailable: num(row.fbaAvailable), daysOfSupply: num(row.daysOfSupply), units30d: num(row.units30d), inbound: num(row.inbound), band: text(row.band) }; }), }; } /** A quantity with at most one decimal, or nothing when the source does not know it. */ const qty = (value: number | null) => (value === null ? "" : value.toLocaleString(undefined, { maximumFractionDigits: 1 })); /** "Oct 24" from an ISO day. A calendar day is read in UTC. */ function day(iso: string) { if (!iso) return ""; const date = new Date(iso.length === 10 ? iso + "T00:00:00Z" : iso); return Number.isNaN(date.getTime()) ? iso : date.toLocaleDateString(undefined, { month: "short", day: "numeric", timeZone: "UTC" }); } const statusTone = (status: string) => status.toLowerCase().replace(/[^a-z]+/g, "-"); type Zone = "critical" | "healthy" | "overstock"; /** The zone of a days of supply value, by the same rule the module bands with. */ function zoneOf(days: number, t: Thresholds): Zone { if (days < t.sendToFbaDays) return "critical"; if (days > t.overstockDays) return "overstock"; return "healthy"; } /** The meter's words: its aria-label and title. */ function meterWords(days: number, t: Thresholds): string { const zone = zoneOf(days, t); if (zone === "critical") return `${qty(days)} days of supply, under the ${qty(t.sendToFbaDays)} day Send to FBA threshold`; if (zone === "overstock") return `${qty(days)} days of supply, over the ${qty(t.overstockDays)} day Overstock threshold`; return `${qty(days)} days of supply, inside the ${qty(t.sendToFbaDays)} to ${qty(t.overstockDays)} day range`; } /** The three levels, named once, from the server's thresholds. */ function levelLabels(t: Thresholds): [Zone, string][] { return [["critical", `Under ${qty(t.sendToFbaDays)} days`], ["healthy", `${qty(t.sendToFbaDays)} to ${qty(t.overstockDays)} days`], ["overstock", `Over ${qty(t.overstockDays)} days`]]; } /** Piecewise position in percent: 0 to send fills 40, send to overstock the next 40, overstock to twice overstock 20. */ function meterPosition(days: number, t: Thresholds): number { const send = t.sendToFbaDays; const over = t.overstockDays; if (days <= 0) return 0; if (days <= send) return (days / send) * 40; if (days <= over) return 40 + ((days - send) / (over - send)) * 40; if (days <= over * 2) return 80 + ((days - over) / over) * 20; return 100; } /** A bar meter for days of supply over a track zoned at the server thresholds, with a tick at each threshold. */ function DaysMeter({ days, thresholds, size, labels = false }: { days: number | null; thresholds: Thresholds; size: "cell" | "wide" | "mini"; labels?: boolean; }) { if (days === null) return null; const at = (value: number) => `${meterPosition(value, thresholds)}%`; const sendAt = meterPosition(thresholds.sendToFbaDays, thresholds); const overAt = meterPosition(thresholds.overstockDays, thresholds); const zone = zoneOf(days, thresholds); const words = meterWords(days, thresholds); return <span className={`rp-meter is-${size} is-${zone}${days > thresholds.overstockDays * 2 ? " is-past" : ""}`} role="img" aria-label={words} title={words}> <span className="rp-meter-track"> <span className="rp-meter-zone is-critical" style={{ width: `${sendAt}%` }} /> <span className="rp-meter-zone is-healthy" style={{ width: `${overAt - sendAt}%` }} /> <span className="rp-meter-zone is-overstock" style={{ width: `${100 - overAt}%` }} /> <span className="rp-meter-bar" style={{ width: at(days) }} /> <span className="rp-meter-tick" style={{ left: at(thresholds.sendToFbaDays) }} /> <span className="rp-meter-tick" style={{ left: at(thresholds.overstockDays) }} /> </span> {labels && <span className="rp-meter-labels" aria-hidden="true"> <span style={{ left: at(thresholds.sendToFbaDays) }}>{qty(thresholds.sendToFbaDays)}</span> <span style={{ left: at(thresholds.overstockDays) }}>{qty(thresholds.overstockDays)}</span> </span>} </span>; } /** The number and its meter in one cell. A critical number reads red and heavier, so it stands out without colour. */ function DaysCell({ days, units, thresholds, size }: { days: number | null; units: number | null; thresholds: Thresholds; size: "cell" | "mini"; }) { if (days === null && units === 0) return <span className="rp-days"><span className="rp-days-none">No sales</span></span>; const zone = days === null ? "" : zoneOf(days, thresholds); return <span className="rp-days"> <DaysMeter days={days} thresholds={thresholds} size={size} /> <span className={zone === "critical" ? "rp-days-num is-critical" : "rp-days-num"}>{qty(days)}</span> </span>; } function Legend({ thresholds }: { thresholds: Thresholds }) { return <ul className="rp-legend" aria-label="Days of supply levels"> {levelLabels(thresholds).map(([zone, label]) => <li key={zone} className={`rp-legend-item is-${zone}`}> <span className="rp-legend-swatch" aria-hidden="true" />{label} </li>)} </ul>; } function Skeleton({ rows = 4 }: { rows?: number }) { return <div className="rp-skeleton-rows" aria-busy="true" aria-label="Loading"> {Array.from({ length: rows }, (_v, index) => <div key={index} className="rp-skeleton" />)} </div>; } function Failed({ message, onRetry }: { message: string; onRetry: () => void }) { return <p className="rp-error" role="alert">{message}{" "} <button type="button" className="rp-link" onClick={onRetry}>Retry</button></p>; } const ADDRESS_FIELDS: { key: keyof ShipFromAddress; label: string; wide?: boolean }[] = [ { key: "name", label: "Name", wide: true }, { key: "addressLine1", label: "Street address", wide: true }, { key: "addressLine2", label: "Address line 2", wide: true }, { key: "city", label: "City" }, { key: "stateOrProvinceCode", label: "State or province" }, { key: "postalCode", label: "Postal code" }, { key: "countryCode", label: "Country code" }, { key: "phoneNumber", label: "Phone", wide: true }, ]; function CapacityHeader({ url, revision }: { url: AppUrl; revision: unknown }) { const [state, setState] = useState<Load<CapacitySummary>>({ phase: "loading" }); const [retry, setRetry] = useState(0); useEffect(() => { const controller = new AbortController(); setState({ phase: "loading" }); void fetch(url("/capacity"), { credentials: CREDENTIALS, signal: controller.signal }) .then((response) => readJson(response, "FBA capacity could not be loaded.")) .then((body) => { if (!controller.signal.aborted) setState({ phase: "ready", value: body as CapacitySummary }); }) .catch((reason: unknown) => { if (!controller.signal.aborted) setState({ phase: "error", message: failure(reason, "FBA capacity could not be loaded.") }); }); return () => controller.abort(); }, [url, revision, retry]); if (state.phase === "loading") return <p className="rp-muted" role="status">Loading FBA capacity</p>; if (state.phase === "error") return <Failed message={state.message} onRetry={() => setRetry((value) => value + 1)} />; const value = state.value; const causes = new Map<string, CapacityCause>(); for (const group of [...value.storageCauses, ...value.plannedCauses]) { const skus = [...new Set([...(causes.get(group.cause)?.skus ?? []), ...group.skus])]; causes.set(group.cause, { cause: group.cause, count: skus.length, skus }); } const volume = (number: number | null) => number === null || !value.unit ? "Not known" : `${qty(number)} ${value.unit}`; return <section className="rp-bar" aria-label="FBA capacity"> <dl className="rp-settings-read"> <Fact label="Remaining FBA capacity" value={volume(value.remaining)} numeric /> <div className="rp-fact" title={value.quantityBasis}><dt>Planned Send to FBA</dt> <dd className="is-num">{volume(value.plannedVolume)}</dd></div> <Fact label="Capacity source" value="Typed" /> <Fact label="Current storage" value={volume(value.storageVolume)} numeric /> </dl> {value.capacityReason && <p className="rp-muted" role="status">{value.capacityReason}</p>} {causes.size > 0 && <div className="rp-notices"> {[...causes.values()].map(({ cause, count, skus }) => <div key={cause}> <p role="status">{count > 0 ? `${qty(count)} ${count === 1 ? "SKU has" : "SKUs have"} ${cause}` : cause}</p> {skus.length > 0 && <details> <summary>Show SKUs</summary> <ul aria-label={`SKUs with ${cause}`} tabIndex={0} style={{ maxHeight: "40vh", overflowY: "auto", overflowWrap: "anywhere" }}> {skus.map((sku) => <li key={sku}>{sku}</li>)} </ul> </details>} </div>)} <p>Enter carton size and CBM in Command Center Data Entry.</p> </div>} </section>; } function RestockSettingsFields({ value, editable, saving, onChange }: { value: RestockSettings; editable: boolean; saving: boolean; onChange: (value: RestockSettings) => void; }) { const [capacityUnit, setCapacityUnit] = useState(value.fba_capacity?.unit ?? "cu ft"); if (!editable) return <dl className="rp-settings-read"> <Fact label="Send to FBA days" value={qty(value.sendToFbaDays)} numeric /> <Fact label="Overstock days" value={qty(value.overstockDays)} numeric /> <Fact label="Label owner" value={value.label_owner} /> <Fact label="Prep owner" value={value.prep_owner} /> <Fact label="FBA capacity (Typed)" value={value.fba_capacity ? `${qty(value.fba_capacity.value)} ${value.fba_capacity.unit}` : "Enter FBA capacity in Restock settings"} /> <div className="rp-fact rp-ship-from-read"><dt>Ship from</dt> <dd>{Object.values(value.ship_from).some(Boolean) ? <address>{[value.ship_from.name, value.ship_from.addressLine1, value.ship_from.addressLine2, [value.ship_from.city, value.ship_from.stateOrProvinceCode, value.ship_from.postalCode].filter(Boolean).join(", "), value.ship_from.countryCode, value.ship_from.phoneNumber].filter(Boolean) .map((line, index) => <span key={index}>{line}</span>)}</address> : "No address"}</dd> </div> </dl>; return <fieldset className="rp-settings-fields" disabled={saving}> <div className="rp-settings-grid"> <label className="rp-field"><span className="rp-field-label">FBA capacity (Typed)</span> <input className="rp-input" aria-label="FBA capacity (Typed)" type="number" min="0" step="any" value={value.fba_capacity?.value ?? ""} onChange={(event) => onChange({ ...value, fba_capacity: event.target.value === "" ? null : { value: event.target.valueAsNumber, unit: value.fba_capacity?.unit ?? capacityUnit } })} /> </label> <label className="rp-field"><span className="rp-field-label">Capacity unit</span> <select className="rp-select" aria-label="Capacity unit" value={value.fba_capacity?.unit ?? capacityUnit} onChange={(event) => { setCapacityUnit(event.target.value); if (value.fba_capacity) onChange({ ...value, fba_capacity: { ...value.fba_capacity, unit: event.target.value } }); }}> <option value="cu ft">cu ft</option><option value="cu m">cu m</option> </select> </label> {(["sendToFbaDays", "overstockDays"] as const).map((field) => <label className="rp-field" key={field}> <span className="rp-field-label">{field === "sendToFbaDays" ? "Send to FBA days" : "Overstock days"}</span> <input className="rp-input" type="number" min="1" max="3650" step="any" required value={value[field]} onChange={(event) => onChange({ ...value, [field]: event.target.valueAsNumber })} /> </label>)} {(["label_owner", "prep_owner"] as const).map((field) => <label className="rp-field" key={field}> <span className="rp-field-label">{field === "label_owner" ? "Label owner" : "Prep owner"}</span> <select className="rp-select" value={value[field]} onChange={(event) => onChange({ ...value, [field]: event.target.value as InboundOwner })}> <option value="Seller">Seller</option><option value="Amazon">Amazon</option> </select> </label>)} </div> <fieldset className="rp-ship-from"> <legend className="rp-heading">Ship from</legend> <div className="rp-settings-grid"> {ADDRESS_FIELDS.map(({ key, label, wide }) => <label key={key} className={wide ? "rp-field rp-address-wide" : "rp-field"}> <span className="rp-field-label">{label}</span> <input className="rp-input" type={key === "phoneNumber" ? "tel" : "text"} value={value.ship_from[key]} maxLength={key === "countryCode" ? 2 : undefined} onChange={(event) => onChange({ ...value, ship_from: { ...value.ship_from, [key]: event.target.value } })} /> </label>)} </div> </fieldset> </fieldset>; } function RestockSettingsPanel({ url, editable, onSaved }: { url: AppUrl; editable: boolean; onSaved: (value: RestockSettings) => void; }) { const [loaded, setLoaded] = useState<Load<RestockSettings>>({ phase: "loading" }); const [draft, setDraft] = useState<RestockSettings | null>(null); const [editing, setEditing] = useState(false); const [saving, setSaving] = useState(false); const [message, setMessage] = useState(""); const [saveError, setSaveError] = useState(""); const [attempt, setAttempt] = useState(0); const saveRequest = useRef<AbortController | null>(null); useEffect(() => { const controller = new AbortController(); void fetch(url("/settings"), { credentials: CREDENTIALS, signal: controller.signal }) .then((response) => readJson(response, "Restock settings could not be loaded.")) .then((body) => { if (controller.signal.aborted) return; const value = parseSettings(body); setLoaded({ phase: "ready", value }); onSaved(value); }).catch((reason: unknown) => { if (!controller.signal.aborted) setLoaded({ phase: "error", message: failure(reason, "Restock settings could not be loaded.") }); }); return () => { controller.abort(); saveRequest.current?.abort(); }; }, [url, onSaved, attempt]); const save = async () => { if (!editable || !draft || saving) return; const controller = new AbortController(); saveRequest.current = controller; setSaving(true); setMessage(""); setSaveError(""); try { const response = await fetch(url("/settings"), { method: "PATCH", credentials: CREDENTIALS, signal: controller.signal, headers: { "Content-Type": "application/json" }, body: JSON.stringify(draft) }); const value = parseSettings(await readJson(response, "Restock settings were not saved.")); if (controller.signal.aborted) return; setLoaded({ phase: "ready", value }); setEditing(false); setDraft(null); setMessage("Settings saved"); onSaved(value); } catch (reason) { if (!controller.signal.aborted) setSaveError(failure(reason, "Restock settings were not saved.")); } finally { if (!controller.signal.aborted) setSaving(false); } }; return <details className="rp-settings"> <summary className="rp-heading">Settings</summary> <div className="rp-settings-body"> {loaded.phase === "loading" && <Skeleton rows={2} />} {loaded.phase === "error" && <Failed message={loaded.message} onRetry={() => { setLoaded({ phase: "loading" }); setAttempt((count) => count + 1); }} />} {loaded.phase === "ready" && <> {editable && editing && draft ? <form className="rp-settings-form" onSubmit={(event) => { event.preventDefault(); void save(); }}> <RestockSettingsFields value={draft} editable={editable} saving={saving} onChange={setDraft} /> <div className="rp-bar"> <button type="submit" className="rp-button is-primary" disabled={saving}>{saving ? "Saving" : "Save"}</button> <button type="button" className="rp-button is-quiet" disabled={saving} onClick={() => { setEditing(false); setDraft(null); setSaveError(""); }}>Cancel</button> </div> </form> : <RestockSettingsFields value={loaded.value} editable={false} saving={false} onChange={setDraft} />} {editable && !editing && <button type="button" className="rp-button" onClick={() => { setDraft(loaded.value); setEditing(true); setMessage(""); setSaveError(""); }}>Edit settings</button>} </>} {saveError && <p className="rp-error" role="alert">{saveError}</p>} {message && <p className="rp-muted" role="status">{message}</p>} </div> </details>; } function StatusPill({ status }: { status: string }) { return status ? <span className={`rp-pill is-${statusTone(status)}`}>{status}</span> : null; } function Fact({ label, value, numeric = false }: { label: string; value: string; numeric?: boolean }) { return <div className="rp-fact"> <dt>{label}</dt><dd className={numeric ? "is-num" : undefined}>{value || "Not known"}</dd> </div>; } interface Reorder { quantityUnit: string; dailySalesUnit: string; product: string; unitsPerSku: number | null; dailySales: { amazon: number | null; odoo: number | null; total: number | null }; leadTimeDays: number | null; purchaseOrderCount: number | null; coverDays: number | null; onHand: number | null; openOrders: number | null; suggestedQuantity: number | null; cause: string; fix: string; } function parseReorder(raw: unknown): Reorder { const body = (raw ?? {}) as Record<string, unknown>; const sales = (body.daily_sales ?? {}) as Record<string, unknown>; if (body.state !== "ready" && body.state !== "unavailable") throw new Error("Reorder could not be loaded."); const quantityUnit = text(body.quantity_unit); const dailySalesUnit = text(body.daily_sales_unit); if (body.state === "ready" && (!quantityUnit || !dailySalesUnit || num(body.suggested_quantity) === null)) { throw new Error("Reorder units or quantity are missing. Retry after syncing."); } return { quantityUnit, dailySalesUnit, product: text(body.odoo_product), unitsPerSku: num(body.units_per_sku), dailySales: { amazon: num(sales.amazon), odoo: num(sales.odoo), total: num(sales.total) }, leadTimeDays: num(body.lead_time_days), purchaseOrderCount: num(body.purchase_order_count), coverDays: num(body.cover_days), onHand: num(body.on_hand), openOrders: num(body.open_order_quantity), suggestedQuantity: body.state === "ready" ? num(body.suggested_quantity) : null, cause: text(body.cause), fix: text(body.fix) || text(body.message), }; } function SupplierReorder({ itemId, url }: { itemId: string; url: AppUrl }) { const [state, setState] = useState<Load<Reorder>>({ phase: "loading" }); const [coverDays, setCoverDays] = useState<string | null>(null); const [defaultCover, setDefaultCover] = useState(""); const [attempt, setAttempt] = useState(0); const validCover = coverDays === null || (coverDays.trim() !== "" && Number.isFinite(Number(coverDays)) && Number(coverDays) >= 0); useEffect(() => { const controller = new AbortController(); setState({ phase: "loading" }); if (!validCover) return () => controller.abort(); const params: Record<string, string> = coverDays === null ? {} : { cover_days: coverDays }; void fetch(url(`/items/${encodeURIComponent(itemId)}/reorder`, params), { credentials: CREDENTIALS, signal: controller.signal }) .then((response) => readJson(response, "Reorder could not be loaded.")) .then((body) => { if (controller.signal.aborted) return; const value = parseReorder(body); if (coverDays === null) setDefaultCover(value.coverDays === null ? "" : String(value.coverDays)); setState({ phase: "ready", value }); }).catch((reason: unknown) => { if (!controller.signal.aborted) setState({ phase: "error", message: failure(reason, "Reorder could not be loaded.") }); }); return () => controller.abort(); }, [itemId, url, coverDays, validCover, attempt]); const value = state.phase === "ready" ? state.value : null; const amount = (quantity: number | null) => quantity === null || !value?.quantityUnit ? "Not known" : `${qty(quantity)} ${value.quantityUnit}`; return <section className="rp-section rp-reorder" aria-label="Reorder from supplier"> <h3 className="rp-heading">Reorder from supplier</h3> <label className="rp-field rp-reorder-cover"> <span className="rp-field-label">Cover days</span> <input className="rp-input" type="number" min="0" step="any" required value={coverDays ?? defaultCover} aria-invalid={!validCover} onChange={(event) => setCoverDays(event.target.value)} /> </label> {!validCover ? <p className="rp-error" role="alert">Enter cover days at or above 0.</p> : state.phase === "loading" ? <Skeleton rows={2} /> : state.phase === "error" ? <Failed message={state.message} onRetry={() => setAttempt((count) => count + 1)} /> : value && <div className="rp-reorder-result" aria-live="polite"> {value.fix && <p className="rp-notice" role="status" title={value.cause}>{value.fix}</p>} {value.quantityUnit && <> <dl className="rp-facts"> <Fact label="Product" value={value.product} /> <Fact label="Per Amazon SKU" value={amount(value.unitsPerSku)} numeric /> </dl> <table className="rp-mini"> <caption>Daily sales ({value.dailySalesUnit || "Unit not known"})</caption> <thead><tr><th scope="col">Channel</th><th scope="col" className="is-num">Daily sales</th></tr></thead> <tbody>{([["Amazon", value.dailySales.amazon], ["Odoo", value.dailySales.odoo], ["Total", value.dailySales.total]] as const) .map(([channel, daily]) => <tr key={channel}><th scope="row">{channel}</th> <td className="is-num">{daily === null || !value.dailySalesUnit ? "Not known" : qty(daily)}</td></tr>)}</tbody> </table> <dl className="rp-facts"> <Fact label="Lead time" value={value.leadTimeDays === null ? "Not known" : `${qty(value.leadTimeDays)} days`} numeric /> <Fact label="Purchase orders" value={qty(value.purchaseOrderCount)} numeric /> <Fact label="On hand" value={amount(value.onHand)} numeric /> <Fact label="Open purchases" value={amount(value.openOrders)} numeric /> </dl> <p className="rp-reorder-suggestion"><span>Suggested quantity</span> <output aria-label="Suggested quantity">{amount(value.suggestedQuantity)}</output></p> </>} </div>} </section>; } function InboundPlan({ item, editable, busy, onCancel }: { item: Item; editable: boolean; busy: boolean; onCancel: () => void; }) { if (!item.inboundState && !item.inboundPlanId && !item.cancelledPlanId) return null; const cancelled = item.inboundState === "cancelled"; const title = cancelled ? "Plan cancelled" : item.inboundState === "sent" ? "Sent to FBA" : item.inboundState.startsWith("cancel_") ? "Cancellation unconfirmed" : item.inboundState === "held" ? "Held back" : (item.inboundState === "failed" || item.inboundState === "refused") ? "Plan refused" : "Plan unconfirmed"; return <section className="rp-section rp-inbound-plan" aria-label="Inbound plan"> <h3 className="rp-heading">{title}</h3> <dl className="rp-facts"> <Fact label="Plan" value={cancelled ? item.cancelledPlanId : item.inboundPlanId} /> <Fact label="Amazon quantity" value={qty(item.amazonRecommendedQty)} numeric /> <Fact label="Odoo on hand at send" value={qty(item.odooNonFbaOnHand)} numeric /> <Fact label="Sent quantity" value={qty(item.sentQty)} numeric /> {cancelled && <> <Fact label="Cancelled by" value={item.cancelledBy} /> <Fact label="Cancelled on" value={day(item.cancelledAt)} /> </>} </dl> {item.inboundReason && <p className="rp-notice" role="status">{item.inboundReason}</p>} {!cancelled && item.sendToAmazonUrl && <a className="rp-link" href={item.sendToAmazonUrl} target="_blank" rel="noopener noreferrer">Open in Send to Amazon</a>} {editable && !cancelled && item.inboundPlanId && <button type="button" className="rp-button" disabled={busy} onClick={onCancel}>Cancel plan</button>} </section>; } /** One SKU from the plan by its exact SKU. It follows every cursor, so a large plan never hides a SKU (rule 1). */ async function findItem(url: AppUrl, sku: string, signal: AbortSignal): Promise<Item | null> { const wanted = sku.trim(); const seen = new Set<string>(); let cursor: string | null = null; do { const params: Record<string, string> = { q: wanted, limit: String(LOOKUP_PAGE) }; if (cursor) params.cursor = cursor; const response = await fetch(url("/items", params), { credentials: CREDENTIALS, signal }); const page = parsePage(await readJson(response, "This SKU could not be loaded.")); const hit = page.items.find((item) => item.sku.trim() === wanted); if (hit) return hit; cursor = page.cursor && !seen.has(page.cursor) ? page.cursor : null; if (cursor) seen.add(cursor); } while (cursor); return null; } interface DetailProps { editable: boolean; owners: string[]; statuses: string[]; thresholds: Thresholds; inboundSettings: RestockSettings | null; url: AppUrl; onSaved: (item: Item) => void; onPlanSaved: (items: Item[]) => Promise<void>; } interface DrawerProps extends DetailProps { appId: string; sku: string; title: string; onClose: () => void } /** D-12058: the Restock drawer is the shared SkuActions drawer. Its body holds the reorder and inbound sections. */ function Drawer({ appId, sku, title, onClose, ...detail }: DrawerProps) { // Set while a plan cancellation is in flight, so Close and Escape keep the drawer open. const lock = useRef(false); const [found, setFound] = useState<Load<Item>>({ phase: "loading" }); const [attempt, setAttempt] = useState(0); const { url } = detail; useEffect(() => { const controller = new AbortController(); setFound({ phase: "loading" }); void findItem(url, sku, controller.signal) .then((item) => { if (!controller.signal.aborted) setFound(item ? { phase: "ready", value: item } : { phase: "error", message: "This SKU is not in the plan. Refresh the plan." }); }) .catch((reason: unknown) => { if (!controller.signal.aborted) setFound({ phase: "error", message: failure(reason, "This SKU could not be loaded.") }); }); return () => controller.abort(); }, [url, sku, attempt]); return <SkuActions appId={appId} appKind="restock_planner" grain="sku" entityKey={sku} title={found.phase === "ready" ? found.value.title : title} canEdit={detail.editable} canRead onClose={() => { if (!lock.current) onClose(); }}> {found.phase === "loading" && <Skeleton rows={3} />} {found.phase === "error" && <Failed message={found.message} onRetry={() => setAttempt((count) => count + 1)} />} {found.phase === "ready" && <SkuDetail key={found.value.id} row={found.value} lock={lock} {...detail} />} </SkuActions>; } function SkuDetail({ row, lock, editable, owners, statuses, thresholds: listThresholds, inboundSettings, url, onSaved, onPlanSaved }: DetailProps & { row: Item; lock: { current: boolean } }) { const [detail, setDetail] = useState<Load<Detail>>({ phase: "loading" }); const [attempt, setAttempt] = useState(0); const [offset, setOffset] = useState(0); const [saving, setSaving] = useState(false); const [saveError, setSaveError] = useState(""); const [confirmCancel, setConfirmCancel] = useState(false); const [cancelling, setCancelling] = useState(false); const [cancelMessage, setCancelMessage] = useState(""); const cancelRequest = lock; // The row object changes after a save. Only a different SKU reloads the detail. const latest = useRef(row); latest.current = row; useEffect(() => { const controller = new AbortController(); setDetail({ phase: "loading" }); void fetch(url(`/items/${encodeURIComponent(row.id)}`, { offset: String(offset) }), { credentials: CREDENTIALS, signal: controller.signal }) .then((response) => readJson(response, "This SKU could not be loaded.")) .then((body) => { if (controller.signal.aborted) return; const value = parseDetail(body, latest.current); setOffset(value.offset); setDetail({ phase: "ready", value }); }) .catch((reason: unknown) => { if (!controller.signal.aborted) setDetail({ phase: "error", message: failure(reason, "This SKU could not be loaded.") }); }); return () => controller.abort(); }, [url, row.id, attempt, offset]); /** Store one change, then show the value the server answered. */ const save = async (change: { owner?: string; status?: string; label_owner?: string; prep_owner?: string }) => { if (!editable || saving || cancelRequest.current || confirmCancel) return; setSaving(true); setSaveError(""); try { const response = await fetch(url(`/items/${encodeURIComponent(row.id)}`), { method: "PATCH", credentials: CREDENTIALS, headers: { "Content-Type": "application/json" }, body: JSON.stringify(change), }); const stored = parseItem(await readJson(response, "The change was not saved.")); if (!stored) throw new Error("The change was not saved."); onSaved(stored); setDetail((current) => current.phase !== "ready" ? current : { phase: "ready", value: { ...current.value, item: { ...current.value.item, ...stored } } }); } catch (reason) { setSaveError(failure(reason, "The change was not saved.")); } finally { setSaving(false); } }; const item = detail.phase === "ready" ? detail.value.item : row; const cancelPlan = async () => { if (!editable || !confirmCancel || !item.inboundPlanId || saving || cancelRequest.current) return; cancelRequest.current = true; setCancelling(true); setCancelMessage(""); try { const response = await fetch(url(`/items/${encodeURIComponent(item.id)}/cancel-plan`), { method: "POST", credentials: CREDENTIALS, }); const result = await readJson(response, "Cancellation is unconfirmed. Check Send to Amazon.") as { state?: string; message?: string; items?: unknown[]; } | null; const items = list(result?.items).map(parseItem).filter((entry): entry is Item => entry !== null); const stored = items.find((entry) => entry.id === item.id); if (!stored) throw new Error(text(result?.message) || "Cancellation is unconfirmed. Check Send to Amazon."); if (result?.state === "cancelled") { if (stored.inboundState !== "cancelled" || stored.status !== "Open" || !stored.cancelledPlanId || stored.inboundPlanId || stored.sendToAmazonUrl) throw new Error("Cancellation is unconfirmed. Reload this item."); } else if (stored.inboundState === "cancelled" || stored.inboundPlanId !== item.inboundPlanId || stored.sendToAmazonUrl !== item.sendToAmazonUrl || (item.status === "Sent to FBA" && stored.status !== "Sent to FBA")) { throw new Error("Cancellation is unconfirmed. Reload this item."); } setDetail((current) => current.phase !== "ready" ? current : { phase: "ready", value: { ...current.value, item: stored } }); setCancelMessage(text(result?.message) || (result?.state === "cancelled" ? "Amazon cancelled this plan." : "Cancellation is unconfirmed. Check Send to Amazon.")); await onPlanSaved(items); } catch (reason) { setCancelMessage(failure(reason, "Cancellation is unconfirmed. Check Send to Amazon.")); } finally { cancelRequest.current = false; setCancelling(false); setConfirmCancel(false); } }; const busy = saving || cancelling || confirmCancel; const thresholds = (detail.phase === "ready" ? detail.value.thresholds : null) ?? listThresholds; const ownerOptions = item.owner && !owners.includes(item.owner) ? [item.owner, ...owners] : owners; return <div className="rp-drawer" aria-label="Restock detail"> {item.asin && <span className="rp-drawer-sub">{item.asin}</span>} <p className="rp-reason">{item.reason}</p> <div className="rp-controls"> <label className="rp-field"> <span className="rp-field-label">Status</span> {editable ? <select className="rp-select" value={item.status} disabled={busy} onChange={(event) => void save({ status: event.target.value })}> {(statuses.includes(item.status) || !item.status ? statuses : [item.status, ...statuses]) .map((status) => <option key={status} value={status}>{status}</option>)} </select> : <StatusPill status={item.status} />} </label> <label className="rp-field"> <span className="rp-field-label">Owner</span> {editable ? <select className="rp-select" value={item.owner} disabled={busy} onChange={(event) => void save({ owner: event.target.value })}> {ownerOptions.map((owner) => <option key={owner} value={owner}>{owner}</option>)} </select> : <span className="rp-field-value">{item.owner || "Nobody"}</span>} </label> {(["label_owner", "prep_owner"] as const).map((field) => <label className="rp-field" key={field}> <span className="rp-field-label">{field === "label_owner" ? "Label owner" : "Prep owner"}</span> {editable ? <select className="rp-select" value={item[field]} disabled={busy} onChange={(event) => void save({ [field]: event.target.value })}> <option value="">{inboundSettings ? `Use setting (${inboundSettings[field]})` : "Use setting"}</option> <option value="Seller">Seller</option><option value="Amazon">Amazon</option> </select> : <span className="rp-field-value">{item[field] || inboundSettings?.[field] || "Not known"}</span>} </label>)} {saveError && <p className="rp-error" role="alert">{saveError}</p>} </div> <InboundPlan item={item} editable={editable} busy={busy || detail.phase !== "ready"} onCancel={() => setConfirmCancel(true)} /> {cancelMessage && cancelMessage !== item.inboundReason && <p className="rp-notice" role="status">{cancelMessage}</p>} {editable && <ConfirmDialog open={confirmCancel} title="Cancel plan" tone="destructive" body={<p>Cancel this plan for every SKU it contains? Items return to Open after Amazon confirms.</p>} confirmLabel={cancelling ? "Cancelling" : "Cancel plan"} cancelLabel="Keep plan" busy={cancelling} onConfirm={() => void cancelPlan()} onCancel={() => setConfirmCancel(false)} />} <dl className="rp-facts"> <Fact label="FBA available" value={qty(item.fbaAvailable)} numeric /> <div className="rp-fact rp-fact-meter"> <dt>Days of supply</dt> <dd className={item.daysOfSupply !== null && zoneOf(item.daysOfSupply, thresholds) === "critical" ? "is-num rp-days-num is-critical" : "is-num"}>{item.daysOfSupply === null ? "Not known" : qty(item.daysOfSupply)}</dd> {item.daysOfSupply !== null && <DaysMeter days={item.daysOfSupply} thresholds={thresholds} size="wide" labels />} <Legend thresholds={thresholds} /> </div> <Fact label="30-day units" value={qty(item.units30d)} numeric /> <Fact label="Recommended" value={qty(item.recommendedQty)} numeric /> <Fact label="Ship date" value={day(item.recommendedShipDate)} numeric /> <Fact label="Odoo on hand" value={qty(item.odooOnHand)} numeric /> <Fact label="Odoo in FBA" value={qty(item.odooFba)} numeric /> <Fact label="Open purchases" value={qty(item.openPurchaseQty)} numeric /> <Fact label="Due" value={day(item.due)} numeric /> </dl> {item.odooNote && <p className="rp-notice" role="status">{item.odooNote}</p>} {detail.phase === "loading" && <Skeleton rows={3} />} {detail.phase === "error" && <Failed message={detail.message} onRetry={() => setAttempt((count) => count + 1)} />} {detail.phase === "ready" && <> <SupplierReorder key={row.id} itemId={row.id} url={url} /> <section className="rp-section" aria-label="Warehouses"> <h3 className="rp-heading">Warehouses</h3> {detail.value.warehouses.length === 0 ? <p className="rp-muted">{detail.value.totals.warehouses ? "No warehouses on this page" : "No Odoo stock"}</p> : <table className="rp-mini"> <thead><tr><th scope="col">Warehouse</th><th scope="col" className="is-num">On hand</th></tr></thead> <tbody>{detail.value.warehouses.map((row) => <tr key={`${row.warehouse}:${row.fba}`}> <td>{row.warehouse}{row.fba && !/fba/i.test(row.warehouse) && <span className="rp-tag">FBA</span>}</td> <td className="is-num">{qty(row.onHand)}</td> </tr>)}</tbody> </table>} </section> <section className="rp-section" aria-label="Open purchase orders"> <h3 className="rp-heading">Open purchase orders</h3> {detail.value.openPurchaseOrders.length === 0 ? <p className="rp-muted">{detail.value.totals.openPurchaseOrders ? "No orders on this page" : "No open orders"}</p> : <table className="rp-mini"> <thead><tr><th scope="col">Order</th><th scope="col">Vendor</th> <th scope="col" className="is-num">Open</th><th scope="col" className="is-num">Expected</th></tr></thead> <tbody>{detail.value.openPurchaseOrders.map((row, index) => <tr key={`${row.order}:${index}`}> <td>{row.order}</td><td>{row.vendor}</td> <td className="is-num">{qty(row.openQty)}</td><td className="is-num">{day(row.expected)}</td> </tr>)}</tbody> </table>} </section> <section className="rp-section" aria-label="History"> <h3 className="rp-heading">History</h3> {detail.value.points.length === 0 ? <p className="rp-muted">{detail.value.totals.points ? "No history on this page" : "No history yet"}</p> : <table className="rp-mini rp-history"> <thead><tr><th scope="col">Day</th><th scope="col" className="is-num">FBA</th> <th scope="col" className="is-num rp-h-days">Days</th><th scope="col" className="is-num">30-day</th> <th scope="col" className="rp-h-band">Band</th></tr></thead> <tbody>{detail.value.points.map((point) => <tr key={point.date}> <td className="rp-nowrap">{day(point.date)}</td> <td className="is-num">{qty(point.fbaAvailable)}</td> <td className="is-num rp-h-days"> <DaysCell days={point.daysOfSupply} units={point.units30d} thresholds={thresholds} size="mini" /> </td> <td className="is-num">{qty(point.units30d)}</td> <td className="rp-h-band">{point.band}</td> </tr>)}</tbody> </table>} </section> </>} <nav className="rp-more rp-bar" aria-label="Detail pages"> <button type="button" className="rp-button" aria-disabled={detail.phase !== "ready" || offset === 0} style={pageButtonStyle(detail.phase !== "ready" || offset === 0)} onClick={() => { if (detail.phase === "ready" && offset > 0) setOffset(Math.max(0, offset - detail.value.limit)); }}>Previous</button> <span className="rp-muted" role="status">{detail.phase === "ready" ? `Page ${Math.floor(offset / detail.value.limit) + 1} of ${Math.max(1, Math.ceil(detail.value.total / detail.value.limit))}` : "Loading"}</span> <button type="button" className="rp-button" aria-disabled={detail.phase !== "ready" || offset + detail.value.limit >= detail.value.total} style={pageButtonStyle(detail.phase !== "ready" || offset + detail.value.limit >= detail.value.total)} onClick={() => { if (detail.phase === "ready" && offset + detail.value.limit < detail.value.total) setOffset(offset + detail.value.limit); }}>Next</button> </nav> </div>; } /** A Grid row as the host passes it: the module table's cells by field key. */ type GridRow = Record<string, unknown>; export default function RestockPlannerView({ application, canEdit }: RestockAppViewProps) { const appId = application.id; const kit = useDashboardKit(); const [tab, setTab] = useState(WORK_TAB); const url = useCallback((path: string, params: Record<string, string> = {}) => { const query = new URLSearchParams({ app: appId, ...params }); return `${API_V1}/app-kinds/restock_planner${path}?${query.toString()}`; }, [appId]); const [capacityRevision, setCapacityRevision] = useState(0); const [status, setStatus] = useState<Load<ListPage>>({ phase: "loading" }); const [attempt, setAttempt] = useState(0); const [serverThresholds, setServerThresholds] = useState<Thresholds | null>(null); const [inboundSettings, setInboundSettings] = useState<RestockSettings | null>(null); const settingsSaved = useCallback((value: RestockSettings) => { setInboundSettings(value); setCapacityRevision((revision) => revision + 1); setServerThresholds({ sendToFbaDays: value.sendToFbaDays, overstockDays: value.overstockDays }); }, []); const [refreshing, setRefreshing] = useState(false); const [refreshError, setRefreshError] = useState(""); const [opened, setOpened] = useState<{ sku: string; title: string } | null>(null); // A drawer save changes table cells. The Grid remounts on close so it reads them. const [gridRevision, setGridRevision] = useState(0); const changed = useRef(false); const alive = useRef(true); useEffect(() => { alive.current = true; return () => { alive.current = false; }; }, []); // D-12043: the Grid's Filter, Sort and Group replace the list query. This one read carries the refresh time, // notices, people and the edit grant, and adopts every Status set in the Grid before it answers. useEffect(() => { const controller = new AbortController(); void fetch(url("/items", { limit: "1" }), { credentials: CREDENTIALS, signal: controller.signal }) .then((response) => readJson(response, "The restock plan could not be loaded.")) .then((body) => { if (controller.signal.aborted) return; const value = parsePage(body); setStatus({ phase: "ready", value }); if (value.thresholds) setServerThresholds(value.thresholds); }) .catch((reason: unknown) => { if (!controller.signal.aborted) setStatus({ phase: "error", message: failure(reason, "The restock plan could not be loaded.") }); }); return () => controller.abort(); }, [url, attempt]); const screen = status.phase === "ready" ? status.value : null; const editable = canEdit === true && screen?.canEdit === true; const refresh = async () => { setRefreshing(true); setRefreshError(""); try { const response = await fetch(url("/refresh"), { method: "POST", credentials: CREDENTIALS }); const queued = await readJson(response, "The restock plan could not be refreshed.") as { requestId?: string }; const deadline = Date.now() + 120000; while (alive.current) { if (Date.now() >= deadline) throw new Error("The refresh is still running. Try again shortly."); await new Promise((resolve) => window.setTimeout(resolve, 1000)); if (!alive.current) return; const state = await readJson(await fetch(url("/refresh"), { credentials: CREDENTIALS }), "The refresh status could not be read.") as { state?: string; requestId?: string; message?: string; result?: { message?: string } }; if (state.requestId !== queued.requestId) throw new Error("Another refresh started. Reload the plan."); if (state.state === "failed") throw new Error(state.message || state.result?.message || "The restock plan could not be refreshed."); if (state.state === "done") { setAttempt((count) => count + 1); setCapacityRevision((revision) => revision + 1); setGridRevision((revision) => revision + 1); break; } } } catch (reason) { if (alive.current) setRefreshError(failure(reason, "The restock plan could not be refreshed.")); } finally { if (alive.current) setRefreshing(false); } }; const openRow = useCallback((row: GridRow) => { const sku = typeof row.sku === "number" ? String(row.sku) : text(row.sku).trim(); if (sku) setOpened({ sku, title: text(row.product) || sku }); }, []); const closeRow = useCallback(() => { setOpened(null); if (changed.current) { changed.current = false; setGridRevision((revision) => revision + 1); } }, []); const saved = useCallback((_item: Item) => { changed.current = true; setCapacityRevision((revision) => revision + 1); }, []); // A plan change moves sibling SKUs too, so the Grid reads them at once. const planSaved = useCallback(async (_items: Item[]) => { setCapacityRevision((revision) => revision + 1); setAttempt((count) => count + 1); setGridRevision((revision) => revision + 1); }, []); const pickTab = (next: string) => { setTab(next); setOpened(null); }; const statuses = screen?.statuses ?? STATUSES; const thresholds = serverThresholds ?? FALLBACK_THRESHOLDS; const tabs = [{ id: WORK_TAB, label: "SKUs", count: screen ? screen.total : null }, { id: "dashboard", label: "Dashboard" }]; return <div className="rp-app"> <div className="rp-scroll"> <CapacityHeader url={url} revision={capacityRevision} /> {kit ? <kit.AppTabs tabs={tabs} value={tab} onChange={pickTab} /> : <div className="rp-tabs" role="tablist" aria-label="Restock tabs"> {tabs.map((entry) => <button key={entry.id} type="button" role="tab" aria-selected={tab === entry.id} className={tab === entry.id ? "rp-tab is-active" : "rp-tab"} onClick={() => pickTab(entry.id)}> {entry.label}{entry.count != null && <span className="rp-count">{qty(entry.count)}</span>} </button>)} </div>} {tab === "dashboard" ? <div className="rp-body" role="tabpanel" aria-label="Dashboard"> <Dashboard key={appId} url={url} kit={kit} attempt={attempt + capacityRevision} /> <ActionCadence appId={appId} appKind="restock_planner" canRead /> </div> : <> <RestockSettingsPanel key={appId} url={url} editable={editable} onSaved={settingsSaved} /> <div className="rp-bar"> <div className="rp-bar-end"> {screen?.refreshedAt && <span className="rp-muted rp-nowrap">Updated {day(screen.refreshedAt)}</span>} {editable && screen?.ready && <button type="button" className="rp-button" disabled={refreshing} onClick={() => void refresh()}>{refreshing ? "Refreshing" : "Refresh"}</button>} </div> </div> <div className="rp-body rp-grid-body" role="tabpanel" aria-label="SKUs"> <RestockTiles url={url} revision={capacityRevision} /> {refreshError && <p className="rp-error" role="alert">{refreshError}</p>} {screen?.lastError && <p className="rp-error" role="alert">{screen.lastError}</p>} {screen && screen.notices.length > 0 && <ul className="rp-notices" role="status"> {screen.notices.map((notice) => <li key={notice}>{notice}</li>)} </ul>} {status.phase === "loading" && <Skeleton />} {status.phase === "error" && <Failed message={status.message} onRetry={() => setAttempt((count) => count + 1)} />} {screen && !screen.ready && screen.total === 0 ? <div className="rp-waiting" role="status"> <p className="rp-empty">{screen.message}</p> {editable && <button type="button" className="rp-button is-primary" disabled={refreshing} onClick={() => void refresh()}>{refreshing ? "Refreshing" : "Refresh"}</button>} </div> : screen && <div className="rp-grid"> <AppGrid key={gridRevision} table={RESTOCK_TABLE} onOpenRow={openRow} empty={<p className="rp-empty" role="status">{EMPTY_PLAN}</p>} /> </div>} </div> </>} </div> {opened && <Drawer key={opened.sku} appId={appId} sku={opened.sku} title={opened.title} editable={editable} owners={screen?.owners ?? []} statuses={statuses} thresholds={thresholds} inboundSettings={inboundSettings} url={url} onSaved={saved} onPlanSaved={planSaved} onClose={closeRow} />} </div>; }
import { useCallback, useEffect, useRef, useState, type ComponentType } from "react";
import { Dashboard } from "./Dashboard";
import type { DashboardKit } from "./Dashboard";
import { API_V1, CREDENTIALS } from "../../apiContract";
import { ConfirmDialog } from "../../ui/ConfirmDialog";
import { AppGrid } from "../AppGrid";
import { ActionCadence } from "../actions/ActionCadence";
import { SkuActions } from "../actions/SkuActions";
import { Kpi, KpiStrip } from "../../viz/kit/Kpi";
import type { KpiProps } from "../../viz/kit/Kpi";
import "../../styles/sdlc79/restock-planner.css";
import "../../styles/sdlc81/restock-loop.css";
import "../../styles/sdlc81/restock-reorder.css";
import "../../styles/sdlc82/restock-grid.css";
// The App frame owns navigation. This view shares Dashboard, the SKU Grid and the SKU drawer.
/** C2: the App as the dispatcher passes it. Structurally equal to lane A's TemplateApplication. */
interface RestockApplication {
id: string;
name: string;
templateKind?: string;
templateView?: string;
templateMark?: string;
templateConnector?: string;
capabilities?: Record<string, boolean>;
}
interface RestockAppViewProps { application: RestockApplication; canEdit: boolean }
// C6 fixture compilers replace this glob with injected module loaders, never substitute the inbound UI kit.
const dashboardModules = import.meta.glob("../App{Tabs,Dashboard}.tsx");
function useDashboardKit() {
const [kit, setKit] = useState<DashboardKit | null | undefined>(undefined);
useEffect(() => {
let alive = true;
const tabs = dashboardModules["../AppTabs.tsx"];
const dashboard = dashboardModules["../AppDashboard.tsx"];
if (!tabs || !dashboard) { setKit(null); return; }
void Promise.all([tabs(), dashboard()]).then(([tabModule, dashboardModule]) => {
const t = tabModule as { AppTabs?: DashboardKit["AppTabs"]; default?: DashboardKit["AppTabs"] };
const d = dashboardModule as { AppDashboard?: DashboardKit["AppDashboard"]; default?: DashboardKit["AppDashboard"] };
const AppTabs = t.AppTabs ?? t.default;
const AppDashboard = d.AppDashboard ?? d.default;
if (alive) setKit(AppTabs && AppDashboard ? { AppTabs, AppDashboard } : null);
}).catch(() => { if (alive) setKit(null); });
return () => { alive = false; };
}, []);
return kit;
}
interface Item {
id: string;
sku: string;
asin: string;
title: string;
band: string;
reason: string;
status: string;
owner: string;
due: string;
fbaAvailable: number | null;
daysOfSupply: number | null;
units30d: number | null;
recommendedQty: number | null;
recommendedShipDate: string;
odooOnHand: number | null;
odooFba: number | null;
odooNote: string;
openPurchaseQty: number | null;
inReport: boolean;
label_owner: string;
prep_owner: string;
amazonRecommendedQty: number | null;
odooNonFbaOnHand: number | null;
sentQty: number | null;
inboundPlanId: string;
sendToAmazonUrl: string;
inboundState: string;
inboundReason: string;
cancelledPlanId: string;
cancelledBy: string;
cancelledAt: string;
}
interface Warehouse { warehouse: string; fba: boolean; onHand: number | null }
interface PurchaseOrder { order: string; vendor: string; openQty: number | null; expected: string }
interface Point {
date: string; fbaAvailable: number | null; daysOfSupply: number | null; units30d: number | null;
inbound: number | null; band: string;
}
/** The two band thresholds in days of supply, from the App settings (R49). */
interface Thresholds { sendToFbaDays: number; overstockDays: number }
type InboundOwner = "Seller" | "Amazon";
interface ShipFromAddress {
name: string; addressLine1: string; addressLine2: string; city: string;
stateOrProvinceCode: string; postalCode: string; countryCode: string; phoneNumber: string;
}
interface RestockSettings extends Thresholds {