feat(api,web): c2 consulta de clientes — list + search + auth flow

prisma: modelo Client + migração 20260527225728_add_client + seed dev (10 clientes)
api: GET /clients (list, busca, filtro atividade/financeiro, paginação) + GET /clients/:id
     rep vê carteira própria; supervisor/admin vê tudo; activityStatus calculado de lastOrderAt
@sar/api-interface: ClientSummarySchema, ClientDetailSchema, ClientListResponseSchema
web: ClientsPage (tabela AntD, busca, filtro), DevLogin (token dev), authStore, Bearer no apiFetch
oq-4 resolvida: creditLimit gerenciado no SAR

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

apps/api/prisma/schema.prisma

@@ -9,18 +9,63 @@
 // CODING-RULES PGD-DB-001: MIGRATION_DATABASE_URL aponta direto ao PG (sem PgBouncer)
 
 generator client {
-  provider      = "prisma-client-js"
-  output        = "../../../node_modules/.prisma/client"
-  moduleFormat  = "cjs"
+  provider     = "prisma-client-js"
+  output       = "../../../node_modules/.prisma/client"
+  moduleFormat = "cjs"
 }
 
-// Prisma 7: url foi removida do schema — conexão fica em prisma.config.ts (migrate)
+// Prisma 7: url removida do schema — conexão em prisma.config.ts (migrate)
 // e no WorkspacePrismaPool via PrismaPg adapter (runtime).
 datasource db {
   provider = "postgresql"
 }
 
-// ─── Modelos de domínio serão adicionados por feature ──────────────────────
+// ─── Enums ───────────────────────────────────────────────────────────────────
+
+// Situação financeira resumida do cliente — cacheável offline (FR-2.4, FR-2.5).
+// Valor numérico de crédito e inadimplência requerem conexão.
+enum FinancialStatus {
+  regular
+  attention
+  blocked
+}
+
+// ─── Client (C2) ─────────────────────────────────────────────────────────────
 //
-// Próximos: Client (C2), Order + OrderItem (C3/C4) — vindos das stories.
-// Cada model novo exige: migration versionada + seed de dev atualizado.
+// Cadastro sincronizado do ERP legado (FR-2.6). Rep não cria/edita no MVP.
+// creditLimit: gerenciado no SAR — admin/supervisor define (OQ-4 resolvido 2026-05-27).
+// lastOrderAt/lastOrderValue: desnormalizados, atualizados ao sincronizar Orders (C3/C4).
+// activityStatus: calculado em runtime a partir de lastOrderAt (não persiste — evita drift).
+
+model Client {
+  id            String          @id @default(uuid()) @db.Uuid
+  name          String          // razão social / nome completo
+  tradeName     String?         // nome fantasia
+  taxId         String          @unique // CNPJ (14 dígitos) ou CPF (11 dígitos), sem máscara
+  email         String?
+  phone         String?
+  address       Json?           // { street, number, complement?, district, city, state, zip }
+
+  // Situação financeira — resumo cacheável; detalhes numéricos requerem conexão
+  financialStatus FinancialStatus @default(regular)
+  creditLimit     Decimal?        @db.Decimal(15, 2)
+
+  // Desnormalizados de Orders (atualizados em C3/C4)
+  repId           String          // userId do Rep responsável (JWT sub)
+  lastOrderAt     DateTime?
+  lastOrderValue  Decimal?        @db.Decimal(15, 2)
+  openOrdersCount Int             @default(0)
+
+  // Controle de sync com ERP
+  erpCode         String?         // código no ERP legado
+  syncedAt        DateTime?
+
+  createdAt DateTime  @default(now())
+  updatedAt DateTime  @updatedAt
+  deletedAt DateTime? // soft delete — não remove fisicamente
+
+  @@index([repId])
+  @@index([taxId])
+  @@index([name])
+  @@index([deletedAt]) // filtragem de soft delete eficiente
+}