Introduced plugin interfaces.

Author: jgauffin

src/Server/Coderr.Server.Api/Core/Incidents/Queries/GetIncidentResult.cs

@@ -61,9 +61,9 @@ public string Description
         }
 
         /// <summary>
-        ///     Number of users that have written what they did when the error occurred.
+        ///     facts
         /// </summary>
-        public int FeedbackCount { get; set; }
+        public QuickFact[] Facts { get; set; }
 
         /// <summary>
         ///     Full name of the exception message.
@@ -112,6 +112,11 @@ public string Description
         /// </summary>
         public bool IsSolved => IncidentState == 3;
 
+        /// <summary>
+        ///     When we received the last report for this incident.
+        /// </summary>
+        public DateTime LastReportReceivedAtUtc { get; set; }
+
         /// <summary>
         ///     Solution written last time (if <see cref="IsReOpened" /> is <c>true</c>).
         /// </summary>
@@ -122,15 +127,11 @@ public string Description
         /// </summary>
         public DateTime ReOpenedAtUtc { get; set; }
 
-        /// <summary>
-        ///     Number of received reports.
-        /// </summary>
-        public int ReportCount { get; set; }
 
         /// <summary>
-        /// When we received the last report for this incident.
+        ///     Number of reports received to date.
         /// </summary>
-        public DateTime LastReportReceivedAtUtc { get; set; }
+        public int ReportCount { get; set; }
 
         /// <summary>
         ///     Generated hash code
@@ -162,9 +163,7 @@ public string Description
         /// </summary>
         public DateTime UpdatedAtUtc { get; private set; }
 
-        /// <summary>
-        ///     Number of users that have supplied their email address
-        /// </summary>
-        public int WaitingUserCount { get; set; }
+        public SuggestedIncidentSolution[] SuggestedSolutions { get; set; }
+        public HighlightedContextData[] HighlightedContextData { get; set; }
     }
 }

src/Server/Coderr.Server.Api/Core/Incidents/Queries/HighlightedContextData.cs

@@ -0,0 +1,36 @@
+namespace codeRR.Server.Api.Core.Incidents.Queries
+{
+    /// <summary>
+    ///     Context data that can help the developer to directly understand why the exception happened.
+    /// </summary>
+    /// <remarks>
+    ///     <para>
+    ///         For instance for Page Not Found this is the URL and the Referrer.
+    ///     </para>
+    /// </remarks>
+    public class HighlightedContextData
+    {
+        /// <summary>
+        ///     Why this data helps and what it means.
+        /// </summary>
+        public string Description { get; set; }
+
+        /// <summary>
+        ///     Name ("UrlReferrer", "Url", "HttpCode" etc).
+        /// </summary>
+        public string Name { get; set; }
+
+        /// <summary>
+        ///     Optional url that the user can click on to get more information
+        /// </summary>
+        public string Url { get; set; }
+
+        /// <summary>
+        ///     Value to show
+        /// </summary>
+        /// <remarks>
+        ///     Values should be sorted i priority order (first item will be displayed directly)
+        /// </remarks>
+        public string[] Value { get; set; }
+    }
+}

src/Server/Coderr.Server.Api/Core/Incidents/Queries/QuickFact.cs

@@ -0,0 +1,36 @@
+namespace codeRR.Server.Api.Core.Incidents.Queries
+{
+    /// <summary>
+    ///     Quick fact for incidents.
+    /// </summary>
+    /// <remarks>
+    ///     <para>
+    ///         For instance number of reports, when the incident was created, number of affected users etc.
+    ///     </para>
+    /// </remarks>
+    public class QuickFact
+    {
+        /// <summary>
+        ///     what this fact displays
+        /// </summary>
+        public string Description { get; set; }
+
+        /// <summary>
+        ///     Fact title (heading)
+        /// </summary>
+        public string Title { get; set; }
+
+        /// <summary>
+        ///     Optional url to get more information.
+        /// </summary>
+        public string Url { get; set; }
+
+        /// <summary>
+        ///     Value to show
+        /// </summary>
+        /// <remarks>
+        ///     For multiple values; separate them with semi colons.
+        /// </remarks>
+        public string Value { get; set; }
+    }
+}

src/Server/Coderr.Server.Api/Core/Incidents/Queries/SuggestedIncidentSolution.cs

@@ -0,0 +1,19 @@
+namespace codeRR.Server.Api.Core.Incidents.Queries
+{
+    /// <summary>
+    ///     A suggested solution for the incident
+    /// </summary>
+    public class SuggestedIncidentSolution
+    {
+        /// <summary>
+        ///     Common reasons to why this exception is thrown.
+        /// </summary>
+        public string Reason { get; set; }
+
+
+        /// <summary>
+        ///     How the incident can be solved.
+        /// </summary>
+        public string SuggestedSolution { get; set; }
+    }
+}

