feat: integrate Career Workspace foundation from feature/career-workspace

Recover the F1 Career Profile foundation + AI-workspace persistence from the unmerged feature/career-workspace branch, so Phase 2 builds on the documented, tested target state instead of re-deriving it. Foundation only — CV Builder commits (variants, ATS badge, rewrite diff) stay deferred per "do not build CV Builder yet". See docs/career-workspace-branch-assessment.md. Squashed from 3 branch commits (235e291, 5916f09, 00a035e), resolved against main + Phase 0: - CareerProfile + CareerProfileVersion (append-only history), dual-written from every profile save path via CareerProfileService. ApplicationUser. ProfileCvStructureJson stays authoritative; the tables mirror it. Stable item IDs assigned to jobs/education/certifications/projects (the prerequisite for future variant lineage). CvDateNormalizer for free-text -> YYYY-MM. - InterviewPrepNote + AiWorkspaceNote: cache AI interview prep / candidate fit / focus plan keyed by an attachment-context signature, so they stop regenerating (and re-spending the provider) on every open. Conflict resolutions (union, favouring current code + Phase 0): - JobTrackerContext / StartupInitializationExtensions: kept Phase 0's tables and reconciler blocks, added the career/interview/ai-note tables (both SQLite and MySQL dialects). - ProfileCvController: dropped the branch's in-file DTO records (main defines them in ProfileCvDtos.cs) and the LayoutFamily/AtsRating template fields (deferred ATS-badge work), keeping main's 7-arg CvTemplateDescriptor. - JobApplicationsController: kept the branch's cache-check, restored main's AsNoTracking on the read-only user load. Tables ship empty (verified dev); nothing to migrate. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-17 19:09:42 +02:00
parent aedd6e32ad
commit 992f89e619
15 changed files with 1063 additions and 9 deletions
@@ -1428,7 +1428,7 @@ Canonical profile:
        }

        [HttpGet("{id:int}/candidate-fit")]
-        public async Task<ActionResult<CandidateFitDto>> GetCandidateFit([FromRoute] int id, [FromQuery] string? attachmentIds, CancellationToken cancellationToken)
+        public async Task<ActionResult<CandidateFitDto>> GetCandidateFit([FromRoute] int id, [FromQuery] string? attachmentIds, [FromQuery] bool refresh, CancellationToken cancellationToken)
        {
            var job = await _db.JobApplications
                .AsNoTracking()
@@ -1439,6 +1439,13 @@ Canonical profile:
            var userId = CurrentUserId;
            if (string.IsNullOrWhiteSpace(userId)) return Unauthorized();

+            var attachmentSignature = NormalizeAttachmentIdsSignature(attachmentIds);
+            if (!refresh)
+            {
+                var cached = await TryGetCachedAiNoteAsync<CandidateFitDto>(userId, id, "candidate-fit", attachmentSignature, cancellationToken);
+                if (cached is not null) return Ok(cached);
+            }
+
            var user = await _db.Users.AsNoTracking().FirstOrDefaultAsync(x => x.Id == userId, cancellationToken);
            var cvText = user?.ProfileCvText;
            if (string.IsNullOrWhiteSpace(cvText))
@@ -1535,7 +1542,7 @@ Candidate CV/profile:
                    "Close with a clear expression of interest and availability."
                });

-            return Ok(new CandidateFitDto(
+            var dto = new CandidateFitDto(
                MatchSummary: matchSummary,
                FitLevel: fitLevel,
                MatchScore: matchScore,
@@ -1549,11 +1556,14 @@ Candidate CV/profile:
                TailoredPitch: tailoredPitch,
                Guidance: guidance,
                CoverLetterDraft: coverLetterDraft,
-                RecruiterMessageDraft: recruiterMessageDraft));
+                RecruiterMessageDraft: recruiterMessageDraft);
+
+            await SaveAiNoteAsync(userId, id, "candidate-fit", attachmentSignature, dto, cancellationToken);
+            return Ok(dto);
        }

        [HttpGet("{id:int}/focus-plan")]
