From ecea7695e3927161901b3d934832c7a1f3c03820 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jos=C3=A9=20Ren=C3=A9=20White=20Enciso?=
 <jrenewhite@gmail.com>
Date: Mon, 9 Mar 2026 11:57:46 -0600
Subject: [PATCH] chore(building-block-operations-config): checkpoint pending
 development updates

---
 Directory.Build.props                          |  4 ++--
 docs/roadmap/feature-epics.md                  | 18 ++++++++++++++++++
 .../Contracts/OperationalOverrideContract.cs   |  8 ++++++++
 ...EffectiveOperationalControlPlaneResponse.cs |  9 +++++++++
 4 files changed, 37 insertions(+), 2 deletions(-)
 create mode 100644 docs/roadmap/feature-epics.md
 create mode 100644 src/BuildingBlock.OperationsConfig.Contracts/Contracts/OperationalOverrideContract.cs
 create mode 100644 src/BuildingBlock.OperationsConfig.Contracts/Responses/GetEffectiveOperationalControlPlaneResponse.cs

diff --git a/Directory.Build.props b/Directory.Build.props
index 9957cc9..87ac3ce 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -3,8 +3,8 @@
     <Authors>AgileWebs</Authors>
     <Company>AgileWebs</Company>
     <RepositoryType>git</RepositoryType>
-    <RepositoryUrl>http://192.168.10.100:3000/AgileWebs/building-block-operations-config</RepositoryUrl>
-    <PackageProjectUrl>http://192.168.10.100:3000/AgileWebs/building-block-operations-config</PackageProjectUrl>
+    <RepositoryUrl>https://gitea.dream-views.com/AgileWebs/building-block-operations-config</RepositoryUrl>
+    <PackageProjectUrl>https://gitea.dream-views.com/AgileWebs/building-block-operations-config</PackageProjectUrl>
     <PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
   </PropertyGroup>
 </Project>
diff --git a/docs/roadmap/feature-epics.md b/docs/roadmap/feature-epics.md
new file mode 100644
index 0000000..7323e21
--- /dev/null
+++ b/docs/roadmap/feature-epics.md
@@ -0,0 +1,18 @@
+# Feature Epics
+
+## Repository
+building-block-operations-config
+
+## Core Epics
+- Epic 1: Expand domain-aligned capabilities for restaurant operations.
+- Epic 2: Stabilize service contracts for containerized runtime integration.
+- Epic 3: Improve observability and operational readiness for demo compose environments.
+
+## Domain-Specific Candidate Features
+- Order lifecycle consistency and state transitions.
+- Kitchen queue and dispatch optimization hooks.
+- Operations control-plane policies (flags, service windows, overrides).
+- POS closeout and settlement summary alignment.
+
+## Documentation Contract
+Any code change in this repository must include docs updates in the same branch.
diff --git a/src/BuildingBlock.OperationsConfig.Contracts/Contracts/OperationalOverrideContract.cs b/src/BuildingBlock.OperationsConfig.Contracts/Contracts/OperationalOverrideContract.cs
new file mode 100644
index 0000000..21cade9
--- /dev/null
+++ b/src/BuildingBlock.OperationsConfig.Contracts/Contracts/OperationalOverrideContract.cs
@@ -0,0 +1,8 @@
+namespace BuildingBlock.OperationsConfig.Contracts.Contracts;
+
+public sealed record OperationalOverrideContract(
+    string Key,
+    string Value,
+    DateTime EffectiveFromUtc,
+    DateTime? EffectiveToUtc,
+    string SetBy);
diff --git a/src/BuildingBlock.OperationsConfig.Contracts/Responses/GetEffectiveOperationalControlPlaneResponse.cs b/src/BuildingBlock.OperationsConfig.Contracts/Responses/GetEffectiveOperationalControlPlaneResponse.cs
new file mode 100644
index 0000000..c393859
--- /dev/null
+++ b/src/BuildingBlock.OperationsConfig.Contracts/Responses/GetEffectiveOperationalControlPlaneResponse.cs
@@ -0,0 +1,9 @@
+using BuildingBlock.OperationsConfig.Contracts.Contracts;
+
+namespace BuildingBlock.OperationsConfig.Contracts.Responses;
+
+public sealed record GetEffectiveOperationalControlPlaneResponse(
+    string Version,
+    IReadOnlyCollection<ServiceWindowContract> ServiceWindows,
+    IReadOnlyCollection<FeatureFlagContract> FeatureFlags,
+    IReadOnlyCollection<OperationalOverrideContract> Overrides);