merge(#36): migrate to MongoDB, add comment tree flattening, and refine API documentation

Author: undrcrxwn

.github/workflows/openapi.yml

@@ -23,15 +23,13 @@ jobs:
       - name: ⚙️ Setup .NET
         uses: actions/setup-dotnet@v1
         with:
-          dotnet-version: |
-            7.0.x
-            8.0.x
+          dotnet-version: 9.0.x
       - name: ⚒ Build solution
         run: dotnet build
       - name: ⚙️ Restore .NET tools
         run: dotnet tool restore
       - name: 📝 Produce OpenAPI specification
-        run: dotnet swagger tofile --output openapi.yaml --yaml ./src/CrowdParlay.Social.Api/bin/Debug/net8.0/CrowdParlay.Social.Api.dll v1
+        run: dotnet swagger tofile --output openapi.yaml --yaml ./src/CrowdParlay.Social.Api/bin/Debug/net9.0/CrowdParlay.Social.Api.dll v1
       - name: 🔗 Upload OpenAPI specification as release asset
         uses: actions/upload-release-asset@v1
         env:

.github/workflows/test.yml

@@ -20,9 +20,7 @@ jobs:
       - name: ⚙️ Setup .NET
         uses: actions/setup-dotnet@v3
         with:
-          dotnet-version: |
-            7.0.x
-            8.0.x
+          dotnet-version: 9.0.x
       - name: 📥 Restore dependencies
         run: dotnet restore
       - name: ⚒ Build solution
@@ -35,4 +33,4 @@ jobs:
         with:
           name: .NET test results
           path: "**/TestResults/*.trx"
-          reporter: dotnet-trx
+          reporter: dotnet-trx

.gitmodules

@@ -1,9 +1,3 @@
-[submodule "src/CrowdParlay.Social.Infrastructure.gRPC/Users"]
-	path = src/CrowdParlay.Social.Infrastructure.gRPC/Users
-	url = https://github.com/crowdparlay/users-proto
-[submodule "src/CrowdParlay.Social.Application/gRPC/Users"]
-	path = src/CrowdParlay.Social.Application/gRPC/Users
-	url = https://github.com/crowdparlay/users-proto
 [submodule "src/CrowdParlay.Social.Infrastructure.Communication/gRPC/Users"]
 	path = src/CrowdParlay.Social.Infrastructure.Communication/gRPC/Users
 	url = https://github.com/crowdparlay/users-proto.git

Dockerfile

@@ -1,18 +1,12 @@
-FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
+FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build
 WORKDIR /app
 
 COPY /src .
 RUN dotnet restore "CrowdParlay.Social.Api/CrowdParlay.Social.Api.csproj"
 RUN dotnet publish "CrowdParlay.Social.Api/CrowdParlay.Social.Api.csproj" -c Release -o out
 
-FROM mcr.microsoft.com/dotnet/aspnet:8.0
+FROM mcr.microsoft.com/dotnet/aspnet:9.0
 WORKDIR /app
 COPY --from=build /app/out .
-COPY /neo4j/migrations ./neo4j/migrations
 
-RUN apt-get update && apt-get install -y curl unzip
-RUN curl -LO https://github.com/michael-simons/neo4j-migrations/releases/download/2.9.3/neo4j-migrations-2.9.3-linux-x86_64.zip
-RUN unzip -j neo4j-migrations-2.9.3-linux-x86_64.zip neo4j-migrations-2.9.3-linux-x86_64/bin/neo4j-migrations
-RUN rm neo4j-migrations-2.9.3-linux-x86_64.zip
-
-ENTRYPOINT ["sh", "-c", "./neo4j-migrations -a $NEO4J_URI -u $NEO4J_USERNAME -p $NEO4J_PASSWORD migrate && dotnet CrowdParlay.Social.Api.dll"]
+ENTRYPOINT ["sh", "-c", "dotnet CrowdParlay.Social.Api.dll"]

README.md

@@ -1,4 +1,10 @@
 # Crowd Parlay's *social* microservice [![Test](https://github.com/crowdparlay/social/actions/workflows/test.yml/badge.svg)](https://github.com/crowdparlay/social/actions/workflows/test.yml)
-- **languages:** <kbd>C#</kbd> <kbd>Cypher</kbd>
-- **technologies:** <kbd>.NET 8</kbd> <kbd>ASP.NET Core</kbd> <kbd>RabbitMQ</kbd> <kbd>Neo4j</kbd> <kbd>SSE</kbd> <kbd>OpenAPI</kbd>
-- **dependencies:** <kbd>MassTransit</kbd> <kbd>SignalR</kbd> <kbd>MediatR</kbd> <kbd>FluentValidation</kbd> <kbd>Mapster</kbd> <kbd>Swashbuckle</kbd> <kbd>Testcontainers</kbd>
+
+A high-performance, cloud-native microservice enabling discussions, threaded comments, emoji/text reactions, and real-time event publishing via message broker. Designed with a clean onion architecture and test-driven development, it integrates seamlessly with other services through resilient, cache-optimized API calls. Built on a NoSQL store with embedded documents and strategic indexing for fast reads. Basic telemetry and observability are integrated, with support for future expansion. Fully automated CI/CD pipelines enable one-click production deployments.
+
+- **Stack:** <kbd>C# 13</kbd> <kbd>.NET 9</kbd> <kbd>ASP.NET Core</kbd> <kbd>MongoDb.Driver</kbd> <kbd>MassTransit</kbd> <kbd>OpenTelemetry</kbd> <kbd>SignalR</kbd> <kbd>FluentValidation</kbd> <kbd>Mapster</kbd> <kbd>Swashbuckle/OpenAPI</kbd> <kbd>Testcontainers</kbd>
+- **Environment:** <kbd>MongoDB</kbd> <kbd>Redis</kbd> <kbd>RabbitMQ</kbd> <kbd>Elastic APM</kbd> [<kbd>crowdparlay/users</kbd>](https://github.com/crowdparlay/users)  
+- **Adopted but retired:** <kbd>Neo4j</kbd> <kbd>MediatR</kbd>
+
+> [!NOTE]
+> This Git repository contains Submodules. Don’t forget to clone with `--recurse-submodules`

neo4j/migrations/V010__Add_indexes.cypher

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
     <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
+        <TargetFramework>net9.0</TargetFramework>
         <Nullable>enable</Nullable>
         <ImplicitUsings>enable</ImplicitUsings>
         <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
@@ -10,19 +10,19 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="Elastic.Apm.NetCoreAll" Version="1.26.0" />
-        <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="8.0.2" />
-        <PackageReference Include="Microsoft.AspNetCore.DataProtection.StackExchangeRedis" Version="8.0.7" />
+        <PackageReference Include="Elastic.Apm.NetCoreAll" Version="1.32.2" />
+        <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="9.0.5" />
+        <PackageReference Include="Microsoft.AspNetCore.DataProtection.StackExchangeRedis" Version="9.0.5" />
         <PackageReference Include="Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer" Version="5.1.0"/>
-        <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="8.0.2" />
-        <PackageReference Include="Microsoft.AspNetCore.SignalR.Common" Version="8.0.2" />
-        <PackageReference Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.8.1" />
-        <PackageReference Include="OpenTelemetry.Extensions.Hosting" Version="1.8.1" />
-        <PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.8.1" />
+        <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="9.0.5" />
+        <PackageReference Include="Microsoft.AspNetCore.SignalR.Common" Version="9.0.5" />
+        <PackageReference Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.12.0" />
+        <PackageReference Include="OpenTelemetry.Extensions.Hosting" Version="1.12.0" />
+        <PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.12.0" />
         <PackageReference Include="OpenTelemetry.Instrumentation.GrpcNetClient" Version="1.9.0-beta.1" />
         <PackageReference Include="Serilog.Enrichers.OpenTelemetry" Version="1.0.1" />
-        <PackageReference Include="SignalRSwaggerGen" Version="4.5.0" />
-        <PackageReference Include="Swashbuckle.AspNetCore" Version="6.6.2" />
+        <PackageReference Include="SignalRSwaggerGen" Version="4.8.0" />
+        <PackageReference Include="Swashbuckle.AspNetCore" Version="8.1.2" />
     </ItemGroup>
 
     <ItemGroup>

neo4j/migrations/V020__Remove_excessive_author_properties.cypher

@@ -1,5 +1,4 @@
 using CrowdParlay.Communication;
-using CrowdParlay.Social.Api.Consumers;
 using CrowdParlay.Social.Api.Services;
 using MassTransit;
 
@@ -21,7 +20,6 @@ public static IServiceCollection AddApi(this IServiceCollection services, IConfi
 
         return services.AddMassTransit(bus =>
         {
-            bus.AddConsumersFromNamespaceContaining<UserEventConsumer>();
             bus.UsingRabbitMq((context, configurator) =>
             {
                 var amqpServerUrl =