-        public async Task<ActionResult<FocusPlanDto>> GetFocusPlan([FromRoute] int id, [FromQuery] string? attachmentIds, CancellationToken cancellationToken)
+        public async Task<ActionResult<FocusPlanDto>> GetFocusPlan([FromRoute] int id, [FromQuery] string? attachmentIds, [FromQuery] bool refresh, CancellationToken cancellationToken)
        {
            var job = await _db.JobApplications
                .AsNoTracking()
@@ -1564,6 +1574,13 @@ Candidate CV/profile:
            var userId = CurrentUserId;
            if (string.IsNullOrWhiteSpace(userId)) return Unauthorized();

+            var attachmentSignature = NormalizeAttachmentIdsSignature(attachmentIds);
+            if (!refresh)
+            {
+                var cached = await TryGetCachedAiNoteAsync<FocusPlanDto>(userId, id, "focus-plan", attachmentSignature, cancellationToken);
+                if (cached is not null) return Ok(cached);
+            }
+
            var user = await _db.Users.AsNoTracking().FirstOrDefaultAsync(x => x.Id == userId, cancellationToken);
            var cvText = user?.ProfileCvText;
            if (string.IsNullOrWhiteSpace(cvText))
@@ -1626,17 +1643,45 @@ Candidate master CV:

            var followUpApproach = BuildFollowUpApproach(job.Status, matchedTags, missingTags);

-            return Ok(new FocusPlanDto(
+            var dto = new FocusPlanDto(
                ImmediatePriorities: immediatePriorities,
                CvBulletIdeas: cvBulletIdeas,
                ProofPointsToLeadWith: proofPointsToLeadWith,
                CoverLetterAngles: coverLetterAngles,
                FollowUpApproach: followUpApproach,
-                StrategicSummary: strategicSummary));
+                StrategicSummary: strategicSummary);
+
+            await SaveAiNoteAsync(userId, id, "focus-plan", attachmentSignature, dto, cancellationToken);
+            return Ok(dto);
+        }
+
+        private async Task<T?> TryGetCachedAiNoteAsync<T>(string userId, int jobApplicationId, string noteType, string attachmentSignature, CancellationToken cancellationToken) where T : class
+        {
+            var existing = await _db.AiWorkspaceNotes.FirstOrDefaultAsync(
+                x => x.OwnerUserId == userId && x.JobApplicationId == jobApplicationId && x.NoteType == noteType && x.AttachmentContextSignature == attachmentSignature,
+                cancellationToken);
+            if (existing is null) return null;
+            return JsonSerializer.Deserialize<T>(existing.ResultJson);
+        }
+
+        private async Task SaveAiNoteAsync<T>(string userId, int jobApplicationId, string noteType, string attachmentSignature, T dto, CancellationToken cancellationToken)
+        {
+            var note = await _db.AiWorkspaceNotes.FirstOrDefaultAsync(
+                x => x.OwnerUserId == userId && x.JobApplicationId == jobApplicationId && x.NoteType == noteType,
+                cancellationToken);
+            if (note is null)
+            {
+                note = new AiWorkspaceNote { OwnerUserId = userId, JobApplicationId = jobApplicationId, NoteType = noteType };
+                _db.AiWorkspaceNotes.Add(note);
+            }
+            note.AttachmentContextSignature = attachmentSignature;
+            note.ResultJson = JsonSerializer.Serialize(dto);
+            note.GeneratedAtUtc = DateTimeOffset.UtcNow;
+            await _db.SaveChangesAsync(cancellationToken);
        }

        [HttpGet("{id:int}/interview-prep")]
