New Scanner + People Pages (#3286)

Co-authored-by: Robbie Davis <robbie@therobbiedavis.com>

API/Controllers/PersonController.cs

@@ -0,0 +1,116 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using API.Data;
+using API.DTOs;
+using API.Entities.Enums;
+using API.Extensions;
+using API.Helpers;
+using API.Services;
+using AutoMapper;
+using Microsoft.AspNetCore.Mvc;
+using Nager.ArticleNumber;
+
+namespace API.Controllers;
+
+public class PersonController : BaseApiController
+{
+    private readonly IUnitOfWork _unitOfWork;
+    private readonly ILocalizationService _localizationService;
+    private readonly IMapper _mapper;
+
+    public PersonController(IUnitOfWork unitOfWork, ILocalizationService localizationService, IMapper mapper)
+    {
+        _unitOfWork = unitOfWork;
+        _localizationService = localizationService;
+        _mapper = mapper;
+    }
+
+
+    [HttpGet]
+    public async Task<ActionResult<PersonDto>> GetPersonByName(string name)
+    {
+        return Ok(await _unitOfWork.PersonRepository.GetPersonDtoByName(name, User.GetUserId()));
+    }
+
+    [HttpGet("roles")]
+    public async Task<ActionResult<IEnumerable<PersonRole>>> GetRolesForPersonByName(string name)
+    {
+        return Ok(await _unitOfWork.PersonRepository.GetRolesForPersonByName(name, User.GetUserId()));
+    }
+
+    /// <summary>
+    /// Returns a list of authors for browsing
+    /// </summary>
+    /// <param name="userParams"></param>
+    /// <returns></returns>
+    [HttpPost("authors")]
+    public async Task<ActionResult<PagedList<BrowsePersonDto>>> GetAuthorsForBrowse([FromQuery] UserParams? userParams)
+    {
+        userParams ??= UserParams.Default;
+        var list = await _unitOfWork.PersonRepository.GetAllWritersAndSeriesCount(User.GetUserId(), userParams);
+        Response.AddPaginationHeader(list.CurrentPage, list.PageSize, list.TotalCount, list.TotalPages);
+        return Ok(list);
+    }
+
+    /// <summary>
+    /// Updates the Person
+    /// </summary>
+    /// <param name="dto"></param>
+    /// <returns></returns>
+    [HttpPost("update")]
+    public async Task<ActionResult<PersonDto>> UpdatePerson(UpdatePersonDto dto)
+    {
+        // This needs to get all people and update them equally
+        var person = await _unitOfWork.PersonRepository.GetPersonById(dto.Id);
+        if (person == null) return BadRequest(_localizationService.Translate(User.GetUserId(), "person-doesnt-exist"));
+
+        dto.Description ??= string.Empty;
+        person.Description = dto.Description;
+        person.CoverImageLocked = dto.CoverImageLocked;
+
+        if (dto.MalId is > 0)
+        {
+            person.MalId = (long) dto.MalId;
+        }
+        if (dto.AniListId is > 0)
+        {
+            person.AniListId = (int) dto.AniListId;
+        }
+
+        if (!string.IsNullOrEmpty(dto.HardcoverId?.Trim()))
+        {
+            person.HardcoverId = dto.HardcoverId.Trim();
+        }
+
+        var asin = dto.Asin?.Trim();
+        if (!string.IsNullOrEmpty(asin) &&
+            (ArticleNumberHelper.IsValidIsbn10(asin) || ArticleNumberHelper.IsValidIsbn13(asin)))
+        {
+            person.Asin = asin;
+        }
+
+        _unitOfWork.PersonRepository.Update(person);
+        await _unitOfWork.CommitAsync();
+
+        return Ok(_mapper.Map<PersonDto>(person));
+    }
+
+    /// <summary>
+    /// Returns the top 20 series that the "person" is known for. This will use Average Rating when applicable (Kavita+ field), else it's a random sort
+    /// </summary>
+    /// <param name="personId"></param>
+    /// <returns></returns>
+    [HttpGet("series-known-for")]
+    public async Task<ActionResult<IEnumerable<SeriesDto>>> GetKnownSeries(int personId)
+    {
+        return Ok(await _unitOfWork.PersonRepository.GetSeriesKnownFor(personId));
+    }
+
+    [HttpGet("chapters-by-role")]
+    public async Task<ActionResult<IEnumerable<StandaloneChapterDto>>> GetChaptersByRole(int personId, PersonRole role)
+    {
+        return Ok(await _unitOfWork.PersonRepository.GetChaptersForPersonByRole(personId, User.GetUserId(), role));
+    }
+
+
+}