@open-mercato/core 0.7.0 → 0.7.1-develop.7103.1.41ff100d93

package/src/modules/sales/i18n/es.json

@@ -1016,6 +1016,7 @@
   "sales.documents.items.errorProductRequired": "Selecciona un producto para continuar.",
   "sales.documents.items.errorQuantity": "La cantidad debe ser mayor que 0.",
   "sales.documents.items.errorQuantityBelowShipped": "No puedes reducir la cantidad por debajo de las {{shipped}} ya enviadas.",
+  "sales.documents.items.errorQuantityShipmentsUnknown": "La cantidad no se puede reducir hasta que se carguen los envíos de este pedido. Vuelve a abrir el pedido para intentarlo de nuevo.",
   "sales.documents.items.errorSave": "No se pudo guardar la línea.",
   "sales.documents.items.errorScope": "Se requieren organización e inquilino.",
   "sales.documents.items.errorUnitPrice": "El precio unitario debe ser mayor que 0.",
@@ -1059,6 +1060,8 @@
   "sales.documents.items.save": "Guardar cambios",
   "sales.documents.items.selectedProduct": "Seleccionado {{id}}",
   "sales.documents.items.selectedVariant": "Seleccionado {{id}}",
+  "sales.documents.items.shippedLineLockPending": "Los precios están bloqueados hasta que se carguen los envíos de este pedido. Vuelve a abrir el pedido para intentarlo de nuevo — todavía puedes editar el nombre y aumentar la cantidad.",
+  "sales.documents.items.shippedLineLocked": "Los precios de esta línea están bloqueados porque ya tiene envíos. Todavía puedes editar el nombre y la cantidad.",
   "sales.documents.items.status": "Estado",
   "sales.documents.items.statusEmpty": "Sin estado",
   "sales.documents.items.statusLoading": "Cargando estados…",
@@ -1093,6 +1096,8 @@
   "sales.documents.items.variantSearch": "Buscar variante",
   "sales.documents.list.errors.load": "No se pudieron cargar los documentos.",
   "sales.documents.list.filters.channel": "Canal",
+  "sales.documents.list.filters.channelPlaceholder": "Buscar canales",
+  "sales.documents.list.filters.channelUnassigned": "(Sin canal)",
   "sales.documents.list.filters.customer": "ID de cliente",
   "sales.documents.list.filters.customerPlaceholder": "ID de cliente",
   "sales.documents.list.filters.date": "Fecha",
@@ -1321,13 +1326,16 @@
   "sales.quotes.email.subject": "Cotización {quoteNumber}",
   "sales.quotes.email.total": "Total: {amount} {currency}",
   "sales.quotes.email.validUntil": "Válida hasta: {date}",
+  "sales.quotes.exchange_rate_unsupported": "El tipo de cambio no está disponible en los presupuestos.",
   "sales.quotes.form.general": "General",
   "sales.quotes.form.lines": "Líneas",
   "sales.quotes.form.notes": "Notas",
+  "sales.quotes.fulfillment_status_unsupported": "El estado de cumplimiento no está disponible en los presupuestos.",
   "sales.quotes.internal_notes_unsupported": "Las notas internas no están disponibles en los presupuestos.",
   "sales.quotes.lines.delete": "Eliminar línea de cotización",
   "sales.quotes.lines.upsert": "Actualizar línea de cotización",
   "sales.quotes.list.title": "Cotizaciones",
+  "sales.quotes.payment_status_unsupported": "El estado de pago no está disponible en los presupuestos.",
   "sales.quotes.public.acceptButton": "Aceptar cotización",
   "sales.quotes.public.acceptFailed": "No se pudo aceptar la cotización.",
   "sales.quotes.public.acceptedMessage": "Pedido creado: {{orderNumber}}",

package/src/modules/sales/i18n/ko.json

@@ -1016,6 +1016,7 @@
   "sales.documents.items.errorProductRequired": "계속하려면 상품을 선택하세요.",
   "sales.documents.items.errorQuantity": "수량은 0보다 커야 합니다.",
   "sales.documents.items.errorQuantityBelowShipped": "이미 배송된 {{shipped}} 이하로 수량을 줄일 수 없습니다.",
+  "sales.documents.items.errorQuantityShipmentsUnknown": "이 주문의 배송 정보를 불러올 때까지 수량을 줄일 수 없습니다. 주문을 다시 열어 재시도하세요.",
   "sales.documents.items.errorSave": "품목을 저장하지 못했습니다.",
   "sales.documents.items.errorScope": "조직 및 테넌트 정보가 필요합니다.",
   "sales.documents.items.errorUnitPrice": "단가는 0보다 커야 합니다.",
