chore(release): 0.1.1

docs: document container deployment and recovery
docs: make documentation checks self-contained
2026-09-16 11:35:55 +03:00 · 2026-09-16 09:41:58 +03:00 · 2026-09-15 20:45:40 +03:00 · 2026-09-14 07:12:03 +03:00 · 2026-09-14 07:10:19 +03:00
39 changed files with 4298 additions and 115 deletions
@@ -0,0 +1,26 @@
+name: Conventional commits
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, edited]
+
+jobs:
+  commits:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: https://github.com/actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+          fetch-depth: 0
+      - uses: https://github.com/actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+      - run: npm ci --ignore-scripts
+      - name: Check PR title and commits
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          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"
@@ -2,40 +2,19 @@ name: Docs verify

 on:
  push:
-    branches:
-      - '**'
+    branches: ['**']
+  pull_request:

 jobs:
  verify:
    runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: workspace/docs
    steps:
-      - name: Checkout workspace root
-        uses: https://github.com/actions/checkout@v4
-        with:
-          repository: WealthLedger/main
-          ref: main
-          path: workspace
      - uses: https://github.com/actions/checkout@v4
-        with:
-          path: workspace/docs
-      - name: Checkout linked repositories
-        run: |
-          git clone --depth 1 --branch main https://git.personal.ksv741.ru/WealthLedger/frontend.git ../frontend
-          git clone --depth 1 --branch main https://git.personal.ksv741.ru/WealthLedger/backend.git ../backend
-          git clone --depth 1 --branch main https://git.personal.ksv741.ru/WealthLedger/specs.git ../specs
-      - name: Record checked revisions
-        run: |
-          git rev-parse HEAD
-          git -C .. rev-parse HEAD
-          git -C ../frontend rev-parse HEAD
-          git -C ../backend rev-parse HEAD
-          git -C ../specs rev-parse HEAD
+      - name: Record checked revision
+        run: git rev-parse HEAD
      - uses: https://github.com/actions/setup-node@v4
        with:
-          node-version-file: workspace/docs/.nvmrc
+          node-version-file: .nvmrc
      - run: npm ci
      - name: Check Markdown and relative links
        run: npm run verify
@@ -2,5 +2,20 @@
  "config": {
    "MD013": false
  },
-  "customRules": ["markdownlint-rule-relative-links"]
+  "customRules": [
+    "markdownlint-rule-relative-links"
+  ],
+  "overrides": [
+    {
+      "filter": [
+        "CHANGELOG.md"
+      ],
+      "config": {
+        "MD024": {
+          "siblings_only": true
+        }
+      },
+      "combine": "merge"
+    }
+  ]
 }
@@ -0,0 +1,106 @@
+{
+  "git": {
+    "requireBranch": "release/*",
+    "requireCleanWorkingDir": true,
+    "requireUpstream": false,
+    "requireCommits": true,
+    "commitMessage": "chore(release): ${version}",
+    "tagName": "v${version}",
+    "tag": false,
+    "push": false
+  },
+  "npm": {
+    "publish": false
+  },
+  "github": {
+    "release": false
+  },
+  "gitlab": {
+    "release": false
+  },
+  "hooks": {
+    "after:git:init": "node scripts/check-release.cjs"
+  },
+  "plugins": {
+    "@release-it/conventional-changelog": {
+      "infile": "CHANGELOG.md",
+      "preset": {
+        "name": "conventionalcommits",
+        "types": [
+          {
+            "type": "chore",
+            "scope": "release",
+            "effect": "hidden"
+          },
+          {
+            "type": "feat",
+            "section": "Features",
+            "effect": "bump"
+          },
+          {
+            "type": "fix",
+            "section": "Bug Fixes",
+            "effect": "bump"
+          },
+          {
+            "type": "perf",
+            "section": "Performance",
+            "effect": "bump"
+          },
+          {
+            "type": "docs",
+            "section": "Documentation",
+            "effect": "bump"
+          },
+          {
+            "type": "spec",
+            "section": "Specifications",
+            "effect": "bump"
+          },
+          {
+            "type": "refactor",
+            "section": "Refactoring",
+            "effect": "bump"
+          },
+          {
+            "type": "build",
+            "section": "Build",
+            "effect": "bump"
+          },
+          {
+            "type": "ci",
+            "section": "CI",
+            "effect": "bump"
+          },
+          {
+            "type": "test",
+            "section": "Tests",
+            "effect": "bump"
+          },
+          {
+            "type": "style",
+            "section": "Styles",
+            "effect": "bump"
+          },
+          {
+            "type": "chore",
+            "section": "Maintenance",
+            "effect": "bump"
+          },
+          {
+            "type": "revert",
+            "section": "Reverts",
+            "effect": "bump"
+          }
+        ]
+      },
+      "context": {
+        "host": "https://git.personal.ksv741.ru",
+        "owner": "WealthLedger",
+        "repository": "docs",
+        "linkReferences": true,
+        "commit": "commit"
+      }
+    }
+  }
+}
@@ -4,8 +4,10 @@
 затем только затронутую тему. Docs объясняет систему; требования принадлежат
 основным спецификациям, реализация и coding conventions — соседним репозиториям.

-Проверь существенные факты адресно по спецификациям, ADR и реализации с учётом
-веток и незакоммиченных изменений. Расхождение обозначь, не выбирая источник
+Проверь существенные факты по локальным тематическим страницам и ADR;
+внешние источники используй как справочные свидетельства, когда они доступны.
+Недостающие факты отмечай явно; инструкции и проверки не требуют других checkout.
+Расхождение обозначь, не выбирая источник
 победителем автоматически. Перенос сохраняет полезное содержание и входящие
 ссылки. Docs описывает текущее устройство системы; история поставок остаётся в Git.
 Отчёты аудитов и исследований в docs не размещаются. Подтверждённые решения