-        public async Task<ActionResult<InterviewPrepDto>> GetInterviewPrep([FromRoute] int id, [FromQuery] string? attachmentIds, CancellationToken cancellationToken)
+        public async Task<ActionResult<InterviewPrepDto>> GetInterviewPrep([FromRoute] int id, [FromQuery] string? attachmentIds, [FromQuery] bool refresh, CancellationToken cancellationToken)
        {
            var job = await _db.JobApplications
                .AsNoTracking()
@@ -1644,6 +1689,24 @@ Candidate master CV:
                .FirstOrDefaultAsync(j => j.Id == id, cancellationToken);
            if (job is null) return NotFound();

+            var userId = CurrentUserId;
+            var attachmentSignature = NormalizeAttachmentIdsSignature(attachmentIds);
+
+            if (!refresh && userId is not null)
+            {
+                var existing = await _db.InterviewPrepNotes.FirstOrDefaultAsync(
+                    x => x.OwnerUserId == userId && x.JobApplicationId == id && x.AttachmentContextSignature == attachmentSignature,
+                    cancellationToken);
+                if (existing is not null)
+                {
+                    return Ok(new InterviewPrepDto(
+                        existing.Summary,
+                        JsonSerializer.Deserialize<List<string>>(existing.TalkingPointsJson) ?? new List<string>(),
+                        JsonSerializer.Deserialize<List<string>>(existing.LikelyQuestionsJson) ?? new List<string>(),
+                        JsonSerializer.Deserialize<List<string>>(existing.WeakSpotsJson) ?? new List<string>()));
+                }
+            }
+
            var attachmentContext = await BuildAttachmentContextAsync(id, cancellationToken, attachmentIds);
            var context = string.Join("\n\n", new[] { job.JobTitle, job.Company?.Name, job.Description, job.TranslatedDescription, job.Notes, job.ShortSummary, attachmentContext?.Context }
                .Where(x => !string.IsNullOrWhiteSpace(x)));
@@ -1662,9 +1725,34 @@ Candidate master CV:
                180,
                70) ?? "Prepare concise, outcome-focused stories that match the core role requirements.";

+            if (userId is not null)
+            {
+                var note = await _db.InterviewPrepNotes.FirstOrDefaultAsync(x => x.OwnerUserId == userId && x.JobApplicationId == id, cancellationToken);
+                if (note is null)
+                {
+                    note = new InterviewPrepNote { OwnerUserId = userId, JobApplicationId = id };
+                    _db.InterviewPrepNotes.Add(note);
+                }
+                note.AttachmentContextSignature = attachmentSignature;
+                note.Summary = summary;
+                note.TalkingPointsJson = JsonSerializer.Serialize(talkingPoints);
+                note.LikelyQuestionsJson = JsonSerializer.Serialize(likelyQuestions);
+                note.WeakSpotsJson = JsonSerializer.Serialize(weakSpots);
+                note.GeneratedAtUtc = DateTimeOffset.UtcNow;
+                await _db.SaveChangesAsync(cancellationToken);
+            }
+
            return Ok(new InterviewPrepDto(summary, talkingPoints, likelyQuestions, weakSpots));
        }