@@ -1059,6 +1060,8 @@
   "sales.documents.items.save": "변경사항 저장",
   "sales.documents.items.selectedProduct": "선택됨 {{id}}",
   "sales.documents.items.selectedVariant": "선택됨 {{id}}",
+  "sales.documents.items.shippedLineLockPending": "이 주문의 선적 정보를 불러올 때까지 가격 정보가 잠깁니다. 주문을 다시 열어 재시도하세요 — 이름 수정과 수량 증가는 계속 가능합니다.",
+  "sales.documents.items.shippedLineLocked": "이 라인은 이미 선적된 품목이 있어 가격 정보가 잠겨 있습니다. 이름과 수량은 계속 수정할 수 있습니다.",
   "sales.documents.items.status": "상태",
   "sales.documents.items.statusEmpty": "상태 없음",
   "sales.documents.items.statusLoading": "상태 목록을 불러오는 중…",
@@ -1093,6 +1096,8 @@
   "sales.documents.items.variantSearch": "옵션(변형) 검색",
   "sales.documents.list.errors.load": "문서를 불러오지 못했습니다.",
   "sales.documents.list.filters.channel": "채널",
+  "sales.documents.list.filters.channelPlaceholder": "채널 검색",
+  "sales.documents.list.filters.channelUnassigned": "(채널 없음)",
   "sales.documents.list.filters.customer": "고객 ID",
   "sales.documents.list.filters.customerPlaceholder": "고객 ID",
   "sales.documents.list.filters.date": "날짜",
@@ -1321,13 +1326,16 @@
   "sales.quotes.email.subject": "견적 {quoteNumber}",
   "sales.quotes.email.total": "합계: {amount} {currency}",
   "sales.quotes.email.validUntil": "유효 기간: {date}까지",
+  "sales.quotes.exchange_rate_unsupported": "환율은 견적서에서 사용할 수 없습니다.",
   "sales.quotes.form.general": "일반",
   "sales.quotes.form.lines": "라인 항목",
   "sales.quotes.form.notes": "메모",
+  "sales.quotes.fulfillment_status_unsupported": "이행 상태는 견적서에서 사용할 수 없습니다.",
   "sales.quotes.internal_notes_unsupported": "내부 메모는 견적서에서 사용할 수 없습니다.",
   "sales.quotes.lines.delete": "견적 항목 삭제",
   "sales.quotes.lines.upsert": "견적 항목 업데이트",
   "sales.quotes.list.title": "견적",
+  "sales.quotes.payment_status_unsupported": "결제 상태는 견적서에서 사용할 수 없습니다.",
   "sales.quotes.public.acceptButton": "견적 수락",
   "sales.quotes.public.acceptFailed": "견적을 수락하지 못했습니다.",
   "sales.quotes.public.acceptedMessage": "주문이 생성되었습니다: {{orderNumber}}",

package/src/modules/sales/i18n/pl.json

@@ -1016,6 +1016,7 @@
   "sales.documents.items.errorProductRequired": "Wybierz produkt, aby kontynuować.",
   "sales.documents.items.errorQuantity": "Ilość musi być większa niż 0.",
   "sales.documents.items.errorQuantityBelowShipped": "Nie można obniżyć ilości poniżej {{shipped}} już wysłanych.",
+  "sales.documents.items.errorQuantityShipmentsUnknown": "Nie można obniżyć ilości, dopóki wysyłki tego zamówienia nie zostaną wczytane. Otwórz zamówienie ponownie, aby spróbować jeszcze raz.",
   "sales.documents.items.errorSave": "Nie udało się zapisać pozycji.",
   "sales.documents.items.errorScope": "Wymagane są organizacja i najemca.",
   "sales.documents.items.errorUnitPrice": "Cena jednostkowa musi być większa niż 0.",
@@ -1059,6 +1060,8 @@
   "sales.documents.items.save": "Zapisz zmiany",
   "sales.documents.items.selectedProduct": "Wybrano {{id}}",
   "sales.documents.items.selectedVariant": "Wybrano {{id}}",
