myAi/cv-matcher-api/Controllers/CvController.cs

using CvMatcher.Models.Requests;
using Api.Services.Contracts;
using Microsoft.AspNetCore.Mvc;
using CvMatcher.Models.Responses;
using Shared.Models.Requests;
using Swashbuckle.AspNetCore.Annotations;

namespace Api.Controllers;

[ApiController]
[Route("api/cv")]
public sealed class CvController : ControllerBase
{
    private readonly ICvMatcherService _service;
    private readonly ILogger<CvController> _logger;

    public CvController(ICvMatcherService service, ILogger<CvController> logger)
    {
        _service = service;
        _logger = logger;
    }

    [HttpPost("upload")]
    [RequestSizeLimit(10 * 1024 * 1024)]
    [SwaggerOperation(Summary = "Upload CV document", Description = "Uploads a CV PDF and indexes it for matching.")]
    [SwaggerResponse(StatusCodes.Status200OK, "CV uploaded and indexed successfully")]
    [SwaggerResponse(StatusCodes.Status400BadRequest, "Invalid upload request")]
    [ProducesResponseType(StatusCodes.Status200OK)]
    [ProducesResponseType(StatusCodes.Status400BadRequest)]
    public async Task<ActionResult<CvUploadResponse>> Upload([FromForm] UploadFileRequest request, CancellationToken ct)
    {
        try
        {
            if (request.File is null) return BadRequest(new { error = "Missing CV PDF." });
            _logger.LogInformation("CV upload received. FileName={FileName}, Size={SizeBytes}", request.File.FileName, request.File.Length);
            var result = await _service.UploadCvAsync(request.File, ct);
            _logger.LogInformation("CV upload processed. CvDocumentId={CvDocumentId}, Cached={Cached}", result.DocumentId, result.Cached);
            return Ok(result);
        }
        catch (InvalidOperationException ex)
        {
            _logger.LogWarning(ex, "Invalid CV upload request.");
            return BadRequest(new { error = ex.Message });
        }
    }

    [HttpPost("find-jobs")]
    [SwaggerOperation(Summary = "Find matching jobs", Description = "Finds top matching jobs for a previously uploaded CV document.")]
    [SwaggerResponse(StatusCodes.Status200OK, "Matching jobs returned")]
    [SwaggerResponse(StatusCodes.Status400BadRequest, "Invalid find jobs request")]
    [ProducesResponseType(StatusCodes.Status200OK)]
    [ProducesResponseType(StatusCodes.Status400BadRequest)]
    public async Task<ActionResult<FindJobsResponse>> FindJobs([FromBody] FindJobsRequest request, CancellationToken ct)
    {
        try
        {
            _logger.LogInformation("Find jobs request received. CvDocumentId={CvDocumentId}, TopK={TopK}", request.CvDocumentId, request.TopK);
            var result = await _service.FindJobsAsync(request, ct);
            _logger.LogInformation("Find jobs completed. CvDocumentId={CvDocumentId}, ResultCount={ResultCount}", request.CvDocumentId, result.Jobs.Count);
            return result;
        }
        catch (InvalidOperationException ex)
        {
            _logger.LogWarning(ex, "Invalid find jobs request.");
            return BadRequest(new { error = ex.Message });
        }
    }

    [HttpPost("match-job")]
    [SwaggerOperation(Summary = "Match CV to one job", Description = "Computes detailed match analysis between a CV and a single job description or URL.")]
    [SwaggerResponse(StatusCodes.Status200OK, "Job match computed successfully")]
    [SwaggerResponse(StatusCodes.Status400BadRequest, "Invalid match job request")]
    [ProducesResponseType(StatusCodes.Status200OK)]
    [ProducesResponseType(StatusCodes.Status400BadRequest)]
    public async Task<ActionResult<JobMatchResponse>> MatchJob([FromBody] MatchJobRequest request, CancellationToken ct)
    {
        try
        {
            _logger.LogInformation("Match job request received. CvDocumentId={CvDocumentId}, HasJobUrl={HasJobUrl}, HasJobDescription={HasJobDescription}, EmailRequested={EmailRequested}",
                request.CvDocumentId, !string.IsNullOrWhiteSpace(request.JobUrl), !string.IsNullOrWhiteSpace(request.JobDescription), !string.IsNullOrWhiteSpace(request.Email));
            var result = await _service.MatchJobAsync(request, ct);
            _logger.LogInformation("Match job completed. CvDocumentId={CvDocumentId}, Score={Score}, Cached={Cached}", request.CvDocumentId, result.Score, result.Cached);
            return result;
        }
        catch (InvalidOperationException ex)
        {
            _logger.LogWarning(ex, "Invalid match job request.");
            return BadRequest(new { error = ex.Message });
        }
    }
}