Fix auto pricelist resolution and latest-price selection; update Bible

bible/02-architecture.md

@@ -118,6 +118,26 @@ A configuration can reference up to three pricelists simultaneously:
 
 Pricelist sources: `estimate` | `warehouse` | `competitor`
 
+### "Auto" Pricelist Selection
+
+Configurator supports explicit and automatic selection per source (`estimate`, `warehouse`, `competitor`):
+
+- **Explicit mode:** concrete `pricelist_id` is set by user in settings.
+- **Auto mode:** client sends no explicit ID for that source; backend resolves the current latest active pricelist.
+
+`auto` must stay `auto` after price-level refresh and after manual "refresh prices":
+- resolved IDs are runtime-only and must not overwrite user's mode;
+- switching to explicit selection must clear runtime auto resolution for that source.
+
+### Latest Pricelist Resolution Rules
+
+For both server (`qt_pricelists`) and local cache (`local_pricelists`), "latest by source" is resolved with:
+
+1. only pricelists that have at least one item (`EXISTS ...pricelist_items`);
+2. deterministic sort: `created_at DESC, id DESC`.
+
+This prevents selecting empty/incomplete snapshots and removes nondeterministic ties.
+
 ---
 
 ## Configuration Versioning

bible/03-database.md

@@ -45,6 +45,7 @@ File: `qfs.db` in the user-state directory (see [05-config.md](05-config.md)).
 INDEX local_pricelist_items(pricelist_id)
 UNIQUE INDEX local_pricelists(server_id)
 INDEX local_pricelists(source, created_at)   -- used for "latest by source" queries
+-- latest-by-source runtime query also applies deterministic tie-break by id DESC
 
 -- Configurations
 INDEX local_configurations(pricelist_id)

bible/04-api.md

@@ -31,12 +31,14 @@
 
 | Method | Endpoint | Purpose |
 |--------|----------|---------|
-| GET | `/api/pricelists` | List pricelists |
+| GET | `/api/pricelists` | List pricelists (`source`, `active_only`, pagination) |
 | GET | `/api/pricelists/latest` | Latest pricelist by source |
 | GET | `/api/pricelists/:id` | Pricelist by ID |
 | GET | `/api/pricelists/:id/items` | Pricelist line items |
 | GET | `/api/pricelists/:id/lots` | Lot names in pricelist |
 
+`GET /api/pricelists?active_only=true` returns only pricelists that have synced items (`item_count > 0`).
+
 ### Configurations
 
 | Method | Endpoint | Purpose |
@@ -46,7 +48,7 @@
 | GET | `/api/configs/:uuid` | Get configuration |
 | PUT | `/api/configs/:uuid` | Update configuration |
 | DELETE | `/api/configs/:uuid` | Archive configuration |
-| POST | `/api/configs/:uuid/refresh` | Refresh prices from pricelist |
+| POST | `/api/configs/:uuid/refresh-prices` | Refresh prices from pricelist |
 | POST | `/api/configs/:uuid/clone` | Clone configuration |
 | POST | `/api/configs/:uuid/reactivate` | Restore archived configuration |
 | POST | `/api/configs/:uuid/rename` | Rename configuration |

bible/07-dev.md

@@ -130,6 +130,7 @@ if found && price > 0 {
 
 **Problem: configuration refresh does not update prices**
 1. Refresh uses the latest estimate pricelist by default
-2. `local_pricelist_items` must have data
+2. Latest resolution ignores pricelists without items (`EXISTS local_pricelist_items`)
 3. Old prices in `config.items` are preserved if a line item is not found in the pricelist
 4. To force a pricelist update: set `configuration.pricelist_id`
+5. In configurator, `Авто` must remain auto-mode (runtime resolved ID must not be persisted as explicit selection)