Dokumentace k rozvržení podkladů a vrstvám číselníků

ROZPISKY.md §2 a §8, ROZHRANI.md §3.4 (a odškrtnutá otevřená otázka v §9),
CLAUDE.md. Baseline testů v promptech subagentů 36 -> 50.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

docs/ROZHRANI.md

@@ -131,12 +131,22 @@ Na revize se odkazují řádkové revizní sloupce přílohy (R1–R4) a revizn
 | **Verze dokumentace** | verze | stupeň dokumentace |
 | **Části** | označení, název části | části/objekty v seznamu |
 
-> **Číselníky jsou sdílená data napříč projekty a žijí v samostatné databázi vedle `.exe`.**
-> V původním Excelu šlo o samostatné listy s daty (označení dokumentace, data firem apod.).
-> Ve standalone aplikaci se z nich stane **externí databázový soubor uložený vedle spustitelného
-> souboru** (např. `cisleniky.db` / `.json` ve složce aplikace), aby ho šlo **průběžně doplňovat
-> a sdílet** mezi projekty bez zásahu do aplikace. (Na rozdíl od revizí, které jsou interní
-> k zakázce – viz [3.3](#33-revize-původní-list-revize).)
+> **Číselníky jsou sdílená data napříč projekty a žijí mimo projekt.** V původním Excelu šlo
+> o samostatné listy s daty (označení dokumentace, data firem apod.). Ve standalone aplikaci jsou
+> uložené ve **dvou vrstvách JSON** (na rozdíl od revizí, které jsou interní k zakázce –
+> viz [3.3](#33-revize-původní-list-revize)):
+>
+> | Vrstva | Soubor | Role |
+> |---|---|---|
+> | dodávaná | `ciselniky.vychozi.json` vedle `.exe` | výchozí obsah dodaný s programem, jen ke čtení; každá instalace ho obnoví |
+> | uživatelská | `ciselniky.user.json` v `%APPDATA%\Rozpisky` | jen **rozdíl** proti dodávané: `Vlastni` (přidané a upravené položky) + `Skryte` (klíče odklizených dodávaných položek) |
+>
+> Při načtení se vrstvy slučují: dodávané pořadí zůstává, upravená položka se přepíše na svém
+> místě, vlastní se řadí za ně. Při uložení se rozdíl dopočítá znovu. Smysl rozdělení: uživatel
+> číselníky průběžně doplňuje (ručně i samoučením jmen z projektů) a **přeinstalace novou verzí
+> mu je nesmí přepsat** – zároveň smí nová verze dodávaný číselník libovolně měnit.
+> Klíč položky: `Nazev` (organizace, firmy, kraje), `Hodnota` (jména, verze), `Oznaceni` (části);
+> porovnává se bez ohledu na velikost písmen.
 
 ### 3.5 Konfigurace
 
@@ -396,8 +406,8 @@ Orientační fázování (priorita shora dolů):
 - **Formát uložení** – rozdělené úložiště:
   - **Projekt** (údaje + seznam příloh + **revize**) = interní data jedné zakázky → formát k rozhodnutí
     (JSON / SQLite / vlastní).
-  - **Číselníky** (organizace, firmy, jména, profese, verze, části) = **externí databáze vedle `.exe`**,
-    sdílená a doplňovatelná napříč projekty ([3.4](#34-číselníky)) → formát k rozhodnutí.
+  - ~~**Číselníky** – formát a umístění.~~ **Vyřešeno:** dvě vrstvy JSON – dodávaná vedle `.exe`,
+    uživatelská (rozdíl) v `%APPDATA%\Rozpisky` ([3.4](#34-číselníky)).
 - **Generátor 47-pozičního kódu** – doimplementovat dle manuálu kap. 3.2.1–3.2.8 vč. okrajových případů
   (sdružené objekty `SK`/`PK`, kap. 3.3; pracovní vs. definitivní verze).
 - **Orientační schéma** – jak se obrázek schématu získá/přiřadí k příloze (vstup uživatele vs. generování).