Added changelog and versioning

Added diagnostics page

Author: FrostyApeOne

CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+All notable changes to this service will be documented in this file.
+
+## [1.0.0] – Public Beta
+### Notes
+- First formally versioned public beta release.

src/DfE.ExternalApplications.Web/DfE.ExternalApplications.Web.csproj

@@ -1,25 +1,28 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
-  <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
-    <Nullable>enable</Nullable>
-    <ImplicitUsings>enable</ImplicitUsings>
-	<UserSecretsId>8051c984-585b-4a5e-b6d7-833e5dd4afe7</UserSecretsId>
-  </PropertyGroup>
+	<PropertyGroup>
+		<TargetFramework>net8.0</TargetFramework>
+		<Nullable>enable</Nullable>
+		<ImplicitUsings>enable</ImplicitUsings>
+		<UserSecretsId>8051c984-585b-4a5e-b6d7-833e5dd4afe7</UserSecretsId>
+		<Version>1.0.0</Version>
+		<InformationalVersion>1.0.0</InformationalVersion>
+		<IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
+	</PropertyGroup>
 
-  <ItemGroup>
-	  <PackageReference Include="GovUK.Dfe.CoreLibs.Security" Version="1.1.21-prerelease-15" />
-	  <PackageReference Include="GovUk.Frontend.AspNetCore" Version="3.2.2" />
-	  <PackageReference Include="HtmlSanitizer" Version="9.0.886" />
-	  <PackageReference Include="Markdig" Version="0.42.0" />
-	  <PackageReference Include="Microsoft.ApplicationInsights.AspNetCore" Version="2.22.0" />
-    <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
-  </ItemGroup>
+	<ItemGroup>
+		<PackageReference Include="GovUK.Dfe.CoreLibs.Security" Version="1.1.21-prerelease-15" />
+		<PackageReference Include="GovUk.Frontend.AspNetCore" Version="3.2.2" />
+		<PackageReference Include="HtmlSanitizer" Version="9.0.886" />
+		<PackageReference Include="Markdig" Version="0.42.0" />
+		<PackageReference Include="Microsoft.ApplicationInsights.AspNetCore" Version="2.22.0" />
+		<PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
+	</ItemGroup>
 
-  <ItemGroup>
-    <ProjectReference Include="..\DfE.ExternalApplications.Application\DfE.ExternalApplications.Application.csproj" />
-    <ProjectReference Include="..\DfE.ExternalApplications.Infrastructure\DfE.ExternalApplications.Infrastructure.csproj" />
-  </ItemGroup>
+	<ItemGroup>
+		<ProjectReference Include="..\DfE.ExternalApplications.Application\DfE.ExternalApplications.Application.csproj" />
+		<ProjectReference Include="..\DfE.ExternalApplications.Infrastructure\DfE.ExternalApplications.Infrastructure.csproj" />
+	</ItemGroup>
 
 
 </Project>

src/DfE.ExternalApplications.Web/Pages/Diagnostics.cshtml

@@ -0,0 +1,7 @@
+@page
+@model DfE.ExternalApplications.Web.Pages.DiagnosticsModel
+@{
+    Layout = null;
+}
+
+

src/DfE.ExternalApplications.Web/Pages/Diagnostics.cshtml.cs

@@ -0,0 +1,40 @@
+using System.Reflection;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.RazorPages;
+
+namespace DfE.ExternalApplications.Web.Pages;
+
+/// <summary>
+/// Diagnostics endpoint that returns basic runtime information as JSON.
+/// </summary>
+[AllowAnonymous]
+public class DiagnosticsModel(IHostEnvironment hostEnvironment) : PageModel
+{
+    /// <summary>
+    /// Returns service name, environment name, and the assembly informational version.
+    /// </summary>
+    public IActionResult OnGet()
+    {
+        var assembly = typeof(Program).Assembly;
+        var serviceName = assembly.GetName().Name ?? "Unknown";
+        var environmentName = hostEnvironment.EnvironmentName;
+
+        var informationalVersion = assembly
+            .GetCustomAttribute<AssemblyInformationalVersionAttribute>()
+            ?.InformationalVersion;
+
+        var version = string.IsNullOrWhiteSpace(informationalVersion)
+            ? (assembly.GetName().Version?.ToString() ?? "Unknown")
+            : informationalVersion;
+
+        return new JsonResult(new
+        {
+            service = serviceName,
+            environment = environmentName,
+            version
+        });
+    }
+}
+
+

src/DfE.ExternalApplications.Web/Program.cs

@@ -83,6 +83,8 @@
 
     options.Conventions.AuthorizeFolder("/", "OpenIdConnectPolicy");
     options.Conventions.AllowAnonymousToPage("/Logout");
+
+    options.Conventions.AuthorizePage("/Diagnostics");
 
     // Allow anonymous access to feedback pages
     options.Conventions.AllowAnonymousToPage("/Feedback/Index");