2 Commits

Author SHA1 Message Date
Sheila
d8b67fc281 feat: retornar WorkshopResponseDTO no GetById e GetAllAsync 2025-09-10 13:24:26 -03:00
Sheila
e780f5c99c feat: implemetar até parte 3 2025-09-09 20:16:58 -03:00
11 changed files with 212 additions and 45 deletions

View File

@@ -1,8 +1,9 @@
using CampusWorkshops.Api.Dtos;
using CampusWorkshops.Api.Models;
using CampusWorkshops.Api.Repositories;
using FluentValidation;
using Microsoft.AspNetCore.Mvc;
using Workshop10_API.Validation;
namespace CampusWorkshops.Api.Controllers;
@@ -11,30 +12,82 @@ namespace CampusWorkshops.Api.Controllers;
public class WorkshopsController : ControllerBase
{
private readonly IWorkshopRepository _repo;
public WorkshopsController(IWorkshopRepository repo) => _repo = repo;
/// <summary>Lista workshops com filtros opcionais.</summary>
[HttpGet]
public Task<IActionResult> GetAll([FromQuery] DateTimeOffset? from, [FromQuery] DateTimeOffset? to, [FromQuery] string? q, CancellationToken ct)
public async Task<IActionResult> GetAll([FromQuery] DateTimeOffset? from, [FromQuery] DateTimeOffset? to, [FromQuery] string? q, CancellationToken ct)
{
// TODO: implementar usando _repo.GetAllAsync e mapear para WorkshopResponse
return Task.FromResult<IActionResult>(Ok(Array.Empty<WorkshopResponse>()));
var workshops = await _repo.GetAllAsync(from, to, q, ct);
if (!workshops.Any())
return NoContent();
var workshopDTOs = workshops.Select(w => ConvertToWorkshopResponseDTO(w)).ToList();
return Ok(workshopDTOs);
}
/// <summary>Obtém um workshop por Id.</summary>
[HttpGet("{id:guid}")]
public Task<IActionResult> GetById(Guid id, CancellationToken ct)
public async Task<IActionResult> GetById(Guid id, CancellationToken ct)
{
// TODO: implementar usando _repo.GetByIdAsync
return Task.FromResult<IActionResult>(NotFound());
var workshop = await _repo.GetByIdAsync(id, ct);
if (workshop == null)
return NoContent();
return Ok(ConvertToWorkshopResponseDTO(workshop));
}
/// <summary>Cria um novo workshop.</summary>
[HttpPost]
public Task<IActionResult> Create([FromBody] CreateWorkshopRequest body, CancellationToken ct)
public async Task<IActionResult> Create([FromBody] CreateWorkshopRequestDTO workshopDTO, CancellationToken ct)
{
// TODO: validar ModelState, regras de negócio e chamar _repo.AddAsync; retornar CreatedAtAction
return Task.FromResult<IActionResult>(BadRequest());
var dtoValidator = new WorkshopRequestDTOValidator();
var validationResult = await dtoValidator.ValidateAsync(workshopDTO);
if (!validationResult.IsValid)
{
var erros = validationResult.Errors.Select(e => new { e.PropertyName, e.ErrorMessage });
return BadRequest(erros);
}
Workshop workshop = new Workshop
{
Capacity = workshopDTO.Capacity,
Description = workshopDTO.Description,
EndAt = workshopDTO.EndAt,
IsOnline = workshopDTO.IsOnline,
Location = workshopDTO.Location,
StartAt = workshopDTO.StartAt,
Title = workshopDTO.Title
};
var result = await _repo.AddAsync(workshop, ct);
if (result != null)
return CreatedAtAction(nameof(GetById), new { workshopDTO });
return BadRequest();
}
[HttpDelete]
public async Task<IActionResult> Delete(Guid id, CancellationToken ct)
{
var result = await _repo.DeleteAsync(id, ct);
if(result)
return NoContent();
return NotFound();
}
private WorkshopResponseDTO ConvertToWorkshopResponseDTO(Workshop workshop)
{
return new WorkshopResponseDTO(
workshop.Id,
workshop.Title,
workshop.Description,
workshop.StartAt,
workshop.EndAt,
workshop.Location,
workshop.Capacity,
workshop.IsOnline
);
}
}

View File

