feat(api,web): mapa do brasil com faturamento por estado no painel gerencial

- KPIs financeiros agrupados (faturamento, meta, atingimento, falta) em metade da primeira dobra
- MapaBrasilCard: choropleth por UF (@svg-maps/brazil), tooltip, ranking lateral e modal Detalhar com representantes por estado
- API: faturamentoPorUf no /dashboard/manager (pedido -> cliente -> municipio -> UF)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

libs/shared/api-interface/src/lib/dashboard.contract.ts

@@ -114,6 +114,26 @@ export const PositivacaoDiaSchema = z.object({
 });
 export type PositivacaoDia = z.infer<typeof PositivacaoDiaSchema>;
 
+// Faturamento por estado (UF do município do cliente), com detalhe por representante.
+export const UfRepSchema = z.object({
+  codVendedor: z.number().int(),
+  nomeVendedor: z.string().nullable(),
+  faturamento: z.number(),
+  pedidos: z.number().int(),
+  clientes: z.number().int(),
+});
+export type UfRep = z.infer<typeof UfRepSchema>;
+
+export const UfFaturamentoSchema = z.object({
+  uf: z.string(), // sigla (SP, PR…); 'ND' = cliente sem município/UF
+  faturamento: z.number(),
+  pedidos: z.number().int(),
+  clientes: z.number().int(),
+  pct: z.number(), // participação no faturamento do período
+  reps: z.array(UfRepSchema),
+});
+export type UfFaturamento = z.infer<typeof UfFaturamentoSchema>;
+
 export const ManagerDashboardSchema = z.object({
   faturamentoMes: z.number(),
   pedidosMes: z.number().int(),
@@ -125,6 +145,7 @@ export const ManagerDashboardSchema = z.object({
   rankingReps: z.array(RankingRepSchema),
   positivacaoReps: z.array(PositivacaoRepSchema),
   positivacaoDiaria: z.array(PositivacaoDiaSchema).default([]),
+  faturamentoPorUf: z.array(UfFaturamentoSchema).default([]),
   // Meta diária de positivação salva pelo gerente (config_empresa)
   metaPositivacaoDia: z.number().int().nullable().optional(),
   syncedAt: z.iso.datetime(),