feat(politicas): regras de desconto por grupo/subgrupo/rep e condicoes comerciais no catalogo

- Nova tabela sar.regras_desconto (grupo, subgrupo, representante, % e
  vigencia; campos nulos = todos) com migration idempotente, espelho no
  sar-erp-schema.sql e GRANT no provision-client
- CRUD manager-only em /politicas/regras + aba "Regras de Desconto" na
  tela de Politicas Comerciais (selects com nomes de rep/grupo/subgrupo
  via /politicas/grupos-produto)
- GET /politicas/regras/vigentes (rep ve so as que o alcancam) e
  GET /politicas/promocoes/vigentes para o catalogo
- Regra vigente pre-aplica o desconto no carrinho do novo pedido
- Selos "Promocao"/"Cond. especial" na busca de produto, catalogo do
  pedido e pagina de catalogo; secao "Condicoes Comerciais" no modal de
  detalhe do produto (descricao, % e validade)
- Empty imageStyle deprecado -> styles.image no carrinho

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

apps/api/prisma/migrations/20260722000000_add_regras_desconto/migration.sql

@@ -0,0 +1,23 @@
+-- CreateTable: sar.regras_desconto (Regras de Desconto - Politicas Comerciais)
+-- Desconto liberado pelo gerente por grupo/subgrupo de produto e/ou
+-- representante, com vigencia. Campos nulos = "todos".
+-- Definicao espelha scripts/sar-erp-schema.sql: provision-client.ts roda o schema SQL
+-- antes de `prisma migrate deploy`, entao esta migration precisa ser idempotente.
+-- ATENCAO: bancos ERP usam LATIN1 - nao usar em-dash nem box-drawing aqui.
+CREATE TABLE IF NOT EXISTS sar.regras_desconto (
+    id               SERIAL        PRIMARY KEY,
+    id_empresa       INTEGER       NOT NULL,
+    descricao        VARCHAR(200)  NOT NULL,
+    cod_grupo        INTEGER,
+    cod_subgrupo     INTEGER,
+    cod_vendedor     INTEGER,
+    desc_pct         NUMERIC(5,2)  NOT NULL,
+    data_inicio      DATE          NOT NULL,
+    data_fim         DATE          NOT NULL,
+    ativa            BOOLEAN       NOT NULL DEFAULT TRUE,
+    created_at       TIMESTAMP     NOT NULL DEFAULT NOW(),
+    created_by       VARCHAR(100)  NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_sar_regras_empresa ON sar.regras_desconto(id_empresa);
+CREATE INDEX IF NOT EXISTS idx_sar_regras_vigente ON sar.regras_desconto(id_empresa, data_fim) WHERE ativa;

apps/api/prisma/schema.prisma

@@ -171,6 +171,30 @@ model Promocao {
   @@map("promocoes")
 }
 
+// ─── RegraDesconto (Políticas Comerciais) ────────────────────────────────────
+//
+// Regra de desconto criada pelo Gerente: percentual liberado por grupo e/ou
+// subgrupo de produto e/ou representante, com vigência. Campos nulos = "todos".
+
+model RegraDesconto {
+  id          Int      @id @default(autoincrement())
+  idEmpresa   Int      @map("id_empresa")
+  descricao   String
+  codGrupo    Int?     @map("cod_grupo")
+  codSubgrupo Int?     @map("cod_subgrupo")
+  codVendedor Int?     @map("cod_vendedor")
+  descPct     Decimal  @db.Decimal(5, 2) @map("desc_pct")
+  dataInicio  DateTime @db.Date @map("data_inicio")
+  dataFim     DateTime @db.Date @map("data_fim")
+  ativa       Boolean  @default(true)
+  createdAt   DateTime @default(now()) @map("created_at")
+  createdBy   String   @map("created_by")
+
+  @@index([idEmpresa])
+  @@index([idEmpresa, dataFim])
+  @@map("regras_desconto")
+}
+
 // ─── Oportunidade (Funil de Vendas) ──────────────────────────────────────────
 //
 // Oportunidade de venda do representante. Pode referenciar cliente ERP (id_cliente)

apps/api/src/app/politicas/politicas.controller.ts

@@ -14,17 +14,27 @@ import {
   UpsertDescontoBodySchema,
   CreatePromocaoBodySchema,
   UpdatePromocaoBodySchema,
+  CreateRegraDescontoBodySchema,
+  UpdateRegraDescontoBodySchema,
   type UpsertDescontoBody,
   type CreatePromocaoBody,
   type UpdatePromocaoBody,
+  type CreateRegraDescontoBody,
+  type UpdateRegraDescontoBody,
   type AlcadaDescontosResponse,
   type PromocoesResponse,
+  type PromocoesVigentesResponse,
+  type RegrasDescontoResponse,
+  type RegrasVigentesResponse,
+  type GruposProdutoResponse,
 } from '@sar/api-interface';
 import { PoliticasService } from './politicas.service';
 
 class UpsertDescontoDto extends createZodDto(UpsertDescontoBodySchema) {}
 class CreatePromocaoDto extends createZodDto(CreatePromocaoBodySchema) {}
 class UpdatePromocaoDto extends createZodDto(UpdatePromocaoBodySchema) {}
+class CreateRegraDescontoDto extends createZodDto(CreateRegraDescontoBodySchema) {}
+class UpdateRegraDescontoDto extends createZodDto(UpdateRegraDescontoBodySchema) {}
 
 @Controller({ path: 'politicas' })
 export class PoliticasController {
@@ -46,6 +56,11 @@ export class PoliticasController {
     return this.politicas.listPromocoes();
   }
 
+  @Get('promocoes/vigentes')
+  listPromocoesVigentes(): Promise<PromocoesVigentesResponse> {
+    return this.politicas.listPromocoesVigentes();
+  }
+
   @Post('promocoes')
   createPromocao(@Body() body: CreatePromocaoDto): Promise<{ id: number }> {
     return this.politicas.createPromocao(body as unknown as CreatePromocaoBody);
@@ -64,4 +79,38 @@ export class PoliticasController {
   deletePromocao(@Param('id', ParseIntPipe) id: number): Promise<void> {
     return this.politicas.deletePromocao(id);
   }
+
+  @Get('regras')
+  listRegras(): Promise<RegrasDescontoResponse> {
+    return this.politicas.listRegras();
+  }
+
+  @Get('regras/vigentes')
+  listRegrasVigentes(): Promise<RegrasVigentesResponse> {
+    return this.politicas.listRegrasVigentes();
+  }
+
+  @Post('regras')
+  createRegra(@Body() body: CreateRegraDescontoDto): Promise<{ id: number }> {
+    return this.politicas.createRegra(body as unknown as CreateRegraDescontoBody);
+  }
+
+  @Patch('regras/:id')
+  updateRegra(
+    @Param('id', ParseIntPipe) id: number,
+    @Body() body: UpdateRegraDescontoDto,
+  ): Promise<void> {
+    return this.politicas.updateRegra(id, body as unknown as UpdateRegraDescontoBody);
+  }
+
+  @Delete('regras/:id')
+  @HttpCode(204)
+  deleteRegra(@Param('id', ParseIntPipe) id: number): Promise<void> {
+    return this.politicas.deleteRegra(id);
+  }
+
+  @Get('grupos-produto')
+  listGruposProduto(): Promise<GruposProdutoResponse> {
+    return this.politicas.listGruposProduto();
+  }
 }

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

@@ -6,6 +6,12 @@ import type {
   PromocoesResponse,
   CreatePromocaoBody,
   UpdatePromocaoBody,
+  RegrasDescontoResponse,
+  CreateRegraDescontoBody,
+  UpdateRegraDescontoBody,
+  RegrasVigentesResponse,
+  PromocoesVigentesResponse,
+  GruposProdutoResponse,
 } from '@sar/api-interface';
 import type { WorkspaceClsStore } from '../workspace/workspace.types';
 
@@ -158,4 +164,219 @@ export class PoliticasService {
 
     await prisma.promocao.delete({ where: { id } });
   }
+
+  // ─── Regras de Desconto ─────────────────────────────────────────────────────
+
+  // Grupos/subgrupos distintos de vw_produtos (empresa matriz), para combos e
+  // resolução de nomes na listagem — UI sempre mostra o nome, nunca só o código.
+  private async loadGruposProduto(): Promise<
+    {
+      cod_grupo: number | null;
+      grupo: string | null;
+      cod_subgrupo: number | null;
+      subgrupo: string | null;
+    }[]
+  > {
+    const prisma = this.cls.get('prisma');
+    if (!prisma) throw new Error('prisma não disponível no CLS');
+    const idEmpresa = this.cls.get('idEmpresa');
+    const idMatriz = idEmpresa > 9000 ? idEmpresa - 9000 : idEmpresa;
+
+    return prisma.$queryRawUnsafe(
+      `SELECT DISTINCT cod_grupo, TRIM(grupo) AS grupo, cod_subgrupo, TRIM(subgrupo) AS subgrupo
+         FROM vw_produtos
+        WHERE id_empresa = ${idMatriz}
+          AND (cod_grupo IS NOT NULL OR cod_subgrupo IS NOT NULL)
+        ORDER BY grupo, subgrupo`,
+    );
+  }
+
+  async listGruposProduto(): Promise<GruposProdutoResponse> {
+    this.assertManager();
+    const rows = await this.loadGruposProduto();
+    return {
+      grupos: rows.map((r) => ({
+        codGrupo: r.cod_grupo != null ? Number(r.cod_grupo) : null,
+        grupo: r.grupo,
+        codSubgrupo: r.cod_subgrupo != null ? Number(r.cod_subgrupo) : null,
+        subgrupo: r.subgrupo,
+      })),
+    };
+  }
+
+  async listRegras(): Promise<RegrasDescontoResponse> {
+    this.assertManager();
+    const prisma = this.cls.get('prisma');
+    if (!prisma) throw new Error('prisma não disponível no CLS');
+    const idEmpresa = this.cls.get('idEmpresa');
+
+    const rows = await prisma.regraDesconto.findMany({
+      where: { idEmpresa },
+      orderBy: [{ dataFim: 'desc' }, { id: 'desc' }],
+    });
+
+    const codigos = [
+      ...new Set(rows.map((r) => r.codVendedor).filter((c): c is number => c != null)),
+    ];
+    const repRows =
+      codigos.length > 0
+        ? await prisma.$queryRawUnsafe<{ codigo: number; nome: string | null }[]>(
+            `SELECT codigo, nome FROM vw_representantes WHERE codigo IN (${codigos.join(',')})`,
+          )
+        : [];
+    const repNameMap = new Map(repRows.map((r) => [Number(r.codigo), r.nome]));
+
+    const grupos = rows.some((r) => r.codGrupo != null || r.codSubgrupo != null)
+      ? await this.loadGruposProduto()
+      : [];
+    const grupoNameMap = new Map(
+      grupos.filter((g) => g.cod_grupo != null).map((g) => [Number(g.cod_grupo), g.grupo]),
+    );
+    const subgrupoNameMap = new Map(
+      grupos.filter((g) => g.cod_subgrupo != null).map((g) => [Number(g.cod_subgrupo), g.subgrupo]),
+    );
+
+    return {
+      regras: rows.map((r) => ({
+        id: r.id,
+        descricao: r.descricao,
+        codGrupo: r.codGrupo,
+        grupo: r.codGrupo != null ? (grupoNameMap.get(r.codGrupo) ?? null) : null,
+        codSubgrupo: r.codSubgrupo,
+        subgrupo: r.codSubgrupo != null ? (subgrupoNameMap.get(r.codSubgrupo) ?? null) : null,
+        codVendedor: r.codVendedor,
+        nomeVendedor: r.codVendedor != null ? (repNameMap.get(r.codVendedor) ?? null) : null,
+        descPct: Number(r.descPct),
+        dataInicio: r.dataInicio.toISOString().slice(0, 10),
+        dataFim: r.dataFim.toISOString().slice(0, 10),
+        ativa: r.ativa,
+        createdAt: r.createdAt.toISOString(),
+        createdBy: r.createdBy,
+      })),
+    };
+  }
+
+  async createRegra(body: CreateRegraDescontoBody): Promise<{ id: number }> {
+    this.assertManager();
+    const prisma = this.cls.get('prisma');
+    if (!prisma) throw new Error('prisma não disponível no CLS');
+    const idEmpresa = this.cls.get('idEmpresa');
+    const userId = this.cls.get('userId') ?? 'system';
+
+    const r = await prisma.regraDesconto.create({
+      data: {
+        idEmpresa,
+        descricao: body.descricao,
+        codGrupo: body.codGrupo ?? null,
+        codSubgrupo: body.codSubgrupo ?? null,
+        codVendedor: body.codVendedor ?? null,
+        descPct: body.descPct,
+        dataInicio: new Date(body.dataInicio),
+        dataFim: new Date(body.dataFim),
+        createdBy: userId,
+      },
+    });
+    return { id: r.id };
+  }
+
+  async updateRegra(id: number, body: UpdateRegraDescontoBody): Promise<void> {
+    this.assertManager();
+    const prisma = this.cls.get('prisma');
+    if (!prisma) throw new Error('prisma não disponível no CLS');
+    const idEmpresa = this.cls.get('idEmpresa');
+
+    const exists = await prisma.regraDesconto.findFirst({ where: { id, idEmpresa } });
+    if (!exists) throw new NotFoundException('Regra de desconto não encontrada');
+
+    await prisma.regraDesconto.update({
+      where: { id },
+      data: {
+        ...(body.descricao !== undefined && { descricao: body.descricao }),
+        ...(body.codGrupo !== undefined && { codGrupo: body.codGrupo }),
+        ...(body.codSubgrupo !== undefined && { codSubgrupo: body.codSubgrupo }),
+        ...(body.codVendedor !== undefined && { codVendedor: body.codVendedor }),
+        ...(body.descPct !== undefined && { descPct: body.descPct }),
+        ...(body.dataInicio !== undefined && { dataInicio: new Date(body.dataInicio) }),
+        ...(body.dataFim !== undefined && { dataFim: new Date(body.dataFim) }),
+        ...(body.ativa !== undefined && { ativa: body.ativa }),
+      },
+    });
+  }
+
+  async deleteRegra(id: number): Promise<void> {
+    this.assertManager();
+    const prisma = this.cls.get('prisma');
+    if (!prisma) throw new Error('prisma não disponível no CLS');
+    const idEmpresa = this.cls.get('idEmpresa');
+
+    const exists = await prisma.regraDesconto.findFirst({ where: { id, idEmpresa } });
+    if (!exists) throw new NotFoundException('Regra de desconto não encontrada');
+
+    await prisma.regraDesconto.delete({ where: { id } });
+  }
+
+  // Promoções vigentes hoje — qualquer usuário autenticado. Usadas pelo rep para
+  // sinalizar no catálogo que o produto tem condição comercial diferenciada.
+  async listPromocoesVigentes(): Promise<PromocoesVigentesResponse> {
+    const prisma = this.cls.get('prisma');
+    if (!prisma) throw new Error('prisma não disponível no CLS');
+    const idEmpresa = this.cls.get('idEmpresa');
+    const idMatriz = idEmpresa > 9000 ? idEmpresa - 9000 : idEmpresa;
+
+    const hoje = new Date();
+    const rows = await prisma.promocao.findMany({
+      where: {
+        idEmpresa: { in: [idEmpresa, idMatriz] },
+        ativa: true,
+        dataInicio: { lte: hoje },
+        dataFim: { gte: hoje },
+      },
+      orderBy: [{ descPct: 'desc' }],
+    });
+
+    return {
+      promocoes: rows.map((p) => ({
+        id: p.id,
+        descricao: p.descricao,
+        codProduto: p.codProduto,
+        grpProd: p.grpProd,
+        descPct: Number(p.descPct),
+        dataFim: p.dataFim.toISOString().slice(0, 10),
+      })),
+    };
+  }
+
+  // Regras vigentes hoje para o usuário logado. Rep recebe só as regras que o
+  // alcançam (cod_vendedor nulo = todos, ou o próprio código); gerente vê todas.
+  async listRegrasVigentes(): Promise<RegrasVigentesResponse> {
+    const prisma = this.cls.get('prisma');
+    if (!prisma) throw new Error('prisma não disponível no CLS');
+    const idEmpresa = this.cls.get('idEmpresa');
+    const idMatriz = idEmpresa > 9000 ? idEmpresa - 9000 : idEmpresa;
+    const role = this.cls.get('role') ?? 'rep';
+    const codVendedor = parseInt(this.cls.get('userId') ?? '0', 10);
+
+    const hoje = new Date();
+    const rows = await prisma.regraDesconto.findMany({
+      where: {
+        idEmpresa: { in: [idEmpresa, idMatriz] },
+        ativa: true,
+        dataInicio: { lte: hoje },
+        dataFim: { gte: hoje },
+        ...(role === 'rep' ? { OR: [{ codVendedor: null }, { codVendedor }] } : {}),
+      },
+      orderBy: [{ descPct: 'desc' }],
+    });
+
+    return {
+      regras: rows.map((r) => ({
+        id: r.id,
+        descricao: r.descricao,
+        codGrupo: r.codGrupo,
+        codSubgrupo: r.codSubgrupo,
+        descPct: Number(r.descPct),
+        dataFim: r.dataFim.toISOString().slice(0, 10),
+      })),
+    };
+  }
 }