Merge branch 'feature/building-block-workflow-contract-baseline' into development

.gitignore

@@ -1,2 +1,4 @@
 .tasks/
 .agile/
+**/bin/
+**/obj/

BuildingBlock.Workflow.slnx

@@ -0,0 +1,5 @@
+<Solution>
+  <Folder Name="/src/">
+    <Project Path="src/BuildingBlock.Workflow.Contracts/BuildingBlock.Workflow.Contracts.csproj" />
+  </Folder>
+</Solution>

Directory.Build.props

@@ -0,0 +1,10 @@
+<Project>
+  <PropertyGroup>
+    <Authors>AgileWebs</Authors>
+    <Company>AgileWebs</Company>
+    <RepositoryType>git</RepositoryType>
+    <RepositoryUrl>http://192.168.68.156:3000/AgileWebs/building-block-workflow</RepositoryUrl>
+    <PackageProjectUrl>http://192.168.68.156:3000/AgileWebs/building-block-workflow</PackageProjectUrl>
+    <PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
+  </PropertyGroup>
+</Project>

src/BuildingBlock.Workflow.Contracts/Abstractions/IWorkflowCapabilityContract.cs

@@ -0,0 +1,11 @@
+using BuildingBlock.Workflow.Contracts.Requests;
+using BuildingBlock.Workflow.Contracts.Responses;
+
+namespace BuildingBlock.Workflow.Contracts.Abstractions;
+
+public interface IWorkflowCapabilityContract
+{
+    Task<TransitionWorkflowStateResponse> TransitionWorkflowStateAsync(
+        TransitionWorkflowStateRequest request,
+        CancellationToken cancellationToken);
+}

src/BuildingBlock.Workflow.Contracts/BuildingBlock.Workflow.Contracts.csproj

@@ -0,0 +1,9 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net10.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+</Project>

src/BuildingBlock.Workflow.Contracts/Contracts/WorkflowState.cs

@@ -0,0 +1,11 @@
+namespace BuildingBlock.Workflow.Contracts.Contracts;
+
+public enum WorkflowState
+{
+    Queued = 0,
+    InProgress = 1,
+    Blocked = 2,
+    Completed = 3,
+    Failed = 4,
+    Canceled = 5
+}

src/BuildingBlock.Workflow.Contracts/Contracts/WorkflowWorkItemContract.cs

@@ -0,0 +1,8 @@
+namespace BuildingBlock.Workflow.Contracts.Contracts;
+
+public sealed record WorkflowWorkItemContract(
+    string WorkItemId,
+    string WorkType,
+    int Priority,
+    DateTime RequestedAtUtc,
+    WorkflowState CurrentState);

src/BuildingBlock.Workflow.Contracts/Requests/TransitionWorkflowStateRequest.cs

@@ -0,0 +1,9 @@
+using BuildingBlock.Workflow.Contracts.Contracts;
+
+namespace BuildingBlock.Workflow.Contracts.Requests;
+
+public sealed record TransitionWorkflowStateRequest(
+    string WorkItemId,
+    WorkflowState TargetState,
+    string RequestedBy,
+    DateTime RequestedAtUtc);

src/BuildingBlock.Workflow.Contracts/Responses/TransitionWorkflowStateResponse.cs

@@ -0,0 +1,10 @@
+using BuildingBlock.Workflow.Contracts.Contracts;
+
+namespace BuildingBlock.Workflow.Contracts.Responses;
+
+public sealed record TransitionWorkflowStateResponse(
+    string WorkItemId,
+    WorkflowState PreviousState,
+    WorkflowState CurrentState,
+    bool TransitionApplied,
+    string? RejectionReason);