feat: Polish Sprint v0.3.0 — release workflow, restore command, assignee field, Redis caching (#125)

Closes #121
Closes #122
Closes #123
Closes #124

## Polish Sprint v0.3.0 Changes

### A1 — Release workflow consolidation
- Added `gh release create` step to `squad-milestone-release.yml`

### A2 — RestoreIssueCommand
- New `RestoreIssueCommand` + sealed handler
- Admin-only Restore button on issue Details page
- 5 unit tests

### A3 — Assignee field
- Added `Assignee (UserInfo)` to `Issue` model; `Assignee (UserDto)` to `IssueDto`
- Updated `IssueMapper`, `IssueConfiguration` (EF Core MongoDB `OwnsOne`)
- Fixed `BulkAssignCommand` + `UndoBulkOperationCommand`

### A4 — Redis distributed caching
- `AnalyticsService` refactored from `IMemoryCache` → `IDistributedCache` + JSON
- Redis in production; `MemoryDistributedCache` fallback for test environments

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: mpaulosky

.github/workflows/squad-milestone-release.yml

@@ -87,4 +87,15 @@ jobs:
 
           git tag -a "$TAG" -m "$MSG"
           git push origin "$TAG"
-          echo "✅ Tagged $TAG — squad-release.yml will create the GitHub Release"
+          echo "✅ Tagged $TAG"
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG: ${{ steps.next.outputs.tag }}
+        run: |
+          gh release create "$TAG" \
+            --generate-notes \
+            --title "Release $TAG" \
+            --verify-tag
+          echo "✅ GitHub Release $TAG created"

.squad/plans/v0.3.0-options.md

@@ -0,0 +1,133 @@
+# IssueTrackerApp — v0.3.0 Work Options
+
+**Created:** 2026-03-31  
+**Status:** 📋 Pending — ready to implement when team picks up
+
+---
+
+## Current State (as of v0.2.0)
+
+- ~85% feature-complete; core flows implemented (Issues, Comments, Categories, Statuses, Dashboard, Analytics, Bulk Ops, Attachments, Email, SignalR)
+- Pre-push gates, CI/CD, and dev workflow are solid
+- No open GitHub issues
+
+---
+
+## Known Gaps (Bugs / Incomplete Features)
+
+| Gap                                                                                                              | Owner Signal  | Effort |
+| ---------------------------------------------------------------------------------------------------------------- | ------------- | ------ |
+| ❌ Redis not wired up (provisioned in Aspire, `IMemoryCache` only)                                                | Sam + Boromir | Medium |
+| ⚠️ Issue Assignee conflates `Author` field — no dedicated field on Issue model                                    | Sam + Aragorn | Medium |
+| ❌ No Restore/Unarchive command for archived issues                                                               | Sam + Legolas | Small  |
+| ❌ Release workflow: `gh release create` not in `squad-milestone-release.yml` (documented decision, not yet done) | Boromir       | Small  |
+
+---
+
+## Option A — "Polish Sprint" (Fix Known Gaps)
+
+**Goal:** Close all known gaps before adding new features.
+
+### Tasks Option A
+
+- Add dedicated `AssigneeId`/`AssigneeInfo` field to `Issue` model
+- Update `BulkAssignCommand` to use new `AssigneeInfo` field instead of `Author`
+- Implement `RestoreIssueCommand` + UI button for unarchiving
+- Consolidate release workflow — add `gh release create` step to `squad-milestone-release.yml`
+- Wire Redis distributed caching (replace `IMemoryCache` with `IDistributedCache`)
+- Update tests for all of the above
+
+**Who:** Sam, Aragorn, Legolas, Boromir, Gimli  
+**Outcome:** v0.3.0 — production-hardened, no known gaps
+
+---
+
+## Option B — "Redis Distributed Caching"
+
+**Goal:** Wire Redis into the app for real scalability.
+
+### Tasks Option B
+
+- Register `IDistributedCache` backed by Redis in `Program.cs` / Aspire
+- Replace `AnalyticsService` `IMemoryCache` with `IDistributedCache`
+- Cache categories and statuses (read-heavy, slow-changing)
+- Update `InMemoryBulkOperationQueue` / `InMemoryUndoService` for distributed awareness
+- Integration tests for cache invalidation
+
+**Who:** Sam + Boromir  
+**Outcome:** App scales horizontally; Redis actually earns its place in the stack
+
+---
+
+## Option C — "Issue Voting & Prioritization"
+
+**Goal:** Let users upvote issues to surface community priorities.
+
+### Tasks Option C
+
+- Add `Votes` (int) + `VotedBy` (list of userIds) to `Issue` model
+- `VoteIssueCommand` / `UnvoteIssueCommand` with idempotency
+- Sort-by-votes on issues list; "Top Voted" quick filter
+- Vote count badge on issue cards
+- SignalR broadcast when vote threshold crossed
+- bUnit + integration tests
+
+**Who:** Sam, Legolas, Gimli  
+**Outcome:** Community-driven prioritization; distinct product differentiator
+
+---
+
+## Option D — "Admin User Management"
+
+**Goal:** Let admins manage users and roles directly in the app.
+
+### Tasks Option D
+
+- Auth0 Management API integration (list users, assign/remove roles)
+- New admin page: `/admin/users` with user list, role badges, edit modal
+- `UserManagementService` wrapping Auth0 Management API
+- Audit log of role changes
+- Strict Admin-only policy + tests
+
+**Who:** Gandalf, Sam, Legolas, Gimli  
+**Outcome:** Full admin control loop without needing Auth0 dashboard
+
+---
+
+## Option E — "Issue Labels / Tags"
+
+**Goal:** Free-form tagging on top of Category/Status.
+
+### Tasks Option E
+
+- Add `Labels` (`List<string>`) to `Issue` model
+- Tag suggestions from existing labels (autocomplete)
+- Filter by label on issues list (URL param `label=`)
+- Label management admin page or inline creation
+- Architecture tests updated for new feature slice
+
+**Who:** Sam, Legolas, Gimli  
+**Outcome:** Richer classification; especially useful once issue volume grows
+
+---
+
+## Option F — "v0.3.0 Sprint Planning Ceremony"
+
+**Goal:** Run a formal plan ceremony (Aragorn leads) to define the next milestone.
+
+### Tasks Option F
+
+- Review all options above as a team
+- Create GitHub Milestone `v0.3.0`
+- File sprint issues with labels, assignees, and acceptance criteria
+- Aragorn + Ralph own the board
+
+**Who:** Aragorn (lead), Ralph (board)  
+**Outcome:** Structured sprint with clear deliverables for all team members
+
+---
+
+## Recommendation
+
+Start with **Option A (Polish Sprint)** + **Option B (Redis)** to close documented technical debt.  
+Then run **Option F (Sprint Ceremony)** to formally charter v0.3.0 with community features from Options C, D, or E.

Directory.Packages.props

@@ -10,6 +10,7 @@
     <!-- MongoDB -->
     <PackageVersion Include="Microsoft.AspNetCore.SignalR.Client" Version="10.0.5" />
     <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="10.0.5" />
+    <PackageVersion Include="Microsoft.Extensions.Caching.StackExchangeRedis" Version="10.0.5" />
     <PackageVersion Include="MongoDB.Bson" Version="3.7.0" />
     <PackageVersion Include="MongoDB.Driver" Version="3.7.0" />
     <PackageVersion Include="MongoDB.EntityFrameworkCore" Version="10.0.1" />
@@ -64,4 +65,4 @@
     <PackageVersion Include="AspNetCore.HealthChecks.MongoDb" Version="9.0.0" />
     <PackageVersion Include="AspNetCore.HealthChecks.Redis" Version="9.0.0" />
   </ItemGroup>
-</Project>
+</Project>

src/Domain/DTOs/IssueDto.cs

@@ -26,7 +26,8 @@ public record IssueDto(
 	bool Archived,
 	UserDto ArchivedBy,
 	bool ApprovedForRelease,
-	bool Rejected)
+	bool Rejected,
+	UserDto Assignee)
 {
 	/// <summary>
 	///   Initializes a new instance of the <see cref="IssueDto" /> record.
@@ -44,7 +45,8 @@ public IssueDto(Issue issue) : this(
 		issue.Archived,
 		UserMapper.ToDto(issue.ArchivedBy),
 		issue.ApprovedForRelease,
-		issue.Rejected)
+		issue.Rejected,
+		UserMapper.ToDto(issue.Assignee))
 	{
 	}
 