+        private static string NormalizeAttachmentIdsSignature(string? attachmentIds)
+        {
+            if (string.IsNullOrWhiteSpace(attachmentIds)) return string.Empty;
+            var ids = attachmentIds.Split(',', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
+                .OrderBy(x => x, StringComparer.Ordinal);
+            return string.Join(",", ids);
+        }
+
        [HttpGet("{id:int}/readiness")]
        public async Task<ActionResult<ReadinessDto>> GetReadiness([FromRoute] int id, CancellationToken cancellationToken)
        {
@@ -71,8 +71,9 @@ public sealed class ProfileCvController : ControllerBase
    private readonly ICvPdfExporter _cvPdfExporter;
    private readonly ICvProcessingQueue _cvProcessingQueue;
    private readonly IAppEmailSender _emailSender;
+    private readonly ICareerProfileService _careerProfileService;

-    public ProfileCvController(UserManager<ApplicationUser> users, ISummarizerService aiService, JobTrackerContext db, AppPaths paths, ILogger<ProfileCvController>? logger = null, ICvAiClassifier? cvAiClassifier = null, ICvAiNormalizer? cvAiNormalizer = null, ICvTemplateRenderer? cvTemplateRenderer = null, ICvPdfExporter? cvPdfExporter = null, ICvProcessingQueue? cvProcessingQueue = null, IAppEmailSender? emailSender = null)
+    public ProfileCvController(UserManager<ApplicationUser> users, ISummarizerService aiService, JobTrackerContext db, AppPaths paths, ILogger<ProfileCvController>? logger = null, ICvAiClassifier? cvAiClassifier = null, ICvAiNormalizer? cvAiNormalizer = null, ICvTemplateRenderer? cvTemplateRenderer = null, ICvPdfExporter? cvPdfExporter = null, ICvProcessingQueue? cvProcessingQueue = null, IAppEmailSender? emailSender = null, ICareerProfileService? careerProfileService = null)
    {
        _users = users;
        _aiService = aiService;
@@ -85,6 +86,7 @@ public sealed class ProfileCvController : ControllerBase
        _cvPdfExporter = cvPdfExporter ?? new ThrowingCvPdfExporter();
        _cvProcessingQueue = cvProcessingQueue ?? NoOpCvProcessingQueue.Instance;
        _emailSender = emailSender ?? NoOpEmailSender.Instance;
+        _careerProfileService = careerProfileService ?? new CareerProfileService(db);
    }

    private sealed class NoOpEmailSender : IAppEmailSender
@@ -113,6 +115,11 @@ public sealed class ProfileCvController : ControllerBase
        public string? Tone { get; set; }
        public string? Language { get; set; }
    }
+    // ParseCvRequest / CvTemplateDescriptor / ProfileCvPreviewDto / CvRewriteFailureDto are
+    // defined in ProfileCvDtos.cs on main (extracted after this branch forked). The branch's
+    // in-file copies are dropped here to avoid duplicate definitions. The LayoutFamily/AtsRating
+    // fields the branch added to CvTemplateDescriptor belong to the deferred ATS-badge work
+    // (Phase 4), not this foundation integration.
    private sealed record ExtractionPipelineResult(string RawText, string NormalizedText, StructuredCvProfile StructuredCv);
    private sealed record ClassifiedCvBlock(int Index, string OriginalBlock, string SectionName, string Content, CvBlockClassificationResult? Classification);

@@ -155,6 +162,7 @@ public sealed class ProfileCvController : ControllerBase
            result.StructuredCv.Metadata.ProfileVersion = (user.CurrentCvProfileVersion ?? 0) + 1;
            result.StructuredCv.Metadata.AppliedExtractionRunId = run.Id;
            result.StructuredCv.Metadata.UpdatedAtUtc = DateTimeOffset.UtcNow;
+            await _careerProfileService.SaveVersionAsync(user.Id, result.StructuredCv, "upload", HttpContext.RequestAborted);
            var structuredJson = StructuredCvProfileJson.Serialize(result.StructuredCv);

            run.RawExtractedText = result.RawText;
@@ -553,6 +561,8 @@ public sealed class ProfileCvController : ControllerBase

    private static IReadOnlyList<CvTemplateDescriptor> GetCvTemplateDescriptors()
    {
+        // 7-arg shape matches CvTemplateDescriptor in ProfileCvDtos.cs. The LayoutFamily/AtsRating
+        // fields the branch added here are deferred with the rest of the ATS-badge work (Phase 4).
        return new[]
        {
            new CvTemplateDescriptor("ats-minimal", "ATS Minimal", "Scanner-friendly", "slate", "Compact, direct, and easy to parse.", "Best for broad application flows and recruiter scanning.", new List<string> { "Tight hierarchy", "Keyword-friendly", "Low visual risk" }),
@@ -825,6 +835,7 @@ public sealed class ProfileCvController : ControllerBase
        structuredCv.Metadata.ProfileVersion = (user.CurrentCvProfileVersion ?? 0) + 1;
        structuredCv.Metadata.AppliedExtractionRunId = run.Id;
        structuredCv.Metadata.UpdatedAtUtc = DateTimeOffset.UtcNow;
+        await _careerProfileService.SaveVersionAsync(user.Id, structuredCv, trigger, cancellationToken);
        var structuredJson = StructuredCvProfileJson.Serialize(structuredCv);
        run.StructuredProfileJson = structuredJson;

@@ -965,6 +976,7 @@ public sealed class ProfileCvController : ControllerBase
        structuredCv.Metadata.ProfileVersion = (user.CurrentCvProfileVersion ?? 0) + 1;
        structuredCv.Metadata.AppliedExtractionRunId = run.Id;
        structuredCv.Metadata.UpdatedAtUtc = DateTimeOffset.UtcNow;
+        await _careerProfileService.SaveVersionAsync(user.Id, structuredCv, run.Trigger, cancellationToken);
        var structuredJson = StructuredCvProfileJson.Serialize(structuredCv);

        run.RawExtractedText = rawText;