[P1] 07.frontend. Обновлять snapshot и generated types одним явным действием #3

Closed
opened 2026-09-13 15:34:03 +03:00 by codex-bot · 1 comment
Owner

Источник: локальный todo/wealthledger-engineering-improvements.md, пункт 07.frontend, анализ от 13.09.2026. Исходные критерии приведены ниже, чтобы issue не зависела от наличия локального TODO.

Что осталось сделать

07.frontend. Обновлять snapshot и generated types одним явным действием. Часть 07.backend.

Использовать backend export из 07.backend и существующий openapi:generate.
Не редактировать generated types вручную и не вводить второй HTTP authority.
Готово, когда: snapshot и types обновляются согласованно; повтор даёт пустой
diff; openapi:check и backend runtime contract test проходят; ошибка экспорта
не оставляет частично перезаписанный snapshot. Root-команда 06 вызывает этот flow.

Основание текущего статуса

package.json содержит полный verify и отдельные openapi:generate/openapi:check. Генерация типов читает локальный snapshot; единого экспорта runtime OpenAPI с согласованным обновлением двух файлов пока нет. Node 24 уже принят.

Проверка 13.09.2026: статическая сверка текущих файлов и remediation registry; через MCP проверены репозитории, issues, ветки и Actions workflows. Все пять main-веток имеют protected=false, список workflows пуст, существующих issues не найдено. Внешние CI, server-side updater, история секретов и свежий npm audit этой сверкой не проверялись; полные application gates повторно не запускались.

Проверяемая revision frontend: 117e74cdfc29cbf63f549ea88e8106ab25300541.

Remediation registry остаётся владельцем статусов audit findings. Создание issue не означает выполнение или изменение статуса finding. Закрыть после проверки критериев и ссылки на фактические результаты.

Связанные issues

<!-- wealthledger-engineering-improvements:frontend:07.frontend --> Источник: локальный `todo/wealthledger-engineering-improvements.md`, пункт 07.frontend, анализ от 13.09.2026. Исходные критерии приведены ниже, чтобы issue не зависела от наличия локального TODO. ## Что осталось сделать **07.frontend. Обновлять snapshot и generated types одним явным действием.** Часть 07.backend. Использовать backend export из 07.backend и существующий `openapi:generate`. Не редактировать generated types вручную и не вводить второй HTTP authority. **Готово, когда:** snapshot и types обновляются согласованно; повтор даёт пустой diff; `openapi:check` и backend runtime contract test проходят; ошибка экспорта не оставляет частично перезаписанный snapshot. Root-команда 06 вызывает этот flow. ## Основание текущего статуса [package.json](https://git.personal.ksv741.ru/WealthLedger/frontend/src/commit/117e74cdfc29cbf63f549ea88e8106ab25300541/package.json) содержит полный verify и отдельные openapi:generate/openapi:check. Генерация типов читает локальный snapshot; единого экспорта runtime OpenAPI с согласованным обновлением двух файлов пока нет. Node 24 уже принят. Проверка 13.09.2026: статическая сверка текущих файлов и remediation registry; через MCP проверены репозитории, issues, ветки и Actions workflows. Все пять main-веток имеют protected=false, список workflows пуст, существующих issues не найдено. Внешние CI, server-side updater, история секретов и свежий npm audit этой сверкой не проверялись; полные application gates повторно не запускались. Проверяемая revision frontend: `117e74cdfc29cbf63f549ea88e8106ab25300541`. [Remediation registry](https://git.personal.ksv741.ru/WealthLedger/docs/src/commit/7bc8792b9853768734066c31a323b70886d73a23/development/audit-remediation.md) остаётся владельцем статусов audit findings. Создание issue не означает выполнение или изменение статуса finding. Закрыть после проверки критериев и ссылки на фактические результаты. ## Связанные issues - [backend: [P1] 07.backend. Подготовить надёжный экспорт backend OpenAPI](https://git.personal.ksv741.ru/WealthLedger/backend/issues/3)
Author
Owner

Закрываю по новой договорённости из ADR 014.

Scope задачи изменён: frontend больше не должен получать schema через backend export, знать пути соседнего backend checkout, фиксировать frontend/backend SHA-пару или сравнивать snapshot с backend runtime OpenAPI. Предоставленный src/shared/api/spec/openapi.json считается актуальным входом.

Текущий frontend flow покрывает оставшуюся обязанность этой задачи:

  • npm run openapi:generate генерирует schema.d.ts из локального snapshot;
  • npm run openapi:check проверяет, что committed generated types соответствуют committed snapshot;
  • npm run verify включает этот check и выполняется без backend.

Зафиксировано и выровнено в commits:

  • frontend 7a89356 — agent guidance под local snapshot/types flow;
  • docs 2ef3759 — ADR 014 и OpenAPI contract flow;
  • specs 05e314c — удалён runtime OpenAPI gate из живой спецификации/шаблона.

Оставшиеся работы вынесены из этой issue: branch protection/required check остаётся в #2, security/dependency audit остаётся в #4.

Закрываю по новой договорённости из ADR 014. Scope задачи изменён: frontend больше не должен получать schema через backend export, знать пути соседнего backend checkout, фиксировать frontend/backend SHA-пару или сравнивать snapshot с backend runtime OpenAPI. Предоставленный `src/shared/api/spec/openapi.json` считается актуальным входом. Текущий frontend flow покрывает оставшуюся обязанность этой задачи: - `npm run openapi:generate` генерирует `schema.d.ts` из локального snapshot; - `npm run openapi:check` проверяет, что committed generated types соответствуют committed snapshot; - `npm run verify` включает этот check и выполняется без backend. Зафиксировано и выровнено в commits: - frontend `7a89356` — agent guidance под local snapshot/types flow; - docs `2ef3759` — ADR 014 и OpenAPI contract flow; - specs `05e314c` — удалён runtime OpenAPI gate из живой спецификации/шаблона. Оставшиеся работы вынесены из этой issue: branch protection/required check остаётся в #2, security/dependency audit остаётся в #4.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: WealthLedger/frontend#3