@@ -60,5 +62,6 @@ public IssueDto(Issue issue) : this(
 		false,
 		UserDto.Empty,
 		false,
-		false);
+		false,
+		UserDto.Empty);
 }

src/Domain/Features/Issues/Commands/Bulk/BulkAssignCommand.cs

@@ -97,15 +97,13 @@ internal async Task<Result<BulkOperationResult>> ProcessBulkAssignAsync(
 
 				var issue = existingResult.Value;
 
-				// Store snapshot for undo (Author serves as the assignee in this model)
+				// Store snapshot for undo — capture current Assignee before overwriting
 				undoSnapshots.Add(new IssueUndoSnapshot(
 					issue.Id.ToString(),
 					BulkOperationType.Assignment,
-					new AssignmentSnapshot(UserMapper.ToDto(issue.Author))));
+					new AssignmentSnapshot(UserMapper.ToDto(issue.Assignee))));
 
-				// Note: Using Author field for assignment as the model doesn't have a separate Assignee
-				// In a real scenario, you'd want to add an Assignee field to the Issue model
-				issue.Author = UserMapper.ToInfo(request.Assignee);
+				issue.Assignee = UserMapper.ToInfo(request.Assignee);
 				issue.DateModified = DateTime.UtcNow;
 
 				var updateResult = await _repository.UpdateAsync(issue, cancellationToken);

