feat: custom deck tags data model and API

Add per-deck custom tags (name, color, target count, ordering) with a
many-to-many relationship to deck cards, alongside the existing
getting/consider_cutting tag axis which is left untouched.

- deck_tags and deck_card_tags tables (denormalized deck_id for same-deck guard)
- DeckTag/DeckCardTag schemas; Decks.Tags context (CRUD, reorder, assign/unassign)
- GraphQL deck.tags, deckCard.tagIds, and 6 tag mutations
- Frontend GraphQL documents + generated types
- Card counts sum deck card quantity; cross-deck assignment rejected

Author: cfbender

assets/react/src/gql/gql.ts

@@ -169,6 +169,27 @@ export const DECK_CARD_TAGS = [
   iconClassName: string
   icon: LucideIcon
 }>
+
+export const DECK_TAG_COLORS = [
+  "#7C5CFF",
+  "#22C55E",
+  "#3B82F6",
+  "#F59E0B",
+  "#EF4444",
+  "#EC4899",
+  "#14B8A6",
+  "#A855F7",
+] as const
+// TODO: derive DeckCustomTag from `DeckQuery["deck"]["tags"][number]` once codegen has
+// run and the `tags` selection on DeckDocument is reflected in the generated types.
+export type DeckCustomTag = {
+  id: string
+  name: string
+  color: string
+  targetCount?: number | null
+  position: number
+  cardCount: number
+}
 export const DECK_FORMATS = [
   "commander",
   "standard",

assets/react/src/gql/graphql.ts

@@ -163,6 +163,14 @@ export const DeckDocument = graphql(`
           cardName
         }
       }
+      tags {
+        id
+        name
+        color
+        targetCount
+        position
+        cardCount
+      }
       deckCards(first: 500, after: $deckCardsAfter) {
         pageInfo {
           endCursor
@@ -175,6 +183,7 @@ export const DeckDocument = graphql(`
             zone
             finish
             tag
+            tagIds
             priceCents
             card {
               id
@@ -339,6 +348,89 @@ export const UpdateDeckCardsTagDocument = graphql(`
   }
 `)
 
+export const CreateDeckTagDocument = graphql(`
+  mutation CreateDeckTag($deckId: ID!, $input: DeckTagInput!) {
+    createDeckTag(deckId: $deckId, input: $input) {
+      deckTag {
+        id
+        name
+        color
+        targetCount
+        position
+        cardCount
+      }
+    }
+  }
+`)
+
+export const UpdateDeckTagDocument = graphql(`
+  mutation UpdateDeckTag($id: ID!, $input: DeckTagInput!) {
+    updateDeckTag(id: $id, input: $input) {
+      deckTag {
+        id
+        name
+        color
+        targetCount
+        position
+        cardCount
+      }
+    }
+  }
+`)
+
+export const DeleteDeckTagDocument = graphql(`
+  mutation DeleteDeckTag($id: ID!) {
+    deleteDeckTag(id: $id) {
+      deckTagId
+    }
+  }
+`)
+
+export const ReorderDeckTagsDocument = graphql(`
+  mutation ReorderDeckTags($deckId: ID!, $tagIds: [ID!]!) {
+    reorderDeckTags(deckId: $deckId, tagIds: $tagIds) {
+      tags {
+        id
+        name
+        color
+        targetCount
+        position
+        cardCount
+      }
+    }
+  }
+`)
+
+export const AssignDeckCardTagDocument = graphql(`
+  mutation AssignDeckCardTag($deckCardId: ID!, $tagId: ID!) {
+    assignDeckCardTag(deckCardId: $deckCardId, tagId: $tagId) {
+      deckCard {
+        id
+        tagIds
+      }
+      deckTags {
+        id
+        cardCount
+      }
+    }
+  }
+`)
+
+export const UnassignDeckCardTagDocument = graphql(`
+  mutation UnassignDeckCardTag($deckCardId: ID!, $tagId: ID!) {
+    unassignDeckCardTag(deckCardId: $deckCardId, tagId: $tagId) {
+      deckCard {
+        id
+        tagIds
+      }
+      deckTags {
+        id
+        cardCount
+      }
+    }
+  }
+`)
+
 export const OptimizeDeckCardPrintingsDocument = graphql(`
   mutation OptimizeDeckCardPrintings($deckCardIds: [ID!]!) {
     optimizeDeckCardPrintings(deckCardIds: $deckCardIds) {

assets/react/src/pages/decks/deck-types.ts

@@ -103,6 +103,15 @@ defmodule Manavault.Catalog do
   defdelegate put_deck_card_allocation_statuses(deck_cards), to: Decks
   defdelegate put_deck_card_fallback_printings(deck_cards), to: Decks
 
+  defdelegate list_deck_tags(deck), to: Cached
+  defdelegate create_deck_tag(deck, attrs), to: Cached
+  defdelegate update_deck_tag(deck_tag, attrs), to: Cached
+  defdelegate delete_deck_tag(deck_tag), to: Cached
+  defdelegate reorder_deck_tags(deck, ordered_tag_ids), to: Cached
+  defdelegate assign_deck_card_tag(deck_card_id, deck_tag_id), to: Cached
+  defdelegate unassign_deck_card_tag(deck_card_id, deck_tag_id), to: Cached
+  defdelegate put_deck_card_tag_ids(deck_cards), to: Cached
+
   defdelegate allocate_collection_item_to_deck_card(
                 deck_card_id,
                 collection_item_id,

assets/react/src/pages/decks/queries.ts

@@ -472,6 +472,45 @@ defmodule Manavault.Catalog.Cached do
   defdelegate put_deck_card_allocation_statuses(deck_cards), to: Decks
   defdelegate put_deck_card_fallback_printings(deck_cards), to: Decks
 
+  defdelegate list_deck_tags(deck), to: Decks
+  defdelegate put_deck_card_tag_ids(deck_cards), to: Decks
+
+  def create_deck_tag(deck, attrs) do
+    deck
+    |> Decks.create_deck_tag(attrs)
+    |> invalidate_on_ok(&Cache.invalidate_decks/0)
+  end
+
+  def update_deck_tag(deck_tag, attrs) do
+    deck_tag
+    |> Decks.update_deck_tag(attrs)
+    |> invalidate_on_ok(&Cache.invalidate_decks/0)
+  end
+
+  def delete_deck_tag(deck_tag) do
+    deck_tag
+    |> Decks.delete_deck_tag()
+    |> invalidate_on_ok(&Cache.invalidate_decks/0)
+  end
+
+  def reorder_deck_tags(deck, ordered_tag_ids) do
+    deck
+    |> Decks.reorder_deck_tags(ordered_tag_ids)
+    |> invalidate_on_ok(&Cache.invalidate_decks/0)
+  end
+
+  def assign_deck_card_tag(deck_card_id, deck_tag_id) do
+    deck_card_id
+    |> Decks.assign_deck_card_tag(deck_tag_id)
+    |> invalidate_on_ok(&Cache.invalidate_decks/0)
+  end
+
+  def unassign_deck_card_tag(deck_card_id, deck_tag_id) do
+    deck_card_id
+    |> Decks.unassign_deck_card_tag(deck_tag_id)
+    |> invalidate_on_ok(&Cache.invalidate_decks/0)
+  end
+
   def allocate_collection_item_to_deck_card(deck_card_id, collection_item_id, quantity \\ 1) do
     deck_card_id
     |> Decks.allocate_collection_item_to_deck_card(collection_item_id, quantity)

lib/manavault/catalog.ex

@@ -18,6 +18,7 @@ defmodule Manavault.Catalog.Deck do
 
     has_many :deck_cards, Manavault.Catalog.DeckCard, on_replace: :delete
     has_many :deck_allocations, through: [:deck_cards, :deck_allocations]
+    has_many :deck_tags, Manavault.Catalog.DeckTag, on_replace: :delete
 
     timestamps(type: :utc_datetime)
   end

lib/manavault/catalog/cached.ex

@@ -15,6 +15,7 @@ defmodule Manavault.Catalog.DeckCard do
     field :tag, :string
     field :allocation_status, :map, virtual: true
     field :fallback_printing, :map, virtual: true
+    field :tag_ids, {:array, :id}, virtual: true, default: []
 
     belongs_to :deck, Manavault.Catalog.Deck
 
@@ -30,6 +31,8 @@ defmodule Manavault.Catalog.DeckCard do
 
     has_many :deck_allocations, Manavault.Catalog.DeckAllocation, on_replace: :delete
     has_many :collection_items, through: [:deck_allocations, :collection_item]
+    has_many :deck_card_tags, Manavault.Catalog.DeckCardTag
+    has_many :deck_tags, through: [:deck_card_tags, :deck_tag]
 
     timestamps(type: :utc_datetime)
   end

lib/manavault/catalog/deck.ex

@@ -0,0 +1,21 @@
+defmodule Manavault.Catalog.DeckCardTag do
+  use Ecto.Schema
+
+  import Ecto.Changeset
+
+  schema "deck_card_tags" do
+    field :deck_id, :id
+
+    belongs_to :deck_card, Manavault.Catalog.DeckCard
+    belongs_to :deck_tag, Manavault.Catalog.DeckTag
+
+    timestamps(type: :utc_datetime)
+  end
+
+  def changeset(deck_card_tag, attrs) do
+    deck_card_tag
+    |> cast(attrs, [:deck_card_id, :deck_tag_id, :deck_id])
+    |> validate_required([:deck_card_id, :deck_tag_id, :deck_id])
+    |> unique_constraint([:deck_card_id, :deck_tag_id])
+  end
+end

lib/manavault/catalog/deck_card.ex

@@ -0,0 +1,28 @@
+defmodule Manavault.Catalog.DeckTag do
+  use Ecto.Schema
+
+  import Ecto.Changeset
+
+  schema "deck_tags" do
+    field :name, :string
+    field :color, :string
+    field :target_count, :integer
+    field :position, :integer, default: 0
+    field :card_count, :integer, virtual: true
+
+    belongs_to :deck, Manavault.Catalog.Deck
+    has_many :deck_card_tags, Manavault.Catalog.DeckCardTag
+
+    timestamps(type: :utc_datetime)
+  end
+
+  def changeset(deck_tag, attrs) do
+    deck_tag
+    |> cast(attrs, [:name, :color, :target_count, :position, :deck_id])
+    |> validate_required([:name, :color, :deck_id])
+    |> validate_length(:name, min: 1, max: 60)
+    |> validate_format(:color, ~r/^#[0-9a-fA-F]{6}$/)
+    |> validate_number(:target_count, greater_than: 0)
+    |> unique_constraint([:deck_id, :name])
+  end
+end