+  "sales.documents.items.shippedLineLockPending": "Ceny są zablokowane, dopóki wysyłki tego zamówienia nie zostaną wczytane. Otwórz zamówienie ponownie, aby spróbować jeszcze raz — nadal możesz edytować nazwę i zwiększyć ilość.",
+  "sales.documents.items.shippedLineLocked": "Ceny tej pozycji są zablokowane, ponieważ ma już wysłane sztuki. Nazwę i ilość nadal możesz edytować.",
   "sales.documents.items.status": "Status",
   "sales.documents.items.statusEmpty": "Brak statusu",
   "sales.documents.items.statusLoading": "Ładowanie statusów…",
@@ -1093,6 +1096,8 @@
   "sales.documents.items.variantSearch": "Szukaj wariantu",
   "sales.documents.list.errors.load": "Nie udało się wczytać dokumentów.",
   "sales.documents.list.filters.channel": "Kanał",
+  "sales.documents.list.filters.channelPlaceholder": "Szukaj kanałów",
+  "sales.documents.list.filters.channelUnassigned": "(Brak kanału)",
   "sales.documents.list.filters.customer": "ID klienta",
   "sales.documents.list.filters.customerPlaceholder": "ID klienta",
   "sales.documents.list.filters.date": "Data",
@@ -1321,13 +1326,16 @@
   "sales.quotes.email.subject": "Oferta {quoteNumber}",
   "sales.quotes.email.total": "Suma: {amount} {currency}",
   "sales.quotes.email.validUntil": "Ważna do: {date}",
+  "sales.quotes.exchange_rate_unsupported": "Kurs wymiany nie jest dostępny dla ofert.",
   "sales.quotes.form.general": "Ogólne",
   "sales.quotes.form.lines": "Pozycje",
   "sales.quotes.form.notes": "Notatki",
+  "sales.quotes.fulfillment_status_unsupported": "Status realizacji nie jest dostępny dla ofert.",
   "sales.quotes.internal_notes_unsupported": "Notatki wewnętrzne nie są dostępne dla ofert.",
   "sales.quotes.lines.delete": "Usuń pozycję oferty",
   "sales.quotes.lines.upsert": "Zaktualizuj pozycję oferty",
   "sales.quotes.list.title": "Oferty",
+  "sales.quotes.payment_status_unsupported": "Status płatności nie jest dostępny dla ofert.",
   "sales.quotes.public.acceptButton": "Zaakceptuj ofertę",
   "sales.quotes.public.acceptFailed": "Nie udało się zaakceptować oferty.",
   "sales.quotes.public.acceptedMessage": "Utworzono zamówienie: {{orderNumber}}",

package/src/modules/sales/lib/salesChannelsToggleSeed.ts

@@ -0,0 +1,42 @@
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { FeatureToggle } from '@open-mercato/core/modules/feature_toggles/data/entities'
+import { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'
+import { SALES_CHANNELS_TOGGLE_ID } from './salesChannelsToggleId'
+
+export const SALES_CHANNELS_TOGGLE_DEFINITION = {
+  identifier: SALES_CHANNELS_TOGGLE_ID,
+  name: 'Sales Channels',
+  description: 'Show sales channel pickers, filters, and management UI. Disable for tenants that do not use sales channels.',
+  category: 'sales',
+  type: 'boolean' as const,
+  defaultValue: true,
+} as const
+
+// The sales module owns this toggle definition, so tenant setup registers it the
+// same way portal, customers and wms register theirs. Shipping it only in the
+// core defaults file left it unregistered on every database initialized before
+// the toggle existed, and `useSalesChannelsEnabled` then 404s on every mount.
+//
+// The lookup deliberately does not filter on `deletedAt`. Deletion is soft
+// (`feature_toggles.global.delete`) while `feature_toggles_identifier_unique`
+// covers every row, so filtering would make this insert a duplicate and fail the
+// whole seed run on any installation where the toggle was deleted. Matching the
+// create command's own uniqueness check also leaves an operator's deletion alone
+// instead of resurrecting the definition on every tenant seed.
+export async function seedSalesChannelsToggle(em: EntityManager): Promise<void> {
+  const existing = await findOneWithDecryption(em, FeatureToggle, {
+    identifier: SALES_CHANNELS_TOGGLE_DEFINITION.identifier,
+  })
+  if (existing) return
+  em.persist(
+    em.create(FeatureToggle, {
+      identifier: SALES_CHANNELS_TOGGLE_DEFINITION.identifier,
+      name: SALES_CHANNELS_TOGGLE_DEFINITION.name,
+      description: SALES_CHANNELS_TOGGLE_DEFINITION.description,
+      category: SALES_CHANNELS_TOGGLE_DEFINITION.category,
+      type: SALES_CHANNELS_TOGGLE_DEFINITION.type,
+      defaultValue: SALES_CHANNELS_TOGGLE_DEFINITION.defaultValue,
+    }),
+  )
+  await em.flush()
+}

package/src/modules/sales/migrations/.snapshot-open-mercato.json

@@ -1962,6 +1962,36 @@
           "keyName": "sales_document_addresses_scope_idx",
           "primary": false,
           "unique": false
+        },
+        {
+          "columnNames": [
+            "document_id"
+          ],
+          "composite": false,
+          "constraint": false,
+          "keyName": "sales_document_addresses_document_idx",
+          "primary": false,
+          "unique": false
+        },
+        {
+          "columnNames": [
+            "order_id"
+          ],
+          "composite": false,
+          "constraint": false,
+          "keyName": "sales_document_addresses_order_idx",
+          "primary": false,
+          "unique": false
+        },
+        {
+          "columnNames": [
+            "quote_id"
+          ],
+          "composite": false,
+          "constraint": false,
+          "keyName": "sales_document_addresses_quote_idx",
+          "primary": false,
+          "unique": false
         }
       ],
       "checks": [],
