feat(mvp-rep): formas de pagamento do ERP + suporte offline completo

Formas de pagamento:
- Endpoint GET /catalog/payment-methods lendo vw_formas_pagamento
  filtrado por ativa=1 e integrar_sar=1
- FormaPagamento schema/type no shared api-interface
- Hook useFormasPagamento (staleTime 1h) substituindo lista hardcoded

Offline (FR-4.2 / NFR-2.1–2.4):
- IndexedDB queue: lib/offline/idb.ts + order-queue.ts sem deps externos
- NewOrderPage detecta !navigator.onLine → enqueueOrder() → toast + reset
- useOfflineSync: auto-sync ao reconectar (POST orders + PATCH transmit)
- usePendingOrders: fila reativa via CustomEvents
- AppShell: banner offline + useOfflineSync() global
- OrdersPage: seção de pedidos pendentes com retry/descartar
- sw.js: network-first para API GETs cacheáveis + stale-while-revalidate
  para assets + app shell navigate fallback

Docs:
- architecture.md: documento de decisões de arquitetura do SAR MVP

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

apps/api/src/app/clients/clients.service.ts

@@ -36,6 +36,7 @@ interface ClientRow {
   email: string | null;
   telefone: string | null;
   cod_vendedor: number;
+  nome_vendedor: string | null;
   limite_credito: string | null;
   dt_ultima_compra: Date | null;
   ativo: number;
@@ -55,20 +56,33 @@ interface ClientRow {
 // SQL compartilhado: dois subqueries que calculam a data do último pedido
 // considerando TANTO pedidos ERP (vw_pedidos_erp) QUANTO pedidos SAR (tabela pedidos).
 // vw_pedidos_erp: situa SIG 5=Cancelado (excluir); pedidos SAR: situa 3=Cancelado (excluir).
-const PEDIDOS_JOINS = `
+// Clientes são cadastro GLOBAL (sem vínculo de id_empresa). A "última compra",
+// porém, é escopada à empresa atual: filtramos os pedidos por idEmpresa e juntamos
+// apenas por id_cliente.
+function pedidosJoins(idEmpresa: number): string {
+  return `
   LEFT JOIN (
-    SELECT id_cliente, id_empresa, MAX(dt_pedido) AS dt_max
+    SELECT id_cliente, MAX(dt_pedido) AS dt_max
     FROM vw_pedidos_erp
-    WHERE situa NOT IN (5)
-    GROUP BY id_cliente, id_empresa
-  ) erp_ped ON erp_ped.id_cliente = c.id_cliente AND erp_ped.id_empresa = c.id_empresa
+    WHERE situa NOT IN (5) AND id_empresa = ${idEmpresa}
+    GROUP BY id_cliente
+  ) erp_ped ON erp_ped.id_cliente = c.id_cliente
   LEFT JOIN (
-    SELECT id_cliente, id_empresa, MAX(dt_pedido) AS dt_max
+    SELECT id_cliente, MAX(dt_pedido) AS dt_max
     FROM pedidos
-    WHERE situa != 3
-    GROUP BY id_cliente, id_empresa
-  ) sar_ped ON sar_ped.id_cliente = c.id_cliente AND sar_ped.id_empresa = c.id_empresa
-`;
+    WHERE situa != 3 AND id_empresa = ${idEmpresa}
+    GROUP BY id_cliente
+  ) sar_ped ON sar_ped.id_cliente = c.id_cliente
+  `;
+}
+
+// Subquery escalar para o nome do representante (cadastro global, sem id_empresa).
+// NÃO usar JOIN: vw_representantes tem códigos duplicados, o que multiplicaria as
+// linhas de cliente e quebraria contagem/paginação. LIMIT 1 garante 1 nome.
+const NOME_VENDEDOR_SUBQ = `
+  (SELECT r.nome FROM vw_representantes r
+    WHERE r.codigo = c.cod_vendedor
+    LIMIT 1) AS nome_vendedor`;
 
 // Expressão SQL que calcula o activity_status a partir das datas dos dois joins.
 const ACTIVITY_CASE = (alias_erp = 'erp_ped', alias_sar = 'sar_ped') => `
@@ -104,13 +118,14 @@ export class ClientsService {
     // Filtro de status calculado em SQL — evita paginação quebrada do filtro pós-SQL
     const statusFilter = status ? `AND ${ACTIVITY_CASE()} = '${status}'` : '';
 
+    // Clientes globais: sem filtro de id_empresa. Rep continua escopado por cod_vendedor.
     const baseWhere = `