src/Server/Coderr.Server.App/Modules/Versions/IVersionRepository.cs

@@ -29,7 +29,7 @@ public interface IVersionRepository
         Task CreateAsync(ApplicationVersion entity);
 
         /// <summary>
-        ///     Get monhtly exception report
+        ///     Get monthly exception report
         /// </summary>
         /// <param name="applicationId">Application id</param>
         /// <param name="year">Year, four digits</param>
@@ -41,7 +41,7 @@ public interface IVersionRepository
         Task<ApplicationVersionMonth> FindMonthForApplicationAsync(int applicationId, int year, int month);
 
         /// <summary>
-        ///     Hämta version
+        ///     Get version
         /// </summary>
         /// <param name="applicationId">id for the application that we want to fetch a version for</param>
         /// <param name="version">Version (<c>"1.0.0"</c>)</param>
@@ -50,6 +50,16 @@ public interface IVersionRepository
         /// <exception cref="DbException">Failed to query DB</exception>
         Task<ApplicationVersion> FindVersionAsync(int applicationId, string version);
 
+        /// <summary>
+        ///     Get version
+        /// </summary>
+        /// <param name="incidentId">Incident to get versions for</param>
+        /// <returns>version if found; otherwise <c>null</c></returns>
+        /// <exception cref="ArgumentNullException">applicationId;version</exception>
+        /// <exception cref="DbException">Failed to query DB</exception>
+        Task<IList<ApplicationVersion>> FindForIncidentAsync(int incidentId);
+
+
         /// <summary>
         ///     Update an existing monthly report
         /// </summary>

src/Server/Coderr.Server.App/Modules/Versions/QuickFactsProvider.cs

@@ -0,0 +1,43 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Threading.Tasks;
+using codeRR.Server.Api.Core.Incidents.Queries;
+using Coderr.Server.PluginApi;
+using Griffin.Container;
+
+namespace codeRR.Server.App.Modules.Versions
+{
+    [Component]
+    class QuickFactsProvider : IQuickfactProvider
+    {
+        private IVersionRepository _repository;
+
+        public QuickFactsProvider(IVersionRepository repository)
+        {
+            _repository = repository;
+        }
+
+        public async Task AssignAsync(int incidentId, ICollection<QuickFact> facts)
+        {
+            var versions = await _repository.FindForIncidentAsync(incidentId);
+            if (!versions.Any())
+            {
+                facts.Add(new QuickFact
+                {
+                    Title = "Versions",
+                    Value = "<em class=\"text-muted\">(This feature is activated in admin)</em>"
+                });
+                return;
+            }
+
+            facts.Add(new QuickFact
+            {
+                Title = "Versions",
+                Description = "Application versions that this incident have been detected in.",
+                Value = string.Join(", ", versions.Select(x => "v" + x.Version))
+            });
+        }
+    }
+}

src/Server/Coderr.Server.App/codeRR.Server.App.csproj

@@ -18,6 +18,7 @@
   <ItemGroup>
     <ProjectReference Include="..\Coderr.Server.Api\codeRR.Server.Api.csproj" />
     <ProjectReference Include="..\Coderr.Server.Infrastructure\codeRR.Server.Infrastructure.csproj" />
+    <ProjectReference Include="..\Coderr.Server.PluginApi\Coderr.Server.PluginApi.csproj" />
   </ItemGroup>
   <ItemGroup>
     <Reference Include="System.Management" />

src/Server/Coderr.Server.PluginApi/Coderr.Server.PluginApi.csproj

@@ -0,0 +1,11 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFrameworks>netstandard2.0;net452</TargetFrameworks>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Coderr.Server.Api\codeRR.Server.Api.csproj" />
+  </ItemGroup>
+
+</Project>

src/Server/Coderr.Server.PluginApi/IHighlightedContextDataProvider.cs

@@ -0,0 +1,11 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using codeRR.Server.Api.Core.Incidents.Queries;
+
+namespace Coderr.Server.PluginApi
+{
+    public interface IHighlightedContextDataProvider
+    {
+        Task CollectAsync(int incidentId, ICollection<HighlightedContextData> data);
+    }
+}

src/Server/Coderr.Server.PluginApi/IQuickfactProvider.cs

@@ -0,0 +1,12 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using codeRR.Server.Api.Core.Incidents.Queries;
+
+namespace Coderr.Server.PluginApi
+{
+    public interface IQuickfactProvider
+    {
+        Task AssignAsync(int incidentId, ICollection<QuickFact> facts);
+    }
+}