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

packages/backend/convex/atas.ts

@@ -4,6 +4,21 @@ import type { Id } from './_generated/dataModel';
 import { getCurrentUserFunction } from './auth';
 import { internal } from './_generated/api';
 
+function normalizeLimitePercentual(value: number | undefined): number {
+	const fallback = 50;
+	if (value === undefined) return fallback;
+	if (!Number.isFinite(value)) return fallback;
+	if (value < 0) return 0;
+	if (value > 100) return 100;
+	return value;
+}
+
+function assertQuantidadeTotalValida(value: number) {
+	if (!Number.isFinite(value) || value <= 0) {
+		throw new Error('Quantidade do produto na ata deve ser maior que zero.');
+	}
+}
+
 export const list = query({
 	args: {
 		periodoInicio: v.optional(v.string()),
@@ -71,6 +86,34 @@ export const getObjetos = query({
 	}
 });
 
+export const getObjetosConfig = query({
+	args: { id: v.id('atas') },
+	returns: v.array(
+		v.object({
+			objetoId: v.id('objetos'),
+			quantidadeTotal: v.union(v.number(), v.null()),
+			limitePercentual: v.union(v.number(), v.null())
+		})
+	),
+	handler: async (ctx, args) => {
+		await ctx.runQuery(internal.permissoesAcoes.assertPermissaoAcaoAtual, {
+			recurso: 'atas',
+			acao: 'ver'
+		});
+
+		const links = await ctx.db
+			.query('atasObjetos')
+			.withIndex('by_ataId', (q) => q.eq('ataId', args.id))
+			.collect();
+
+		return links.map((l) => ({
+			objetoId: l.objetoId,
+			quantidadeTotal: l.quantidadeTotal ?? null,
+			limitePercentual: l.limitePercentual ?? null
+		}));
+	}
+});
+
 export const listByObjetoIds = query({
 	args: {
 		objetoIds: v.array(v.id('objetos'))
@@ -108,7 +151,13 @@ export const create = mutation({
 		dataFim: v.optional(v.string()),
 		empresaId: v.id('empresas'),
 		numeroSei: v.string(),
-		objetosIds: v.array(v.id('objetos'))
+		objetos: v.array(
+			v.object({
+				objetoId: v.id('objetos'),
+				quantidadeTotal: v.number(),
+				limitePercentual: v.optional(v.number())
+			})
+		)
 	},
 	handler: async (ctx, args) => {
 		await ctx.runQuery(internal.permissoesAcoes.assertPermissaoAcaoAtual, {
@@ -131,10 +180,16 @@ export const create = mutation({
 		});
 
 		// Vincular objetos
-		for (const objetoId of args.objetosIds) {
+		for (const cfg of args.objetos) {
+			assertQuantidadeTotalValida(cfg.quantidadeTotal);
+			const limitePercentual = normalizeLimitePercentual(cfg.limitePercentual);
+
 			await ctx.db.insert('atasObjetos', {
 				ataId,
-				objetoId
+				objetoId: cfg.objetoId,
+				quantidadeTotal: cfg.quantidadeTotal,
+				limitePercentual,
+				quantidadeUsada: 0
 			});
 		}
 
@@ -150,7 +205,13 @@ export const update = mutation({
 		empresaId: v.id('empresas'),
 		dataInicio: v.optional(v.string()),
 		dataFim: v.optional(v.string()),
-		objetosIds: v.array(v.id('objetos'))
+		objetos: v.array(
+			v.object({
+				objetoId: v.id('objetos'),
+				quantidadeTotal: v.number(),
+				limitePercentual: v.optional(v.number())
+			})
+		)
 	},
 	handler: async (ctx, args) => {
 		await ctx.runQuery(internal.permissoesAcoes.assertPermissaoAcaoAtual, {
@@ -171,22 +232,71 @@ export const update = mutation({
 		});
 
 		// Atualizar objetos vinculados
-		// Primeiro remove todos os vínculos existentes
 		const existingLinks = await ctx.db
 			.query('atasObjetos')
 			.withIndex('by_ataId', (q) => q.eq('ataId', args.id))
 			.collect();
 
+		const existingByObjeto = new Map<Id<'objetos'>, (typeof existingLinks)[number]>();
 		for (const link of existingLinks) {
-			await ctx.db.delete(link._id);
+			existingByObjeto.set(link.objetoId, link);
 		}
 
-		// Adiciona os novos vínculos
-		for (const objetoId of args.objetosIds) {
-			await ctx.db.insert('atasObjetos', {
-				ataId: args.id,
-				objetoId
-			});
+		const desiredObjetoIds = new Set<Id<'objetos'>>(args.objetos.map((o) => o.objetoId));
+
+		// Upsert dos vínculos desejados (preserva quantidadeUsada quando já existe)
+		for (const cfg of args.objetos) {
+			assertQuantidadeTotalValida(cfg.quantidadeTotal);
+			const limitePercentual = normalizeLimitePercentual(cfg.limitePercentual);
+
+			const existing = existingByObjeto.get(cfg.objetoId);
+			if (existing) {
+				await ctx.db.patch(existing._id, {
+					quantidadeTotal: cfg.quantidadeTotal,
+					limitePercentual
+				});
+			} else {
+				await ctx.db.insert('atasObjetos', {
+					ataId: args.id,
+					objetoId: cfg.objetoId,
+					quantidadeTotal: cfg.quantidadeTotal,
+					limitePercentual,
+					quantidadeUsada: 0
+				});
+			}
+		}
+
+		// Remoção de vínculos não selecionados (somente se não houver uso em pedidos não-cancelados)
+		for (const link of existingLinks) {
+			if (desiredObjetoIds.has(link.objetoId)) continue;
+
+			const items = await ctx.db
+				.query('objetoItems')
+				.withIndex('by_ataId_and_objetoId', (q) =>
+					q.eq('ataId', args.id).eq('objetoId', link.objetoId)
+				)
+				.collect();
+
+			// Se existe qualquer item em pedido não cancelado, bloquear remoção do vínculo
+			let inUse = false;
+			const seenPedidos = new Set<Id<'pedidos'>>();
+			for (const item of items) {
+				if (seenPedidos.has(item.pedidoId)) continue;
+				seenPedidos.add(item.pedidoId);
+				const pedido = await ctx.db.get(item.pedidoId);
+				if (pedido && pedido.status !== 'cancelado') {
+					inUse = true;
+					break;
+				}
+			}
+
+			if (inUse) {
+				throw new Error(
+					'Não é possível remover este objeto da ata porque já existe uso em pedidos não cancelados.'
+				);
+			}
+
+			await ctx.db.delete(link._id);
 		}
 	}
 });

packages/backend/convex/objetos.ts

@@ -1,5 +1,6 @@
 import { v } from 'convex/values';
 import { mutation, query } from './_generated/server';
+import type { Id } from './_generated/dataModel';
 import { getCurrentUserFunction } from './auth';
 
 export const list = query({
@@ -145,6 +146,93 @@ export const getAtas = query({
 	}
 });
 
+export const getAtasComLimite = query({
+	args: { objetoId: v.id('objetos') },
+	returns: v.array(
+		v.object({
+			_id: v.id('atas'),
+			numero: v.string(),
+			numeroSei: v.string(),
+			dataInicio: v.union(v.string(), v.null()),
+			dataFim: v.union(v.string(), v.null()),
+			quantidadeTotal: v.union(v.number(), v.null()),
+			limitePercentual: v.number(),
+			quantidadeUsada: v.number(),
+			limitePermitido: v.number(),
+			restante: v.number(),
+			isLocked: v.boolean()
+		})
+	),
+	handler: async (ctx, args) => {
+		const links = await ctx.db
+			.query('atasObjetos')
+			.withIndex('by_objetoId', (q) => q.eq('objetoId', args.objetoId))
+			.collect();
+
+		const results = [];
+		for (const link of links) {
+			const ata = await ctx.db.get(link.ataId);
+			if (!ata) continue;
+
+			let quantidadeUsada = link.quantidadeUsada ?? 0;
+			if (link.quantidadeUsada === undefined) {
+				const items = await ctx.db
+					.query('objetoItems')
+					.withIndex('by_ataId_and_objetoId', (q) =>
+						q.eq('ataId', link.ataId).eq('objetoId', link.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;
+					}
+				}
+				quantidadeUsada = total;
+			}
+
+			const quantidadeTotal = link.quantidadeTotal ?? null;
+			const limitePercentualRaw = link.limitePercentual ?? 50;
+			const limitePercentual = Number.isFinite(limitePercentualRaw)
+				? Math.min(100, Math.max(0, limitePercentualRaw))
+				: 50;
+
+			const limitePermitido =
+				quantidadeTotal && quantidadeTotal > 0
+					? Math.floor(quantidadeTotal * (limitePercentual / 100))
+					: 0;
+
+			const restante = Math.max(0, limitePermitido - quantidadeUsada);
+			const isLocked =
+				!quantidadeTotal || quantidadeTotal <= 0 || quantidadeUsada >= limitePermitido;
+
+			results.push({
+				_id: ata._id,
+				numero: ata.numero,
+				numeroSei: ata.numeroSei,
+				dataInicio: ata.dataInicio ?? null,
+				dataFim: ata.dataFim ?? null,
+				quantidadeTotal,
+				limitePercentual,
+				quantidadeUsada,
+				limitePermitido,
+				restante,
+				isLocked
+			});
+		}
+
+		return results;
+	}
+});
+
 export const remove = mutation({
 	args: {
 		id: v.id('objetos')

packages/backend/convex/pedidos.ts

@@ -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,

packages/backend/convex/tables/atas.ts

@@ -18,10 +18,16 @@ export const atasTables = {
 
 	atasObjetos: defineTable({
 		ataId: v.id('atas'),
-		objetoId: v.id('objetos')
+		objetoId: v.id('objetos'),
+		// Configuração de limite de uso por (ataId, objetoId)
+		quantidadeTotal: v.optional(v.number()),
+		limitePercentual: v.optional(v.number()), // padrão lógico: 50
+		// Controle transacional para evitar corrida; se ausente, pode ser inicializado via rebuild.
+		quantidadeUsada: v.optional(v.number())
 	})
 		.index('by_ataId', ['ataId'])
-		.index('by_objetoId', ['objetoId']),
+		.index('by_objetoId', ['objetoId'])
+		.index('by_ataId_and_objetoId', ['ataId', 'objetoId']),
 
 	atasDocumentos: defineTable({
 		ataId: v.id('atas'),

packages/backend/convex/tables/pedidos.ts

@@ -46,6 +46,7 @@ export const pedidosTables = {
 	})
 		.index('by_pedidoId', ['pedidoId'])
 		.index('by_objetoId', ['objetoId'])
+		.index('by_ataId_and_objetoId', ['ataId', 'objetoId'])
 		.index('by_adicionadoPor', ['adicionadoPor'])
 		.index('by_acaoId', ['acaoId']),