-      WHERE c.id_empresa = ${idEmpresa}
-        AND c.ativo = 1
+      WHERE c.ativo = 1
         ${vendedorFilter}
         ${searchFilter}
         ${statusFilter}
     `;
+    const joins = pedidosJoins(idEmpresa);
 
     const [rows, totalRows] = await Promise.all([
       prisma.$queryRawUnsafe<ClientRow[]>(`
@@ -123,6 +138,7 @@ export class ClientsService {
           c.email,
           c.telefone,
           c.cod_vendedor,
+          ${NOME_VENDEDOR_SUBQ},
           c.limite_credito::text,
           c.ativo,
           c.pessoa,
@@ -138,7 +154,7 @@ export class ClientsService {
           c.dt_atual::text,
           GREATEST(erp_ped.dt_max, sar_ped.dt_max) AS dt_ultima_compra
         FROM vw_clientes c
-        ${PEDIDOS_JOINS}
+        ${joins}
         ${baseWhere}
         ORDER BY c.nome
         LIMIT ${limit} OFFSET ${offset}
@@ -146,7 +162,7 @@ export class ClientsService {
       prisma.$queryRawUnsafe<[{ count: string }]>(`
         SELECT COUNT(*)::text AS count
         FROM vw_clientes c
-        ${PEDIDOS_JOINS}
+        ${joins}
         ${baseWhere}
       `),
     ]);
@@ -162,6 +178,7 @@ export class ClientsService {
       email: r.email,
       telefone: r.telefone,
       codVendedor: Number(r.cod_vendedor),
+      nomeVendedor: r.nome_vendedor ?? null,
       limiteCreditoStr: r.limite_credito,
       activityStatus: activityStatus(r.dt_ultima_compra),
       dtUltimaCompra: r.dt_ultima_compra?.toISOString() ?? null,
@@ -178,14 +195,14 @@ export class ClientsService {
     const rows = await prisma.$queryRawUnsafe<ClientRow[]>(`
       SELECT
         c.id_cliente, c.id_empresa, c.nome, c.razao, c.cgcpf, c.email,
-        c.telefone, c.cod_vendedor, c.limite_credito::text,
+        c.telefone, c.cod_vendedor, ${NOME_VENDEDOR_SUBQ}, c.limite_credito::text,
         c.ativo, c.pessoa, c.inscricao_estadual, c.endereco, c.num_endereco,
         c.bairro, c.cep, c.ddd, c.obs, c.cod_pauta,
         c.dt_cadastro::text, c.dt_atual::text,
         GREATEST(erp_ped.dt_max, sar_ped.dt_max) AS dt_ultima_compra
       FROM vw_clientes c
-      ${PEDIDOS_JOINS}
-      WHERE c.id_empresa = ${idEmpresa} AND c.id_cliente = ${idCliente}
+      ${pedidosJoins(idEmpresa)}
+      WHERE c.id_cliente = ${idCliente}
       LIMIT 1
     `);
 
@@ -201,6 +218,7 @@ export class ClientsService {
       email: r.email,
       telefone: r.telefone,
       codVendedor: Number(r.cod_vendedor),
+      nomeVendedor: r.nome_vendedor ?? null,
       limiteCreditoStr: r.limite_credito,
       activityStatus: activityStatus(r.dt_ultima_compra),
       dtUltimaCompra: r.dt_ultima_compra?.toISOString() ?? null,