@@ -15,3 +17,10 @@
 [доступные проверки](CONTRIBUTING.md#проверки), включая новые файлы.
 Сохрани границы задачи и чужие изменения. Успех Markdown-проверки не заменяет
 смысловую сверку и не доказывает рендер диаграмм.
+
+## Ветки и релизы
+
+Работа — в отдельной ветке от `develop`, затем PR в `develop`; в `main` напрямую
+не пушить. Release/hotfix и синхронизация веток — по [README](README.md#релизы).
+Commits и заголовки PR — Conventional Commits; для спецификаций допустим `spec:`.
+Перед подготовкой релиза прочитай местный README; версии вручную не повышать.
@@ -0,0 +1,130 @@
+# Changelog
+
+## [0.1.1](https://git.personal.ksv741.ru/WealthLedger/docs/compare/v0.1.0...v0.1.1) (2026-09-16)
+
+### Documentation
+
+* document container deployment and recovery ([cead9dc](https://git.personal.ksv741.ru/WealthLedger/docs/commit/cead9dc1765700b7e10f9567e38f6d68d4ec9656))
+* make documentation checks self-contained ([97069d6](https://git.personal.ksv741.ru/WealthLedger/docs/commit/97069d6f6d0719d6fcee30b1ce8adbda41bd3a6d))
+
+## 0.1.0 (2026-09-14)
+
+### Features
+
+* add authorization ([6ca175b](https://git.personal.ksv741.ru/WealthLedger/docs/commit/6ca175b541a9f03e08448bef7593e560e928a15c))
+* add brocker account list ([ebf34e0](https://git.personal.ksv741.ru/WealthLedger/docs/commit/ebf34e01ca8c8dab533bb76aff3d5b03177383f8))
+* add logging ([016b624](https://git.personal.ksv741.ru/WealthLedger/docs/commit/016b624185d24a4e5ff07d4d164f2a3942b12358))
+* add operations list ([d825126](https://git.personal.ksv741.ru/WealthLedger/docs/commit/d8251269207b6f163889f04637862d9126cd89ca))
+* add portfolio ([4ffc374](https://git.personal.ksv741.ru/WealthLedger/docs/commit/4ffc374bd8ae4cca5a05ac806bf8d9a423d1153f))
+* add tbank tokens ([026b531](https://git.personal.ksv741.ru/WealthLedger/docs/commit/026b5318af0d1d2b8e4622fc82cc454c23222bd8))
+* add агегку events ([c513c47](https://git.personal.ksv741.ru/WealthLedger/docs/commit/c513c478404c6d00475ad093f70fce54aa30d1c2))
+
+### Documentation
+
+* activate frontend quality guardrails remediation ([fa5db07](https://git.personal.ksv741.ru/WealthLedger/docs/commit/fa5db0722915dd21fff49dbf49b8ddfc42eb4733))
+* activate token-efficient agent workflow ([42fd894](https://git.personal.ksv741.ru/WealthLedger/docs/commit/42fd8940dcd2fcfba5ed7f34d6265f289b049659))
+* add account income analytics ([cc3b5b0](https://git.personal.ksv741.ru/WealthLedger/docs/commit/cc3b5b0ae5b0e9507e2267c47fb55ea969f2765b))
+* add audit remediation registry ([793d201](https://git.personal.ksv741.ru/WealthLedger/docs/commit/793d2012a39e0b204d1dc768c386e60cb987b05a))
+* add baseline design ([e610c83](https://git.personal.ksv741.ru/WealthLedger/docs/commit/e610c83366045e5e8dab71ea5edbe7796bb78364))
+* add completion evidence for extend-instrument-logo-to-bonds ([c68c978](https://git.personal.ksv741.ru/WealthLedger/docs/commit/c68c978c91d3fc821b8a31a9e52c7406a7121bb6))
+* add old audit file ([5bf5c4e](https://git.personal.ksv741.ru/WealthLedger/docs/commit/5bf5c4e774f3dae8610a8ea9cba1204b1f3532ae))
+* **ai:** adopt task-driven scoped context ([b7a56b1](https://git.personal.ksv741.ru/WealthLedger/docs/commit/b7a56b1eb53bae0a00e18be4ed4209df70fc193b))
+* align investment domain terminology ([68d975b](https://git.personal.ksv741.ru/WealthLedger/docs/commit/68d975befda90c198a0287bb8d43ac5d6e386eb5))
+* **brokerage-account-ledger:** describe explicit filters ([820cf55](https://git.personal.ksv741.ru/WealthLedger/docs/commit/820cf5510318e0868eba46a6ff0b556053cb9806))
+* **brokerage-account-ledger:** describe operation type label and no category duplication ([2abb591](https://git.personal.ksv741.ru/WealthLedger/docs/commit/2abb5912b2db23d4984ca3b99578310596d66555))
+* **cards:** describe compact expense summaries ([d3a9e91](https://git.personal.ksv741.ru/WealthLedger/docs/commit/d3a9e91d475414f92b01f53848b58bd20263a56b))
+* **cards:** describe date range filtering ([a86d1eb](https://git.personal.ksv741.ru/WealthLedger/docs/commit/a86d1eb0a3d34992e650075c9f94cec1bda252e8))
+* clarify domain and agent authority ([0c53c50](https://git.personal.ksv741.ru/WealthLedger/docs/commit/0c53c50c624c9ab8d9c812c60a7cab56661fcbbd))
+* close SQLite migration and e2e blocker ([c74c573](https://git.personal.ksv741.ru/WealthLedger/docs/commit/c74c57373329e4accc46dbc13fdbe57ebf7ea3fd))
+* describe all-accounts behavior ([0e8c8c8](https://git.personal.ksv741.ru/WealthLedger/docs/commit/0e8c8c803f8ce8b49cdb7cbf2d5d1b0018736ee9))
+* describe bank operation icons and date format ([1f65b91](https://git.personal.ksv741.ru/WealthLedger/docs/commit/1f65b91a16a3ab90de17a493d011a8cf3fdc3c1c))
+* describe bond pages and rating sources ([35711a5](https://git.personal.ksv741.ru/WealthLedger/docs/commit/35711a52ec79d05887b39adb5a64b52578b4da21))
+* describe brokerage account summaries ([76d4de4](https://git.personal.ksv741.ru/WealthLedger/docs/commit/76d4de4428e5f902d82782ade745487d015994a1))
+* describe compact portfolio totals ([2985def](https://git.personal.ksv741.ru/WealthLedger/docs/commit/2985def574f1c22f9c41f6755b802342fafb30cd))
+* describe direct local token adaptation ([b0e747f](https://git.personal.ksv741.ru/WealthLedger/docs/commit/b0e747fdee2f726f18a4222f4bfc249c8f6d845b))
+* describe improved ledger event rows ([d39a9d3](https://git.personal.ksv741.ru/WealthLedger/docs/commit/d39a9d3df08d068b0c5fba97cfb7bb0d5755f329))
+* describe manual bank card accounting ([c0dfb80](https://git.personal.ksv741.ru/WealthLedger/docs/commit/c0dfb8061721bfd48d16e2a978348be4bec38c50))
+* describe polished stock cards ([0c59ce7](https://git.personal.ksv741.ru/WealthLedger/docs/commit/0c59ce788690ba6d17f33e0b57e122dd67e74904))
+* describe portable design token contract ([436251e](https://git.personal.ksv741.ru/WealthLedger/docs/commit/436251e83e07fe9726a1576dd081d5bd41655ff9))
+* describe shared design system and catalog blocks ([30683b8](https://git.personal.ksv741.ru/WealthLedger/docs/commit/30683b8b73cdad838feac6c1cac255aea3783ae4))
+* describe simplified income page ([7166ee5](https://git.personal.ksv741.ru/WealthLedger/docs/commit/7166ee51d181b04f3892ff6757a56b578ee9df64))
+* describe stock pages and portfolio navigation ([ead965a](https://git.personal.ksv741.ru/WealthLedger/docs/commit/ead965a67402789245c267a4c32b52176d3df7a2))
+* describe year-over-year income comparison ([2c98989](https://git.personal.ksv741.ru/WealthLedger/docs/commit/2c98989f5eeafd9baca8dab2659619473b78702d))
+* document auth and client refresh resilience ([b91280c](https://git.personal.ksv741.ru/WealthLedger/docs/commit/b91280cbaace4d0ed6d66186c62465abeeda6032))
+* document frontend audit remediation delivery ([55d35c7](https://git.personal.ksv741.ru/WealthLedger/docs/commit/55d35c7f789478230c683a79e5c80563c75487b6))
+* document instrument logos in portfolio ([30e5699](https://git.personal.ksv741.ru/WealthLedger/docs/commit/30e56997f9bbceee09ea87b218a6042ab17112f0))
+* document local verification workflow ([293df9c](https://git.personal.ksv741.ru/WealthLedger/docs/commit/293df9c59dfb8788e2c7e044c8855146b3c5d03e))
+* document OpenSpec authority lifecycle ([0bc8d1c](https://git.personal.ksv741.ru/WealthLedger/docs/commit/0bc8d1c9aed984cc16b6efd1dab76e2a7a9ca307))
+* document skeleton loading states ([95fa815](https://git.personal.ksv741.ru/WealthLedger/docs/commit/95fa8153286d549f7a58229bd92ef327b75b7e58))
+* document T-Bank cache generation boundary ([3d2bc1e](https://git.personal.ksv741.ru/WealthLedger/docs/commit/3d2bc1eac4add7cc3316c97d4d02a78fe91620d5))
+* establish architecture records ([2a09ef7](https://git.personal.ksv741.ru/WealthLedger/docs/commit/2a09ef74bb25feca65efdace61c2686199f614a5))
+* **events:** describe date range filtering ([aa9afc1](https://git.personal.ksv741.ru/WealthLedger/docs/commit/aa9afc15e46888c4d6cabbe8e17ff87e383f5731))
+* explain server-side portfolio metadata recovery ([05bfe8d](https://git.personal.ksv741.ru/WealthLedger/docs/commit/05bfe8df1cb0fde9b97d2075d9f571198295fea1))
+* link remediation evidence commit ([9752234](https://git.personal.ksv741.ru/WealthLedger/docs/commit/9752234f23c8dd400667ba354b0ed1eec248db99))
+* make project documentation self-contained ([3a99af1](https://git.personal.ksv741.ru/WealthLedger/docs/commit/3a99af1a6e49836ae6ea2378dd2e4037092d08fc))
+* mark frontend audit remediation active ([ba15e52](https://git.personal.ksv741.ru/WealthLedger/docs/commit/ba15e529b44b39f819c3666ad4787f2f566d1da4))
+* **portfolio-view:** update as-built for bond parity ([2e9e403](https://git.personal.ksv741.ru/WealthLedger/docs/commit/2e9e403db207c5fc4a21827b118407a51c7a70cc))
+* **portfolio:** describe asset allocation ([174bab3](https://git.personal.ksv741.ru/WealthLedger/docs/commit/174bab3566be2d302b51a8a86e10b11271f9835f))
+* **portfolio:** document ticker display ([7f4d0b2](https://git.personal.ksv741.ru/WealthLedger/docs/commit/7f4d0b255eb4ef5a73139bfd499eb88118105a6d))
+* publish token workflow pilot result ([21ccad3](https://git.personal.ksv741.ru/WealthLedger/docs/commit/21ccad3639714bcc364af329ea884eda57259aab))
+* record account-ledger-explicit-filters evidence ([2bc56db](https://git.personal.ksv741.ru/WealthLedger/docs/commit/2bc56db68076b243dccaa36ef850e4b28823e2fc))
+* record add-instrument-logos completion evidence ([d2a98f3](https://git.personal.ksv741.ru/WealthLedger/docs/commit/d2a98f31577cdd0730efa6fad73e132572e017f2))
+* record AI governance audit ([1944f2f](https://git.personal.ksv741.ru/WealthLedger/docs/commit/1944f2fc970db2bdc292981e01b1aca549f9ac52))
+* record api contract resilience remediation ([b623805](https://git.personal.ksv741.ru/WealthLedger/docs/commit/b623805cbe9cd8c57cfc83a35b6c8af3018fea1e))
+* record auth and cache concurrency policy ([8568e7b](https://git.personal.ksv741.ru/WealthLedger/docs/commit/8568e7b317a3c96c1e4ca2cbabce41d57a11181e))
+* record auth cache remediation evidence ([6c37e58](https://git.personal.ksv741.ru/WealthLedger/docs/commit/6c37e58fbe670ef79ec774280171bc8b28d88737))
+* record backend refactor and close P1-12 ([b940d39](https://git.personal.ksv741.ru/WealthLedger/docs/commit/b940d39946baae78ab14a10b9f71ef15153e9604))
+* record backend strict typing completion ([f4cefd5](https://git.personal.ksv741.ru/WealthLedger/docs/commit/f4cefd5c401d009e1d3332e76f30913c97a480b7))
+* record dependency hygiene remediation evidence ([60a1c33](https://git.personal.ksv741.ru/WealthLedger/docs/commit/60a1c33003bd35f7ff71e8c4b8f30d6a6f511e12))
+* record documentation remediation evidence ([b91dfe6](https://git.personal.ksv741.ru/WealthLedger/docs/commit/b91dfe66e0d8c55c9000687895dfc2954f4d1c44))
+* record domain money contract evidence ([4dbff85](https://git.personal.ksv741.ru/WealthLedger/docs/commit/4dbff85654656473dfa0b68f69b7841ac27d8efe))
+* record frontend audit remediation evidence ([8721e93](https://git.personal.ksv741.ru/WealthLedger/docs/commit/8721e93849f72413ca065f9e738948f0ca10132e))
+* record frontend auth query gating evidence ([68f1d8f](https://git.personal.ksv741.ru/WealthLedger/docs/commit/68f1d8f398e6606fb2a0db694c452ba235a29434))
+* record frontend quality guardrails evidence ([eb69300](https://git.personal.ksv741.ru/WealthLedger/docs/commit/eb69300ebed41bc19e78909195387dce4e2c0ec7))
+* record frontend remediation completion ([4cc8565](https://git.personal.ksv741.ru/WealthLedger/docs/commit/4cc856552498821f0dbaaa192b0fcc9a45d7b097))
+* record frontend remediation evidence ([ef2bf97](https://git.personal.ksv741.ru/WealthLedger/docs/commit/ef2bf977bf6fd55580c878b0b3aec3e37a3d944e))
+* record frontend view model boundary evidence ([373c18a](https://git.personal.ksv741.ru/WealthLedger/docs/commit/373c18a2f170f6ae2df1bda0b294b37e4c31d18f))
+* record governance completion evidence ([1a214dd](https://git.personal.ksv741.ru/WealthLedger/docs/commit/1a214dd7649cc34ff86ec1483e68d099b69ff2e7))
+* record improved ledger row evidence ([35c5302](https://git.personal.ksv741.ru/WealthLedger/docs/commit/35c5302e78545170ded1f9aa9109e3faa0ebea2a))
+* record income analytics completion evidence ([09f5f9e](https://git.personal.ksv741.ru/WealthLedger/docs/commit/09f5f9e4f9ac8709e1fa66b24e485deecf5f0655))
+* record ledger entry type label evidence ([d749bf5](https://git.personal.ksv741.ru/WealthLedger/docs/commit/d749bf5b2829b3127d6b8f6129edd262db37348f))
+* record local verification remediation evidence ([82159e3](https://git.personal.ksv741.ru/WealthLedger/docs/commit/82159e3b073ff0b4b5a0ceb5033a623b9d39f2e2))
+* record Mantine breadcrumbs evidence ([5fd5e79](https://git.personal.ksv741.ru/WealthLedger/docs/commit/5fd5e79590986ecc9787fd26b548ec8bd5b08fc3))
+* record OpenSpec lifecycle remediation ([9bb76e3](https://git.personal.ksv741.ru/WealthLedger/docs/commit/9bb76e35f9496e9414b678d325f6995bf413f144))
+* record OpenSpec resilience evidence ([79727de](https://git.personal.ksv741.ru/WealthLedger/docs/commit/79727de9ffe61f36fbaca866e2993bde6243eace))
+* record P1-11 SQLite verification ([66721ee](https://git.personal.ksv741.ru/WealthLedger/docs/commit/66721eee6295f1c432aaeb8631cfd3b0234d11d6))
+* record React component style evidence ([6812fde](https://git.personal.ksv741.ru/WealthLedger/docs/commit/6812fdeae36faf93e682d1ec089bd2e839ea6fdc))
+* record SDD audit remediation ([72c3a8a](https://git.personal.ksv741.ru/WealthLedger/docs/commit/72c3a8a6683b95f7e734044fdabe568668097c33))
+* record SDD remediation evidence ([5233726](https://git.personal.ksv741.ru/WealthLedger/docs/commit/5233726855b9f3a8f1b8e0f64991e17f9e8be299))
+* record second OpenSpec schema review ([d80e2e3](https://git.personal.ksv741.ru/WealthLedger/docs/commit/d80e2e32b2ebadcd93a53105e1ac337fe2c1f4f6))
+* record session workflow evidence ([9f8280c](https://git.personal.ksv741.ru/WealthLedger/docs/commit/9f8280c567e6e3e659c899980e916805cdf46968))
+* record stock card polish evidence ([6006400](https://git.personal.ksv741.ru/WealthLedger/docs/commit/60064003ede0afb99c1fa299b813c0be5f889ad7))
+* record T-Bank cache boundary evidence ([598dfb2](https://git.personal.ksv741.ru/WealthLedger/docs/commit/598dfb2bdb2c0d5da41495f01edbea83f6e5c0d3))
+* record verification simplification evidence ([1f030af](https://git.personal.ksv741.ru/WealthLedger/docs/commit/1f030af2df32cb392e272ce90f6fb0138a9d13b4))
+* refresh project onboarding entrypoints ([88c0cd3](https://git.personal.ksv741.ru/WealthLedger/docs/commit/88c0cd3281f1b409779f0ec9365692291c651ffa))
+* remove misplaced baseline design ([34577dc](https://git.personal.ksv741.ru/WealthLedger/docs/commit/34577dc7956f90f73c50ba067ff8ecc7e751853c))
+* remove useless ([adc369b](https://git.personal.ksv741.ru/WealthLedger/docs/commit/adc369be79d1b4b4aad36168a8d32deab6568932))
+* reorganize system knowledge by domain ([f20c3f4](https://git.personal.ksv741.ru/WealthLedger/docs/commit/f20c3f47bcacc4e65444c602c261c80691cab66f))
+* simplify OpenSpec agent entrypoints ([eb0a96e](https://git.personal.ksv741.ru/WealthLedger/docs/commit/eb0a96e27c072e53f5c01db5a810502c104e8e6c))
+* simplify system documentation ([9b19a5c](https://git.personal.ksv741.ru/WealthLedger/docs/commit/9b19a5cf4df5116c5f603f7189751d37ae9f0ffd))
+* simplify verification workflow ([4af0a9c](https://git.personal.ksv741.ru/WealthLedger/docs/commit/4af0a9c05590d7d47135fc708719bf83d5dd3fb9))
+* trust supplied OpenAPI snapshot ([2ef3759](https://git.personal.ksv741.ru/WealthLedger/docs/commit/2ef375919b84d9367791e9b22d761e506a5da930))
+* update income analytics period constraints ([28a01a4](https://git.personal.ksv741.ru/WealthLedger/docs/commit/28a01a449acd907a93b6f45c86cd40543237395b))
+* update portfolio view feature ([c628535](https://git.personal.ksv741.ru/WealthLedger/docs/commit/c6285352b11907b3542ba8fc502608828a834fa3))
+
+### Refactoring
+
+* little structure refactor ([1383949](https://git.personal.ksv741.ru/WealthLedger/docs/commit/1383949dc4c295d1b4e89abc372b780442ad91b7))
+* refactor foundation ([5d5497a](https://git.personal.ksv741.ru/WealthLedger/docs/commit/5d5497a4e4fc52cd03326080ba082c6dec369ce5))
+* refactor future event list ([680fc03](https://git.personal.ksv741.ru/WealthLedger/docs/commit/680fc03bec7ff5fdbac7c81c6daf8e5dc119abb5))
+
+### CI
+
+* verify docs and secure dependency updates [#1](https://git.personal.ksv741.ru/WealthLedger/docs/issues/1) [#5](https://git.personal.ksv741.ru/WealthLedger/docs/issues/5) [#6](https://git.personal.ksv741.ru/WealthLedger/docs/issues/6) ([c0a8cdb](https://git.personal.ksv741.ru/WealthLedger/docs/commit/c0a8cdb683953e515757071c288bfdf9e7b4b40a))
+
+### Maintenance
+
+* configure releases and develop workflow ([261f1ca](https://git.personal.ksv741.ru/WealthLedger/docs/commit/261f1ca6d15a894de470b94f2f0ad6fce3ae7917))
+* **deps:** update node.js to v24.21.0 ([67f152d](https://git.personal.ksv741.ru/WealthLedger/docs/commit/67f152d3654b15c8d51b5bde95ac4e9e0e6fb253))
+* document and adopt Node 24 LTS ([7bc8792](https://git.personal.ksv741.ru/WealthLedger/docs/commit/7bc8792b9853768734066c31a323b70886d73a23))
+* save pending changes ([14dd879](https://git.personal.ksv741.ru/WealthLedger/docs/commit/14dd8790996b3461da8b1e3ec9a49d9526100047))
@@ -8,15 +8,16 @@ Docs даёт самостоятельное понимание продукта

 | Вид знания | Где поддерживается |
 | --- | --- |
-| Согласованное проверяемое поведение: требования и сценарии | [Основные спецификации](../specs/AI_INDEX.md) в `specs/openspec/specs/` |
+| Согласованное проверяемое поведение: требования и сценарии | [Основные спецификации](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/AI_INDEX.md) в `specs/openspec/specs/` |
 | Предложения изменений, их проектирование и задачи | OpenSpec changes в существующем Store `wealth-ledger-specs`, `specs/openspec/changes/` |
 | Понимание системы, областей и взаимодействий | Тематические страницы docs |
 | Принятые решения и подтверждённые причины | Единственный журнал [docs/adr](adr/README.md) |
 | Конкретная реализация и технические контракты | Код, тесты, схемы, конфигурация; публичный OpenAPI формирует backend |
 | Размещение кода, conventions, команды разработки и проверки | Локальные инструкции frontend/backend |
-| Выбор репозитория и типа знания | Корневой [AGENTS](../AGENTS.md) |
+| Работа над docs | Локальные [AGENTS](AGENTS.md) и этот документ |

-История поставок, аудитов и проверок остаётся в Git, Issues и PR.
+История аудитов и проверок остаётся в Git, Issues и PR. `CHANGELOG.md`
+генерируется release-it из commits; вручную дублировать его на тематических страницах не нужно.
 Процесс разработки и инструкции агентов принадлежат локальным инструкциям
 репозиториев. ADR фиксируют решения самой системы, а не организацию работы.

@@ -85,9 +86,11 @@ Docs объясняет смысл контракта, не вводя неза
 Нужные точные значения сопровождай определяющим источником, чтобы не создать
 конкурирующую норму. Паспорта страниц, Evidence-секции и номера строк не требуются.

-Внутри docs используем относительные Markdown-ссылки. Между репозиториями —
-относительный путь через соседний корень, например `../specs/AI_INDEX.md` из README.
-Проверяй регистр, файл и якорь в фактическом workspace. Перенос требует исправить
+Внутри docs используем относительные Markdown-ссылки. Внешние репозитории —
+необязательные справочные веб-ссылки на опубликованный источник. Основной текст
+и инструкции должны быть понятны без открытия этих ссылок. Проверяй локальные
+файлы/якоря; для удалённых источников не обещай проверку их доступности CI.
+Перенос требует исправить
 входящие ссылки активных Markdown-документов; исторические архивы и dated audits
 сохраняют адреса своего времени. Короткий указатель оставляем только при реальной
 необходимости совместимости, без второй копии содержания.
@@ -152,8 +155,7 @@ npm run verify
 Существующий gate запускает Markdown lint с проверкой относительных ссылок
 и якорей, затем `git diff --check`. Он охватывает новые Markdown-файлы;
 обычный diff их не показывает, поэтому отдельно просмотри untracked-содержание.
-При изменениях соседних репозиториев выполни там `git diff --check` и проверь
-затронутые ссылки. Markdown-only правки не требуют тестов всего приложения.
+Markdown-only правки не требуют тестов приложения или соседнего checkout.

 Правило relative-links не проверяет внешние URL и HTML-ссылки. Mermaid-рендер
 в gate не входит; используй доступный локальный рендерер без отправки материалов
@@ -167,12 +169,11 @@ npm run verify

 ### CI и обновления зависимостей

-`.gitea/workflows/verify.yml` запускает этот gate на каждом push ветки с Node
-из `.nvmrc` и установкой через `npm ci`. Checkout docs размещается внутри
-workspace из `WealthLedger/main`, рядом с frontend, backend и specs. Соседние
-репозитории берутся из `main`; SHA всех пяти участников сохраняются в логе.
-Ошибка checkout, Markdown или относительной ссылки завершает job с FAIL.
-Это проверка ссылок на выбранные revisions, без Mermaid-render и semantic review.
+`.gitea/workflows/verify.yml` запускает этот gate на push и PR с Node
+из `.nvmrc` и установкой через `npm ci`. Скачивается только docs;
+его SHA сохраняется в логе. Ошибка checkout, Markdown или внутренней ссылки
+завершает job с FAIL. Внешние веб-ссылки — справочные; CI не проверяет их
+доступность, Mermaid-render или semantic correctness.

 `security.yml` при push, PR и ежедневно проверяет всю Git-историю через
 Gitleaks 8.30.1 с redacted-выводом и все npm dependencies через
@@ -183,3 +184,5 @@ DoS в TOML parser markdownlint-cli2; его можно удалить, когд
 Renovate объединяет minor/patch updates; major требует согласования в
 Dependency Dashboard, automerge не включён. Required checks включаются
 отдельно в Gitea; workflow сам по себе не запрещает merge.
+
+Версии и ветки: [процесс релиза](README.md#релизы).
@@ -47,15 +47,16 @@ WealthLedger помогает частному инвестору понимат
 | Понять ошибку или старые данные | [Состояния интерфейса](architecture/cross-cutting/ui-resilience.md), [свежесть данных](architecture/cross-cutting/data-freshness.md) |
 | Понять визуальные роли и состояния | [Визуальные принципы](design/overview.md) |
 | Узнать причину архитектурного решения | [Журнал ADR](adr/README.md) |
+| Запустить, обновить или восстановить приложение | [Контейнерная поставка](architecture/deployment.md) |

 ## Границы знаний

-[Основные спецификации](../specs/AI_INDEX.md) сохраняют согласованное проверяемое
+[Основные спецификации](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/AI_INDEX.md) сохраняют согласованное проверяемое
 поведение, а OpenSpec changes — предложения, дизайн и задачи изменений.
 Фактический Store находится в `specs/openspec/`, основные требования — в
 `specs/openspec/specs/`. Docs объясняет систему; код, тесты, схемы и конфигурация
 задают конкретный механизм, а [ADR](adr/README.md) сохраняют принятые решения.
-Локальные инструкции [frontend](../frontend/AGENTS.md) и [backend](../backend/AGENTS.md)
+Локальные инструкции [frontend](https://git.personal.ksv741.ru/WealthLedger/frontend/src/commit/9f7e342333b80bfacfd5bc394a2dcd0613d33ff3/AGENTS.md) и [backend](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/AGENTS.md)
 описывают изменение реализации и её проверки.

 Эти источники дополняют друг друга. Найденный незавершённый change не доказывает
@@ -67,3 +68,39 @@ WealthLedger помогает частному инвестору понимат

 Правила изменения текста, диаграмм, ссылок и проверки docs-impact находятся
 в [CONTRIBUTING](CONTRIBUTING.md).
+
+## Релизы
+
+Репозиторий выпускается независимо. `develop` — интеграция, `main` — принятые
+релизы. Работа: `codex/<task>` от актуального `develop`, PR в `develop`.
+Обычные PR допускают squash; release и обратная синхронизация сохраняют историю.
+Commits и PR titles — Conventional Commits, включая `spec:`. Версии вручную не повышай.
+
+1. Получи `main`, `develop` и теги: `git fetch origin --tags`. Убедись, что
+   `develop` содержит последний релиз. Создай `release/<name>` от проверенного
+   `develop`; `nvm use --silent`, `npm ci`. Hotfix начинается от `main` в
+   `release/hotfix-<name>` и проходит тот же процесс.
+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 и версией
+   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 исправь и проверь
+   существующий кандидат без повторного повышения версии.
+
+`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*` защищены.
+Workflow сам не включает эти настройки. Отдельное review approval для одного
+владельца не требуется. Npm publishing, deploy и Gitea Releases не включены.
@@ -2,6 +2,9 @@

 **Status:** Accepted, baseline decision

+Deployment boundary расширена [ADR 015](015-single-server-sqlite-deployment.md)
+для одного сервера и одного backend process. Ниже сохранён исходный контекст.
+
 ## Context

 MVP нужен воспроизводимый локальный доступ к данным без инфраструктуры развёртывания. Доменные таблицы и миграции на baseline отсутствуют.
@@ -0,0 +1,47 @@
+# 015. SQLite в ограниченном single-server deployment
+
+**Status:** Accepted
+
+## Context
+
+[ADR 001](001-prisma-sqlite-local-mvp.md) ограничивал SQLite локальным MVP.
+Контейнерная поставка требует постоянного хранилища на одном сервере,
+но не требует высокой доступности или нескольких экземпляров API.
+Пользователи, сессии, зашифрованные подключения и банковская история уже
+хранятся в SQLite. Кэши, limiter и generation подключений локальны процессу.
+
+## Decision
+
+Разрешён один backend process на одном Docker host с SQLite в постоянном
+host directory. Development использует отдельный named volume. SQLite
+остаётся embedded library без сетевого порта. Это расширяет deployment
+boundary ADR 001; его исторический контекст сохраняется.
+
+Prisma migrations выполняются отдельным одноразовым service из того же image,
+что и backend. Перед изменением схемы backend останавливается, всё data
+directory копируется вместе с возможными WAL/SHM files. Ключ шифрования
+сохраняется отдельно. Неуспешная migration блокирует запуск новой версии.
+
+Откат image требует совместимости с текущей схемой и не восстанавливает
+старую базу. Restore требует отдельного решения о потере данных после backup.
+Frontend и backend имеют независимые версии; production фиксирует version tags.
+Краткий простой допустим.
+
+## Alternatives
+
+PostgreSQL потребовал бы миграции данных и отдельного database lifecycle;
+текущие требования этого не оправдывают. Kubernetes, replicas и blue-green
+не устраняют ограничения process-local состояния и не входят в решение.
+
+## Consequences
+
+Сервер не обещает HA или zero-downtime. Один backend instance — обязательное
+ограничение, а не рекомендуемая настройка масштабирования. Нужны контроль
+свободного места, согласованные backups и проверяемое восстановление.
+
+Решение пересматривается при необходимости нескольких replicas, другом
+availability target, заметном write contention или потребности в отдельном
+database service. Добавление реплик до такого решения недопустимо.
+
+Топология описана в [архитектуре](../architecture/containers.md#контейнерная-поставка),
+операции — в [runbook](../architecture/deployment.md).
@@ -19,3 +19,4 @@
 - [009 — Concurrent refresh rotation policy](009-concurrent-refresh-rotation-policy.md)
 - [013 — НКР как первый источник кредитных рейтингов облигаций](013-nkr-bond-credit-ratings.md)
 - [014 — Актуальная OpenAPI-схема как вход frontend](014-trusted-openapi-input.md)
+- [015 — SQLite в ограниченном single-server deployment](015-single-server-sqlite-deployment.md)
@@ -16,6 +16,7 @@
 | Как обрабатываются ошибки и ожидание? | [HTTP API и ошибки](http-api.md), [состояния интерфейса](cross-cutting/ui-resilience.md) |
 | Как связать ошибку с обработкой запроса? | [Наблюдаемость](http-api.md#наблюдаемость) |
 | Как устроено подтверждённое локальное окружение? | [Container](containers.md#представление-container), [качество и ограничения](containers.md#качество-и-ограничения) |
+| Как запустить, обновить или восстановить приложение? | [Развёртывание](deployment.md) |
 | Что означают предметные термины? | [Глоссарий](../glossary.md) |

 Эта карта покрывает вопросы архитектуры там, где о них есть подтверждённое
@@ -27,11 +27,50 @@ flowchart LR
  F -->|"HTTPS; изображения без авторизации"| C
 ```

-SPA выполняется в браузере пользователя. Backend — отдельное локальное
+SPA выполняется в браузере пользователя. Backend — отдельное
 приложение; SQLite используется внутри его процесса через библиотеку и файл
 базы. Между API и SQLite нет сетевого database server. Граница системы на
 схеме показывает принадлежность частей, а не их размещение на одном узле.

+## Контейнерная поставка
+
+Deployment view для одного сервера. Caddy принадлежит серверу; Compose
+содержит два постоянных application containers и одноразовую migration.
+
+```mermaid
+flowchart LR
+  Browser["Браузер · React SPA"] -->|HTTPS| Caddy["Серверный Caddy · TLS"]
+  subgraph Host["Один Docker host"]
+    Caddy -->|"HTTP · 127.0.0.1:8080"| Frontend["frontend · nginx · SPA + /api/"]
+    Frontend -->|"HTTP /api/v1 · internal network"| Backend["backend · NestJS · один process"]
+    Migration["migration · Prisma · one-shot"] -->|"До старта backend"| Data[("Host directory · SQLite + WAL")]
+    Backend -->|"Чтение и запись /data"| Data
+    Secrets["Restricted environment · ключи вне images"] --> Backend
+  end
+```
+
+Только frontend публикует host port, привязанный к loopback. Backend не
+публикует порт, но имеет исходящий доступ к внешним API. nginx сохраняет
+`/api/` prefix, forwarding headers и request ID; Docker DNS разрешается
+повторно после backend recreation. HTML требует revalidation, hashed assets
+имеют immutable cache. Caddy не содержит отдельного маршрута к API.
+
+Development заменяет nginx на Vite с HMR, backend — на Nest watch, а host data
+path — на отдельный named volume. Browser origin остаётся единым. Linux
+node_modules не монтируются с хоста. Production SPA собирается с relative API
+base; production cookies остаются Secure, публичный origin использует HTTPS.
+
+Компоненты имеют независимые images и версии. Production фиксирует image
+version tags; migration использует тот же backend image. Успех migration предшествует
+backend healthcheck на существующем auth route; frontend ждёт healthy backend.
+Runtime работает non-root, SQLite сохраняется вне image, ключ шифрования и JWT
+secret поступают из restricted environment и сохраняются между обновлениями.
+
+Ограничение SQLite расширено в [ADR 015](../adr/015-single-server-sqlite-deployment.md).
+[Runbook](deployment.md) описывает установку, independent
+updates, backup, rollback и explicit restore. Он также перечисляет внешние
+prerequisites: локальный smoke не подтверждает registry/server rollout.
+
 ## Ответственность частей

 | Часть | Ответственность |
@@ -106,10 +145,10 @@ credentials не являются сохраняемым представлен

 ## Сохранение и восстановление данных

-Резервная копия SQLite должна быть согласованной: для работающей базы
-используется SQLite backup API с учётом WAL. Несогласованное копирование
-файлов базы и WAL не сохраняет целостный снимок. Восстановление проверяется
-на отдельной копии. Ключ шифрования подключения хранится отдельно от базы;
+Поддерживаемая процедура останавливает backend и копирует весь data directory
+с возможными WAL/SHM files до migration. Копирование отдельных файлов
+работающей базы не сохраняет целостный снимок; для live backup потребовался бы
+SQLite backup API. Восстановление проверяется на отдельной копии. Ключ шифрования подключения хранится отдельно от базы;
 его потеря делает сохранённый T-Bank token нечитаемым.

 Откат приложения требует совместимости предыдущей версии с сохранённой
@@ -150,12 +189,12 @@ access token и вращаемый refresh token. [Политика query-кэш
 отмечены в [аутентификации](../domains/authentication/overview.md#регистрация-и-вход)
 и [HTTP API](http-api.md#error-contract).

-Подтверждённая топология — локальная SPA и локальный API с файлом SQLite.
+Поддерживается локальный Compose и ограниченная single-server topology с SQLite.
 Origin браузера, адрес API и cookie policy должны быть согласованы.
 `localhost` и `127.0.0.1` задают разные browser-границы для cookie и CORS.
 Локальный HTTP поддерживается в development-режиме backend; в остальных
 режимах refresh-cookie имеет Secure flag и требует защищённого соединения.
-Наличие локального запуска не задаёт production-топологию или гарантии SLA.
+Single-server deployment не задаёт гарантий HA или zero-downtime.

 Кэши и лимитер T-Bank действуют на экземпляр backend. Ротация ключа шифрования
 подключений и согласование изменений подключения между распределёнными
@@ -65,8 +65,8 @@ Client Cached Snapshot прежнего подключения больше не

 Пользовательский сценарий описан в [интеграции T-Bank](../../integrations/tbank.md).
 Согласованные правила frontend находятся в workspace-спецификациях
-[query coherence](../../../specs/openspec/specs/frontend-query-coherence/spec.md)
-и [data resilience](../../../specs/openspec/specs/frontend-data-resilience/spec.md);
+[query coherence](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/frontend-query-coherence/spec.md)
+и [data resilience](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/frontend-data-resilience/spec.md);
 серверные правила — в
-[portfolio](../../../specs/openspec/specs/portfolio-view/spec.md) и
-[ledger](../../../specs/openspec/specs/brokerage-account-ledger/spec.md).
+[portfolio](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md) и
+[ledger](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-ledger/spec.md).
@@ -44,6 +44,6 @@ actions. Устаревший серверный Portfolio Snapshot показы
 [аутентификации](../../domains/authentication/overview.md).

 Согласованное поведение раскрыто в workspace-спецификациях
-[UI resilience](../../../specs/openspec/specs/frontend-ui-resilience/spec.md),
-[loading presentation](../../../specs/openspec/specs/frontend-loading-presentation/spec.md)
-и [data resilience](../../../specs/openspec/specs/frontend-data-resilience/spec.md).
+[UI resilience](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/frontend-ui-resilience/spec.md),
+[loading presentation](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/frontend-loading-presentation/spec.md)
+и [data resilience](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/frontend-data-resilience/spec.md).
@@ -0,0 +1,227 @@
+# Контейнерная поставка
+
+Runbook для одного Docker host, одного backend и краткого простоя.
+[Топология](containers.md#контейнерная-поставка) и
+[ADR 015](../adr/015-single-server-sqlite-deployment.md) объясняют границы.
+Команды выполняются из checkout `WealthLedger/main`, содержащего `compose.yaml`.
+Development дополнительно требует checkout `frontend/` и `backend/`.
+
+## Предпосылки
+
+- Docker Engine с Compose plugin **не ниже 2.24.4** (`!override` в development),
+  доступ к registry и достаточно свободного диска для non-root UID 1000.
+  Локально проверены Engine 29.8.0, Compose 5.5.1, Linux arm64.
+  Другую архитектуру проверяют отдельно; multi-platform images не обещаны.
+- Gitea Container Registry; проверяемая версия сервера — 1.27.3.
+  Runner label — `ubuntu-latest`, runner должен иметь Docker CLI, buildx и daemon.
+  Наличие label само по себе не доказывает Docker capability.
+- В Actions каждого component repo нужны `REGISTRY_USERNAME` и
+  `REGISTRY_TOKEN` отдельной identity с package write permission. Server
+  использует другую identity только с package read permission. Built-in
+  workflow token не заменяет эту настройку.
+- На сервере Caddy уже завершает TLS и передаёт весь домен на
+  `127.0.0.1:8080` (или выбранный frontend port). Отдельного `/api` upstream нет.
+  DNS, TLS, firewall и provisioning Caddy выполняются вне этого runbook.
+
+Реальная публикация и server pull-only login требуют отдельной проверки
+на вашей инфраструктуре. Локальные images не доказывают registry permissions.
+
+## Development
+
+Из workspace с исходниками обоих компонентов:
+
+```bash
+docker version
+docker compose version
+docker compose --env-file .env.development.example \
+  -f compose.yaml -f compose.development.yaml config --quiet
+docker compose --env-file .env.development.example \
+  -f compose.yaml -f compose.development.yaml up -d --build --wait --wait-timeout 180
+```
+
+Откройте `http://localhost:5173`. Vite отдаёт HMR и проксирует `/api/` без
+rewrite; Nest работает в watch mode. Монтируются только source/public,
+`node_modules` и generated files остаются в container filesystem. `.env`
+с хоста не копируется. После изменения manifest, lockfile, tsconfig или Vite
+config пересоберите соответствующий image. `up --build` обновляет Linux
+dependencies без stale named volume для `node_modules`.
+
+Для другого порта скопируйте `.env.development.example` в игнорируемый
+`.env.development` и согласованно поменяйте `FRONTEND_PORT`/`FRONTEND_ORIGIN`.
+Пример содержит только вымышленные local secrets; server secrets сюда не входят.
+Поля image/data directory нужны для интерполяции base Compose, но полностью
+заменяются development override. В итоговом config нет production data path.
+
+Project `wealthledger-dev` хранит SQLite в `development-data`. Обычные
+`restart` и `down` сохраняют его. Не применяйте `down -v` к данным, которые
+хотите сохранить. Не используйте production project name для development.
+
+## Публикация компонентных images
+
+Штатный release process каждого repo создаёт защищённый `vX.Y.Z` после
+проверенного release commit. `image.yml` проверяет tag против package/lock
+version, затем выполняет `npm ci`, `npm run verify`; backend дополнительно
+выполняет `npm run test:e2e`. У каждого image OCI version/revision labels.
+
+Images публикуются как `git.personal.ksv741.ru/wealthledger/frontend:X.Y.Z`
+и `.../backend:X.Y.Z`. `latest` не создаётся.
+Workflow отказывается перезаписывать существующие release tags;
+защита release tags и запрет параллельных publishers обязательны. Если одна
+публикация уже состоялась, не удаляйте tag для повторного запуска: проверьте
+опубликованный image и завершите проверку существующего artifact отдельно.
+
+Выберите опубликованные version tags, выполните pull и сравните OCI revision
+с release commit. Выполните smoke с disposable data/config до первого server
+rollout. В production env хранится пара полных image references, например
+`git.personal.ksv741.ru/wealthledger/frontend:0.1.0`. Сохраните versions/revisions
+в deployment record. Release tags не должны переназначаться другим images.
+
+## Первая установка
+
+Создайте restricted environment file и data directory:
+
+```bash
+sudo install -d -m 0700 /srv/wealthledger
+sudo install -d -m 0700 -o 1000 -g 1000 /srv/wealthledger/data
+sudo install -m 0600 .env.compose.example /srv/wealthledger/production.env
+```
+
+Дальнейшие команды выполняет оператор, имеющий доступ к environment file,
+backup directory и Docker. Заполните env локальным защищённым редактором:
+полные ссылки `FRONTEND_IMAGE` и `BACKEND_IMAGE` с опубликованными version tags,
+публичный HTTPS origin и абсолютный data path. Версии в примере — образец
+формата; перед запуском выберите реально опубликованные releases.
+Пустые required значения блокируют config; некорректные secrets блокируют backend.
+Не выводите полный rendered config с настоящими secrets в журналы.
+
+Для новой базы создайте JWT secret длиной хотя бы 32 символа и отдельный
+32-byte encryption key в base64 (`openssl rand -hex 32` и
+`openssl rand -base64 32` в защищённом терминале). Сохраните ключ отдельно
+от data backup. Для существующей установки перенесите прежние JWT secret
+и encryption key, а согласованную копию **всего** data directory — при
+остановленном прежнем backend. Файл должен называться `wealthledger.db`;
+если переименовываете, согласуйте также WAL/SHM companion names до старта.
+Не запускайте старый и новый backend на одной базе одновременно.
+
+Войдите в registry server identity без помещения token в командную строку:
+
+```bash
+docker login git.personal.ksv741.ru --username SERVER_PULL_USER
+export COMPOSE_FILE=compose.yaml
+export COMPOSE_PROJECT_NAME=wealthledger
+export COMPOSE_ENV_FILES=/srv/wealthledger/production.env
+docker compose config --quiet
+docker compose pull frontend backend migration
+docker compose up -d --wait --wait-timeout 120
+docker compose ps -a
+```
+
+Migration и backend используют один image и один data mount.
+Migration должна завершиться с кодом 0; иначе backend не запускается.
+Readiness принимает 401 от существующего `/api/v1/auth/me` без credentials.
+Frontend становится healthy после backend. Backend host port отсутствует.
+Runtime non-root; root filesystem read-only, nginx temp files находятся в tmpfs.
+
+Проверьте SPA deep link, регистрацию/вход, refresh, существующие карты,
+чтение старого зашифрованного подключения и один финансовый запрос.
+Production refresh-cookie имеет Secure flag: проверяйте через HTTPS Caddy;
+loopback HTTP curl без browser cookie jar не доказывает browser session.
+При локальном smoke используйте disposable credentials и явную передачу cookie.
+Направляйте Caddy на новый deployment только после успешной проверки.
+Прежний runtime удаляйте только после проверки новой установки.
+
+## Backup при остановленном backend
+
+До backend update проверьте совместимость новой версии с текущим frontend
+и схемой, а обратной версии — с новой схемой. При неизвестной совместимости
+не обещайте image rollback. В выбранном rollout отсутствуют параллельные API.
+
+Ниже data path соответствует примеру env; при другом path замените его.
+Сохраните текущую пару image references/revisions и отдельно — ключи.
+
+```bash
+docker compose stop backend
+docker compose ps -a backend
+install -d -m 0700 /srv/wealthledger/backups
+BACKUP_DIRECTORY="/srv/wealthledger/backups/$(date -u +%Y%m%dT%H%M%SZ)"
+mkdir -m 0700 "$BACKUP_DIRECTORY"
+cp -a /srv/wealthledger/data "$BACKUP_DIRECTORY/data"
+```
+
+Перед копированием убедитесь, что backend остановлен, migration не выполняется
+и никто другой не пишет в каталог. Успех `cp` обязателен перед продолжением.
+Не копируйте отдельный `.db` из работающего приложения. Проверяйте backup
+на отдельной копии: migration status, `PRAGMA integrity_check`, auth, карты
+и расшифровка тестового подключения исходным ключом. Backup без проверяемого
+ключа недостаточен для восстановления подключения.
+
+## Независимое обновление frontend
+
+После проверки API compatibility замените только `FRONTEND_IMAGE` в env:
+
+```bash
+docker compose pull frontend
+docker compose up -d --no-deps --wait --wait-timeout 120 frontend
+```
+
+Backend container и SQLite не пересоздаются. Входная точка кратко недоступна.
+Проверьте deep link, login/refresh и новую OCI revision. Старым browser tabs
+может понадобиться reload: старые hashed chunks не сохраняются между images.
+
+## Независимое обновление backend
+
+Выполните stopped-backend backup выше. Замените только `BACKEND_IMAGE` в env.
+Последовательность не продолжается после failed migration:
+
+```bash
+docker compose pull backend migration
+docker compose up --no-deps --force-recreate --abort-on-container-exit \
+  --exit-code-from migration migration &&
+docker compose up -d --no-deps --wait --wait-timeout 120 backend
+```
+
+Frontend не пересоздаётся; nginx повторно разрешает backend DNS. Во время
+перерыва возможен 502. При failure оставьте backend остановленным, сохраните
+диагностику migration и выберите совместимый image либо отдельный restore.
+Не используйте `migrate reset` или автоматический `resolve` как recovery.
+Проверьте migration status, health, login/refresh, карты и расшифровку подключения.
+После успешного smoke запишите фактически установленную пару image references.
+
+## Откат image
+
+Для frontend верните предыдущий совместимый version tag и повторите frontend update.
+Для backend сначала остановите процесс и подтвердите совместимость старого
+image с **текущей** схемой. Верните предыдущий image reference и запустите только backend:
+
+```bash
+docker compose pull backend
+docker compose up -d --no-deps --wait --wait-timeout 120 backend
+```
+
+Данные и encryption key не заменяются. Migration service здесь намеренно
+не запускается: старые migrations не являются down-migrations. Прочитайте
+новые записи, сделанные после backup, и проверьте auth/cards/connection.
+При несовместимости оставьте приложение остановленным до решения о recovery.
+
+## Explicit restore
+
+Это отдельное решение оператора, **не часть image rollback**. Оператор выбирает
+backup timestamp и явно принимает потерю всех изменений после него, включая
+сессии, карты и подключения. Сначала воспроизведите restore на isolated project
+с отдельным data path/port и совместимым image; не используйте production data
+как fixture. Убедитесь в наличии соответствующего encryption key.
+
+После отдельного решения остановите backend и убедитесь, что migration не
+работает. Сохраните нынешний каталог под новым именем, ничего не удаляя:
+
+```bash
+docker compose stop backend
+mv /srv/wealthledger/data /srv/wealthledger/data-before-restore-TIMESTAMP
+cp -a /srv/wealthledger/backups/CHOSEN_TIMESTAMP/data /srv/wealthledger/data
+```
+
+Проверьте owner 1000:1000, permissions, выбранный compatible image и исходный
+ключ. Запустите backend командой rollback с `--no-deps`, затем выполните smoke.
+Сверьте наличие записей до backup и отсутствие известных записей потерянного
+интервала. Сохраните прежний каталог для расследования. При необходимости
+новой migration сначала выполните обычную backup/update последовательность.
@@ -8,6 +8,15 @@ Backend генерирует OpenAPI из собственного публич
 схемы находятся вне frontend. Это разделение принято в
 [ADR 002](../adr/002-nest-generated-openapi-contract.md) и
 [ADR 014](../adr/014-trusted-openapi-input.md).
+
+Backend командой `npm run openapi:generate` создаёт `openapi.json` без запуска
+сервера и не хранит результат в Git. Contract test сравнивает вывод генератора
+с Nest runtime schema настроенного приложения. Frontend хранит полученный
+artifact у себя и проверяет соответствие generated types этой копии. CI не
+скачивает соседние репозитории и не сравнивает их текущие revisions. Обновление
+входного artifact потребителя выполняется отдельно с review; совместимость
+развёрнутых версий не доказывается одним зелёным локальным CI.
+
 API имеет prefix `/api/v1`; Swagger публикуется для локальной разработки по
 environment policy, а не используется frontend в runtime.

@@ -36,7 +45,7 @@ message/stack. Типичный ответ:
 HTTP-ответа после всех стадий обработки запроса.

 **Известное расхождение:** согласованная
-[спецификация аутентификации](../../specs/openspec/specs/user-authentication/spec.md#requirement-стандартные-ответы-об-ошибках)
+[спецификация аутентификации](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/user-authentication/spec.md#requirement-стандартные-ответы-об-ошибках)
 требует `pointer` и `detail` для невалидных полей. В текущей конфигурации
 валидация формирует строковые сообщения, а фильтр ожидает структурированные
 ошибки полей; поэтому корректность деталей `errors` не подтверждена.
@@ -74,5 +83,5 @@ client request ID. Это позволяет сопоставить публич
 Выбор logger и граница ответственности описаны в
 [ADR 008](../adr/008-pino-backend-logging.md); согласованное поведение — в
 workspace-спецификации
-[Structured logging](../../specs/openspec/specs/backend-structured-logging/spec.md).
+[Structured logging](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/backend-structured-logging/spec.md).
 Сборщик, срок хранения журналов и alerting не определяются приложением.
@@ -0,0 +1,4 @@
+module.exports = {
+  extends: ["@commitlint/config-conventional"],
+  rules: { "type-enum": [2, "always", ["feat", "fix", "perf", "docs", "spec", "refactor", "build", "ci", "test", "style", "chore", "revert"]] },
+};
@@ -44,4 +44,4 @@
 и [банковских картах](../domains/cards/overview.md).

 Согласованная общая основа описана в
-[спецификации дизайн-системы](../../specs/openspec/specs/frontend-design-system/spec.md).
+[спецификации дизайн-системы](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/frontend-design-system/spec.md).
@@ -93,7 +93,7 @@ sequenceDiagram
 [журнал операций](../operations/overview.md) или историю закрытых счетов.
 Для совокупного результата доступен [режим «Все счета»](../portfolio/all-accounts.md).

-Согласованное поведение описывает [спецификация счетов](../../../specs/openspec/specs/brokerage-accounts/spec.md).
+Согласованное поведение описывает [спецификация счетов](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-accounts/spec.md).
 Её раздел об экране пока требует одноколоночного списка и не описывает
 счётчики акций и облигаций. Текущая реализация и её проверки используют
 две колонки на широком экране и показывают эти счётчики. Расхождение требует
@@ -23,7 +23,7 @@
 Access token действует 15 минут и хранится только в памяти браузера.
 Refresh token имеет серверный срок 7 дней, заменяется при восстановлении
 сессии и передаётся в cookie `refresh_token` с `httpOnly` и `SameSite=Lax`.
-Сроки определены в [спецификации сессий](../../../specs/openspec/specs/user-authentication/spec.md#requirement-access-и-refresh-сессии)
+Сроки определены в [спецификации сессий](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/user-authentication/spec.md#requirement-access-и-refresh-сессии)
 и [ADR 006](../../adr/006-auth-session-policy.md).

 После перезагрузки SPA получает новый access token через refresh-cookie.
@@ -117,6 +117,6 @@ Backend проверяет учётные данные и tokens, хранит
 и проверку атомарности с реальной изолированной базой.

 Согласованное поведение находится в workspace-спецификации
-[User authentication](../../../specs/openspec/specs/user-authentication/spec.md).
+[User authentication](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/user-authentication/spec.md).
 Правила начального ожидания — в
 [состояниях интерфейса](../../architecture/cross-cutting/ui-resilience.md).
@@ -140,6 +140,6 @@ JavaScript Number. Отдельный ввод ограничен signed64: на
 сохраняет новую финансовую историю и при откате приложения. Устройство хранения
 описано в [контейнерах](../../architecture/containers.md#хранимые-данные-и-границы-доступа).
 Согласованный контракт банковского учёта находится в
-[manual-bank-cards](../../../specs/openspec/changes/add-manual-bank-cards/specs/manual-bank-cards/spec.md).
+[manual-bank-cards](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/changes/add-manual-bank-cards/specs/manual-bank-cards/spec.md).
 Автоматическая загрузка банковских данных, кредитные карты, другие валюты,
 бюджеты и общий баланс банковских денег с инвестициями в эту версию не входят.
@@ -59,7 +59,7 @@
 для полного месяца это предыдущий полный месяц, иначе — непосредственно
 предшествующий интервал той же включительной длительности. Текущая страница
 его не показывает. Это расходится с
-[основным требованием сравнений](../../../specs/openspec/specs/brokerage-account-income-analytics/spec.md#requirement-period-comparisons-preserve-calendar-and-currency-meaning),
+[основным требованием сравнений](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-income-analytics/spec.md#requirement-period-comparisons-preserve-calendar-and-currency-meaning),
 которое описывает оба сравнения. Требуется отдельно согласовать этот разрыв;
 здесь сохранено различие между ответом API и фактическим экраном.

@@ -104,7 +104,7 @@ Frontend проверяет принадлежность выплат по по

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

-Основное проверяемое поведение — в [спецификации дохода](../../../specs/openspec/specs/brokerage-account-income-analytics/spec.md),
+Основное проверяемое поведение — в [спецификации дохода](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-income-analytics/spec.md),
 точная форма ответа — в [HTTP API](../../architecture/http-api.md).
 Не следует использовать календарь будущих событий для восстановления
 состава уже полученного дохода.
@@ -29,7 +29,7 @@
 Суммы рассчитаны по количеству на `calculatedAt`. Они не учитывают будущие
 сделки, право владения на дату реестра и персональный налоговый расчёт.
 Есть неразрешённое ограничение интерпретации:
-[основная спецификация](../../../specs/openspec/specs/brokerage-account-upcoming-events/spec.md#requirement-forecasts-preserve-event-meaning-and-uncertainty)
+[основная спецификация](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-upcoming-events/spec.md#requirement-forecasts-preserve-event-meaning-and-uncertainty)
 и текущая подсказка экрана называют прогноз суммой «до налогов», но для
 дивиденда реализация только умножает `dividend_net` на количество.
 Налоговый смысл этого поля не подтверждён локальными материалами; на
@@ -61,7 +61,7 @@ API принимает необязательные `from` и `to` в форма
 Итоги остаются в ответе API; полный экран показывает список без общего итога.

 Текущие controller, сервис и экран поддерживают выбор периода, тогда как
-[основная спецификация](../../../specs/openspec/specs/brokerage-account-upcoming-events/spec.md#requirement-account-page-presents-an-upcoming-events-list)
+[основная спецификация](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-upcoming-events/spec.md#requirement-account-page-presents-an-upcoming-events-list)
 описывает фиксированные 30 дней и экран без фильтров. Документация отражает
 реализованный выбор периода, не изменяя это несогласованное требование.

@@ -132,13 +132,13 @@ HTML-источник, общий кэш и поведение при измен
 выход очищает кэш сессии. Общие график, позиция и личные события
 имеют общее представление на страницах акций и облигаций.

-Основные спецификации [портфеля](../../../specs/openspec/specs/portfolio-view/spec.md)
-и [журнала](../../../specs/openspec/specs/brokerage-account-ledger/spec.md)
+Основные спецификации [портфеля](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md)
+и [журнала](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-ledger/spec.md)
 описывают исходные финансовые понятия. Отдельная основная спецификация
 страницы облигации в текущем OpenSpec Store не найдена; условия вычислений
-подтверждены [каталогом](../../../backend/src/modules/investments/instruments/bonds/application/bond-catalog.service.ts),
-[рыночными данными](../../../backend/src/modules/investments/instruments/bonds/application/bond-market.service.ts),
-[выплатами](../../../backend/src/modules/investments/instruments/bonds/application/bond-income.service.ts)
-и [проверками](../../../backend/src/modules/investments/instruments/bonds/application/bond.spec.ts).
+подтверждены [каталогом](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/instruments/bonds/application/bond-catalog.service.ts),
+[рыночными данными](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/instruments/bonds/application/bond-market.service.ts),
+[выплатами](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/instruments/bonds/application/bond-income.service.ts)
+и [проверками](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/instruments/bonds/application/bond.spec.ts).
 Границы источников описаны в [разделе интеграций](../../integrations/README.md),
 сходное разделение рыночных и личных данных — в [акциях](stocks.md).
@@ -169,11 +169,11 @@ TTM означает последние 12 месяцев, MRQ — послед
 История открытых счетов не обещает полную историю владения, включая закрытые
 счета, переводы и универсальные корпоративные события.

-Основные спецификации [портфеля](../../../specs/openspec/specs/portfolio-view/spec.md)
-и [журнала](../../../specs/openspec/specs/brokerage-account-ledger/spec.md)
+Основные спецификации [портфеля](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md)
+и [журнала](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-ledger/spec.md)
 задают исходные финансовые понятия. Отдельная основная спецификация страницы
 акции в текущем OpenSpec Store не найдена; описанные механизмы проверяются
-по [каталогу](../../../backend/src/modules/investments/instruments/stocks/application/stock-catalog.service.ts),
-[рыночным данным](../../../backend/src/modules/investments/instruments/stocks/application/stock-market.service.ts),
-[выплатам](../../../backend/src/modules/investments/instruments/stocks/application/stock-income.service.ts) и [проверкам](../../../backend/src/modules/investments/instruments/stocks/application/stock.spec.ts).
+по [каталогу](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/instruments/stocks/application/stock-catalog.service.ts),
+[рыночным данным](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).
@@ -112,6 +112,6 @@ Backend хранит не более 100 страниц в памяти проц
 и `TBANK_UNAVAILABLE` сохраняют [общую семантику API](../../architecture/http-api.md).
 Пустой успешный ответ означает отсутствие подходящих операций, а не сбой.

-Согласованное поведение описано в [спецификации журнала](../../../specs/openspec/specs/brokerage-account-ledger/spec.md).
+Согласованное поведение описано в [спецификации журнала](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-ledger/spec.md).
 Фильтр конкретной бумаги и общий режим расширяют исходное описание отдельного
 счёта; их механизм раскрыт на страницах инструментов и общего портфеля.
@@ -109,11 +109,11 @@ Backend публикует статические маршруты под `/api/
 работать с отдельными счетами. При откате сначала возвращается клиент.
 Этот механизм не требует изменения схемы SQLite и миграции финансовых данных.

-Основные спецификации [портфеля](../../../specs/openspec/specs/portfolio-view/spec.md),
-[операций](../../../specs/openspec/specs/brokerage-account-ledger/spec.md),
-[дохода](../../../specs/openspec/specs/brokerage-account-income-analytics/spec.md)
-и [событий](../../../specs/openspec/specs/brokerage-account-upcoming-events/spec.md)
+Основные спецификации [портфеля](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md),
+[операций](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-ledger/spec.md),
+[дохода](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-income-analytics/spec.md)
+и [событий](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-upcoming-events/spec.md)
 описывают отдельный счёт. Общий режим подтверждён действующими маршрутизаторами,
-сервисами и [проверками агрегации](../../../backend/src/modules/investments/all-accounts.spec.ts),
+сервисами и [проверками агрегации](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/all-accounts.spec.ts),
 но не выделен в самостоятельную основную спецификацию. Не следует считать
 описание общего режима изменением требований к отдельному счёту.
@@ -90,8 +90,8 @@ frontend показывает до сотых. Положительное зна
 поэтому ограничение долей действует на все валюты. В общем портфеле проверка
 отрицательных денег выполняется по остаткам счетов до взаимозачёта.

-Нормативные основы: [нормализованный состав](../../../specs/openspec/specs/portfolio-view/spec.md#requirement-нормализованный-состав-portfolio)
-и [точные значения и валютные агрегаты](../../../specs/openspec/specs/portfolio-view/spec.md#requirement-точные-значения-и-валютные-агрегаты).
+Нормативные основы: [нормализованный состав](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md#requirement-нормализованный-состав-portfolio)
+и [точные значения и валютные агрегаты](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md#requirement-точные-значения-и-валютные-агрегаты).
 Структура и общий режим подтверждены реализацией и её проверками;
 отдельных требований к ним в основной спецификации портфеля пока нет.
 Поля транспорта следует сверять с [HTTP API](../../architecture/http-api.md),
@@ -79,9 +79,9 @@ sequenceDiagram
 | Метаданные инструмента | Успешный поиск или подтверждённое отсутствие | Свежими считаются 24 часа; общий кэш на 500 ключей UID/FIGI, ошибки не сохраняются |

 Это параметры текущей реализации, а не самостоятельная политика этого
-документа: [снимки](../../../../backend/src/modules/investments/portfolio/application/portfolio.service.ts),
-[метаданные](../../../../backend/src/integrations/tbank/instrument-metadata.service.ts) и
-[клиентский запрос](../../../../frontend/src/entities/portfolio/api/usePortfolio.ts).
+документа: [снимки](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/portfolio/application/portfolio.service.ts),
+[метаданные](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/integrations/tbank/instrument-metadata.service.ts) и
+[клиентский запрос](https://git.personal.ksv741.ru/WealthLedger/frontend/src/commit/9f7e342333b80bfacfd5bc394a2dcd0613d33ff3/src/entities/portfolio/api/usePortfolio.ts).

 Пять минут — предельный возраст успешного снимка, а не дополнительные
 пять минут после окончания свежих 30 секунд. Запасной ответ сохраняет
@@ -152,7 +152,7 @@ Frontend отображает название и остальные сведе
 источника; его увеличение не является гарантированным исправлением
 ограничения самого T-Bank.

-Проверяемые правила: [свежесть и запасной снимок](../../../../specs/openspec/specs/portfolio-view/spec.md#requirement-свежесть-и-fallback-полного-portfolio-snapshot),
-[клиентские состояния](../../../../specs/openspec/specs/portfolio-view/spec.md#requirement-состояния-и-ошибки-portfolio-на-клиенте).
+Проверяемые правила: [свежесть и запасной снимок](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md#requirement-свежесть-и-fallback-полного-portfolio-snapshot),
+[клиентские состояния](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md#requirement-состояния-и-ошибки-portfolio-на-клиенте).
 Для расследования конкретного значения используйте
 [порядок диагностики](../how-to/investigate-discrepancy.md).
@@ -37,16 +37,16 @@
   теряет цифры, валюту или показатель, исследуйте frontend.
   Если исходные безопасные данные и нормализованный ответ расходятся,
   исследуйте backend. Если не совпадают ожидаемое и описанное поведение,
-   сначала сопоставьте [спецификацию портфеля](../../../../specs/openspec/specs/portfolio-view/spec.md)
+   сначала сопоставьте [спецификацию портфеля](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md)
   и ограничения [потока загрузки](../flows/portfolio-loading.md).
   Исправление документации само по себе не разрешает конфликт требований
   и реализации.

 Для адресной проверки исходников владельцами служат
-[сервис снимков](../../../../backend/src/modules/investments/portfolio/application/portfolio.service.ts),
-[валютные итоги](../../../../backend/src/modules/investments/portfolio/infrastructure/tbank-portfolio.mapper.ts),
-[структура](../../../../backend/src/modules/investments/portfolio/domain/portfolio-structure.ts) и
-[подготовка экрана](../../../../frontend/src/pages/account/ui/AccountPage.vm.ts).
+[сервис снимков](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/portfolio/application/portfolio.service.ts),
+[валютные итоги](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/portfolio/infrastructure/tbank-portfolio.mapper.ts),
+[структура](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/modules/investments/portfolio/domain/portfolio-structure.ts) и
+[подготовка экрана](https://git.personal.ksv741.ru/WealthLedger/frontend/src/commit/9f7e342333b80bfacfd5bc394a2dcd0613d33ff3/src/pages/account/ui/AccountPage.vm.ts).
 Это точки продолжения расследования; смысл вычислений изложен выше.

 Разбор завершён, когда различие объяснено составом, временем или определением
@@ -64,7 +64,7 @@ SQLite не хранит сам портфель: backend получает да
 без логотипа и с подписью результата. Отсутствующие показатели скрываются,
 а не подменяются нулём или заглушкой.

-Существует расхождение: [согласованная спецификация представления позиций](../../../specs/openspec/specs/portfolio-view/spec.md#requirement-представление-карточек-позиций-на-клиенте)
+Существует расхождение: [согласованная спецификация представления позиций](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md#requirement-представление-карточек-позиций-на-клиенте)
 требует доступности всех иных типов в отдельной секции, а текущие frontend
 и его проверка исключают `CURRENCY` только из списка карточек. Такие позиции
 остаются в ответе, валютных итогах, структуре и знаменателе долей остальных
@@ -95,5 +95,5 @@ SQLite не хранит сам портфель: backend получает да
 Для проверки конкретной суммы используйте
 [руководство по расхождениям](how-to/investigate-discrepancy.md).
 Проверяемое поведение отдельного счёта описано в
-[спецификации портфеля](../../../specs/openspec/specs/portfolio-view/spec.md);
+[спецификации портфеля](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md);
 точную форму HTTP-ответа задаёт [OpenAPI backend](../../architecture/http-api.md).
@@ -48,6 +48,6 @@ HTTP-запрос ограничен таймаутом. Сеть, неуспе
 Наличие успешного HTTP-ответа не гарантирует котировку без задержки.

 Условия обработки источника в прогнозе закреплены в
-[спецификации будущих событий](../../specs/openspec/specs/brokerage-account-upcoming-events/spec.md#requirement-upcoming-events-use-complete-source-results).
+[спецификации будущих событий](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-upcoming-events/spec.md#requirement-upcoming-events-use-complete-source-results).
 Точный механизм транспорта, разбора и сопоставления реализован в
-[клиенте MOEX](../../backend/src/integrations/moex/moex.client.ts).
+[клиенте MOEX](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/integrations/moex/moex.client.ts).
@@ -36,7 +36,7 @@ ISIN, даты и ссылки на выпуск. Изменение табли
 После ошибки новая загрузка ограничена минутным интервалом; внутри одного
 HTTP-запроса повторных попыток нет. Обновление запускается следующим обращением
 после истечения кэша, без фонового задания. Точный механизм и сроки принадлежат
-[клиенту НКР](../../backend/src/integrations/ncr/ncr-ratings.client.ts).
+[клиенту НКР](https://git.personal.ksv741.ru/WealthLedger/backend/src/commit/016782657acfd35ff3fd755462007938fac35156/src/integrations/ncr/ncr-ratings.client.ts).

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

 ## Проверка и сохранение подключения

@@ -96,7 +96,7 @@ sequenceDiagram
 для последующих запросов. Оно не описывает отзыв token на стороне T-Bank.

 Согласованное поведение сохранено в workspace-спецификации
-[T-Bank connection](../../specs/openspec/specs/tbank-connection/spec.md).
+[T-Bank connection](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/tbank-connection/spec.md).
 Точные endpoints и формы ответов определяет backend OpenAPI;
 [HTTP API](../architecture/http-api.md) описывает общую границу.

@@ -126,7 +126,7 @@ Backend хранит token в шифротексте AES-256-GCM с новым n
 | `TBANK_CA_CERT_PATH` | Необязательный путь к доверенному корневому CA в PEM для сетей с TLS-инспекцией; проверка TLS сохраняется |

 Параметры окружения определяет backend
-[validateEnv](../../backend/src/config/env.validation.ts) (workspace-ссылка).
+[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 секунд,
@@ -139,7 +139,7 @@ Backend хранит token в шифротексте AES-256-GCM с новым n
 отсутствие инструмента, а не временный сбой. Остальные RPC при полной
 очереди завершаются сразу.
 Параметры попыток принадлежат
-[T-Bank client](../../backend/src/integrations/tbank/tbank.client.ts) (workspace-ссылка);
+[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).

 Большое число ранее неизвестных инструментов требует отдельных запросов
@@ -1,17 +1,25 @@
 {
  "name": "wealth-ledger-docs",
-  "version": "1.0.0",
+  "version": "0.1.1",
  "private": true,
  "engines": {
    "node": "24.21.0"
  },
  "scripts": {
    "lint": "markdownlint-cli2 \"**/*.md\" \"#node_modules\"",
-    "verify": "npm run lint && git diff --check"
+    "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"
+    "markdownlint-rule-relative-links": "5.1.2",
+    "release-it": "21.0.2"
  },
  "overrides": {
    "markdownlint-cli2@0.23.2": {
@@ -9,7 +9,7 @@
    "dependencies"
  ],
  "dependencyDashboard": true,
-  "rangeStrategy": "bump",
+  "rangeStrategy": "pin",
  "packageRules": [
    {
      "matchUpdateTypes": [
@@ -24,5 +24,8 @@
      ],
      "dependencyDashboardApproval": true
    }
+  ],
+  "baseBranchPatterns": [
+    "develop"
  ]
 }
@@ -0,0 +1,10 @@
+const assert = require("node:assert/strict");
+const { execFileSync } = require("node:child_process");
+const { version } = require("../package.json");
+const git = (...args) => execFileSync("git", args, { encoding: "utf8" }).trim();
+
+assert.equal(git("status", "--porcelain"), "", "Commit all changes before preparing a release");
+const tags = git("tag", "--merged", "HEAD", "--list", "v[0-9]*", "--sort=-version:refname")
+  .split("\n").filter(tag => /^v\d+\.\d+\.\d+$/.test(tag));
+assert.equal(version, tags[0]?.slice(1) ?? "0.0.0",
+  "Version is already prepared or release tags are missing. Fetch tags; finish the existing release before preparing another.");
Author	SHA1	Message	Date
ksv741	34b483018b	chore(release): 0.1.1 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 13s Details Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 13s Details	2026-09-16 11:35:55 +03:00
ksv741	cead9dc176	docs: document container deployment and recovery Docs security / security (pull_request) Successful in 6s Details Docs verify / verify (pull_request) Successful in 11s Details Conventional commits / commits (pull_request) Successful in 11s Details Docs security / security (push) Successful in 7s Details Docs verify / verify (push) Successful in 10s Details	2026-09-16 09:41:58 +03:00
ksv741	97069d6f6d	docs: make documentation checks self-contained Docs security / security (pull_request) Successful in 6s Details Docs verify / verify (pull_request) Successful in 11s Details Conventional commits / commits (pull_request) Successful in 16s Details Docs security / security (push) Successful in 9s Details Docs verify / verify (push) Successful in 10s Details	2026-09-15 20:45:40 +03:00
ksv741	c557af4ea5	chore(release): 0.1.0 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 14s Details Docs security / security (push) Successful in 8s Details Docs verify / verify (push) Successful in 16s Details	2026-09-14 07:12:03 +03:00
ksv741	261f1ca6d1	chore: configure releases and develop workflow	2026-09-14 07:10:19 +03:00