Derive canonical material Key from the FEN

The Endgame key is now a canonical, colour-agnostic material signature derived
from the FEN instead of a hand-typed field: each side's pieces, strongest side
first by material value (e.g. "KQ v KR"). This fixes the seed ordering
inconsistency and guarantees the key always matches the position.

- Add Chesstrainer.Key.from_fen/1.
- Compute the key in the Endgame changeset; drop the manual input and its
  regex validation.
- Index endgames.key and derive keys in the seeds.
- Document the Key term and the decision (ADR 0003).

Closes #13
This commit is contained in:
2026-11-02 09:22:01 +01:00
parent cd2e7f0164
commit ca65207baa
12 changed files with 258 additions and 47 deletions
@@ -19,5 +19,6 @@ defmodule Chesstrainer.Repo.Migrations.CreateEndgames do
end
create unique_index(:endgames, [:fen])
create index(:endgames, [:key])
end
end
+25 -24
View File
@@ -18,32 +18,33 @@ now = DateTime.utc_now() |> DateTime.truncate(:second)
IO.puts("🌱 Seeding basic endgames into DB...")
endgames = [
%{
fen: "8/8/3k4/8/8/3K1R2/8/8 w - - 0 1",
color: :white,
message: "Rook vs king endgame",
notes: "Basic rook endgame",
result: :win
},
%{
fen: "6k1/5p2/6p1/8/7p/8/6PP/6K1 b - - 0 1",
color: :black,
message: "3 pawns vs 2 pawns",
notes: "https://www.chessgames.com/perl/chessgame?gid=1017147",
result: :win
}
]
Repo.insert_all(
Endgame,
[
%{
id: Ecto.UUID.generate(),
fen: "8/8/3k4/8/8/3K1R2/8/8 w - - 0 1",
color: :white,
key: "KR v K",
message: "Rook vs king endgame",
notes: "Basic rook endgame",
result: :win,
inserted_at: now,
updated_at: now
},
%{
id: Ecto.UUID.generate(),
fen: "6k1/5p2/6p1/8/7p/8/6PP/6K1 b - - 0 1",
color: :black,
key: "KPPP v KPP",
message: "3 pawns vs 2 pawns",
notes: "https://www.chessgames.com/perl/chessgame?gid=1017147",
result: :win,
inserted_at: now,
updated_at: now
}
],
Enum.map(endgames, fn endgame ->
{:ok, key} = Chesstrainer.Key.from_fen(endgame.fen)
endgame
|> Map.put(:id, Ecto.UUID.generate())
|> Map.put(:key, key)
|> Map.merge(%{inserted_at: now, updated_at: now})
end),
on_conflict: :nothing
)