Refactor budget repository and handlers, add new budget features

.gitignore

@@ -49,13 +49,6 @@ nuget.config
 .vs/
 *.rsuser
 
-# User-specific files
-*.rsuser
-*.suo
-*.user
-*.userosscache
-*.sln.docstates
-
 # OS
 .DS_Store
 Thumbs.db
@@ -69,12 +62,8 @@ appsettings.Production.json
 # Logs
 logs/
 
+
 # Copilot instructions
 .github/copilot-instructions.md
-# Squad: ignore runtime state (logs, inbox, sessions)
-.squad/orchestration-log/
-.squad/log/
-.squad/decisions/inbox/
-.squad/sessions/
-# Squad: SubSquad activation file (local to this machine)
-.squad-workstream
+.agents
+.antigravitycli

README.md

@@ -460,8 +460,69 @@ Cria um novo usuário na plataforma.
 - Documento deve ser único no sistema.
 - Senha é armazenada como hash **Argon2id** — nunca em texto puro.
 
+### Orçamentos
+
+#### `PUT /api/v1/budgets/{id}/finalize` — Finalizar orçamento
+
+Muda o status do orçamento de `Draft` para `Finalized`. O orçamento deve ter pelo menos um item e pertencer ao usuário autenticado. Uma vez finalizado, o orçamento torna-se somente leitura e não pode mais ser editado.
+
+**Headers obrigatórios:**
+```
+Authorization: Bearer <token>
+```
+
+**Respostas:**
+
+| Status | Descrição |
+|---|---|
+| `204 NoContent` | Orçamento finalizado com sucesso |
+| `400 Bad Request` | Orçamento não está em rascunho ou não contém itens (lança DomainException) |
+| `401 Unauthorized` | Token ausente ou inválido |
+| `404 Not Found` | Orçamento não encontrado ou não pertence ao usuário |
+
 ---
 
+#### `PUT /api/v1/budgets/{id}/approve` — Aprovar orçamento
+
+Aprova um orçamento que foi finalizado ou tem PDF gerado.
+
+**Headers obrigatórios:**
+```
+Authorization: Bearer <token>
+```
+
+**Respostas:**
+
+| Status | Descrição |
+|---|---|
+| `204 NoContent` | Orçamento aprovado com sucesso |
+| `400 Bad Request` | Orçamento não está nos estados `Finalized` ou `PdfGenerated` (lança DomainException) |
+| `401 Unauthorized` | Token ausente ou inválido |
+| `404 Not Found` | Orçamento não encontrado ou não pertence ao usuário |
+
+---
+
+#### `PUT /api/v1/budgets/{id}/reject` — Rejeitar orçamento
+
+Rejeita um orçamento que foi finalizado ou tem PDF gerado.
+
+**Headers obrigatórios:**
+```
+Authorization: Bearer <token>
+```
+
+**Respostas:**
+
+| Status | Descrição |
+|---|---|
+| `204 NoContent` | Orçamento rejeitado com sucesso |
+| `400 Bad Request` | Orçamento não está nos estados `Finalized` ou `PdfGenerated` (lança DomainException) |
+| `401 Unauthorized` | Token ausente ou inválido |
+| `404 Not Found` | Orçamento não encontrado ou não pertence ao usuário |
+
+---
+
+
 
 
 ### CQRS com MediatR

scripts/seed-dev.cs

@@ -118,19 +118,19 @@
 
 // Orçamento 1: Construtora ABC — mix de material vinculado + item customizado
 var budget1 = Budget.Register(user.Id, clients[0].Id);
-budget1.AddItem(BudgetItem.Create(budget1.Id, materials[0].Id, "Cabo Flexível 2,5mm",
-    MaterialUnit.Metro, 50, 4.80m));
-budget1.AddItem(BudgetItem.Create(budget1.Id, materials[2].Id, "Tomada 2P+T", MaterialUnit.Unidade,
-    8, 18.50m));
-budget1.AddItem(BudgetItem.Create(budget1.Id, null, "Mão de obra elétrica", null, 1, 350.00m));
+budget1.AddItem(BudgetItem.Create(budget1.Id, materials[0].Id, BudgetItemType.Material,
+    MaterialUnit.Metro, 50, 4.80m, "Cabo Flexível 2,5mm"));
+budget1.AddItem(BudgetItem.Create(budget1.Id, materials[2].Id, BudgetItemType.Material, MaterialUnit.Unidade,
+    8, 18.50m, "Tomada 2P+T"));
+budget1.AddItem(BudgetItem.Create(budget1.Id, null, BudgetItemType.MaoDeObra, null, 1, 350.00m, "Mão de obra elétrica"));
 
 await db.Budgets.AddAsync(budget1);
 await db.SaveChangesAsync();
 
 // Orçamento 2: João da Silva — item customizado
 var budget2 = Budget.Register(user.Id, clients[1].Id);
