SchotzIAD/backend/SchotzIadKmTracker.Api/Controllers/ProfilController.cs

using Microsoft.AspNetCore.Mvc;
using SchotzIadKmTracker.Api.Models.DTOs;
using SchotzIadKmTracker.Api.Services;

namespace SchotzIadKmTracker.Api.Controllers;

/// <summary>
/// Endpoints de gestion du profil utilisateur (singleton) et de son état de configuration.
/// </summary>
[ApiController]
[Route("api/profil")]
public class ProfilController : ControllerBase
{
    private readonly IProfilService _profilService;

    public ProfilController(IProfilService profilService)
    {
        _profilService = profilService;
    }

    /// <summary>Récupère le profil (créé à la volée s'il est absent).</summary>
    [HttpGet]
    [ProducesResponseType(typeof(ProfilDto), StatusCodes.Status200OK)]
    public async Task<ActionResult<ProfilDto>> GetProfil(CancellationToken cancellationToken)
    {
        var profil = await _profilService.GetProfilAsync(cancellationToken);
        return Ok(profil);
    }

    /// <summary>
    /// Sauvegarde le profil. La validation du matricule (≤ 8 car.) est assurée par FluentValidation.
    /// Le géocodage de l'Adresse_Domicile est effectué au mieux : un échec BAN n'empêche pas la sauvegarde.
    /// </summary>
    [HttpPut]
    [ProducesResponseType(typeof(ProfilDto), StatusCodes.Status200OK)]
    [ProducesResponseType(StatusCodes.Status400BadRequest)]
    public async Task<ActionResult<ProfilDto>> SaveProfil(
        [FromBody] SaveProfilDto dto,
        CancellationToken cancellationToken)
    {
        var profil = await _profilService.SaveProfilAsync(dto, cancellationToken);
        return Ok(profil);
    }

    /// <summary>État de configuration du profil (onboarding).</summary>
    [HttpGet("etat")]
    [ProducesResponseType(typeof(EtatProfilDto), StatusCodes.Status200OK)]
    public async Task<ActionResult<EtatProfilDto>> GetEtat(CancellationToken cancellationToken)
    {
        var etat = await _profilService.GetEtatAsync(cancellationToken);
        return Ok(etat);
    }
}