feat(quotes): anexo de conformidade ANATEL/RGC no PDF de oferta

Porta o anexo regulatório do legado (Resolução Anatel 765/2023, RGC,
recorte STFC) com fidelidade total ao conteúdo legal, incluindo a
seção de tarifação — em vez do html2canvas+jsPDF client-side do
legado, usa o Chromium server-side já construído para Documents.

Schema: products ganha service_type/metered/tariff_rates/has_ldi
(migration 1788525270647) — campos que a migration original de
products tinha deliberadamente deferido. Snapshot no item da oferta
na criação (nunca referência viva ao produto). Novo pacote
compartilhado packages/domain-shared/src/telecom para o catálogo de
tipos e legendas de tarifação.

Endpoint GET /v1/quotes/:id/anatel-pdf (400 sem item STFC), sempre
renderizado ao vivo (nunca cacheado, já que o conteúdo deriva de
updated_at). Frontend: campos de produto/oferta necessários +
"Baixar PDF ANATEL" na tela de detalhe da oferta. Inclui também o
botão de download de PDF em Documentos (endpoint já existia, faltava
o link na UI).

Verificado ao vivo através do container real: PDF gerado com
Chromium de verdade, texto extraído confere byte a byte com os
valores computados (multa, datas, tarifas, resumo financeiro).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BcWWuKfykGtUweXmHD6cKx
This commit is contained in:
2026-09-04 10:33:33 -03:00
parent 29430d0d96
commit ccac936372
26 changed files with 1321 additions and 20 deletions

View File

