394 lines
17 KiB
C#
394 lines
17 KiB
C#
using Microsoft.AspNetCore.Authorization;
|
|
using Microsoft.AspNetCore.Mvc;
|
|
using Microsoft.EntityFrameworkCore;
|
|
using Microsoft.AspNetCore.Identity;
|
|
using JobTrackerApi.Data;
|
|
using JobTrackerApi.Models;
|
|
using JobTrackerApi.Services;
|
|
using System.Security.Cryptography;
|
|
|
|
namespace JobTrackerApi.Controllers
|
|
{
|
|
[ApiController]
|
|
[Route("api/attachments")]
|
|
[Authorize(AuthenticationSchemes = "local")]
|
|
public class AttachmentsController : ControllerBase
|
|
{
|
|
private const long MaxFileSizeBytes = 10 * 1024 * 1024; // 10 MB per file keeps local storage use predictable.
|
|
|
|
private static readonly HashSet<string> AllowedExtensions = new(StringComparer.OrdinalIgnoreCase)
|
|
{
|
|
".pdf", ".doc", ".docx", ".txt", ".rtf", ".png", ".jpg", ".jpeg", ".webp"
|
|
};
|
|
|
|
private readonly JobTrackerContext _db;
|
|
private readonly UserManager<ApplicationUser>? _users;
|
|
private readonly IAttachmentStorage _storage;
|
|
private readonly ILogger<AttachmentsController> _logger;
|
|
|
|
public AttachmentsController(AppPaths paths, JobTrackerContext db, UserManager<ApplicationUser>? users = null, IAttachmentStorage? storage = null, ILogger<AttachmentsController>? logger = null)
|
|
{
|
|
_db = db;
|
|
_users = users;
|
|
_storage = storage ?? new AttachmentStorage(paths);
|
|
_logger = logger ?? Microsoft.Extensions.Logging.Abstractions.NullLogger<AttachmentsController>.Instance;
|
|
}
|
|
|
|
public sealed record AttachmentDto(int Id, string FileName, DateTime UploadDate, string FileType, long FileSize, string? Purpose, bool UseForAi);
|
|
|
|
// Child entities are accessed by raw integer ids in a few endpoints below.
|
|
// Always resolve them through the parent JobApplication query so the global job-level
|
|
// ownership filter is still enforced for multi-user environments.
|
|
private Task<Attachment?> FindOwnedAttachmentAsync(int attachmentId, CancellationToken cancellationToken)
|
|
{
|
|
return _db.Attachments
|
|
.Include(a => a.JobApplication)
|
|
.FirstOrDefaultAsync(a => a.Id == attachmentId, cancellationToken);
|
|
}
|
|
|
|
private static string BuildStoredFileName(string originalName)
|
|
{
|
|
var ext = Path.GetExtension(originalName);
|
|
var suffix = Convert.ToHexString(RandomNumberGenerator.GetBytes(6)).ToLowerInvariant();
|
|
return $"{DateTime.UtcNow:yyyyMMddHHmmssfff}-{suffix}{ext}";
|
|
}
|
|
|
|
private static string GuessPurpose(string fileName)
|
|
{
|
|
var n = (fileName ?? string.Empty).ToLowerInvariant();
|
|
if (n.Contains("cover")) return "cover-letter";
|
|
if (n.Contains("resume") || n.Contains("résumé") || n.Contains(" cv") || n.EndsWith("cv.pdf")) return "resume";
|
|
if (n.Contains("portfolio")) return "portfolio";
|
|
if (n.Contains("case") || n.Contains("sample")) return "case-study";
|
|
if (n.Contains("cert")) return "certificate";
|
|
return "other";
|
|
}
|
|
|
|
// JobApplication.HasResume/HasCoverLetter/HasPortfolio/HasOtherAttachment are derived
|
|
// from actual Attachment rows, not manually settable -- this is the single place they're
|
|
// written, called after every attachment mutation (upload/delete/purpose change) so they
|
|
// can never drift from what's actually attached.
|
|
private async Task RecomputeAttachmentFlagsAsync(int jobId, CancellationToken cancellationToken)
|
|
{
|
|
var job = await _db.JobApplications.FirstOrDefaultAsync(j => j.Id == jobId, cancellationToken);
|
|
if (job is null) return;
|
|
|
|
var purposes = await _db.Attachments
|
|
.Where(a => a.JobApplicationId == jobId)
|
|
.Select(a => a.Purpose)
|
|
.ToListAsync(cancellationToken);
|
|
|
|
job.HasResume = purposes.Any(p => p == "resume");
|
|
job.HasCoverLetter = purposes.Any(p => p == "cover-letter");
|
|
job.HasPortfolio = purposes.Any(p => p == "portfolio");
|
|
job.HasOtherAttachment = purposes.Any(p => p is not ("resume" or "cover-letter" or "portfolio"));
|
|
}
|
|
|
|
[HttpGet("{jobId:int}")]
|
|
public async Task<ActionResult<List<AttachmentDto>>> ListForJob([FromRoute] int jobId, CancellationToken cancellationToken)
|
|
{
|
|
var jobOk = await _db.JobApplications.AnyAsync(j => j.Id == jobId, cancellationToken);
|
|
if (!jobOk) return NotFound();
|
|
|
|
var items = await _db.Attachments
|
|
.AsNoTracking()
|
|
.Where(a => a.JobApplicationId == jobId)
|
|
.OrderByDescending(a => a.UploadDate)
|
|
.Select(a => new AttachmentDto(a.Id, a.FileName, a.UploadDate, a.FileType, a.FileSize, a.Purpose, a.UseForAi))
|
|
.ToListAsync(cancellationToken);
|
|
|
|
return Ok(items);
|
|
}
|
|
|
|
[HttpGet("download/{id:int}")]
|
|
public async Task<IActionResult> Download([FromRoute] int id, CancellationToken cancellationToken)
|
|
{
|
|
var att = await FindOwnedAttachmentAsync(id, cancellationToken);
|
|
if (att is null) return NotFound();
|
|
|
|
if (string.IsNullOrWhiteSpace(att.FilePath) || !_storage.IsManagedPath(att.FilePath))
|
|
return Conflict("The attachment storage path is invalid.");
|
|
if (!System.IO.File.Exists(att.FilePath))
|
|
{
|
|
if (System.IO.File.Exists(_storage.StagePath(att.FilePath)))
|
|
return Conflict("The attachment is still being finalized. Try again after the service restarts.");
|
|
return NotFound();
|
|
}
|
|
|
|
var contentType = string.IsNullOrWhiteSpace(att.FileType) ? "application/octet-stream" : att.FileType;
|
|
var fileName = Path.GetFileName(att.FileName);
|
|
return PhysicalFile(att.FilePath, contentType, fileName);
|
|
}
|
|
|
|
public sealed record UpdateAttachmentRequest(string? FileName, string? Purpose, bool? UseForAi);
|
|
|
|
[HttpPatch("{id:int}")]
|
|
public async Task<IActionResult> Rename([FromRoute] int id, [FromBody] UpdateAttachmentRequest request, CancellationToken cancellationToken)
|
|
{
|
|
var att = await FindOwnedAttachmentAsync(id, cancellationToken);
|
|
if (att is null) return NotFound();
|
|
|
|
if (request.UseForAi is not null)
|
|
{
|
|
att.UseForAi = request.UseForAi.Value;
|
|
}
|
|
|
|
var purposeChanged = !string.IsNullOrWhiteSpace(request.Purpose);
|
|
if (purposeChanged)
|
|
{
|
|
att.Purpose = request.Purpose!.Trim().ToLowerInvariant();
|
|
}
|
|
|
|
var rawName = (request.FileName ?? string.Empty).Trim();
|
|
if (rawName.Length > 0)
|
|
{
|
|
var name = Path.GetFileName(rawName);
|
|
var ext = Path.GetExtension(name);
|
|
if (!AllowedExtensions.Contains(ext))
|
|
return BadRequest("That file type is not allowed.");
|
|
|
|
// The generated storage name is intentionally stable. A user-visible rename is metadata,
|
|
// so no filesystem/DB split can leave the row pointing at a moved file.
|
|
att.FileName = name;
|
|
}
|
|
|
|
await using var transaction = _db.Database.IsRelational()
|
|
? await _db.Database.BeginTransactionAsync(cancellationToken)
|
|
: null;
|
|
await _db.SaveChangesAsync(cancellationToken);
|
|
if (purposeChanged)
|
|
{
|
|
// This query must see the new persisted purpose; the transaction keeps both saves atomic.
|
|
await RecomputeAttachmentFlagsAsync(att.JobApplicationId, cancellationToken);
|
|
await _db.SaveChangesAsync(cancellationToken);
|
|
}
|
|
if (transaction is not null) await transaction.CommitAsync(cancellationToken);
|
|
|
|
return NoContent();
|
|
}
|
|
|
|
[HttpDelete("{id:int}")]
|
|
public async Task<IActionResult> Delete([FromRoute] int id, CancellationToken cancellationToken)
|
|
{
|
|
var att = await FindOwnedAttachmentAsync(id, cancellationToken);
|
|
if (att is null) return NotFound();
|
|
|
|
var path = att.FilePath;
|
|
var jobId = att.JobApplicationId;
|
|
if (!string.IsNullOrWhiteSpace(path) && !_storage.IsManagedPath(path))
|
|
return Conflict("The attachment storage path is invalid.");
|
|
|
|
var deletePath = string.IsNullOrWhiteSpace(path) ? null : _storage.DeletePath(path);
|
|
var quarantined = false;
|
|
if (!string.IsNullOrWhiteSpace(path) && System.IO.File.Exists(path))
|
|
{
|
|
_storage.Quarantine(path, deletePath!);
|
|
quarantined = true;
|
|
}
|
|
else if (deletePath is not null && System.IO.File.Exists(deletePath))
|
|
{
|
|
return Accepted(new { recoveryPending = true });
|
|
}
|
|
else if (!string.IsNullOrWhiteSpace(path))
|
|
{
|
|
_logger.LogWarning("Attachment {AttachmentId} metadata referenced missing bytes; deleting the stale row.", id);
|
|
}
|
|
|
|
Microsoft.EntityFrameworkCore.Storage.IDbContextTransaction? transaction = null;
|
|
var rolledBack = false;
|
|
try
|
|
{
|
|
if (_db.Database.IsRelational())
|
|
transaction = await _db.Database.BeginTransactionAsync(cancellationToken);
|
|
_db.Attachments.Remove(att);
|
|
await _db.SaveChangesAsync(cancellationToken);
|
|
await RecomputeAttachmentFlagsAsync(jobId, cancellationToken);
|
|
await _db.SaveChangesAsync(cancellationToken);
|
|
if (transaction is not null) await transaction.CommitAsync(cancellationToken);
|
|
}
|
|
catch
|
|
{
|
|
if (transaction is not null)
|
|
{
|
|
try
|
|
{
|
|
await transaction.RollbackAsync(CancellationToken.None);
|
|
rolledBack = true;
|
|
}
|
|
catch (Exception rollbackError)
|
|
{
|
|
_logger.LogWarning(rollbackError, "Attachment {AttachmentId} transaction outcome is uncertain; quarantined bytes await startup reconciliation.", id);
|
|
}
|
|
}
|
|
if (rolledBack && quarantined && deletePath is not null && System.IO.File.Exists(deletePath) && !System.IO.File.Exists(path))
|
|
{
|
|
try { _storage.Restore(deletePath, path); }
|
|
catch (Exception restoreError)
|
|
{
|
|
_logger.LogWarning(restoreError, "Attachment {AttachmentId} bytes could not be restored after database rollback; startup reconciliation will retry.", id);
|
|
}
|
|
}
|
|
throw;
|
|
}
|
|
finally
|
|
{
|
|
if (transaction is not null) await transaction.DisposeAsync();
|
|
}
|
|
|
|
if (deletePath is not null)
|
|
{
|
|
try
|
|
{
|
|
_storage.Purge(deletePath);
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
_logger.LogWarning(ex, "Attachment {AttachmentId} metadata was deleted; quarantined bytes await startup reconciliation.", id);
|
|
return Accepted(new { recoveryPending = true });
|
|
}
|
|
}
|
|
|
|
return NoContent();
|
|
}
|
|
|
|
[HttpPost]
|
|
public async Task<IActionResult> Upload([FromForm] IFormFileCollection files, [FromForm] int jobId, CancellationToken cancellationToken)
|
|
{
|
|
if (jobId <= 0) return BadRequest("Valid jobId is required.");
|
|
if (files is null || files.Count == 0) return BadRequest("At least one file is required.");
|
|
|
|
var jobExists = await _db.JobApplications.AnyAsync(j => j.Id == jobId, cancellationToken);
|
|
if (!jobExists) return BadRequest("jobId does not exist.");
|
|
|
|
|
|
if (_users is not null)
|
|
{
|
|
var user = await _users.GetUserAsync(User);
|
|
if (user is null) return Unauthorized();
|
|
var roles = await _users.GetRolesAsync(user);
|
|
var limit = AccountPlans.ForRoles(roles).StorageBytes;
|
|
var used = await _db.Attachments.Where(a => a.JobApplication.OwnerUserId == user.Id).SumAsync(a => (long?)a.FileSize, cancellationToken) ?? 0;
|
|
var incoming = files.Sum(file => file.Length);
|
|
if (incoming > limit - used)
|
|
return StatusCode(StatusCodes.Status413PayloadTooLarge, $"Storage limit reached ({limit / 1_000_000} MB). Remove files or upgrade your plan.");
|
|
}
|
|
|
|
var validFiles = new List<(IFormFile File, string DisplayName, string ContentType, string Purpose, string FinalPath, string StagePath)>();
|
|
foreach (var file in files)
|
|
{
|
|
if (file.Length == 0) continue;
|
|
if (file.Length > MaxFileSizeBytes)
|
|
return BadRequest($"{file.FileName} exceeds the 10 MB upload limit.");
|
|
|
|
var displayName = Path.GetFileName(file.FileName);
|
|
var ext = Path.GetExtension(displayName);
|
|
if (!AllowedExtensions.Contains(ext))
|
|
return BadRequest($"{displayName} is not an allowed file type.");
|
|
|
|
var storedName = BuildStoredFileName(displayName);
|
|
var finalPath = _storage.CreateFinalPath(jobId, storedName);
|
|
validFiles.Add((
|
|
file,
|
|
displayName,
|
|
string.IsNullOrWhiteSpace(file.ContentType) ? "application/octet-stream" : file.ContentType,
|
|
GuessPurpose(displayName),
|
|
finalPath,
|
|
_storage.StagePath(finalPath)));
|
|
}
|
|
|
|
if (validFiles.Count == 0) return BadRequest("At least one non-empty file is required.");
|
|
|
|
var stagedPaths = new List<string>();
|
|
try
|
|
{
|
|
foreach (var item in validFiles)
|
|
{
|
|
await _storage.StageAsync(item.File, item.StagePath, cancellationToken);
|
|
stagedPaths.Add(item.StagePath);
|
|
}
|
|
}
|
|
catch
|
|
{
|
|
foreach (var stagedPath in stagedPaths)
|
|
{
|
|
try { _storage.Purge(stagedPath); } catch { }
|
|
}
|
|
throw;
|
|
}
|
|
|
|
Microsoft.EntityFrameworkCore.Storage.IDbContextTransaction? transaction = null;
|
|
var rolledBack = false;
|
|
try
|
|
{
|
|
if (_db.Database.IsRelational())
|
|
transaction = await _db.Database.BeginTransactionAsync(cancellationToken);
|
|
foreach (var item in validFiles)
|
|
{
|
|
_db.Attachments.Add(new Attachment
|
|
{
|
|
JobApplicationId = jobId,
|
|
FileName = item.DisplayName,
|
|
FilePath = item.FinalPath,
|
|
UploadDate = DateTime.Now,
|
|
FileType = item.ContentType,
|
|
FileSize = item.File.Length,
|
|
Purpose = item.Purpose,
|
|
UseForAi = true,
|
|
});
|
|
}
|
|
await _db.SaveChangesAsync(cancellationToken);
|
|
await RecomputeAttachmentFlagsAsync(jobId, cancellationToken);
|
|
await _db.SaveChangesAsync(cancellationToken);
|
|
if (transaction is not null) await transaction.CommitAsync(cancellationToken);
|
|
}
|
|
catch
|
|
{
|
|
if (transaction is not null)
|
|
{
|
|
try
|
|
{
|
|
await transaction.RollbackAsync(CancellationToken.None);
|
|
rolledBack = true;
|
|
}
|
|
catch (Exception rollbackError)
|
|
{
|
|
_logger.LogWarning(rollbackError, "Attachment upload transaction outcome is uncertain; staged bytes await startup reconciliation.");
|
|
}
|
|
}
|
|
if (rolledBack)
|
|
{
|
|
foreach (var item in validFiles)
|
|
{
|
|
try { _storage.Purge(item.StagePath); }
|
|
catch (Exception purgeError)
|
|
{
|
|
_logger.LogWarning(purgeError, "Attachment upload rolled back but staged bytes could not be removed; startup reconciliation will retry.");
|
|
}
|
|
}
|
|
}
|
|
throw;
|
|
}
|
|
finally
|
|
{
|
|
if (transaction is not null) await transaction.DisposeAsync();
|
|
}
|
|
|
|
var pending = false;
|
|
foreach (var item in validFiles)
|
|
{
|
|
try
|
|
{
|
|
_storage.Promote(item.StagePath, item.FinalPath);
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
pending = true;
|
|
_logger.LogWarning(ex, "Attachment upload committed for job {JobId}; staged bytes await startup reconciliation.", jobId);
|
|
}
|
|
}
|
|
|
|
return pending ? Accepted(new { recoveryPending = true }) : Ok();
|
|
}
|
|
}
|
|
}
|