kjh2064/KArtSell.Aegis
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(wbs): AEG-VS-01-05 Event/Job/Inbox - Part 2-3 Complete (Outbox/Inbox + Consumers)

Browse Source 
Part 2: Transaction + Outbox Integration
- RegisterIdentityEndpoint: DbConnection → DbTransaction → Outbox write
- RegisterIdentitySql: Accept NpgsqlConnection + NpgsqlTransaction (Dapper)
- Fixed schema references: identity.identity → public.identity
- Hash computation (SHA256) for Outbox payload integrity

Part 3: Consumer + Job Implementation
- IdentityCreatedConsumer: SignalR group 'identity-notifications'
- MfaReminderJob: Hangfire job, 24-hour reminder, idempotent via DB tracking
- IdentityAuditConsumer: Immutable append-only audit trail
- Migration 0043: identity_mfa_reminder + identity_audit_log tables

Testing
- Unit: IdentityCreated event serialization + immutability (4 tests)
- Integration: RegisterIdentityWithOutbox (3 tests: happy path, rollback, duplicate email)
- Updated existing tests: Transaction management (6 test methods)

Architecture
- Outbox/Inbox pattern ensures exactly-once delivery
- Consumers decouple from identity creation (async, independent retry)
- Audit trail immutable (trigger prevents updates/deletes)
- MFA reminder idempotent (tracked in DB)

