SESP/sgse-app
2
0
Fork 0
Code Issues 3 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

feat: enhance ata and objeto management by adding configuration options for quantity limits and usage tracking, improving data integrity and user feedback in pedidos

Browse Source
This commit is contained in:
killer-cf
2025-12-16 14:20:31 -03:00
parent fd2669aa4f
commit f90b27648f
8 changed files with 618 additions and 55 deletions
Download Patch File Download Diff File Expand all files Collapse all files

244
packages/backend/convex/pedidos.ts
View File

@@ -192,6 +192,152 @@ async function ensurePedidoModalidadeAtaConsistency(
}
}
type AtaObjetoUsageInfo = {
linkId: Id<'atasObjetos'>;
quantidadeTotal: number;
limitePercentual: number;
limitePermitido: number;
quantidadeUsada: number;
restante: number;
};
function normalizeLimitePercentual(value: number | undefined): number {
const fallback = 50;
if (value === undefined) return fallback;
if (!Number.isFinite(value)) return fallback;
// Normalizar para faixa 0..100
if (value < 0) return 0;
if (value > 100) return 100;
return value;
}
function computeLimitePermitido(quantidadeTotal: number, limitePercentual: number): number {
if (!Number.isFinite(quantidadeTotal) || quantidadeTotal <= 0) return 0;
const pct = normalizeLimitePercentual(limitePercentual);
return Math.floor(quantidadeTotal * (pct / 100));
}
async function getAtaObjetoLinkOrThrow(
ctx: MutationCtx,
ataId: Id<'atas'>,
objetoId: Id<'objetos'>
): Promise<Doc<'atasObjetos'>> {
const link = await ctx.db
.query('atasObjetos')
.withIndex('by_ataId_and_objetoId', (q) => q.eq('ataId', ataId).eq('objetoId', objetoId))
.unique();
if (!link) {
throw new Error('Esta ata não está vinculada a este objeto.');
}
return link;
}
async function computeQuantidadeUsadaFromDb(
ctx: MutationCtx,
ataId: Id<'atas'>,
objetoId: Id<'objetos'>
): Promise<number> {
const items = await ctx.db
.query('objetoItems')
.withIndex('by_ataId_and_objetoId', (q) => q.eq('ataId', ataId).eq('objetoId', objetoId))
.collect();
const sumByPedidoId = new Map<Id<'pedidos'>, number>();
for (const item of items) {
const prev = sumByPedidoId.get(item.pedidoId) ?? 0;
sumByPedidoId.set(item.pedidoId, prev + item.quantidade);
}
let total = 0;
for (const [pedidoId, sum] of sumByPedidoId.entries()) {
const pedido = await ctx.db.get(pedidoId);
if (pedido && pedido.status !== 'cancelado') {
total += sum;
}
}
return total;
}
async function getAtaObjetoUsageInfo(
ctx: MutationCtx,
ataId: Id<'atas'>,
objetoId: Id<'objetos'>,
requireConfigured: boolean
): Promise<AtaObjetoUsageInfo> {
const link = await getAtaObjetoLinkOrThrow(ctx, ataId, objetoId);
const quantidadeTotalRaw = link.quantidadeTotal;
const hasQuantidadeTotal =
quantidadeTotalRaw !== undefined &&
Number.isFinite(quantidadeTotalRaw) &&
quantidadeTotalRaw > 0;
if (requireConfigured && !hasQuantidadeTotal) {
throw new Error(
'Esta ata está vinculada ao objeto, mas a quantidade do produto na ata não foi configurada. Configure a quantidade/limite antes de usar esta ata.'
);
}
const limitePercentual = normalizeLimitePercentual(link.limitePercentual);
const quantidadeTotal = hasQuantidadeTotal ? (quantidadeTotalRaw as number) : 0;
const limitePermitido = computeLimitePermitido(quantidadeTotal, limitePercentual);
let quantidadeUsada = link.quantidadeUsada;
if (quantidadeUsada === undefined) {
quantidadeUsada = await computeQuantidadeUsadaFromDb(ctx, ataId, objetoId);
await ctx.db.patch(link._id, { quantidadeUsada });
}
const restante = Math.max(0, limitePermitido - quantidadeUsada);
return {
linkId: link._id,
quantidadeTotal,
limitePercentual,
limitePermitido,
quantidadeUsada,
restante
};
}
async function assertAtaObjetoCanConsume(
ctx: MutationCtx,
ataId: Id<'atas'>,
objetoId: Id<'objetos'>,
delta: number
) {
if (!Number.isFinite(delta) || delta <= 0) return;
const info = await getAtaObjetoUsageInfo(ctx, ataId, objetoId, true);
if (info.quantidadeUsada + delta > info.limitePermitido) {
throw new Error(
`Limite de uso da ata atingido para este objeto. Limite permitido: ${info.limitePermitido}. Usado: ${info.quantidadeUsada}. Tentativa de adicionar: ${delta}. Restante: ${info.restante}.`
);
}
}
async function applyAtaObjetoUsageDelta(
ctx: MutationCtx,
ataId: Id<'atas'>,
objetoId: Id<'objetos'>,
delta: number
) {
if (!Number.isFinite(delta) || delta === 0) return;
const info = await getAtaObjetoUsageInfo(ctx, ataId, objetoId, delta > 0);
const novoUsadoRaw = info.quantidadeUsada + delta;
const novoUsado = Math.max(0, novoUsadoRaw);
if (delta > 0 && novoUsado > info.limitePermitido) {
throw new Error(
`Limite de uso da ata atingido para este objeto. Limite permitido: ${info.limitePermitido}. Usado: ${info.quantidadeUsada}. Tentativa de adicionar: ${delta}. Restante: ${info.restante}.`
);
}
await ctx.db.patch(info.linkId, { quantidadeUsada: novoUsado });
}
async function isFuncionarioInComprasSector(
ctx: QueryCtx | MutationCtx,
funcionarioId: Id<'funcionarios'>
@@ -1194,6 +1340,10 @@ export const addItem = mutation({
// Em pedidos em análise, a inclusão de itens deve passar por fluxo de aprovação.
// Em rascunho ou aguardando aceite, a inclusão é direta, sem necessidade de aprovação.
if (pedido.status === 'em_analise') {
if (args.ataId) {
// Não altera consumo aqui (ainda é só solicitação), mas valida limite/configuração.
await assertAtaObjetoCanConsume(ctx, args.ataId, args.objetoId, args.quantidade);
}
await ctx.db.insert('solicitacoesItens', {
pedidoId: args.pedidoId,
tipo: 'adicao',
@@ -1234,6 +1384,9 @@ export const addItem = mutation({
);
if (existingItem) {
if (args.ataId) {
await applyAtaObjetoUsageDelta(ctx, args.ataId, args.objetoId, args.quantidade);
}
// Increment quantity
const novaQuantidade = existingItem.quantidade + args.quantidade;
await ctx.db.patch(existingItem._id, { quantidade: novaQuantidade });
@@ -1250,6 +1403,9 @@ export const addItem = mutation({
data: Date.now()
});
} else {
if (args.ataId) {
await applyAtaObjetoUsageDelta(ctx, args.ataId, args.objetoId, args.quantidade);
}
// Insert new item
await ctx.db.insert('objetoItems', {
pedidoId: args.pedidoId,
@@ -1302,8 +1458,14 @@ export const updateItemQuantity = mutation({
const pedido = await ctx.db.get(item.pedidoId);
if (!pedido) throw new Error('Pedido não encontrado.');
const delta = args.novaQuantidade - item.quantidade;
// --- CHECK ANALYSIS / ACCEPTANCE MODE ---
if (pedido.status === 'em_analise' || pedido.status === 'aguardando_aceite') {
if (delta > 0 && item.ataId) {
// Não altera consumo aqui (ainda é só solicitação), mas valida limite/configuração.
await assertAtaObjetoCanConsume(ctx, item.ataId, item.objetoId, delta);
}
await ctx.db.insert('solicitacoesItens', {
pedidoId: item.pedidoId,
tipo: 'alteracao_quantidade',
@@ -1324,6 +1486,11 @@ export const updateItemQuantity = mutation({
throw new Error('Apenas quem adicionou este item pode alterar a quantidade.');
}
// Atualiza consumo (ata+objeto) antes de persistir a nova quantidade
if (item.ataId) {
await applyAtaObjetoUsageDelta(ctx, item.ataId, item.objetoId, delta);
}
// Update quantity
await ctx.db.patch(args.itemId, { quantidade: args.novaQuantidade });
await ctx.db.patch(item.pedidoId, { atualizadoEm: Date.now() });
@@ -1371,6 +1538,10 @@ export const removeItem = mutation({
return;
}
if (item.ataId) {
await applyAtaObjetoUsageDelta(ctx, item.ataId, item.objetoId, -item.quantidade);
}
await ctx.db.delete(args.itemId);
await ctx.db.patch(item.pedidoId, { atualizadoEm: Date.now() });
@@ -1436,6 +1607,10 @@ export const removeItemsBatch = mutation({
throw new Error('Você só pode remover itens que você adicionou.');
}
if (item.ataId) {
await applyAtaObjetoUsageDelta(ctx, item.ataId, item.objetoId, -item.quantidade);
}
await ctx.db.delete(itemId);
await ctx.db.insert('historicoPedidos', {
@@ -1596,6 +1771,13 @@ export const updateItem = mutation({
// Em pedidos em análise ou aguardando aceite, geramos uma solicitação em vez de alterar diretamente
if (pedido.status === 'em_analise' || pedido.status === 'aguardando_aceite') {
const oldAtaId = oldValues.ataId;
const newAtaId = args.ataId;
if (newAtaId && newAtaId !== oldAtaId) {
// Não altera consumo aqui (ainda é só solicitação), mas valida limite/configuração.
await assertAtaObjetoCanConsume(ctx, newAtaId, item.objetoId, item.quantidade);
}
await ctx.db.insert('solicitacoesItens', {
pedidoId: item.pedidoId,
tipo: 'alteracao_detalhes',
@@ -1617,6 +1799,18 @@ export const updateItem = mutation({
return;
}
// Se a ata mudou, mover consumo entre vínculos (ata antiga -> nova ata)
const oldAtaId = oldValues.ataId;
const newAtaId = args.ataId;
if ((oldAtaId ?? null) !== (newAtaId ?? null)) {
if (newAtaId) {
await applyAtaObjetoUsageDelta(ctx, newAtaId, item.objetoId, item.quantidade);
}
if (oldAtaId) {
await applyAtaObjetoUsageDelta(ctx, oldAtaId, item.objetoId, -item.quantidade);
}
}
await ctx.db.patch(args.itemId, {
valorEstimado: args.valorEstimado,
modalidade: args.modalidade,
@@ -1696,8 +1890,7 @@ export const getPermissions = query({
const isCreator = pedido.criadoPor === user._id;
return {
canSendToAcceptance:
(pedido.status === 'em_rascunho' || pedido.status === 'precisa_ajustes') && hasAddedItems,
canSendToAcceptance: pedido.status === 'em_rascunho' && hasAddedItems,
canStartAnalysis: pedido.status === 'aguardando_aceite' && isInComprasSector,
canConclude: pedido.status === 'em_analise' && isInComprasSector,
canRequestAdjustments:
@@ -1726,7 +1919,7 @@ export const enviarParaAceite = mutation({
const pedido = await ctx.db.get(args.pedidoId);
if (!pedido) throw new Error('Pedido não encontrado.');
if (pedido.status !== 'em_rascunho' && pedido.status !== 'precisa_ajustes') {
if (pedido.status !== 'em_rascunho') {
throw new Error('Status inválido para envio.');
}
@@ -2015,6 +2208,18 @@ export const cancelarPedido = mutation({
const oldStatus = pedido.status;
const newStatus = 'cancelado';
// Ao cancelar, liberar consumo de todas as combinações (ataId,objetoId) deste pedido
const items = await ctx.db
.query('objetoItems')
.withIndex('by_pedidoId', (q) => q.eq('pedidoId', args.pedidoId))
.collect();
for (const item of items) {
if (item.ataId) {
await applyAtaObjetoUsageDelta(ctx, item.ataId, item.objetoId, -item.quantidade);
}
}
await ctx.db.patch(args.pedidoId, {
status: newStatus,
atualizadoEm: Date.now()
@@ -2253,6 +2458,10 @@ export const approveItemRequest = mutation({
i.modalidade === newItem.modalidade
);
if (newItem.ataId) {
await applyAtaObjetoUsageDelta(ctx, newItem.ataId, newItem.objetoId, newItem.quantidade);
}
if (existingItem) {
await ctx.db.patch(existingItem._id, {
quantidade: existingItem.quantidade + newItem.quantidade
@@ -2273,15 +2482,25 @@ export const approveItemRequest = mutation({
});
}
} else if (request.tipo === 'alteracao_quantidade') {
const { itemId, novaQuantidade } = data;
const item = await ctx.db.get(itemId);
const { itemId, novaQuantidade } = data as {
itemId: Id<'objetoItems'>;
novaQuantidade: number;
};
const item = (await ctx.db.get(itemId)) as Doc<'objetoItems'> | null;
if (item) {
const delta = novaQuantidade - item.quantidade;
if (item.ataId) {
await applyAtaObjetoUsageDelta(ctx, item.ataId, item.objetoId, delta);
}
await ctx.db.patch(itemId, { quantidade: novaQuantidade });
}
} else if (request.tipo === 'exclusao') {
const { itemId } = data;
const item = await ctx.db.get(itemId);
const { itemId } = data as { itemId: Id<'objetoItems'> };
const item = (await ctx.db.get(itemId)) as Doc<'objetoItems'> | null;
if (item) {
if (item.ataId) {
await applyAtaObjetoUsageDelta(ctx, item.ataId, item.objetoId, -item.quantidade);
}
await ctx.db.delete(itemId);
}
} else if (request.tipo === 'alteracao_detalhes') {
@@ -2306,6 +2525,17 @@ export const approveItemRequest = mutation({
itemId
);
const oldAtaId = ('ataId' in item ? item.ataId : undefined) ?? undefined;
const newAtaId = para.ataId;
if ((oldAtaId ?? null) !== (newAtaId ?? null)) {
if (newAtaId) {
await applyAtaObjetoUsageDelta(ctx, newAtaId, item.objetoId, item.quantidade);
}
if (oldAtaId) {
await applyAtaObjetoUsageDelta(ctx, oldAtaId, item.objetoId, -item.quantidade);
}
}
await ctx.db.patch(itemId, {
valorEstimado: para.valorEstimado,
modalidade: para.modalidade,