@endora-commerce/mod-quick-order 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
+
+# @endora-commerce/mod-quick-order
+
+Bulk Cart / Quote Request import (CSV + Excel, with variants), quick product search, reorder, default ordering preferences, and one-click buy.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `quick_order` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-quick-order` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-quick-order/admin` | the Admin UI contribution: the screens, navigation and palette actions it adds |
+| `@endora-commerce/mod-quick-order/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-quick-order/migrations` | the module’s own schema migrations, in the order the platform runs them |
+| `@endora-commerce/mod-quick-order/tailwind.css` | the Tailwind source declaration for the admin code above |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/admin-kit` — *optional*
+- `@endora-commerce/contracts`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `exceljs` ^4
+- `fastify` ^5
+- `react` ^19 — *optional*
+- `zod` ^4
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `i18n/` — the translation bundles this package ships (`en`, `pl`), loaded by the platform
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+- `tailwind.css` — the Tailwind source declaration
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-quick-order
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/admin/api/quick-order-client.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Admin quick-order bindings (feature 039). Wraps the `/api/v1/admin/quick-order`
+ * endpoints; the operator acts on behalf of a customer + organization.
+ */
+export type QuickOrderRejectionReason = 'sku_missing' | 'quantity_invalid' | 'product_not_found' | 'product_archived' | 'malformed_row' | 'variant_not_resolved' | 'variant_ambiguous' | 'row_limit_exceeded';
+export interface RecognizedQuickOrderItem {
+    line: number;
+    sku: string;
+    productId: string;
+    variantId: string | null;
+    resolvedVariantSku?: string | null;
+    quantity: number;
+    mergedFromLines?: number[];
+}
+export interface RejectedQuickOrderItem {
+    line: number;
+    raw: string;
+    reason: QuickOrderRejectionReason;
+}
+export interface QuickOrderImportResponse {
+    recognized: RecognizedQuickOrderItem[];
+    rejected: RejectedQuickOrderItem[];
+    summary: {
+        recognizedCount: number;
+        rejectedCount: number;
+        mergedCount: number;
+        truncated: boolean;
+    };
+}
+export type QuickOrderTarget = 'cart' | 'quote_request';
+export interface QuickOrderBuildResponse {
+    target: QuickOrderTarget;
+    cartId?: string;
+    checkoutUrl?: string;
+    quoteRequestId?: string;
+}
+export interface OnBehalfOf {
+    customerAccountId: string;
+    organizationId: string;
+}
+export declare function adminQuickOrderImport(input: {
+    csv?: string;
+    file?: {
+        filename: string;
+        contentBase64: string;
+    };
+}): Promise<QuickOrderImportResponse>;
+export declare function adminQuickOrderBuild(input: {
+    target: QuickOrderTarget;
+    items: Array<{
+        productId: string;
+        variantId?: string | null;
+        quantity: number;
+    }>;
+    onBehalfOf: OnBehalfOf;
+}): Promise<QuickOrderBuildResponse>;
+export type PreferenceScope = 'organization' | 'customer';
+export interface QuickOrderPreference {
+    scope: PreferenceScope;
+    scopeId: string;
+    defaultPaymentMethodId: string | null;
+    defaultDeliveryMethodId: string | null;
+    defaultBillingAddressId: string | null;
+    defaultShippingAddressId: string | null;
+}
+export interface QuickOrderPreferenceUpsert {
+    scope: PreferenceScope;
+    scopeId: string;
+    defaultPaymentMethodId?: string | null;
+    defaultDeliveryMethodId?: string | null;
+    defaultBillingAddressId?: string | null;
+    defaultShippingAddressId?: string | null;
+}
+export declare function adminGetPreference(scope: PreferenceScope, scopeId: string): Promise<QuickOrderPreference | null>;
+export declare function adminUpsertPreference(body: QuickOrderPreferenceUpsert): Promise<QuickOrderPreference>;
+//# sourceMappingURL=quick-order-client.d.ts.map

package/dist/admin/api/quick-order-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-order-client.d.ts","sourceRoot":"","sources":["../../../src/admin/api/quick-order-client.ts"],"names":[],"mappings":"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"}

package/dist/admin/api/quick-order-client.js

@@ -0,0 +1,18 @@
+import { apiClient } from '@endora-commerce/admin-kit/lib';
+export async function adminQuickOrderImport(input) {
+    const res = await apiClient.post('/api/v1/admin/quick-order/import', input);
+    return res.data;
+}
+export async function adminQuickOrderBuild(input) {
+    const res = await apiClient.post('/api/v1/admin/quick-order/build', input);
+    return res.data;
+}
+export async function adminGetPreference(scope, scopeId) {
+    const res = await apiClient.get(`/api/v1/admin/quick-order/preferences?scope=${scope}&scopeId=${encodeURIComponent(scopeId)}`);
+    return res.data;
+}
+export async function adminUpsertPreference(body) {
+    const res = await apiClient.put('/api/v1/admin/quick-order/preferences', body);
+    return res.data;
+}
+//# sourceMappingURL=quick-order-client.js.map

package/dist/admin/api/quick-order-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-order-client.js","sourceRoot":"","sources":["../../../src/admin/api/quick-order-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAwD3D,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAG3C;IACC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,IAAI,CAC9B,kCAAkC,EAClC,KAAK,CACN,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAI1C;IACC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,IAAI,CAC9B,iCAAiC,EACjC,KAAK,CACN,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC;AAsBD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAsB,EACtB,OAAe;IAEf,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,CAC7B,+CAA+C,KAAK,YAAY,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAC9F,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAgC;IAEhC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,CAC7B,uCAAuC,EACvC,IAAI,CACL,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC"}

package/dist/admin/components/DefaultPreferencesPanel.d.ts

@@ -0,0 +1,44 @@
+import { type ReactNode } from 'react';
+/**
+ * DefaultPreferencesPanel — feature 039 (US2 / FR-018).
+ *
+ * Embedded editor for an organization's or customer's default ordering
+ * preferences (payment / delivery method + billing / shipping address). It is
+ * mounted on the Customer and Organization edit pages so the configuration
+ * lives next to the entity it belongs to — the standalone admin page was
+ * removed in favour of this panel.
+ *
+ * Scope + scopeId are fixed by the host page; the four values are picked from
+ * dropdowns populated with the real methods / addresses available for that
+ * scope. For the customer scope an empty value means "inherit the
+ * organization default"; for the organization scope it means "no default".
+ *
+ * ## Why the calls are rebuilt rather than the client moved (feature 091, P7b)
+ *
+ * The file used to live at `admin/src/modules/quick_order/`, imported by path
+ * from `organizations`' and `customers`' detail screens — the two
+ * `DefaultPreferencesPanel` keys of the boundary ledger, one in each shard. It
+ * is this module's panel, so it lives in this module's package and reaches both
+ * screens as `organization.detail.after` and `customer.detail.after`
+ * contributions instead.
+ *
+ * `admin/src/modules/quick_order/api/quick-order-client.ts` did **not** travel
+ * with it: `QuickOrderOnBehalfPage` still imports that file, and moving it here
+ * would leave a package reaching back into the admin application. Its two
+ * preference bindings are HTTP paths over a payload this file already declares,
+ * so they are rebuilt from the published `apiClient` (P2's exit) — twelve lines
+ * against a reach.
+ *
+ * The copy stays in the `core` namespace rather than moving to this module's
+ * own, on P7a's reading of `contracts/admin-component-contribution.md` §9.2:
+ * that population is 62 files wide and no P7 row is the merge request that
+ * answers it.
+ */
+/** Which entity the defaults belong to. */
+export type PreferenceScope = 'organization' | 'customer';
+export interface DefaultPreferencesPanelProps {
+    scope: PreferenceScope;
+    scopeId: string;
+}
+export declare function DefaultPreferencesPanel(props: DefaultPreferencesPanelProps): ReactNode;
+//# sourceMappingURL=DefaultPreferencesPanel.d.ts.map

package/dist/admin/components/DefaultPreferencesPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultPreferencesPanel.d.ts","sourceRoot":"","sources":["../../../src/admin/components/DefaultPreferencesPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAezE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,UAAU,CAAC;AAoD1D,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,SAAS,CA+JtF"}

package/dist/admin/components/DefaultPreferencesPanel.js

@@ -0,0 +1,107 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from 'react';
+import { ApiError, apiClient } from '@endora-commerce/admin-kit/lib';
+import { Alert, AlertDescription, Button, Card, CardContent, CardHeader, CardTitle, Label, Select, } from '@endora-commerce/admin-kit/ui';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+async function readPreference(scope, scopeId) {
+    const res = await apiClient.get(`/api/v1/admin/quick-order/preferences?scope=${scope}&scopeId=${encodeURIComponent(scopeId)}`);
+    return res.data;
+}
+async function writePreference(body) {
+    await apiClient.put('/api/v1/admin/quick-order/preferences', body);
+}
+function pickLabel(name, fallback) {
+    if (!name)
+        return fallback;
+    return name['en'] ?? name['pl'] ?? Object.values(name)[0] ?? fallback;
+}
+function addressLabel(a) {
+    return `${a.recipientName} — ${a.street}, ${a.postalCode} ${a.city}`;
+}
+export function DefaultPreferencesPanel(props) {
+    const { scope, scopeId } = props;
+    const t = useTranslation('core');
+    const [paymentMethods, setPaymentMethods] = useState([]);
+    const [deliveryMethods, setDeliveryMethods] = useState([]);
+    const [addresses, setAddresses] = useState([]);
+    const [payment, setPayment] = useState('');
+    const [delivery, setDelivery] = useState('');
+    const [billing, setBilling] = useState('');
+    const [shipping, setShipping] = useState('');
+    const [loading, setLoading] = useState(true);
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    const [info, setInfo] = useState(null);
+    const loadAll = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        setInfo(null);
+        try {
+            const addressesReq = scope === 'customer'
+                ? apiClient
+                    .get(`/api/v1/admin/customers/${scopeId}/addresses`)
+                    .then((res) => [...res.data.personal, ...res.data.organization])
+                : apiClient
+                    .get(`/api/v1/admin/organizations/${scopeId}/addresses`)
+                    .then((res) => res.data);
+            const [pms, dms, addrRows, current] = await Promise.all([
+                apiClient.get('/api/v1/admin/payment-methods?pageSize=200'),
+                apiClient.get('/api/v1/admin/delivery-methods?pageSize=200'),
+                addressesReq,
+                readPreference(scope, scopeId),
+            ]);
+            setPaymentMethods((pms.data ?? []).map((m) => ({ id: m.id, label: pickLabel(m.name, m.code) })));
+            setDeliveryMethods((dms.data ?? []).map((m) => ({ id: m.id, label: pickLabel(m.name, m.code) })));
+            setAddresses((addrRows ?? []).map((a) => ({ id: a.id, kind: a.kind, label: addressLabel(a) })));
+            setPayment(current?.defaultPaymentMethodId ?? '');
+            setDelivery(current?.defaultDeliveryMethodId ?? '');
+            setBilling(current?.defaultBillingAddressId ?? '');
+            setShipping(current?.defaultShippingAddressId ?? '');
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : t('defaultPreferences.loadError'));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [scope, scopeId, t]);
+    useEffect(() => {
+        void loadAll();
+    }, [loadAll]);
+    const save = useCallback(async () => {
+        if (busy)
+            return;
+        setBusy(true);
+        setError(null);
+        setInfo(null);
+        try {
+            await writePreference({
+                scope,
+                scopeId,
+                defaultPaymentMethodId: payment || null,
+                defaultDeliveryMethodId: delivery || null,
+                defaultBillingAddressId: billing || null,
+                defaultShippingAddressId: shipping || null,
+            });
+            setInfo(t('defaultPreferences.saved'));
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : t('defaultPreferences.saveError'));
+        }
+        finally {
+            setBusy(false);
+        }
+    }, [busy, scope, scopeId, payment, delivery, billing, shipping, t]);
+    const emptyLabel = scope === 'customer' ? t('defaultPreferences.inherit') : t('defaultPreferences.none');
+    const billingAddresses = addresses.filter((a) => a.kind === 'billing');
+    const shippingAddresses = addresses.filter((a) => a.kind === 'delivery');
+    return (_jsxs(Card, { className: "mb-4", children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: t('defaultPreferences.title') }) }), _jsxs(CardContent, { className: "space-y-4", children: [_jsx("p", { className: "text-xs text-muted-foreground", children: t('defaultPreferences.description') }), error ? (_jsx(Alert, { variant: "destructive", children: _jsx(AlertDescription, { children: error }) })) : null, info ? (_jsx(Alert, { variant: "success", children: _jsx(AlertDescription, { children: info }) })) : null, loading ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('common.state.loading') })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "grid gap-4 md:grid-cols-2", children: [_jsx(PrefSelect, { id: "pref-payment", label: t('defaultPreferences.paymentMethod'), emptyLabel: emptyLabel, value: payment, options: paymentMethods, onChange: setPayment }), _jsx(PrefSelect, { id: "pref-delivery", label: t('defaultPreferences.deliveryMethod'), emptyLabel: emptyLabel, value: delivery, options: deliveryMethods, onChange: setDelivery }), _jsx(PrefSelect, { id: "pref-billing", label: t('defaultPreferences.billingAddress'), emptyLabel: emptyLabel, value: billing, options: billingAddresses, onChange: setBilling }), _jsx(PrefSelect, { id: "pref-shipping", label: t('defaultPreferences.shippingAddress'), emptyLabel: emptyLabel, value: shipping, options: shippingAddresses, onChange: setShipping })] }), _jsx("div", { className: "flex justify-end", children: _jsx(Button, { onClick: () => void save(), disabled: busy, children: t('defaultPreferences.save') }) })] }))] })] }));
+}
+function PrefSelect(props) {
+    // Keep the stored value selectable even when it is no longer in the
+    // available list (e.g. an address that was since deleted, or a method the
+    // caller cannot see) so saving does not silently drop it.
+    const known = props.options.some((o) => o.id === props.value);
+    return (_jsxs("div", { className: "space-y-2", children: [_jsx(Label, { htmlFor: props.id, children: props.label }), _jsxs(Select, { id: props.id, value: props.value, onChange: (e) => props.onChange(e.target.value), children: [_jsx("option", { value: "", children: props.emptyLabel }), props.options.map((o) => (_jsx("option", { value: o.id, children: o.label }, o.id))), props.value && !known ? _jsx("option", { value: props.value, children: props.value }) : null] })] }));
+}
+//# sourceMappingURL=DefaultPreferencesPanel.js.map

package/dist/admin/components/DefaultPreferencesPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultPreferencesPanel.js","sourceRoot":"","sources":["../../../src/admin/components/DefaultPreferencesPanel.tsx"],"names":[],"mappings":"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"}

package/dist/admin/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `quick_order`'s admin surface — one route, no sidebar entry and three zone
+ * contributions (feature 091, P7b and P4d for the zones, Phase 4 batch 13 for
+ * the route;
+ * `specs/091-module-owned-admin-surfaces/contracts/admin-component-contribution.md`
+ * §10).
+ *
+ * **No sidebar entry, and it is not an omission.** `AppShell.tsx`'s own
+ * comment records why, in the *Sales* section this module never had a row in:
+ * quick order *"is not a second destination — it is the other way of getting
+ * lines into the same order, so it lives behind a tab on the order-entry page
+ * rather than on its own sidebar row"*. That tab is the
+ * `order.entry.tabs` contribution below, which P4d declared. So this module's
+ * `{ routes: 1, nav: 0 }` entry leaves the ratchet like any other: a zero that
+ * stays zero is a passing assertion, not a missing one, and `plan.md`'s Ruling
+ * 1 puts the off-state proof on the **route**, which is what an operator
+ * following a stale deep link meets.
+ *
+ * **The zones came first, and that is the property the batch rests on.** P7b
+ * and P4d declared the three contributions below while this screen was still
+ * `admin/src/App.tsx`'s, because `check:admin-registrations` counts routes and
+ * nav entries and a zone is neither.
+ *
+ * **What it drains**: both `DefaultPreferencesPanel` keys of the boundary
+ * ledger — the whole of
+ * `backend/scripts/ledgers/cross-module-imports/customers.ts`, which is
+ * deleted, and one of the three in `organizations.ts`. Each entry's recorded
+ * retiring condition is *"the owner declaring an admin contribution zone"*, and
+ * this is that declaration.
+ *
+ * **And, with P4d, one of the last two keys of
+ * `backend/scripts/ledgers/admin-surface.ts`**:
+ * `admin/src/modules/quick_order/QuickOrderOnBehalfPage.tsx` importing
+ * `OrderEntryTabs` out of `admin/src/components/`. `orders` drains the other
+ * with the twin tab, and with the pair gone that ledger is empty.
+ *
+ * **Zone and not a published component**, decided from the signature read off
+ * the file in this merge request (§9.3): `({ scope, scopeId })` — two
+ * identifiers in, nothing back, no `value`/`onChange` pair, and the panel owns
+ * its own `PUT`. That is Z1 question 2, an addition this module makes because
+ * this module is installed.
+ *
+ * **This entry exports data and nothing else** (R2); every component is a
+ * dynamic-import factory (R6).
+ */
+import { type AdminContributions } from '@endora-commerce/admin-kit/contributions';
+export declare const contributions: AdminContributions;
+//# sourceMappingURL=index.d.ts.map

package/dist/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,0CAA0C,CAAC;AAiClD,eAAO,MAAM,aAAa,EAAE,kBA2C3B,CAAC"}

package/dist/admin/index.js

@@ -0,0 +1,120 @@
+/**
+ * `quick_order`'s admin surface — one route, no sidebar entry and three zone
+ * contributions (feature 091, P7b and P4d for the zones, Phase 4 batch 13 for
+ * the route;
+ * `specs/091-module-owned-admin-surfaces/contracts/admin-component-contribution.md`
+ * §10).
+ *
+ * **No sidebar entry, and it is not an omission.** `AppShell.tsx`'s own
+ * comment records why, in the *Sales* section this module never had a row in:
+ * quick order *"is not a second destination — it is the other way of getting
+ * lines into the same order, so it lives behind a tab on the order-entry page
+ * rather than on its own sidebar row"*. That tab is the
+ * `order.entry.tabs` contribution below, which P4d declared. So this module's
+ * `{ routes: 1, nav: 0 }` entry leaves the ratchet like any other: a zero that
+ * stays zero is a passing assertion, not a missing one, and `plan.md`'s Ruling
+ * 1 puts the off-state proof on the **route**, which is what an operator
+ * following a stale deep link meets.
+ *
+ * **The zones came first, and that is the property the batch rests on.** P7b
+ * and P4d declared the three contributions below while this screen was still
+ * `admin/src/App.tsx`'s, because `check:admin-registrations` counts routes and
+ * nav entries and a zone is neither.
+ *
+ * **What it drains**: both `DefaultPreferencesPanel` keys of the boundary
+ * ledger — the whole of
+ * `backend/scripts/ledgers/cross-module-imports/customers.ts`, which is
+ * deleted, and one of the three in `organizations.ts`. Each entry's recorded
+ * retiring condition is *"the owner declaring an admin contribution zone"*, and
+ * this is that declaration.
+ *
+ * **And, with P4d, one of the last two keys of
+ * `backend/scripts/ledgers/admin-surface.ts`**:
+ * `admin/src/modules/quick_order/QuickOrderOnBehalfPage.tsx` importing
+ * `OrderEntryTabs` out of `admin/src/components/`. `orders` drains the other
+ * with the twin tab, and with the pair gone that ledger is empty.
+ *
+ * **Zone and not a published component**, decided from the signature read off
+ * the file in this merge request (§9.3): `({ scope, scopeId })` — two
+ * identifiers in, nothing back, no `value`/`onChange` pair, and the panel owns
+ * its own `PUT`. That is Z1 question 2, an addition this module makes because
+ * this module is installed.
+ *
+ * **This entry exports data and nothing else** (R2); every component is a
+ * dynamic-import factory (R6).
+ */
+import { zoneComponent, } from '@endora-commerce/admin-kit/contributions';
+/**
+ * The code that opens both contributed surfaces — and it is **not**
+ * `quick_order:read`, which §10.6 named and which exists nowhere.
+ *
+ * Read off the routes in this merge request, as §10.6's own instruction for the
+ * sibling row requires: `packages/modules/quick_order/src/backend/routes.preferences.admin.ts`
+ * gates `GET` and `PUT /api/v1/admin/quick-order/preferences` with
+ * `requireAdmin('orders:write')`, and every other admin route this module owns
+ * takes the same code — the manifest's own palette action says so in place.
+ * There is no `quick_order:*` permission in the platform at all, so declaring
+ * one would not merely advertise a 403: no role could ever hold it, and the
+ * panel would be invisible to every operator including the one who can use it.
+ *
+ * It is a **write** code for a surface that also reads, which is honest here
+ * rather than a compromise: the panel is an editor, its `GET` is gated on the
+ * same code as its `PUT`, and an operator holding `orders:write` can do both.
+ */
+const PREFERENCES_PERMISSION = 'orders:write';
+/**
+ * The module's only route: placing an order on a customer's behalf.
+ *
+ * It sits under `/orders/` rather than at a path of its own, which is the
+ * placement the host table had and this declaration keeps: `orders` declares
+ * `/orders`, `/orders/new`, `/orders/statuses` and `/orders/:id`, and
+ * `<Routes>` ranks by specificity, so the static `quick-order` segment wins
+ * over `orders`' parametric detail route whatever order the registry composes
+ * them in.
+ */
+const ROUTE_PATH = '/orders/quick-order';
+export const contributions = {
+    routes: [
+        {
+            path: ROUTE_PATH,
+            component: () => import('./pages/QuickOrderOnBehalfPage.js'),
+            // The same `orders:write` the zones declare, and for the same reason
+            // read off the routes rather than guessed: the two `POST`s behind this
+            // screen (`src/backend/routes.admin.ts`) carry it, and there is no
+            // `quick_order:*` code in the platform at all.
+            requiredPermission: PREFERENCES_PERMISSION,
+            index: true,
+        },
+    ],
+    zones: [
+        // Weight 300 of four contributors to the organization detail's zone:
+        // `sales_channels` at 100, `price_lists` at 200, this panel, then `carts`
+        // at 400. That is the order the operator saw when the panels were
+        // scattered through `OrganizationDetail.tsx`, preserved rather than
+        // re-chosen.
+        zoneComponent('organization.detail.after', () => import('./zones/OrganizationDefaults.js'), {
+            weight: 300,
+            requiredPermission: PREFERENCES_PERMISSION,
+        }),
+        // The only contribution to the customer detail's zone, so the weight
+        // orders nothing today. Declared rather than defaulted so a second
+        // contributor arrives beside it rather than ahead of it by accident.
+        zoneComponent('customer.detail.after', () => import('./zones/CustomerDefaults.js'), {
+            weight: 100,
+            requiredPermission: PREFERENCES_PERMISSION,
+        }),
+        // Weight 200 of the two tabs in the order-entry strip: `orders`' standard
+        // tab at 100, then this one. That is the order the operator has seen since
+        // the strip existed, preserved rather than re-chosen.
+        //
+        // The same `orders:write`, and for the same reason one level down: the two
+        // `POST`s behind `/orders/quick-order`
+        // (`src/backend/routes.admin.ts`) carry it, and there is no
+        // `quick_order:*` code in the platform at all.
+        zoneComponent('order.entry.tabs', () => import('./zones/OrderEntryQuickTab.js'), {
+            weight: 200,
+            requiredPermission: PREFERENCES_PERMISSION,
+        }),
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,OAAO,EACL,aAAa,GAEd,MAAM,0CAA0C,CAAC;AAElD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,sBAAsB,GAAG,cAAc,CAAC;AAE9C;;;;;;;;;GASG;AACH,MAAM,UAAU,GAAG,qBAAqB,CAAC;AAEzC,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,MAAM,EAAE;QACN;YACE,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mCAAmC,CAAC;YAC5D,qEAAqE;YACrE,uEAAuE;YACvE,mEAAmE;YACnE,+CAA+C;YAC/C,kBAAkB,EAAE,sBAAsB;YAC1C,KAAK,EAAE,IAAI;SACZ;KACF;IACD,KAAK,EAAE;QACL,qEAAqE;QACrE,0EAA0E;QAC1E,kEAAkE;QAClE,oEAAoE;QACpE,aAAa;QACb,aAAa,CAAC,2BAA2B,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,iCAAiC,CAAC,EAAE;YAC1F,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,sBAAsB;SAC3C,CAAC;QACF,qEAAqE;QACrE,mEAAmE;QACnE,qEAAqE;QACrE,aAAa,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,6BAA6B,CAAC,EAAE;YAClF,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,sBAAsB;SAC3C,CAAC;QACF,0EAA0E;QAC1E,2EAA2E;QAC3E,sDAAsD;QACtD,EAAE;QACF,2EAA2E;QAC3E,uCAAuC;QACvC,4DAA4D;QAC5D,+CAA+C;QAC/C,aAAa,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,+BAA+B,CAAC,EAAE;YAC/E,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,sBAAsB;SAC3C,CAAC;KACH;CACF,CAAC"}

package/dist/admin/pages/QuickOrderOnBehalfPage.d.ts

@@ -0,0 +1,16 @@
+import { type ReactNode } from 'react';
+/**
+ * QuickOrderOnBehalfPage — feature 039 (US1 / FR-008).
+ *
+ * Lets an operator import a CSV / Excel file (or paste CSV) and build a Cart
+ * or Quote Request on behalf of a chosen customer + organization. Identifier
+ * fields are entered directly, matching the existing OrderCreatePage approach.
+ */
+export declare function QuickOrderOnBehalfPage(): ReactNode;
+/**
+ * The registry loads a route component through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013). The named export stays: it is
+ * the spelling this module's own code and its tests use.
+ */
+export default QuickOrderOnBehalfPage;
+//# sourceMappingURL=QuickOrderOnBehalfPage.d.ts.map

package/dist/admin/pages/QuickOrderOnBehalfPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuickOrderOnBehalfPage.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/QuickOrderOnBehalfPage.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAcjD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,CAsNlD;AAED;;;;GAIG;AACH,eAAe,sBAAsB,CAAC"}