chore(release): 0.1.8

chore(deps): set Renovate release age, PR limit and update groups (WealthLedger/main#6) (#64 )
chore(release): 0.1.7
2026-11-06 07:47:24 +03:00 · 2026-11-03 14:07:41 +03:00 · 2026-11-01 19:33:26 +03:00 · 2026-11-01 19:29:01 +03:00 · 2026-11-01 19:13:01 +03:00 · 2026-10-30 07:28:25 +03:00
52 changed files with 2618 additions and 1407 deletions
@@ -0,0 +1,15 @@
+---
+name: Bug Report
+about: Неверное поведение
+---
+# Bug Report
+
+## Проблема и шаги воспроизведения
+
+## Факт / ожидание
+
+## Acceptance Criteria
+
+- [ ]
+
+## Окружение / ссылки (если применимо)
@@ -0,0 +1,13 @@
+---
+name: Engineering Task
+about: CI, тесты, документация, процесс и прочее
+---
+# Engineering Task
+
+## Контекст и результат
+
+## Scope / связанные Issues (если есть)
+
+## Acceptance Criteria
+
+- [ ]
@@ -0,0 +1,15 @@
+---
+name: Feature Request
+about: Новое наблюдаемое поведение
+---
+# Feature Request
+
+## Зачем и какой результат
+
+## Ожидаемое поведение
+
+## Acceptance Criteria
+
+- [ ]
+
+## Зависимости / связанные Issues (если есть)
@@ -0,0 +1,15 @@
+---
+name: Refactoring / Technical Debt
+about: Улучшение без нового поведения
+---
+# Refactoring / Technical Debt
+
+## Проблема и результат
+
+## Сохраняемые инварианты / границы
+
+## Acceptance Criteria
+
+- [ ]
+
+## Зависимости / ссылки (если есть)
@@ -0,0 +1,19 @@
+# Pull Request
+
+## Summary
+
+Краткий результат работы описывается здесь.
+
+## Linked Issue
+
+Refs `<owner/repo#number>` (заменить ссылкой на реальную Issue).
+
+## Changes
+
+Затронутые части и изменения.
+
+## Verification
+
+- Команда / результат / ограничения:
+
+## Breaking Changes (если есть)
@@ -4,6 +4,10 @@ on:
  pull_request:
    types: [opened, synchronize, reopened, edited]

+concurrency:
+  group: docs-commits-${{ gitea.event.pull_request.number }}
+  cancel-in-progress: true
+
 jobs:
  commits:
    runs-on: ubuntu-latest
@@ -23,4 +27,8 @@ jobs:
          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
        run: |
          printf '%s\n' "$PR_TITLE" | npm run commitlint -- --strict
-          npm run commitlint -- --strict --from "$BASE_SHA" --to "$HEAD_SHA"
+          if [[ "$PR_TITLE" =~ ^chore\(release\):\ [0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            npm run commitlint -- --strict --from "$HEAD_SHA^" --to "$HEAD_SHA"
+          else
+            npm run commitlint -- --strict --from "$BASE_SHA" --to "$HEAD_SHA"
+          fi
@@ -2,12 +2,16 @@ name: Docs security

 on:
  push:
-    branches:
-      - '**'
+    branches: [develop, main]
  pull_request:
+    types: [opened, synchronize, reopened]
  schedule:
    - cron: '17 5 * * *'

+concurrency:
+  group: docs-security-${{ gitea.event_name }}-${{ gitea.event.pull_request.number || gitea.ref }}
+  cancel-in-progress: true
+
 jobs:
  security:
    runs-on: ubuntu-latest
@@ -2,8 +2,13 @@ name: Docs verify

 on:
  push:
-    branches: ['**']
+    branches: [develop, main]
  pull_request:
+    types: [opened, synchronize, reopened]
+
+concurrency:
+  group: docs-verify-${{ gitea.event_name }}-${{ gitea.event.pull_request.number || gitea.ref }}
+  cancel-in-progress: true

 jobs:
  verify:
@@ -0,0 +1,6 @@
+{
+  "extends": ".markdownlint.json",
+  "MD024": {
+    "siblings_only": true
+  }
+}
@@ -1,21 +0,0 @@
-{
-  "config": {
-    "MD013": false
-  },
-  "customRules": [
-    "markdownlint-rule-relative-links"
-  ],
-  "overrides": [
-    {
-      "filter": [
-        "CHANGELOG.md"
-      ],
-      "config": {
-        "MD024": {
-          "siblings_only": true
-        }
-      },
-      "combine": "merge"
-    }
-  ]
-}
@@ -0,0 +1 @@
+module.exports = require('markdownlint-rule-relative-links').default;
@@ -0,0 +1,3 @@
+{
+  "MD013": false
+}
@@ -1 +1 @@
-24.21.0
+24.22.1
@@ -3,6 +3,9 @@
 Перед изменением прочитай [README](README.md) и [CONTRIBUTING](CONTRIBUTING.md),
 затем только затронутую тему. Docs объясняет систему; требования принадлежат
 основным спецификациям, реализация и coding conventions — соседним репозиториям.
+До edits найди/создай подходящую Gitea Issue, проверь AC и ветку; чтение
+допускается без Issue. Общий маршрут — [Engineering Workflow](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/03b3b59e6ff2ba391f9dfc42a039a96d0d84c1c9/.ai/conventions/engineering-workflow.md)
+(main#28; после merge — актуальная версия `develop`).

 Проверь существенные факты по локальным тематическим страницам и ADR;
 внешние источники используй как справочные свидетельства, когда они доступны.
@@ -20,7 +23,13 @@

 ## Ветки и релизы

-Работа — в отдельной ветке от `develop`, затем PR в `develop`; в `main` напрямую
-не пушить. Release/hotfix и синхронизация веток — по [README](README.md#релизы).
-Commits и заголовки PR — Conventional Commits; для спецификаций допустим `spec:`.
+Работа — в issue-linked ветке от `develop`, затем PR в `develop`; в `main` напрямую
+не пушить. PR сливается squash или rebase-merge; merge-коммит не используется.
+`main` обновляется только fast-forward из `develop`, поэтому `origin/main`
+всегда предок `origin/develop`:
+`git merge-base --is-ancestor origin/main origin/develop`. Срочный fix —
+обычная ветка `fix/*` от `develop`; пути hotfix от `main` нет.
+Релиз — по [README](README.md#релизы).
+Commits и заголовки PR — Conventional Commits со ссылкой на Issue (кроме release);
+для спецификаций допустим `spec:`.
 Перед подготовкой релиза прочитай местный README; версии вручную не повышать.
@@ -1,5 +1,84 @@
 # Changelog

+## [0.1.8](https://git.personal.ksv741.ru/WealthLedger/docs/compare/v0.1.7...v0.1.8) (2026-11-06)
+
+### Maintenance
+
+* **deps:** set Renovate release age, PR limit and update groups (WealthLedger/main[#6](https://git.personal.ksv741.ru/WealthLedger/docs/issues/6)) ([#64](https://git.personal.ksv741.ru/WealthLedger/docs/issues/64)) ([6d7d4c7](https://git.personal.ksv741.ru/WealthLedger/docs/commit/6d7d4c7b286535b7338d7e398d2daf7d8137a501))
+
+## [0.1.7](https://git.personal.ksv741.ru/WealthLedger/docs/compare/v0.1.6...v0.1.7) (2026-11-01)
+
+### Documentation
+
+* describe all-account row grouping (WealthLedger/main[#47](https://git.personal.ksv741.ru/WealthLedger/docs/issues/47)) ([#59](https://git.personal.ksv741.ru/WealthLedger/docs/issues/59)) ([dcb528f](https://git.personal.ksv741.ru/WealthLedger/docs/commit/dcb528fa9f76f0d7aa98bd827cc7ee39024dbb13))
+* describe concentration tab and stored instrument classification (WealthLedger/main[#48](https://git.personal.ksv741.ru/WealthLedger/docs/issues/48)) ([#60](https://git.personal.ksv741.ru/WealthLedger/docs/issues/60)) ([37430da](https://git.personal.ksv741.ru/WealthLedger/docs/commit/37430da4c99cb571ef5bc0676cad7b3a47bcb6f0))
+
+### Maintenance
+
+* **deps:** resolve markdownlint audit advisory (WealthLedger/main[#49](https://git.personal.ksv741.ru/WealthLedger/docs/issues/49)) ([#61](https://git.personal.ksv741.ru/WealthLedger/docs/issues/61)) ([abe5b16](https://git.personal.ksv741.ru/WealthLedger/docs/commit/abe5b16241d3002baa5d39c2a12949f23a75b968))
+
+## [0.1.6](https://git.personal.ksv741.ru/WealthLedger/docs/compare/v0.1.5...v0.1.6) (2026-10-24)
+
+### Maintenance
+
+* bump Node to 24.22.1 (WealthLedger/backend[#122](https://git.personal.ksv741.ru/WealthLedger/docs/issues/122)) ([4216eb8](https://git.personal.ksv741.ru/WealthLedger/docs/commit/4216eb815f59b7a284e679ccb1b725438da07882))
+* **deps:** update non-major dependencies (WealthLedger/docs[#56](https://git.personal.ksv741.ru/WealthLedger/docs/issues/56)) ([f9098d8](https://git.personal.ksv741.ru/WealthLedger/docs/commit/f9098d84098467e41143bad5044085d6329099d9))
+
+## [0.1.5](https://git.personal.ksv741.ru/WealthLedger/docs/compare/v0.1.4...v0.1.5) (2026-10-18)
+
+### Documentation
+
+* align current pages with hourly freshness model (WealthLedger/docs[#34](https://git.personal.ksv741.ru/WealthLedger/docs/issues/34)) ([#42](https://git.personal.ksv741.ru/WealthLedger/docs/issues/42)) ([7b61eb8](https://git.personal.ksv741.ru/WealthLedger/docs/commit/7b61eb8e6ba93a765b1ae27ca31d77b5e422e149))
+* describe ASCII 8-72 password policy and drop resolved discrepancy (WealthLedger/docs[#46](https://git.personal.ksv741.ru/WealthLedger/docs/issues/46)) ([#47](https://git.personal.ksv741.ru/WealthLedger/docs/issues/47)) ([56885f4](https://git.personal.ksv741.ru/WealthLedger/docs/commit/56885f450bc1298d383d496174d16e591926e047))
+* describe events default period and picker bounds (WealthLedger/frontend[#63](https://git.personal.ksv741.ru/WealthLedger/docs/issues/63)) ([8a2a62c](https://git.personal.ksv741.ru/WealthLedger/docs/commit/8a2a62c611e1acc1c1e69048a88b049bbf0d9087))
+* describe quiet reading and visible source state ([#51](https://git.personal.ksv741.ru/WealthLedger/docs/issues/51)) ([e8e3ef6](https://git.personal.ksv741.ru/WealthLedger/docs/commit/e8e3ef62854dae8448deaa66ac26e5b15d5c7d6a))
+* document income without comparisons and unified payouts (WealthLedger/main[#33](https://git.personal.ksv741.ru/WealthLedger/docs/issues/33)) ([#40](https://git.personal.ksv741.ru/WealthLedger/docs/issues/40)) ([03fb045](https://git.personal.ksv741.ru/WealthLedger/docs/commit/03fb045a9ee8a36775599bda66e7f6a08362bd84))
+* document Nexus delivery with shared account (WealthLedger/docs[#18](https://git.personal.ksv741.ru/WealthLedger/docs/issues/18)) ([#48](https://git.personal.ksv741.ru/WealthLedger/docs/issues/48)) ([550143a](https://git.personal.ksv741.ru/WealthLedger/docs/commit/550143aea1f0ac90630f326dd927091b0ec4f38e))
+
+### CI
+
+* rerun commits proof on PR title edit (WealthLedger/docs[#35](https://git.personal.ksv741.ru/WealthLedger/docs/issues/35)) ([03110e9](https://git.personal.ksv741.ru/WealthLedger/docs/commit/03110e99ea58600bacd4c091fda8591d374a5a8d))
+
+### Maintenance
+
+* adopt linear git model in docs instructions ([#49](https://git.personal.ksv741.ru/WealthLedger/docs/issues/49)) ([11f819e](https://git.personal.ksv741.ru/WealthLedger/docs/commit/11f819ed31226a05524ac35a893064525713e41b))
+
+## [0.1.4](https://git.personal.ksv741.ru/WealthLedger/docs/compare/v0.1.3...v0.1.4) (2026-10-12)
+
+### Bug Fixes
+
+* align docs commitlint workflow (WealthLedger/main[#27](https://git.personal.ksv741.ru/WealthLedger/docs/issues/27)) ([602eb43](https://git.personal.ksv741.ru/WealthLedger/docs/commit/602eb43294509274cbd9003be31f726b6e275a1e))
+
+### Documentation
+
+* clarify card summary totals ([df6f010](https://git.personal.ksv741.ru/WealthLedger/docs/commit/df6f0109ed696a529cf2622e23fceeab8133f932))
+* document hourly attempt lifecycle semantics (WealthLedger/backend[#56](https://git.personal.ksv741.ru/WealthLedger/docs/issues/56)) ([1378ac9](https://git.personal.ksv741.ru/WealthLedger/docs/commit/1378ac9fe2fcfd43bd71421e62b02f00069be928))
+* document hourly investment reads ([f0cab44](https://git.personal.ksv741.ru/WealthLedger/docs/commit/f0cab445d7e7076bf92a61f1023b8bf51e094d33))
+* document hourly sync history ([e0bceea](https://git.personal.ksv741.ru/WealthLedger/docs/commit/e0bceea936239c08f4717e264be23d7f60552398))
+* document stock screener ([2c34023](https://git.personal.ksv741.ru/WealthLedger/docs/commit/2c34023af8593f305f7c81e672b4e179c0992cf3))
+* pin docs workflow reference (WealthLedger/main[#27](https://git.personal.ksv741.ru/WealthLedger/docs/issues/27)) ([c24e4b9](https://git.personal.ksv741.ru/WealthLedger/docs/commit/c24e4b990aaeffd02e05f7de21942579e452cecf))
+
+### CI
+
+* avoid duplicate PR checks ([4caa5e9](https://git.personal.ksv741.ru/WealthLedger/docs/commit/4caa5e92b7d2597e5c7725b2036007b71ece2abd))
+* skip checks on PR metadata edits ([e6fd4f6](https://git.personal.ksv741.ru/WealthLedger/docs/commit/e6fd4f64b81dd73b33959b845a1babcfac1891c8))
+
+### Maintenance
+
+* align docs engineering workflow (WealthLedger/main[#27](https://git.personal.ksv741.ru/WealthLedger/docs/issues/27)) ([eaf7ede](https://git.personal.ksv741.ru/WealthLedger/docs/commit/eaf7ede8414f0df972f9ae7ab9e223a6350b5462))
+
+## [0.1.3](https://git.personal.ksv741.ru/WealthLedger/docs/compare/v0.1.2...v0.1.3) (2026-10-07)
+
+### Bug Fixes
+
+* **deps:** refresh docs security baseline ([256d49b](https://git.personal.ksv741.ru/WealthLedger/docs/commit/256d49b04591d55d980a22c49b413432c9bda746))
+* **deps:** remove vulnerable docs tooling ([9477e68](https://git.personal.ksv741.ru/WealthLedger/docs/commit/9477e688d180783881abc92f8835517715880279))
+
+### Documentation
+
+* record code quality review and refactoring ([6fa62fb](https://git.personal.ksv741.ru/WealthLedger/docs/commit/6fa62fb8b51aba82766fb50b3e5871572af8be27))
+* record minimal runtime coordination ([0ee54ca](https://git.personal.ksv741.ru/WealthLedger/docs/commit/0ee54ca952db6ca7264c0d7fe8cf5759b3187c5b))
+
 ## [0.1.2](https://git.personal.ksv741.ru/WealthLedger/docs/compare/v0.1.1...v0.1.2) (2026-09-26)

 ### Documentation
@@ -177,9 +177,10 @@ Markdown-only правки не требуют тестов приложения

 `security.yml` при push, PR и ежедневно проверяет всю Git-историю через
 Gitleaks 8.30.1 с redacted-выводом и все npm dependencies через
-`npm audit --include=dev --audit-level=low`. Override `smol-toml` исправляет
-DoS в TOML parser markdownlint-cli2; его можно удалить, когда родительский
-пакет примет исправленную версию.
+`npm audit --include=dev --audit-level=low`. Overrides `smol-toml` и `js-yaml`
+исправляют DoS в parsers markdownlint-cli; overrides для release-it обновляют
+уязвимые basic-ftp и undici. Их можно удалить, когда родительские пакеты
+примут исправленные версии.

 Renovate объединяет minor/patch updates; major требует согласования в
 Dependency Dashboard, automerge не включён. Required checks включаются
@@ -30,12 +30,12 @@ WealthLedger помогает частному инвестору понимат
 | [Аутентификация](domains/authentication/overview.md) | Регистрация, вход, восстановление и завершение сессии |
 | [Счета](domains/accounts/overview.md) | Доступные счета, сводки и состояния каждого счёта |
 | [Банковские карты](domains/cards/overview.md) | Ручные остатки, операции, категории, возвраты, месячные сводки и исправления |
-| [Портфель](domains/portfolio/overview.md) | Позиции, остатки, суммы, структура и свежесть |
+| [Портфель](domains/portfolio/overview.md) | Позиции, остатки, суммы, структура, [концентрация](domains/portfolio/concentration.md) и свежесть |
 | [Все счета](domains/portfolio/all-accounts.md) | Общий портфель, происхождение строк и сводные разделы |
 | [Операции](domains/operations/overview.md) | Исполненные операции, фильтры и пагинация |
 | [Доход](domains/income/overview.md) | Полученные купоны и дивиденды, периоды и состав расчёта |
 | [Будущие выплаты](domains/income/upcoming-events.md) | Календарь по текущим позициям и ограничения прогноза |
-| [Акции](domains/instruments/stocks.md) и [облигации](domains/instruments/bonds.md) | Поиск выпуска, рыночные показатели и личная история |
+| [Скринер акций](domains/instruments/stocks.md) и [облигации](domains/instruments/bonds.md) | Подбор акций по параметрам, поиск выпуска, рыночные показатели и личная история |

 ## Найти материал по задаче

@@ -72,35 +72,60 @@ WealthLedger помогает частному инвестору понимат
 ## Релизы

 Репозиторий выпускается независимо. `develop` — интеграция, `main` — принятые
-релизы. Работа: `codex/<task>` от актуального `develop`, PR в `develop`.
-Обычные PR допускают squash; release и обратная синхронизация сохраняют историю.
-Commits и PR titles — Conventional Commits, включая `spec:`. Версии вручную не повышай.
+релизы. Обычная работа: issue-linked ветка от актуального `develop`, PR в `develop`;
+общие правила — в Engineering Workflow по ссылке из AGENTS.
+PR сливается squash или rebase-merge; merge-коммит не используется. `main`
+обновляется только fast-forward из `develop`, поэтому история линейна:

-1. Получи `main`, `develop` и теги: `git fetch origin --tags`. Убедись, что
-   `develop` содержит последний релиз. Создай `release/<name>` от проверенного
-   `develop`; `nvm use --silent`, `npm ci`. Hotfix начинается от `main` в
-   `release/hotfix-<name>` и проходит тот же процесс.
+```text
+<type>/<issue>-<slug> --squash--> develop --ff-only--> main --> tag vX.Y.Z
+```
+
+Инвариант: `origin/main` всегда предок `origin/develop`. Проверка:
+
+```bash
+git fetch -q origin
+git merge-base --is-ancestor origin/main origin/develop && echo ok || echo BROKEN
+```
+
+Commits и PR titles — Conventional Commits со ссылкой на Issue (кроме release),
+включая `spec:`. Версии вручную не повышай.
+
+1. Получи `main`, `develop` и теги: `git fetch origin --tags`. Проверь
+   инвариант. Создай `release/X.Y.Z` от проверенного `develop`;
+   `nvm use --silent`, `npm ci`.
 2. На чистой ветке выполни `npm run release:preview`, просмотри версию/changelog,
   затем `npm run release:prepare`. Команда создаёт `chore(release): X.Y.Z`,
   обновляет manifest/lockfile/CHANGELOG; тег и push не выполняет. Не обходи
   guards ветки, чистого дерева, отсутствующих тегов или уже подготовленной версии.
 3. Проверь diff и штатные gates этого репозитория. Отправь только release-ветку,
-   открой PR в `main` с заголовком `chore(release): X.Y.Z`. После зелёных
-   `verify`, `security`, `commits` выполни fast-forward-only merge. Если `main`
-   изменился, согласуй историю и повтори проверки кандидата.
-4. Получи удалённый `main`, сравни его HEAD с проверенным release SHA и версией
+   открой PR в **`develop`** с заголовком `chore(release): X.Y.Z`. После зелёных
+   `verify`, `security`, `commits` выполни fast-forward-only merge. Если
+   `develop` изменился, обнови release-ветку и повтори проверки кандидата.
+4. Открой PR `develop → main` с тем же заголовком и слей fast-forward-only.
+5. Получи удалённый `main`, сравни его HEAD с проверенным release SHA и версией
   manifest/lockfile. Создай аннотированный `vX.Y.Z` именно на этом SHA:
   `git tag -a vX.Y.Z <release-sha> -m "Release X.Y.Z"`, затем отправь только
   `git push origin refs/tags/vX.Y.Z`. Не запускай release-it повторно на `main`.
-5. Верни release-коммит через PR `main → develop` без squash/rebase; проверь,
-   что `develop` содержит тег. Опубликованные теги не перемещай. При сбое после
-   merge создай отсутствующий тег без нового bump; до merge исправь и проверь
-   существующий кандидат без повторного повышения версии.
+
+Обратная синхронизация не нужна: release-коммит попал в `develop` на шаге 3.
+Опубликованные теги не перемещай. При сбое после merge создай отсутствующий тег
+без нового bump; до merge исправь и проверь существующий кандидат без
+повторного повышения версии.
+
+Freeze релиза не поддерживается: пока открыт релизный PR, `develop` не двигают.
+Срочный fix — обычная ветка `fix/*` от `develop` с последующим релизом;
+пути от `main` нет, он сделал бы `main` не-предком `develop`. Исключение
+требует явного решения: `release/hotfix-<name>` от `main`, PR в `main`, тег,
+затем merge `main → develop` для восстановления инварианта.

 `feat:` повышает minor, `fix:`/`perf:` и прочие разрешённые типы — patch;
 `!`/`BREAKING CHANGE:` — major, включая версии до 1.0. `chore(release):`
 исключён из рекомендации и changelog. Конфигурация — `.release-it.json`.
 В Gitea для `main`/`develop` должны быть запрещены прямой/force push и обход
-администратором, обязательны `verify`, `security`, `commits`; теги `v*` защищены.
+администратором, включена блокировка устаревшей ветки, обязательны `verify`,
+`security`, `commits`; теги `v*` защищены. Линейность обеспечивают merge styles
+репозитория: merge-коммиты и rebase `--no-ff` выключены, доступны squash,
+rebase-merge и fast-forward-only; стиль по умолчанию — squash.
 Workflow сам не включает эти настройки. Отдельное review approval для одного
 владельца не требуется. Npm publishing, deploy и Gitea Releases не включены.
@@ -2,6 +2,9 @@

 **Status:** Accepted; supersedes the refresh-token reuse rule in ADR-006.

+Cookie-clearing policy уточнена в [ADR 018](018-minimal-runtime-coordination.md):
+неуспешный refresh больше не удаляет cookie. CAS и отказ superseded token сохранены.
+
 ## Context

 Два одновременных запроса могут предъявить один действительный refresh token. Отзыв Session для проигравшего запроса делает недействительной сессию успешного запроса, а сохранение отдельной истории token или grace-window для различения replay добавляет непропорциональное состояние локальному MVP.
@@ -1,6 +1,12 @@
 # 017. Локальное чтение данных T-Bank и фоновая синхронизация

-**Status:** Accepted — архитектурное направление согласовано.
+**Status:** Accepted — историческое архитектурное направление. Решения ниже о
+request-driven запуске, ручном обновлении и отсутствии периодического обхода
+заменены [ADR 019](019-hourly-reads-and-online-instrument-reference.md).
+
+Prefetch policy ниже заменена [ADR 018](018-minimal-runtime-coordination.md):
+свечи загружаются по запрошенному диапазону, без предварительной загрузки
+всей истории бумаг портфеля. Остальные гарантии локального хранения сохранены.

 Реализация `persist-tbank-data` добавлена в рабочие ветки приложения;
 performance/browser и canonical application gates пройдены. Это не отметка
@@ -0,0 +1,45 @@
+# 018. Минимальная runtime-координация
+
+**Status:** Accepted. Уточняет cookie policy ADR 009 и prefetch policy ADR 017.
+
+## Context
+
+Изоляция владельцев данных, атомарные финансовые изменения и локальное чтение
+не требуют отдельного протокола согласования каждого HTTP-ответа. Дополнительная
+координация оправдана только наблюдаемым поведением, которое иначе нарушается.
+
+## Decision
+
+- Refresh сохраняет атомарную ротацию. Неуспешный refresh не меняет cookie:
+  поздний отказ не должен удалять cookie успешного запроса. Logout очищает cookie.
+- Frontend объединяет refresh и упорядочивает cookie-writing requests только
+  внутри вкладки. Cross-tab auth synchronization не является требованием;
+  после изменения сессии в другой вкладке допускаются reload или re-login.
+- Отменой, сбросом и публикацией query results владеет TanStack Query.
+  Смена session/connection очищает соответствующий cache; отдельные registries
+  HTTP-запросов, access epochs и URL-wide latest-read counters не используются.
+  Локальная auth boundary предотвращает применение старого auth result и
+  повтор mutation под другой identity.
+- Status GET читает только состояние работы. Открытый экран перечитывает
+  resources через `sync=observe` во время работы и после завершения.
+  Сверка hashes между status и data GET, публичные progress counters и
+  невыдаваемые sync states не нужны. Полнота истории остаётся в resource metadata.
+- Свечи загружаются для запрошенного диапазона. Предзагрузки всей истории
+  портфеля и автоматического расширения короткого периода до `all` нет.
+- Backend формирует согласованные entries и aggregates из одних исходных
+  данных; frontend доверяет этому contract и не выполняет вторую сверку групп.
+- Request context и HTTP completion принадлежат `nestjs-pino`/`pino-http`.
+  Проект сохраняет safe field filtering, redaction и route-template logging.
+- Deployment всегда выполняет один stop → backup → migration → readiness
+  цикл. No-op и frontend-only оптимизации не обещаются; короткий простой принят.
+
+## Consequences
+
+Первое открытие нового диапазона свечей может ждать загрузку. Наблюдение активной
+работы может перечитать неизменившиеся локальные данные, зато не требует
+checksum protocol. Повтор deployment создаёт новый backup и может остановить API.
+
+DB ownership подключения, conditional publication, coverage, staging,
+банковские intent fingerprints и версии записей сохраняются. Отмена HTTP
+не считается отменой уже выполняющейся server-side transaction.
+Сохранённый полный forecast не заменяется candidate с изменившимися dependencies.
@@ -0,0 +1,40 @@
+# 019. Часовой обход и онлайн-справочник инструментов
+
+**Status:** Accepted. Заменяет request-driven, manual-refresh и
+no-periodic-walk части [ADR 017](017-local-tbank-reads-and-background-sync.md)
+и дополняет [ADR 018](018-minimal-runtime-coordination.md). Правило «справочные
+сведения запрашиваются онлайн» дополнено исключением для сектора и бренда
+актива позиции — [ADR
+022](022-stored-instrument-classification.md).
+
+## Decision
+
+- Личные T-Bank данные текущего подключения обновляются владельцами источников
+  через durable hourly walk; его результат ограничен этой connection boundary.
+  Обычный GET и retry читают только сохранённый результат и не запускают
+  personal work.
+- Только первое открытие неподтверждённого исторического интервала operations
+  и первого неоткрытого диапазона candles может получить соответственно этот
+  интервал или диапазон. Это не manual sync; повторное чтение не расширяет и не
+  запускает такую работу заново.
+- Portfolio, operations, forecasts и события сохраняют собственные complete
+  результаты и время последнего успешного чтения. Результат ресурса
+  (freshness, completeness, `lastSuccessfulAt`, availability) независим от
+  resource-relevant последней часовой попытки: поздняя partial/failed попытка
+  не заменяет сохранённый complete result. При его отсутствии `data: null`.
+- Detail, company, catalog search и ticker lookup получают ответ онлайн через
+  существующие integration clients. Их ошибки не заменяют сохранённые
+  финансовые данные или подписи snapshot.
+- Старые справочные строки не являются источником актуальности и удаляются
+  только отдельной совместимой миграцией после проверки FK и свечей.
+- Клиент повторяет открытые инвестиционные GET не чаще одного раза в 30 минут;
+  retry повторяет чтение и не создаёт screen sync work. Наблюдение последней
+  попытки, включая Accounts `sync`, не является командой.
+
+## Consequences
+
+Карточки инструментов зависят от доступности публичного upstream в момент
+чтения. Финансовые экраны сохраняют последний успешный snapshot, а статус
+последнего hourly walk показывается отдельно. OpenAPI backend остаётся
+единственным исполняемым источником HTTP-контракта; frontend использует
+опубликованный snapshot.
@@ -0,0 +1,42 @@
+# 020. Evidence for hourly sync read boundaries
+
+**Status:** Accepted. Evidence for [ADR 019](019-hourly-reads-and-online-instrument-reference.md).
+
+## Measurements
+
+The backend persisted-read budget was measured with `npm run test:performance`
+using a synthetic SQLite dataset: three accounts, 100,000 operations per
+account, 200 instruments, and 5,000 candles per instrument. The run used Node
+24.21.0 on Apple M1 Pro with 32 GiB RAM and a failing synthetic upstream after
+population. It measured 100 reads per route family, excluding transport
+limiter cost.
+
+The generated evidence is written by the test to its temporary
+`persistent-budget.json` file. This is a repeatable measurement, not a
+production SLA: it does not include network latency, real T-Bank quotas, or
+multi-process SQLite contention.
+
+The successful run produced a 617,263,104-byte SQLite database and measured
+zero upstream calls during the persisted-read phase. Backend p50/p95 response
+times were approximately 1.3/2.3 ms for account and portfolio reads,
+3.9/4.5 ms for account operations, 6.7/7.2 ms for aggregate operations,
+40.0/41.5 ms for account income analytics, and 128.1/134.2 ms for aggregate
+income analytics. These figures are local synthetic measurements only.
+
+## Durability
+
+The migration durability check passes against a separately built repository at
+the pre-history migration prefix. It verifies preservation of users, sessions,
+T-Bank connection data, bank-card data, operations, categories, archive state,
+and replay behavior across migration and restart.
+
+The executed command was `node test/bank-cards-durability.cjs` with a separately
+built pre-history repository. It completed with `PASS durability`.
+
+## Limits
+
+The configured T-Bank start limiter is `TBANK_RATE_LIMIT_PER_SECOND`, default
+`5` per backend instance. The hourly scheduler therefore remains a single
+durable reservation owner; the measurement does not justify increasing this
+limit or changing the hourly cadence. Any production tuning requires current
+T-Bank documentation and a new measurement with the deployed topology.
@@ -0,0 +1,66 @@
+# 021. Тихое чтение и редкие подтверждения
+
+**Status:** Accepted. Заменяет manual-refresh часть
+[ADR 019](019-hourly-reads-and-online-instrument-reference.md) на стороне
+интерфейса и уточняет клиентскую часть
+[ADR 007](007-react-query-fetch-policy.md). Не меняет владельцев обновления
+и границы чтения из ADR 019.
+
+## Context
+
+Экраны просмотра перекладывали на пользователя контроль над получением данных:
+кнопки «Обновить» и «Повторить», индикатор фонового обновления и сообщение
+о неудачной синхронизации повторялись в разных разделах. Пользователь приходит
+смотреть финансы, а не обслуживать загрузку; восстановление после временного
+сбоя не должно зависеть от нажатия кнопки.
+
+При этом состояние самих данных остаётся значимым: время последнего успешного
+результата источника, устаревание и исход часовой попытки влияют на доверие
+к показанным суммам и не могут быть просто скрыты.
+
+## Decision
+
+- Автоматическое чтение клиента не сообщает о себе. Экраны просмотра не
+  показывают кнопок ручного обновления и повтора, индикаторов фонового
+  перечитывания и технических предупреждений о собственном запросе.
+- Временные сбои GET восстанавливаются сами: ограниченный срок ожидания запроса
+  и не более двух повторов с возрастающими паузами, затем возврат к штатной
+  работе при появлении результата. Пользователь не инициирует восстановление.
+- Состояние источника из `meta` остаётся видимым. Время последнего успешного
+  результата, признак устаревания, исход последней часовой попытки и неполнота
+  показываются текстом либо доступно именованным элементом, а не только цветом.
+  Это свойство данных, а не отчёт о техническом процессе, и оно не превращается
+  в действие пользователя.
+- Доступный результат сохраняется при обновлении и временной ошибке. Неполнота
+  и подтверждённая пустота остаются различимыми: неизвестная сумма не становится
+  нулём, незавершённый расчёт не выдаётся за окончательный, незагруженный список
+  не выдаётся за отсутствие записей.
+- Первичное ожидание ограничено по времени и показывает структуру будущего
+  содержимого. По его истечении экран переходит в спокойную локальную
+  недоступность вместо бесконечной загрузки и сам заменяет её содержимым после
+  восстановления. Сбой одного блока не скрывает остальные доступные блоки.
+- Ошибки явных действий пользователя сохраняются и остаются видимыми. Решение
+  касается только чтения; отправка формы, изменение данных и сброс фильтра
+  по-прежнему сообщают результат, в том числе неуспешный.
+
+## Consequences
+
+Пользователь не может ускорить обновление вручную: нормальным владельцем
+обновления остаётся часовой обход из ADR 019, и отсутствие кнопки не меняет его
+срок. Если источник недоступен долго, экран показывает прежние данные с
+обозначением устаревания, а не приглашение повторить.
+
+Автоматический повтор ограничен: он покрывает короткие сетевые сбои, но не
+длительную недоступность. Ошибки доступа, домена и отмены не повторяются,
+mutations не повторяются вовсе.
+
+Состояние источника и состояние клиентского чтения описывают разные вещи и
+не подменяют друг друга. `Portfolio.isStale` сохраняет смысл возраста снимка;
+ошибка клиентского перечитывания его не меняет.
+
+Детали поведения — в
+[ожидании и восстановлении интерфейса](../architecture/cross-cutting/ui-resilience.md)
+и [свежести данных](../architecture/cross-cutting/data-freshness.md).
+Согласованные требования принадлежат workspace-спецификациям
+`frontend-user-feedback`, `frontend-data-resilience` и
+`frontend-loading-presentation`.
@@ -0,0 +1,56 @@
+# 022. Хранимая классификация инструментов T-Bank
+
+**Status:** Accepted. Дополняет [ADR
+019](019-hourly-reads-and-online-instrument-reference.md) исключением из
+правила «справочные сведения запрашиваются онлайн». Решение утверждено
+владельцем в [Issue
+WealthLedger/main#48](https://git.personal.ksv741.ru/WealthLedger/main/issues/48).
+
+## Context
+
+ADR 019 установил, что справочные сведения инструментов (detail, lookup,
+каталоги) запрашиваются онлайн и не сохраняются как долговременный справочник:
+«старые справочные строки не являются источником актуальности». Вкладка
+«Концентрация» требует для каждой позиции её сектора и эмитента — бренда
+актива по данным T-Bank. Сектор есть только в описаниях отдельных типов
+инструментов (`share`, `bond`, `etf`), а эмитент — в описании актива по
+`asset_uid` инструмента; из названия, тикера, ISIN или `logoName` его вывести
+нельзя. Запрашивать эти поля онлайн при каждом открытии экрана нельзя:
+ответ Portfolio не ждёт T-Bank, а разрезы должны считаться по уже сохранённому
+снимку.
+
+Существующий metadata-кэш (`TbankInstrument`) не подходит: общий ответ
+`GetInstrumentBy` не содержит `sector`, а его `brand` — данные логотипа,
+а не `{uid, name}` бренда актива.
+
+## Decision
+
+- Сектор и бренд актива позиции хранятся как последнее известное значение в
+  глобальной таблице `TbankInstrumentClassification` (провайдер, ключ
+  инструмента, сектор и время его получения, uid актива и uid/название бренда
+  с временем получения). Данные публичные, без привязки к пользователю или
+  подключению; ограждение по connection revision к ним не применяется, публикация
+  Snapshot ограждается как прежде.
+- Каждое поле обновляется в часовом обходе при его первой попытке, начавшейся
+  не ранее чем через 24 часа после последнего успешного получения этого поля;
+  пока значение не получено, попытка повторяется в каждом обходе. Сектор и
+  бренд обновляются независимо.
+- Неуспешное получение не мешает публикации Portfolio Snapshot и не влияет на
+  его свежесть; сохранённое значение остаётся доступным. Отказ token
+  обрабатывается как отказ token при обходе Portfolio. Ответ «инструмент не
+  найден» сохраняет прежнее значение и перезапускает отсчёт 24 часов.
+- Классификация не входит в `meta.dependencies` Portfolio и не меняет
+  `isStale` и `lastSuccessfulAt`.
+
+## Consequences
+
+- Это первый долговременный справочник T-Bank в системе: ADR 019 теряет
+  характер «только онлайн» для этой области и дополняется, а не заменяется.
+- Разрезы концентрации считаются по снимку без обращений к T-Bank; число
+  вызовов растёт ограниченно — не более одной попытки на поле в сутки на
+  позицию, при первом обходе после выката возможен разовый всплеск, сглаженный
+  общим лимитером и очередью.
+- Значение может быть устаревшим до 24 часов; это приемлемо для группировки
+  позиций, но классификация не является источником актуальных данных брокера.
+- Второй потребитель хранимой классификации — условие пересмотра решения
+  (выделение независимого процесса обновления, отдельные сроки).
@@ -22,3 +22,8 @@
 - [015 — SQLite в ограниченном single-server deployment](015-single-server-sqlite-deployment.md)
 - [016 — Версионируемый комплект развёртывания](016-versioned-deployment-bundle.md)
 - [017 — Локальное чтение данных T-Bank и фоновая синхронизация](017-local-tbank-reads-and-background-sync.md)
+- [018 — Минимальная runtime-координация](018-minimal-runtime-coordination.md)
+- [019 — Часовой обход и онлайн-справочник инструментов](019-hourly-reads-and-online-instrument-reference.md)
+- [020 — Evidence for hourly sync read boundaries](020-hourly-sync-verification-evidence.md)
+- [021 — Тихое чтение и редкие подтверждения](021-quiet-reading-and-rare-confirmations.md)
+- [022 — Хранимая классификация инструментов T-Bank](022-stored-instrument-classification.md)
@@ -140,12 +140,20 @@ membership текущей revision перед каждым финансовым
 личные данные. Ротация refresh token остаётся атомарной.

 SQLite хранит полный последний portfolio, операции и их подтверждённые
-диапазоны, private прогнозы, общие instrument/market sources и intent/staging.
+диапазоны, private прогнозы, сохранённые точки истории оценки, общие
+instrument/market sources, классификацию инструментов (сектор и бренд актива
+как последнее известное значение с временем каждого получения,
+`TbankInstrumentClassification`) и intent/staging.
 Нормализованные финансовые значения сохраняются decimal-строками. Полнота
-отделена от свежести и пагинации. Ответ не ждёт внешних RPC; запрос при
-необходимости запускает работу в том же backend process через существующий
-лимитер. На startup импорт не запускается; восстановление требует следующего
-запроса. Подробности — [модель свежести](cross-cutting/data-freshness.md).
+отделена от свежести и пагинации. Ответ не ждёт внешних RPC; обновлением
+личных данных владеет часовой обход в том же backend process через
+существующий лимитер, недостающие общие источники он же ставит в фоновую
+очередь. На startup обход начинает следующую попытку по обычному часовому
+сроку; после нового подключения первая попытка начинается сразу.
+Классификация — публичные данные без привязки к пользователю и подключению;
+её поля обновляются в том же обходе не чаще раза в сутки
+([ADR 022](../adr/022-stored-instrument-classification.md)).
+Подробности — [модель свежести](cross-cutting/data-freshness.md).

 PUT подключения сначала проверяет token у T-Bank, затем одной транзакцией
 сохраняет encrypted token, новую revision и проверенный membership.
@@ -195,9 +203,8 @@ access token и вращаемый refresh token. [Политика query-кэш

 Авторизация доступа, недопущение token в публичный ответ и атомарность
 ротации сессии — отдельные свойства; наличие типизированного клиента
-не доказывает их. Известные расхождения регистрации и деталей валидации
-отмечены в [аутентификации](../domains/authentication/overview.md#регистрация-и-вход)
-и [HTTP API](http-api.md#error-contract).
+не доказывает их. Действующий формат ошибок описан в
+[HTTP API](http-api.md#error-contract).

 Поддерживается локальный Compose и ограниченная single-server topology с SQLite.
 Origin браузера, адрес API и cookie policy должны быть согласованы.
@@ -1,47 +1,79 @@
 # Свежесть данных и повторное использование

-WealthLedger читает инвестиционные данные из SQLite. Обычный GET возвращает
-сохранённый результат и запрашивает фоновые зависимости, если они отсутствуют
-или устарели. HTTP-ответ не ждёт T-Bank. Модель принята в
-[ADR 017](../../adr/017-local-tbank-reads-and-background-sync.md).
+WealthLedger читает личные инвестиционные данные из SQLite. Обычный GET и его
+HTTP retry возвращают сохранённый результат и не запускают личную работу с
+T-Bank. Нормальным владельцем обновления служит часовой обход текущего
+подключения: после успешного подключения он начинает первую попытку, затем
+начинает следующую не ранее чем через 60 минут от начала предыдущей. После
+простоя выполняется не более одна актуальная попытка, а перекрывающийся срок
+пропускается, не ставится в очередь. Общие справочные данные инструментов
+запрашиваются онлайн, когда это требуется карточке; финансовый HTTP-ответ не
+ждёт T-Bank. Единственное исключение — сектор и бренд актива позиции, которые
+хранятся как последнее известное значение с обновлением не чаще раза в сутки;
+свежесть и полнота Portfolio от них не зависят. Модель принята в
+[ADR 019](../../adr/019-hourly-reads-and-online-instrument-reference.md),
+исключение — в
+[ADR 022](../../adr/022-stored-instrument-classification.md).

 ## Клиентский и серверный снимки

 [Client Cached Snapshot](../../glossary.md#client-cached-snapshot) — успешный
 ответ в TanStack Query. Он сохраняет показанное содержимое при временной ошибке
-запроса в той же границе доступа. SQLite сохраняет источники независимо от
-браузера: membership, последний полный portfolio, исполненные операции,
-общие сведения об инструментах, котировки, свечи и календари.
+HTTP-перечитывания в той же границе доступа. Это не серверный fallback и не
+состояние часового обхода. SQLite независимо от браузера хранит membership,
+последний полный portfolio, исполненные операции, прогнозы, общие сведения об
+инструментах и классификацию инструментов (сектор и бренд актива как
+последнее известное значение, [ADR
+022](../../adr/022-stored-instrument-classification.md)), котировки, свечи и
+календари.

 [Полнота периода](../../glossary.md#полнота-истории-счёта) и свежесть различаются.
-Успешно проверенный пустой интервал полон; последняя страница журнала сама
-по себе полноту не доказывает. Ошибка сверки сохраняет прежние данные и время.
-Старый полный портфель не удаляется по истечении TTL. `isStale` показывает
-возраст portfolio source, а не сам факт неудачного обновления.
+Успешно проверенный пустой результат полон и доступен; последняя страница
+журнала сама по себе полноту не доказывает. Результат каждого личного ресурса
+в `{ data, meta }` описывают пять независимых значений: freshness,
+completeness, `lastSuccessfulAt`, `lastAttempt` и availability. Первые,
+полнота и `lastSuccessfulAt` относятся только к возвращённому подтверждённому
+результату. `lastAttempt` описывает относящуюся к ресурсу часовую попытку:
+`none`, `running`, `succeeded`, `partial` или `failed`.

-| Источник | Когда обычный запрос требует обновления |
+Итог попытки выводится из фактических результатов её шагов: попытка, не
+завершившая обязательный шаг, не обозначается полным успехом, а полученные
+успешные результаты сохраняются. Ожидание каждого шага ограничено; зависший
+шаг учитывается проблемным, а начатое обращение к T-Bank не отменяется.
+Попытка, потерявшая выполнение после сбоя сохранения или остановки процесса,
+закрывается частичным успехом либо неуспехом и не блокирует следующий обход
+дольше обычного часового срока.
+
+Поздняя неуспешная или частичная попытка сохраняет прежний полный результат и
+его исходное время. Если полного результата нет, `data` равно `null`: состояние
+availability объясняет первоначальную загрузку, временную недоступность либо
+недоступность подключения. Пустой массив не означает отсутствие результата.
+Старый полный portfolio не удаляется из-за возраста. `Portfolio.isStale`
+сохраняет смысл возраста его snapshot, а не обозначает неуспех обхода или
+клиентскую ошибку перечитывания.
+
+| Источник | Владелец нормального обновления |
 | --- | --- |
-| Portfolio, котировки, изменяемый хвост дневных свечей | Через 60 секунд |
-| Membership и изменяемый хвост операций | Через 5 минут |
-| Metadata, поиск каталога, company и календари | Через сутки |
-| Полные прошлые интервалы операций и завершённые свечи | При явном обновлении показанного периода |
+| Membership, portfolio, изменяемый хвост операций и события | Часовой обход текущего подключения |
+| Котировки и изменяемый хвост дневных свечей | Установленная политика источника; не ordinary personal GET |
+| Metadata, поиск каталога и company | Онлайн при чтении |
+| Полные прошлые интервалы операций и завершённые свечи | Не обновляются часовым обходом или обычным GET |

-TTL не создаёт таймер импорта. Запрошенная работа может закончиться после
-ухода со страницы. После перезапуска нет автоматического обхода intent:
-следующий подходящий запрос повторяет незавершённый интервал с первой страницы,
-переиспользуя полные интервалы. Cursor брокера не служит durable checkpoint.
+Два исключения разрешают только первое получение отсутствующего результата:
+первое открытие неподтверждённого исторического интервала операций получает
+только этот интервал и возвращает локальные строки с неполным покрытием; первое
+открытие диапазона свечей без подтверждённого локального результата получает
+только этот диапазон. Ни одно исключение не обновляет membership, portfolio,
+события, другой интервал или диапазон. Их HTTP retry также только перечитывает
+локальное состояние. Подтверждённый полный интервал или диапазон остаётся
+локальным.

-Ручное «Обновить» перечитывает зависимости текущего экрана и применённый
-период независимо от TTL. Повторная сверка полного периода публикуется одной
-транзакцией после всех страниц, интервалов и счетов, включая `all`.
-Сбой сохраняет весь прежний результат. Первая загрузка может публиковать
-полные малые интервалы и показывать частичный период без окончательных сумм.
-
-Клиент наблюдает только известную активную работу открытого экрана.
-Status GET и data GET с `sync=observe` не запускают работу. После изменения
-состояния ответ попадает в ту же query identity; после ухода или завершения
-наблюдение прекращается. Поздний ответ не заменяет уже принятый новый.
-[HTTP API](../http-api.md) объясняет envelope и экранный refresh.
+Часовой обход сохраняет успешные разделы независимо, а failed section не
+заменяет прежний complete result. Отменой query lifecycle владеет TanStack
+Query. Открытый экран перечитывает ресурс не чаще одного раза в 30 минут;
+это локальный HTTP read. Совместимый параметр `sync=observe`, пока он есть в
+маршруте, также является только чтением и не представляет команду обходу.
+[HTTP API](../http-api.md) описывает исполняемый контракт envelope.

 ## Смена подключения

@@ -16,11 +16,17 @@
 пока неизвестно, доступен public или protected маршрут. При загрузке
 отложенного маршрута уже доступный каркас остаётся видимым.

-Фоновое обновление и действие пользователя сохраняют видимые данные или
-элемент управления с компактной индикацией процесса. В частности,
+Фоновое чтение не сообщает о себе: оно сохраняет видимые данные без индикации
+процесса и без технического предупреждения. В частности,
 [клиентский снимок](data-freshness.md#клиентский-и-серверный-снимки) счетов или
-портфеля остаётся доступным после ошибки refetch; сообщение и повтор
-относятся к обновлению, а не к отсутствию инвестиций.
+портфеля остаётся доступным после ошибки refetch, и эта ошибка не означает
+отсутствие инвестиций. Действие пользователя сохраняет видимые данные или
+элемент управления и сообщает свой результат, включая неуспешный.
+
+Первичное ожидание ограничено по времени. По его истечении область переходит
+в спокойную локальную недоступность вместо бесконечной загрузки и сама
+заменяет её содержимым после восстановления. Решение принято в
+[ADR 021](../../adr/021-quiet-reading-and-rare-confirmations.md).

 Серверная полнота не выводится из query lifecycle. Missing показывает
 skeleton только отсутствующих секций, partial — подтверждённые строки и
@@ -28,20 +34,30 @@ skeleton только отсутствующих секций, partial — по
 готовятся независимо. Только complete empty означает отсутствие операций.
 Время источника не заменяется временем получения HTTP-ответа.

-Ручное обновление сохраняет показанный результат и applied filters; кнопка
-недоступна во время уже запрошенной работы. Ошибка transport отличается от
+Экраны просмотра не предлагают ручное обновление или повтор чтения: временные
+сбои GET восстанавливаются сами ограниченным числом повторов, сохраняя
+показанный результат и applied filters. Ошибка transport отличается от
 ошибки source work. Status observation прекращается после terminal outcome
 или ухода; само истечение TTL не запускает импорт. Известный access loss
 очищает personal view, включая защиту от позднего ответа.

+Состояние источника при этом видимо: время последнего успешного результата,
+устаревание, исход последней часовой попытки и неполнота показаны текстом либо
+доступно именованным элементом рядом с данными, к которым относятся. Это
+свойство данных, а не отчёт о техническом процессе, и оно не требует действия.
+
 ## Известная ошибка сценария

-Ошибки счетов, портфеля и подключения T-Bank остаются локальными: рядом
-с затронутыми данными доступны предусмотренные сценарием retry и navigation
-actions. Устаревший серверный Portfolio Snapshot показывает сохранённый
-портфель с предупреждением. Он не превращается в глобальный fallback.
+Ошибки счетов, портфеля и подключения T-Bank остаются локальными: затронутый
+блок показывает собственное состояние и не скрывает успешно отображённые
+соседние блоки. Устаревший серверный Portfolio Snapshot показывает сохранённый
+портфель с обозначением устаревания. Он не превращается в глобальный fallback.
 Ошибка источника не означает нулевой баланс или отсутствие операций.

+Предусмотренные сценарием navigation actions сохраняются: подтверждённая потеря
+доступа предлагает восстановить подключение, а `404` — вернуться к списку
+счетов. Это навигация и явные действия пользователя, а не повтор чтения.
+
 ## Непойманная ошибка маршрута

 Непойманная runtime-ошибка при отображении public или protected route
@@ -12,7 +12,7 @@ Development-команды ниже выполняются из workspace с che

 - Docker Engine с Compose plugin **не ниже 2.24.4** (`!override` в development),
  доступ к registry и достаточно свободного диска для non-root UID 1000.
-  Production images `0.2.3` опубликованы для Linux amd64.
+  Опубликованные images собраны для Linux amd64 (см. README комплекта).
  Другую архитектуру проверяют отдельно; multi-platform images не обещаны.
 - Nexus Docker hosted repository `docker-hosted`, доступный через
  `nexus.personal.ksv741.ru/docker-hosted/`. Docker Bearer Token Realm включён;
@@ -26,7 +26,10 @@ Development-команды ниже выполняются из workspace с che
  используется сервером для загрузки образов. Для публикации нужны
  browse/read/add/edit на `docker-hosted`; фактически выданный набор прав
  настраивается в Nexus. Built-in
-  workflow token не заменяет эту настройку.
+  workflow token не заменяет эту настройку. Отдельной read-only учётной записи
+  сервера нет: `wealthledger-ci` работает и как CI writer, и как server reader,
+  поэтому её пароль на сервере даёт право публикации в `docker-hosted`. Это
+  принятое владельцем решение; разделение ролей — возможное усиление.
 - На сервере Caddy уже завершает TLS и передаёт весь домен на
  `127.0.0.1:8080` (или выбранный frontend port). Отдельного `/api` upstream нет.
  DNS, TLS, firewall и provisioning Caddy выполняются вне этого runbook.
@@ -81,7 +84,8 @@ Workflow отказывается перезаписывать существу
 Выберите опубликованные version tags, выполните pull и сравните OCI revision
 с release commit. Выполните smoke с disposable data/config до первого server
 rollout. В `release.env` комплекта хранится пара полных image references, например
-`nexus.personal.ksv741.ru/docker-hosted/wealthledger/frontend:0.2.3`. Сохраните versions/revisions
+`nexus.personal.ksv741.ru/docker-hosted/wealthledger/frontend:1.1.0` и
+`.../backend:2.1.0`. Сохраните versions/revisions
 в deployment record. Release tags не должны переназначаться другим images.

 ## Перенос существующих images из Gitea
@@ -91,7 +95,9 @@ rollout. В `release.env` комплекта хранится пара полн
 `REGISTRY_USERNAME`/`REGISTRY_TOKEN` сохраните для отката старого workflow.
 Пароли вводятся интерактивно или через `--password-stdin`, не через аргументы.

-Скопируйте каждый опубликованный release без пересборки. Например, для `0.2.0`
+Прежние images лежат в [Gitea packages](https://git.personal.ksv741.ru/WealthLedger/-/packages)
+(`git.personal.ksv741.ru/wealthledger/{frontend,backend}`); новые публикуются
+только в Nexus. Скопируйте каждый опубликованный release без пересборки. Например, для `0.2.0`
 с установленным Skopeo и доступом чтения Gitea/записи Nexus:

 ```bash
@@ -114,7 +120,9 @@ artifact повторно не публикуйте; несовпадение т
 После копирования сравните digests через `skopeo inspect --raw` и SHA-256,
 выполните `docker pull` обоих images пользователем `wealthledger-ci` на сервере приложения,
 проверьте OCI revision и container smoke на disposable data.
-Только после этого меняйте production image references и запускайте обычную
+Серверные шаги (login, pull, smoke) в репозитории не подтверждены и
+выполняются оператором. Только после них меняйте
+production image references и запускайте обычную
 последовательность обновления ниже. Старые Gitea packages и references сохраните:
 откат registry возвращает прежние адреса тех же artifacts, не восстанавливает
 SQLite и не меняет encryption keys. Не переносите Git release tags и не
@@ -142,20 +150,15 @@ backups находятся рядом с data directory, вне checkout, и а
 не удаляются. Незавершённая копия помечается `.partial-` и не подходит для restore.
 Ключ шифрования хранится отдельно. Локальная копия не защищает от потери диска.

-## Независимое обновление frontend
+## Единый цикл обновления

-Если изменились только image или конфигурация frontend, backend не
-пересоздаётся, backup и migration не выполняются. Возможен короткий перерыв
-на внешней точке входа; старым browser tabs может потребоваться reload.
-При неизменных исправных контейнерах повтор команды не пересоздаёт сервисы.
-
-## Независимое обновление backend
-
-Изменение image или конфигурации backend запускает stop → backup → migration →
-readiness. Неизменный frontend не пересоздаётся. Во время простоя возможен 502.
+Каждое обновление, включая повтор того же тега и изменение только frontend,
+выполняет stop → backup → migration → readiness. Сравнение hashes контейнеров
+и конфигурации не выполняется. Приняты короткий простой API и дополнительный
+backup; во время простоя возможен 502, вкладкам может потребоваться reload.
 Ошибка migration блокирует старт, ошибка готовности останавливает новый backend;
 ошибка frontend не останавливает исправный backend. Успех фиксируется только
-после проверок запуска затронутых компонентов.
+после проверок запуска обоих компонентов.

 Одна file lock защищает установку от параллельных команд. Маркер незавершённого
 обновления блокирует повтор до разбора оператором. Он содержит этап, версии
@@ -2,7 +2,8 @@

 ## Источник контракта

-Backend генерирует OpenAPI из собственного публичного API. Frontend использует
+Backend генерирует OpenAPI из собственного публичного API. Этот сгенерированный
+OpenAPI — исполняемый источник HTTP-контракта. Frontend использует
 предоставленный OpenAPI snapshot как актуальный вход и локально генерирует
 типизированный клиент. Backend владеет контрактом, а подготовка и доставка
 схемы находятся вне frontend. Это разделение принято в
@@ -20,30 +21,57 @@ artifact у себя и проверяет соответствие generated ty
 API имеет prefix `/api/v1`; Swagger публикуется для локальной разработки по
 environment policy, а не используется frontend в runtime.

+## Скринер акций
+
+`POST /api/v1/stocks/screener/search` всегда создаёт новый результат по
+условиям скринера, включая пустой подтверждённый список. Ответ первой страницы
+содержит непрозрачный `searchId`, время получения каталога и признак следующей
+страницы. `GET /api/v1/stocks/screener/search/{searchId}?page=...` читает
+последующую страницу того же результата, не запускает новый поиск и сохраняет
+состав и время списка. Идентификатор результата принадлежит текущему пользователю
+и его подключению; недоступный или чужой результат возвращает ошибку, а не
+пустой список. Точные поля и статусы определяет backend-generated OpenAPI.
+
 ## Инвестиционные данные и синхронизация

-T-Bank data GET возвращают envelope `{ data, meta }`. `data` может быть `null`
-при missing или неполном финансовом агрегате; partial ledger/candles могут
-содержать подтверждённые строки. `meta` разделяет availability, freshness,
-lastSuccessfulAt, sync, coverage и состояния зависимостей. `dataRevision`
-описывает набор данных, `stateVersion` — наблюдаемое состояние, включая
-пустое завершённое покрытие. Ни одно поле не раскрывает connection revision.
+Затронутые GET инвестиционных ресурсов возвращают сгенерированный contract
+`{ data, meta }`. `data` nullable: `null` означает отсутствие complete result,
+а подтверждённый пустой массив является available complete result. `meta`
+независимо описывает freshness, completeness, `lastSuccessfulAt`,
+resource-relevant `lastAttempt` и availability. `lastAttempt` имеет состояния
+`none`, `running`, `succeeded`, `partial` и `failed`; его неуспех не заменяет
+сохранённый complete result или его время. `Portfolio.isStale` остаётся
+специфичным для snapshot полем, а не заменой состояния попытки.

-Обычный GET планирует missing/stale зависимости после проверки доступа.
-GET с `sync=observe` только читает. `POST /api/v1/tbank-sync` принимает
-валидированный screen descriptor и возвращает `202` с handle и нормализованным
-scope. `GET /api/v1/tbank-sync/:id` наблюдает разрешённую работу; чужой или
-прежний handle возвращает `404`. Приём работы не означает её успех.
+Только Accounts дополнительно возвращает top-level `sync`: `null`, если у
+текущего подключения ещё не было часовой попытки, иначе connection-wide
+наблюдаемый результат. Это наблюдение, не команда. Обычный GET и retry после
+проверки доступа читают локальное состояние и не начинают личную работу.
+Устаревший `sync=observe`, пока он сохранён для совместимости маршрута, также
+только читает. Request-started screen-sync command/status не является текущей
+AS-IS моделью.

-Source failure принятой работы передаётся безопасным `meta.sync.errorCode`;
-HTTP transport/access/input errors сохраняют Problem Details. Старые данные
-при transient failure сохраняют исходное успешное время. Детали поведения —
+Безопасные ошибки завершённой часовой попытки передаются в `lastAttempt` и
+Accounts `sync`; HTTP transport/access/input errors сохраняют Problem Details.
+Старые данные при временной source failure сохраняют исходное успешное время.
+Ни одно поле не раскрывает connection revision. Детали поведения —
 [свежесть и полнота](cross-cutting/data-freshness.md).

 Envelope несовместим с прежними bare-array ответами: backend/frontend
 поставляются согласованной парой. Финальный artifact передаётся явно;
 локальная генерация и CI frontend читают только собственный snapshot.

+## Income analytics
+
+`GET /api/v1/brokerage-accounts/{accountId}/income-analytics` и общий маршрут
+`all` возвращают результат только выбранного периода: итоги по исходным
+валютам, точные записи выплат, разбиение по инструментам и временные
+интервалы. Данных сравнения с предыдущим периодом или годом ранее в ответе
+нет — ни в теле, ни среди зависимостей `meta.dependencies`, роль которых
+ограничена значением `selected`. Публичную машинную схему задаёт
+backend-generated OpenAPI; frontend получает её обновлённый snapshot отдельно.
+Точную семантику поведения описывает [доход](../domains/income/overview.md).
+
 ## Validation и identity

 Backend преобразует и проверяет входные данные на общей HTTP-границе.
@@ -65,16 +93,11 @@ message/stack. Типичный ответ:

 Для input validation контракт требует `400`, `VALIDATION_ERROR` и `errors` как
 массив `{ pointer, detail }`, где pointer адресует поле запроса. Это требование
-не считается проверенным одним описанием OpenAPI: нужна проверка реального
-HTTP-ответа после всех стадий обработки запроса.
-
-**Известное расхождение:** согласованная
-[спецификация аутентификации](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/user-authentication/spec.md#requirement-стандартные-ответы-об-ошибках)
-требует `pointer` и `detail` для невалидных полей. В текущей конфигурации
-валидация формирует строковые сообщения, а фильтр ожидает структурированные
-ошибки полей; поэтому корректность деталей `errors` не подтверждена.
-Исправление требует отдельного изменения реализации и проверки полного
-HTTP-потока. OpenAPI сам по себе этого расхождения не устраняет.
+проверяется реальным HTTP-ответом после всех стадий обработки запроса. Глобальная
+валидация передаёт фильтру структурированные ошибки без исходных значений и DTO,
+а фильтр формирует JSON Pointer, включая вложенные поля. HTTP suites подтверждают
+детали ошибок регистрации, банковской карты и синхронизации; OpenAPI отдельно
+фиксирует форму ответа.

 Ответ не включает автоматически все поля RFC (`type`, `title`, `instance`).
 Добавление обязательного поля является изменением публичного контракта.
@@ -1,4 +1,12 @@
 module.exports = {
  extends: ["@commitlint/config-conventional"],
-  rules: { "type-enum": [2, "always", ["feat", "fix", "perf", "docs", "spec", "refactor", "build", "ci", "test", "style", "chore", "revert"]] },
+  defaultIgnores: false,
+  ignores: [
+    message => /^chore\(release\): \d+\.\d+\.\d+$/.test(message.trim()),
+    message => /^Merge pull request ['"].+['"] \(#\d+\) from .+ into .+$/.test(message.trim()),
+  ],
+  rules: {
+    "type-enum": [2, "always", ["feat", "fix", "perf", "docs", "spec", "refactor", "build", "ci", "test", "style", "chore", "revert"]],
+    "references-empty": [2, "never"],
+  },
 };
@@ -62,8 +62,8 @@

 - `409 TBANK_NOT_CONNECTED`: список не запрашивается у T-Bank, экран ведёт в настройки.
 - `400 INVALID_TBANK_TOKEN`: сохранённый токен не удаляется, экран ведёт в настройки для замены или удаления.
- `503 TBANK_UNAVAILABLE`: экран предлагает повторить загрузку или открыть настройки.
- Неизвестная ошибка: экран предлагает только повторить загрузку.
+- `503 TBANK_UNAVAILABLE`: экран показывает спокойное состояние недоступности; чтение возобновляется автоматически.
+- Неизвестная ошибка: то же состояние недоступности без действия повтора.
 - Успешный пустой ответ: штатное состояние отсутствия инвестиционных счетов.

 Карточка ведёт на `/accounts/:accountId` по всей области и доступна с клавиатуры. Карточки расположены в одну колонку при любой ширине. Карточка показывает название, локализованный тип, крупный валютный итог и вторую валюту при наличии, число остальных валют, дату открытия без времени и видимое действие открытия. Отдельные цветные блоки «Акции» и «Облигации» показывают количество наименований бумаг. Недоступная или пустая сводка отображается локально; отсутствие сумм не скрывает известные количества бумаг, а недоступная сводка не подменяет их нулями. Наведение и видимый клавиатурный фокус подчёркивают переход; настройка уменьшения движения отключает анимацию.
@@ -71,9 +71,10 @@
 ## Свежесть и границы

 Обычное открытие использует query owner и локальный server snapshot.
-«Обновить» запрашивает membership и сводки доступных счетов; активная работа
-наблюдается без нового импорта. Истечение TTL само не запускает запрос.
-Membership имеет пятиминутную свежесть, portfolio — минутную. Время списка
+«Обновить» перечитывает сохранённые membership и сводки доступных счетов;
+активная работа наблюдается без нового импорта. Истечение TTL само не
+запускает запрос: обновлением личных данных владеет часовой обход.
+Membership и portfolio source имеют часовую свежесть. Время списка
 не подменяет время каждой сводки. Список не заменяет полный
 [портфель](../portfolio/overview.md), [журнал](../operations/overview.md)
 или историю закрытых счетов. Для общего результата доступен
@@ -11,14 +11,20 @@

 Пользователь регистрируется или входит по email и паролю. Регистрация сразу
 создаёт первую сессию. Внешние пробелы email удаляются, буквы приводятся
-к нижнему регистру. Backend требует пароль не короче 12 символов и не длиннее
-72 UTF-8 байтов.
+к нижнему регистру.

-**Известное расхождение:** сохранённое требование регистрации и проверка
-в форме frontend считают нижнюю границу в UTF-8 байтах, а backend — в символах.
-Не-ASCII пароль может пройти форму и получить отказ API. Это не принятое
-изменение password policy; требуется отдельное согласованное решение
-о проверке пароля и подтверждение полного HTTP-потока.
+Пароль при регистрации — от 8 до 72 печатных ASCII-символов: латинские
+буквы, цифры, спецсимволы и пробел. Кириллица, emoji, другие не-ASCII и
+управляющие символы отклоняются. Пароль не обрезается и не нормализуется, а
+обязательных классов символов нет. Верхняя граница вытекает из bcrypt, который
+учитывает только первые 72 байта: для ASCII символ равен байту, поэтому
+длинный пароль не обрезается молча. Frontend и backend проверяют одну и ту же
+политику.
+
+При входе проверяется только то, что пароль непустой и не длиннее 72 UTF-8
+байтов. Минимум и набор символов не применяются, чтобы пользователь,
+зарегистрированный по прежним правилам (в том числе с не-ASCII паролем), мог
+войти. Невалидный пароль получает `400` с кодом `VALIDATION_ERROR`.

 Access token действует 15 минут и хранится только в памяти браузера.
 Refresh token имеет серверный срок 7 дней, заменяется при восстановлении
@@ -55,15 +61,16 @@ sequenceDiagram
    B-->>F: Access token, профиль, новая refresh-cookie
    F->>B: Protected request с Bearer
  else Cookie нет или refresh отклонён
-    B-->>F: 401 и очистка cookie
+    B-->>F: 401 без изменения cookie
    Note over F: Готовое неавторизованное состояние
  end
 ```

-В одном экземпляре frontend одновременные refresh используют один
-незавершённый запрос. Между вкладками используется Web Locks, если браузер
-его поддерживает. Backend всё равно защищает ротацию атомарно: координация
-браузеров не заменяет серверную проверку.
+В одной вкладке одновременные refresh используют один незавершённый запрос;
+cookie-writing requests упорядочены локально. Межвкладочная синхронизация
+не поддерживается: после смены сессии в другой вкладке допустимы reload/re-login.
+Backend защищает ротацию атомарно. Неуспешный refresh не удаляет cookie
+победившего запроса; недействительный token по-прежнему не восстанавливает сессию.

 Обычный защищённый запрос с `401 UNAUTHORIZED` проходит refresh и один повтор
 через общий транспорт; auth endpoints из этого цикла исключены. Само
@@ -89,9 +89,8 @@ JavaScript Number. Отдельный ввод ограничен signed64: на
 следующие страницы. Баланс при выборе прошлого периода остаётся текущим.
 Сводка учитывает все подходящие записи, включая не показанные на странице.

-Сводка одной или всех карт показывает одну итоговую сумму расходов с учётом
-возвратов и компактные строки категорий по убыванию итоговых расходов. Отдельные показатели «Возвращено»
-и «После возвратов» в интерфейсе скрыты; расчёт и операции возврата сохранены. Возврат уменьшает расходы месяца своего
+Сводка одной или всех карт отдельно показывает расходы, возвращённую сумму и
+итог после возвратов, а также компактные строки категорий по убыванию итоговых расходов. Возврат уменьшает расходы месяца своего
 получения: августовская покупка 1 000 ₽ и сентябрьский возврат 600 ₽ дают
 августовский итог 1 000 ₽ и сентябрьский −600 ₽ при отсутствии других трат.
 Начальный остаток, пополнения и переводы в эти показатели не входят.
@@ -4,7 +4,7 @@
 купонами и дивидендами за выбранный период». Пользователь открывает
 `/accounts/:accountId/income` из обзора счёта или
 [общий доход](../portfolio/all-accounts.md) по доступным счетам.
-Экран показывает итоги по валютам, сравнение и отдельную карточку каждой
+Экран показывает итоги по валютам и отдельную карточку каждой
 включённой выплаты. Источником служат [исполненные операции](../operations/overview.md),
 а не изменение цены портфеля и не календарь будущих выплат.

@@ -38,11 +38,12 @@

 При первой загрузке или новом периоде без сохранённых данных показан
 каркас страницы. Пустой результат объясняет отсутствие исполненных купонов и
-дивидендов, сохраняя фильтры, налоговое пояснение и сравнения. Ошибка запроса
-или нарушение принадлежности выплат даёт локальное состояние с действием «Повторить».
+дивидендов, сохраняя фильтры и налоговое пояснение. Ошибка запроса
+или нарушение принадлежности выплат даёт локальное состояние недоступности
+без действия повтора; чтение восстанавливается автоматически.
 При фоновом обновлении того же периода сохранённый ответ и черновик
-остаются видимыми: загрузку обозначает индикатор, неуспешное обновление —
-предупреждение с повторной попыткой.
+остаются видимыми без индикации обновления и технического предупреждения.
+Неполнота применённого периода обозначается состоянием самого результата.

 На узком экране поля и действия идут вертикально; все карточки выплат
 остаются в общем потоке страницы без раскрытия или внутренних областей прокрутки.
@@ -51,32 +52,15 @@

 - Backend проверяет доступ локально и читает сохранённые операции. Фоновая загрузка должна завершить все страницы; ошибка страницы или повреждённая цепочка курсоров не подтверждают полноту.
 - Только точные типы купона и дивиденда источника формируют результат. Суммы остаются точными десятичными строками в исходной валюте; отрицательные корректировки сохраняют знак. Налоги, комиссии, сделки, переводы, погашения и переводы дивидендов не входят в доход.
- Итоги, сравнения, временные интервалы и разбиение по инструментам не смешивают валюты и не создают общий конвертированный итог. Страница показывает сравнения с предыдущим периодом и годом ранее, когда календарная дата и история счёта позволяют. Неполное сравнение имеет отдельное сообщение, без нулевой базы.
+- Итоги, временные интервалы и разбиение по инструментам не смешивают валюты и не создают общий конвертированный итог. Система не загружает другие периоды ради сравнения полученного дохода с выбранным.
 - Временные интервалы по-прежнему приходят с backend: дни для 1–45 дней, недели для 46–180 и месяцы для более длинного периода, включая пустые интервалы. Страница дохода не строит из них график или текстовую динамику; ответ API не меняется.
- Раздел «Выплаты» показывает единый список карточек выплат в исходном порядке `entries`: одна карточка на каждую выплату. Внешних групп по инструментам или валютам, итогов и количества выплат инструмента нет. Описание, дата, доступные идентификаторы инструмента и сумма со знаком видны в каждой карточке; валюты по-прежнему разделены в итогах и сравнениях. Дополнительный запрос за составом не нужен.
-
-Сравнение с непосредственно предыдущим периодом использует предыдущий полный
-месяц для полного выбранного месяца, иначе — непосредственно предшествующий
-интервал той же включительной длительности. Оно не подменяет сравнение годом
-ранее. Незагруженное сравнение и ошибка его источника отличаются от
-недоступности годового сравнения по календарю или дате открытия счёта.
-
-Каждый раздел сравнения показывает цветные панели без общей белой подложки и
-внутренних отступов у внешнего блока. Точные периоды показаны в заголовках двух панелей с русским форматом диапазона
-и UTC для календарных дат.
-Отдельного заголовка с датами и валютного бейджа нет; валюта остаётся у каждой суммы.
-Панель «Разница» сохраняет серверную абсолютную разницу и дополняет итог, купоны
-и дивиденды процентом: абсолютная разница / сумма годом ранее × 100.
-Это округлённый показатель для отображения, а не пересчёт Money или инвестиционная
-доходность. Форматирование сохраняет знак и не более одного десятичного разряда.
-При нулевой или отрицательной базе либо непредставимом числовом отношении
-процентный бейдж не отображается; абсолютная разница остаётся видимой.
+- Раздел «Выплаты» показывает карточки выплат в исходном порядке `entries`. В отдельном счёте каждая выплата — отдельная карточка. В режиме «Все счета» выплаты одного инструмента, дня и точного типа образуют группу, если их две и более ([правила группировки](../operations/overview.md#группировка-в-режиме-все-счета)). Группа стоит на месте первой выплаты; каждая строка счёта показывает название счёта и свою сумму со знаком. Визуальный итог группы — точная сумма по валютам по показанным выплатам; он скрыт, если полнота периода не `complete`, или у выплаты нет суммы, или сумма равна нулю. Это клиентский расчёт и не заменяет серверные итоги аналитики дохода, которые по-прежнему приходят из ответа API и не пересчитываются. Описание, дата, доступные идентификаторы инструмента и сумма со знаком видны в каждой выплате. Дополнительный запрос за составом не нужен.

 ## Полнота и принадлежность выплат

 Доходы читают сохранённые операции и coverage в согласованной транзакции.
-Selected, previous и yearAgo имеют независимую готовность. Неполный selected
-не получает окончательных итогов; неполное сравнение не создаёт нулевую базу.
+Только выбранный период определяет готовность результата. Неполный период
+не получает окончательных итогов.
 Подтверждённый пустой период отличается от ещё не загруженного. При смене
 периода прежний snapshot не показывается под новым названием.

@@ -91,25 +75,24 @@ Selected, previous и yearAgo имеют независимую готовнос
 серверным правилом; клиент воспринимает ключ как непрозрачную строку.
 Это поле принадлежит ответу аналитики; общий журнал операций его не требует.

-Frontend проверяет принадлежность выплат по полученному ключу до подготовки
-плоского списка выплат. Отсутствующий, пустой или
-нестроковый ключ, неоднозначные ключи инструментов, неизвестная группа, другая
-валюта или несовпадение числа выплат приводят к существующему локальному
-состоянию ошибки аналитики с повторной попыткой. Частичный список выплат не показывается как
-полный; формула идентификации в клиенте не восстанавливается. Полностью пустой
-ответ допустим. Состав и исходный серверный порядок записей и знак сумм
-сохраняются, frontend не пересчитывает денежные итоги. Стабильный ID в пределах подключения и счёта определяет одну операцию:
+Backend обеспечивает принадлежность выплат, валюту и receipt count при
+построении entries и instrument groups из одного набора данных. Frontend
+доверяет типизированному contract, не восстанавливает формулу идентификации
+и не выполняет второй consistency validator. Полностью пустой ответ допустим.
+Состав и исходный серверный порядок записей и знак сумм
+сохраняются; серверные денежные итоги frontend не пересчитывает (визуальный итог группы в режиме «Все счета» отдельный, см. выше). Стабильный ID в пределах подключения и счёта определяет одну операцию:
 повторная сверка обновляет её без двойного учёта. Одинаковые ID разных счетов
 остаются разными выплатами. Изменение источника логотипа позволяет заново
 показать изображение после буквенной заглушки.

 ## Будущие события и ограничения

-На странице дохода нет блоков «Динамика» и «Ближайший прогноз». Она не запрашивает
+На странице дохода нет блоков «Динамика» и «Ближайший прогноз», блоков
+сравнения периодов и сообщений об их недоступности. Она не запрашивает
 `/events` и не зависит от его доступности. Самостоятельная страница
 [«Будущие события»](upcoming-events.md) по-прежнему доступна из обзора
 выбранного счёта и сохраняет прежнее поведение. Будущие выплаты
-не включаются в итоги полученного дохода или сравнения.
+не включаются в итоги полученного дохода.

 Аналитика читает сохранённую историю операций и не рассчитывает налоги, инвестиционную эффективность, доходность, валютную конвертацию или общий мультивалютный итог.

@@ -39,50 +39,76 @@

 ## Период и список

-Без фильтра период начинается сегодня в UTC и заканчивается через 30 дней
-после начала, обе даты включены. Поля «С» и «По» позволяют изменить период:
-«Применить» сохраняет выбранные календарные даты в URL и запрашивает результат,
-«Сбросить» возвращает период по умолчанию. Обзор счёта сохраняет прогноз
-на текущую дату и следующие 30 дней.
+Без фильтра страница применяет период по умолчанию из семи календарных
+дат включительно: сегодняшней и шести следующих календарных дней. API при
+отсутствии параметров использует своё окно (от текущей даты UTC до `from + 30`
+календарных дней), обе даты включены; `from` и `to` принимают только строгие
+даты `YYYY-MM-DD`. Календарь фильтра разрешает выбор сегодняшней и будущих дат
+и не позволяет выбрать даты раньше сегодняшней. Прямая ссылка с валидным
+прошедшим периодом сохраняет указанные даты без замены; некорректный формат,
+несуществующая календарная дата или обратный диапазон нормализуются к периоду
+по умолчанию с удалением параметров из URL. Поля «С» и «По» сохраняют
+выбранные календарные даты в URL, а «Сбросить» возвращает период по умолчанию.

-События упорядочены по календарной дате. У каждой строки видны тип,
+События упорядочены по календарной дате. Купоны и дивиденды показываются
+единым предметным представлением выплаты с явной пометкой прогноза — тем же,
+что у исполненных выплат в доходе и журнале; неизвестная сумма остаётся
+«сумма неизвестна» и не превращается в ноль или полученные деньги.
+Дата дивиденда обозначена как дата реестра. Offer и погашение сохраняют своё
+значение без суммы выплаты. У каждой строки видны тип,
 инструмент, дата и доступная сумма в исходной валюте. Список не имеет
 пагинации и не конвертирует валюты. Пустой результат означает отсутствие
 известных поддерживаемых событий в выбранном окне, а не доказательство
 отсутствия всех будущих выплат. Инструмент без поддерживаемых данных
 не получает искусственную строку «нет данных».

-API принимает необязательные `from` и `to` в формате `YYYY-MM-DD` для
-отдельного и общего счёта. Без `from` используется сегодня в UTC,
-без `to` — 30 дней после начала. Неверный формат или несуществующая дата
-дают `400`; обратный период — `400 INVALID_EVENTS_PERIOD`.
+Сохранённый forecast сохраняет свой `calculatedAt` и исходное включительное
+окно. GET для отдельного счёта или `all` возвращает только пересечение этого
+окна и запрошенного UTC-периода, не меняя ни `calculatedAt`, ни исходное окно.
+Пустое пересечение или отсутствие событий в пересечении — успешный пустой
+список с теми же metadata; это не отсутствие forecast. Неверный формат или
+несуществующая дата дают `400`; обратный период — `400 INVALID_EVENTS_PERIOD`
+без замены периода и без запуска личной работы.
 Фильтрация на сервере предшествует сортировке и вычислению
 `incomeTotalsByCurrency`, включающего только купоны и дивиденды.
-Итоги остаются в ответе API; полный экран показывает список без общего итога.
+Итоги остаются в ответе API; полный экран показывает список без общего итога списка.
+
+В режиме «Все счета» события одного инструмента, даты, точного типа и `dateKind` образуют
+группу, если их две и более, в том числе одного счёта. Ключ дополнительно включает `dateKind`,
+поэтому дата реестра дивиденда и иная дата того же инструмента не объединяются. Группа стоит на месте первого
+события. Полный список группирует все полученные события; превью обзора сначала берёт пять
+событий и группирует только их. Каждая строка счёта остаётся отдельной и показывает название
+счёта и свою прогнозную сумму. Визуальный итог группы — точная сумма по валютам; он показывается
+только если полнота прогноза `complete` и у каждого события группы известна прогнозная сумма.
+Иначе итог скрыт, а строки остаются. Этот итог не равен итогам ответа API и не относится к полученному доходу.

 ## Получение и отказы

 Запрос требует сессии, подключения и локально подтверждённого membership.
-Прогноз строится из личного сохранённого portfolio и общих календарей: T-Bank для
-дивидендов, MOEX для bond events. Отдельного синхронного получения portfolio
-нет. Личные оценки сохраняются отдельно от общих календарей.
+Он читает сохранённый forecast и не запускает личную синхронизацию. Часовой
+обход строит forecast из полного личного portfolio и общих календарей: T-Bank
+для дивидендов, MOEX для bond events. Личные оценки сохраняются отдельно от
+общих календарей.

-Последний полный forecast привязан к scope, периоду и membership.
-Если новый portfolio требует ещё недоступного календаря, прежний полный
-прогноз и его source times остаются, в том числе после рестарта. Новый
-полный результат заменяет его атомарно. Без fallback показывается
-missing/partial, а не подтверждённое отсутствие выплат. Другой период или
-изменившийся membership не получают старый прогноз под новым названием.
-Source failure сообщается в metadata и не изменяет успешное время.
+Последний полный forecast привязан к scope, исходному окну и membership. Если
+часовой обход не может получить полный новый forecast, прежний полный прогноз,
+его `calculatedAt` и исходное окно остаются читаемыми, в том числе после
+рестарта; `meta.lastAttempt` отдельно сообщает об ошибке обновления. Без
+полного forecast `data: null` и metadata обозначает initial loading либо
+временную недоступность, а не подтверждённое отсутствие выплат. В режиме `all`
+результат complete только при полном вкладе каждого включённого счёта. Другой
+scope или изменившийся membership не получают старый forecast под новым
+названием.
 Успешный ответ MOEX без запрошенного блока означает отсутствие поддерживаемых
 событий этого источника; это отличается от transport failure и повреждённого
 формата ответа.

-При первом открытии показан каркас заголовка и строк, без интерактивных
-заглушек. Пустой ответ сохраняет возможность изменить период.
-При обычном фоновом обновлении уже полученные данные остаются на экране,
-ошибка получает предупреждение и повторную попытку. Без выбранного счёта
-запрос не выполняется. Смена сессии и подключения следует
+При первом открытии без complete forecast показан каркас заголовка и строк,
+без интерактивных заглушек. Пустой успешный ответ сохраняет возможность
+изменить период. При failed HTTP reread уже полученный Client Cached Snapshot
+остаётся на экране; это отличается от server-side failed hourly attempt.
+Повторная попытка перечитывает только HTTP-ответ. Без выбранного счёта запрос
+не выполняется. Смена сессии и подключения следует
 [общим правилам финансовых данных](../../architecture/cross-cutting/data-freshness.md).

 Внешние границы объясняют интеграции [T-Bank](../../integrations/tbank.md)
@@ -89,7 +89,11 @@ HTML-источник, общий кэш и поведение при измен

 Календарь охватывает пять прошлых лет и следующий год. Будущие купоны
 сортируются по дате выплаты, прошедшие и недатированные доступны отдельно.
-Показаны сумма на облигацию, номер, тип, длительность периода и дата реестра,
+Будущие и прошедшие события купонного графика показываются единым предметным
+представлением выплаты с пометкой события по графику — тем же, что у
+исполненных выплат и прогноза; исполнение подтверждает только личная история.
+Показаны сумма на облигацию, отдельная личная оценка, номер, тип, длительность
+периода и дата реестра,
 если они известны. Неопределённый будущий купон не заменяется нулём.

 Личная оценка доступна только при положительных позициях, известной сумме,
@@ -117,8 +121,8 @@ HTML-источник, общий кэш и поведение при измен
 portfolio; они не попадают в общие источники.

 BondBy переиспользуется зависимостями выпуска. Discovery принадлежит query,
-свежесть — конкретному source/range. Missing/stale зависимости запрашиваются
-в фоне через прежний limiter; обычный HTTP-ответ не ждёт брокера.
+свежесть — конкретному source/range. Missing/stale зависимости ставятся
+в фоновую очередь через прежний limiter; обычный HTTP-ответ не ждёт брокера.
 Покрытые завершённые свечи не перечитываются после restart. Открытый хвост
 остаётся изменяемым; ручной refresh охватывает показанный период.

@@ -127,7 +131,8 @@ BondBy переиспользуется зависимостями выпуск
 выплат. Наблюдение статуса не запускает повторный импорт. Политика источников
 и границы — в [модели свежести](../../architecture/cross-cutting/data-freshness.md).

-Разделы загружаются независимо, показывают каркас загрузки и локальную повторную попытку.
+Разделы загружаются независимо, показывают каркас загрузки и локальное
+спокойное состояние недоступности без действия повтора.
 Ошибка фонового обновления сохраняет последние данные. Смена подключения
 сбрасывает поддерево клиентских запросов облигаций вместе с остальными финансовыми запросами;
 выход очищает кэш сессии. Общие график, позиция и личные события
@@ -143,3 +148,9 @@ BondBy переиспользуется зависимостями выпуск
 и [проверками](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/instruments/bonds/application/bond.spec.ts).
 Границы источников описаны в [разделе интеграций](../../integrations/README.md),
 сходное разделение рыночных и личных данных — в [акциях](stocks.md).
+
+## Online reference
+
+Страница облигации, поиск и переход по тикеру обращаются к онлайн-справочнику
+брокера; сохранённые quotes, свечи, события, ratings и метки портфеля
+сохраняют собственные границы свежести и ошибок.
@@ -28,24 +28,30 @@
 на frontend. Общее для акций и облигаций восстановление справочных данных
 принадлежит [загрузке портфеля на backend](../portfolio/flows/portfolio-loading.md).

-Раздел «Акции» в боковой и мобильной навигации ведёт на `/stocks`: поиск
-по названию или тикеру через каталог Т-Банка, начиная с двух символов.
-Результаты разных выпусков, включая обыкновенные и привилегированные акции,
-имеют отдельные UID. Карточка результата показывает логотип, последнюю цену
-с её временем, тип бумаги, площадку, код режима, ISIN и доступность торгов через
-API. Поиск показывает одну карточку на нормализованный ISIN. До ограничения
-в 30 результатов выбирается представитель выпуска: доступность через API,
-точное совпадение тикера, затем режим TQBR; равные варианты упорядочены по UID.
-Записи без ISIN сохраняются отдельно по UID. Обыкновенные и привилегированные
-акции с разными ISIN не объединяются. Цена и ссылка принадлежат выбранному
-UID; данные разных режимов не смешиваются. Прямые ссылки из портфеля сохраняют
+Раздел «Акции» в боковой и мобильной навигации ведёт на `/stocks`: скринер
+запускается кнопкой «Найти» с необязательным названием или тикером, сектором,
+типом акции, валютой расчётов, площадкой, страной риска и максимальным размером
+лота. Он использует полный полученный каталог и показывает только акции, для
+которых каталог подтверждает доступность покупки и торговли через API. Это не
+гарантирует, что конкретная заявка пользователя будет исполнена прямо сейчас.
+
+Скринер показывает одну карточку на выпуск с нормализованным ISIN, а выпуск
+без ISIN остаётся отдельной карточкой точного UID. Обыкновенные и
+привилегированные акции с разными ISIN не объединяются. После отбора карточки
+упорядочены по тикеру и UID, разделены на страницы по 30 и показывают единое
+время получения списка. Изменение условий не заменяет текущий список до
+следующего нажатия «Найти». Повторный поиск получает новый каталог; страницы
+одного результата не пересчитываются. Подтверждённый пустой результат отличается
+от ошибки источника: она сообщается рядом с полем поиска, а повторить запрос
+пользователь может обычным «Найти» — отдельного действия повтора чтения нет.
+
+Ссылка карточки принадлежит выбранному UID; данные разных режимов не смешиваются.
+Прямые ссылки из портфеля сохраняют
 исходный UID, даже если поиск выбрал другой режим этого выпуска; такая страница
 сохраняет UUID в адресе. Если один точный тикер относится к разным выпускам,
-сервер возвращает `409 STOCK_TICKER_AMBIGUOUS`, а страница предлагает поиск.
-Поиск тикера нечувствителен к регистру, но использует точное совпадение:
-SBER не заменяется на SBERP. Однобуквенные тикеры также поддерживаются.
+сервер возвращает `409 STOCK_TICKER_AMBIGUOUS`.
 Прямая ссылка не требует предварительного открытия портфеля. Хлебные крошки
-«Акции → название» возвращают к поиску.
+«Акции → название» возвращают к скринеру.

 ## Содержание и состояния

@@ -58,8 +64,9 @@ SBER не заменяется на SBERP. Однобуквенные тикер
 рыночные данные и личная история остаются доступны.

 Каждый раздел загружается независимо. Первичная загрузка показывает каркас
-раздела, ошибка — локальную повторную попытку. При ошибке фонового обновления
-сохраняются предыдущие данные и предупреждение. Цена содержит собственное время
+раздела, затянувшаяся недоступность — локальное спокойное состояние без
+повторной попытки. При ошибке фонового обновления сохраняются предыдущие
+данные без технического предупреждения. Цена содержит собственное время
 UTC, которое может быть старше времени получения ответа. Статус торгов не
 выводится из свежести цены. Отсутствующее значение не заменяется нулём.

@@ -119,7 +126,11 @@ UID включён в ключ кэша и подпись общего курс

 ## Дивиденды и финансовые показатели

-События компании отделены от личных зачислений. Известные будущие выплаты
+События компании отделены от личных зачислений. Будущие и прошедшие события
+дивидендного графика показываются единым предметным представлением выплаты
+с пометкой «событие по графику» — тем же, что у исполненных выплат и прогноза;
+сумма на акцию, отдельная личная оценка и дата реестра сохраняют свои подписи
+и не выдаются за личное зачисление. Известные будущие выплаты
 определяются по `paymentDate`, при её отсутствии — по `recordDate`; прошедшие
 и недатированные события помещены в отдельную историю компании. Отменённые
 события исключаются. Личная оценка умножает сумму на акцию на текущее положительное
@@ -144,19 +155,22 @@ TTM означает последние 12 месяцев, MRQ — послед
 ## Получение данных и ограничения

 Общие metadata, discovery, company, quotes, свечи и календари сохраняются
-в SQLite. Поиск хранит подтверждённый набор UID для конкретного query;
-успешный SBER не подтверждает пустой GAZP. Отсутствующее enrichment не
-скрывает найденную бумагу. Сохранённые общие источники переиспользуются
-между пользователями, но личные позиции и выплаты всегда проверяют доступ.
+в SQLite. Скринер получает каталог online и показывает время его получения;
+временная недоступность каталога не подтверждает отсутствие подходящих акций.
+Отсутствующее enrichment не скрывает найденную бумагу. Сохранённые общие
+источники переиспользуются между пользователями, но личные позиции и выплаты
+всегда проверяют доступ.

-Обычное чтение не ждёт RPC; missing/stale зависимости запрашиваются в фоне
-через существующий T-Bank limiter. Минутная свежесть применяется к quotes
-и открытому хвосту свечей, суточная — к metadata/company/календарям.
+Обычное чтение не ждёт RPC; missing/stale зависимости ставятся в фоновую
+очередь через существующий T-Bank limiter. Часовая свежесть применяется
+к quotes и открытому хвосту свечей; metadata/company/календари, будучи
+сохранёнными, не перечитываются обычным чтением.
 Закрытые полные свечные интервалы, включая пустые, сохраняются после restart.
 Новый день не делает прежнюю незавершённую свечу полной.

-«Обновить» передаёт текущий инструмент, выбранный график и personal-history
-scope. Частичные строки видны с предупреждением; неполные личные оценки
+Отдельного действия «Обновить» на странице нет: чтение текущего инструмента,
+выбранного графика и personal-history scope выполняется автоматически.
+Частичные строки видны с обозначением неполноты; неполные личные оценки
 не становятся нулями. Статус и `sync=observe` не создают новый импорт.
 Смена подключения и известный access loss очищают личное представление;
 поздние ответы не возвращают прежние данные. Детали —
@@ -184,3 +198,9 @@ scope. Частичные строки видны с предупреждени
 [рыночным данным](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/instruments/stocks/application/stock-market.service.ts),
 [выплатам](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/instruments/stocks/application/stock-income.service.ts) и [проверкам](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/instruments/stocks/application/stock.spec.ts).
 Сопоставление с облигациями — на [странице облигаций](bonds.md).
+
+## Online reference
+
+Страница акции, поиск и переход по тикеру обращаются к онлайн-справочнику
+брокера; сохранённые позиции, quotes, свечи и события остаются независимыми
+локальными ресурсами и не подменяются ошибкой справочника.
@@ -13,9 +13,27 @@
 Исполненная операция содержит тип события, его категорию, описание,
 момент совершения, доступные сведения об инструменте и денежное движение.
 Запросы отменённых или ожидающих исполнения поручений не образуют этот журнал.
-Суммы остаются точными десятичными строками в исходной валюте; frontend
-только форматирует их. Положительное и отрицательное движение сохраняют
-знак. Отсутствие `payment` означает «Без движения денег», а не нулевую сумму.
+Суммы остаются точными десятичными строками в исходной валюте. Frontend
+форматирует их и считает визуальный итог группы по показанным записям
+(см. [группировку](#группировка-в-режиме-все-счета)). Положительное и отрицательное
+движение сохраняют знак. Отсутствие `payment` означает «Без движения денег», а не нулевую сумму.
+
+## Группировка в режиме «Все счета»
+
+Только в режиме `all` записи журнала и превью обзора, которые относятся к одному
+дню экрана, одному инструменту и точному типу операции, объединяются в группу.
+Ключом служат день, `instrumentUid` (иначе `figi`) и тип; группа образуется при
+двух и более записях, в том числе одного счёта. Группа стоит на месте первой записи.
+Каждая запись остаётся отдельной строкой с названием счёта простым текстом и своей суммой.
+Одиночный счёт не группируется.
+
+Группировка выполняется после лимита: превью обзора сначала берёт пять записей,
+затем группирует только их. Полный журнал группирует страницу, уже загруженную
+курсором; группы не переносятся между страницами. Курсор и порядок записей не меняются.
+
+Итог группы — точная сумма по каждой валюте, без конвертации. Он показывается только
+если полнота журнала `complete`, у каждой записи группы есть `payment`, и ни одна сумма
+не равна нулю. Иначе итог скрыт, а строки счетов остаются.

 Категории объединяют разные события для фильтрации: сделка (`trade`),
 доход (`income`), налог (`tax`), комиссия (`fee`), перевод (`transfer`)
@@ -84,8 +102,10 @@ Coverage/status без изменения rowset cursor не ломают. Пе

 Полный журнал и превью используют одинаковую компактную строку: логотип
 или буквенная заглушка, описание, дата, инструмент и денежное движение.
-Для купона и дивиденда денежная метка называет точное событие; для прочих
-операций — категорию. Она показывается один раз, без повтора рядом с датой.
+Исполненные купоны и дивиденды показываются единым предметным представлением
+выплаты — тем же, что на странице дохода, в прогнозе и графиках инструментов;
+денежная метка называет точное исполненное событие. Для прочих
+операций метка называет категорию. Она показывается один раз, без повтора рядом с датой.
 Знак и цвет обозначают направление денег; отсутствие движения нейтрально.
 Если описание отсутствует, показывается локализованный тип операции.

@@ -53,13 +53,10 @@ Backend публикует статические маршруты под `/api/
 - Журнал объединяет операции по убыванию времени, при равном времени использует
  порядок идентификаторов счетов и операций. ID
  операций разных счетов не считаются дублями. Переводы не схлопываются.
- Доходы рассчитываются из согласованной локальной выборки операций за общие периоды.
-  Итоги, сравнения, временные интервалы и принадлежность выплат рассчитывает
-  сервис дохода.
-  Для сравнения с годом ранее используется текущий состав счетов; новый счёт
-  добавляет только реально полученные выплаты. При известных датах открытия всех счетов
-  доступность сравнения определяется самым ранним открытием в этом составе.
-  Закрытые счета в историческое сравнение не добавляются.
+- Доходы собираются из всех страниц операций каждого счёта за выбранный период.
+  Итоги, временные интервалы и принадлежность выплат рассчитывает
+  сервис дохода. Данные сравнения периодов не загружаются и не возвращаются;
+  состав счетов влияет только на фактические выплаты выбранного периода.
 - Будущие события сортируются по дате и сохраняют отдельную строку каждого счёта.
  Прогноз не включается в реализованные доходы.

@@ -84,6 +81,12 @@ Backend публикует статические маршруты под `/api/
 применённые фильтры. Coverage/status без изменения строк не ломают cursor.
 Продолжение не зависит от RAM-кэша или перезапуска.

+Визуальная группировка строк одного инструмента в общих списках выполняется только
+в пределах уже полученного списка: в журнале — на загруженной странице, без переноса группы
+на следующую; в полном списке будущих событий и выплатах дохода — по всем полученным строкам
+периода. Группировка не меняет порядок, cursor или ответ API. Протокол курсора прежний.
+Правила группировки — в [журнале](../operations/overview.md#группировка-в-режиме-все-счета).
+
 Повторная сверка полного показанного периода публикует все счета и интервалы
 одной транзакцией; успешное первое окно не смешивается с прежними остальными.
 Подробнее — [журнал](../operations/overview.md#получение-и-полнота).
@@ -0,0 +1,81 @@
+# Концентрация портфеля
+
+Вкладка «Концентрация» на странице счёта `/accounts/:accountId` показывает,
+какие акции, облигации, секторы и эмитенты занимают наибольшую часть текущей
+оценки Portfolio. Она отвечает на вопрос «где сконцентрированы деньги»,
+который не решают карточки позиций и [структура
+активов](overview.md#как-читать-экран). Точный смысл полей и долей — в
+[справочнике данных](data-reference.md).
+
+## Вкладка и разрезы
+
+Вкладка есть только у отдельного счёта: в режиме [«Все счета»](all-accounts.md)
+её нет. Появление вкладки не меняет вкладку, открытую по умолчанию («Позиции»),
+и содержание остальных вкладок. Пока Portfolio загружается, при его ошибке или
+штатном пустом составе вкладки нет; при Portfolio хотя бы с одной позицией или
+денежным остатком вкладка показывается.
+
+Вкладка содержит четыре разреза и показывает один из них одновременно:
+
+| Разрез | Что ранжирует | Типы позиций |
+| --- | --- | --- |
+| «Акции» | Пять крупнейших позиций акций | `STOCK` |
+| «Облигации» | Пять крупнейших позиций облигаций | `BOND` |
+| «Секторы» | Пять крупнейших секторов по данным T-Bank | `STOCK`, `BOND`, `FUND` |
+| «Эмитенты» | Пять крупнейших эмитентов (брендов актива) | `STOCK`, `BOND` |
+
+Фонды участвуют только в разрезе «Секторы»: их эмитент — управляющая компания,
+а не компания внутри фонда. Позиции типов `CURRENCY`, `FUTURE`, `OPTION`,
+`STRUCTURED_NOTE`, `DIGITAL_FINANCIAL_ASSET` и `OTHER` во вкладку не входят.
+
+Позиции без сектора образуют явную группу «Сектор не указан», без бренда —
+«Эмитент не указан»; обе группы показываются с видимой долей. Государственные
+облигации определяются значением сектора T-Bank `government` с подписью
+«Государственный сектор»; других собственных классификаций WealthLedger
+не вводит. Название элемента в разрезе эмитентов — название бренда; если у
+одного бренда разные названия, показывается название позиции с наибольшей
+стоимостью.
+
+## Топ-5 и «Прочее»
+
+В каждом разрезе показаны пять крупнейших элементов по текущей денежной оценке,
+каждый с суммой и долей. Рядом показан суммарный показатель «Топ-5 · N %».
+Если в разрезе семь и более элементов, все остальные объединены в одну строку
+«Прочее» с числом элементов, суммой и долей. При шести и меньшем числе
+элементов каждый показан своей строкой. По нажатию на «Прочее» раскрывается
+полный перечень остальных элементов, каждый со своей суммой и долей; топ-5
+и диаграмма при этом не меняются.
+
+Доли считаются от суммы стоимостей позиций разреза в выбранной валюте и
+в сумме дают ровно 100 %; округление — до десятой доли процента, очень малые
+доли показываются как «< 0,1 %». Отрицательные и нулевые стоимости, а также
+позиции без оценки в разрез не входят. Конвертации валют нет: каждая позиция
+входит только в валюту своей оценки.
+
+## Валюта
+
+У вкладки свой список валют — валюты оценок позиций акций, облигаций и фондов,
+отсортированные по ISO-коду, — и свой выбор, независимый от «Структуры
+портфеля». По умолчанию выбрана первая валюта списка. При одной валюте
+переключатель не показывается. Общего итога по нескольким валютам нет.
+Выбранные разрез и валюта сохраняются, пока пользователь остаётся на странице
+счёта, включая переключение её вкладок, и сбрасываются при новом заходе и при
+смене счёта.
+
+## Диаграмма и неполные данные
+
+Рядом с перечнем показана кольцевая диаграмма, согласованная с перечнем;
+информация передаётся не только цветом, есть текстовый эквивалент. Если ответ
+отмечен как неполный (`completeness: "incomplete"` — часть позиций не имеет
+оценки), над разрезом появляется предупреждение «Данные неполные», а под
+списком — сноска «Не учтено позиций: N» с числом позиций, не вошедших в разрез.
+Пустой разрез (нет позиций с положительной оценкой в выбранной валюте)
+показывает текстовое состояние вместо диаграммы.
+
+## Откуда берутся сектор и эмитент
+
+Сектор и эмитент — часть данных Portfolio: их получает backend в часовом
+обходе и сохраняет в снимке вместе с остальными полями позиций
+([поток загрузки](flows/portfolio-loading.md#обновление-сектора-и-эмитента),
+[интеграция T-Bank](../../integrations/tbank.md)). Вкладка считается по уже
+загруженному снимку и не обращается к T-Bank.
@@ -32,7 +32,9 @@
 | Cash Balance | Суммы из `GetPositions.money`, объединённые по валюте | Заблокированные деньги не прибавляются; торгуемый инструмент `CURRENCY` остаётся позицией |
 | `totalsByCurrency` | Стоимости позиций + доступные деньги той же валюты | Не включает невычислимую стоимость; не обещает полную оценку портфеля |
 | `lastSuccessfulAt` | Время формирования успешного снимка, UTC | Не является временем каждой котировки; запасной снимок сохраняет исходное время |
-| `isStale` | Истёк минутный срок свежести сохранённого portfolio source | Не описывает состояние клиентского кэша или ошибку фонового запроса |
+| `isStale` | Истёк часовой срок свежести сохранённого portfolio source | Не описывает состояние клиентского кэша или ошибку фонового запроса |
+| `sector` | Сектор инструмента в том виде, как его определяет T-Bank, с обрезанными пробелами | Только для позиций `STOCK`, `BOND` и `FUND`; значение из одних пробел считается отсутствующим. Во всех остальных случаях — `null` |
+| `issuer` | Бренд актива инструмента по данным T-Bank: `{ id, name }` | Только для позиций `STOCK`, `BOND` и `FUND`, когда у актива известны uid и название бренда. Во всех остальных случаях — `null`. Не влияет на количество, стоимость и свежесть снимка; используется вкладкой [«Концентрация»](concentration.md) |

 Ненулевые денежные остатки одной валюты суммируются. Позиции одинаковых
 инструментов в ответе отдельного счёта не объединяются; визуальная группировка
@@ -58,6 +60,8 @@ ISIN, тикер и `logoName` могут быть `null`. `logoName` — имя
 или метаданных не меняет количество, суммы и свежесть снимка и не скрывает
 финансовые данные. Metadata обновляется независимо; отсутствие имени не задерживает выдачу
 финансового снимка и оставляет доступный идентификатор.
+`logoName` не равен эмитенту из вкладки «Концентрация»: он берётся из metadata
+инструмента, а эмитент — из [классификации инструмента](flows/portfolio-loading.md#обновление-сектора-и-эмитента).

 ## Структура и доли

@@ -1,46 +1,66 @@
 # Загрузка портфеля

-Экран `/accounts/:accountId` читает последний полный snapshot из SQLite
-после проверки сессии, подключения и локального membership. Если список
-счетов ещё неизвестен, сервер сообщает о загрузке доступа без выдачи личных
-данных неизвестного ID. Известный недоступный счёт возвращает `404`.
+Экран `/accounts/:accountId` читает последний полный snapshot из SQLite после
+проверки сессии, подключения и локального membership. Если список счетов ещё
+неизвестен, сервер сообщает о загрузке доступа без выдачи личных данных
+неизвестного ID. Известный недоступный счёт возвращает `404`.

 ## Основной обмен

-Обычный GET возвращает локальный envelope. Missing/stale зависимости
-запрашиваются в фоне; чтение не ждёт T-Bank. Для нового полного snapshot
-нужны оба финансовых ответа `GetPortfolio` и `GetPositions`. Суммы и позиции
-публикуются вместе; metadata дополняет представление независимо, с доступным
-UID/FIGI вместо имени до её загрузки.
+Обычный GET и retry возвращают read-only локальный `{ data, meta }` envelope:
+они не ждут и не вызывают T-Bank и не предлагают ручную синхронизацию. Часовой
+обход текущего подключения обновляет Portfolio независимо от экрана. Для нового
+полного snapshot ему нужны оба финансовых ответа `GetPortfolio` и
+`GetPositions`; суммы и позиции публикуются вместе. Metadata инструмента и
+классификация (сектор и эмитент) дополняют представление независимо,
+с доступным UID/FIGI вместо имени до их загрузки.

-Свежесть portfolio — 60 секунд. Истечение срока не удаляет snapshot и не
-создаёт таймер. «Обновить» на обзоре перечитывает зависимости текущего экрана:
-membership, portfolio, показанные операции, доход и будущие события.
-Секции могут быть готовы независимо. Подробнее —
-[свежесть](../../../architecture/cross-cutting/data-freshness.md).
+## Обновление сектора и эмитента
+
+Часовой обход также обновляет сектор и эмитента позиций типов `share`, `bond`
+и `etf`. Значения хранятся как последнее известное ([ADR
+022](../../../adr/022-stored-instrument-classification.md)): сектор — как его
+определяет T-Bank, эмитент — бренд актива (`uid` и `name`). Каждое поле
+обновляется при первом обходе, начавшемся не ранее чем через 24 часа после его
+последнего успешного получения; пока значение не получено, попытка повторяется
+в каждом обходе. Сектор и эмитент обновляются независимо.
+
+Неуспешное получение не мешает публикации snapshot и не меняет
+`lastSuccessfulAt` и `isStale`; сохранённое значение остаётся доступным.
+Исключение — отказ token: он обрабатывается так же, как отказ token при
+обходе Portfolio. Инструмент ищется по UID, затем по FIGI; ответ «не найдено»
+сохраняет прежнее значение и отсчёт 24 часов начинается заново. Позиции без
+полученных значений участвуют в разрезах вкладки
+[«Концентрация»](../concentration.md) как «Сектор не указан» и
+«Эмитент не указан».
+
+Открытый экран выполняет локальное перечитывание не чаще одного раза в
+30 минут; retry также повторяет только HTTP GET. `data: null` означает, что
+полного snapshot ещё нет, а не нулевой портфель. Пустой подтверждённый portfolio
+остаётся available complete result. Секции могут быть готовы независимо.
+Подробнее — [свежесть](../../../architecture/cross-cutting/data-freshness.md).

 ## Границы доступа

-Публикация проверяет connection revision и attempt в той же транзакции.
-Замена или удаление подключения не допускает позднюю запись прежней работы.
-Frontend очищает недоступный personal view и отклоняет запоздалые ответы.
-В режиме [«Все счета»](../all-accounts.md#полнота-свежесть-и-доступ) состав
-accounts и snapshots читается согласованно, но их source times могут различаться.
+Публикация проверяет connection revision и attempt в той же транзакции. Замена
+или удаление подключения не допускает позднюю запись прежней работы. Frontend
+очищает недоступный personal view и отклоняет запоздалые ответы. В режиме
+[«Все счета»](../all-accounts.md#полнота-свежесть-и-доступ) состав accounts и
+snapshots читается согласованно, но их source times могут различаться.

 ## Ошибки и результат для пользователя

 Нет подключения — `409 TBANK_NOT_CONNECTED`, известный отказ токена —
 `400 INVALID_TBANK_TOKEN`, недоступный счёт — `404`. Они не маскируются
-запасным snapshot. Transient source failure оставляет прежний полный портфель
-и его исходное время с безопасным предупреждением. При отсутствии snapshot
-показывается missing/failed, без нулевых итогов. `503` означает ошибку
-обслуживания HTTP-запроса, а не принятой фоновой работы.
+запасным snapshot. Временная ошибка часового обхода оставляет прежний полный
+portfolio и его исходное `lastSuccessfulAt`; `meta.lastAttempt` сообщает о
+failed или partial попытке отдельно. `Portfolio.isStale` сообщает возраст
+snapshot, а Client Cached Snapshot и ошибка браузерного HTTP-перечитывания
+имеют независимый смысл. При отсутствии полного snapshot `data: null` и
+metadata обозначает initial loading либо временную недоступность, без нулевых
+итогов. `503` означает ошибку обслуживания самого HTTP-запроса, а не
+завершившуюся фоновую работу.

-Observer запрашивает статус известной работы, затем `sync=observe` читает
-изменившийся ресурс без запуска синхронизации. При уходе и terminal outcome
-наблюдение прекращается. Повторное открытие может запросить недостающее;
-после рестарта сохранённый snapshot доступен сразу.
-
-Денежные правила находятся в [справочнике](../data-reference.md),
-проверка расхождения — в [диагностике](../how-to/investigate-discrepancy.md),
-RPC/лимиты — в [интеграции T-Bank](../../../integrations/tbank.md).
+Денежные правила находятся в [справочнике](../data-reference.md), проверка
+расхождения — в [диагностике](../how-to/investigate-discrepancy.md), RPC/лимиты
+— в [интеграции T-Bank](../../../integrations/tbank.md).
@@ -12,11 +12,12 @@
   величины. Убедитесь, что сравниваемые значения относятся к одному составу
   счетов и инструменту. Название или тикер сами по себе не доказывают
   совпадение выпуска; используйте доступные UID, FIGI и ISIN.
-2. **Сопоставьте время.** Проверьте `lastSuccessfulAt`, `isStale` и наличие
-   предупреждения о клиентском обновлении. Серверный снимок не обещает время
+2. **Сопоставьте время.** Проверьте `lastSuccessfulAt`, `isStale` и показанный
+   исход последней часовой попытки. Серверный снимок не обещает время
   каждой котировки, а общий портфель может соединять разные моменты.
-   Если запрос завершился ошибкой, доступное действие «Повторить» должно
-   обновить результат или оставить объяснимую ошибку. Перезагрузка backend
+   Действия «Повторить» на экране нет: временный сбой чтения восстанавливается
+   автоматически, поэтому расхождение проверяйте по показанному состоянию
+   источника, а не по результату ручного обновления. Перезагрузка backend
   сохраняет последний полный снимок в SQLite, но не создаёт историю стоимости.
 3. **Проверьте состав суммы.** Для одной валюты итог складывается из
   вычислимых стоимостей позиций и доступных денег. Не добавляйте деньги
@@ -64,6 +64,10 @@ Backend получает данные через серверную
 без логотипа и с подписью результата. Отсутствующие показатели скрываются,
 а не подменяются нулём или заглушкой.

+Рядом с вкладкой «Позиции» на странице отдельного счёта есть вкладка
+[«Концентрация»](concentration.md): она показывает, где сконцентрированы
+деньги — крупнейшие бумаги, секторы и эмитенты. В режиме «Все счета» её нет.
+
 Существует расхождение: [согласованная спецификация представления позиций](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md#requirement-представление-карточек-позиций-на-клиенте)
 требует доступности всех иных типов в отдельной секции, а текущие frontend
 и его проверка исключают `CURRENCY` только из списка карточек. Такие позиции
@@ -79,18 +83,23 @@ Backend получает данные через серверную
 не содержат данных и не получают фокус. При обычном фоновом обновлении
 сохраняются предыдущие суммы и время успешного получения в UTC.

-Серверный `isStale` обозначает истечение минутной свежести снимка.
-Клиентское предупреждение означает неудачную попытку обновить уже показанный
-ответ. Эти состояния независимы и могут появиться одновременно.
-Успешный повторный запрос обновляет суммы и время, снимает клиентскую ошибку;
-серверное предупреждение определяется новым `isStale`.
+Серверный `isStale` обозначает возраст снимка старше часа: обновлением
+владеет часовой обход, а не запрос экрана. Он показывается рядом с суммами
+вместе с временем последнего успешного результата и исходом последней часовой
+попытки. Неудачная попытка клиента обновить уже показанный ответ о себе не
+сообщает: эти состояния независимы, но пользователю видимо только состояние
+источника. Успешное автоматическое перечитывание обновляет суммы и время;
+обозначение устаревания определяется новым `isStale`.
 Правила времени и ошибок приведены в [потоке загрузки](flows/portfolio-loading.md).

-В текущем решении нет долговременной истории снимков, графиков стоимости
-портфеля, валютной конвертации, учёта виртуальных позиций или заблокированных
-средств. Последний полный снимок сохраняется после перезапуска; выполнение
-синхронизации рассчитано на один экземпляр backend. Действие «Обновить»
-перечитывает зависимости открытого экрана независимо от их свежести.
+Отдельного чтения истории стоимости нет, но каждый полный снимок
+сохраняет точку оценки по счёту и валюте для будущих поддерживаемых
+представлений; публичного графика в текущем решении нет. Нет также
+валютной конвертации, учёта виртуальных позиций или заблокированных
+средств. Последний полный снимок сохраняется после перезапуска;
+обновлением личных данных владеет часовой обход, рассчитанный на один
+экземпляр backend. Действие «Обновить» выполняет только локальное
+перечитывание открытого экрана и не запускает работу с T-Bank.

 Для проверки конкретной суммы используйте
 [руководство по расхождениям](how-to/investigate-discrepancy.md).
@@ -119,6 +119,46 @@ Instrument. Она остаётся в `positions` и не объединяет

 _Не использовать_: денежный остаток, cash balance.

+## Концентрация
+
+Вкладка страницы одного Brokerage Account, показывающая, какие акции,
+облигации, секторы и эмитенты занимают наибольшую часть текущей оценки
+Portfolio, без валютной конвертации. Отличается от [структуры
+портфеля](domains/portfolio/data-reference.md#структура-и-доли): в её разрезах
+деньги не входят в знаменатель долей.
+
+_Не использовать_: структура портфеля, диверсификация.
+
+## Разрез
+
+Одна из четырёх группировок вкладки «Концентрация»: «Акции», «Облигации»,
+«Секторы», «Эмитенты». Элемент разреза — единица ранжирования; сектор
+агрегирует позиции `STOCK`, `BOND` и `FUND`, эмитенты — `STOCK` и `BOND`.
+
+_Не использовать_: фильтр, категория структуры.
+
+## Сектор
+
+Значение сектора инструмента в том виде, как его определяет T-Bank, без
+перекодирования и собственной классификации WealthLedger. Заполняется для
+позиций `STOCK`, `BOND` и `FUND`; государственные облигации определяются
+значением `government` с подписью «Государственный сектор». Позиция без
+сектора попадает в явную группу «Сектор не указан».
+
+_Не использовать_: отрасль, собственная классификация приложения.
+
+## Эмитент
+
+В разрезе «Эмитенты» вкладки «Концентрация» — бренд актива по данным T-Bank,
+объединяющий акции и облигации одной компании; фонды в разрез не входят.
+Название эмитента — название бренда. **Оговорка:** в этом разрезе слово
+означает бренд актива T-Bank, а не юридического эмитента ценной бумаги;
+[рейтинг выпуска](integrations/nkr.md) не подставляется вместо рейтинга
+эмитента и наоборот. Позиция без бренда попадает в явную группу
+«Эмитент не указан».
+
+_Не использовать_: юридический эмитент, эмитент рейтинга.
+
 ## Instrument

 Ценная бумага или иной торгуемый актив T-Bank, на который ссылается Portfolio
@@ -128,6 +168,14 @@ Instrument обогащают отображение Position или Event, но

 _Не использовать_: бумага, тикер, актив позиции.

+## Скринер акций
+
+Подбор выпусков акций по заданным условиям из каталога T-Bank с указанием
+времени получения списка. Скринер отличается от текстового поиска конкретного
+инструмента, личного портфеля и подтверждения исполнимости сделки.
+
+_Не использовать_: гарантия покупки, личная проверка доступа к сделке.
+
 ## Instrument Logo

 Имя файла бренда T-Bank для отображения Instrument в интерфейсе;
@@ -152,6 +200,15 @@ _Не использовать_: валютная позиция, заблоки

 _Не использовать_: история портфеля, snapshot для графика.

+## Точка истории стоимости портфеля
+
+Полная оценка одного Brokerage Account в одной валюте на момент успешного
+обновления Portfolio; последовательность таких точек описывает изменение
+оценки во времени, включая неторговые дни. Не является Portfolio Snapshot
+или инвестиционной доходностью; отсутствие цены позиции не приравнивается к нулю.
+
+_Не использовать_: снимок состава портфеля, доходность.
+
 ## Client Cached Snapshot

 Технический термин: последний успешно полученный frontend-ответ React Query, который остаётся
@@ -14,12 +14,27 @@ WealthLedger обращается к Invest API на сервере по gRPC ov
 | Портфель и денежные остатки | Показать текущий состав инвестиций и итоги по исходным валютам |
 | Исполненные операции | Построить журнал и выделить полученные купоны и дивиденды |
 | Инструменты и рынок | Имена, идентификаторы, цены, свечи, параметры акций и облигаций |
+| Классификация инструментов | Сектор акций, облигаций и фондов и бренд актива для разрезов [концентрации](../domains/portfolio/concentration.md) |
 | Купоны и дивиденды | Построить будущие события по текущим позициям и календарь инструмента |

+Сектор получается из описаний инструмента (отдельные описания для акций,
+облигаций и фондов, поиск по UID, затем по FIGI); эмитент — из описания актива
+по `asset_uid` инструмента: его uid и название бренда. Эмитент не выводится из
+названия, тикера или ISIN. Классификация хранится как последнее известное
+значение с обновлением не чаще раза в сутки ([ADR
+022](../adr/022-stored-instrument-classification.md)); все вызовы проходят
+через общий лимитер запросов T-Bank.
+
 T-Bank определяет исходные данные и права token. Backend проверяет локальную
 сессию, выбирает подключение её пользователя и устанавливает доступ к счёту.
 Наличие идентификатора счёта в URL этого доступа не подтверждает.

+Скринер акций получает полный online-каталог акций T-Bank для каждого нового
+поиска. В него входят только инструменты, для которых каталог подтверждает и
+доступность покупки, и торговли через API. Эти признаки описывают полученный
+снимок каталога: они не подтверждают личные права пользователя, состояние торгов
+или исполнение будущей заявки. Скринер не использует личный портфель как каталог.
+
 [MOEX](moex.md) и [НКР](nkr.md) дополняют публичные сведения об облигациях; они не заменяют
 брокера как источник личных позиций и исполненных выплат. Границы источников
 показаны в [контексте](../architecture/context.md), смысл дополнений — в
@@ -35,7 +50,9 @@ Backend передаёт имя файла `logoName` из метаданных

 Логотипы используются в портфеле, операциях, будущих событиях, поиске и
 страницах инструментов. Отсутствующее имя или ошибка изображения оставляют
-буквенную заглушку и не меняют финансовые значения. Правило построения URL
+буквенную заглушку и не меняют финансовые значения. Логотип — это metadata
+инструмента; он не равен эмитенту из [концентрации](../domains/portfolio/concentration.md),
+который берётся из бренда актива. Правило построения URL
 принадлежит [форматированию frontend](https://git.personal.ksv741.ru/WealthLedger/frontend/src/commit/9f7e342333b80bfacfd5bc394a2dcd0613d33ff3/src/shared/lib/display.ts).

 ## Проверка и сохранение подключения
@@ -91,7 +108,12 @@ sequenceDiagram

 `INVALID_TBANK_TOKEN` означает отказ внешней аутентификации или прав доступа.
 `TBANK_UNAVAILABLE` сообщает о временной или иной upstream-ошибке, включая
-исчерпание очереди. Ответы и ошибки не содержат token. Удаление подключения
+исчерпание очереди. Диагностические причины жизненного цикла часовой попытки
+(`INTERRUPTED` — прерывание до нормального завершения, `DEADLINE` — истечение
+ограничения ожидания шага) не относятся к ошибкам T-Bank: они остаются
+внутренней диагностикой и не раскрываются в hourly-read. Истечение ограничения
+ожидания не отменяет уже начатые обращения к T-Bank; их поздние результаты
+остаются в строках шагов. Ответы и ошибки не содержат token. Удаление подключения
 идемпотентно: удаляются локальный секрет, личные datasets и work; поздняя
 публикация прежней revision запрещена. Общие неперсональные источники могут
 сохраняться. Оно не описывает отзыв token на стороне T-Bank.
@@ -130,15 +152,12 @@ Backend хранит token в шифротексте AES-256-GCM с новым n
 [validateEnv](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/config/env.validation.ts) (справочный источник).
 Общий FIFO-лимитер ограничивает поток RPC и не допускает более 50
 ожидающих. Для `UNAVAILABLE`, `DEADLINE_EXCEEDED` и `RESOURCE_EXHAUSTED`
-обычный RPC допускает один повтор через секунду. Deadline каждой попытки — 15 секунд,
+каждый RPC допускает один повтор через секунду. Deadline каждой попытки — 15 секунд,
 а ожидание места в лимитере не является временем этой сетевой попытки.
-Для поиска метаданных `GetInstrumentBy` разрешены две повторные попытки
-с паузами 2 и 4 секунды после неудачных попыток. Они применяются к тем же
-временным кодам и к переполнению локальной очереди; перед каждой попыткой
-проверяется её вместимость. Постоянные ошибки и отказ авторизации
+Метаданные используют ту же retry policy. Переполненная очередь завершается
+ошибкой сразу, без повторов admission. Постоянные ошибки и отказ авторизации
 не повторяются. Подтверждённый `NOT_FOUND` при поиске метаданных означает
-отсутствие инструмента, а не временный сбой. Остальные RPC при полной
-очереди завершаются сразу.
+отсутствие инструмента, а не временный сбой.
 Параметры попыток принадлежат
 [T-Bank client](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/integrations/tbank/tbank.client.ts) (справочный источник);
 решение об ограниченных повторах — [ADR 005](../adr/005-tbank-upstream-resilience.md).
@@ -20,11 +20,12 @@ WealthLedger — локальное приложение для частного
 | Найти свой инвестиционный счёт | [Список счетов](domains/accounts/overview.md), их типы и доступные сводки |
 | Вести банковские карты | [Ручной учёт](domains/cards/overview.md): независимые балансы, расходы, пополнения, переводы, возвраты и месячные сводки |
 | Понять текущий состав инвестиций | [Портфель](domains/portfolio/overview.md): позиции, денежные остатки и итоги по валютам |
+| Увидеть, где сконцентрированы деньги | [Концентрация](domains/portfolio/concentration.md): крупнейшие бумаги, секторы и эмитенты счёта |
 | Разобрать уже совершённые движения | [Журнал операций](domains/operations/overview.md): исполненные операции с фильтрами и последовательной загрузкой истории |
 | Посчитать полученные выплаты | [Пассивный доход](domains/income/overview.md): исполненные купоны и дивиденды за календарный период |
 | Посмотреть ожидаемые события | [Будущие выплаты](domains/income/upcoming-events.md): купоны, дивиденды, погашения и оферты по текущим позициям |
 | Увидеть общий состав инвестиций | Режим [«Все счета»](domains/portfolio/all-accounts.md), сохраняющий принадлежность строк к счетам |
-| Изучить конкретный инструмент | Поиск и страницы [акций](domains/instruments/stocks.md) и [облигаций](domains/instruments/bonds.md): рынок, личная позиция, история и события |
+| Изучить конкретный инструмент | [Скринер акций](domains/instruments/stocks.md) по параметрам каталога, страницы акций и поиск [облигаций](domains/instruments/bonds.md): рынок, личная позиция, история и события |

 ## Как связаны представления

@@ -1,29 +1,38 @@
 {
  "name": "wealth-ledger-docs",
-  "version": "0.1.2",
+  "version": "0.1.8",
  "private": true,
  "engines": {
-    "node": "24.21.0"
+    "node": "24.22.1"
  },
  "scripts": {
-    "lint": "markdownlint-cli2 \"**/*.md\" \"#node_modules\"",
+    "lint": "markdownlint --dot --rules .markdownlint-rule-relative-links.cjs --ignore node_modules --ignore CHANGELOG.md -- \"**/*.md\" && markdownlint --config .markdownlint-changelog.json --rules .markdownlint-rule-relative-links.cjs -- CHANGELOG.md",
    "verify": "npm run lint && git diff --check",
    "release:preview": "release-it --dry-run --ci",
    "release:prepare": "release-it --ci",
    "commitlint": "commitlint"
  },
  "devDependencies": {
-    "@commitlint/cli": "21.2.2",
-    "@commitlint/config-conventional": "21.2.2",
-    "@release-it/conventional-changelog": "12.0.0",
-    "conventional-changelog-conventionalcommits": "10.4.0",
-    "markdownlint-cli2": "0.23.2",
-    "markdownlint-rule-relative-links": "5.1.2",
-    "release-it": "21.0.2"
+    "@commitlint/cli": "21.2.4",
+    "@commitlint/config-conventional": "21.2.4",
+    "@release-it/conventional-changelog": "12.0.2",
+    "conventional-changelog-conventionalcommits": "10.4.1",
+    "markdownlint-cli": "0.49.1",
+    "markdownlint-rule-relative-links": "5.1.4",
+    "release-it": "21.1.1"
  },
  "overrides": {
-    "markdownlint-cli2@0.23.2": {
-      "smol-toml": "1.8.0"
-    }
+    "fast-uri": "3.1.9",
+    "katex": "0.19.1",
+    "markdownlint-cli@0.49.1": {
+      "js-yaml": "5.4.2",
+      "minimatch": "11.0.2",
+      "smol-toml": "1.9.1"
+    },
+    "release-it": {
+      "basic-ftp": "6.2.3",
+      "undici": "7.30.1"
+    },
+    "markdown-it": "15.0.3"
  }
 }
@@ -2,7 +2,8 @@
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": [
    "config:recommended",
-    ":semanticCommitTypeAll(chore)"
+    ":semanticCommitTypeAll(chore)",
+    "security:minimumReleaseAgeNpm"
  ],
  "timezone": "Europe/Moscow",
  "labels": [
@@ -10,6 +11,13 @@
  ],
  "dependencyDashboard": true,
  "rangeStrategy": "pin",
+  "prConcurrentLimit": 5,
+  "lockFileMaintenance": {
+    "enabled": true,
+    "schedule": [
+      "before 4am on the first day of the month"
+    ]
+  },
  "packageRules": [
    {
      "matchUpdateTypes": [
@@ -18,6 +26,27 @@
      ],
      "groupName": "non-major dependencies"
    },
+    {
+      "matchManagers": [
+        "github-actions"
+      ],
+      "matchUpdateTypes": [
+        "minor",
+        "patch"
+      ],
+      "groupName": "non-major github actions"
+    },
+    {
+      "matchManagers": [
+        "docker-compose",
+        "dockerfile"
+      ],
+      "matchUpdateTypes": [
+        "minor",
+        "patch"
+      ],
+      "groupName": "non-major container images"
+    },
    {
      "matchUpdateTypes": [
        "major"
Author	SHA1	Message	Date
ksv741	364f6bd8d0	chore(release): 0.1.8 Conventional commits / commits (pull_request) Successful in 10s Details Docs security / security (pull_request) Successful in 6s Details Docs verify / verify (pull_request) Successful in 9s Details Docs security / security (push) Successful in 6s Details Docs verify / verify (push) Successful in 10s Details	2026-11-06 07:47:24 +03:00
codex-bot	6d7d4c7b28	chore(deps): set Renovate release age, PR limit and update groups (WealthLedger/main#6) (#64 ) Docs security / security (push) Successful in 6s Details Docs verify / verify (push) Successful in 10s Details	2026-11-03 14:07:41 +03:00
ksv741	40ea47a7c2	chore(release): 0.1.7 Conventional commits / commits (pull_request) Successful in 10s Details Docs security / security (pull_request) Successful in 7s Details Docs verify / verify (pull_request) Successful in 12s Details Docs security / security (push) Successful in 8s Details Docs verify / verify (push) Successful in 11s Details	2026-11-01 19:33:26 +03:00
codex-bot	37430da4c9	docs: describe concentration tab and stored instrument classification (WealthLedger/main#48) (#60 ) Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 11s Details	2026-11-01 19:29:01 +03:00
codex-bot	abe5b16241	chore(deps): resolve markdownlint audit advisory (WealthLedger/main#49) (#61 ) Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 11s Details	2026-11-01 19:13:01 +03:00
codex-bot	dcb528fa9f	docs: describe all-account row grouping (WealthLedger/main#47) (#59 ) Docs security / security (push) Successful in 6s Details Docs verify / verify (push) Successful in 9s Details	2026-10-30 07:28:25 +03:00
ksv741	8c6c2f84ce	chore(release): 0.1.6 Conventional commits / commits (pull_request) Successful in 12s Details Docs security / security (pull_request) Successful in 8s Details Docs verify / verify (pull_request) Successful in 12s Details Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 13s Details	2026-10-24 19:15:05 +03:00
renovate-bot	f9098d8409	chore(deps): update non-major dependencies (WealthLedger/docs#56 ) Docs security / security (push) Successful in 8s Details Docs verify / verify (push) Successful in 12s Details Co-authored-by: renovate-bot <renovate-bot@ksv741.ru>	2026-10-24 19:04:54 +03:00
codex-bot	4216eb815f	chore: bump Node to 24.22.1 (WealthLedger/backend#122 ) Docs security / security (push) Successful in 8s Details Docs verify / verify (push) Successful in 13s Details	2026-10-23 16:20:01 +03:00
ksv741	24ad250c02	chore(release): 0.1.5 Conventional commits / commits (pull_request) Successful in 13s Details Docs security / security (pull_request) Successful in 7s Details Docs verify / verify (pull_request) Successful in 13s Details Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 13s Details	2026-10-18 16:24:45 +03:00
codex-bot	e8e3ef6285	docs: describe quiet reading and visible source state (#51 ) Docs security / security (push) Successful in 8s Details Docs verify / verify (push) Successful in 13s Details ADR 021 фиксирует решение о тихом чтении и видимом состоянии источника; ui-resilience и затронутые domains приведены к AS-IS.	2026-10-17 22:11:49 +03:00
codex-bot	11f819ed31	chore: adopt linear git model in docs instructions (#49 ) Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 14s Details	2026-10-17 14:14:16 +03:00
codex-bot	550143aea1	docs: document Nexus delivery with shared account (WealthLedger/docs#18) (#48 ) Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 14s Details	2026-10-17 13:01:25 +03:00
codex-bot	56885f450b	docs: describe ASCII 8-72 password policy and drop resolved discrepancy (WealthLedger/docs#46) (#47 ) Docs security / security (push) Successful in 8s Details Docs verify / verify (push) Successful in 12s Details	2026-10-16 10:47:42 +03:00
codex-bot	1c89d321b1	Merge pull request 'chore: synchronize release 0.1.4 into develop (WealthLedger/main#30)' (#45 ) from chore/30-sync-release into develop Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 11s Details	2026-10-16 07:48:19 +03:00
codex-bot	ad1978c75e	Merge pull request 'chore: bring develop into release sync branch (WealthLedger/main#30)' (#44 ) from develop into chore/30-sync-release Conventional commits / commits (pull_request) Successful in 11s Details Docs security / security (pull_request) Successful in 6s Details Docs verify / verify (pull_request) Successful in 11s Details	2026-10-16 07:41:04 +03:00
codex-bot	77c1f44726	Merge pull request 'docs: describe events default period and picker bounds (WealthLedger/frontend#63)' (#43 ) from docs/63-upcoming-events-default-period into develop Docs security / security (push) Successful in 11s Details Docs verify / verify (push) Successful in 15s Details Conventional commits / commits (pull_request) Successful in 10s Details Docs security / security (pull_request) Successful in 6s Details Docs verify / verify (pull_request) Successful in 11s Details	2026-10-14 21:35:00 +03:00
ksv741	8a2a62c611	docs: describe events default period and picker bounds (WealthLedger/frontend#63 ) Conventional commits / commits (pull_request) Successful in 13s Details Docs security / security (pull_request) Successful in 9s Details Docs verify / verify (pull_request) Successful in 14s Details	2026-10-14 21:23:33 +03:00
codex-bot	7b61eb8e6b	docs: align current pages with hourly freshness model (WealthLedger/docs#34) (#42 ) Docs security / security (push) Successful in 8s Details Docs verify / verify (push) Successful in 13s Details	2026-10-14 14:03:58 +03:00
codex-bot	cad0f31615	Merge pull request 'ci: rerun commits proof on PR title edit (WealthLedger/docs#35)' (#41 ) from docs/35-commits-workflow-edited into develop Docs security / security (push) Successful in 8s Details Docs verify / verify (push) Successful in 13s Details	2026-10-13 20:33:45 +03:00
ksv741	03110e99ea	ci: rerun commits proof on PR title edit (WealthLedger/docs#35 ) Conventional commits / commits (pull_request) Successful in 13s Details Docs security / security (pull_request) Successful in 9s Details Docs verify / verify (pull_request) Successful in 13s Details	2026-10-13 20:18:59 +03:00
codex-bot	03fb045a9e	docs: document income without comparisons and unified payouts (WealthLedger/main#33) (#40 ) Docs security / security (push) Successful in 8s Details Docs verify / verify (push) Successful in 14s Details docs: document income without comparisons and unified payouts (WealthLedger/main#33)	2026-10-13 18:16:59 +03:00
ksv741	add9e5f638	ci: validate release PR commits independently (WealthLedger/main#30 ) Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 11s Details Conventional commits / commits (pull_request) Successful in 11s Details Docs security / security (pull_request) Successful in 7s Details Docs verify / verify (pull_request) Successful in 12s Details	2026-10-12 23:39:30 +03:00
ksv741	a818889e54	chore(release): 0.1.4 Conventional commits / commits (pull_request) Failing after 11s Details Docs security / security (pull_request) Successful in 7s Details Docs verify / verify (pull_request) Successful in 12s Details	2026-10-12 23:19:12 +03:00
ksv741	803f0843f8	Merge pull request 'docs: document hourly attempt lifecycle semantics (WealthLedger/backend#56)' (#37 ) from docs/56-harden-hourly-sync-lifecycle into develop Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 15s Details Reviewed-on: #37	2026-10-12 22:29:06 +03:00
ksv741	1378ac9fe2	docs: document hourly attempt lifecycle semantics (WealthLedger/backend#56 ) Conventional commits / commits (pull_request) Successful in 12s Details Docs security / security (pull_request) Successful in 8s Details Docs verify / verify (pull_request) Successful in 12s Details	2026-10-12 20:28:59 +03:00
codex-bot	04dc662b2e	Merge pull request 'chore: align docs engineering workflow (WealthLedger/main#27)' (#36 ) from chore/27-engineering-workflow into develop Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 13s Details	2026-10-12 11:00:36 +03:00
ksv741	c24e4b990a	docs: pin docs workflow reference (WealthLedger/main#27 ) Conventional commits / commits (pull_request) Successful in 13s Details Docs security / security (pull_request) Successful in 7s Details Docs verify / verify (pull_request) Successful in 12s Details	2026-10-12 10:22:13 +03:00
ksv741	602eb43294	fix: align docs commitlint workflow (WealthLedger/main#27 ) Conventional commits / commits (pull_request) Canceled after 0s Details Docs security / security (pull_request) Canceled after 0s Details Docs verify / verify (pull_request) Canceled after 0s Details	2026-10-12 10:21:16 +03:00
ksv741	eaf7ede841	chore: align docs engineering workflow (WealthLedger/main#27 ) Conventional commits / commits (pull_request) Successful in 11s Details Docs security / security (pull_request) Successful in 7s Details Docs verify / verify (pull_request) Successful in 12s Details	2026-10-12 09:20:54 +03:00
codex-bot	fe99b05e93	docs: document stock screener Docs security / security (push) Successful in 6s Details Docs verify / verify (push) Successful in 11s Details	2026-10-11 11:45:09 +03:00
ksv741	e6fd4f64b8	ci: skip checks on PR metadata edits Conventional commits / commits (pull_request) Successful in 11s Details Docs security / security (pull_request) Successful in 6s Details Docs verify / verify (pull_request) Successful in 11s Details	2026-10-11 11:36:51 +03:00
ksv741	4caa5e92b7	ci: avoid duplicate PR checks Docs security / security (pull_request) Successful in 7s Details Docs verify / verify (pull_request) Successful in 11s Details Conventional commits / commits (pull_request) Successful in 11s Details	2026-10-11 11:24:57 +03:00
ksv741	2c34023af8	docs: document stock screener Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 11s Details Conventional commits / commits (pull_request) Successful in 11s Details Docs security / security (pull_request) Successful in 6s Details Docs verify / verify (pull_request) Successful in 12s Details	2026-10-11 11:18:40 +03:00
ksv741	f0cab445d7	docs: document hourly investment reads Docs security / security (push) Successful in 46s Details Docs verify / verify (push) Successful in 13s Details	2026-10-09 21:13:45 +03:00
ksv741	df6f0109ed	docs: clarify card summary totals	2026-10-09 21:13:45 +03:00
codex-bot	0f8bbee10a	Merge pull request 'docs: document hourly sync history' (#31 ) from release/0.1.3 into develop Docs security / security (push) Successful in 9s Details Docs verify / verify (push) Successful in 14s Details Merge hourly sync history documentation	2026-10-09 09:19:44 +03:00
ksv741	e0bceea936	docs: document hourly sync history Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 13s Details Conventional commits / commits (pull_request) Successful in 11s Details Docs security / security (pull_request) Successful in 7s Details Docs verify / verify (pull_request) Successful in 13s Details	2026-10-09 09:05:08 +03:00
ksv741	9a9b0409cc	chore(release): 0.1.3 Conventional commits / commits (pull_request) Successful in 11s Details Docs security / security (pull_request) Successful in 10s Details Docs verify / verify (pull_request) Successful in 12s Details Docs security / security (push) Successful in 9s Details Docs verify / verify (push) Successful in 12s Details	2026-10-07 18:13:58 +03:00
ksv741	256d49b045	fix(deps): refresh docs security baseline Conventional commits / commits (pull_request) Successful in 12s Details Docs security / security (pull_request) Successful in 7s Details Docs verify / verify (pull_request) Successful in 14s Details Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 16s Details	2026-10-07 15:36:47 +03:00
ksv741	9477e688d1	fix(deps): remove vulnerable docs tooling Docs security / security (push) Successful in 19s Details Docs verify / verify (push) Successful in 13s Details Replace CLI2's unpatched braces dependency with markdownlint-cli. Preserve link checks and CHANGELOG rules; pin patched release and parser dependencies.	2026-10-03 21:32:35 +03:00
ksv741	0ee54ca952	docs: record minimal runtime coordination Document accepted cross-tab reauthentication, on-demand candles, native query/logging ownership and the complete deployment path. Preserve historical ADR context and link amendments through ADR 018. Related backend change: WealthLedger/backend@d698ed9	2026-10-03 21:32:35 +03:00
codex-bot	6fa62fb8b5	docs: record code quality review and refactoring Docs security / security (push) Successful in 9s Details Docs verify / verify (push) Successful in 14s Details	2026-09-27 18:26:55 +03:00
				`@@ -0,0 +1 @@`
				`module.exports = require('markdownlint-rule-relative-links').default;`
@@ -1 +1 @@
 .21.0
 .22.1