@@ -1,4 +1,7 @@
import { IsBoolean, IsNumber, IsOptional, IsString, Min, MinLength } from "class-validator";
import { IsBoolean, IsIn, IsNumber, IsOptional, IsString, Min, MinLength, ValidateNested } from "class-validator";
import { Type } from "class-transformer";
import { SERVICE_TYPES, type ServiceType } from "@eden/domain-shared";
import { TariffRatesDto } from "./tariff-rate.dto.js";
export class CreateProductDto {
@IsString()
@@ -33,4 +36,15 @@ export class CreateProductDto {
@IsOptional() @IsNumber() @Min(0) price36?: number;
@IsOptional() @IsNumber() @Min(0) price48?: number;
@IsOptional() @IsNumber() @Min(0) implUnitPrice?: number;
// Recorte regulatório RGC (Resolução Anatel 765/2023, ver
// packages/domain-shared/src/telecom/service-types.ts) — usado pelo
// anexo de conformidade ANATEL do PDF de oferta (apps/api/src/quotes/
// anatel-offer-template.ts). Snapshot no item da oferta no momento da
// criação, não referência viva ao produto.
@IsOptional() @IsIn(SERVICE_TYPES) serviceType?: ServiceType;
@IsOptional() @IsBoolean() metered?: boolean;
@IsOptional() @IsNumber() @Min(0) minutesAllowance?: number;
@IsOptional() @ValidateNested() @Type(() => TariffRatesDto) tariffRates?: TariffRatesDto;
@IsOptional() @IsBoolean() hasLdi?: boolean;
}

View File

@@ -0,0 +1,17 @@
import { IsNumber, IsOptional, Min, ValidateNested } from "class-validator";
import { Type } from "class-transformer";
export class TariffRateDto {
@IsNumber() @Min(0) normal!: number;
@IsNumber() @Min(0) reduced!: number;
}
/** One optional key per TARIFF_TYPES entry (LC/LDN/VC1/VC2/VC3/LDI) — validated by TariffRateDto below, not decorated individually since the set is derived from the shared catalog. */
export class TariffRatesDto {
@IsOptional() @ValidateNested() @Type(() => TariffRateDto) LC?: TariffRateDto;
@IsOptional() @ValidateNested() @Type(() => TariffRateDto) LDN?: TariffRateDto;
@IsOptional() @ValidateNested() @Type(() => TariffRateDto) VC1?: TariffRateDto;
@IsOptional() @ValidateNested() @Type(() => TariffRateDto) VC2?: TariffRateDto;
@IsOptional() @ValidateNested() @Type(() => TariffRateDto) VC3?: TariffRateDto;
@IsOptional() @ValidateNested() @Type(() => TariffRateDto) LDI?: TariffRateDto;
}

View File

@@ -1,8 +1,15 @@
import { Injectable, NotFoundException } from "@nestjs/common";
import { auditRepo, productsRepo, type Product } from "@eden/database";
import { emptyTariffRates, type TariffRates } from "@eden/domain-shared";
import type { CreateProductDto } from "./dto/create-product.dto.js";
import type { UpdateProductDto } from "./dto/update-product.dto.js";
/** DTO fields are individually optional (partial override); persisted tariff_rates always carries all 6 keys — mirrors the legacy's normalizeTariffRates(), never a partial object at rest. */
function normalizeTariffRates(partial: Partial<TariffRates> | undefined): TariffRates | undefined {
if (!partial) return undefined;
return { ...emptyTariffRates(), ...partial };
}
@Injectable()
export class ProductsService {
list(includeInactive: boolean): Promise<Product[]> {
@@ -36,6 +43,11 @@ export class ProductsService {
price36: dto.price36,
price48: dto.price48,
implUnitPrice: dto.implUnitPrice,
serviceType: dto.serviceType,
metered: dto.metered,
minutesAllowance: dto.minutesAllowance,
tariffRates: normalizeTariffRates(dto.tariffRates),
hasLdi: dto.hasLdi,
createdBy: actorId,
});
@@ -73,6 +85,11 @@ export class ProductsService {
price36: dto.price36,
price48: dto.price48,
implUnitPrice: dto.implUnitPrice,
serviceType: dto.serviceType,
metered: dto.metered,
minutesAllowance: dto.minutesAllowance,
tariffRates: normalizeTariffRates(dto.tariffRates),
hasLdi: dto.hasLdi,
});
if (!product) throw new NotFoundException("Produto não encontrado");

View File

@@ -0,0 +1,517 @@
/**
* Anexo de conformidade RGC (Regulamento Geral de Direitos do Consumidor
* de Serviços de Telecomunicações, Resolução Anatel nº 765/2023), recorte
* STFC — campos exigidos pelo art. 21 §3º (I a X) e arts. 26, 27, 36 a 39.
* Ported com fidelidade do legado (BackofficeAnatelPDFTemplate.jsx),
* porém como PDF autônomo (renderizado via Chromium server-side, ver
* packages/integrations/src/pdf/renderer.ts) em vez de anexo capturado
* client-side com html2canvas — e SEM o split automático software/
* não-software do legado (splitQuoteByServiceType.js): esta leva sempre
* gera um único documento cobrindo todos os itens da oferta. Se o negócio
* precisar do split (contratos separados para itens "Serviço software"),
* isso é trabalho futuro, não implementado aqui.
*
* Termos usados seguem o art. 3º do RGC: Prazo de Comercialização (inciso
* XI) é a janela em que a oferta fica disponível para contratação — NÃO é
* "Prazo de Oferta" (esse termo não existe no RGC). Prazo de Vigência
* (inciso XIII) é a duração do contrato a partir da contratação —
* corresponde ao período de fidelidade efetivo desta oferta.
*
* Campos sem fonte de dado institucional/jurídica confirmada (Handix ainda
* não definiu) usam o placeholder [A DEFINIR] — nunca um valor inventado.
*/
import type { Quote, QuoteItem, Reseller } from "@eden/database";
import {
formatCNPJ,
formatCPF,
getTariffTypesToShow,
TARIFF_DESCRIPTIONS,
TARIFF_EXTRA_NOTES,
} from "@eden/domain-shared";
import { computeQuotePricing, computeSavings, resolveEffectiveFidelity } from "./pricing.js";
export function hasStfcItem(items: QuoteItem[]): boolean {
return items.some((item) => item.serviceType === "STFC");
}
export interface ClientDocument {
cpf: string | null;
cnpj: string | null;
}
export interface AnatelOfferPdfInput {
quote: Quote;
reseller: Reseller;
clientDocument: ClientDocument;
}
const CANAIS_ATENDIMENTO = "(48) 3420-0969 ou 0800 048 0969";
export function buildAnatelOfferHtml(input: AnatelOfferPdfInput): string {
const { quote, reseller, clientDocument } = input;
const items = quote.items;
const stfc = hasStfcItem(items);
const pricing = computeQuotePricing({
items,
contractPeriod: quote.contract_period,
fidelityPeriod: quote.fidelity_period,
implGeral: Number(quote.impl_geral),
proposedMonthlyTotal: quote.proposed_monthly_total != null ? Number(quote.proposed_monthly_total) : null,
});
const fidelityPeriod = resolveEffectiveFidelity(quote.contract_period, quote.fidelity_period, quote.approval_status);
const savings = computeSavings(
items,
quote.contract_period,
fidelityPeriod,
pricing.monthlyTotal,
quote.proposed_monthly_total != null ? Number(quote.proposed_monthly_total) : null,
);
const updatedDate = quote.updated_at;
const comercializacaoInicio = formatDateBR(updatedDate);
const comercializacaoFim = formatDateBR(addDays(updatedDate, 10));
const nomeOferta = fidelityPeriod === 0 ? "Oferta sem fidelidade" : `Oferta com fidelidade de ${fidelityPeriod} meses`;
const codigoIdentificacao = quote.quote_number ? escapeHtml(quote.quote_number) : placeholder("ID");
const clientLabel = quote.client_company ? quote.client_company : quote.client_name;
const clientDoc = clientDocument.cnpj
? formatCNPJ(clientDocument.cnpj)
: clientDocument.cpf
? formatCPF(clientDocument.cpf)
: placeholder("CPF/CNPJ");
const meteredItems = items.filter((item) => item.metered);
return `
<!doctype html>
<html>
<head>
<meta charset="utf-8" />
<style>${css()}</style>
</head>
<body>
<div class="page">
${renderHeader(quote)}
${renderClientBlock(clientLabel, clientDoc, quote)}
${renderPlanBox(quote, fidelityPeriod)}
${renderSavingsBox(savings)}
${renderItemsTable(items, pricing)}
${stfc ? `<p class="tech-note">A tecnologia utilizada para entrega das chamadas do serviço STFC ofertado é VoIP.</p>` : ""}
${meteredItems.length > 0 ? renderTariffSection(meteredItems) : ""}
${pricing.hasSpecialPrice ? renderSpecialConditionBox(quote, pricing) : ""}
${pricing.totalImpl > 0 ? renderImplementationBox(pricing, quote) : ""}
<div class="two-col">
${stfc ? renderRgcBox({ codigoIdentificacao, nomeOferta, comercializacaoInicio, comercializacaoFim, fidelityPeriod, savings }) : "<div></div>"}
${renderFinancialSummaryBox({ quote, reseller, pricing, savings, nomeOferta })}
</div>
${quote.notes ? `<div class="notes"><strong>Observações:</strong> ${escapeHtml(quote.notes)}</div>` : ""}
${renderSignatures(quote, reseller)}
${renderFooter(comercializacaoInicio, comercializacaoFim)}
</div>
</body>
</html>`;
}
function renderHeader(quote: Quote): string {
const today = formatDateBR(new Date());
return `
<div class="header">
<div>
<div class="brand">Handix do Brasil</div>
<div class="brand-sub">0800 048 0969</div>
</div>
<div class="header-right">
<div class="oferta-title">OFERTA</div>
<div>#${escapeHtml(quote.quote_number)}</div>
<div>${today}</div>
</div>
</div>`;
}
function renderClientBlock(clientLabel: string, clientDoc: string, quote: Quote): string {
return `
<div class="section client-block">
<div class="section-label">Cliente</div>
<div class="client-name">${escapeHtml(clientLabel)}</div>
<div>${clientDoc}</div>
${quote.client_email ? `<div>${escapeHtml(quote.client_email)}</div>` : ""}
<div>${escapeHtml(quote.client_phone)}</div>
</div>`;
}
function renderPlanBox(quote: Quote, fidelityPeriod: number): string {
const periodLabel = quote.contract_period > 0 ? `${quote.contract_period} meses` : "S/F (Sem Fidelidade)";
const reduced = quote.fidelity_period != null && quote.approval_status === "approved";
return `
<div class="box plan-box">
<div class="box-title">Plano contratado</div>
<div>${periodLabel}</div>
${reduced ? `<span class="badge badge-info">Fidelidade reduzida: ${fidelityPeriod} meses (aprovada)</span>` : ""}
</div>`;
}
function renderSavingsBox(savings: ReturnType<typeof computeSavings>): string {
return `
<div class="box savings-box">
<div class="box-title">Economia Mensal</div>
<div class="savings-value">${money(savings.totalEconomiaMensal)} /mês</div>
</div>`;
}
function renderItemsTable(items: QuoteItem[], pricing: ReturnType<typeof computeQuotePricing>): string {
const showSpecial = pricing.hasSpecialPrice;
const groups = groupByServiceType(items);
const groupTables = Array.from(groups.entries())
.map(([serviceType, groupItems]) => {
const rows = groupItems
.map((item) => renderItemRow(item, pricing, showSpecial))
.join("");
const subtotal = round2(groupItems.reduce((sum, item) => sum + item.total, 0));
return `
<table class="items-table">
<caption>${escapeHtml(serviceType)}</caption>
<thead>
<tr>
<th>Item</th><th>Qtd</th><th>S/F Unit.</th><th>Preço Unit.</th>
<th>Desc.Fid./un</th><th>Tot.Desc.Fid.</th>
${showSpecial ? "<th>Desc.Esp./un</th><th>Tot.Desc.Esp.</th>" : ""}
<th>Tot.Desc.</th>
${showSpecial ? "<th>Preço Final/un</th>" : ""}
<th>Total Contr.</th>
${showSpecial ? "<th>Total Final</th>" : ""}
</tr>
</thead>
<tbody>${rows}</tbody>
<tfoot><tr><td colspan="${showSpecial ? 11 : 8}">Subtotal: ${money(subtotal)}</td></tr></tfoot>
</table>`;
})
.join("");
const total = round2(items.reduce((sum, item) => sum + item.total, 0));
return `
<div class="section">
<div class="section-label">Detalhamento de Itens e Descontos</div>
${groupTables}
<div class="grand-total">Total Geral da Oferta: ${money(total)}</div>
</div>`;
}
function renderItemRow(item: QuoteItem, pricing: ReturnType<typeof computeQuotePricing>, showSpecial: boolean): string {
const semFidUnit = item.price0 ?? item.unitPrice;
const descFidUnit = round2(semFidUnit - item.unitPrice);
const totDescFid = round2(descFidUnit * item.quantity);
let specialCells = "";
let totDesc = totDescFid;
let finalUnit = item.unitPrice;
let totalFinal = item.total;
if (showSpecial && pricing.monthlyTotal > 0) {
const itemSpecialDiscTotal = round2((item.total / pricing.monthlyTotal) * pricing.diffMonthly);
const specialUnit = round2(itemSpecialDiscTotal / item.quantity);
totDesc = round2(totDescFid + itemSpecialDiscTotal);
finalUnit = round2(item.unitPrice - specialUnit);
totalFinal = round2(item.total - itemSpecialDiscTotal);
specialCells = `<td>${money(specialUnit)}</td><td>${money(itemSpecialDiscTotal)}</td>`;
}
return `
<tr>
<td>${escapeHtml(item.productName)}</td>
<td>${item.quantity}</td>
<td>${money(semFidUnit)}</td>
<td>${money(item.unitPrice)}</td>
<td>${money(descFidUnit)}</td>
<td>${money(totDescFid)}</td>
${specialCells}
<td>${money(totDesc)}</td>
${showSpecial ? `<td>${money(finalUnit)}</td>` : ""}
<td>${money(item.total)}</td>
${showSpecial ? `<td>${money(totalFinal)}</td>` : ""}
</tr>`;
}
function renderTariffSection(meteredItems: QuoteItem[]): string {
const tables = meteredItems
.map((item) => {
const types = getTariffTypesToShow(item.hasLdi);
const rows = types
.map((type) => {
const rate = item.tariffRates[type];
return `<tr><td>${type}</td><td>${money(rate.normal)}</td><td>${money(rate.reduced)}</td></tr>`;
})
.join("");
const legend = types.map((type) => `<li><strong>${type}:</strong> ${TARIFF_DESCRIPTIONS[type]}</li>`).join("");
const franquia =
item.minutesAllowance != null ? `<div>Franquia de minutos: ${item.minutesAllowance}</div>` : "";
return `
<div class="tariff-block">
<div class="tariff-item-name">${escapeHtml(item.productName)}</div>
${franquia}
<table class="tariff-table">
<caption>TABELA DE TARIFAÇÃO (valor por minuto)</caption>
<thead><tr><th>Tipo</th><th>Normal</th><th>Reduzido</th></tr></thead>
<tbody>${rows}</tbody>
</table>
<ul class="tariff-legend">${legend}</ul>
</div>`;
})
.join("");
const notes = TARIFF_EXTRA_NOTES.map((note) => `<li>${escapeHtml(note)}</li>`).join("");
return `
<div class="section">
<div class="section-label">Tarifação</div>
${tables}
<ul class="tariff-notes">${notes}</ul>
</div>`;
}
function renderSpecialConditionBox(quote: Quote, pricing: ReturnType<typeof computeQuotePricing>): string {
let statusLabel: string;
let statusClass: string;
if (pricing.isMarkup) {
statusLabel = "ACRÉSCIMO APLICADO";
statusClass = "badge-warning";
} else if (quote.approval_status === "approved") {
statusLabel = "APROVADA";
statusClass = "badge-success";
} else if (quote.approval_status === "rejected") {
statusLabel = "RECUSADA";
statusClass = "badge-danger";
} else {
statusLabel = "AGUARDANDO APROVAÇÃO";
statusClass = "badge-warning";
}
return `
<div class="box special-condition-box">
<div class="box-title">Condição Especial <span class="badge ${statusClass}">${statusLabel}</span></div>
<div>Preço original: <span class="struck">${money(pricing.monthlyTotal)}</span></div>
<div>${pricing.isMarkup ? "Acréscimo" : "Desconto"}: ${money(Math.abs(pricing.diffMonthly))}</div>
<div>Preço efetivo: ${money(pricing.effectiveMonthly)}</div>
${quote.approval_notes ? `<div>Observação da aprovação: ${escapeHtml(quote.approval_notes)}</div>` : ""}
</div>`;
}
function renderImplementationBox(pricing: ReturnType<typeof computeQuotePricing>, quote: Quote): string {
return `
<div class="box">
<div class="box-title">Total Implantação (único)</div>
<div>${money(pricing.totalImpl)} — condição: ${escapeHtml(quote.impl_payment_condition)}</div>
</div>`;
}
function renderRgcBox(fields: {
codigoIdentificacao: string;
nomeOferta: string;
comercializacaoInicio: string;
comercializacaoFim: string;
fidelityPeriod: number;
savings: ReturnType<typeof computeSavings>;
}): string {
const { codigoIdentificacao, nomeOferta, comercializacaoInicio, comercializacaoFim, fidelityPeriod, savings } = fields;
const vigenciaText =
fidelityPeriod > 0
? `${fidelityPeriod} meses a partir da contratação`
: "Indeterminado (mín. 12 meses garantidos — art. 27, §único)";
const permanenciaText = fidelityPeriod > 0 ? `${fidelityPeriod} meses` : "Não há (oferta sem fidelidade)";
const multaText =
fidelityPeriod > 0
? `Proporcional ao tempo restante, limitada a ${money(savings.beneficioTotalFidelidade)} (benefício concedido)`
: "Não aplicável";
const dataBaseReajuste = `${formatMonthYearBR(new Date())} (última alteração da oferta)`;
const rows: Array<[string, string]> = [
["Código de Identificação Único", codigoIdentificacao],
["Nome Comercial da Oferta", escapeHtml(nomeOferta)],
["Prazo de Comercialização", `${comercializacaoInicio} a ${comercializacaoFim}`],
["Prazo de Vigência", vigenciaText],
["Prazo de Permanência", permanenciaText],
["Multa por Rescisão Antecipada", multaText],
["Critério de Reajuste", "Intervalo mínimo de 12 meses (art. 39)"],
["Data-base de Reajuste", dataBaseReajuste],
["Forma de Pagamento", "Pós-paga"],
["Área de Abrangência", "Nacional"],
["Canais de Atendimento", CANAIS_ATENDIMENTO],
];
return `
<div class="box rgc-box">
<div class="box-title">Conformidade RGC — Resolução Anatel nº 765/2023 (recorte STFC)</div>
<table class="kv-table">
${rows.map(([label, value]) => `<tr><th>${label}</th><td>${value}</td></tr>`).join("")}
</table>
</div>`;
}
function renderFinancialSummaryBox(params: {
quote: Quote;
reseller: Reseller;
pricing: ReturnType<typeof computeQuotePricing>;
savings: ReturnType<typeof computeSavings>;
nomeOferta: string;
}): string {
const { quote, reseller, pricing, savings, nomeOferta } = params;
const rows: Array<[string, string]> = [
["Total Mensal s/ fidelidade", money(pricing.monthlyTotal)],
["Desconto por fidelidade", money(savings.totalDescontoMensal)],
];
if (pricing.hasSpecialPrice) {
rows.push([pricing.isMarkup ? "Acréscimo especial" : "Desconto especial", money(Math.abs(pricing.diffMonthly))]);
}
rows.push(
["Total Mensal Contratado", money(pricing.effectiveMonthly)],
["Total Implantação", money(pricing.totalImpl)],
);
if (pricing.totalImpl > 0) {
rows.push(["Cond. Pagamento Implantação", escapeHtml(quote.impl_payment_condition)]);
}
rows.push(
["Nome da Oferta", escapeHtml(nomeOferta)],
["Abrangência Geográfica", "Nacional"],
["Revenda", escapeHtml(reseller.name)],
["Total do Contrato", money(Number(quote.contract_total))],
);
if (savings.economiaTotalContrato > 0) {
rows.push(["Economia total no contrato", money(savings.economiaTotalContrato)]);
}
return `
<div class="box financial-box">
<div class="box-title">Resumo Financeiro</div>
<table class="kv-table">
${rows.map(([label, value]) => `<tr><th>${label}</th><td>${value}</td></tr>`).join("")}
</table>
</div>`;
}
function renderSignatures(quote: Quote, reseller: Reseller): string {
const salesRep = quote.sales_rep_name ? escapeHtml(quote.sales_rep_name) : "Responsável Comercial";
return `
<div class="signatures">
<div class="signature">
<div class="signature-line"></div>
<div>${salesRep}</div>
<div>${escapeHtml(reseller.name)}</div>
<div class="small">Revendedor autorizado HANDIX</div>
</div>
<div class="signature">
<div class="signature-line"></div>
<div>${escapeHtml(quote.client_name)}</div>
<div class="small">Cliente</div>
</div>
</div>`;
}
function renderFooter(comercializacaoInicio: string, comercializacaoFim: string): string {
return `
<div class="footer">
<div>Prazo de Comercialização: ${comercializacaoInicio} a ${comercializacaoFim}</div>
<div>Handix do Brasil · 0800 048 0969</div>
</div>`;
}
function groupByServiceType(items: QuoteItem[]): Map<string, QuoteItem[]> {
const map = new Map<string, QuoteItem[]>();
for (const item of items) {
const key = item.serviceType ?? "Outros";
const bucket = map.get(key);
if (bucket) bucket.push(item);
else map.set(key, [item]);
}
return map;
}
function placeholder(label?: string): string {
const text = label ? `[A DEFINIR: ${label}]` : "[A DEFINIR]";
return `<span class="placeholder">${escapeHtml(text)}</span>`;
}
function money(value: number): string {
return `R$ ${value.toFixed(2).replace(".", ",")}`;
}
function round2(value: number): number {
return Math.round((value + Number.EPSILON) * 100) / 100;
}
function addDays(date: Date, days: number): Date {
return new Date(date.getTime() + days * 24 * 60 * 60 * 1000);
}
function formatDateBR(date: Date): string {
return new Intl.DateTimeFormat("pt-BR", { day: "2-digit", month: "2-digit", year: "numeric", timeZone: "UTC" }).format(
date,
);
}
function formatMonthYearBR(date: Date): string {
return new Intl.DateTimeFormat("pt-BR", { month: "2-digit", year: "numeric", timeZone: "UTC" }).format(date);
}
function escapeHtml(value: string): string {
return value
.replace(/&/g, "&amp;")
.replace(/</g, "&lt;")
.replace(/>/g, "&gt;")
.replace(/"/g, "&quot;")
.replace(/'/g, "&#39;");
}
// Font stack has no Google Fonts import deliberately — the renderer blocks
// every outbound request the page makes (see packages/integrations/src/
// pdf/renderer.ts), so an @import here would just silently fail to load.
function css(): string {
return `
@page { size: A4 portrait; margin: 12mm; }
* { box-sizing: border-box; }
body { font-family: 'Segoe UI', Arial, sans-serif; color: #2F3A4B; font-size: 10px; margin: 0; }
.page { width: 100%; }
.header { display: flex; justify-content: space-between; align-items: flex-start; border-bottom: 2px solid #0F766E; padding-bottom: 8px; margin-bottom: 10px; }
.brand { font-size: 16px; font-weight: 700; color: #0F766E; }
.brand-sub { color: #67707D; }
.header-right { text-align: right; }
.oferta-title { font-size: 14px; font-weight: 700; letter-spacing: 1px; }
.section { margin-bottom: 10px; }
.section-label { font-weight: 700; color: #0F766E; text-transform: uppercase; font-size: 9px; margin-bottom: 4px; }
.client-block .client-name { font-weight: 700; font-size: 12px; }
.box { border: 1px solid #E8E9EC; border-radius: 6px; padding: 8px 10px; margin-bottom: 10px; }
.box-title { font-weight: 700; margin-bottom: 6px; display: flex; align-items: center; gap: 6px; }
.plan-box, .savings-box { display: inline-block; width: 48%; vertical-align: top; }
.savings-box { margin-left: 2%; }
.savings-value { font-size: 14px; font-weight: 700; color: #059669; }
table { width: 100%; border-collapse: collapse; margin-bottom: 4px; }
.items-table caption, .tariff-table caption { text-align: left; font-weight: 700; padding: 4px 0; }
.items-table th, .items-table td, .tariff-table th, .tariff-table td { border: 1px solid #E8E9EC; padding: 3px 5px; text-align: right; font-size: 8.5px; }
.items-table th:first-child, .items-table td:first-child, .tariff-table th:first-child, .tariff-table td:first-child { text-align: left; }
.items-table tfoot td { text-align: right; font-weight: 700; background: #F8F9FA; }
.grand-total { text-align: right; font-weight: 700; font-size: 11px; margin-top: 4px; }
.tech-note { font-style: italic; color: #67707D; }
.tariff-block { margin-bottom: 8px; }
.tariff-item-name { font-weight: 700; }
.tariff-legend, .tariff-notes { font-size: 8px; color: #67707D; padding-left: 14px; margin: 4px 0; }
.special-condition-box .struck { text-decoration: line-through; color: #67707D; }
.badge { display: inline-block; padding: 1px 6px; border-radius: 4px; font-size: 8px; font-weight: 700; }
.badge-info { background: #DCEFFC; color: #0B91CD; }
.badge-success { background: #DAECE2; color: #059669; }
.badge-warning { background: #FAE7D9; color: #D97706; }
.badge-danger { background: #F8D9D5; color: #B91C1C; }
.two-col { display: flex; gap: 10px; margin-bottom: 10px; }
.two-col > div { flex: 1; }
.kv-table th { text-align: left; font-weight: 600; color: #67707D; width: 45%; padding: 2px 4px; border: none; }
.kv-table td { text-align: left; padding: 2px 4px; border: none; }
.placeholder { background: #fef3c7; padding: 1px 4px; border-radius: 3px; font-weight: 600; }
.notes { border-top: 1px solid #E8E9EC; padding-top: 6px; margin-bottom: 10px; }
.signatures { display: flex; justify-content: space-between; margin-top: 24px; }
.signature { width: 45%; text-align: center; }
.signature-line { border-top: 1px solid #2F3A4B; margin-bottom: 4px; }
.signature .small { color: #67707D; font-size: 8px; }
.footer { display: flex; justify-content: space-between; border-top: 1px solid #E8E9EC; padding-top: 6px; margin-top: 10px; color: #67707D; font-size: 8px; }
`;
}

View File

@@ -50,4 +50,6 @@ export class CreateQuoteDto {
@IsOptional() @IsIn(["À vista", "1+1", "1+2"]) implPaymentCondition?: string;
@IsOptional() @IsString() notes?: string;
/** Impresso no bloco de assinatura do PDF de oferta ANATEL — cai para "Responsável Comercial" quando ausente. */
@IsOptional() @IsString() salesRepName?: string;
}

View File

@@ -48,4 +48,5 @@ export class UpdateQuoteDto {
@IsOptional() @IsIn(["À vista", "1+1", "1+2"]) implPaymentCondition?: string;
@IsOptional() @IsString() @MinLength(0) notes?: string;
@IsOptional() @IsString() salesRepName?: string;
}

View File

@@ -1,4 +1,5 @@
import { Body, Controller, Get, Param, Patch, Post, Query, UseGuards } from "@nestjs/common";
import { Body, Controller, Get, Header, Param, Patch, Post, Query, Res, StreamableFile, UseGuards } from "@nestjs/common";
import type { Response } from "express";
import { ApiBearerAuth, ApiTags } from "@nestjs/swagger";
import { QuotesService } from "./quotes.service.js";
import { CreateQuoteDto } from "./dto/create-quote.dto.js";
@@ -43,6 +44,20 @@ export class QuotesController {
return this.quotes.create(dto, user);
}
/** Anexo de conformidade ANATEL/RGC (Resolução 765/2023) — 400 se a oferta não tiver item STFC. Renderizado ao vivo, nunca cacheado (ver doc comment em QuotesService.generateAnatelPdf). */
@Get(":id/anatel-pdf")
@RequirePermission("quotes", "view")
@Header("Content-Type", "application/pdf")
async downloadAnatelPdf(
@Param("id") id: string,
@CurrentUser() user: EdenAuthenticatedUser,
@Res({ passthrough: true }) res: Response,
) {
const pdf = await this.quotes.generateAnatelPdf(id, user);
res.set({ "Content-Disposition": `inline; filename="anatel-${id}.pdf"` });
return new StreamableFile(pdf);
}
@Patch(":id")
@RequirePermission("quotes", "edit")
update(

View File

@@ -7,11 +7,14 @@ import {
} from "@nestjs/common";
import {
auditRepo,
clientRegistrationsRepo,
productsRepo,
quotesRepo,
resellersRepo,
type Quote,
type QuoteItem,
} from "@eden/database";
import { renderPdf } from "@eden/integrations";
import type { EdenAuthenticatedUser } from "../auth/jwt-auth.guard.js";
import { maxGrantedScope } from "../auth/permissions.js";
import {
@@ -20,6 +23,7 @@ import {
getAvailablePaymentConditions,
resolveApprovalStatus,
} from "./pricing.js";
import { buildAnatelOfferHtml, hasStfcItem } from "./anatel-offer-template.js";
import type { CreateQuoteDto } from "./dto/create-quote.dto.js";
import type { UpdateQuoteDto } from "./dto/update-quote.dto.js";
import type { QuoteItemInputDto } from "./dto/quote-item-input.dto.js";
@@ -51,6 +55,40 @@ export class QuotesService {
return quote;
}
/**
* Anexo de conformidade ANATEL/RGC — sempre renderizado ao vivo a partir
* do estado atual da oferta (nunca cacheado/persistido como os
* documentos do módulo Documents), porque vários campos regulatórios
* são derivados de `updated_at` (Prazo de Comercialização, data-base de
* reajuste) — um PDF armazenado ficaria defasado assim que a oferta
* fosse editada de novo. 400 se a oferta não tiver nenhum item STFC: o
* documento inteiro existe para essa disclosure (art. 21 §3º do RGC),
* não faz sentido gerar um PDF "ANATEL" vazio de conteúdo regulatório.
*/
async generateAnatelPdf(id: string, user: EdenAuthenticatedUser): Promise<Buffer> {
const quote = await this.get(id, user);
if (!hasStfcItem(quote.items)) {
throw new BadRequestException(
"Esta oferta não tem nenhum item STFC — o anexo de conformidade ANATEL (RGC art. 21 §3º) só se aplica a ofertas com item STFC.",
);
}
const reseller = await resellersRepo.getResellerById(quote.reseller_id);
if (!reseller) throw new NotFoundException("Revenda da oferta não encontrada");
const clientDocument = { cpf: null as string | null, cnpj: null as string | null };
if (quote.client_registration_id) {
const registration = await clientRegistrationsRepo.getClientRegistrationById(quote.client_registration_id);
if (registration) {
clientDocument.cpf = registration.pf_cpf;
clientDocument.cnpj = registration.pj_cnpj;
}
}
const html = buildAnatelOfferHtml({ quote, reseller, clientDocument });
return renderPdf({ html });
}
async create(dto: CreateQuoteDto, user: EdenAuthenticatedUser): Promise<Quote> {
const items = await this.buildItems(dto.items, dto.contractPeriod);
const proposedMonthlyTotal = dto.proposedMonthlyTotal ?? null;
@@ -93,6 +131,7 @@ export class QuotesService {
approvalStatus,
implPaymentCondition,
notes: dto.notes ?? null,
salesRepName: dto.salesRepName ?? null,
createdBy: user.id,
});
@@ -166,6 +205,7 @@ export class QuotesService {
approvedById,
implPaymentCondition,
notes: dto.notes,
salesRepName: dto.salesRepName,
});
if (!quote) throw new NotFoundException("Oferta não encontrada");
@@ -303,6 +343,13 @@ export class QuotesService {
price24: product.price_24 != null ? Number(product.price_24) : null,
price36: product.price_36 != null ? Number(product.price_36) : null,
price48: product.price_48 != null ? Number(product.price_48) : null,
// Snapshot do produto no momento em que o item é adicionado — ver
// o doc comment de QuoteItem.serviceType em @eden/database.
serviceType: product.service_type,
metered: product.metered,
minutesAllowance: product.minutes_allowance != null ? Number(product.minutes_allowance) : null,
tariffRates: product.tariff_rates,
hasLdi: product.has_ldi,
});
}
return items;

View File

@@ -0,0 +1,172 @@
import { INestApplication } from "@nestjs/common";
import { afterAll, beforeAll, describe, expect, it, vi } from "vitest";
import { agent, bearer, closeTestApp, createTestApp, loginSuperAdmin, type AuthedTokens } from "./setup.js";
/**
* `renderPdf` is mocked (real call path through quotes.service.ts still
* runs) — what's under test is the ANATEL/RGC annex's computed content
* (anatel-offer-template.ts), not Chromium itself (covered by the
* documents-pdf.spec.ts suite + the manual smoke test in progress.md).
* Business-critical regulatory content: this asserts the actual HTML
* handed to the renderer contains the right computed fields, not just
* that the endpoint returns 200.
*/
const renderPdfMock = vi.fn(async (_input: { html: string }) => Buffer.from("%PDF-1.4 fake anatel pdf"));
vi.mock("@eden/integrations", () => ({
renderPdf: (input: { html: string }) => renderPdfMock(input),
}));
describe("quotes — anexo de conformidade ANATEL/RGC", () => {
let app: INestApplication;
let admin: AuthedTokens;
let resellerId: string;
let stfcProductId: string;
let pabxProductId: string;
beforeAll(async () => {
app = await createTestApp();
admin = await loginSuperAdmin(app);
const reseller = await agent(app)
.post("/api/v1/resellers")
.set(...bearer(admin.accessToken))
.send({ name: "qa-test- Revenda ANATEL" })
.expect(201);
resellerId = reseller.body.id;
const stfcProduct = await agent(app)
.post("/api/v1/products")
.set(...bearer(admin.accessToken))
.send({
name: "qa-test- Linha STFC",
productType: "service",
price0: 200,
price12: 150,
serviceType: "STFC",
metered: true,
minutesAllowance: 100,
hasLdi: true,
tariffRates: {
LC: { normal: 0.1, reduced: 0.1 },
LDN: { normal: 0.2, reduced: 0.2 },
VC1: { normal: 0.15, reduced: 0.15 },
VC2: { normal: 0.25, reduced: 0.25 },
VC3: { normal: 0.3, reduced: 0.3 },
LDI: { normal: 1.5, reduced: 1.5 },
},
})
.expect(201);
stfcProductId = stfcProduct.body.id;
expect(stfcProduct.body.service_type).toBe("STFC");
expect(stfcProduct.body.tariff_rates.LC).toEqual({ normal: 0.1, reduced: 0.1 });
const pabxProduct = await agent(app)
.post("/api/v1/products")
.set(...bearer(admin.accessToken))
.send({ name: "qa-test- Ramal PABX", productType: "service", price0: 50, serviceType: "Serviço PABX" })
.expect(201);
pabxProductId = pabxProduct.body.id;
});
afterAll(async () => {
await agent(app)
.patch(`/api/v1/products/${stfcProductId}`)
.set(...bearer(admin.accessToken))
.send({ active: false })
.expect(200);
await agent(app)
.patch(`/api/v1/products/${pabxProductId}`)
.set(...bearer(admin.accessToken))
.send({ active: false })
.expect(200);
await agent(app)
.patch(`/api/v1/resellers/${resellerId}`)
.set(...bearer(admin.accessToken))
.send({ active: false })
.expect(200);
await closeTestApp(app);
});
it("snapshots service_type/metered/tariffRates onto the quote item at creation", async () => {
const quote = await agent(app)
.post("/api/v1/quotes")
.set(...bearer(admin.accessToken))
.send({
resellerId,
clientName: "qa-test Cliente ANATEL",
clientPhone: "11999998888",
contractPeriod: 12,
items: [{ productId: stfcProductId, quantity: 2 }],
salesRepName: "qa-test Vendedor",
})
.expect(201);
const item = quote.body.items[0];
expect(item.serviceType).toBe("STFC");
expect(item.metered).toBe(true);
expect(item.hasLdi).toBe(true);
expect(item.tariffRates.LC).toEqual({ normal: 0.1, reduced: 0.1 });
expect(item.minutesAllowance).toBe(100);
});
it("renders the RGC annex with the right computed fields for an STFC quote", async () => {
renderPdfMock.mockClear();
const quote = await agent(app)
.post("/api/v1/quotes")
.set(...bearer(admin.accessToken))
.send({
resellerId,
clientName: "qa-test Cliente ANATEL 2",
clientPhone: "11999998888",
contractPeriod: 12,
items: [{ productId: stfcProductId, quantity: 1 }],
salesRepName: "qa-test Vendedor",
})
.expect(201);
const download = await agent(app)
.get(`/api/v1/quotes/${quote.body.id}/anatel-pdf`)
.set(...bearer(admin.accessToken))
.expect(200);
expect(download.headers["content-type"]).toBe("application/pdf");
expect(renderPdfMock).toHaveBeenCalledTimes(1);
const html = renderPdfMock.mock.calls[0]![0].html;
// Legal-basis section only renders because the quote has an STFC item.
expect(html).toContain("Conformidade RGC — Resolução Anatel nº 765/2023");
expect(html).toContain("Prazo de Comercialização");
expect(html).toContain(quote.body.quote_number);
expect(html).toContain("qa-test Cliente ANATEL 2");
expect(html).toContain("qa-test Vendedor");
// Tariff section, since the item is metered.
expect(html).toContain("TABELA DE TARIFAÇÃO");
expect(html).toContain("LDI");
expect(html).toContain("A tecnologia utilizada para entrega das chamadas do serviço STFC ofertado é VoIP.");
// Fixed regulatory fields.
expect(html).toContain("Pós-paga");
expect(html).toContain("Nacional");
expect(html).toContain("Intervalo mínimo de 12 meses");
});
it("rejects (400) a quote with no STFC item", async () => {
const quote = await agent(app)
.post("/api/v1/quotes")
.set(...bearer(admin.accessToken))
.send({
resellerId,
clientName: "qa-test Cliente Sem STFC",
clientPhone: "11999998888",
contractPeriod: 0,
items: [{ productId: pabxProductId, quantity: 1 }],
})
.expect(201);
const res = await agent(app)
.get(`/api/v1/quotes/${quote.body.id}/anatel-pdf`)
.set(...bearer(admin.accessToken))
.expect(400);
expect(res.body.message).toContain("STFC");
});
});