jobtrackingapp/Models/Job.cs

using System;

namespace JobTrackerApi.Models
{
    /// <summary>
    /// A job opportunity — the role as the employer posted it, independent of whether the user
    /// has applied. Separated from <see cref="JobApplication"/> (the user's pursuit of a job) so
    /// that:
    ///   - a job can be tracked before it is applied to (see JobPipeline's Prospect stages), and
    ///   - applying twice to the same role does not duplicate the whole job description.
    ///
    /// Introduced in Phase 0 (2026-07-17) as an additive step. Nothing reads from this table yet:
    /// <see cref="JobApplication"/> still carries its own copy of these columns and remains the
    /// source of truth for all current reads and writes. The cutover (dual-write, then flip reads,
    /// then drop the legacy columns) is Phase 1 work.
    ///
    /// See docs/decisions/ADR-002-job-application-model.md.
    /// </summary>
    public class Job
    {
        public int Id { get; set; }
        public string? OwnerUserId { get; set; }

        public int CompanyId { get; set; }
        public Company Company { get; set; } = null!;

        public string JobTitle { get; set; } = "";
        public string? Location { get; set; }
        public string? JobUrl { get; set; }

        // Imported job content.
        public string? Description { get; set; }
        public string? TranslatedDescription { get; set; }
        public string? DescriptionLanguage { get; set; } // "en", "no", ...
        public string? ShortSummary { get; set; }
        public string? Tags { get; set; } // JSON array string, e.g. ["Azure","Docker"]
        public DateTime? Deadline { get; set; }

        // Structured salary; the free-text Salary field is kept for display/back-compat.
        public string? Salary { get; set; }
        public decimal? SalaryMin { get; set; }
        public decimal? SalaryMax { get; set; }
        public string? SalaryCurrency { get; set; } // e.g. "NOK", "GBP", "EUR"
        public string? SalaryPeriod { get; set; }   // "year" | "month" | "hour"

        // Where this job came from. Market is data, not an assumption: Jobjakt is Norway-first
        // but must not hardcode Norway, so country travels with the job rather than being
        // implied by the importer. Null = unknown/manually entered.
        public string? Source { get; set; }      // e.g. "finn", "nav", "linkedin", "manual"
        public string? CountryCode { get; set; } // ISO 3166-1 alpha-2, e.g. "NO", "GB"

        /// <summary>When the user first captured this opportunity.</summary>
        public DateTime SavedAt { get; set; } = DateTime.UtcNow;

        public List<JobApplication> Applications { get; set; } = new();
    }
}