4.4 KiB
4.4 KiB
1. Состояние remediation и навигация по устойчивой архитектуре
- 1.1 Отметить WL-P2-10 как
activeвdocs/development/audit-remediation.md, связать с ним этот OpenSpec change и убрать устаревший текст об отсутствии active/следующей задаче без terminal evidence до archive. - 1.2 Создать
docs/architecture/domain-glossary.md, перенёсши утверждённые термины из корневогоCONTEXT.md; сохранить различия Client Cached Snapshot и Portfolio Snapshot, а также Future Cash Event и Ledger Entry. - 1.3 Создать
docs/architecture/system-overview.mdс delivered capabilities, локальными MVP-границами, ссылками на feature docs и ADR, а также Mermaid-потоками auth/session и T-Bank → backend → frontend. - 1.4 Превратить
docs/architecture/README.mdв index system overview, domain glossary и ADR index без дублирования их содержания.
2. Onboarding и documentation entrypoints
- 2.1 Заменить template content
frontend/README.mdрусскоязычным onboarding: Node 22,npm ci,npm run verify, local configuration и ссылки на FSD, API, testing и OpenAPI documentation. - 2.2 Заменить template content
backend/README.mdрусскоязычным onboarding: Node 22,.env.example,npm ci, non-mutating lint/typecheck/unit-test gates, явныйlint:fix, ссылки на API/development documentation и короткую ссылку на deferred Prisma e2e registry record. - 2.3 Расширить
docs/development/README.mdдо index frontend workflow, backend local workflow, runtime OpenAPI verification, OpenSpec authority/lifecycle и audit remediation; registry остаётся единственным detailed owner deferred Prisma status. - 2.4 Расширить
docs/features/README.mdдо краткого index всех delivered feature documents и исправитьdocs/features/tbank-connection.md, чтобы он больше не описывал accounts, portfolio, ledger или future cash events как deferred. - 2.5 Обновить корневой и scoped
AGENTS.md, только убрав stale MVP routing и направив agents к relevant durable documentation entrypoints при сохранении canonical OpenSpec authority и local gates.
3. Удаление superseded root entrypoints и согласование ссылок
- 3.1 Обновить active documentation и project-owned specification references, чтобы они направляли читателей к durable docs и canonical OpenSpec, а не к корневым
MVP.mdилиCONTEXT.md. - 3.2 Удалить корневые
MVP.mdиCONTEXT.mdтолько после появления durable replacements и active links; immutable audits и historical archives оставить evidence. - 3.3 Проверить, что resulting README, index и glossary prose остаются русскоязычными, а команды, API paths и technical identifiers сохраняют каноническое написание.
4. Верификация и review перед archive
- 4.1 Выполнить read-only repository-wide active-link/path review удалённых root files, architecture/development/features navigation и README links; подтвердить намеренное сохранение historical audit/archive references.
- 4.2 Выполнить applicable non-mutating checks:
git diff --checkв каждом affected Git repository,bash specs/scripts/verify-openspec-authority.sh,openspec validate refresh-project-documentation-and-agent-entrypoints --type change --strict --store wealth-ledger-specsи strict validation synced specs. - 4.3 Провести independent read-only review точности документации по delivered specs,
package.jsonscripts,.env.example, domain glossary, deferred Prisma wording и scope; устранить каждый blocking finding. - 4.4 Выполнить applicable
opsx-verifyprocedure и устранить каждый blocking result completeness, correctness или coherence до archive.