Merge branch 'develop' into codex/reconcile-hourly-investment-sync

.gitea/ISSUE_TEMPLATE/bug.md

@@ -1,15 +0,0 @@
----
-name: Bug Report
-about: Неверное поведение
----
-# Bug Report
-
-## Проблема и шаги воспроизведения
-
-## Факт / ожидание
-
-## Acceptance Criteria
-
-- [ ]
-
-## Окружение / ссылки (если применимо)

.gitea/ISSUE_TEMPLATE/engineering.md

@@ -1,13 +0,0 @@
----
-name: Engineering Task
-about: CI, тесты, документация, процесс и прочее
----
-# Engineering Task
-
-## Контекст и результат
-
-## Scope / связанные Issues (если есть)
-
-## Acceptance Criteria
-
-- [ ]

.gitea/ISSUE_TEMPLATE/feature.md

@@ -1,15 +0,0 @@
----
-name: Feature Request
-about: Новое наблюдаемое поведение
----
-# Feature Request
-
-## Зачем и какой результат
-
-## Ожидаемое поведение
-
-## Acceptance Criteria
-
-- [ ]
-
-## Зависимости / связанные Issues (если есть)

.gitea/ISSUE_TEMPLATE/refactor.md

@@ -1,15 +0,0 @@
----
-name: Refactoring / Technical Debt
-about: Улучшение без нового поведения
----
-# Refactoring / Technical Debt
-
-## Проблема и результат
-
-## Сохраняемые инварианты / границы
-
-## Acceptance Criteria
-
-- [ ]
-
-## Зависимости / ссылки (если есть)

.gitea/PULL_REQUEST_TEMPLATE.md

@@ -1,19 +0,0 @@
-# Pull Request
-
-## Summary
-
-Краткий результат работы описывается здесь.
-
-## Linked Issue
-
-Refs `<owner/repo#number>` (заменить ссылкой на реальную Issue).
-
-## Changes
-
-Затронутые части и изменения.
-
-## Verification
-
-- Команда / результат / ограничения:
-
-## Breaking Changes (если есть)

.gitea/workflows/commits.yml

@@ -2,11 +2,7 @@ name: Conventional commits
 
 on:
   pull_request:
-    types: [opened, synchronize, reopened]
+    types: [opened, synchronize, reopened, edited]
-
-concurrency:
-  group: docs-commits-${{ gitea.event.pull_request.number }}
-  cancel-in-progress: true
 
 jobs:
   commits:
@@ -27,8 +23,4 @@ jobs:
           HEAD_SHA: ${{ github.event.pull_request.head.sha }}
         run: |
           printf '%s\n' "$PR_TITLE" | npm run commitlint -- --strict
-          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

.gitea/workflows/security.yml

@@ -2,16 +2,12 @@ name: Docs security
 
 on:
   push:
-    branches: [develop, main]
+    branches:
+      - '**'
   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

.gitea/workflows/verify.yml

@@ -2,13 +2,8 @@ name: Docs verify
 
 on:
   push:
-    branches: [develop, main]
+    branches: ['**']
   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:

AGENTS.md

