notebookvb

SběrDatRůzné/DailyStr8ts/NOTES.md

@@ -1,13 +1,21 @@
 # DailyStr8ts — technické poznámky
 
-Skript `stahni_str8ts.py` stahuje denní Str8ts puzzle jako PDF ze https://www.solitaire.org/daily-str8ts/ a odesílá emailem.
+## Přehled skriptů
+
+| Skript | Popis |
+|--------|-------|
+| `stahni_str8ts.py` | Stahuje denní puzzle jako PDF z webu, odesílá emailem |
+| `preskumaj_str8ts.py` | Průzkumný — vytáhne `gameLevels` z JS kontextu stránky |
+| `vykresli_puzzle.py` | Generuje vlastní PDF z dat v MySQL (reportlab, vektorové) |
+| `vykresli_velikosti.py` | Testovací — jedno puzzle v 17 velikostech (18–2 cm) |
+| `create_puzzles_table.sql` | DDL pro tabulku `puzzle.puzzles` |
+
+## Stahování z webu (`stahni_str8ts.py`)
 
 **Výstup:** `U:\Dropbox\!!!Days\Downloads Z230\yyyy-mm-dd Daily Str8ts puzzle.pdf`
 
 **Příjemci:** vladimir.buzalka@buzalka.cz, alica.buzalkova@buzalka.cz
 
-## Jak to funguje (klíčové)
-
 Stránka `game.php` má funkci `Game.printDaily()` která:
 1. Vytvoří skrytý `<iframe id="printFrame">` v DOM
 2. Zapíše do něj puzzle HTML přes `contentWindow.document.write()` — všechny 3 obtížnosti (Easy, Medium, Hard)
@@ -21,8 +29,54 @@ Stránka `game.php` má funkci `Game.printDaily()` která:
 - Přidáme `<base href="https://www.solitaire.org/daily-str8ts/">` pro obrázky
 - Načteme HTML do nové stránky a uložíme jako `page.pdf()`
 
+## Datová struktura `gameLevels`
+
+JS objekt `gameLevels` obsahuje puzzle pro všechny dny roku, klíčované jako `gameLevels[difficulty]["MM-DD"]`.
+
+Každý záznam má 3 stringy po 81 znacích (9×9 mřížka, po řádcích):
+
+| Pole | Význam |
+|------|--------|
+| `puzzle` | Zadání: `1`–`9` = předvyplněné číslo, `.` = prázdná buňka |
+| `bw` | Mapa barev: `0` = bílá buňka, `1` = černá buňka |
+| `solution` | Řešení: `1`–`9` = číslo, `.` = černá bez čísla |
+
+## MySQL tabulka `puzzle.puzzles`
+
+Univerzální tabulka pro Str8ts, Sudoku i další puzzle typy.
+
+```sql
+CREATE TABLE puzzles (
+    id INT AUTO_INCREMENT PRIMARY KEY,
+    game_type VARCHAR(30) NOT NULL,       -- 'str8ts', 'sudoku', 'killer_sudoku'
+    difficulty VARCHAR(20) NOT NULL,       -- 'easy', 'medium', 'hard'
+    puzzle_date DATE NOT NULL,
+    puzzle VARCHAR(200) NOT NULL,          -- zadání (81 znaků pro 9×9)
+    solution VARCHAR(200) DEFAULT NULL,
+    extra JSON DEFAULT NULL,              -- specifika typu (bw mapa, cage definice...)
+    source VARCHAR(100) DEFAULT NULL,
+    fetched_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE KEY uq_puzzle (game_type, difficulty, puzzle_date)
+);
+```
+
+Pro Str8ts se do `extra` ukládá `{"bw": "001100011..."}`.
+
+## Generování vlastního PDF (`vykresli_puzzle.py`)
+
+- Knihovna: **reportlab** — vektorová grafika, plynule škálovatelná
+- Zvolená velikost: **11×11 cm**, 2 puzzle nad sebou na A4
+- Černé buňky: `c.rect(fill=1)`, žlutá čísla na černé, černá čísla na bílé
+- Str8ts nemá 3×3 bloky → všechny čáry mřížky stejně silné
+
 ## Co nefunguje (neopakovat)
 
 - `page.pdf()` na hlavní stránce → uvítací obrazovka, ne puzzle
 - `context.expect_page()` → žádný popup se neotevírá
 - Override `window.print` → Game volá `contentWindow.print()`, ne `window.print()`
+
+## Co zbývá
+
+- Zabudovat extrakci + MySQL insert do `stahni_str8ts.py`
+- Nahradit stahované PDF z webu vlastním generovaným
+- Rozšířit na další typy puzzle (Sudoku, Killer Sudoku)