Initial import of the CBDDC codebase with docs and tests. Add a .NET-focused gitignore to keep generated artifacts out of source control.

samples/ZB.MOM.WW.CBDDC.Sample.Console/SampleDocumentStore.cs

@@ -0,0 +1,164 @@
+using ZB.MOM.WW.CBDDC.Core;
+using ZB.MOM.WW.CBDDC.Core.Network;
+using ZB.MOM.WW.CBDDC.Core.Storage;
+using ZB.MOM.WW.CBDDC.Core.Sync;
+using ZB.MOM.WW.CBDDC.Persistence.BLite;
+using Microsoft.Extensions.Logging;
+using System.Text.Json;
+
+namespace ZB.MOM.WW.CBDDC.Sample.Console;
+
+/// <summary>
+/// Document store implementation for CBDDC Sample using BLite persistence.
+/// Extends BLiteDocumentStore to automatically handle Oplog creation via CDC.
+/// </summary>
+public class SampleDocumentStore : BLiteDocumentStore<SampleDbContext>
+{
+    private const string UsersCollection = "Users";
+    private const string TodoListsCollection = "TodoLists";
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="SampleDocumentStore"/> class.
+    /// </summary>
+    /// <param name="context">The sample database context.</param>
+    /// <param name="configProvider">The peer node configuration provider.</param>
+    /// <param name="vectorClockService">The vector clock service.</param>
+    /// <param name="logger">The optional logger instance.</param>
+    public SampleDocumentStore(
+        SampleDbContext context,
+        IPeerNodeConfigurationProvider configProvider,
+        IVectorClockService vectorClockService,
+        ILogger<SampleDocumentStore>? logger = null)
+        : base(context, configProvider, vectorClockService, new LastWriteWinsConflictResolver(), logger)
+    {
+        // Register CDC watchers for local change detection
+        // InterestedCollection is automatically populated
+        WatchCollection(UsersCollection, context.Users, u => u.Id);
+        WatchCollection(TodoListsCollection, context.TodoLists, t => t.Id);
+    }
+
+    #region Abstract Method Implementations
+
+    /// <inheritdoc />
+    protected override async Task ApplyContentToEntityAsync(
+        string collection, string key, JsonElement content, CancellationToken cancellationToken)
+    {
+        UpsertEntity(collection, key, content);
+        await _context.SaveChangesAsync(cancellationToken);
+    }
+
+    /// <inheritdoc />
+    protected override async Task ApplyContentToEntitiesBatchAsync(
+        IEnumerable<(string Collection, string Key, JsonElement Content)> documents, CancellationToken cancellationToken)
+    {
+        foreach (var (collection, key, content) in documents)
+        {
+            UpsertEntity(collection, key, content);
+        }
+        await _context.SaveChangesAsync(cancellationToken);
+    }
+
+    private void UpsertEntity(string collection, string key, JsonElement content)
+    {
+        switch (collection)
+        {
+            case UsersCollection:
+                var user = content.Deserialize<User>()!;
+                user.Id = key;
+                var existingUser = _context.Users.Find(u => u.Id == key).FirstOrDefault();
+                if (existingUser != null)
+                    _context.Users.Update(user);
+                else
+                    _context.Users.Insert(user);
+                break;
+
+            case TodoListsCollection:
+                var todoList = content.Deserialize<TodoList>()!;
+                todoList.Id = key;
+                var existingTodoList = _context.TodoLists.Find(t => t.Id == key).FirstOrDefault();
+                if (existingTodoList != null)
+                    _context.TodoLists.Update(todoList);
+                else
+                    _context.TodoLists.Insert(todoList);
+                break;
+
+            default:
+                throw new NotSupportedException($"Collection '{collection}' is not supported for sync.");
+        }
+    }
+
+    /// <inheritdoc />
+    protected override Task<JsonElement?> GetEntityAsJsonAsync(
+        string collection, string key, CancellationToken cancellationToken)
+    {
+        return Task.FromResult<JsonElement?>(collection switch
+        {
+            UsersCollection => SerializeEntity(_context.Users.Find(u => u.Id == key).FirstOrDefault()),
+            TodoListsCollection => SerializeEntity(_context.TodoLists.Find(t => t.Id == key).FirstOrDefault()),
+            _ => null
+        });
+    }
+
+    /// <inheritdoc />
+    protected override async Task RemoveEntityAsync(
+        string collection, string key, CancellationToken cancellationToken)
+    {
+        DeleteEntity(collection, key);
+        await _context.SaveChangesAsync(cancellationToken);
+    }
+
+    /// <inheritdoc />
+    protected override async Task RemoveEntitiesBatchAsync(
+        IEnumerable<(string Collection, string Key)> documents, CancellationToken cancellationToken)
+    {
+        foreach (var (collection, key) in documents)
+        {
+            DeleteEntity(collection, key);
+        }
+        await _context.SaveChangesAsync(cancellationToken);
+    }
+
+    private void DeleteEntity(string collection, string key)
+    {
+        switch (collection)
+        {
+            case UsersCollection:
+                _context.Users.Delete(key);
+                break;
+            case TodoListsCollection:
+                _context.TodoLists.Delete(key);
+                break;
+            default:
+                _logger.LogWarning("Attempted to remove entity from unsupported collection: {Collection}", collection);
+                break;
+        }
+    }
+
+    /// <inheritdoc />
+    protected override async Task<IEnumerable<(string Key, JsonElement Content)>> GetAllEntitiesAsJsonAsync(
+        string collection, CancellationToken cancellationToken)
+    {
+        return await Task.Run(() => collection switch
+        {
+            UsersCollection => _context.Users.FindAll()
+                .Select(u => (u.Id, SerializeEntity(u)!.Value)),
+
+            TodoListsCollection => _context.TodoLists.FindAll()
+                .Select(t => (t.Id, SerializeEntity(t)!.Value)),
+
+            _ => Enumerable.Empty<(string, JsonElement)>()
+        }, cancellationToken);
+    }
+
+    #endregion
+
+    #region Helper Methods
+
+    private static JsonElement? SerializeEntity<T>(T? entity) where T : class
+    {
+        if (entity == null) return null;
+        return JsonSerializer.SerializeToElement(entity);
+    }
+
+    #endregion
+}