@@ -3750,6 +3780,36 @@
           "keyName": "sales_notes_scope_idx",
           "primary": false,
           "unique": false
+        },
+        {
+          "columnNames": [
+            "context_id"
+          ],
+          "composite": false,
+          "constraint": false,
+          "keyName": "sales_notes_context_idx",
+          "primary": false,
+          "unique": false
+        },
+        {
+          "columnNames": [
+            "order_id"
+          ],
+          "composite": false,
+          "constraint": false,
+          "keyName": "sales_notes_order_idx",
+          "primary": false,
+          "unique": false
+        },
+        {
+          "columnNames": [
+            "quote_id"
+          ],
+          "composite": false,
+          "constraint": false,
+          "keyName": "sales_notes_quote_idx",
+          "primary": false,
+          "unique": false
         }
       ],
       "checks": [],

package/src/modules/sales/migrations/Migration20260821120000_sales_notes_addresses_context_idx.ts

@@ -0,0 +1,87 @@
+import { Migration } from '@mikro-orm/migrations';
+
+// sales_notes and sales_document_addresses each carried a single index —
+// (organization_id, tenant_id) — and are never read by that predicate alone.
+// loadOrderSnapshot / loadQuoteSnapshot (commands/documents.ts) read them by
+// context in the same Promise.all:
+//
+//   findWithDecryption(em, SalesNote, { contextType, contextId, ...scope })
+//   findWithDecryption(em, SalesDocumentAddress, { documentId, documentKind, ...scope })
+//
+// On a single-organization deployment the scope index matches every row, so the
+// planner discards it and scans. The cost is CPU filtering, so a warm cache does
+// not reduce it. Measured on a table of ~331k rows / 110 MB: a parallel
+// sequential scan removing 110,457 rows per worker, 82 ms per read to return 0
+// rows. The command bus runs prepare() and captureAfter() around every command
+// and both load a document snapshot, so one written document — itself several
+// commands (the document, one per changed line, the payment reconcile) —
+// performs roughly 20 of these reads. Counters over one bulk-import batch of 100
+// records showed 1,971 sequential scans reading 217,670,528 rows, 2.18M rows per
+// imported record; repeatable across consecutive batches (1,971 / 1,974 / 1,911).
+//
+// context_type and document_kind are deliberately omitted, as they were for
+// sales_document_tag_assignments_document_idx (Migration20260806120000), and the
+// scope columns with them. sales_orders.id and sales_quotes.id are both
+// gen_random_uuid() from their own tables, so a context_id already determines its
+// context_type and its tenant; the seek returns the handful of rows belonging to
+// one document and the remaining terms are rechecked over those. Folding three
+// more columns in — one text and two uuids — roughly triples the index entry for
+// no selectivity, on tables that take a write per document save and a note per
+// order status change. The sibling scope indexes that do fold scope in
+// (sales_order_lines_scope_idx, sales_payments_scope_idx) predate that reasoning.
+//
+// order_id and quote_id are separate indexes rather than a widening of the above:
+// both tables are the child side of `on delete set null` constraints, which
+// PostgreSQL does not index automatically, and the constraint check probes
+// order_id / quote_id — columns the context index cannot serve even though they
+// hold the same uuid. Without them every delete of a parent order or quote scans
+// the child table in full.
+//
+// Both tables are high-churn, so the indexes are built CONCURRENTLY to avoid
+// blocking writes during the build. CREATE INDEX CONCURRENTLY cannot run inside a
+// transaction, hence isTransactional() => false; the migration runner applies
+// migrations one-by-one, so this opt-out is safe. Drop first so retrying a failed
+// concurrent build removes PostgreSQL's invalid index stub instead of letting IF
+// NOT EXISTS silently accept it: a half-built concurrent index is left INVALID,
+// the planner ignores it, and IF NOT EXISTS would report success while the table
+// stays unindexed. Same shape as Migration20260806120000 and
+// Migration20260731105052_query_index.
+//
+// On a database that does not have these indexes yet — every fresh install — the
+// drops are no-ops and there is no window without them. An operator who already
+// created one out of band should expect it to be rebuilt here, and the reads that
+// depend on it to fall back to their pre-index cost until the concurrent build
+// finishes; on a large table, run this while the writers that depend on it are
+// paused.
+export class Migration20260821120000_sales_notes_addresses_context_idx extends Migration {
+
+  override isTransactional(): boolean {
+    return false;
+  }
+
+  override up(): void | Promise<void> {
+    this.addSql(`drop index concurrently if exists "sales_notes_context_idx";`);
+    this.addSql(`create index concurrently "sales_notes_context_idx" on "sales_notes" ("context_id");`);
+    this.addSql(`drop index concurrently if exists "sales_notes_order_idx";`);
+    this.addSql(`create index concurrently "sales_notes_order_idx" on "sales_notes" ("order_id");`);
+    this.addSql(`drop index concurrently if exists "sales_notes_quote_idx";`);
+    this.addSql(`create index concurrently "sales_notes_quote_idx" on "sales_notes" ("quote_id");`);
+
+    this.addSql(`drop index concurrently if exists "sales_document_addresses_document_idx";`);
+    this.addSql(`create index concurrently "sales_document_addresses_document_idx" on "sales_document_addresses" ("document_id");`);
+    this.addSql(`drop index concurrently if exists "sales_document_addresses_order_idx";`);
+    this.addSql(`create index concurrently "sales_document_addresses_order_idx" on "sales_document_addresses" ("order_id");`);
+    this.addSql(`drop index concurrently if exists "sales_document_addresses_quote_idx";`);
+    this.addSql(`create index concurrently "sales_document_addresses_quote_idx" on "sales_document_addresses" ("quote_id");`);
+  }
+
+  override down(): void | Promise<void> {
+    this.addSql(`drop index concurrently if exists "sales_document_addresses_quote_idx";`);
+    this.addSql(`drop index concurrently if exists "sales_document_addresses_order_idx";`);
+    this.addSql(`drop index concurrently if exists "sales_document_addresses_document_idx";`);
+    this.addSql(`drop index concurrently if exists "sales_notes_quote_idx";`);
+    this.addSql(`drop index concurrently if exists "sales_notes_order_idx";`);
+    this.addSql(`drop index concurrently if exists "sales_notes_context_idx";`);
+  }
+
+}