-budget2.AddItem(BudgetItem.Create(budget2.Id, materials[3].Id, "Disjuntor 20A",
-    MaterialUnit.Unidade, 2, 32.00m));
+budget2.AddItem(BudgetItem.Create(budget2.Id, materials[3].Id, BudgetItemType.Material,
+    MaterialUnit.Unidade, 2, 32.00m, "Disjuntor 20A"));
 
 await db.Budgets.AddAsync(budget2);
 await db.SaveChangesAsync();

src/Voltiq.API/Controllers/Budgets/BudgetsController.cs

@@ -3,6 +3,10 @@
 using Voltiq.Application.Features.Budgets;
 using Voltiq.Application.Features.Budgets.Commands.DeleteBudget;
 using Voltiq.Application.Features.Budgets.Commands.RegisterBudget;
+using Voltiq.Application.Features.Budgets.Commands.UpdateBudget;
+using Voltiq.Application.Features.Budgets.Commands.FinalizeBudget;
+using Voltiq.Application.Features.Budgets.Commands.ApproveBudget;
+using Voltiq.Application.Features.Budgets.Commands.RejectBudget;
 using Voltiq.Application.Features.Budgets.Queries.GetBudgetById;
 using Voltiq.Application.Features.Budgets.Queries.GetBudgets;
 using Voltiq.Application.Mappings.Budgets;
@@ -67,4 +71,65 @@ public async Task<IActionResult> Delete(
 
         return result.Match(_ => NoContent(), ToErrorResult);
     }
+
+    /// <summary>Updates a budget (must belong to the authenticated user).</summary>
+    [HttpPut("{id:guid}")]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    public async Task<IActionResult> Update(
+        Guid id,
+        [FromBody] UpdateBudgetRequest request,
+        CancellationToken cancellationToken)
+    {
+        var result = await Sender.Send(request.ToCommand(id), cancellationToken);
+
+        return result.Match(_ => NoContent(), ToErrorResult);
+    }
+
+    /// <summary>Finalizes a budget, making it read-only.</summary>
+    [HttpPut("{id:guid}/finalize")]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    public async Task<IActionResult> Finalize(
+        Guid id,
+        CancellationToken cancellationToken)
+    {
+        var result = await Sender.Send(new FinalizeBudgetCommand(id), cancellationToken);
+
+        return result.Match(_ => NoContent(), ToErrorResult);
+    }
+
+    /// <summary>Approves a finalized budget.</summary>
+    [HttpPut("{id:guid}/approve")]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    public async Task<IActionResult> Approve(
+        Guid id,
+        CancellationToken cancellationToken)
+    {
+        var result = await Sender.Send(new ApproveBudgetCommand(id), cancellationToken);
+
+        return result.Match(_ => NoContent(), ToErrorResult);
+    }
+
+    /// <summary>Rejects a finalized budget.</summary>
+    [HttpPut("{id:guid}/reject")]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    public async Task<IActionResult> Reject(
+        Guid id,
+        CancellationToken cancellationToken)
+    {
+        var result = await Sender.Send(new RejectBudgetCommand(id), cancellationToken);
+
+        return result.Match(_ => NoContent(), ToErrorResult);
+    }
 }

src/Voltiq.Application/Features/Budgets/BudgetResponse.cs

