Credit360.AuditLogging.Contracts 1.0.0

Credit360.AuditLogging.Libraries

Reusable NuGet packages for publishing audit events from Credit360 microservices to the Audit & Logging backend.

Install

From a private feed or local folder after packing:

dotnet add package Credit360.AuditLogging.Producer

Local development (after ./pack.ps1):

dotnet nuget add source ./artifacts --name Credit360Local
dotnet add package Credit360.AuditLogging.Producer --source Credit360Local

Configuration

Add to appsettings.json:

{
  "AuditLoggingProducer": {
    "Kafka": {
      "Enabled": true,
      "BootstrapServers": "localhost:9092",
      "AuditLogCreatedTopic": "audit-log-created",
      "AuditLogDefinitionUpdatedTopic": "audit-log-definition-updated"
    },
    "Grpc": {
      "Enabled": true,
      "Address": "http://localhost:9080"
    },
    "Fallback": {
      "UseGrpcWhenKafkaFails": true,
      "QueueGrpcFallbackWithCoravel": true,
      "CoravelMaxRetries": 5
    }
  }
}

Usage

using Credit360.AuditLogging.Contracts.Events;
using Credit360.AuditLogging.Producer.Abstractions;
using Credit360.AuditLogging.Producer.Extensions;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddAuditLoggingProducer(builder.Configuration);

var app = builder.Build();
app.Services.ConfigureQueue(); // required for Coravel gRPC fallback

// Inject IAuditEventPublisher where audit events are emitted
await auditPublisher.PublishAuditLogCreatedAsync(new AuditLogEventData
{
    OperationCode = "USER_LOGIN",
    Description = "User signed in",
    UserName = "jane.doe",
    ClientIp = "10.0.0.1"
});

Build and pack

dotnet build Credit360.AuditLogging.sln
./pack.ps1

Packages are emitted to ./artifacts.

Standalone Git repository

This folder is intended to live in its own repository (Credit360.AuditLogging.Libraries). To split from a monorepo:

1. Copy or move this directory to a new repo root.
2. Run git init and push to your remote.
3. Update consuming services to reference NuGet packages instead of project references.

The Audit & Logging service currently references these projects via relative paths during local development.

Kafka topics and gRPC contract

• Topics: audit-log-created, audit-log-definition-updated
• Envelope: KafkaEventWrapper<T> with EventType, EventId, Timestamp, Data
• gRPC service: audit_ingest.AuditIngestService (proto files under Credit360.AuditLogging.Contracts/Protos/)