src/Domain/Features/Issues/Commands/Bulk/UndoBulkOperationCommand.cs

@@ -99,7 +99,7 @@ public async Task<Result<BulkOperationResult>> Handle(
 					case BulkOperationType.Assignment:
 						if (snapshot.PreviousState is AssignmentSnapshot assignmentSnapshot)
 						{
-							issue.Author = UserMapper.ToInfo(assignmentSnapshot.PreviousAssignee);
+							issue.Assignee = UserMapper.ToInfo(assignmentSnapshot.PreviousAssignee);
 						}
 						break;
 

src/Domain/Features/Issues/Commands/RestoreIssueCommand.cs

@@ -0,0 +1,70 @@
+// =======================================================
+// Copyright (c) 2026. All rights reserved.
+// File Name :     RestoreIssueCommand.cs
+// Company :       mpaulosky
+// Author :        Matthew Paulosky
+// Solution Name : IssueTrackerApp
+// Project Name :  Domain
+// =======================================================
+
+using Domain.Abstractions;
+
+namespace Domain.Features.Issues.Commands;
+
+/// <summary>
+///   Command to restore (unarchive) a previously archived issue.
+/// </summary>
+public record RestoreIssueCommand(string Id) : IRequest<Result<bool>>;
+
+/// <summary>
+///   Handler for restoring (unarchiving) an issue.
+/// </summary>
+public sealed class RestoreIssueCommandHandler : IRequestHandler<RestoreIssueCommand, Result<bool>>
+{
+	private readonly IRepository<Issue> _repository;
+	private readonly ILogger<RestoreIssueCommandHandler> _logger;
+
+	public RestoreIssueCommandHandler(
+		IRepository<Issue> repository,
+		ILogger<RestoreIssueCommandHandler> logger)
+	{
+		_repository = repository;
+		_logger = logger;
+	}
+
+	public async Task<Result<bool>> Handle(RestoreIssueCommand request, CancellationToken cancellationToken)
+	{
+		_logger.LogInformation("Restoring archived issue with ID: {IssueId}", request.Id);
+
+		var existingResult = await _repository.GetByIdAsync(request.Id, cancellationToken);
+
+		if (existingResult.Failure || existingResult.Value is null)
+		{
+			_logger.LogWarning("Issue not found with ID: {IssueId}", request.Id);
+			return Result.Fail<bool>("Issue not found", ResultErrorCode.NotFound);
+		}
+
+		var issue = existingResult.Value;
+
+		if (!issue.Archived)
+		{
+			_logger.LogWarning("Issue {IssueId} is not archived; restore skipped", request.Id);
+			return Result.Fail<bool>("Issue is not archived", ResultErrorCode.Validation);
+		}
+
+		issue.Archived = false;
+		issue.ArchivedBy = UserInfo.Empty;
+		issue.DateModified = DateTime.UtcNow;
+
+		var result = await _repository.UpdateAsync(issue, cancellationToken);
+
+		if (result.Failure)
+		{
+			_logger.LogError("Failed to restore issue: {Error}", result.Error);
+			return Result.Fail<bool>(result.Error ?? "Failed to restore issue", result.ErrorCode);
+		}
+
+		_logger.LogInformation("Successfully restored issue with ID: {IssueId}", request.Id);
+		return Result.Ok(true);
+	}
+}

src/Domain/Mappers/IssueMapper.cs

@@ -36,7 +36,8 @@ public static IssueDto ToDto(Issue? issue)
 			issue.Archived,
 			UserMapper.ToDto(issue.ArchivedBy),
 			issue.ApprovedForRelease,
-			issue.Rejected);
+			issue.Rejected,
+			UserMapper.ToDto(issue.Assignee));
 	}
 
 	/// <summary>

src/Domain/Models/Issue.cs

@@ -96,6 +96,14 @@ public class Issue
 	/// </value>
 	public UserInfo ArchivedBy { get; set; } = UserInfo.Empty;
 
+	/// <summary>
+	///   Gets or sets the user assigned to this issue.
+	/// </summary>
+	/// <value>
+	///   The assigned user, or <see cref="UserInfo.Empty" /> if unassigned.
+	/// </value>
+	public UserInfo Assignee { get; set; } = UserInfo.Empty;
+
 	/// <summary>
 	///   Gets or sets a value indicating whether [approved for release].
 	/// </summary>

src/Persistence.MongoDb/Configurations/IssueConfiguration.cs

@@ -36,6 +36,13 @@ public void Configure(EntityTypeBuilder<Issue> builder)
 			ab.Property(u => u.Email).HasElementName("email");
 		});
 
+		builder.OwnsOne(i => i.Assignee, a =>
+		{
+			a.Property(u => u.Id).HasElementName("id");
+			a.Property(u => u.Name).HasElementName("name");
+			a.Property(u => u.Email).HasElementName("email");
+		});
+
 		builder.OwnsOne(i => i.Category, c =>
 		{
 			c.Property(cat => cat.Id).HasElementName("id");