@@ -25,6 +25,7 @@ public sealed record BudgetItemResponse(
     Guid Id,
     Guid? MaterialId,
     string MaterialName,
+    BudgetItemType Type,
     MaterialUnit? Unit,
     int Quantity,
     decimal UnitPrice,

src/Voltiq.Application/Features/Budgets/Commands/ApproveBudget/ApproveBudgetCommand.cs

@@ -0,0 +1,10 @@
+using ErrorOr;
+using MediatR;
+using Voltiq.Application.Common.Interfaces;
+
+namespace Voltiq.Application.Features.Budgets.Commands.ApproveBudget;
+
+public record ApproveBudgetCommand(Guid Id) : IAuthenticatedRequest<ErrorOr<Updated>>
+{
+    public Guid UserId { get; set; }
+}

src/Voltiq.Application/Features/Budgets/Commands/ApproveBudget/ApproveBudgetCommandHandler.cs

@@ -0,0 +1,29 @@
+using ErrorOr;
+using MediatR;
+using Voltiq.Domain.Interfaces;
+using Voltiq.Domain.Interfaces.Repositories.Budget;
+using Voltiq.Exceptions.Resources;
+
+namespace Voltiq.Application.Features.Budgets.Commands.ApproveBudget;
+
+public sealed class ApproveBudgetCommandHandler(
+    IBudgetUpdateOnlyRepository budgetUpdateOnly,
+    IUnitOfWork unitOfWork)
+    : IRequestHandler<ApproveBudgetCommand, ErrorOr<Updated>>
+{
+    public async Task<ErrorOr<Updated>> Handle(
+        ApproveBudgetCommand command, CancellationToken cancellationToken)
+    {
+        var budget = await budgetUpdateOnly.GetTrackedByIdAndUserIdAsync(
+            command.Id, command.UserId, cancellationToken);
+
+        if (budget is null)
+            return Error.NotFound(description: ResourceErrorMessages.ORCAMENTO_NAO_ENCONTRADO);
+
+        budget.Approve();
+
+        await unitOfWork.SaveChangesAsync(cancellationToken);
+
+        return Result.Updated;
+    }
+}

src/Voltiq.Application/Features/Budgets/Commands/FinalizeBudget/FinalizeBudgetCommand.cs

@@ -0,0 +1,10 @@
+using ErrorOr;
+using MediatR;
+using Voltiq.Application.Common.Interfaces;
+
+namespace Voltiq.Application.Features.Budgets.Commands.FinalizeBudget;
+
+public record FinalizeBudgetCommand(Guid Id) : IAuthenticatedRequest<ErrorOr<Updated>>
+{
+    public Guid UserId { get; set; }
+}

src/Voltiq.Application/Features/Budgets/Commands/FinalizeBudget/FinalizeBudgetCommandHandler.cs

@@ -0,0 +1,29 @@
+using ErrorOr;
+using MediatR;
+using Voltiq.Domain.Interfaces;
+using Voltiq.Domain.Interfaces.Repositories.Budget;
+using Voltiq.Exceptions.Resources;
+
+namespace Voltiq.Application.Features.Budgets.Commands.FinalizeBudget;
+
+public sealed class FinalizeBudgetCommandHandler(
+    IBudgetUpdateOnlyRepository budgetUpdateOnly,
+    IUnitOfWork unitOfWork)
+    : IRequestHandler<FinalizeBudgetCommand, ErrorOr<Updated>>
+{
+    public async Task<ErrorOr<Updated>> Handle(
+        FinalizeBudgetCommand command, CancellationToken cancellationToken)
+    {
+        var budget = await budgetUpdateOnly.GetTrackedByIdWithItemsAndUserIdAsync(
+            command.Id, command.UserId, cancellationToken);
+
+        if (budget is null)
+            return Error.NotFound(description: ResourceErrorMessages.ORCAMENTO_NAO_ENCONTRADO);
+
+        budget.FinalizeBudget();
+
+        await unitOfWork.SaveChangesAsync(cancellationToken);
+
+        return Result.Updated;
+    }
+}

src/Voltiq.Application/Features/Budgets/Commands/RegisterBudget/RegisterBudgetCommand.cs

@@ -14,6 +14,7 @@ public sealed record RegisterBudgetCommand(
 public sealed record RegisterBudgetItemCommand(
     Guid? MaterialId,
     string MaterialName,
+    BudgetItemType Type,
     MaterialUnit? Unit,
     int Quantity,
     decimal UnitPrice);

src/Voltiq.Application/Features/Budgets/Commands/RegisterBudget/RegisterBudgetCommandHandler.cs

@@ -27,7 +27,7 @@
             return Error.NotFound(description: ResourceErrorMessages.CLIENTE_NAO_ENCONTRADO);
 
         var materialLookup = new Dictionary<Guid, Material>();
         foreach (var item in command.Items.Where(i => i.MaterialId.HasValue))
         {
             var material = await materialReadOnly.GetByIdAndUserIdAsync(
                 item.MaterialId!.Value, command.UserId, cancellationToken);
@@ -43,8 +43,7 @@
         foreach (var item in command.Items)
         {
             var budgetItem = BudgetItem.Create(
-                budget.Id, item.MaterialId, item.MaterialName,
-                item.Unit, item.Quantity, item.UnitPrice);
+                budget.Id, item.MaterialId, item.Type, item.Unit, item.Quantity, item.UnitPrice, item.MaterialName);
 
             budget.AddItem(budgetItem);
         }

src/Voltiq.Application/Features/Budgets/Commands/RegisterBudget/RegisterBudgetCommandValidator.cs

@@ -1,4 +1,5 @@
 using FluentValidation;
+using Voltiq.Domain.Enums;
 using Voltiq.Exceptions.Resources;
 
 namespace Voltiq.Application.Features.Budgets.Commands.RegisterBudget;
@@ -21,6 +22,30 @@ public RegisterBudgetCommandValidator()
                 .NotEmpty()
                 .WithMessage(ResourceErrorMessages.ORCAMENTO_ITEM_NOME_OBRIGATORIO);
 
+            item.RuleFor(i => i.Type)
+                .IsInEnum()
+                .WithMessage(ResourceErrorMessages.ORCAMENTO_ITEM_TIPO_INVALIDO);
+
+            item.RuleFor(i => i.MaterialId)
+                .NotNull()
+                .When(i => i.Type == BudgetItemType.Material)
+                .WithMessage(ResourceErrorMessages.ORCAMENTO_ITEM_MATERIAL_ID_OBRIGATORIO_PARA_MATERIAL);
+
+            item.RuleFor(i => i.MaterialId)
+                .Null()
+                .When(i => i.Type != BudgetItemType.Material && Enum.IsDefined(i.Type))
+                .WithMessage(ResourceErrorMessages.ORCAMENTO_ITEM_MATERIAL_ID_DEVE_SER_NULO);
+
+            item.RuleFor(i => i.Unit)
+                .NotNull()
+                .When(i => i.Type == BudgetItemType.Material)
+                .WithMessage(ResourceErrorMessages.ORCAMENTO_ITEM_UNIDADE_OBRIGATORIA_PARA_MATERIAL);
+
+            item.RuleFor(i => i.Unit)
+                .Null()
+                .When(i => i.Type != BudgetItemType.Material && Enum.IsDefined(i.Type))
+                .WithMessage(ResourceErrorMessages.ORCAMENTO_ITEM_UNIDADE_DEVE_SER_NULA);
+
             item.RuleFor(i => i.Quantity)
                 .GreaterThan(0)
                 .WithMessage(ResourceErrorMessages.ORCAMENTO_ITEM_QUANTIDADE_INVALIDA);

src/Voltiq.Application/Features/Budgets/Commands/RegisterBudget/RegisterBudgetRequest.cs

@@ -9,6 +9,7 @@ public sealed record RegisterBudgetRequest(
 public sealed record RegisterBudgetItemRequest(
     Guid? MaterialId,
     string MaterialName,
+    BudgetItemType Type,
     MaterialUnit? Unit,
     int Quantity,
     decimal UnitPrice);

src/Voltiq.Application/Features/Budgets/Commands/RejectBudget/RejectBudgetCommand.cs

@@ -0,0 +1,10 @@
+using ErrorOr;
+using MediatR;
+using Voltiq.Application.Common.Interfaces;
+
+namespace Voltiq.Application.Features.Budgets.Commands.RejectBudget;
+
+public record RejectBudgetCommand(Guid Id) : IAuthenticatedRequest<ErrorOr<Updated>>
+{
+    public Guid UserId { get; set; }
+}

src/Voltiq.Application/Features/Budgets/Commands/RejectBudget/RejectBudgetCommandHandler.cs

@@ -0,0 +1,29 @@
+using ErrorOr;
+using MediatR;
+using Voltiq.Domain.Interfaces;
+using Voltiq.Domain.Interfaces.Repositories.Budget;
+using Voltiq.Exceptions.Resources;
+
+namespace Voltiq.Application.Features.Budgets.Commands.RejectBudget;
+
+public sealed class RejectBudgetCommandHandler(
+    IBudgetUpdateOnlyRepository budgetUpdateOnly,
+    IUnitOfWork unitOfWork)
+    : IRequestHandler<RejectBudgetCommand, ErrorOr<Updated>>
+{
+    public async Task<ErrorOr<Updated>> Handle(
+        RejectBudgetCommand command, CancellationToken cancellationToken)
+    {
+        var budget = await budgetUpdateOnly.GetTrackedByIdAndUserIdAsync(
+            command.Id, command.UserId, cancellationToken);
+
+        if (budget is null)
+            return Error.NotFound(description: ResourceErrorMessages.ORCAMENTO_NAO_ENCONTRADO);
+
+        budget.Reject();
+
+        await unitOfWork.SaveChangesAsync(cancellationToken);
+
+        return Result.Updated;
+    }
+}