Status: 40% COMPLETE (event + endpoint + 3 consumers)
Next: E2E tests + Hangfire job registration + Admin UI

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
김재현
2026-08-17 18:41:10 +09:00
parent 023bfa97bf
commit c289a698c5
11 changed files with 825 additions and 70 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/Modules/IdentityAccess/ManageIdentityAndRoles/Features/RegisterIdentity/RegisterIdentityEndpoint.cs
+70 -14
View File
@@ -1,8 +1,18 @@
using FastEndpoints;
using KArtSell.BuildingBlocks.Data;
using KArtSell.BuildingBlocks.Reliability;
using KArtSell.Modules.IdentityAccess.ManageIdentityAndRoles.Events;
using Npgsql;
using System.Data;
using System.Text.Json;
namespace KArtSell.Modules.IdentityAccess.ManageIdentityAndRoles.Features.RegisterIdentity;
public sealed class RegisterIdentityEndpoint(IRegisterIdentitySql sql) : Endpoint<RegisterIdentityRequest, RegisterIdentityResponse>
public sealed class RegisterIdentityEndpoint(
IRegisterIdentitySql sql,
IDbConnectionFactory connectionFactory,
IOutboxWriter outboxWriter)
: Endpoint<RegisterIdentityRequest, RegisterIdentityResponse>
{
public override void Configure()
{
@@ -35,25 +45,71 @@ public sealed class RegisterIdentityEndpoint(IRegisterIdentitySql sql) : Endpoin
var identityId = Guid.NewGuid();
var correlationId = Guid.NewGuid().ToString();
var createdId = await sql.CreateIdentityAsync(identityId, email, req.DisplayName, correlationId, ct);
if (createdId == Guid.Empty)
var conn = await connectionFactory.OpenAsync(ct) as NpgsqlConnection
?? throw new InvalidOperationException("Failed to open connection");
await using (conn)
{
await SendErrorAsync(409, "Failed to create identity", ct);
return;
await using var transaction = await conn.BeginTransactionAsync(IsolationLevel.ReadCommitted, ct);
try
{
var createdId = await sql.CreateIdentityAsync(conn, transaction, identityId, email, req.DisplayName, correlationId, ct);
if (createdId == Guid.Empty)
{
await SendErrorAsync(409, "Failed to create identity", ct);
return;
}
// Write IdentityCreated event to Outbox
var identityCreatedEvent = new IdentityCreated
{
IdentityId = createdId,
Email = email,
DisplayName = req.DisplayName,
CorrelationId = correlationId,
OccurredAt = DateTime.UtcNow
};
var payloadJson = JsonSerializer.Serialize(identityCreatedEvent);
var outboxMessage = new OutboxMessage(
MessageId: Guid.NewGuid(),
EventType: nameof(IdentityCreated),
SchemaVersion: 1,
PayloadJson: payloadJson,
CorrelationId: correlationId,
OccurredAt: DateTimeOffset.UtcNow,
PayloadHash: ComputePayloadHash(payloadJson));
await outboxWriter.AddAsync(conn, transaction, outboxMessage, ct);
await transaction.CommitAsync(ct);
var (id, returnedEmail, _, currentState) = await sql.GetIdentityAsync(createdId, ct);
await Send.OkAsync(new RegisterIdentityResponse
{
Id = id,
Email = returnedEmail,
State = currentState
}, ct);
}
catch (Exception)
{
await transaction.RollbackAsync(ct);
throw;
}
}
var (id, returnedEmail, _, currentState) = await sql.GetIdentityAsync(createdId, ct);
await Send.OkAsync(new RegisterIdentityResponse
{
Id = id,
Email = returnedEmail,
State = currentState
}, ct);
}
private async Task SendErrorAsync(int statusCode, string message, CancellationToken ct)
{
await Send.StatusCodeAsync(statusCode, ct);
}
private static string ComputePayloadHash(string payloadJson)
{
using var hasher = System.Security.Cryptography.SHA256.Create();
var hash = hasher.ComputeHash(System.Text.Encoding.UTF8.GetBytes(payloadJson));
return Convert.ToHexString(hash);
}
}
src/Modules/IdentityAccess/ManageIdentityAndRoles/Features/RegisterIdentity/RegisterIdentitySql.cs
+25 -19
View File
@@ -1,3 +1,4 @@
using System.Data;
using Dapper;
using Npgsql;
@@ -6,7 +7,7 @@ namespace KArtSell.Modules.IdentityAccess.ManageIdentityAndRoles.Features.Regist
public interface IRegisterIdentitySql
{
Task<bool> EmailExistsAsync(string email, CancellationToken ct);
Task<Guid> CreateIdentityAsync(Guid id, string email, string displayName, string correlationId, CancellationToken ct);
Task<Guid> CreateIdentityAsync(NpgsqlConnection conn, NpgsqlTransaction transaction, Guid id, string email, string displayName, string correlationId, CancellationToken ct);
Task<(Guid Id, string Email, string DisplayName, string State)> GetIdentityAsync(Guid id, CancellationToken ct);
}
@@ -23,29 +24,34 @@ public sealed class RegisterIdentitySql : IRegisterIdentitySql
{
using var conn = await _connectionFactory();
const string sql = """
SELECT EXISTS(SELECT 1 FROM identity.identity WHERE email = @email)
SELECT EXISTS(SELECT 1 FROM public.identity WHERE email = @email)
""";
return await conn.QuerySingleAsync<bool>(sql, new { email }, commandTimeout: 5);
}
public async Task<Guid> CreateIdentityAsync(Guid id, string email, string displayName, string correlationId, CancellationToken ct)
public async Task<Guid> CreateIdentityAsync(NpgsqlConnection conn, NpgsqlTransaction transaction, Guid id, string email, string displayName, string correlationId, CancellationToken ct)
{
using var conn = await _connectionFactory();
const string sql = """
INSERT INTO identity.identity (id, email, display_name, state, created_at, updated_at, published_at, revision_version, correlation_id)
VALUES (@id, @email, @displayName, @state, NOW(), NOW(), NOW(), 1, @correlationId)
INSERT INTO public.identity (identity_id, email, display_name, state, created_at, updated_at, published_at, revision_version, correlation_id, username)
VALUES (@id, @email, @displayName, @state, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, 1, @correlationId, @email)
ON CONFLICT (email) DO NOTHING
RETURNING id;
RETURNING identity_id;
""";
var result = await conn.QuerySingleOrDefaultAsync<Guid?>(sql, new
{
id,
email,
displayName,
state = Domain.IdentityState.Active,
correlationId
}, commandTimeout: 5);
var result = await conn.QuerySingleOrDefaultAsync<Guid?>(
new CommandDefinition(
sql,
new
{
id,
email,
displayName,
state = Domain.IdentityState.Active,
correlationId
},
transaction,
commandTimeout: 5,
cancellationToken: ct));
return result ?? Guid.Empty;
}
@@ -54,15 +60,15 @@ public sealed class RegisterIdentitySql : IRegisterIdentitySql
{
using var conn = await _connectionFactory();
const string sql = """
SELECT id, email, display_name, state
FROM identity.identity
WHERE id = @id
SELECT identity_id, email, display_name, state
FROM public.identity
WHERE identity_id = @id
""";
var row = await conn.QuerySingleOrDefaultAsync<dynamic>(sql, new { id }, commandTimeout: 5);
if (row is null)
throw new InvalidOperationException($"Identity {id} not found");
return ((Guid)row.id, (string)row.email, (string)row.display_name, (string)row.state);
return ((Guid)row.identity_id, (string)row.email, (string)row.display_name, (string)row.state);
}
}