@@ -1,8 +1,7 @@
namespace CampusWorkshops.Api.Dtos;
// DTO para criação de Workshop.
public record CreateWorkshopRequest(
public record CreateWorkshopRequestDTO(
string? Title,
string? Description,
DateTimeOffset StartAt,
@@ -10,4 +9,4 @@ public record CreateWorkshopRequest(
string? Location,
int Capacity,
bool IsOnline
);
);

View File

@@ -1,8 +1,7 @@
namespace CampusWorkshops.Api.Dtos;
// DTO de resposta para Workshop
public record WorkshopResponse(
public record WorkshopResponseDTO(
Guid Id,
string? Title,
string? Description,

View File

@@ -1,28 +1,19 @@
namespace CampusWorkshops.Api.Models;
// Modelo mínimo para Workshop.Completar as validações
// e ajustar os tipos/atributos durante a atividade.
public class Workshop
{
// Identificador único
public Guid Id { get; set; } = Guid.NewGuid();
// TODO: adicionar [Required], [StringLength(120, MinimumLength = 3)]
public string? Title { get; set; }
// TODO: limitar tamanho (ex.: 2000)
public string? Description { get; set; }
// TODO: usar DateTimeOffset com formato ISO 8601
public DateTimeOffset StartAt { get; set; }
public DateTimeOffset EndAt { get; set; }
// Location deve ser obrigatório se IsOnline == false
public string? Location { get; set; }
// TODO: validar Capacity >= 1
public int Capacity { get; set; } = 1;
public bool IsOnline { get; set; }

View File

@@ -1,23 +1,26 @@
// Note: repository implementation removed for workshop exercise (TODOs in project files)
using CampusWorkshops.Api.Repositories;
using Microsoft.AspNetCore.Diagnostics;
using Microsoft.AspNetCore.Mvc;
using SharpGrip.FluentValidation.AutoValidation.Mvc.Extensions;
var builder = WebApplication.CreateBuilder(args);
// Add services
builder.Services.AddControllers();
builder.Services.AddTransient<IWorkshopRepository, InMemoryWorkshopRepository>();
builder.Services.AddFluentValidationAutoValidation();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen(o =>
{
o.SwaggerDoc("v1", new Microsoft.OpenApi.Models.OpenApiInfo
{
Title = "CampusWorkshops API",
Title = "Workshop 10 - API's RESTFul",
Version = "v1",
Description = "API para gestão de workshops do campus (MVP in-memory)."
});
});
// DI
var app = builder.Build();

View File

@@ -5,7 +5,7 @@
"commandName": "Project",
"dotnetRunMessages": true,
"launchBrowser": false,
"applicationUrl": "http://localhost:5298",
"applicationUrl": "http://localhost:5001",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
@@ -14,7 +14,7 @@
"commandName": "Project",
"dotnetRunMessages": true,
"launchBrowser": false,
"applicationUrl": "https://localhost:7006;http://localhost:5298",
"applicationUrl": "https://localhost:7006;http://localhost:5001",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}

View File

@@ -9,4 +9,5 @@ public interface IWorkshopRepository
Task<IReadOnlyList<Workshop>> GetAllAsync(DateTimeOffset? from, DateTimeOffset? to, string? q, CancellationToken ct);
Task<Workshop?> GetByIdAsync(Guid id, CancellationToken ct);
Task<Workshop> AddAsync(Workshop workshop, CancellationToken ct);
Task<bool> DeleteAsync(Guid id, CancellationToken ct);
}

View File

@@ -6,26 +6,107 @@ namespace CampusWorkshops.Api.Repositories;
// In-memory repository stub
public class InMemoryWorkshopRepository : IWorkshopRepository
{
private readonly List<Workshop> workshops = new List<Workshop>();
public InMemoryWorkshopRepository()
{
// TODO: Adicionar workshops iniciais
workshops.AddRange(Seed());
}
public Task<IReadOnlyList<Workshop>> GetAllAsync(DateTimeOffset? from, DateTimeOffset? to, string? q, CancellationToken ct)
public async Task<Workshop?> GetByIdAsync(Guid id, CancellationToken ct)
{
// TODO: retornar uma lista filtrada e ordenada por StartAt
return Task.FromResult<IReadOnlyList<Workshop>>(Array.Empty<Workshop>());
ct.ThrowIfCancellationRequested();
Workshop workshop = workshops.FirstOrDefault(w => w.Id == id);
if(workshop == null) return await Task.FromResult<Workshop?>(null);
return await Task.FromResult<Workshop?>(workshop);
}
public Task<Workshop?> GetByIdAsync(Guid id, CancellationToken ct)
public async Task<Workshop> AddAsync(Workshop workshop, CancellationToken ct)
{
// TODO: buscar por id
return Task.FromResult<Workshop?>(null);
ct.ThrowIfCancellationRequested();
ArgumentNullException.ThrowIfNull(workshop);
workshops.Add(workshop);
return await Task.FromResult<Workshop?>(workshop);
}
public Task<Workshop> AddAsync(Workshop workshop, CancellationToken ct)
public async Task<IReadOnlyList<Workshop>> GetAllAsync(DateTimeOffset? from, DateTimeOffset? to, string? q, CancellationToken ct)
{
// TODO: adicionar à lista em memória e retornar criado
return Task.FromResult(workshop);
ct.ThrowIfCancellationRequested();
IEnumerable<Workshop> retorno = workshops;
if (from.HasValue)
retorno = retorno.Where(w => w.StartAt >= from.Value);
if (to.HasValue)
retorno = retorno.Where(w => w.StartAt <= to.Value);
if (!string.IsNullOrWhiteSpace(q))
retorno = retorno.Where(w => (!string.IsNullOrWhiteSpace(w.Title) && w.Title.Contains(q)));
IReadOnlyList<Workshop> orderedWorkshops = retorno.OrderBy(r => r.StartAt).ToList();
return await Task.FromResult<IReadOnlyList<Workshop>>(orderedWorkshops);
}
public async Task<bool> DeleteAsync(Guid id, CancellationToken ct)
{
bool retorno = false;
Workshop workshop = await GetByIdAsync(id, ct);
if(workshop != null)
retorno = workshops.Remove(workshop);
return retorno;
}
/// <summary>
/// Método auxiliar para popular o repositório in memory com alguns workshops de exemplo
/// </summary>
private static List<Workshop> Seed()
{
// Base de datas: sempre a partir da próxima semana, para não “envelhecer” o seed
var baseDate = DateTimeOffset.UtcNow.Date.AddDays(7);
List<Workshop> workShops = new();
var w1 = new Workshop
{
Id = Guid.Parse("8a0b9f1b-6c9b-4a2a-9d5e-1c2f3a4b5c6d"),
Title = "APIs RESTful — visão geral",
Description = "Modelagem de recursos, status codes e boas práticas.",
StartAt = baseDate.AddHours(12), // daqui a 7 dias, 12:00 UTC
EndAt = baseDate.AddHours(15), // 15:00 UTC
Location = "Lab 101",
Capacity = 25,
IsOnline = false
};
var w2 = new Workshop
{
Id = Guid.Parse("1c3d5e7f-9a2b-4c6d-8e0f-1a2b3c4d5e6f"),
Title = "Entity Framework — mapeamentos e LINQ",
Description = "Relações, consultas eficientes e boas práticas.",
StartAt = baseDate.AddDays(2).AddHours(12), // +2 dias, 12:00 UTC
EndAt = baseDate.AddDays(2).AddHours(14), // 14:00 UTC
Location = null, // online
Capacity = 40,
IsOnline = true
};
var w3 = new Workshop
{
Id = Guid.Parse("f0e1d2c3-b4a5-6789-9a8b-7c6d5e4f3a2b"),
Title = "Construindo contratos com Swagger/OpenAPI",
Description = "Documentação viva, exemplos e testes via Swagger UI.",
StartAt = baseDate.AddDays(5).AddHours(13), // +5 dias, 13:00 UTC
EndAt = baseDate.AddDays(5).AddHours(16), // 16:00 UTC
Location = "Auditório Central",
Capacity = 80,
IsOnline = false
};
workShops.Add(w1);
workShops.Add(w2);
workShops.Add(w3);
return workShops;
}
}

View File

@@ -0,0 +1,33 @@
using CampusWorkshops.Api.Dtos;
using FluentValidation;
namespace Workshop10_API.Validation
{
public class WorkshopRequestDTOValidator : AbstractValidator<CreateWorkshopRequestDTO>
{
public WorkshopRequestDTOValidator()
{
RuleFor(x => x.Title)
.NotEmpty().WithMessage("O título é obrigatório.")
.Length(3, 120).WithMessage("O título deve ter entre 3 e 120 caracteres.");
RuleFor(x => x.Capacity)
.GreaterThan(0).WithMessage("Capacidade deve ser no mínimo 1.");
RuleFor(x => x.StartAt)
.LessThan(x => x.EndAt).WithMessage("A data de início deve ser menor que a data de término.");
RuleFor(x => x.Location)
.NotEmpty().When(x => !x.IsOnline)
.WithMessage("Local é obrigatório quando o evento não é online.");
RuleFor(x => x.StartAt)
.Must(date => DateTime.TryParse(date.ToString("yyyy/MM/dd HH:mm:ss"), out DateTime x))
.WithMessage("A data de início deve estar em formato ISO 8601 (YYYY-MM-DDTHH:mm:ssZ).");
RuleFor(x => x.EndAt)
.Must(date => DateTime.TryParse(date.ToString("yyyy/MM/dd HH:mm:ss"), out DateTime x))
.WithMessage("A data fim deve estar em formato ISO 8601 (YYYY-MM-DDTHH:mm:ssZ).");
}
}
}

View File

@@ -8,8 +8,15 @@
</PropertyGroup>
<ItemGroup>
<PackageReference Include="FluentValidation" Version="12.0.0" />
<PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.2" />
<PackageReference Include="Microsoft.EntityFrameworkCore" Version="9.0.8" />
<PackageReference Include="SharpGrip.FluentValidation.AutoValidation.Mvc" Version="1.5.0" />
<PackageReference Include="Swashbuckle.AspNetCore" Version="9.0.3" />
</ItemGroup>
<ItemGroup>
<Folder Include="Controllers\" />
</ItemGroup>
</Project>

View File

@@ -1,6 +1,6 @@
@Workshop10_API_HostAddress = http://localhost:5298
@Workshop10_API_HostAddress = http://localhost:5001
GET {{Workshop10_API_HostAddress}}/weatherforecast/
GET {{Workshop10_API_HostAddress}}/
Accept: application/json
###