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:
dingo
2026-02-25 14:46:00 -05:00
co-authored by Claude Happy
parent 3e4a07d4b5
commit 2cac55cbd9
28 changed files with 1796 additions and 4 deletions
@@ -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;
}