using System.Text.RegularExpressions; using JobTrackerApi.Data; using JobTrackerApi.Models; using Microsoft.EntityFrameworkCore; namespace JobTrackerApi.Services; // Career Workspace foundation (see docs/career-workspace-implementation-roadmap.md, Phase F1). // Bounded to the profile/CV domain -- job tracking is untouched. Every existing read path still // goes through ApplicationUser.ProfileCvStructureJson (dual-write window); this service is the // single place stable item IDs and normalized dates get assigned, and where profile history is // captured so it's never silently overwritten on the next rebuild/improve/upload. public interface ICareerProfileService { // Mutates the given profile in place (assigns missing item IDs + normalized dates), persists // it as the current CareerProfile snapshot plus an append-only CareerProfileVersion row, and // returns the same profile so the caller can go on to serialize it into the legacy column. Task SaveVersionAsync(string ownerUserId, StructuredCvProfile profile, string source, CancellationToken cancellationToken); } public sealed class CareerProfileService : ICareerProfileService { private readonly JobTrackerContext _db; public CareerProfileService(JobTrackerContext db) { _db = db; } public async Task SaveVersionAsync(string ownerUserId, StructuredCvProfile profile, string source, CancellationToken cancellationToken) { AssignStableIds(profile); NormalizeDates(profile); var json = StructuredCvProfileJson.Serialize(profile); var existing = await _db.CareerProfiles.FirstOrDefaultAsync(x => x.OwnerUserId == ownerUserId, cancellationToken); if (existing is null) { existing = new CareerProfile { OwnerUserId = ownerUserId, ProfileJson = json, Version = 1, CreatedAtUtc = DateTimeOffset.UtcNow, UpdatedAtUtc = DateTimeOffset.UtcNow, }; _db.CareerProfiles.Add(existing); } else { existing.ProfileJson = json; existing.Version += 1; existing.UpdatedAtUtc = DateTimeOffset.UtcNow; } await _db.SaveChangesAsync(cancellationToken); _db.CareerProfileVersions.Add(new CareerProfileVersion { OwnerUserId = ownerUserId, CareerProfileId = existing.Id, Version = existing.Version, ProfileJson = json, Source = string.IsNullOrWhiteSpace(source) ? "manual" : source.Trim(), CreatedAtUtc = DateTimeOffset.UtcNow, }); await _db.SaveChangesAsync(cancellationToken); return profile; } private static void AssignStableIds(StructuredCvProfile profile) { foreach (var job in profile.Jobs) { if (string.IsNullOrWhiteSpace(job.Id)) job.Id = NewItemId(); } foreach (var education in profile.Education) { if (string.IsNullOrWhiteSpace(education.Id)) education.Id = NewItemId(); } foreach (var certification in profile.Certifications) { if (string.IsNullOrWhiteSpace(certification.Id)) certification.Id = NewItemId(); } foreach (var project in profile.Projects) { if (string.IsNullOrWhiteSpace(project.Id)) project.Id = NewItemId(); } } private static string NewItemId() => Guid.NewGuid().ToString("N")[..12]; private static void NormalizeDates(StructuredCvProfile profile) { foreach (var job in profile.Jobs) { job.StartDate = CvDateNormalizer.TryParseYearMonth(job.Start); job.EndDate = job.IsCurrent ? null : CvDateNormalizer.TryParseYearMonth(job.End); } foreach (var education in profile.Education) { education.StartDate = CvDateNormalizer.TryParseYearMonth(education.Start); education.EndDate = CvDateNormalizer.TryParseYearMonth(education.End); } foreach (var certification in profile.Certifications) { certification.DateNormalized = CvDateNormalizer.TryParseYearMonth(certification.Date); } foreach (var project in profile.Projects) { project.StartDate = CvDateNormalizer.TryParseYearMonth(project.Start); project.EndDate = CvDateNormalizer.TryParseYearMonth(project.End); } } } // Best-effort free-string -> "YYYY-MM" parser. Never throws, never loses data: the original // free-string field is always kept alongside whatever this returns (null on anything it can't // confidently parse -- callers must not treat null as "no date", only as "unparsed"). public static class CvDateNormalizer { private static readonly Dictionary MonthNames = new(StringComparer.OrdinalIgnoreCase) { ["jan"] = 1, ["january"] = 1, ["feb"] = 2, ["february"] = 2, ["mar"] = 3, ["march"] = 3, ["apr"] = 4, ["april"] = 4, ["may"] = 5, ["jun"] = 6, ["june"] = 6, ["jul"] = 7, ["july"] = 7, ["aug"] = 8, ["august"] = 8, ["sep"] = 9, ["sept"] = 9, ["september"] = 9, ["oct"] = 10, ["october"] = 10, ["nov"] = 11, ["november"] = 11, ["dec"] = 12, ["december"] = 12, }; public static string? TryParseYearMonth(string? raw) { var value = (raw ?? string.Empty).Trim(); if (value.Length == 0) return null; if (value.Equals("present", StringComparison.OrdinalIgnoreCase) || value.Equals("current", StringComparison.OrdinalIgnoreCase)) return null; // "2020" -> January is an assumption we don't want to make silently; year-only stays unparsed. var monthYear = Regex.Match(value, @"^(?[A-Za-z]+)\.?\s+(?\d{4})$"); if (monthYear.Success && MonthNames.TryGetValue(monthYear.Groups["month"].Value, out var month)) { return $"{monthYear.Groups["year"].Value}-{month:D2}"; } var slash = Regex.Match(value, @"^(?\d{1,2})/(?\d{4})$"); if (slash.Success) { var m = int.Parse(slash.Groups["month"].Value); if (m is >= 1 and <= 12) return $"{slash.Groups["year"].Value}-{m:D2}"; } var isoLike = Regex.Match(value, @"^(?\d{4})-(?\d{1,2})$"); if (isoLike.Success) { var m = int.Parse(isoLike.Groups["month"].Value); if (m is >= 1 and <= 12) return $"{isoLike.Groups["year"].Value}-{m:D2}"; } return null; } }