claude
99e5cfb76b
Closes #41 - Add RequireKeywordInAnchor per-provider flag (default true); set false for ejobs.ro and bestjobs.eu so Stage 2 anchor-text filter is skipped — their search URL already filters by relevance server-side - Update AI system prompts (en + ro) to extract concise job-board-friendly keywords (role title + key tech, not abstract concepts) and candidate location - Propagate location through JobMatchResponse -> CreateJobSearchTokenRequest -> JobSearchTokenEntity -> JobSearchSessionEntity - Add {location} and {location-slug} substitution in HtmlJobSearcher - Update provider SearchUrlTemplates to include location: ejobs.ro: /locuri-de-munca/{location-slug}?q={keywords} bestjobs.eu: /ro/locuri-de-munca-in-{location-slug}?keywords={keywords} linkedin.com: ?keywords={keywords}&location={location} - Three new migrations: AddRequireKeywordInAnchorAndLocation, ImproveKeywordsAndAddLocation, AddLocationToProviders Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
35 lines
1.8 KiB
C#
35 lines
1.8 KiB
C#
namespace Api.Services.Contracts;
|
|
|
|
/// <summary>
|
|
/// Manages one-time job search tokens and the sessions they trigger.
|
|
/// </summary>
|
|
public interface IJobTokenService
|
|
{
|
|
/// <summary>
|
|
/// Creates a new single-use job search token linked to the given CV document and user.
|
|
/// The token expires after the number of days configured in <c>JobSearch:TokenExpiryDays</c>.
|
|
/// </summary>
|
|
/// <param name="cvDocumentId">Identifier of the indexed CV document.</param>
|
|
/// <param name="email">Email address of the user who will receive the results.</param>
|
|
/// <param name="language">Preferred language for result emails (e.g. <c>"en"</c>, <c>"ro"</c>).</param>
|
|
/// <param name="keywords">Job search keywords extracted by the LLM during the match call.</param>
|
|
/// <param name="location">Candidate location extracted from the CV (e.g. "Cluj-Napoca, Romania"). Null if not available.</param>
|
|
/// <param name="ct">Cancellation token.</param>
|
|
/// <returns>
|
|
/// The generated token ID to embed in the one-click job search link,
|
|
/// or <c>null</c> when no job providers are currently enabled (link should be suppressed).
|
|
/// </returns>
|
|
Task<string?> CreateTokenAsync(string cvDocumentId, string email, string language, IReadOnlyList<string> keywords, string? location, CancellationToken ct);
|
|
|
|
/// <summary>
|
|
/// Validates the token and, if valid, marks it as used and creates a <c>Pending</c> job search session.
|
|
/// </summary>
|
|
/// <param name="tokenId">The token ID from the one-click link.</param>
|
|
/// <param name="ct">Cancellation token.</param>
|
|
/// <returns>
|
|
/// One of the <c>StartJobSearchStatus</c> string constants:
|
|
/// <c>Started</c>, <c>AlreadyUsed</c>, <c>Expired</c>, or <c>NotFound</c>.
|
|
/// </returns>
|
|
Task<string> TriggerStartAsync(string tokenId, CancellationToken ct);
|
|
}
|