using TechKey = Volpe.Cafe.TechKeys.TechKey128;

namespace Volpe.Cafe.MarketData.Design
{
    /// <summary>
    /// Defines a revision of an <see cref="IOEMProduct"/> produced by a manufacturer, with descriptions of its
    /// engineering characteristics and/or compliance attributes for a specific model year.
    /// </summary>
    /// <seealso cref="IOEMProduct"/>
    /// <seealso cref="IOEMProductInfo"/>
    public interface IOEMProductRevision : IOEMProductInfo
    {
        /// <summary>
        /// Gets the underlying <see cref="IOEMProduct"/> associated with this product revision.
        /// </summary>
        IOEMProduct Product { get; }

        /// <summary>
        /// Gets a description of baseline engineering characteristics for the <see cref="IOEMProduct"/> associated
        /// with this product revision.
        /// </summary>
        IOEMProductInfo BaselineInfo { get; }

        /// <summary>
        /// Gets the model year associated with this product revision.
        /// </summary>
        int RevisionYear { get; }

        /// <summary>
        /// Gets or sets the technology key, representing the technology configuration of this product revision.
        /// </summary>
        new TechKey TechKey { get; set; }

        /// <summary>
        /// Copies the revision data from the specified product revision to this instance.
        /// </summary>
        /// <param name="revision">The product revision to use for updating this instance.</param>
        void CopyFrom(IOEMProductRevision revision);

    }
}