@@ -3,9 +3,6 @@
 Перед изменением прочитай [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;
 внешние источники используй как справочные свидетельства, когда они доступны.
@@ -23,8 +20,7 @@
 
 ## Ветки и релизы
 
-Работа — в issue-linked ветке от `develop`, затем PR в `develop`; в `main` напрямую
+Работа — в отдельной ветке от `develop`, затем PR в `develop`; в `main` напрямую
 не пушить. Release/hotfix и синхронизация веток — по [README](README.md#релизы).
-Commits и заголовки PR — Conventional Commits со ссылкой на Issue (кроме release);
+Commits и заголовки PR — Conventional Commits; для спецификаций допустим `spec:`.
-для спецификаций допустим `spec:`.
 Перед подготовкой релиза прочитай местный README; версии вручную не повышать.

CHANGELOG.md

@@ -1,29 +1,5 @@
 # Changelog
 
-## [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

README.md

@@ -35,7 +35,7 @@ WealthLedger помогает частному инвестору понимат
 | [Операции](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,11 +72,9 @@ WealthLedger помогает частному инвестору понимат
 ## Релизы
 
 Репозиторий выпускается независимо. `develop` — интеграция, `main` — принятые
-релизы. Обычная работа: issue-linked ветка от актуального `develop`, PR в `develop`;
+релизы. Работа: `codex/<task>` от актуального `develop`, PR в `develop`.
-общие правила — в Engineering Workflow по ссылке из AGENTS.
 Обычные PR допускают squash; release и обратная синхронизация сохраняют историю.
-Commits и PR titles — Conventional Commits со ссылкой на Issue (кроме release),
+Commits и PR titles — Conventional Commits, включая `spec:`. Версии вручную не повышай.
-включая `spec:`. Версии вручную не повышай.
 
 1. Получи `main`, `develop` и теги: `git fetch origin --tags`. Убедись, что
    `develop` содержит последний релиз. Создай `release/<name>` от проверенного

architecture/cross-cutting/data-freshness.md

@@ -29,14 +29,6 @@ completeness, `lastSuccessfulAt`, `lastAttempt` и availability. Первые,
 результату. `lastAttempt` описывает относящуюся к ресурсу часовую попытку:
 `none`, `running`, `succeeded`, `partial` или `failed`.
 
-Итог попытки выводится из фактических результатов её шагов: попытка, не
-завершившая обязательный шаг, не обозначается полным успехом, а полученные
-успешные результаты сохраняются. Ожидание каждого шага ограничено; зависший
-шаг учитывается проблемным, а начатое обращение к T-Bank не отменяется.
-Попытка, потерявшая выполнение после сбоя сохранения или остановки процесса,
-закрывается частичным успехом либо неуспехом и не блокирует следующий обход
-дольше обычного часового срока.
-
 Поздняя неуспешная или частичная попытка сохраняет прежний полный результат и
 его исходное время. Если полного результата нет, `data` равно `null`: состояние
 availability объясняет первоначальную загрузку, временную недоступность либо

architecture/http-api.md

@@ -21,17 +21,6 @@ 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.
-
 ## Инвестиционные данные и синхронизация
 
 Затронутые GET инвестиционных ресурсов возвращают сгенерированный contract

commitlint.config.cjs

@@ -1,12 +1,4 @@
 module.exports = {
   extends: ["@commitlint/config-conventional"],
-  defaultIgnores: false,
+  rules: { "type-enum": [2, "always", ["feat", "fix", "perf", "docs", "spec", "refactor", "build", "ci", "test", "style", "chore", "revert"]] },
-  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"],
-  },
 };

domains/instruments/stocks.md

@@ -28,29 +28,24 @@
 на frontend. Общее для акций и облигаций восстановление справочных данных
 принадлежит [загрузке портфеля на backend](../portfolio/flows/portfolio-loading.md).
 
-Раздел «Акции» в боковой и мобильной навигации ведёт на `/stocks`: скринер
+Раздел «Акции» в боковой и мобильной навигации ведёт на `/stocks`: поиск
-запускается кнопкой «Найти» с необязательным названием или тикером, сектором,
+по названию или тикеру через каталог Т-Банка, начиная с двух символов.
-типом акции, валютой расчётов, площадкой, страной риска и максимальным размером
+Результаты разных выпусков, включая обыкновенные и привилегированные акции,
-лота. Он использует полный полученный каталог и показывает только акции, для
+имеют отдельные UID. Карточка результата показывает логотип, последнюю цену
-которых каталог подтверждает доступность покупки и торговли через API. Это не
+с её временем, тип бумаги, площадку, код режима, ISIN и доступность торгов через
-гарантирует, что конкретная заявка пользователя будет исполнена прямо сейчас.
+API. Поиск показывает одну карточку на нормализованный ISIN. До ограничения
-
+в 30 результатов выбирается представитель выпуска: доступность через API,
-Скринер показывает одну карточку на выпуск с нормализованным ISIN, а выпуск
+точное совпадение тикера, затем режим TQBR; равные варианты упорядочены по UID.
-без ISIN остаётся отдельной карточкой точного UID. Обыкновенные и
+Записи без ISIN сохраняются отдельно по UID. Обыкновенные и привилегированные
-привилегированные акции с разными ISIN не объединяются. После отбора карточки
+акции с разными ISIN не объединяются. Цена и ссылка принадлежат выбранному
-упорядочены по тикеру и UID, разделены на страницы по 30 и показывают единое
+UID; данные разных режимов не смешиваются. Прямые ссылки из портфеля сохраняют
-время получения списка. Изменение условий не заменяет текущий список до
-следующего нажатия «Найти». Повторный поиск получает новый каталог; страницы
-одного результата не пересчитываются. Подтверждённый пустой результат отличается
-от ошибки источника, для которой интерфейс предлагает повторить поиск.
-
-Ссылка карточки принадлежит выбранному UID; данные разных режимов не смешиваются.
-Прямые ссылки из портфеля сохраняют
 исходный UID, даже если поиск выбрал другой режим этого выпуска; такая страница
 сохраняет UUID в адресе. Если один точный тикер относится к разным выпускам,
-сервер возвращает `409 STOCK_TICKER_AMBIGUOUS`.
+сервер возвращает `409 STOCK_TICKER_AMBIGUOUS`, а страница предлагает поиск.
+Поиск тикера нечувствителен к регистру, но использует точное совпадение:
+SBER не заменяется на SBERP. Однобуквенные тикеры также поддерживаются.
 Прямая ссылка не требует предварительного открытия портфеля. Хлебные крошки
-«Акции → название» возвращают к скринеру.
+«Акции → название» возвращают к поиску.
 
 ## Содержание и состояния
 
@@ -149,11 +144,10 @@ TTM означает последние 12 месяцев, MRQ — послед
 ## Получение данных и ограничения
 
 Общие metadata, discovery, company, quotes, свечи и календари сохраняются
-в SQLite. Скринер получает каталог online и показывает время его получения;
+в SQLite. Поиск хранит подтверждённый набор UID для конкретного query;
-временная недоступность каталога не подтверждает отсутствие подходящих акций.
+успешный SBER не подтверждает пустой GAZP. Отсутствующее enrichment не
-Отсутствующее enrichment не скрывает найденную бумагу. Сохранённые общие
+скрывает найденную бумагу. Сохранённые общие источники переиспользуются
-источники переиспользуются между пользователями, но личные позиции и выплаты
+между пользователями, но личные позиции и выплаты всегда проверяют доступ.
-всегда проверяют доступ.
 
 Обычное чтение не ждёт RPC; missing/stale зависимости запрашиваются в фоне
 через существующий T-Bank limiter. Минутная свежесть применяется к quotes

glossary.md

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

integrations/tbank.md

@@ -20,12 +20,6 @@ T-Bank определяет исходные данные и права token. B
 сессию, выбирает подключение её пользователя и устанавливает доступ к счёту.
 Наличие идентификатора счёта в URL этого доступа не подтверждает.
 
-Скринер акций получает полный online-каталог акций T-Bank для каждого нового
-поиска. В него входят только инструменты, для которых каталог подтверждает и
-доступность покупки, и торговли через API. Эти признаки описывают полученный
-снимок каталога: они не подтверждают личные права пользователя, состояние торгов
-или исполнение будущей заявки. Скринер не использует личный портфель как каталог.
-
 [MOEX](moex.md) и [НКР](nkr.md) дополняют публичные сведения об облигациях; они не заменяют
 брокера как источник личных позиций и исполненных выплат. Границы источников
 показаны в [контексте](../architecture/context.md), смысл дополнений — в
@@ -97,12 +91,7 @@ sequenceDiagram
 
 `INVALID_TBANK_TOKEN` означает отказ внешней аутентификации или прав доступа.
 `TBANK_UNAVAILABLE` сообщает о временной или иной upstream-ошибке, включая
-исчерпание очереди. Диагностические причины жизненного цикла часовой попытки
+исчерпание очереди. Ответы и ошибки не содержат token. Удаление подключения
-(`INTERRUPTED` — прерывание до нормального завершения, `DEADLINE` — истечение
-ограничения ожидания шага) не относятся к ошибкам T-Bank: они остаются
-внутренней диагностикой и не раскрываются в hourly-read. Истечение ограничения
-ожидания не отменяет уже начатые обращения к T-Bank; их поздние результаты
-остаются в строках шагов. Ответы и ошибки не содержат token. Удаление подключения
 идемпотентно: удаляются локальный секрет, личные datasets и work; поздняя
 публикация прежней revision запрещена. Общие неперсональные источники могут
 сохраняться. Оно не описывает отзыв token на стороне T-Bank.

overview.md

@@ -24,7 +24,7 @@ WealthLedger — локальное приложение для частного
 | Посчитать полученные выплаты | [Пассивный доход](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): рынок, личная позиция, история и события |
 
 ## Как связаны представления
 

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "wealth-ledger-docs",
-  "version": "0.1.4",
+  "version": "0.1.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "wealth-ledger-docs",
-      "version": "0.1.4",
+      "version": "0.1.3",
       "devDependencies": {
         "@commitlint/cli": "21.2.2",
         "@commitlint/config-conventional": "21.2.2",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "wealth-ledger-docs",
-  "version": "0.1.4",
+  "version": "0.1.3",
   "private": true,
   "engines": {
     "node": "24.21.0"