Disco/Disco.Services/Plugins/Features/InsuranceProvider/InsuranceProviderFeature.cs

using Disco.Data.Repository;
using Disco.Models.BI.Config;
using Disco.Models.Repository;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web.Mvc;

namespace Disco.Services.Plugins.Features.InsuranceProvider
{
    [PluginFeatureCategory(DisplayName = "Insurance Providers")]
    public abstract class InsuranceProviderFeature : PluginFeature
    {
        /// <summary>
        /// The insurer identifier. Used to link this provider to any <see cref="JobMetaInsurance.Insurer"/>. This identifier is used to automatically set the Insurer when a job is submitted using this plugin.
        /// </summary>
        public abstract string ProviderId { get; }

        #region Job Submission

        /// <summary>
        /// Called when a user selects this plugin to submit the insurance claim and allows a plugin to inject a View to collect additional information.
        /// </summary>
        /// <returns>A Tuple consisting of the Razor View type and a View Model</returns>
        public virtual Tuple<Type, dynamic> SubmitJobBegin(DiscoDataContext database, Controller controller, Job job, OrganisationAddress address, User techUser)
        {
            return null;
        }

        /// <summary>
        /// Called after the RepairDescription is completed and allows the plugin to parse any data collected from SubmitJobBegin.
        /// </summary>
        /// <returns>A Dictionary of key/value items which are persisted throughout the submission and passed into the final SubmitJob method.</returns>
        public virtual Dictionary<string, string> SubmitJobParseProperties(DiscoDataContext database, FormCollection form, Controller controller, Job job, OrganisationAddress address, User techUser)
        {
            return null;
        }

        /// <summary>
        /// Plugins are required to disclose any information that will be transmitted to any external party. This method is expected to return a clear list all data which will be transmitted.
        /// </summary>
        /// <returns>A Dictionary of key/value items which contain all information which will be disclosed to the plugin provider.</returns>
        public abstract Dictionary<string, string> SubmitJobDiscloseInfo(DiscoDataContext database, Job job, OrganisationAddress address, User techUser, Dictionary<string, string> providerProperties);

        /// <summary>
        /// Called when the plugin should submit the job to the external party.
        /// </summary>
        /// <returns>A reference number/identifier from the external party which is stored in <see cref="JobMetaInsurance.InsurerReference"/></returns>
        public abstract string SubmitJob(DiscoDataContext database, Job job, OrganisationAddress address, User techUser, List<JobAttachment> attachments, Dictionary<string, string> providerProperties);

        #endregion

        #region Job Details

        /// <summary>
        /// <see cref="true"/> when additional Job Details are supported by the external party. When <see cref="true"/>, JobDetailsViewModel must be implemented.
        /// </summary>
        public abstract bool JobDetailsSupported { get; }

        /// <summary>
        /// Called when a job's insurance information is shown. Allows a plugin to inject a View to display additional information.
        /// </summary>
        /// <returns>A Tuple consisting of the Razor View type and a View Model</returns>
        public virtual Tuple<Type, dynamic> JobDetails(DiscoDataContext database, Controller controller, Job job)
        {
            return null;
        }

        #endregion

        public static PluginFeatureManifest FindPluginFeature(string pluginIdOrInsuranceProviderId)
        {
            var defs = Plugins.GetPluginFeatures(typeof(InsuranceProviderFeature));
            var def = defs.FirstOrDefault(d => d.PluginManifest.Id.Equals(pluginIdOrInsuranceProviderId, StringComparison.OrdinalIgnoreCase));
            if (def != null)
                return def;
            else
                foreach (var d in defs)
                {
                    using (var providerInstance = d.CreateInstance<InsuranceProviderFeature>())
                    {
                        if (providerInstance.ProviderId != null && providerInstance.ProviderId.Equals(pluginIdOrInsuranceProviderId, StringComparison.OrdinalIgnoreCase))
                        {
                            return d;
                        }
                    }
                }

            return null;
        }
    }
}