# Docs

- [Documentation](/docs): How to use MTG Copilot, and how the system underneath it works.
- Using the app
  - [Using the app](/docs/using): How to use the parts of MTG Copilot that need explaining, starting with the playtest board.
  - [Playtest board](/docs/using/playtest): Goldfish a deck: deal an opening hand, mulligan, and play turns out on a full board.
- Card data
  - [Card data](/docs/card-data): What the card data means: the concept vocabulary, the rules text, sets and precons, and prices.
  - [Taxonomy and tagging](/docs/card-data/taxonomy): Where a card's tags come from, how the concept vocabulary is built, and how to argue with a tag.
  - [Where a price comes from](/docs/card-data/prices): Three independent price paths, what each one covers, and how to tell how stale a number is.
- Data model
  - [Data model](/docs/data-model): Per-table field reference, with the source, owner and refresh cadence of every column.

  - **Cards**
  - [Cards](/docs/data-model/cards): One row per Magic card as a game object: rules text, cost, legality. Independent of how many times it has been printed.
  - [Card popularity](/docs/data-model/card_popularity): EDHREC play rank per card, kept apart from the card so refreshing it is cheap.
  - [Card printings](/docs/data-model/card_printings): One row per physical release of a card: set, collector number, artwork, finishes.
  - [Card subtypes](/docs/data-model/card_subtypes): Which subtypes each card has, parsed from its type line.
  - [Card types](/docs/data-model/mtg_card_types): The card type vocabulary, from Scryfall catalogs.
  - [Supertypes](/docs/data-model/mtg_supertypes): The supertype vocabulary, from Scryfall catalogs.
  - [Subtypes](/docs/data-model/mtg_subtypes): The subtype vocabulary, grouped by the card type each one belongs to.

  - **Sets and products**
  - [Sets](/docs/data-model/sets): Magic set metadata: codes, names, release dates, and printing counts.
  - [Set guides](/docs/data-model/set_guides): Per-set mechanics, themes and Limited archetypes, parsed from the MTG Fandom wiki.
  - [Precon decks](/docs/data-model/precon_decks): Preconstructed decks as shipped by Wizards, with their commanders and metadata.
  - [Precon deck cards](/docs/data-model/precon_deck_cards): The card list of each preconstructed deck, linking a precon to its printings.
  - [Sealed products](/docs/data-model/sealed_products): Sealed product catalogue: boxes, bundles and decks, priced only where a user owns one.

  - **Prices**
  - [Card prices](/docs/data-model/card_prices): Current prices per card, refreshed on a cron rather than with the card data.
  - [Printing prices (current)](/docs/data-model/printing_prices_current): Latest known price per printing and finish.
  - [Printing prices (daily)](/docs/data-model/printing_price_daily): Daily TCGplayer price points per printing, accumulated for history and charts. TCGplayer only. No other vendor is tracked over time.
  - [Printing prices (weekly)](/docs/data-model/printing_price_weekly): Weekly TCGplayer price rollups per printing, for longer-range history. TCGplayer only, like the daily series.

  - **Taxonomy**
  - [Game concepts](/docs/data-model/game_concepts): The curated vocabulary the AI reasons over: rules glossary terms plus concepts we added.
  - [Tag detection rules](/docs/data-model/tag_detection_rules): The patterns that decide when a card counts as an instance of a concept.
  - [Card concept associations](/docs/data-model/card_concept_associations): Which concepts are attached to which cards, and which pass decided.

  - **Rules**
  - [Comprehensive Rules](/docs/data-model/game_rules): Every numbered rule, verbatim, with its parents, cross references and examples.
  - [Card rulings](/docs/data-model/card_rulings): Official rulings issued for individual cards.
  - [Rules examples](/docs/data-model/rules_examples): Worked interaction examples drawn from the rules and from card rulings.

  - **Operations**
  - [Job runs](/docs/data-model/data_job_runs): One row per data job execution, with what it consumed and how much it matched.
- Search
  - [Query syntax](/docs/search): The search language: tokens, colour operators, boolean logic, and the places it differs from Scryfall.
  - [Anatomy of a search](/docs/search/anatomy): From query text to rows: tokenizing, the intermediate representation, and how it compiles to SQL.
- AI
  - [Grounding and limits](/docs/ai): What the model is given, which answers to trust, and where the system falls down.
  - [The chat pipeline](/docs/ai/chat): The five layers a chat message passes through, what each one loads, and what the reasoner can fetch for itself.
  - [How the AI sees your deck](/docs/ai/deck-context): What the model is handed before it answers, what it can fetch mid-answer, and what stays on the server.
  - [Recommendations](/docs/ai/recommendations): How a recommendation is produced: hard filters, semantic ranking, and a model choosing sixteen with reasons.
  - [Smart search](/docs/ai/smart-search): How plain English becomes a query string, what checks the output, and how often it gets it right.
  - [Deck analysis](/docs/ai/deck-analysis): The nine analysis panels: what each one is asked, what it can see, and why this surface deserves the most scepticism.
  - [The knowledge layer](/docs/ai/knowledge): A planned corpus of deck-building principles the AI can draw on, why it is empty today, and how sourced advice will be attributed.
- Your data
  - [Your data](/docs/your-data): What the app stores for you, how to get data in and out, and what each table holds.
  - [Importing a collection](/docs/your-data/collection): Supported CSV exports from Moxfield, Archidekt, Deckbox, ManaBox and TCGplayer, and what to do when a row does not match.
  - [Decks](/docs/your-data/decks): What a deck row holds, how the card list and its history are stored, who can read a deck, and what deck import and export accept.
  - [Profile and account](/docs/your-data/profile): The two rows created when you sign up, which fields are public, where avatars are stored, and how the credit balance moves.
  - [AI conversations](/docs/your-data/conversations): What a chat turn writes to the database, the diagnostic trace kept alongside it, and how AI spend is recorded against your credit balance.
  - [Feedback you send](/docs/your-data/feedback): The two tables behind tag corrections and smart search reports, what each row captures, and who can read it.
- Workflows
  - [Workflows](/docs/workflows): The scheduled jobs and scripts that put data in the database, and how often each one runs.
  - [Scheduled jobs](/docs/workflows/crons): What runs on a timer, what each job writes, and how a job that stops running becomes visible.
  - [Imports](/docs/workflows/ingest): The jobs that pull card text, printings, sets, precons, products and rules into the database.
  - [Tagging and embeddings](/docs/workflows/embeddings): The passes that turn imported card text into concept associations and vectors, and what depends on each.
- [Glossary](/docs/glossary): The words this documentation uses for its own machinery, and which ones collide with a Magic term that means something else.