Переносит архив `audits/2026-10-11/` (19 файлов) из codex/audit-remediation-2026-10-11 в develop и добавляет точечный allowlist в .gitignore.
766 lines
71 KiB
Markdown
766 lines
71 KiB
Markdown
# WealthLedger — Complexity, Redundancy & Engineering Overhead Audit
|
||
|
||
Дата: 11 октября 2026 года.
|
||
|
||
Метод: `ponytail-audit`, статический анализ owners, consumers, проверок и последствий удаления.
|
||
|
||
## Основание и ограничения
|
||
|
||
Изучены root, `frontend`, `backend`, `docs`, `specs` и обнаруженный отдельный репозиторий `deploy`. Первый отчёт `technical-audit-2026-10-11.md` прочитан. Его функциональные дефекты и уже перечисленные simplification opportunities не включены в новые findings.
|
||
|
||
Основные checkout совпадают с первым аудитом:
|
||
|
||
| Репозиторий | Commit |
|
||
|---|---|
|
||
| frontend | `c882120` |
|
||
| backend | `0ad84ff` |
|
||
| docs | `e6fd4f6` |
|
||
| specs | `fcdc805` |
|
||
|
||
Выполнены чтение, поиск, Git inspection и подсчёты через `rg`. Единственная дополнительная проверка инструментом:
|
||
|
||
```sh
|
||
source "$HOME/.nvm/nvm.sh"
|
||
nvm use --silent
|
||
node node_modules/openapi-typescript/bin/cli.js \
|
||
src/shared/api/spec/openapi.json \
|
||
-o src/shared/api/generated/schema.d.ts \
|
||
--check
|
||
```
|
||
|
||
**Результат: exit 0, установленный `openapi-typescript 7.13.0`.** Проверка не записывает output: сравнение и выход происходят до `mkdirSync`/`writeFileSync` — `frontend/node_modules/openapi-typescript/bin/cli.js:125–134,280–291`.
|
||
|
||
Build, полные verify, тестовые наборы, установки, Docker и deployment не запускались. Финальные `git status --short` всех шести обследованных рабочих деревьев не показали изменений.
|
||
|
||
Время, стоимость CI, bundle size и расход токенов не измерялись.
|
||
|
||
# A. Executive Summary
|
||
|
||
## Главные источники избыточности
|
||
|
||
1. **Обязательный полный локальный workflow для любого code change.**
|
||
|
||
Frontend и backend требуют `npm ci` и полный `verify` перед завершением, независимо от изменённой области. Дополнительные conventions отдельно направляют к typecheck/lint/risk checks. Это расширяет небольшую задачу до полного bootstrap и проверки всего приложения.
|
||
|
||
Evidence: `frontend/.ai/conventions/engineering.md:58–66`, `backend/.ai/conventions/engineering.md:58–66`, `frontend/.ai/conventions/ui.md:165–170`.
|
||
|
||
2. **Повторная работа внутри одной границы проверки.**
|
||
- Frontend `verify` вызывает TypeScript дважды.
|
||
- Backend отдельно typecheck’ит application, хотя test typecheck включает те же application sources.
|
||
- Backend CI собирает приложение в `verify`, затем повторно в `test:e2e`.
|
||
- SQLite runner regression повторяет весь functional suite пять раз ради свойств самого runner.
|
||
|
||
Evidence: `frontend/package.json:26`, `backend/package.json:22–34`, `backend/tsconfig.typecheck.test.json:7–8`, `backend/.gitea/workflows/verify.yml:84–89`, `backend/test/sqlite-regression.cjs:20–22,77–91`.
|
||
|
||
3. **Самописная проверка, уже реализованная установленным инструментом.**
|
||
|
||
`check-openapi.mjs` — 45 строк temp-directory/subprocess/cleanup orchestration для возможности `openapi-typescript --check`. Это наиболее уверенный tooling-cut с сохранением той же гарантии.
|
||
|
||
4. **Production API, поддерживаемые тестовыми consumers.**
|
||
- `useAuthenticatedQueries`: production callers отсутствуют.
|
||
- `InstrumentMetadataService.read`: используется metadata persistence suite; production использует `request`/`savedMany`.
|
||
|
||
Evidence: `frontend/src/shared/api/authenticated-query.ts:15–32,61`, `frontend/src/shared/api/authenticated-query.test.tsx:9–23`, `backend/src/integrations/tbank/instrument-metadata.service.ts:41–63`, `backend/test/tbank-metadata-persistence.e2e-spec.ts:87–382`.
|
||
|
||
5. **Тесты иногда обходят дешёвую существующую boundary.**
|
||
|
||
Чистые преобразования проверяются через fake Prisma transactions или background orchestration; page tests поддерживают fake query-result shapes параллельно существующей MSW boundary.
|
||
|
||
6. **Противоречивая процессная authority.**
|
||
|
||
Локальные инструкции задают opt-in OpenSpec и запрещают audit artifacts в docs. Действующие process specs требуют registry, snapshots и canonical workflow для audit-derived работы. Это создаёт дополнительные artifacts и решения о том, какую инструкцию исполнять.
|
||
|
||
Evidence: `specs/AGENTS.md:3–6`, `docs/AGENTS.md:12–14`, `specs/openspec/specs/project-foundation/spec.md:9–19`, `specs/openspec/specs/audit-remediation-workflow/spec.md:9–49`.
|
||
|
||
## Общая оценка
|
||
|
||
**Масштабный архитектурный рефакторинг не нужен.** Не подтверждена потребность вводить новые interfaces, generic workers, fixture frameworks, архитектурные validators или quality tools.
|
||
|
||
Самые полезные изменения сокращают **число путей, запусков и обязательных artifacts**, сохраняя существующие owners и реальные behavioral proofs.
|
||
|
||
# B. Complexity Inventory
|
||
|
||
## B1. Количественные показатели
|
||
|
||
| Метрика | Результат | Метод и ограничения |
|
||
|---|---:|---|
|
||
| Package script entries | **67** | Root 3; frontend 25; backend 27; docs 5; specs 5; UI/icons workspace builds 2. Это entrypoints и aliases, не 67 самописных программ |
|
||
| Custom script/adapter/harness/plugin files | **21** | Frontend 6; backend 10; docs 2; specs 1; deploy 2. Git hooks и декларативные configs отдельно |
|
||
| Custom Git hooks | **3** | Frontend pre-commit/commit-msg; specs commit-msg. Generated Husky files и Git samples исключены |
|
||
| Custom release hook declarations | **4** | Frontend/backend/docs/specs `after:git:init`; root такого helper не имеет |
|
||
| Frontend `verify` command stages | **12** | Разделение команды на последовательные стадии; вложенные workspace builds отдельно не разворачиваются |
|
||
| Backend `verify` command stages | **6** | Lint, lint-config tests, два typecheck, unit coverage, build |
|
||
| Operational verification families | **29** | Группы в разделе C; не количество отдельных ESLint rules или test assertions |
|
||
| Участки повторной/малоинформативной проверки | **7** | Frontend TS; backend TS subset; backend rebuild; full-suite runner repetition; preset-parity meta-tests; docs/specs clean-checkout diff checks |
|
||
| Test files frontend/backend | **63 / 59** | Backend: 39 colocated specs + 20 integration suites. Browser files входят в frontend 63 |
|
||
| Test files вместе с deploy harness | **123** | 122 TS/TSX test files + `deploy/tests/deploy.sh`; CJS инфраструктурные проверки здесь отдельно |
|
||
| Production TS/TSX | **34 465 строк** | Frontend 16 967; backend 17 498. Generated, stories, fixtures/test support исключены |
|
||
| Test TS/TSX | **23 679 строк** | Frontend 11 537; backend 12 142 |
|
||
| Test/production ratio | **≈ 0,69** | Физические строки, включая comments/blank lines. Не критерий качества архитектуры |
|
||
| Frontend stories / support | **18 файлов / 6 файлов** | 1 855 / 263 строки соответственно; не включены в test LOC |
|
||
| Классифицированные factory/polling definitions | **не менее 18** | Frontend 3 общие factories; backend 4 service factories, 4 deferred helpers, 7 polling helpers. Локальные render/helpers не полностью включены |
|
||
| Frontend module mocks | **4 в 3 файлах** | `vi.mock`; не учитывает spies и MSW handlers |
|
||
| Backend module mocks | **18 в 12 unit files** | `jest.mock`; сам count не является finding |
|
||
| Snapshot assertions | **0 найдено** | Поиск `toMatchSnapshot`, `toMatchInlineSnapshot`, `toMatchFileSnapshot`, `__snapshots__` в обследованных test sources |
|
||
| Backend runtime SHA/HMAC mechanisms | **8** | 7 `createHash` emission sites + один signed-cursor mechanism с encode/decode HMAC. Password bcrypt отдельно |
|
||
| Gitleaks archive checksum steps | **4** | Одна download-integrity policy в четырёх независимых repos |
|
||
| OCI digest publication paths | **2** | Frontend/backend image workflows |
|
||
| Подтверждённые точки удаления | **18** | Перечень в G; считаются удаляемые элементы/стадии, не файлы |
|
||
| Обследованные single-production-consumer abstractions | **6 примеров** | RouteTransition, InstrumentSearch, useInstrumentSearch, metadata repository `work`, `queueSnapshot`, `TBANK_ACCESS`. Это выборка, не полный census |
|
||
|
||
LOC и количества используются для описания масштаба. Они **не доказывают** избыточность.
|
||
|
||
## B2. Все custom scripts и исполняемые adapters
|
||
|
||
| Файл | Назначение и consumers; автоматизация | Пересечение / последствия удаления / решение |
|
||
|---|---|---|
|
||
| `frontend/scripts/check-openapi.mjs:1–45` | Freshness generated types; вызывается `openapi:check` и `verify` | Полностью покрывается native `--check`. **Удалить реализацию, сохранить проверку** |
|
||
| `frontend/scripts/check-release.cjs:1–24` | Manifest version ↔ reachable stable tag; release-it hook | Не эквивалентен `requireCommits`. **KEEP**: предотвращает повторную подготовку версии |
|
||
| `frontend/scripts/test-eslint.mjs:23–395` | Config/rule/fixer proofs; автоматически из `test:lint`/`verify` | Смешивает проектные checks и exhaustive preset parity. **SIMPLIFY**, сохранять probes реальных exceptions/custom fixers |
|
||
| `frontend/scripts/test-pre-commit.mjs:17–79` | Staged-index scanning, redaction, fail-closed; security CI и ручная команда | Full-history scan не доказывает index behavior. **KEEP** |
|
||
| `frontend/scripts/check-image-publication.cjs:15–88` | Модель retry после post-push failure, exact digest/revision/smoke | Автоматических callers не найдено. Не считать dead только из-за этого: самостоятельный workflow proof. **KEEP как targeted check**, не обязательный gate каждой правки |
|
||
| `frontend/eslint-rules.mjs:1–178` | Два custom ESLint rules; загружается lint config | Часть правил — formatting/обязательная форма кода. **SIMPLIFY**, не заменять новым analyzer |
|
||
| `backend/scripts/check-release.cjs:1–11` | Version/tag guard; release-it hook | Штатный release guard не покрывает эту policy. **KEEP** |
|
||
| `backend/scripts/generate-openapi.cjs:1–41` | Swagger generation из built app без deployment config | Package command и contract integration suite. TypeScript сам контракт не генерирует. **KEEP** |
|
||
| `backend/test/sqlite.cjs:1–95` | Per-suite temporary DB, migrations, subprocesses, signal cleanup | Все SQLite entrypoints. Обычный Jest не гарантирует DB isolation. **KEEP** |
|
||
| `backend/test/sqlite-regression.cjs:1–96` | Runner isolation/failure/signal proof; ручной README entrypoint | Пять полных успешных suite runs избыточны для runner properties. **SIMPLIFY область прогонов** |
|
||
| `backend/test/e2e-env.cjs:1–17` | Отказ от не-изолированной DB, synthetic credentials | Jest setup и crash fixture. **KEEP**: защита данных developer |
|
||
| `backend/test/fixtures/tbank-sync-crash.cjs:1–86` | Управляемый kill процесса на durable boundaries | Consumer — operations persistence suite. In-process mocks не заменяют crash proof. **KEEP** |
|
||
| `backend/test/eslint-config.cjs:9–146` | Profile scope, generated ignores, import exceptions | Автоматически `test:lint`. **SIMPLIFY**: project scope/exception checks полезны; поведение каждой library rule не нужно доказывать заново |
|
||
| `backend/test/runtime-check.cjs:1–8` | Проверяет строку start command, наличие dist и require generated client | Runtime callers не найдены; config test использует имя как fixture path. Real image smoke сильнее. **DELETE** |
|
||
| `backend/test/container-smoke.cjs:1–77` | Native modules/assets, migration, non-root/read-only runtime, auth/restart | Image publication и manual package entrypoint. Host build это не доказывает. **KEEP** |
|
||
| `backend/test/bank-cards-durability.cjs:1–219` | Historical build → migration → restart → rollback → restore | Risk-triggered manual entrypoint. Fresh DB suites не заменяют historical compatibility. **KEEP** |
|
||
| `docs/scripts/check-release.cjs:1–10` | Clean status + version/tag guard | Release hook. Porcelain видит untracked files; native clean guard не полностью эквивалентен. **KEEP** |
|
||
| `docs/.markdownlint-rule-relative-links.cjs:1` | Adapter `.default` установленного link rule | Оба markdownlint запуска. Не собственный validator. **KEEP** |
|
||
| `specs/scripts/check-release.cjs:1–10` | Clean status + version/tag guard | Release hook. **KEEP** |
|
||
| `deploy/deploy.sh:1–192` | Tagged snapshot, preflight, lock/pending, backup, migration/readiness | Ручной запуск, затем self-handoff к tagged script. **KEEP** |
|
||
| `deploy/tests/deploy.sh:1–251` | Real Git/files/locks + Docker double; optional bind-restore proof | Ручной entrypoint. **KEEP**: orchestration и bind semantics не доказываются application tests |
|
||
|
||
**Не установлена необходимость централизовать десятистрочные release helpers между независимыми repos.** Общий tooling package добавит dependency boundary и release ownership ради небольшого копирования.
|
||
|
||
## B3. Package scripts: роль и оправданность
|
||
|
||
Определения: `package.json:8–12`, `frontend/package.json:9–34`, `backend/package.json:11–38`, `docs/package.json:8–14`, `specs/package.json:8–14`.
|
||
|
||
| Группа entrypoints | Consumers и оценка |
|
||
|---|---|
|
||
| Root `release:preview`, `release:prepare`, `commitlint` | Release/operator и commits CI. Штатные CLI wrappers; оставить |
|
||
| Frontend `dev`, `dev:catalog`, `build:catalog`, `preview:catalog`, `preview` | Developer/catalog lifecycle. Разные outputs; не дублируют одну проверку |
|
||
| Frontend `build`, `build:packages`, `typecheck` | Application/workspace compilation. Packages нужны из-за dist-based exports; проблема — частота повторного запуска |
|
||
| Frontend `lint`, `lint:eslint`, `lint:fix` | Alias, check, explicit edit. `lint` alias сам по себе не требует удаления |
|
||
| Frontend `test`, `test:run`, `test:coverage`, `test:lint` | Watch, one-shot, coverage, tooling tests. Различимые режимы; уменьшать обязательность, не механически удалять entrypoints |
|
||
| Frontend `openapi:generate`, `openapi:check` | Explicit generation и read-only freshness. Оставить оба; check реализовать native CLI |
|
||
| Frontend `knip`, `deps`, `deps:storybook` | Dead usage, production boundaries, transitive catalog isolation — разные свойства |
|
||
| Frontend `verify`, `prepare`, release pair, `commitlint` | Aggregate gate, Husky bootstrap, release и commit policy. `verify` упростить |
|
||
| Backend `start`, `start:dev`, `start:debug`, `start:prod` | Различные runtime/debug modes; production также задаётся Docker |
|
||
| Backend `build`, `openapi:generate` | Prisma/Nest output и public artifact; оставить standalone completeness |
|
||
| Backend `format`, `lint`, `lint:check`, `lint:fix` | Aliases и явный check/edit. Небольшая стоимость, нет причины строить новые wrappers |
|
||
| Backend `typecheck:app`, `typecheck:test` | Оставить targeted entrypoints; в полном gate достаточно test superset |
|
||
| Backend `test`, `test:watch`, `test:cov`, `test:debug` | Runner modes; текущая необходимость debug не опровергнута отсутствием CI caller |
|
||
| Backend `test:e2e`, `test:sqlite`, `test:performance`, `test:openapi-contract` | Full functional, auth/cards subset, отдельный benchmark, отдельный contract proof. Сокращать repeated build при orchestration, не смешивать наборы |
|
||
| Backend `test:container`, `test:durability` | Image/historical-data boundaries; risk-triggered |
|
||
| Backend `verify`, `test:lint`, release pair, `commitlint` | Aggregate/tooling/release policy; упростить aggregate |
|
||
| Docs `lint`, `verify`, release pair, `commitlint` | Содержательный Markdown gate. Два lint запуска обрабатывают разные наборы с разными changelog rules |
|
||
| Specs `verify`, release pair, `commitlint`, `prepare` | `verify` полезен только как local diff check в нынешнем виде; `prepare` незаметно меняет hooksPath |
|
||
| UI/icons `build` | Vite bundle + TypeScript declarations для двух реально используемых packages |
|
||
|
||
## B4. Hash, SHA, freshness и integrity
|
||
|
||
| Группа / механизм | Реальный failure mode | Альтернативные защиты и риск удаления | Решение |
|
||
|---|---|---|---|
|
||
| **Business idempotency:** bank intent fingerprint | Повтор запроса после lost response; тот же ID с другим содержимым | Unique ID предотвращает вторую запись, но не различает повтор и конфликтующий intent. `backend/src/modules/banking/bank-cards/application/bank-card-input.ts:74–81`, `bank-cards.service.ts:76–81`, `bank-operations.service.ts:216–223` | **KEEP** |
|
||
| **Security:** refresh-token SHA и password bcrypt | Чтение БД не должно раскрывать reusable token/password; rotation CAS | CAS не заменяет безопасное хранение. `backend/src/modules/auth/application/auth.service.ts:52,110–133,180,204–205` | **KEEP** |
|
||
| **Cursor integrity:** HMAC + revision/filter binding | Подмена cursor или применение к изменённому dataset/filter | Ownership проверяет доступ, но не подписанность и согласованность cursor. `backend/src/modules/investments/operations/application/brokerage-operations.service.ts:347–388`, `backend/src/modules/investments/operations/infrastructure/brokerage-operations.repository.ts:128–143` | **KEEP** |
|
||
| **Work identity:** hash canonical operations intervals | Разные диапазоны не должны случайно объединяться; одинаковые intents coalesce | Возможна строковая canonical identity, но существующий механизм короткий и связан с durable keys. `backend/src/modules/investments/operations/infrastructure/brokerage-operations.repository.ts:254–269` | **KEEP**, нет доказанного выигрыша от замены |
|
||
| **Resource identity/revisions:** accounts, candles, operations | Согласованность metadata и identity текущей read-model | Это public/runtime metadata, не development gate. `backend/src/modules/investments/brokerage-accounts/brokerage-accounts.service.ts:42–54`, `backend/src/modules/investments/instruments/infrastructure/candle.repository.ts:41–52`, `backend/src/modules/investments/operations/application/brokerage-operations.service.ts:238–239` | **KEEP до установленного contract-safe cut** |
|
||
| **Freshness metadata/TTL** | Отсутствие данных, stale и confirmed completeness нельзя смешивать | Coverage/revisions защищают другие свойства. `backend/src/modules/investments/investment-resource.mapper.ts:31–64,78–88`, `backend/src/integrations/tbank/tbank-source.policy.ts:1–21` | **KEEP**; удалить только неиспользуемый `candleTail` key |
|
||
| **Data integrity:** SQLite integrity/FK checks | Повреждение/невалидные связи после migration/restore | Unit mocks и successful startup недостаточны. `backend/test/bank-cards-durability.cjs:109–118,190–205`, `backend/test/container-smoke.cjs:58–64` | **KEEP на соответствующих boundaries** |
|
||
| **Generated artifacts:** local OpenAPI → types | Committed types расходятся с предоставленным snapshot | TS не сравнивает types с JSON. Native `--check` покрывает custom script | **SIMPLIFY implementation, KEEP guarantee** |
|
||
| **Runtime OpenAPI generator parity** | Generator отличается от configured app schema | Frontend freshness этого не доказывает. `backend/test/openapi-contract.e2e-spec.ts:108–156` | **KEEP** |
|
||
| **Download integrity:** Gitleaks tarball SHA-256 | Исполнение не тех bytes скачанного binary | HTTPS/version URL не эквивалентны pinned checksum. Frontend/backend verify `52–58`, docs/specs security `24–30` | **KEEP** |
|
||
| **Image content identity:** OCI digest/revision | Smoke проверяет другой image, tag изменён, retry скрывает несовпадение | Host tests не доказывают bytes опубликованного image. `frontend/.gitea/workflows/image.yml:46–62`, `backend/.gitea/workflows/image.yml:42–55` | **KEEP** |
|
||
| **Process identity:** release manifest/tag, deployment Git commit | Повторная подготовка версии; deployment не из выбранного tagged snapshot | Native release-it покрывает лишь часть; рабочий checkout не immutable input. `deploy/deploy.sh:26–39` | **KEEP** |
|
||
| **Process visual SHA tables** | Approved export изменён отдельно от approval input | Git commit binding может покрывать Git-only delivery; отдельно передаваемые exports — другой риск. `specs/openspec/schemas/wealth-ledger-sdd-v2/schema.yaml:322–330`, `specs/openspec/schemas/wealth-ledger-sdd-v2/templates/design.md:38–61` | **Условный SIMPLIFY**, не безусловное удаление |
|
||
| **npm lockfile integrity** | Package bytes не соответствуют lockfile | Стандартный механизм npm, не custom framework | **KEEP** |
|
||
|
||
**Самописных self-hash/fingerprint validators для planning Markdown или hash-gated reuse CI результатов не обнаружено.** Требования в prose не равны действующей автоматизации.
|
||
|
||
# C. Redundancy Matrix
|
||
|
||
## Фактическая цепочка
|
||
|
||
### Frontend
|
||
|
||
```text
|
||
Developer / AI:
|
||
npm ci
|
||
targeted typecheck/lint/tests
|
||
full verify
|
||
|
||
pre-commit:
|
||
staged Gitleaks → lint-staged ESLint → deps → build:packages
|
||
|
||
CI:
|
||
commitlint → history Gitleaks / audit / hook proof
|
||
→ full verify
|
||
|
||
full verify:
|
||
packages → OpenAPI freshness → TS → ESLint → lint-config tests
|
||
→ Vitest coverage → Knip → production graph → story graph
|
||
→ TS again → application build → Storybook build
|
||
```
|
||
|
||
Источники: `frontend/.ai/conventions/engineering.md:58–66`, `frontend/.husky/pre-commit:1–3`, `frontend/.gitea/workflows/verify.yml:17–100`, `frontend/package.json:26`.
|
||
|
||
### Backend
|
||
|
||
```text
|
||
Developer / AI:
|
||
npm ci → targeted checks → full verify → risk-specific suites
|
||
|
||
CI:
|
||
commitlint → history Gitleaks / audits
|
||
→ Prisma generate → verify
|
||
→ test:e2e → build again → isolated SQLite suites
|
||
```
|
||
|
||
Источники: `backend/.ai/conventions/engineering.md:58–66`, `backend/.ai/conventions/testing.md:38–57`, `backend/.gitea/workflows/verify.yml:84–89`, `backend/package.json:28–34`.
|
||
|
||
### Docs / specs / deploy
|
||
|
||
- Docs: Markdown/link lint + local diff check; CI content/security/commit checks.
|
||
- Specs: local `git diff --check`; CI устанавливает Node dependencies и повторяет эту команду на чистом checkout. Native OpenSpec validation документирована отдельно, но не вызывается этим job.
|
||
- Deploy: отдельный ручной lifecycle и shell harness, вне application CI.
|
||
|
||
## Матрица
|
||
|
||
Частота ниже — **сценарная**, не измеренная: один local final verify, один commit и один CI event. Для checks outside этой цепочки указан их фактический trigger.
|
||
|
||
| Mechanism | Purpose / consumers | Overlap и частота | Cost | Recommendation | Confidence |
|
||
|---|---|---|---|---|---|
|
||
| 1. TypeScript | Source/tooling diagnostics; local/CI | FE: 4 calls в двух verify. BE: по 2 app/test calls; test включает app | Повтор compiler invocation; incremental может удешевлять | Убрать FE второй call; BE app из aggregate | High |
|
||
| 2. ESLint | Syntax, async, security/style policies | FE: 2 full + staged hook; scopes различаются | Typed lint всего проекта | KEEP full CI; local scoped; staged сохранить | High |
|
||
| 3. Lint-config tests | Scope/exceptions/custom fixers | 2 full executions; часть заново доказывает presets | Synthetic lintText/config calculations | Сократить generic parity; project probes по tooling trigger | High |
|
||
| 4. Knip | Dead exports/dependencies/entries | 2 executions; TS не эквивалентен | Whole-project analysis | KEEP CI; local по соответствующему изменению | High |
|
||
| 5. Production dependency graph | FSD/package/test boundaries, cycles | FE: local + hook + CI = 3 | Hook дополнительно builds packages | Перенести из каждого commit в scoped local/CI | High |
|
||
| 6. Story reachable graph | Catalog не достигает application data | 2 executions; base config включён, но graph semantics отличаются | Второй graph traversal | KEEP: не объединять вслепую | High |
|
||
| 7. Generated OpenAPI freshness | Snapshot ↔ types bytes | 2 executions; TS не заменяет | Custom temp/subprocess machinery | Native `--check` | High |
|
||
| 8. Unit/RTL/MSW tests | Own behavior, transport/UI results | Обычно 2 full runs; local/CI разные trust boundaries | Whole suite local | Targeted local, full CI | High |
|
||
| 9. Browser layout | Реальная геометрия narrow/wide | Два viewport instances на run | Chromium/runtime setup | KEEP для geometry changes и CI | High |
|
||
| 10. Coverage | FE floor; BE report | По одному сбору на full test run | Instrumentation/reporting | CI report; local targeted без coverage | High |
|
||
| 11. Application build | Emission/bundling/assets | BE CI два builds подряд; Docker — отдельная boundary | Prisma/Nest/Vite work | Убрать same-job rebuild; Docker оставить | High |
|
||
| 12. Storybook build | Catalog bundle | Local/CI по одному; app build не заменяет | Отдельный bundle | CI/catalog-risk scope | High |
|
||
| 13. SQLite HTTP/integration | DB constraints, guards, contract | CI 19 functional suites; standalone 20-я performance отдельно | Per-suite migration + Jest | KEEP independent DB isolation | High |
|
||
| 14. Runner regression | Isolation, cleanup, signals | Пять успешных `--all` + failure/signal paths вручную | 95 successful suite executions | Representative two-suite runs | High facts / Medium cut |
|
||
| 15. Historical durability | Migration/rollback/restore | Schema/data-risk trigger | Separate historical build/app runs | KEEP risk-triggered | High |
|
||
| 16. Image smoke | Actual image runtime/assets/persistence | Publication/manual; host checks не эквивалентны | Docker lifecycle | KEEP | High |
|
||
| 17. Publication model test | Retry/digest failure branches | Только explicit invocation найден | Stateful command double, YAML block extraction | KEEP focused, не every-change gate | Medium |
|
||
| 18. Staged secret scan | Не допустить secret в commit | Каждый FE commit | Index scan | KEEP; history scan позднее | High |
|
||
| 19. History secret scan | Secrets во всей Git history | PR/push/schedule | Full-history scan/download | KEEP; оптимизировать только по измерениям | High |
|
||
| 20. Hook security proof | Index vs worktree, redaction/fail-closed | FE security CI | Temp Git repo/real scanner | KEEP; разные гарантии с №19 | High |
|
||
| 21. Dependency audit | Known advisories | CI; BE runtime/dev thresholds различаются | Network/advisory processing | KEEP; overlap не доказан одинаковыми properties | High |
|
||
| 22. Commitlint | PR title и retained commits | CI 2 invocations; local commit hook дополнительно | App repos устанавливают полный manifest для job | KEEP policy; не добавлять custom parser | High |
|
||
| 23. Release preparation guard | Branch/tree/version lifecycle | Explicit release prepare | Несколько Git queries | KEEP; preview не считать proof custom hook | High |
|
||
| 24. Image version/digest binding | Tag/package/lock/revision/published bytes | Release-tag workflow | Metadata/registry checks | KEEP release boundary | High |
|
||
| 25. Scanner checksum | Downloaded scanner bytes | 4 repo-local security paths | Один hash command | KEEP | High |
|
||
| 26. Markdown/link checks | Docs syntax/local targets | 2 disjoint lint commands/run | 50 Markdown files | KEEP; не второй custom link checker | High |
|
||
| 27. `git diff --check` | Working diff whitespace/conflict markers | Local useful; docs/specs CI clean checkout малоинформативен | Specs CI ещё устанавливает deps | KEEP local; удалить пустой CI work | High |
|
||
| 28. Native OpenSpec validation | Schema/change/spec structure | Manual; v2 instructions требуют после 7 stages | Repeated CLI/context work | Только explicitly selected SDD; proportional scope | High facts / Medium policy |
|
||
| 29. Deploy preflight/lifecycle tests | Lock, backup, ordering, failure cleanup | Manual deploy/harness | Docker doubles/real locks/files | KEEP | High |
|
||
|
||
### Важные разграничения
|
||
|
||
- **Local и CI не объявлены дубликатами только потому, что запускают одинаковую команду.** Сокращается обязательный local scope, CI остаётся независимой проверкой.
|
||
- Production и Storybook dependency-cruiser отличаются `tsPreCompilationDeps: true/false`: `frontend/dependency-cruiser.cjs:78–87`, `frontend/.storybook/dependency-cruiser.cjs:22`. Один простой запуск не доказан эквивалентным двум.
|
||
- OpenAPI generator parity и consumer type freshness проверяют разные отношения.
|
||
- Coverage, browser layout и JSDOM behavior не взаимозаменяемы.
|
||
|
||
# D. SOLID / DRY / KISS / YAGNI Findings
|
||
|
||
## SRP
|
||
|
||
### D1. Test-only orchestration внутри production metadata service
|
||
|
||
`InstrumentMetadataService.read` совмещает access, saved lookup, demand start и work lookup, но production callers используют отдельные existing methods.
|
||
|
||
- Owner: `backend/src/integrations/tbank/instrument-metadata.service.ts:41–63`.
|
||
- Production примеры: `backend/src/modules/investments/portfolio/application/portfolio.service.ts:122–123,275–283,309–315`, `backend/src/modules/investments/operations/application/brokerage-operations.service.ts:213–216`, `backend/src/modules/investments/upcoming-events/upcoming-events.service.ts:200–206`.
|
||
- Test consumer: `backend/test/tbank-metadata-persistence.e2e-spec.ts:87–382`, 38 call sites.
|
||
|
||
**Вывод:** убрать совмещённый API после перевода тестов на production-used boundary. Не удалять persistence suite и её concurrency/restart proofs.
|
||
|
||
### D2. Portfolio имеет ложную DI-зависимость и два имени одной операции
|
||
|
||
- Неиспользуемый `TbankMembershipService` constructor dependency: `backend/src/modules/investments/portfolio/application/portfolio.service.ts:9–18,45–53`.
|
||
- Public `request` → private `queueSnapshot` без дополнительной policy: тот же файл, `234–243`.
|
||
- Тест обходит public operation и читает private repository: `backend/test/tbank-value-history.e2e-spec.ts:99–111,247–256,307–313`.
|
||
|
||
**Вывод:** один public `request`, без unused DI; тест получает существующий repository provider напрямую. Не дробить queue/publication lifecycle.
|
||
|
||
## OCP / YAGNI
|
||
|
||
### D3. Plural authenticated-query boundary существует ради теста
|
||
|
||
`frontend/src/shared/api/authenticated-query.ts:15–32,61`; единственный consumer — `frontend/src/shared/api/authenticated-query.test.tsx:9–23`.
|
||
|
||
Тестовая plural branch содержит один query и берёт `[0]`. Приложение потребляет singular hook.
|
||
|
||
**Вывод:** удалить plural implementation и вариант test matrix. Singular auth gating оставить.
|
||
|
||
### D4. InstrumentSearch сохраняет stock-вариант без product consumer
|
||
|
||
- Union contract: `frontend/src/features/instrument-search/ui/InstrumentSearch/InstrumentSearch.view.tsx:18–31`.
|
||
- Единственный production renderer consumer — BondsPage: `frontend/src/pages/bonds/ui/BondsPage/BondsPage.view.tsx:26–113`.
|
||
- Stock-конфигурация используется тестом: `frontend/src/features/instrument-search/ui/InstrumentSearch/InstrumentSearch.test.tsx:21–29`.
|
||
|
||
**Вывод:** специализировать current renderer под bond, сохранив debounce, URL/search states и presentation cases. Не объединять bond search со stock screener.
|
||
|
||
### D5. Малые невостребованные элементы поверхности
|
||
|
||
| Элемент | Evidence | Минимальное действие |
|
||
|---|---|---|
|
||
| `history.retry` | `frontend/src/entities/broker-operation/model/useBrokerageOperationHistory.ts:52–61,76`; все три VMs его не читают | Удалить action; automatic invalid-cursor recovery `37–50` оставить |
|
||
| `isFetching` input | `frontend/src/shared/lib/initial-availability.ts:10–16,18–46`; не читается | Удалить из type, пяти callers и fixtures |
|
||
| `membershipWork()` | `backend/src/integrations/tbank/tbank-access.service.ts:90–97`; callers не найдены | Удалить метод, не одноимённое repository result field |
|
||
| `candleTail` TTL key | `backend/src/integrations/tbank/tbank-source.policy.ts:3–8`; production references отсутствуют | Удалить key; настоящую candle coverage/tail policy оставить |
|
||
| `HourlySyncSectionDto` | `backend/src/modules/investments/tbank-sync/tbank-sync.dto.ts:232–250`; current problems DTO другой, `271–272` | Удалить непривязанный class |
|
||
| Export `totalsByCurrency` | `backend/src/modules/investments/portfolio/infrastructure/tbank-portfolio.mapper.ts:56,109–141`; используется внутри файла | Удалить export, не calculation |
|
||
|
||
## ISP / DIP
|
||
|
||
### D6. String DI alias для единственной реализации
|
||
|
||
- Structural contract/string token: `backend/src/modules/investments/instruments/stocks/application/stock-screener.service.ts:49–63`.
|
||
- Единственный `useExisting` alias: `backend/src/modules/investments/instruments/instruments.module.ts:23–25`.
|
||
- Alternative implementations/overrides token не найдены.
|
||
|
||
**Вывод:** injection по существующему concrete class token. Узкий type можно сохранить через `Pick`, как уже сделано в `backend/src/modules/investments/tbank-connection/tbank-connection.service.ts:11–19`.
|
||
|
||
Это небольшой cleanup, не повод создавать interface.
|
||
|
||
### D7. FormProvider без context consumers
|
||
|
||
`frontend/src/features/auth/ui/AuthForm/AuthForm.tsx:50–86`: поля используют локальный `methods.register`, descendants не используют form context.
|
||
|
||
Но `frontend/.ai/conventions/ui.md:128–129` предписывает `FormProvider`.
|
||
|
||
**Вывод:** сначала сделать existing rule условным по наличию context consumers, затем убрать provider здесь. Не создавать consumers ради оправдания wrapper.
|
||
|
||
## LSP
|
||
|
||
Для основной business architecture **практически неприменим**: нет собственной иерархии взаимозаменяемых domain implementations. Concrete providers/repositories — не нарушение LSP или DIP.
|
||
|
||
DTO inheritance может сохранять Swagger metadata/schema identity — например `backend/src/modules/investments/instruments/bonds/presentation/bond.dto.ts:5–16`. Удалять пустые DTO subclasses по визуальному сходству нельзя.
|
||
|
||
## DRY
|
||
|
||
Подтверждены узкие дубли knowledge/assertions:
|
||
|
||
- Anonymous `/accounts` redirect повторён table case и standalone case: `frontend/src/app/routes/AppRoutes/AppRoutes.test.tsx:35–61`.
|
||
- Failed-image behavior повторяется на page level, хотя сильнее проверен EntryCard: `frontend/src/pages/account-events/ui/AccountEventsPage/AccountEventsPage.test.tsx:166–169`, `frontend/packages/ui/src/EntryCard/EntryCard.test.tsx:24–63`.
|
||
- Process authority повторяет approval/cascade/context policies в canonical specs, schemas и config: `specs/openspec/config.yaml:55–58`, `specs/openspec/specs/openspec-authority-and-lifecycle/spec.md:53–80`, `specs/openspec/schemas/wealth-ledger-sdd-v2/schema.yaml:554–566,625–642`.
|
||
|
||
Не рекомендовано объединять:
|
||
- короткие local money fixtures;
|
||
- worker implementations с разной publication semantics;
|
||
- repo-local release configs;
|
||
- похожие UI/domain states с разными responsibilities.
|
||
|
||
## KISS
|
||
|
||
### D8. Motion dependency ради одного opacity transition
|
||
|
||
- Единственный source consumer: `frontend/src/app/routes/RouteTransition.tsx:3–30`.
|
||
- Единственный caller: `frontend/src/app/routes/RouteFallback.tsx:70–81`.
|
||
- Dependency: `frontend/package.json:52`.
|
||
|
||
**Минимум:** локальный CSS fade-in с `prefers-reduced-motion`; сохранить `key={pathname}` и current mount boundary.
|
||
|
||
Потенциально удаляется **одна runtime dependency**. Bundle savings не измерены. Это replacement opportunity, а не unused package в текущем коде.
|
||
|
||
# E. Test Suite Complexity
|
||
|
||
## E1. Setup architecture
|
||
|
||
### Frontend
|
||
|
||
Общая инфраструктура небольшая:
|
||
|
||
- `frontend/src/test/query.tsx:5–24`: две Query factories, consumers — 7 и 20 test files.
|
||
- `frontend/src/test/resource.ts:6–25`: одна resource-envelope factory, 20 test consumers.
|
||
- `frontend/src/test/setup.ts:13–48`: MSW lifecycle, RTL cleanup, auth reset, browser substitutes.
|
||
- `frontend/src/test/server.ts:1–7`: прямой MSW server.
|
||
- `frontend/src/test/storybook.test.tsx:19–57`: isolation checks для девяти story modules.
|
||
|
||
**Общего самописного test framework не обнаружено.** Размножение локальных render/provider setups не требует автоматически создавать универсальный render helper.
|
||
|
||
### Backend
|
||
|
||
- 20 integration suites: 14 AppModule, 5 direct repository/service boundaries, одна migration suite.
|
||
- 14 Nest bootstrap sites, 23 overrideProvider call sites.
|
||
- 4 service factories, 4 deferred definitions, 7 polling helpers.
|
||
- 8 CJS инфраструктурных/helper файлов, перечисленных в B2.
|
||
|
||
Fresh DB на suite, synthetic credentials и signal cleanup — необходимая стоимость. Не рекомендовано объединять все suites в общую DB ради меньшего setup.
|
||
|
||
## E2. Участки для сокращения
|
||
|
||
В таблице ниже сокращённые frontend filenames принадлежат указанным page/component directories; backend filenames — `src/modules` или `test` по полным путям в разделах D и H.
|
||
|
||
| Набор | Что защищает | Лишняя подготовка / overlap | Что теряется и решение |
|
||
|---|---|---|---|
|
||
| `frontend/src/pages/account-events/ui/AccountEventsPage/AccountEventsPage.test.tsx:13–28,40–61,83–205` | Route scope, loading/busy, events/empty/error presentation | Два module mocks и пять fake query shapes через `as never`; соседняя `AccountEventsPage.filters.test.tsx:50–108` уже использует MSW | **Упростить**, не удалять outcomes. Network cases — existing MSW; presentation-only — existing view |
|
||
| `backend/src/modules/banking/bank-cards/application/get-bank-summary.use-case.spec.ts:11–48` | Category mapping, точное `1.23`, inconsistent category rejection | Fake Prisma tx + настоящий repository, хотя use case вызывает только `summaryData()` | Mock ближайшую repository boundary. DB proof не теряется: fake tx его не обеспечивал |
|
||
| `backend/src/modules/investments/portfolio/application/portfolio.service.spec.ts:48–165` | Signed nanos, unknown type, cash/quantity/currency mapping | Background request, polling и `publish.mock.calls` для чистого mapper result | Первые два cases напрямую через existing `mapPortfolio`; orchestration/integration proof оставить |
|
||
| `backend/src/modules/investments/operations/presentation/brokerage-operations.controller.spec.ts:1–18` | Передача args в mock service | Prisma mock, casts, assertion прямого вызова; configured HTTP cases покрывают account/query/access | **Удалить**. HTTP proof: `backend/test/tbank-ledger-local.e2e-spec.ts:113–137,194–227,336–366`, `backend/test/all-accounts.e2e-spec.ts:63–104` |
|
||
| `frontend/src/app/routes/AppRoutes/AppRoutes.test.tsx:55–61` | Anonymous redirect | Более сильный table case уже на `35–53` | **Удалить standalone case** |
|
||
| `frontend/src/pages/account-events/ui/AccountEventsPage/AccountEventsPage.test.tsx:166–169` | Image error fallback | EntryCard test проверяет также same-source rerender/new-source reset | Удалить только error exercise; event→logo/initial assertions оставить |
|
||
| `backend/test/tbank-metadata-persistence.e2e-spec.ts:87–382` | Reuse, coalescing, privacy, late publication, reopen, batch lookup | Сценарии завязаны на production-unused `read()` | **Перевести boundary**, не удалить suite |
|
||
| `backend/test/bank-cards.e2e-spec.ts:371–389,710–753` | Rename/default role, durability, FK/unique | Три declarations зависят от предыдущих tests и их category state | Сделать три cases самодостаточными существующим `createCard`; не fixture framework |
|
||
| `backend/test/sqlite-regression.cjs:20–22,77–91` | Runner isolation/cleanup/signals | Пять повторов всех 19 functional suites | По две representative suites/run; canonical full functional CI оставить |
|
||
| `frontend/scripts/test-eslint.mjs:148–202` | Все recommended plugin rules включены | Exhaustive parity каждой library preset | Удалить blanket parity; оставить project exceptions/scopes/custom behavior probes |
|
||
|
||
## E3. Assertions против стоимости setup
|
||
|
||
Наиболее явные несоразмерности:
|
||
|
||
- **18 строк controller unit** поддерживают исключительно mock delegation.
|
||
- **Две mock layers + пять query shapes** конкурируют с уже существующей HTTP boundary в одном page area.
|
||
- **Пять полных SQLite runs** защищают свойства runner, не пять разных domain scenarios.
|
||
- **Fake Prisma transaction** требуется для двух assertions чистого summary use case.
|
||
|
||
Большие financial fixtures или длинный crash setup сами по себе не плохи: они могут защищать boundary, недоступную дешёвому test level.
|
||
|
||
## E4. Что оставить
|
||
|
||
- Денежные unit cases: signed nanos, значения выше `2^53`, currencies, unknown≠zero.
|
||
- Real SQLite CAS/transactions/replay/refund constraints.
|
||
- Session transport/generation fencing.
|
||
- Metadata/candle/operations late-publication и restart/crash cases.
|
||
- Configured HTTP guards/pipes/cookie/status tests.
|
||
- Browser geometry.
|
||
- Historical migration/rollback/restore.
|
||
- Story isolation, когда она доказывает отсутствие application network/storage access.
|
||
|
||
Примеры: `backend/src/modules/banking/bank-cards/domain/bank-card.calculations.spec.ts:46–159`, `backend/test/bank-cards.e2e-spec.ts:462–523,622–683`, `backend/test/app.e2e-spec.ts:161–213`, `backend/test/tbank-operations-persistence.e2e-spec.ts:74–100`.
|
||
|
||
**Не установлено, какие tests были созданы исключительно ради coverage.** Frontend floors (`frontend/vitest.config.ts:19–24`) создают constraint, но не доказывают происхождение тестов. Snapshot bloat не найден.
|
||
|
||
# F. AI Agent & Developer Workflow
|
||
|
||
## F1. Bootstrap и full gate обязательны слишком широко
|
||
|
||
Одинаковое требование в обоих application repos:
|
||
|
||
> Code/dependency change: `npm ci`, полный `npm run verify`…
|
||
|
||
`frontend/.ai/conventions/engineering.md:60–62`, `backend/.ai/conventions/engineering.md:60–62`.
|
||
|
||
Для code-only изменения в уже подготовленном checkout повторная установка не устанавливает новый инвариант. Full frontend verify также запускает browser tests, Knip, оба dependency graphs и Storybook build.
|
||
|
||
**Упростить:** bootstrap при новом checkout/изменении lockfile или toolchain; local checks по affected behavior; полный независимый CI gate сохранить.
|
||
|
||
Потеря — более поздний feedback по незатронутым областям, а не отсутствие merge-time проверки.
|
||
|
||
## F2. Pre-commit собирает packages и проверяет весь graph на каждом commit
|
||
|
||
`frontend/.husky/pre-commit:1–3`, `frontend/package.json:25,33`.
|
||
|
||
Даже Markdown commit достигает `npm run deps`, который сначала builds workspaces. UI/icons builds включают Vite и declaration compilation: `frontend/packages/ui/package.json:23–25`, `frontend/packages/icons/package.json:19–21`.
|
||
|
||
**Перенести graph check из hook в scoped local/CI.** Staged secret scan и staged ESLint оставить.
|
||
|
||
## F3. Mechanical lint policy создаёт искусственную форму кода
|
||
|
||
- Вложенные component helpers запрещены custom rule: `frontend/eslint-rules.mjs:63–85`.
|
||
- Локальные Zod declarations/refinements требуют filename suffix: тот же файл, `20–36`.
|
||
- JSX sibling spacing имеет собственный AST traversal/fixer: тот же файл, `104–175`.
|
||
- Любой inline JSX callback/conditional prop запрещён: `frontend/eslint.config.mjs:273–283`.
|
||
- Backend magic-number profile требует имена даже для `0`, `1` и bigint literals: `backend/test/eslint-config.cjs:78–92`.
|
||
|
||
Часть этих правил защищает readability preferences, а не data flow или runtime correctness. Они увеличивают число именованных declarations, файлов и exceptions.
|
||
|
||
**Упростить blanket restrictions**, оставив semantic boundaries: no data fetching во view, безопасные promises, stable query client, доступность, named business policy values. Не заменять custom policy ещё одним инструментом.
|
||
|
||
## F4. Generic skills конфликтуют с локальным соразмерным workflow
|
||
|
||
- `writing-plans` автоматически применим к multi-step requirements: `.agents/skills/workflow/writing-plans/SKILL.md:3`.
|
||
- Предписывает файл в `docs/superpowers/plans`: тот же файл, `16–17`.
|
||
- Добавляет fixed test/commit structure и Review Focus cases: тот же файл, `43–50,77–87,108–137`.
|
||
- TDD применяется к refactoring и требует failing test до любого production code: `.agents/skills/workflow/test-driven-development/SKILL.md:18–45`.
|
||
- Локальный Test Intent не требует отдельного artifact, исключает trivial wrapper/declaration testing: `frontend/.ai/conventions/engineering.md:49–55`, `backend/.ai/conventions/engineering.md:49–55`.
|
||
|
||
**Рекомендация:** ограничить применение этих workflows явно выбранной planning/TDD задачей и реальным regression risk. Сохранить reproduction для bug fixes и meaningful proof; не требовать новый тест для удаления unused field/export.
|
||
|
||
Стандартные OpenSpec skills изменять не требуется.
|
||
|
||
## F5. Opt-in OpenSpec против mandatory audit remediation
|
||
|
||
Противоречие:
|
||
|
||
- Opt-in: `specs/AGENTS.md:3–6`, `frontend/.ai/conventions/engineering.md:11–13`, `backend/.ai/conventions/engineering.md:11–13`.
|
||
- Mandatory audit-derived registry/workflow: `specs/openspec/specs/project-foundation/spec.md:9–19`.
|
||
- Обязательные snapshots/registry: `specs/openspec/specs/audit-remediation-workflow/spec.md:9–49`.
|
||
- Docs запрещает размещение audit/research reports: `docs/AGENTS.md:12–14`.
|
||
|
||
**Упростить действующую process policy**, согласовав область действия и место artifacts. Не создавать registry/SDD change автоматически для реализации этого аудита.
|
||
|
||
## F6. Custom SDD workflow остаётся тяжёлым даже без behavioral delta
|
||
|
||
- V2: семь planning artifact groups.
|
||
- При `skip_specs` остаются шесть.
|
||
- Schemas: 885 строк; templates: 335 строк.
|
||
- Семь stage instructions требуют native validation после записи.
|
||
- Apply preconditions перечисляют семь explicit approvals: `specs/openspec/schemas/wealth-ledger-sdd-v2/schema.yaml:587–589`.
|
||
|
||
Это не доказательство бесполезности анализа/QA. Однако small docs/tooling change не всегда требует отдельных System Analysis, QA Analysis, Docs Impact и sessions.
|
||
|
||
**Сначала соблюдать opt-in режим.** При отдельном пересмотре custom schema — соразмерный набор artifacts по реальному риску. Не удалять approval/data-safety boundaries вслепую.
|
||
|
||
## F7. Specs CI даёт мало гарантии за полноценный install
|
||
|
||
`specs/.gitea/workflows/verify.yml:17–22` → `npm ci` → `git diff --check`.
|
||
|
||
На чистом checkout команда не проверяет committed PR diff, semantic structure или OpenSpec artifacts. Зато npm `prepare` настраивает hooksPath: `specs/package.json:13`.
|
||
|
||
**Удалить нынешний пустой job**, предварительно установив required-check settings. Существующие native validations запускать для соответствующего изменения; этот аудит не требует нового verifier.
|
||
|
||
## F8. Что не является проблемой
|
||
|
||
- AGENTS routers уже ограничивают чтение affected topics.
|
||
- Root и nested conventions не наследуются друг в друга — разные enum/style choices не конфликт.
|
||
- Read-only archives/history не нужно удалять.
|
||
- Повторение краткого stage-specific rule допустимо, если оно нужно executor текущей стадии.
|
||
- Транзитивно избыточные schema edges нельзя удалять только по graph reachability: они могут влиять на CLI context inputs.
|
||
|
||
## Необходимые измерения
|
||
|
||
Без новых tools достаточно existing CI logs и session usage:
|
||
|
||
1. Duration каждой verify stage, cold/warm отдельно.
|
||
2. Время workspace builds в local commands/hook.
|
||
3. Частота local full verify и reinstall.
|
||
4. CI critical path и full-history scan duration.
|
||
5. Token/context volume на обычную задачу против explicitly selected SDD change.
|
||
6. Какие gates действительно находят regressions и на какой boundary.
|
||
|
||
Сейчас денежная/временная экономия не оценена численно.
|
||
|
||
# G. DELETE / SIMPLIFY / KEEP
|
||
|
||
## DELETE — 18 подтверждённых точек
|
||
|
||
Удаление подразумевает сохранение указанного более сильного или эквивалентного механизма.
|
||
|
||
1. Custom implementation `check-openapi.mjs` — заменить native check.
|
||
2. Второй TypeScript call в frontend verify.
|
||
3. `typecheck:app` stage из backend full verify — test typecheck superset оставить.
|
||
4. Повторный backend build перед SQLite в том же CI job.
|
||
5. Невызываемый `runtime-check.cjs`.
|
||
6. `useAuthenticatedQueries` и исключительно его test branch.
|
||
7. Неиспользуемый `history.retry`.
|
||
8. Неиспользуемый `isFetching` input.
|
||
9. Неиспользуемая Portfolio membership DI dependency.
|
||
10. String alias `TBANK_ACCESS` — concrete provider оставить.
|
||
11. Невызываемый `TbankAccessService.membershipWork`.
|
||
12. Неиспользуемый `candleTail` policy key.
|
||
13. Непривязанный `HourlySyncSectionDto`.
|
||
14. Неиспользуемый внешний export `totalsByCurrency`.
|
||
15. Delegation-only `brokerage-operations.controller.spec.ts`.
|
||
16. Повторный standalone anonymous `/accounts` route test.
|
||
17. Повторный image-error exercise в AccountEvents page test.
|
||
18. Пустой specs CI verify job — после проверки branch requirements.
|
||
|
||
Evidence и consequences перечислены в B–E. Это **18 элементов/стадий**, а не 18 файлов.
|
||
|
||
## SIMPLIFY
|
||
|
||
- Local gate scope и bootstrap frequency.
|
||
- Dependency graph invocation в pre-commit.
|
||
- SQLite runner regression scope.
|
||
- Exhaustive preset parity и mechanical custom lint policy.
|
||
- Metadata tests через production-used methods.
|
||
- Portfolio `request`/private test access.
|
||
- AccountEvents fake-query setup.
|
||
- Pure mapper/use-case tests.
|
||
- Три order-dependent bank cases.
|
||
- Bond-only InstrumentSearch contract.
|
||
- Motion → CSS.
|
||
- FormProvider rule по наличию consumers.
|
||
- Process specs/SDD activation.
|
||
- Specs hook activation через явное подключение вместо npm lifecycle.
|
||
- Visual SHA tables только там, где exports реально передаются отдельно от Git.
|
||
|
||
## KEEP
|
||
|
||
- Финансовая точность и business validation.
|
||
- Intent fingerprint, unique IDs, versions, tombstones, refund transaction.
|
||
- Refresh hashing/CAS, cursor signature/binding.
|
||
- Connection revision и conditional publication.
|
||
- Coverage/completeness/freshness как разные свойства.
|
||
- Independent local/CI trust boundaries.
|
||
- Per-suite DB isolation и crash/durability proofs.
|
||
- Runtime OpenAPI parity и consumer artifact freshness.
|
||
- Scanner checksum, exact image digest/revision checks.
|
||
- Deployment lock, pending marker, backup staging, explicit recovery.
|
||
- Repo-local небольшие configs/helpers вместо нового shared tooling package.
|
||
- Исторические ADR/archives.
|
||
- Реальные browser layout и Storybook isolation guarantees.
|
||
|
||
**Условный кандидат, не DELETE:** `InvestmentRefreshState` имеет ноль production callers, но четыре stories и catalog isolation consumer — `frontend/src/features/tbank-connection/ui/InvestmentRefreshState/InvestmentRefreshState.view.tsx:1–61`, `frontend/src/features/tbank-connection/ui/InvestmentRefreshState/InvestmentRefreshState.stories.tsx:1–52`, `frontend/src/test/storybook.test.tsx:11,38`. Его удаление уберёт catalog artifact; намерение owner не установлено.
|
||
|
||
# H. Top 20 Complexity Reduction Opportunities
|
||
|
||
Порядок — по ожидаемому сокращению engineering overhead. Экономия указана в механизмах/запусках, не в выдуманных секундах.
|
||
|
||
Сокращённые filenames в таблице однозначно относятся к полным путям, указанным в B–F.
|
||
|
||
| № | Файлы и доказательства | Текущий механизм → минимальное изменение | Что перестанет работать / ожидаемая экономия | Риск · Confidence |
|
||
|---:|---|---|---|---|
|
||
| **1** | FE/BE `.ai/conventions/engineering.md:58–66` | `npm ci` + full verify для любого code change → bootstrap по изменению inputs, local affected checks, full CI | Исчезнет обязательный ранний full-project proof; меньше reinstall/full suites на малую задачу | Medium · High |
|
||
| **2** | `backend/test/sqlite-regression.cjs:20–22,77–91`; `backend/test/sqlite.cjs:10–17` | Пять successful `--all` runs → по две representative suites | Теряются повторные business runs внутри runner proof; **95 → 10** successful suite executions, canonical full CI остаётся | Medium · High facts |
|
||
| **3** | `frontend/package.json:26`; `frontend/tsconfig.app.json:17`, `frontend/tsconfig.node.json:12` | Два TS calls с noEmit configs → один | Второй call не выполняется; минус один compiler invocation/full verify | Low · High |
|
||
| **4** | `backend/package.json:22–34`; typecheck configs app `7–8`, test `7–8` | App subset + test superset → test superset в aggregate | Отдельная маркировка app-stage failure; минус один nonincremental TS pass | Low · High |
|
||
| **5** | `backend/.gitea/workflows/verify.yml:84–89`; package `28,34` | Verify build, затем E2E build → после verify existing `node test/sqlite.cjs --all` | E2E stage перестанет пересобирать уже готовый output; standalone entrypoint сохранить | Low · High |
|
||
| **6** | `frontend/.husky/pre-commit:1–3`; package `25,33`; UI/icons package builds | Whole graph + workspace build на каждый commit → local/CI graph | Потеря hook-time graph feedback; минус один workspace build/graph traversal на commit | Low–Medium · High |
|
||
| **7** | `frontend/scripts/check-openapi.mjs:1–45`; CLI `125–134` | Custom temp/subprocess compare → `openapi-typescript … -o … --check` | Ничего из freshness guarantee; **45 строк custom orchestration** заменяются CLI option | Low · High; native check executed |
|
||
| **8** | `specs/package.json:9,13`; `specs/.gitea/workflows/verify.yml:17–22` | Install + clean working diff check → удалить пустой job | Теряется малоинформативный check status; минус job/install/hooks side effect | Low после branch-setting review · High |
|
||
| **9** | FE `eslint-rules.mjs:1–178`; `test-eslint.mjs:148–202,290–339` | Mechanical AST policy + exhaustive preset parity → оставить semantic boundaries и custom-exception probes | Меньше формальных style/shape guarantees; меньше custom rule/test maintenance | Medium · High facts |
|
||
| **10** | `frontend/src/app/routes/RouteTransition.tsx:3–30`; package `52`; caller `RouteFallback.tsx:70–81` | Motion для fade-in → CSS с reduced motion | Library-driven fade-in заменяется; сохранить key/mount semantics; **−1 runtime dependency** | Low–Medium · High |
|
||
| **11** | Metadata service `45–61`; persistence tests `87–382`; repository `159–170` | Test-only read/start API → tests через `request`/`savedMany`, затем удалить API/work accessor | Исчезнет unused combined operation; реальные reuse/race/restart proofs сохранить | Medium · High |
|
||
| **12** | `frontend/src/shared/api/authenticated-query.ts:15–32,61`; test `9–23` | Unused plural generic hook → удалить и test-only variant | Multi-query convenience без product consumers; меньше generic surface/test matrix | Low · High |
|
||
| **13** | Portfolio service `45–53,234–243`; value-history tests `99–111,247–256` | Unused DI + public/private alias → один `request`, прямой provider access в tests | Private test route исчезнет; queue/publication не меняется | Low · High |
|
||
| **14** | History hook `52–61,76`; initial availability `10–46` | Невостребованное action и непрочитанный input → удалить | Никакой used behavior; automatic cursor recovery/wait budget остаются | Low · High |
|
||
| **15** | InstrumentSearch view `18–31`; BondsPage view `26–113`; test `21–29` | Stock/bond renderer при одном bond consumer → bond-specific current contract | Исчезнет test-only stock mode; current product search не меняется | Low–Medium · High |
|
||
| **16** | AccountEvents test `13–28,40–205`; filters test `50–108` | Fake hooks/query shapes → existing MSW/view boundaries | Исчезнут internal-hook assertions и пять fake shapes; visible outcomes сохранить | Medium · High |
|
||
| **17** | Summary spec `11–48`; portfolio spec `48–165`; mapper `33–138` | Fake tx/background work ради чистого result → ближайший existing owner | Unit не будет exercise’ить orchestration; configured DB/publication proofs остаются | Low–Medium · High |
|
||
| **18** | Controller spec `1–18`; route test `35–61`; page image test `166–169` | Delegation-only и одинаковые assertions → удалить узкие дубли | Только internal-call/repeated fallback assertions; более сильные HTTP/route/EntryCard proofs остаются | Low · High |
|
||
| **19** | `backend/test/bank-cards.e2e-spec.ts:371–389,710–753`; setup `86–105` | Три tests с implicit prerequisites → собственный arrange через `createCard` | Теряется зависимость от suite history, не business guarantee; targeted tests дешевле понимать | Low–Medium · High |
|
||
| **20** | Specs AGENTS `3–6`; foundation `9–19`; remediation `9–49`; writing-plans `16–17,77–87`; TDD `18–45` | Mandatory artifacts/SDD/TDD rules конфликтуют с opt-in/direct work → уточнить existing activation/scope | Не будет автоматических planning/registry artifacts для каждой audit-derived правки; меньше context/approval loops | Medium · High |
|
||
|
||
Отдельные дешёвые dead-surface cuts из G можно делать при связанном изменении owner. Ради удаления одного export не нужен самостоятельный архитектурный проект.
|
||
|
||
# I. Minimal Engineering Baseline
|
||
|
||
Это предложение сократить существующий workflow, **не новая convention или набор инструментов**.
|
||
|
||
## Local development
|
||
|
||
Оставить:
|
||
|
||
- Активировать local Node version.
|
||
- Bootstrap при новом checkout или изменении dependency/toolchain inputs.
|
||
- Targeted test на cheapest reliable boundary.
|
||
- Relevant typecheck/lint.
|
||
- Semantic review affected behavior и `git diff --check`.
|
||
- Risk-triggered DB/browser/contract/durability proof.
|
||
|
||
Убрать обязательный `npm ci` и весь full-project gate после каждого code-only изменения.
|
||
|
||
Full verify остаётся доступным локально, но его обязательная независимая граница — CI.
|
||
|
||
## Pre-commit
|
||
|
||
Оставить frontend:
|
||
|
||
1. Staged Gitleaks с redaction/fail-closed.
|
||
2. Staged ESLint.
|
||
3. Commit-msg policy при подключённом hook.
|
||
|
||
Перенести whole dependency graph и workspace builds из pre-commit.
|
||
|
||
Specs `commit-msg` можно оставить; подключение hooks сделать явным вместо автоматического `prepare`. Это не отменит уже записанный hooksPath само по себе.
|
||
|
||
## CI
|
||
|
||
### Frontend
|
||
|
||
Оставить:
|
||
|
||
- Native OpenAPI freshness.
|
||
- Один TypeScript pass.
|
||
- Один ESLint run.
|
||
- Behavioral tests + coverage.
|
||
- Knip.
|
||
- Production и Storybook graph checks с сохранением различающихся semantics.
|
||
- Application и catalog builds.
|
||
- Security и commit policy.
|
||
|
||
Lint-config tests сократить до project-specific scopes/exceptions/custom behavior; изменение tooling требует соответствующего focused proof.
|
||
|
||
### Backend
|
||
|
||
Оставить:
|
||
|
||
- Generated Prisma client до checks.
|
||
- Один full-source/test typecheck.
|
||
- ESLint.
|
||
- Unit suite.
|
||
- Один build.
|
||
- Изолированные functional SQLite suites, включая runtime OpenAPI contract.
|
||
- Security и commit policy.
|
||
|
||
После уже выполненного build использовать existing runner без повторного build. Performance и historical durability остаются отдельными risk-triggered командами.
|
||
|
||
### Docs / specs
|
||
|
||
- Docs Markdown/link lint сохранить.
|
||
- Working-diff check оставить локально.
|
||
- Specs пустой verify job удалить после проверки branch requirements.
|
||
- Native OpenSpec validation использовать по изменению schema/spec/change и только в выбранном SDD scope.
|
||
- Security/release/commit mechanisms сохранить.
|
||
|
||
## Testing layers
|
||
|
||
Минимально достаточные существующие layers:
|
||
|
||
1. Pure domain/unit — деньги, normalizers, mappers.
|
||
2. RTL/MSW — UI, forms, route/session/transport behavior.
|
||
3. Configured HTTP + real SQLite — pipes, guards, transactions, CAS, persistence.
|
||
4. Browser — geometry/lifecycle, которые JSDOM не доказывает.
|
||
5. Image/historical/deploy — соответствующие packaging/data-recovery risks.
|
||
|
||
Удалять одинаковый proof, а не целый layer.
|
||
|
||
## Architecture constraints
|
||
|
||
Оставить:
|
||
|
||
- Production не зависит от test code.
|
||
- Package не зависит от app.
|
||
- FSD public API/layer/cycle boundaries.
|
||
- Presentation не выполняет application fetching.
|
||
- Story graph не достигает application data.
|
||
- Pure domain не зависит от persistence/transport.
|
||
|
||
Не добавлять interface перед каждым concrete provider, общий worker framework или новые архитектурные checks.
|
||
|
||
## AI instructions
|
||
|
||
Оставить:
|
||
|
||
- Local AGENTS router.
|
||
- Owner/callers/invariants до изменения.
|
||
- Сохранение чужих изменений.
|
||
- Context по affected topics.
|
||
- Meaningful verification evidence.
|
||
- Opt-in OpenSpec.
|
||
|
||
Сократить:
|
||
|
||
- Universal plan-file creation.
|
||
- Новый failing test для каждого mechanical refactor.
|
||
- Mandatory full reinstall/full verify на любую правку.
|
||
- Blanket FormProvider/VM/helper/style mechanics без current responsibility.
|
||
- Повторные process authority descriptions и обязательные artifacts с конфликтующим размещением.
|
||
|
||
---
|
||
|
||
## Итог
|
||
|
||
**Наиболее выгодный путь: сократить обязательную частоту и scope проверок → удалить доказанную невостребованную поверхность → упростить test boundaries → согласовать процессную authority.**
|
||
|
||
Не требуется менять финансовую архитектуру, добавлять инструменты или объединять независимые repositories.
|
||
|
||
**Net:** точный line delta не подготовлен; подтверждена замена 45-строчного OpenAPI checker native CLI, 18 точек удаления и возможность убрать одну runtime dependency после CSS-замены. Экономия времени и токенов требует измерений.
|