refactor: updated shared resources and references to properties

Author: sliedig

.gitignore

@@ -3,6 +3,6 @@
 **/.aws-sam/
 *.DotSettings.user
 .vscode/*
-UnicornProperties.sln.DotSettings.user
+UnicornApprovals.sln.DotSettings.user
 **/cdk.out/
 **/obj/**

Unicorn.Contracts/ContractsService.Test/ContractsService.Tests.csproj

@@ -8,9 +8,9 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="Amazon.Lambda.Core" Version="2.5.1" />
+        <PackageReference Include="Amazon.Lambda.Core" Version="2.6.0" />
         <PackageReference Include="Amazon.Lambda.DynamoDBEvents" Version="3.1.1" />
-        <PackageReference Include="Amazon.Lambda.TestUtilities" Version="2.0.0" />
+        <PackageReference Include="Amazon.Lambda.TestUtilities" Version="3.0.0" />
         <PackageReference Include="AWSSDK.DynamoDBv2" Version="3.7.404.11" />
         <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.0" />
         <PackageReference Include="NBuilder" Version="6.1.0" />

Unicorn.Contracts/ContractsService/ContractsService.csproj

@@ -10,7 +10,7 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="Amazon.Lambda.Core" Version="2.5.1" />
+        <PackageReference Include="Amazon.Lambda.Core" Version="2.6.0" />
         <PackageReference Include="Amazon.Lambda.Serialization.SystemTextJson" Version="2.4.4" />
         <PackageReference Include="Amazon.Lambda.APIGatewayEvents" Version="2.7.1" />
         <PackageReference Include="AWS.Lambda.Powertools.Logging" Version="2.0.0" />

Unicorn.Contracts/README.md

@@ -4,13 +4,22 @@
 
 ## Architecture overview
 
-Unicorn Contract manages the contractual relationship between the customers and the Unicorn Properties agency. It's primary function is to allow Unicorn Properties agents to create a new contract for a property listing, and to have the contract approved once it's ready.
+The **Unicorn Contracts** service manages contractual relationships between customers and Unicorn Properties agency. The service handles standard terms and conditions, property service rates, fees, and additional services.
 
-The architecture is fairly straight forward. An API exposes the create contract and update contract methods. This information is recorded in a Amazon DynamoDB table which will contain all latest information about the contract and it's status.
+Each property can have only one active contract. Properties use their address as a unique identifier instead of a GUID, which correlates across services.
 
-Each time a new contract is created or updated, Unicorn Contracts publishes a `ContractStatusChanged` event to Amazon EventBridge signalling changes to the contract status. These events are consumed by **Unicorn Properties**, so it can track changes to contracts, without needing to take a direct dependency on Unicorn Contracts and it's database.
+For example: `usa/anytown/main-street/111`.
 
-Here is an example of an event that is published to EventBridge:
+The contract workflow operates as follows:
+
+1. Agents submit contract creation/update commands through the Contracts API
+1. The API sends requests to Amazon SQS
+1. A Contracts function processes the queue messages and updates Amazon DynamoDB
+1. DynamoDB Streams captures contract changes
+1. Amazon EventBridge Pipes transforms the DynamoDB records into ContractStatusChanged events
+1. Unicorn Approvals consumes these events to track contract changes without direct database dependencies
+
+An example of `ContractStatusChanged` event:
 
 ```json
 {

Unicorn.Shared/uni-prop-namespaces.yaml

@@ -35,7 +35,7 @@ Outputs:
     Description: Unicorn Contracts namespace parameter
     Value: !Ref UnicornContractsNamespaceParam
 
-  UnicornPropertiesNamespace:
+  UnicornApprovalsNamespace:
     Description: Unicorn Properties namespace parameter
     Value: !Ref UnicornApprovalsNamespaceParam
 

Unicorn.Web/ApprovalService.Tests/ApprovalService.Tests.csproj

@@ -10,10 +10,10 @@
 
     <ItemGroup>
         <PackageReference Include="Amazon.Lambda.APIGatewayEvents" Version="2.7.1" />
-        <PackageReference Include="Amazon.Lambda.Core" Version="2.5.1" />
+        <PackageReference Include="Amazon.Lambda.Core" Version="2.6.0" />
         <PackageReference Include="Amazon.Lambda.DynamoDBEvents" Version="3.1.1" />
         <PackageReference Include="Amazon.Lambda.Serialization.SystemTextJson" Version="2.4.4" />
-        <PackageReference Include="Amazon.Lambda.TestUtilities" Version="2.0.0" />
+        <PackageReference Include="Amazon.Lambda.TestUtilities" Version="3.0.0" />
         <PackageReference Include="AWSSDK.DynamoDBv2" Version="3.7.404.11" />
         <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.0" />
         <PackageReference Include="NBuilder" Version="6.1.0" />

Unicorn.Web/ApprovalService/ApprovalService.csproj

@@ -11,7 +11,7 @@
     <ItemGroup>
         <PackageReference Include="Amazon.Lambda.APIGatewayEvents" Version="2.7.1" />
         <PackageReference Include="Amazon.Lambda.CloudWatchEvents" Version="4.4.0" />
-        <PackageReference Include="Amazon.Lambda.Core" Version="2.5.1" />
+        <PackageReference Include="Amazon.Lambda.Core" Version="2.6.0" />
         <PackageReference Include="Amazon.Lambda.Serialization.SystemTextJson" Version="2.4.4" />
         <PackageReference Include="AWS.Lambda.Powertools.Logging" Version="2.0.0" />
         <PackageReference Include="AWS.Lambda.Powertools.Metrics" Version="2.0.0" />

Unicorn.Web/Common/Common.csproj

@@ -11,7 +11,7 @@
     <ItemGroup>
       <PackageReference Include="Amazon.Lambda.APIGatewayEvents" Version="2.7.1" />
       <PackageReference Include="Amazon.Lambda.CloudWatchEvents" Version="4.4.0" />
-      <PackageReference Include="Amazon.Lambda.Core" Version="2.5.1" />
+      <PackageReference Include="Amazon.Lambda.Core" Version="2.6.0" />
       <PackageReference Include="AWSSDK.DynamoDBv2" Version="3.7.404.11" />
       <PackageReference Include="AWSSDK.XRay" Version="3.7.401.102" />
       <PackageReference Include="AWSXRayRecorder.Handlers.AwsSdk" Version="2.13.0" />

Unicorn.Web/Integration/subscriptions.yaml

@@ -20,7 +20,7 @@ Resources:
       Name: unicorn.web-PublicationEvaluationCompleted
       Description: PublicationEvaluationCompleted subscription
       EventBusName:
-        Fn::Sub: "{{resolve:ssm:/uni-prop/${Stage}/UnicornPropertiesEventBusArn}}"
+        Fn::Sub: "{{resolve:ssm:/uni-prop/${Stage}/UnicornApprovalsEventBusArn}}"
       EventPattern:
         source:
           - "{{resolve:ssm:/uni-prop/UnicornApprovalsNamespace}}"

Unicorn.Web/SearchService.Tests/SearchService.Tests.csproj

@@ -9,9 +9,9 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="Amazon.Lambda.Core" Version="2.5.1" />
+        <PackageReference Include="Amazon.Lambda.Core" Version="2.6.0" />
         <PackageReference Include="Amazon.Lambda.DynamoDBEvents" Version="3.1.1" />
-        <PackageReference Include="Amazon.Lambda.TestUtilities" Version="2.0.0" />
+        <PackageReference Include="Amazon.Lambda.TestUtilities" Version="3.0.0" />
         <PackageReference Include="AWSSDK.DynamoDBv2" Version="3.7.404.11" />
         <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.14.0" />
         <PackageReference Include="NSubstitute" Version="5.3.0" />