javier.2526/dolibarr-bff
javier.2526
/
dolibarr-bff
mirror of https://github.com/JavMB/dolibarr-bff.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

quito anotaciones de los Controllers para mayor legibilidad.

This commit is contained in:
javiermengual 2026-02-05 14:38:47 +01:00
parent 45913112be
commit eef2c9954c
2 changed files with 0 additions and 43 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
DoliMiddlewareApi/Controllers/ClientsController.cs
View File

@ -13,9 +13,6 @@ public class ClientsController(ClientService clientService) : ControllerBase
{ {
[HttpGet] [HttpGet]
[ProducesResponseType(typeof(List<ClientDto>), StatusCodes.Status200OK)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
public async Task<ActionResult<List<ClientDto>>> GetClientes( public async Task<ActionResult<List<ClientDto>>> GetClientes(
[FromQuery] int limit = 50, [FromQuery] int limit = 50,
[FromQuery][Range(1, int.MaxValue)] int page = 1) [FromQuery][Range(1, int.MaxValue)] int page = 1)

40
DoliMiddlewareApi/Controllers/InvoicesController.cs
View File

@ -13,9 +13,6 @@ namespace DoliMiddlewareApi.Controllers;
public class InvoicesController(InvoiceService invoiceService) : ControllerBase public class InvoicesController(InvoiceService invoiceService) : ControllerBase
{ {
[HttpGet] [HttpGet]
[ProducesResponseType(typeof(List<InvoiceDto>), StatusCodes.Status200OK)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
public async Task<ActionResult<List<InvoiceDto>>> GetInvoices( public async Task<ActionResult<List<InvoiceDto>>> GetInvoices(
[FromQuery] int limit = 50, [FromQuery] int limit = 50,
[FromQuery][Range(1, int.MaxValue)] int page = 1, [FromQuery][Range(1, int.MaxValue)] int page = 1,
@ -27,10 +24,6 @@ public class InvoicesController(InvoiceService invoiceService) : ControllerBase
} }
[HttpGet("{id:int}")] [HttpGet("{id:int}")]
[ProducesResponseType(typeof(InvoiceDetailDto), StatusCodes.Status200OK)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
public async Task<ActionResult<InvoiceDetailDto>> GetInvoice([Range(1, int.MaxValue)] int id) public async Task<ActionResult<InvoiceDetailDto>> GetInvoice([Range(1, int.MaxValue)] int id)
{ {
var invoice = await invoiceService.GetInvoiceAsync(id); var invoice = await invoiceService.GetInvoiceAsync(id);
@ -38,9 +31,6 @@ public class InvoicesController(InvoiceService invoiceService) : ControllerBase
} }
[HttpPost] [HttpPost]
[ProducesResponseType(typeof(int), StatusCodes.Status201Created)] // Devuelve el ID creado
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
public async Task<ActionResult<int>> CreateInvoice([FromBody] CreateInvoiceDto createInvoiceDto) public async Task<ActionResult<int>> CreateInvoice([FromBody] CreateInvoiceDto createInvoiceDto)
{ {
var invoiceId = await invoiceService.CreateInvoiceAsync(createInvoiceDto); var invoiceId = await invoiceService.CreateInvoiceAsync(createInvoiceDto);
@ -48,11 +38,6 @@ public class InvoicesController(InvoiceService invoiceService) : ControllerBase
} }
[HttpPut("{id:int}")] [HttpPut("{id:int}")]
[ProducesResponseType(StatusCodes.Status204NoContent)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status403Forbidden)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
public async Task<IActionResult> UpdateInvoice([Range(1, int.MaxValue)] int id, [FromBody] UpdateInvoiceDto updateInvoiceDto) public async Task<IActionResult> UpdateInvoice([Range(1, int.MaxValue)] int id, [FromBody] UpdateInvoiceDto updateInvoiceDto)
{ {
await invoiceService.UpdateInvoiceAsync(id, updateInvoiceDto); await invoiceService.UpdateInvoiceAsync(id, updateInvoiceDto);
@ -60,11 +45,6 @@ public class InvoicesController(InvoiceService invoiceService) : ControllerBase
} }
[HttpPost("{id:int}/lines")] [HttpPost("{id:int}/lines")]
[ProducesResponseType(typeof(string), StatusCodes.Status201Created)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status403Forbidden)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
public async Task<ActionResult<string>> AddInvoiceLine([Range(1, int.MaxValue)] int id, [FromBody] CreateInvoiceLineDto lineDto) public async Task<ActionResult<string>> AddInvoiceLine([Range(1, int.MaxValue)] int id, [FromBody] CreateInvoiceLineDto lineDto)
{ {
var result = await invoiceService.AddInvoiceLineAsync(id, lineDto); var result = await invoiceService.AddInvoiceLineAsync(id, lineDto);
@ -72,11 +52,6 @@ public class InvoicesController(InvoiceService invoiceService) : ControllerBase
} }
[HttpPatch("{id:int}/status")] [HttpPatch("{id:int}/status")]
[ProducesResponseType(StatusCodes.Status204NoContent)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status403Forbidden)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
public async Task<IActionResult> UpdateInvoiceStatus( public async Task<IActionResult> UpdateInvoiceStatus(
[Range(1, int.MaxValue)] int id, [Range(1, int.MaxValue)] int id,
[FromBody] UpdateInvoiceStatusDto updateStatusDto) [FromBody] UpdateInvoiceStatusDto updateStatusDto)
@ -86,11 +61,6 @@ public class InvoicesController(InvoiceService invoiceService) : ControllerBase
} }
[HttpPost("{id:int}/validate")] [HttpPost("{id:int}/validate")]
[ProducesResponseType(StatusCodes.Status204NoContent)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status403Forbidden)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
public async Task<IActionResult> ValidateInvoice([Range(1, int.MaxValue)] int id) public async Task<IActionResult> ValidateInvoice([Range(1, int.MaxValue)] int id)
{ {
await invoiceService.ValidateInvoiceAsync(id); await invoiceService.ValidateInvoiceAsync(id);
@ -98,11 +68,6 @@ public class InvoicesController(InvoiceService invoiceService) : ControllerBase
} }
[HttpDelete("{id:int}")] [HttpDelete("{id:int}")]
[ProducesResponseType(StatusCodes.Status204NoContent)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status403Forbidden)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
public async Task<IActionResult> DeleteInvoice([Range(1, int.MaxValue)] int id) public async Task<IActionResult> DeleteInvoice([Range(1, int.MaxValue)] int id)
{ {
await invoiceService.DeleteInvoiceAsync(id); await invoiceService.DeleteInvoiceAsync(id);
@ -110,11 +75,6 @@ public class InvoicesController(InvoiceService invoiceService) : ControllerBase
} }
[HttpDelete("{invoiceId:int}/lines/{lineId:int}")] [HttpDelete("{invoiceId:int}/lines/{lineId:int}")]
[ProducesResponseType(StatusCodes.Status204NoContent)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status400BadRequest)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status403Forbidden)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)]
[ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status500InternalServerError)]
public async Task<IActionResult> DeleteInvoiceLine( public async Task<IActionResult> DeleteInvoiceLine(
[Range(1, int.MaxValue)] int invoiceId, [Range(1, int.MaxValue)] int invoiceId,
[Range(1, int.MaxValue)] int lineId) [Range(1, int.MaxValue)] int lineId)