Add starter deck system and AI art tracker
- PlayerCard.IsTradeable (default true; false for starter deck grants) - PrebuiltDeck.IsStarterDeck flag + index - Account.StarterDeckSelectedAt one-time onboarding gate - CardAsset.IsAiGenerated + CardAnimationBinding.IsAiGenerated - Handlers: CollectionGetStarterDecks, CollectionSelectStarterDeck - CollectionGetCards passes IsTradeable through to PlayerCardDto - Admin: PrebuiltDeckEditor Starter checkbox, CardEditor AI Generated checkboxes on assets and animation rows - Admin: /content/ai-assets AI Art Tracker page + NavMenu entry - 4 EF migrations applied to pg-forge-01 Generated with [Claude Code](https://claude.ai/code) via [Happy](https://happy.engineering) Co-Authored-By: Claude <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering>
This commit is contained in:
@@ -51,6 +51,17 @@ public sealed record RemoveCardRequest(Guid DeckId, Guid CardDefinitionId, int?
|
||||
/// </summary>
|
||||
public sealed record CloneDeckRequest(Guid DeckId, string? Name = null);
|
||||
|
||||
/// <summary>Returns all active starter decks available for new-account selection.</summary>
|
||||
public sealed record GetStarterDecksRequest; // identity from connection
|
||||
|
||||
/// <summary>
|
||||
/// Selects and binds a starter deck to the account.
|
||||
/// Can only be called once per account (guarded by Account.StarterDeckSelectedAt).
|
||||
/// Grants all cards from the deck as non-tradeable PlayerCards and creates a
|
||||
/// ready-to-play Deck in the player's collection.
|
||||
/// </summary>
|
||||
public sealed record SelectStarterDeckRequest(Guid StarterDeckId);
|
||||
|
||||
// ── Response / DTO types (server → client) ────────────────────────────────────
|
||||
|
||||
public sealed record GetCardsResponse(
|
||||
@@ -69,7 +80,8 @@ public sealed record PlayerCardDto(
|
||||
bool IsFoil,
|
||||
int? SerialNumber,
|
||||
DateTimeOffset AcquiredAt,
|
||||
string? ArtUrl);
|
||||
string? ArtUrl,
|
||||
bool IsTradeable = true);
|
||||
|
||||
public sealed record GetDecksResponse(IEnumerable<DeckSummaryDto> Decks);
|
||||
|
||||
@@ -109,3 +121,16 @@ public sealed record DeckCardDto(
|
||||
int OwnedCount);
|
||||
|
||||
public sealed record DeckMutationResponse(DeckSummaryDto Deck);
|
||||
|
||||
public sealed record GetStarterDecksResponse(IEnumerable<StarterDeckDto> Decks);
|
||||
|
||||
public sealed record StarterDeckDto(
|
||||
Guid Id,
|
||||
string Name,
|
||||
string? Description,
|
||||
Guid? ArchSpiritCardDefinitionId,
|
||||
string? ArchSpiritName,
|
||||
string? ImageCdnUrl,
|
||||
int TotalCards);
|
||||
|
||||
public sealed record SelectStarterDeckResponse(DeckSummaryDto Deck);
|
||||
|
||||
@@ -93,7 +93,8 @@ internal sealed class CollectionGetCardsHandler : CollectionHandlerBase, IMessag
|
||||
IsFoil: pc.IsFoil,
|
||||
SerialNumber: pc.SerialNumber,
|
||||
AcquiredAt: pc.AcquiredAt,
|
||||
ArtUrl: GetArtUrl(def));
|
||||
ArtUrl: GetArtUrl(def),
|
||||
IsTradeable: pc.IsTradeable);
|
||||
});
|
||||
|
||||
return ServerMessage.Reply(
|
||||
|
||||
@@ -0,0 +1,43 @@
|
||||
namespace SOR.Collection.Handlers;
|
||||
|
||||
using Microsoft.EntityFrameworkCore;
|
||||
using SOR.Database.Contexts;
|
||||
using SOR.Networking.Abstractions.Messaging;
|
||||
using SOR.Networking.Abstractions.Transport;
|
||||
using SOR.Shared.Networking;
|
||||
|
||||
/// <summary>
|
||||
/// collection.get_starter_decks — returns all active starter decks available
|
||||
/// for a new player to choose from during onboarding.
|
||||
/// </summary>
|
||||
internal sealed class CollectionGetStarterDecksHandler : CollectionHandlerBase, IMessageHandler
|
||||
{
|
||||
private readonly BazaarDbContext _bazaarDb;
|
||||
|
||||
public CollectionGetStarterDecksHandler(BazaarDbContext bazaarDb)
|
||||
=> _bazaarDb = bazaarDb;
|
||||
|
||||
public string MessageType => "collection.get_starter_decks";
|
||||
|
||||
public async Task<IServerMessage?> HandleAsync(
|
||||
IClientMessage message,
|
||||
AuthenticatedConnection connection,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
var decks = await _bazaarDb.PrebuiltDecks
|
||||
.Where(d => d.IsStarterDeck && d.IsActive)
|
||||
.OrderBy(d => d.Name)
|
||||
.Select(d => new StarterDeckDto(
|
||||
d.Id,
|
||||
d.Name,
|
||||
d.Description,
|
||||
d.ArchSpiritCardDefinitionId,
|
||||
d.ArchSpiritName,
|
||||
d.ImageCdnUrl,
|
||||
d.Cards.Sum(c => c.Quantity)))
|
||||
.ToListAsync(cancellationToken);
|
||||
|
||||
return ServerMessage.Reply("collection.get_starter_decks.ack", message.Seq,
|
||||
new GetStarterDecksResponse(decks));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,160 @@
|
||||
namespace SOR.Collection.Handlers;
|
||||
|
||||
using Microsoft.EntityFrameworkCore;
|
||||
using SOR.Database.Contexts;
|
||||
using SOR.Database.Entities.Collection;
|
||||
using SOR.Database.Entities.Identity;
|
||||
using SOR.Networking.Abstractions.Messaging;
|
||||
using SOR.Networking.Abstractions.Transport;
|
||||
using SOR.Shared.Networking;
|
||||
|
||||
/// <summary>
|
||||
/// collection.select_starter_deck — binds a starter deck to the player's account.
|
||||
///
|
||||
/// Can be called exactly once per account (guarded by Account.StarterDeckSelectedAt).
|
||||
///
|
||||
/// On success:
|
||||
/// - All cards from the PrebuiltDeck (including the ArchSpirit) are granted as
|
||||
/// PlayerCards with IsTradeable = false.
|
||||
/// - A Deck is created in the player's collection using those cards.
|
||||
/// - Account.StarterDeckSelectedAt is stamped.
|
||||
/// </summary>
|
||||
internal sealed class CollectionSelectStarterDeckHandler : CollectionHandlerBase, IMessageHandler
|
||||
{
|
||||
private readonly IMessageSerializer _serializer;
|
||||
private readonly CollectionDbContext _collectionDb;
|
||||
private readonly CatalogDbContext _catalogDb;
|
||||
private readonly BazaarDbContext _bazaarDb;
|
||||
private readonly SorIdentityDbContext _identityDb;
|
||||
|
||||
public CollectionSelectStarterDeckHandler(
|
||||
IMessageSerializer serializer,
|
||||
CollectionDbContext collectionDb,
|
||||
CatalogDbContext catalogDb,
|
||||
BazaarDbContext bazaarDb,
|
||||
SorIdentityDbContext identityDb)
|
||||
{
|
||||
_serializer = serializer;
|
||||
_collectionDb = collectionDb;
|
||||
_catalogDb = catalogDb;
|
||||
_bazaarDb = bazaarDb;
|
||||
_identityDb = identityDb;
|
||||
}
|
||||
|
||||
public string MessageType => "collection.select_starter_deck";
|
||||
|
||||
public async Task<IServerMessage?> HandleAsync(
|
||||
IClientMessage message,
|
||||
AuthenticatedConnection connection,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
var req = _serializer.DeserializePayload<SelectStarterDeckRequest>(message.Payload);
|
||||
var accountId = Guid.Parse(connection.UserId);
|
||||
|
||||
// ── Guard: one-time selection ─────────────────────────────────────────
|
||||
var account = await _identityDb.Set<Account>()
|
||||
.FirstOrDefaultAsync(a => a.Id == accountId, cancellationToken);
|
||||
|
||||
if (account == null)
|
||||
return ServerMessage.Error(message.Seq, "ACCOUNT_NOT_FOUND", "Account not found.");
|
||||
|
||||
if (account.StarterDeckSelectedAt.HasValue)
|
||||
return ServerMessage.Error(message.Seq, "ALREADY_SELECTED",
|
||||
"You have already selected a starter deck.");
|
||||
|
||||
// ── Load the starter deck ─────────────────────────────────────────────
|
||||
var starterDeck = await _bazaarDb.PrebuiltDecks
|
||||
.Include(d => d.Cards)
|
||||
.FirstOrDefaultAsync(
|
||||
d => d.Id == req.StarterDeckId && d.IsStarterDeck && d.IsActive,
|
||||
cancellationToken);
|
||||
|
||||
if (starterDeck == null)
|
||||
return ServerMessage.Error(message.Seq, "DECK_NOT_FOUND",
|
||||
"Starter deck not found or is no longer available.");
|
||||
|
||||
if (!starterDeck.ArchSpiritCardDefinitionId.HasValue)
|
||||
return ServerMessage.Error(message.Seq, "INVALID_DECK",
|
||||
"Starter deck has no ArchSpirit configured.");
|
||||
|
||||
var now = DateTimeOffset.UtcNow;
|
||||
|
||||
// ── Grant PlayerCards (untradeable) ───────────────────────────────────
|
||||
// One PlayerCard row per copy of each card in the prebuilt deck.
|
||||
foreach (var deckCard in starterDeck.Cards)
|
||||
{
|
||||
for (int i = 0; i < deckCard.Quantity; i++)
|
||||
{
|
||||
_collectionDb.PlayerCards.Add(new PlayerCard
|
||||
{
|
||||
AccountId = accountId,
|
||||
CardDefinitionId = deckCard.CardDefinitionId,
|
||||
AcquiredAt = now,
|
||||
IsTradeable = false,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
// Grant the ArchSpirit.
|
||||
_collectionDb.PlayerCards.Add(new PlayerCard
|
||||
{
|
||||
AccountId = accountId,
|
||||
CardDefinitionId = starterDeck.ArchSpiritCardDefinitionId.Value,
|
||||
AcquiredAt = now,
|
||||
IsTradeable = false,
|
||||
});
|
||||
|
||||
await _collectionDb.SaveChangesAsync(cancellationToken);
|
||||
|
||||
// ── Create the player's starter deck ──────────────────────────────────
|
||||
var deck = new Deck
|
||||
{
|
||||
AccountId = accountId,
|
||||
Name = starterDeck.Name,
|
||||
ArchSpiritCardDefinitionId = starterDeck.ArchSpiritCardDefinitionId.Value,
|
||||
IsValid = false, // set by RefreshValidityAsync below
|
||||
CreatedAt = now,
|
||||
UpdatedAt = now,
|
||||
};
|
||||
_collectionDb.Decks.Add(deck);
|
||||
await _collectionDb.SaveChangesAsync(cancellationToken);
|
||||
|
||||
foreach (var deckCard in starterDeck.Cards)
|
||||
{
|
||||
_collectionDb.DeckCards.Add(new DeckCard
|
||||
{
|
||||
DeckId = deck.Id,
|
||||
CardDefinitionId = deckCard.CardDefinitionId,
|
||||
Quantity = deckCard.Quantity,
|
||||
});
|
||||
}
|
||||
await _collectionDb.SaveChangesAsync(cancellationToken);
|
||||
|
||||
// ── Validate ──────────────────────────────────────────────────────────
|
||||
var warnings = await RefreshValidityAsync(_collectionDb, _catalogDb, deck, cancellationToken);
|
||||
|
||||
// ── Stamp account ─────────────────────────────────────────────────────
|
||||
account.StarterDeckSelectedAt = now;
|
||||
await _identityDb.SaveChangesAsync(cancellationToken);
|
||||
|
||||
// ── Build response ────────────────────────────────────────────────────
|
||||
var archName = await _catalogDb.CardDefinitions
|
||||
.Where(cd => cd.Id == deck.ArchSpiritCardDefinitionId)
|
||||
.Select(cd => cd.Name)
|
||||
.FirstOrDefaultAsync(cancellationToken);
|
||||
|
||||
var summary = new DeckSummaryDto(
|
||||
Id: deck.Id,
|
||||
Name: deck.Name,
|
||||
ArchSpiritCardDefinitionId: deck.ArchSpiritCardDefinitionId,
|
||||
ArchSpiritName: archName,
|
||||
CardCount: starterDeck.Cards.Sum(c => c.Quantity),
|
||||
IsValid: deck.IsValid,
|
||||
CreatedAt: deck.CreatedAt,
|
||||
UpdatedAt: deck.UpdatedAt,
|
||||
ValidationWarnings: warnings.Length > 0 ? warnings : null);
|
||||
|
||||
return ServerMessage.Reply("collection.select_starter_deck.ack", message.Seq,
|
||||
new SelectStarterDeckResponse(summary));
|
||||
}
|
||||
}
|
||||
@@ -19,6 +19,8 @@ public static class ServiceRegistration
|
||||
// Database contexts the collection service needs.
|
||||
services.AddCollectionDatabase(configuration);
|
||||
services.AddCatalogDatabase(configuration);
|
||||
services.AddBazaarDatabase(configuration); // needed by starter deck handlers
|
||||
services.AddIdentityDatabase(configuration); // needed by starter deck handlers
|
||||
|
||||
// Message handlers — one per message type, Transient lifetime.
|
||||
// MessageDispatcher collects all IMessageHandler registrations at startup.
|
||||
@@ -31,6 +33,8 @@ public static class ServiceRegistration
|
||||
services.AddTransient<IMessageHandler, CollectionAddCardHandler>();
|
||||
services.AddTransient<IMessageHandler, CollectionRemoveCardHandler>();
|
||||
services.AddTransient<IMessageHandler, CollectionCloneDeckHandler>();
|
||||
services.AddTransient<IMessageHandler, CollectionGetStarterDecksHandler>();
|
||||
services.AddTransient<IMessageHandler, CollectionSelectStarterDeckHandler>();
|
||||
|
||||
return services;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user