mirror of
https://github.com/TheRealOwenRees/chess-endgame-trainer.git
synced 2026-11-18 03:32:06 +00:00
add puzzle training sessions with difficulty and ratings
- /train starts an ephemeral session by choosing easy/medium/hard, banded relative to the user's current rating (band width configurable) - session timer, average per-puzzle time, net rating gain and per-puzzle delta - next puzzle, plus review and retry reused from the play surface - explicit stop/start: stopping returns to the difficulty picker - puzzle rating shown once a puzzle completes, and a side-to-move indicator - extract the play logic/markup into shared PlayCore and PlayComponents so the standalone play view and sessions share one implementation - sticky footer; glossary entries for Difficulty and Session; ADR 0009
This commit is contained in:
@@ -0,0 +1,98 @@
|
||||
defmodule Chesstrainer.PuzzlesTest do
|
||||
use Chesstrainer.DataCase, async: true
|
||||
|
||||
import Chesstrainer.AccountsFixtures
|
||||
import Chesstrainer.EndgamesFixtures
|
||||
|
||||
alias Chesstrainer.Accounts.Scope
|
||||
alias Chesstrainer.Attempts
|
||||
alias Chesstrainer.Puzzles
|
||||
|
||||
# The shared `endgame_fixture/1` picks one of six FENs at random-ish, which
|
||||
# can collide when one test creates several endgames under async load. Pin
|
||||
# distinct FENs here instead.
|
||||
@fens [
|
||||
"4k3/8/8/8/8/8/8/1K6 w - - 0 1",
|
||||
"4k3/8/8/8/8/8/8/2K5 w - - 0 1",
|
||||
"4k3/8/8/8/8/8/8/3K4 w - - 0 1",
|
||||
"4k3/8/8/8/8/8/8/4K3 w - - 0 1"
|
||||
]
|
||||
|
||||
defp endgame_at(rating, index) do
|
||||
endgame_fixture(fen: Enum.fetch!(@fens, index), rating: rating)
|
||||
end
|
||||
|
||||
describe "difficulty_range/2" do
|
||||
test "is centred on the rating and open-ended at the extremes" do
|
||||
assert Puzzles.difficulty_range(1500, :medium) == {1400, 1600}
|
||||
assert Puzzles.difficulty_range(1500, :easy) == {nil, 1400}
|
||||
assert Puzzles.difficulty_range(1500, :hard) == {1600, nil}
|
||||
end
|
||||
end
|
||||
|
||||
describe "next_endgame/3" do
|
||||
test "medium picks an endgame within the band" do
|
||||
user = user_fixture()
|
||||
in_band = endgame_at(1550, 0)
|
||||
_out_of_band = endgame_at(1900, 1)
|
||||
|
||||
assert Puzzles.next_endgame(user, :medium).id == in_band.id
|
||||
end
|
||||
|
||||
test "easy picks an endgame below the user's rating" do
|
||||
user = user_fixture()
|
||||
easy = endgame_at(1300, 0)
|
||||
_medium = endgame_at(1500, 1)
|
||||
|
||||
assert Puzzles.next_endgame(user, :easy).id == easy.id
|
||||
end
|
||||
|
||||
test "hard picks an endgame above the user's rating" do
|
||||
user = user_fixture()
|
||||
hard = endgame_at(1700, 0)
|
||||
_medium = endgame_at(1500, 1)
|
||||
|
||||
assert Puzzles.next_endgame(user, :hard).id == hard.id
|
||||
end
|
||||
|
||||
test "falls back to the nearest endgame when the band is empty" do
|
||||
user = user_fixture()
|
||||
only = endgame_at(2200, 0)
|
||||
|
||||
assert Puzzles.next_endgame(user, :medium).id == only.id
|
||||
end
|
||||
|
||||
test "prefers endgames not attempted in the last 30 days" do
|
||||
user = user_fixture()
|
||||
attempted = endgame_at(1500, 0)
|
||||
fresh = endgame_at(1500, 1)
|
||||
|
||||
{:ok, _} = Attempts.record_attempt(Scope.for_user(user), attempted, :solved)
|
||||
|
||||
assert Puzzles.next_endgame(user, :medium).id == fresh.id
|
||||
end
|
||||
|
||||
test "falls back to a recent endgame once the fresh pool is empty" do
|
||||
user = user_fixture()
|
||||
only = endgame_at(1500, 0)
|
||||
|
||||
{:ok, _} = Attempts.record_attempt(Scope.for_user(user), only, :solved)
|
||||
|
||||
assert Puzzles.next_endgame(user, :medium).id == only.id
|
||||
end
|
||||
|
||||
test "skips excluded ids" do
|
||||
user = user_fixture()
|
||||
excluded = endgame_at(1500, 0)
|
||||
other = endgame_at(1500, 1)
|
||||
|
||||
assert Puzzles.next_endgame(user, :medium, exclude_ids: [excluded.id]).id == other.id
|
||||
end
|
||||
|
||||
test "returns nil when no endgames exist" do
|
||||
user = user_fixture()
|
||||
|
||||
assert Puzzles.next_endgame(user, :medium) == nil
|
||||
end
|
||||
end
|
||||
end
|
||||
@@ -0,0 +1,171 @@
|
||||
defmodule ChesstrainerWeb.EndgameLive.TrainTest do
|
||||
use ChesstrainerWeb.ConnCase
|
||||
|
||||
import Phoenix.LiveViewTest
|
||||
import Chesstrainer.EndgamesFixtures
|
||||
|
||||
alias Chesstrainer.Attempts.Attempt
|
||||
alias Chesstrainer.Endgames.Tablebase
|
||||
alias Chesstrainer.Endgames.Tablebase.Cache, as: TablebaseCache
|
||||
alias Chesstrainer.FEN
|
||||
alias Chesstrainer.Repo
|
||||
|
||||
defp seed_tablebase(fen, opts \\ []) do
|
||||
tablebase = %Tablebase{
|
||||
category: Keyword.get(opts, :category, :win),
|
||||
checkmate: Keyword.get(opts, :checkmate, false),
|
||||
moves: Keyword.get(opts, :moves, [])
|
||||
}
|
||||
|
||||
key = FEN.position_key(fen)
|
||||
TablebaseCache.put(key, tablebase)
|
||||
on_exit(fn -> TablebaseCache.delete(key) end)
|
||||
end
|
||||
|
||||
defp grading_moves do
|
||||
[%Tablebase.Move{uci: "d1d7", san: "Qd7+", category: :loss, dtz: -1}]
|
||||
end
|
||||
|
||||
# Sets up `count` endgames all inside the medium band, seeds their tablebases,
|
||||
# and starts a medium session. Returns the view and the endgames.
|
||||
@session_fens [
|
||||
"4k3/8/8/8/8/8/8/1K6 w - - 0 1",
|
||||
"4k3/8/8/8/8/8/8/2K5 w - - 0 1",
|
||||
"4k3/8/8/8/8/8/8/3K4 w - - 0 1"
|
||||
]
|
||||
|
||||
defp start_medium_session(conn, count) do
|
||||
endgames =
|
||||
for index <- 0..(count - 1) do
|
||||
endgame_fixture(fen: Enum.fetch!(@session_fens, index), rating: 1500)
|
||||
end
|
||||
|
||||
Enum.each(endgames, fn endgame ->
|
||||
seed_tablebase(endgame.fen, moves: grading_moves())
|
||||
end)
|
||||
|
||||
{:ok, view, _html} = live(conn, ~p"/train")
|
||||
|
||||
view
|
||||
|> element("#difficulty-medium")
|
||||
|> render_click()
|
||||
|
||||
{view, endgames}
|
||||
end
|
||||
|
||||
defp solve_current(view) do
|
||||
endgame = :sys.get_state(view.pid).socket.assigns.endgame
|
||||
after_fen = "8/8/8/8/8/8/8/8 b - - 0 1"
|
||||
|
||||
seed_tablebase(after_fen, checkmate: true, moves: [])
|
||||
|
||||
render_hook(view, "endgame_move_played", %{
|
||||
"from" => "d1",
|
||||
"to" => "d7",
|
||||
"san" => "Qd7+",
|
||||
"prev_fen" => endgame.fen,
|
||||
"fen" => after_fen,
|
||||
"endgame_id" => endgame.id
|
||||
})
|
||||
end
|
||||
|
||||
describe "access" do
|
||||
test "redirects anonymous visitors to log in", %{conn: conn} do
|
||||
assert {:error, {:redirect, %{to: "/users/log-in"}}} = live(conn, ~p"/train")
|
||||
end
|
||||
end
|
||||
|
||||
describe "starting a session" do
|
||||
setup :register_and_log_in_user
|
||||
|
||||
test "shows the difficulty picker with all three choices", %{conn: conn} do
|
||||
{:ok, view, _html} = live(conn, ~p"/train")
|
||||
|
||||
assert has_element?(view, "#difficulty-picker")
|
||||
assert has_element?(view, "#difficulty-easy")
|
||||
assert has_element?(view, "#difficulty-medium")
|
||||
assert has_element?(view, "#difficulty-hard")
|
||||
assert render(view) =~ "Choose a difficulty"
|
||||
end
|
||||
|
||||
test "starts a medium session and shows the session chrome", %{conn: conn} do
|
||||
endgame = endgame_fixture(rating: 1500)
|
||||
seed_tablebase(endgame.fen)
|
||||
{:ok, view, _html} = live(conn, ~p"/train")
|
||||
|
||||
view |> element("#difficulty-medium") |> render_click()
|
||||
|
||||
refute has_element?(view, "#difficulty-picker")
|
||||
assert has_element?(view, "#session-bar")
|
||||
assert has_element?(view, "#session-clock-" <> Integer.to_string(elapsed_id(view)))
|
||||
assert has_element?(view, "#endgame-board")
|
||||
|
||||
html = render(view)
|
||||
assert html =~ "Your move"
|
||||
assert html =~ "You play White"
|
||||
|
||||
session = :sys.get_state(view.pid).socket.assigns.session
|
||||
assert session.difficulty == :medium
|
||||
assert session.count == 0
|
||||
end
|
||||
end
|
||||
|
||||
describe "playing a session" do
|
||||
setup :register_and_log_in_user
|
||||
|
||||
test "solves a puzzle, records an attempt and shows the rating gain", %{conn: conn} do
|
||||
{view, [_endgame]} = start_medium_session(conn, 1)
|
||||
|
||||
solve_current(view)
|
||||
|
||||
assert render(view) =~ "Solved!"
|
||||
assert render(view) =~ "Puzzle rating:"
|
||||
assert [attempt] = Repo.all(Attempt)
|
||||
assert attempt.outcome == :solved
|
||||
|
||||
assigns = :sys.get_state(view.pid).socket.assigns
|
||||
assert assigns.session.count == 1
|
||||
assert is_float(assigns.last_rating_delta)
|
||||
assert assigns.last_rating_delta > 0
|
||||
assert assigns.user_rating > 1500.0
|
||||
end
|
||||
|
||||
test "loads a different puzzle on next", %{conn: conn} do
|
||||
{view, endgames} = start_medium_session(conn, 2)
|
||||
first = :sys.get_state(view.pid).socket.assigns.endgame
|
||||
|
||||
solve_current(view)
|
||||
view |> element("#next-puzzle-button") |> render_click()
|
||||
|
||||
second = :sys.get_state(view.pid).socket.assigns.endgame
|
||||
assert second.id != first.id
|
||||
assert Enum.any?(endgames, &(&1.id == second.id))
|
||||
end
|
||||
|
||||
test "a retry does not count toward the average again", %{conn: conn} do
|
||||
{view, [_endgame]} = start_medium_session(conn, 1)
|
||||
|
||||
solve_current(view)
|
||||
assert :sys.get_state(view.pid).socket.assigns.session.count == 1
|
||||
|
||||
view |> element("button", "Try again") |> render_click()
|
||||
solve_current(view)
|
||||
|
||||
assert :sys.get_state(view.pid).socket.assigns.session.count == 1
|
||||
end
|
||||
|
||||
test "stopping a session returns to the picker so a new one can start", %{conn: conn} do
|
||||
{view, [_endgame]} = start_medium_session(conn, 1)
|
||||
|
||||
view |> element("button", "Stop session") |> render_click()
|
||||
|
||||
assert has_element?(view, "#difficulty-picker")
|
||||
assert has_element?(view, "#difficulty-medium")
|
||||
assert :sys.get_state(view.pid).socket.assigns.session == nil
|
||||
end
|
||||
end
|
||||
|
||||
defp elapsed_id(view) do
|
||||
:sys.get_state(view.pid).socket.assigns.session.started_at_ms
|
||||
end
|
||||
end
|
||||
Reference in New Issue
Block a user