package/src/modules/sales/setup.ts

@@ -3,6 +3,7 @@ import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'
 import { SalesSettings, SalesDocumentSequence, SalesTaxRate } from './data/entities'
 import { DEFAULT_ORDER_NUMBER_FORMAT, DEFAULT_QUOTE_NUMBER_FORMAT } from './lib/documentNumberTokens'
 import { seedSalesStatusDictionaries, seedSalesAdjustmentKinds } from './lib/dictionaries'
+import { seedSalesChannelsToggle } from './lib/salesChannelsToggleSeed'
 import { ensureExampleShippingMethods, ensureExamplePaymentMethods } from './seed/examples-data'
 import { seedSalesExamples } from './seed/examples'
 
@@ -116,6 +117,7 @@ export const setup: ModuleSetupConfig = {
     await seedSalesAdjustmentKinds(em, scope)
     await ensureExampleShippingMethods(em, scope)
     await ensureExamplePaymentMethods(em, scope)
+    await seedSalesChannelsToggle(em)
   },
 
   async seedExamples({ em, container, tenantId, organizationId }) {

package/src/modules/sales/widgets/injection/payment-gateway-status-column/widget.ts

@@ -1,19 +1,27 @@
 import type { InjectionColumnWidget } from '@open-mercato/shared/modules/widgets/injection'
+import { InjectionPosition } from '@open-mercato/shared/modules/widgets/injection-position'
 
 const widget: InjectionColumnWidget = {
   metadata: {
     id: 'sales.injection.payment-gateway-status-column',
     priority: 50,
+    features: ['payment_gateways.view'],
+    // The header key and every value this column can ever show come from
+    // `payment_gateways`; without that module the column has no data source and
+    // its header would degrade to the raw translation key.
+    requiredModules: ['payment_gateways'],
   },
   columns: [
     {
       id: 'gateway_status',
       header: 'payment_gateways.column.gatewayStatus',
       accessorKey: '_gateway.unifiedStatus',
+      size: 120,
       sortable: false,
+      placement: { position: InjectionPosition.After, relativeTo: 'status' },
       cell: ({ getValue }) => {
         const value = getValue()
-        return typeof value === 'string' && value.trim().length > 0 ? value : 'pending'
+        return typeof value === 'string' && value.trim().length > 0 ? value : '—'
       },
     },
   ],

package/src/modules/sales/widgets/injection-table.ts

@@ -17,13 +17,10 @@ export const injectionTable: ModuleInjectionTable = {
       priority: 50,
     },
   ],
-  // NOTE: the 'data-table:sales.payments:columns' binding for
-  // 'sales.injection.payment-gateway-status-column' was removed here — it could never
-  // resolve. PaymentsSection.tsx renders its DataTable with no perspective/injectionSpotId/
-  // extensionTableId, so extensionTableId is null and the columns spot degrades to
-  // '__disabled__:columns'. The widget itself is still registered and is now UNBOUND: giving
-  // the payments table a real tableId so the gateway-status column finally renders is a sales
-  // feature gap, tracked in #5142 rather than silently reintroduced here.
+  'data-table:sales.payments:columns': {
+    widgetId: 'sales.injection.payment-gateway-status-column',
+    priority: 50,
+  },
   'crud-form:sales.payment_method:fields': {
     widgetId: 'sales.injection.payment-gateway-config-field',
     priority: 40,

package/src/modules/staff/backend/staff/leave-requests/page.tsx

@@ -30,6 +30,7 @@ type LeaveRequestsResponse = {
   items?: Array<Record<string, unknown>>
   total?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 export default function StaffLeaveRequestsPage() {
@@ -40,6 +41,7 @@ export default function StaffLeaveRequestsPage() {
   const [page, setPage] = React.useState(1)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [search, setSearch] = React.useState('')
   const [isLoading, setIsLoading] = React.useState(true)
   const [sorting, setSorting] = React.useState<SortingState>([{ id: 'startDate', desc: true }])
@@ -123,6 +125,7 @@ export default function StaffLeaveRequestsPage() {
       setRows(items.map(mapLeaveRequest))
       setTotal(typeof payload.total === 'number' ? payload.total : items.length)
       setTotalPages(typeof payload.totalPages === 'number' ? payload.totalPages : 1)
+      setTotalIsCapped(payload?.totalIsCapped === true)
     } catch {
       setRows([])
       setTotal(0)
@@ -177,6 +180,7 @@ export default function StaffLeaveRequestsPage() {
             pageSize: PAGE_SIZE,
             total,
             totalPages,
+            totalIsCapped,
             onPageChange: setPage,
           }}
           onRowClick={(row) => {

package/src/modules/staff/backend/staff/my-leave-requests/page.tsx

@@ -29,6 +29,7 @@ type LeaveRequestsResponse = {
   total?: number
   totalPages?: number
   viewer?: { memberId?: string | null; canSend?: boolean }
+  totalIsCapped?: boolean
 }
 
 export default function StaffMyLeaveRequestsPage() {
@@ -39,6 +40,7 @@ export default function StaffMyLeaveRequestsPage() {
   const [page, setPage] = React.useState(1)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [search, setSearch] = React.useState('')
   const [isLoading, setIsLoading] = React.useState(true)
   const [sorting, setSorting] = React.useState<SortingState>([{ id: 'startDate', desc: true }])
@@ -118,6 +120,7 @@ export default function StaffMyLeaveRequestsPage() {
       setRows(items.map(mapLeaveRequest))
       setTotal(typeof payload.total === 'number' ? payload.total : items.length)
       setTotalPages(typeof payload.totalPages === 'number' ? payload.totalPages : 1)
+      setTotalIsCapped(payload?.totalIsCapped === true)
       const viewerMemberId = typeof payload.viewer?.memberId === 'string' ? payload.viewer.memberId : null
       setMemberId(viewerMemberId)
       setCanSend(payload.viewer?.canSend === true)
@@ -182,6 +185,7 @@ export default function StaffMyLeaveRequestsPage() {
             pageSize: PAGE_SIZE,
             total,
             totalPages,
+            totalIsCapped,
             onPageChange: setPage,
           }}
           onRowClick={(row) => {

package/src/modules/staff/backend/staff/team-members/page.tsx

@@ -47,6 +47,7 @@ type TeamMembersResponse = {
   items?: Array<Record<string, unknown>>
   total?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 type TeamsResponse = {
@@ -68,6 +69,7 @@ export default function StaffTeamMembersPage() {
   const [page, setPage] = React.useState(1)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [sorting, setSorting] = React.useState<SortingState>([{ id: 'displayName', desc: false }])
   const [search, setSearch] = React.useState('')
   const [isLoading, setIsLoading] = React.useState(true)
@@ -272,6 +274,9 @@ export default function StaffTeamMembersPage() {
         : typeof payload.totalPages === 'number'
           ? payload.totalPages
           : Math.max(1, Math.ceil(items.length / PAGE_SIZE)))
+      // A role filter is applied client-side over the fetched page, so the total
+      // shown is that array's length — exact by construction, never a capped floor.
+      setTotalIsCapped(!roleFilterApplied && payload.totalIsCapped === true)
     } catch (error) {
       logger.error('staff.team-members.list', { err: error })
       flash(labels.errors.load, 'error')
@@ -452,6 +457,7 @@ export default function StaffTeamMembersPage() {
             pageSize: PAGE_SIZE,
             total,
             totalPages,
+            totalIsCapped,
             onPageChange: setPage,
           }}
           rowActions={(row) => row.kind === 'member' ? (

package/src/modules/staff/backend/staff/team-roles/page.tsx

@@ -41,6 +41,7 @@ type TeamRolesResponse = {
   items?: Array<Record<string, unknown>>
   total?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 type TeamsResponse = {
@@ -56,6 +57,7 @@ export default function StaffTeamRolesPage() {
   const [page, setPage] = React.useState(1)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [search, setSearch] = React.useState('')
   const [isLoading, setIsLoading] = React.useState(true)
   const [reloadToken, setReloadToken] = React.useState(0)
@@ -203,6 +205,7 @@ export default function StaffTeamRolesPage() {
       setRows(buildTeamRoleRows(items.map(mapApiTeamRole), labels.groups.unassigned))
       setTotal(typeof payload.total === 'number' ? payload.total : items.length)
       setTotalPages(typeof payload.totalPages === 'number' ? payload.totalPages : Math.max(1, Math.ceil(items.length / PAGE_SIZE)))
+      setTotalIsCapped(payload?.totalIsCapped === true)
     } catch (error) {
       logger.error('staff.team-roles.list', { err: error })
       flash(labels.errors.load, 'error')
@@ -329,6 +332,7 @@ export default function StaffTeamRolesPage() {
             pageSize: PAGE_SIZE,
             total,
             totalPages,
+            totalIsCapped,
             onPageChange: setPage,
           }}
           rowActions={(row) => row.kind === 'role' ? (

package/src/modules/staff/backend/staff/teams/[id]/edit/page.tsx

@@ -60,6 +60,7 @@ type TeamMembersResponse = {
   items?: Array<Record<string, unknown>>
   total?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 export default function StaffTeamEditPage({ params }: { params?: { id?: string } }) {
@@ -76,6 +77,7 @@ export default function StaffTeamEditPage({ params }: { params?: { id?: string }
   const [memberRows, setMemberRows] = React.useState<TeamMemberRow[]>([])
   const [memberPage, setMemberPage] = React.useState(1)
   const [memberTotal, setMemberTotal] = React.useState(0)
+  const [memberTotalIsCapped, setMemberTotalIsCapped] = React.useState(false)
   const [memberTotalPages, setMemberTotalPages] = React.useState(1)
   const [memberSorting, setMemberSorting] = React.useState<SortingState>([{ id: 'displayName', desc: false }])
   const [memberSearch, setMemberSearch] = React.useState('')
@@ -263,6 +265,7 @@ export default function StaffTeamEditPage({ params }: { params?: { id?: string }
       const items = Array.isArray(payload.items) ? payload.items : []
       setMemberRows(items.map(mapApiTeamMember))
       setMemberTotal(typeof payload.total === 'number' ? payload.total : items.length)
+      setMemberTotalIsCapped(payload.totalIsCapped === true)
       setMemberTotalPages(
         typeof payload.totalPages === 'number'
           ? payload.totalPages
@@ -434,6 +437,7 @@ export default function StaffTeamEditPage({ params }: { params?: { id?: string }
                 pageSize: TEAM_MEMBERS_PAGE_SIZE,
                 total: memberTotal,
                 totalPages: memberTotalPages,
+                totalIsCapped: memberTotalIsCapped,
                 onPageChange: setMemberPage,
               }}
               rowActions={(row) => (

package/src/modules/staff/backend/staff/teams/page.tsx

@@ -41,6 +41,7 @@ type TeamsResponse = {
   items?: Array<Record<string, unknown>>
   total?: number
   totalPages?: number
+  totalIsCapped?: boolean
 }
 
 export default function StaffTeamsPage() {
@@ -52,6 +53,7 @@ export default function StaffTeamsPage() {
   const [page, setPage] = React.useState(1)
   const [total, setTotal] = React.useState(0)
   const [totalPages, setTotalPages] = React.useState(1)
+  const [totalIsCapped, setTotalIsCapped] = React.useState(false)
   const [sorting, setSorting] = React.useState<SortingState>([{ id: 'name', desc: false }])
   const [search, setSearch] = React.useState('')
   const [isLoading, setIsLoading] = React.useState(true)
@@ -176,6 +178,7 @@ export default function StaffTeamsPage() {
       setRows(items.map(mapApiTeam))
       setTotal(typeof payload.total === 'number' ? payload.total : items.length)
       setTotalPages(typeof payload.totalPages === 'number' ? payload.totalPages : Math.max(1, Math.ceil(items.length / PAGE_SIZE)))
+      setTotalIsCapped(payload?.totalIsCapped === true)
     } catch (error) {
       logger.error('staff.teams.list', { err: error })
       flash(labels.errors.load, 'error')
@@ -261,6 +264,7 @@ export default function StaffTeamsPage() {
             pageSize: PAGE_SIZE,
             total,
             totalPages,
+            totalIsCapped,
             onPageChange: setPage,
           }}
           rowActions={(row) => (

package/src/modules/staff/backend/staff/timesheets/page.tsx

@@ -178,6 +178,12 @@ export default function MyTimesheetsPage() {
     blockedMessage: t('ui.forms.flash.saveBlocked', 'Save blocked by validation'),
   })
 
+  const gridInstanceId = React.useId()
+  const durationHintId = `${gridInstanceId}-duration-hint`
+  const buildDurationErrorId = React.useCallback(
+    (projectId: string, dateKey: string): string => `${gridInstanceId}-duration-error-${projectId}-${dateKey}`,
+    [gridInstanceId],
+  )
   const durationFormatHint = t(
     'staff.timesheets.my.duration.hint',
     'Enter hours (8 or 1.5), h:mm (1:30) or minutes (90m). Max 24h per day.',
@@ -919,6 +925,7 @@ export default function MyTimesheetsPage() {
                       const isDirty = dirty[project.id]?.[dateKey] !== undefined
                       const cellError = cellErrors[project.id]?.[dateKey]
                       const cellErrorMessage = cellError ? describeDurationError(cellError) : undefined
+                      const cellErrorId = cellErrorMessage ? buildDurationErrorId(project.id, dateKey) : undefined
                       return (
                         <td key={dateKey} className={`px-0.5 py-0.5 ${weekend ? 'bg-muted/40' : ''}`}>
                           {weekend ? (
@@ -943,9 +950,13 @@ export default function MyTimesheetsPage() {
                               placeholder={t('staff.timesheets.my.durationPlaceholder', '0')}
                               aria-invalid={cellError !== undefined}
                               aria-label={describeDurationCell(project.name, date)}
+                              aria-describedby={[durationHintId, cellErrorId].filter(Boolean).join(' ')}
                               title={cellErrorMessage ?? durationFormatHint}
                             />
                           )}
+                          {cellErrorMessage ? (
+                            <span id={cellErrorId} role="alert" className="sr-only">{cellErrorMessage}</span>
+                          ) : null}
                         </td>
                       )
                     })}
@@ -984,7 +995,7 @@ export default function MyTimesheetsPage() {
                 </tr>
               </tfoot>
             </table>
-            <p className="px-3 py-2 text-xs text-muted-foreground">{durationFormatHint}</p>
+            <p id={durationHintId} className="px-3 py-2 text-xs text-muted-foreground">{durationFormatHint}</p>
           </div>
         )}
         </div>