Add CV template preview and PDF export pipeline

This commit is contained in:
2026-03-29 00:43:54 +01:00
parent 2392b135c2
commit 839a2ed80d
15 changed files with 2288 additions and 97 deletions
@@ -0,0 +1,341 @@
using System.Net;
using System.Text;
using JobTrackerApi.Models;
namespace JobTrackerApi.Services;
public sealed record TailoredCvRenderResult(string TemplateId, string SuggestedFileName, string Html);
public interface ICvTemplateRenderer
{
TailoredCvRenderResult Render(TailoredCvDocument? document, string? templateId, string candidateName, string jobTitle, string? companyName, string? photoDataUrl = null);
}
public sealed class CvTemplateRenderer : ICvTemplateRenderer
{
public TailoredCvRenderResult Render(TailoredCvDocument? document, string? templateId, string candidateName, string jobTitle, string? companyName, string? photoDataUrl = null)
{
var normalized = TailoredCvDraftJson.Normalize(document);
var effectiveTemplateId = NormalizeTemplateId(templateId ?? normalized.TemplateId);
normalized.TemplateId = effectiveTemplateId;
var suggestedFileName = Slugify($"{candidateName}-{jobTitle}-{effectiveTemplateId}") + ".pdf";
var html = effectiveTemplateId switch
{
"harvard" => RenderHarvard(normalized, candidateName, jobTitle, companyName),
"auckland" => RenderSidebar(normalized, candidateName, jobTitle, companyName, photoDataUrl, "Auckland", roundedPhoto: false, curvedHeader: false),
"edinburgh" => RenderSidebar(normalized, candidateName, jobTitle, companyName, photoDataUrl, "Edinburgh", roundedPhoto: true, curvedHeader: true),
_ => RenderAtsMinimal(normalized, candidateName, jobTitle, companyName, photoDataUrl)
};
return new TailoredCvRenderResult(effectiveTemplateId, suggestedFileName, html);
}
private static string NormalizeTemplateId(string? value)
{
var normalized = (value ?? string.Empty).Trim().ToLowerInvariant();
return normalized switch
{
"base" => "ats-minimal",
"legacy-text" => "ats-minimal",
"harvard" => "harvard",
"auckland" => "auckland",
"edinburgh" => "edinburgh",
_ => "ats-minimal"
};
}
private static string RenderAtsMinimal(TailoredCvDocument document, string candidateName, string jobTitle, string? companyName, string? photoDataUrl)
{
var accent = ResolveAccent(document.RenderOptions.AccentColor);
var showPhoto = document.RenderOptions.ShowPhoto && !string.IsNullOrWhiteSpace(photoDataUrl);
var body = RenderMainSections(document, accent, headingStyle: "caps-rule");
var companyFocusMarkup = string.IsNullOrWhiteSpace(companyName) ? string.Empty : $"<span>Company focus: {Encode(companyName)}</span>";
var photoMarkup = showPhoto ? $"<div class=\"photo\"><img src=\"{EncodeAttribute(photoDataUrl)}\" alt=\"Profile photo\" /></div>" : string.Empty;
return $@"<!DOCTYPE html>
<html lang=""en"">
<head>
<meta charset=""utf-8"" />
<title>{Encode(candidateName)} — ATS Minimal</title>
<style>
:root {{ --accent:{accent}; --ink:#111827; --muted:#4b5563; --line:#d1d5db; --paper:#fff; }}
* {{ box-sizing:border-box; }}
body {{ margin:0; background:#eef2f7; color:var(--ink); font-family:Georgia, 'Times New Roman', serif; -webkit-print-color-adjust:exact; print-color-adjust:exact; }}
.page {{ width:210mm; min-height:297mm; margin:0 auto; background:var(--paper); padding:16mm; }}
.header {{ display:grid; grid-template-columns:1fr auto; gap:6mm; border-bottom:2px solid var(--accent); padding-bottom:8mm; margin-bottom:7mm; }}
.name {{ margin:0; font-size:25pt; letter-spacing:.02em; }}
.headline {{ margin-top:2mm; color:var(--muted); font-size:11pt; }}
.meta {{ margin-top:3mm; display:flex; flex-wrap:wrap; gap:3mm; color:var(--muted); font-size:9pt; }}
.photo {{ width:28mm; height:36mm; border-radius:5mm; overflow:hidden; border:1px solid var(--line); }}
.photo img {{ width:100%; height:100%; object-fit:cover; display:block; }}
{BaseSectionCss(accent, "caps-rule")}
@page {{ size:A4; margin:0; }}
</style>
</head>
<body>
<main class=""page"">
<header class=""header"">
<div>
<h1 class=""name"">{Encode(candidateName)}</h1>
<div class=""headline"">{Encode(document.Headline ?? jobTitle)}</div>
<div class=""meta""><span>Target role: {Encode(jobTitle)}</span>{companyFocusMarkup}<span>Template: ATS Minimal</span></div>
</div>
{photoMarkup}
</header>
{body}
</main>
</body>
</html>";
}
private static string RenderHarvard(TailoredCvDocument document, string candidateName, string jobTitle, string? companyName)
{
var accent = ResolveAccent(document.RenderOptions.AccentColor);
var body = RenderMainSections(document, accent, headingStyle: "harvard");
var contactLine = string.Join(" &nbsp;•&nbsp; ", new[]
{
string.IsNullOrWhiteSpace(companyName) ? null : $"Targeting {Encode(companyName)}",
Encode(jobTitle)
}.Where(x => !string.IsNullOrWhiteSpace(x)));
return $@"<!DOCTYPE html>
<html lang=""en"">
<head>
<meta charset=""utf-8"" />
<title>{Encode(candidateName)} — Harvard</title>
<style>
:root {{ --accent:{accent}; --ink:#111; --muted:#333; --line:#111; --paper:#fff; }}
* {{ box-sizing:border-box; }}
body {{ margin:0; background:#f5f5f5; color:var(--ink); font-family:Georgia, 'Times New Roman', serif; -webkit-print-color-adjust:exact; print-color-adjust:exact; }}
.page {{ width:210mm; min-height:297mm; margin:0 auto; background:#fff; padding:16mm 18mm; }}
.header {{ text-align:center; margin-bottom:6mm; }}
.name {{ margin:0; font-size:23pt; font-weight:700; }}
.headline {{ margin-top:2mm; font-size:10pt; font-style:italic; }}
.meta {{ margin-top:4mm; font-size:9pt; }}
{BaseSectionCss(accent, "harvard")}
.section-title {{ color:var(--ink); }}
@page {{ size:A4; margin:0; }}
</style>
</head>
<body>
<main class=""page"">
<header class=""header"">
<h1 class=""name"">{Encode(candidateName)}</h1>
<div class=""headline"">{Encode(document.Headline ?? jobTitle)}</div>
<div class=""meta"">{contactLine}</div>
</header>
{body}
</main>
</body>
</html>";
}
private static string RenderSidebar(TailoredCvDocument document, string candidateName, string jobTitle, string? companyName, string? photoDataUrl, string templateLabel, bool roundedPhoto, bool curvedHeader)
{
var accent = ResolveAccent(document.RenderOptions.AccentColor);
var showPhoto = document.RenderOptions.ShowPhoto && !string.IsNullOrWhiteSpace(photoDataUrl);
var sidebarSections = new StringBuilder();
sidebarSections.Append(RenderSidebarMetaSection("Personal Details", new[]
{
$"Name\n{Encode(candidateName)}",
$"Target role\n{Encode(jobTitle)}",
string.IsNullOrWhiteSpace(companyName) ? null : $"Company focus\n{Encode(companyName)}"
}));
if (document.CustomSections.Count > 0)
{
foreach (var section in document.CustomSections.Take(2))
{
sidebarSections.Append(RenderSidebarMetaSection(section.Title ?? "Additional", section.Items));
}
}
if (document.SelectedSkills.Count > 0)
{
sidebarSections.Append(RenderSidebarMetaSection("Skills", document.SelectedSkills.Take(8)));
}
var main = RenderMainSections(document, accent, headingStyle: "sidebar");
var photoClass = roundedPhoto ? "photo round" : "photo";
var photoMarkup = showPhoto ? $"<div class=\"{photoClass}\"><img src=\"{EncodeAttribute(photoDataUrl)}\" alt=\"Profile photo\" /></div>" : string.Empty;
var heroClass = curvedHeader ? "hero curved" : "hero";
return $@"<!DOCTYPE html>
<html lang=""en"">
<head>
<meta charset=""utf-8"" />
<title>{Encode(candidateName)} — {Encode(templateLabel)}</title>
<style>
:root {{ --accent:{accent}; --ink:#1f2937; --muted:#4b5563; --line:#d1d5db; --sidebar:#f3f4f6; --paper:#fff; }}
* {{ box-sizing:border-box; }}
body {{ margin:0; background:#edf2f7; color:var(--ink); font-family:Arial, Helvetica, sans-serif; -webkit-print-color-adjust:exact; print-color-adjust:exact; }}
.page {{ width:210mm; min-height:297mm; margin:0 auto; background:#fff; display:grid; grid-template-columns:34% 66%; }}
.sidebar {{ background:linear-gradient(180deg, var(--accent), color-mix(in srgb, var(--accent) 8%, white)); color:#fff; padding:12mm 8mm 12mm 10mm; }}
.hero {{ margin:-12mm -8mm 8mm -10mm; padding:10mm 10mm 8mm 10mm; background:var(--accent); }}
.hero.curved {{ border-bottom-right-radius:28mm; }}
.name {{ margin:0; font-size:18pt; letter-spacing:.08em; font-weight:700; }}
.headline {{ margin-top:2mm; font-size:10pt; opacity:.95; }}
.photo {{ width:34mm; height:34mm; margin-top:6mm; border:2px solid rgba(255,255,255,.85); overflow:hidden; }}
.photo.round {{ border-radius:50%; }}
.photo img {{ width:100%; height:100%; object-fit:cover; display:block; }}
.sidebar-section {{ margin-top:7mm; }}
.sidebar-title {{ margin:0 0 3mm 0; font-size:9pt; text-transform:uppercase; letter-spacing:.16em; }}
.sidebar-item {{ margin:0 0 2.4mm 0; font-size:8.8pt; line-height:1.4; white-space:pre-line; }}
.content {{ padding:14mm 14mm 14mm 10mm; }}
{BaseSectionCss(accent, "sidebar")}
@page {{ size:A4; margin:0; }}
</style>
</head>
<body>
<main class=""page"">
<aside class=""sidebar"">
<div class=""{heroClass}"">
<h1 class=""name"">{Encode(candidateName)}</h1>
<div class=""headline"">{Encode(document.Headline ?? jobTitle)}</div>
{photoMarkup}
</div>
{sidebarSections}
</aside>
<section class=""content"">
{main}
</section>
</main>
</body>
</html>";
}
private static string RenderMainSections(TailoredCvDocument document, string accent, string headingStyle)
{
var sectionOrder = document.RenderOptions.SectionOrder.Count == 0
? new List<string> { "summary", "skills", "experience", "education", "custom" }
: document.RenderOptions.SectionOrder;
var sections = new Dictionary<string, string>(StringComparer.OrdinalIgnoreCase)
{
["summary"] = RenderListSection("Profile", document.Summary, bulletList: true),
["skills"] = RenderSkillSection(document.SelectedSkills),
["experience"] = RenderExperienceSection(document.Experience),
["education"] = RenderEducationSection(document.Education),
["custom"] = string.Join(string.Empty, document.CustomSections.Select(RenderCustomSection)),
};
return string.Join(string.Empty, sectionOrder
.Select(key => sections.TryGetValue(key, out var section) ? section : string.Empty)
.Where(section => !string.IsNullOrWhiteSpace(section)));
}
private static string BaseSectionCss(string accent, string headingStyle)
{
var headingCss = headingStyle switch
{
"harvard" => ".section-title{font-size:17pt;font-weight:700;border-bottom:1.5px solid var(--line);padding-bottom:1.5mm;margin-bottom:3mm;}",
"sidebar" => ".section-title{font-size:14pt;font-weight:700;letter-spacing:.02em;margin-bottom:3mm;}",
_ => ".section-title{font-size:9pt;letter-spacing:.16em;text-transform:uppercase;color:var(--accent);border-bottom:1px solid var(--line);padding-bottom:1.5mm;margin-bottom:3mm;}"
};
return $@"
.section{{margin-top:6mm;}}
{headingCss}
.summary,.custom-list,.education-list,.experience-bullets{{margin:0;padding-left:4.5mm;}}
.summary li,.custom-list li,.education-list li,.experience-bullets li{{margin:0 0 1.6mm 0;line-height:1.42;}}
.skills{{list-style:none;padding-left:0;display:flex;flex-wrap:wrap;gap:2mm;}}
.skill-pill{{border:1px solid var(--line);border-radius:999px;padding:1mm 2.4mm;font-size:9pt;}}
.entry{{margin-bottom:4.8mm;}}
.entry-header{{display:flex;justify-content:space-between;gap:4mm;align-items:baseline;margin-bottom:1.2mm;}}
.entry-title{{font-weight:700;font-size:11pt;}}
.entry-meta{{color:var(--muted);font-size:9pt;text-align:right;white-space:nowrap;}}
.entry-subtitle{{color:var(--muted);font-size:9.5pt;margin-bottom:1.3mm;}}";
}
private static string RenderSidebarMetaSection(string title, IEnumerable<string?> items)
{
var content = string.Join(string.Empty, items.Where(item => !string.IsNullOrWhiteSpace(item)).Select(item => $"<p class=\"sidebar-item\">{item}</p>"));
if (string.IsNullOrWhiteSpace(content)) return string.Empty;
return $"<section class=\"sidebar-section\"><h2 class=\"sidebar-title\">{Encode(title)}</h2>{content}</section>";
}
private static string RenderListSection(string title, IReadOnlyCollection<string> items, bool bulletList)
{
if (items.Count == 0) return string.Empty;
var tag = bulletList ? "summary" : "custom-list";
return $"<section class=\"section\"><h2 class=\"section-title\">{Encode(title)}</h2><ul class=\"{tag}\">{string.Join(string.Empty, items.Select(item => $"<li>{Encode(item)}</li>"))}</ul></section>";
}
private static string RenderSkillSection(IReadOnlyCollection<string> skills)
{
if (skills.Count == 0) return string.Empty;
return $"<section class=\"section\"><h2 class=\"section-title\">Skills</h2><ul class=\"skills\">{string.Join(string.Empty, skills.Select(skill => $"<li class=\"skill-pill\">{Encode(skill)}</li>"))}</ul></section>";
}
private static string RenderExperienceSection(IReadOnlyCollection<TailoredCvExperienceItem> experience)
{
if (experience.Count == 0) return string.Empty;
var items = new StringBuilder();
foreach (var entry in experience)
{
var subtitle = string.Join(" · ", new[] { entry.Company, entry.Location }.Where(x => !string.IsNullOrWhiteSpace(x)).Select(Encode));
var dateRange = FormatDateRange(entry.Start, entry.End, entry.IsCurrent);
items.Append("<article class=\"entry\">");
items.Append($"<div class=\"entry-header\"><div class=\"entry-title\">{Encode(entry.Title)}</div><div class=\"entry-meta\">{Encode(dateRange)}</div></div>");
if (!string.IsNullOrWhiteSpace(subtitle)) items.Append($"<div class=\"entry-subtitle\">{subtitle}</div>");
if (entry.Bullets.Count > 0) items.Append($"<ul class=\"experience-bullets\">{string.Join(string.Empty, entry.Bullets.Select(bullet => $"<li>{Encode(bullet)}</li>"))}</ul>");
items.Append("</article>");
}
return $"<section class=\"section\"><h2 class=\"section-title\">Professional Experience</h2>{items}</section>";
}
private static string RenderEducationSection(IReadOnlyCollection<TailoredCvEducationItem> education)
{
if (education.Count == 0) return string.Empty;
var items = new StringBuilder();
foreach (var entry in education)
{
var subtitle = string.Join(" · ", new[] { entry.Institution, entry.Location, FormatDateRange(entry.Start, entry.End, false) }
.Where(x => !string.IsNullOrWhiteSpace(x))
.Select(Encode));
items.Append("<article class=\"entry\">");
items.Append($"<div class=\"entry-title\">{Encode(entry.Qualification)}</div>");
if (!string.IsNullOrWhiteSpace(subtitle)) items.Append($"<div class=\"entry-subtitle\">{subtitle}</div>");
if (entry.Details.Count > 0) items.Append($"<ul class=\"education-list\">{string.Join(string.Empty, entry.Details.Select(detail => $"<li>{Encode(detail)}</li>"))}</ul>");
items.Append("</article>");
}
return $"<section class=\"section\"><h2 class=\"section-title\">Education</h2>{items}</section>";
}
private static string RenderCustomSection(TailoredCvCustomSection section)
{
if (section.Items.Count == 0) return string.Empty;
return $"<section class=\"section\"><h2 class=\"section-title\">{Encode(section.Title ?? "Additional Information")}</h2><ul class=\"custom-list\">{string.Join(string.Empty, section.Items.Select(item => $"<li>{Encode(item)}</li>"))}</ul></section>";
}
private static string FormatDateRange(string? start, string? end, bool isCurrent)
{
var normalizedStart = (start ?? string.Empty).Trim();
var normalizedEnd = (end ?? string.Empty).Trim();
if (string.IsNullOrWhiteSpace(normalizedStart) && string.IsNullOrWhiteSpace(normalizedEnd)) return string.Empty;
if (string.IsNullOrWhiteSpace(normalizedStart)) return normalizedEnd;
return $"{normalizedStart} - {(isCurrent ? "Present" : string.IsNullOrWhiteSpace(normalizedEnd) ? "Present" : normalizedEnd)}";
}
private static string ResolveAccent(string? accentColor)
{
var normalized = (accentColor ?? string.Empty).Trim().ToLowerInvariant();
return normalized switch
{
"slate" => "#334155",
"blue" => "#1d4ed8",
"emerald" => "#047857",
"plum" => "#7c3aed",
"brick" => "#b45309",
_ when normalized.StartsWith("#") => normalized,
_ => "#334155"
};
}
private static string Encode(string? value) => WebUtility.HtmlEncode(value ?? string.Empty);
private static string EncodeAttribute(string? value) => WebUtility.HtmlEncode(value ?? string.Empty).Replace("'", "&#39;", StringComparison.Ordinal);
private static string Slugify(string value)
{
var cleaned = new string((value ?? string.Empty).ToLowerInvariant().Select(ch => char.IsLetterOrDigit(ch) ? ch : '-').ToArray());
while (cleaned.Contains("--", StringComparison.Ordinal)) cleaned = cleaned.Replace("--", "-", StringComparison.Ordinal);
return cleaned.Trim('-');
}
}