WealthLedger/backend
5
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

[Refactor] Публиковать типизированные коды Problem Details для frontend #117

New Issue
Closed
opened 2026-10-20 05:00:26 +03:00 by codex-bot · 2 comments
codex-bot commented 2026-10-20 05:00:26 +03:00
Owner
Copy Link
Copy Source

Проблема

Аудит main/audits/2026-10-19-code-quality-architecture/02-findings.md, CQ-003: ProblemDetailsDto.code публикуется в OpenAPI как произвольная строка; frontend поддерживает отдельный неполный список кодов, включая недостижимую ветку. Это одна координирующая задача для публичного контракта и его потребителя.

Результат и scope

Backend определяет достоверный публикуемый словарь кодов и передаёт обновлённый OpenAPI artifact; frontend обновляет generated types и убирает ручное зеркало там, где оно дублирует контракт. Не удалять и не переименовывать реально выдаваемые коды без отдельного согласования; не править generated файлы вручную. Смежная frontend#55 отвечает за отображение source/recovery, не за генерацию словаря.

Acceptance Criteria

  • Публикуемый backend OpenAPI описывает допустимые значения ProblemDetailsDto.code согласно реально выдаваемым кодам; runtime payload остаётся совместимым.
  • Контракт явно доставлен frontend, сгенерированные типы обновлены из него; ручной список не расходится с источником или удалён.
  • Использования отсутствующих/лишних кодов на frontend пересмотрены без потери текущего поведения access-loss; соответствующие проверки backend/frontend проходят.
  • Изменения в двух самостоятельных репозиториях проверены и приняты вместе; порядок поставки backend contract → frontend consumer зафиксирован.

Источник: аудит 2026-10-19, CQ-003 (CQ-014/OE-08 лишь смежны), план, пункт 4. Отдельные внутренние перестановки всех enum не входят в эту задачу.

## Проблема Аудит `main/audits/2026-10-19-code-quality-architecture/02-findings.md`, CQ-003: `ProblemDetailsDto.code` публикуется в OpenAPI как произвольная строка; frontend поддерживает отдельный неполный список кодов, включая недостижимую ветку. Это одна координирующая задача для публичного контракта и его потребителя. ## Результат и scope Backend определяет достоверный публикуемый словарь кодов и передаёт обновлённый OpenAPI artifact; frontend обновляет generated types и убирает ручное зеркало там, где оно дублирует контракт. Не удалять и не переименовывать реально выдаваемые коды без отдельного согласования; не править generated файлы вручную. Смежная frontend#55 отвечает за отображение source/recovery, не за генерацию словаря. ## Acceptance Criteria - [ ] Публикуемый backend OpenAPI описывает допустимые значения `ProblemDetailsDto.code` согласно реально выдаваемым кодам; runtime payload остаётся совместимым. - [ ] Контракт явно доставлен frontend, сгенерированные типы обновлены из него; ручной список не расходится с источником или удалён. - [ ] Использования отсутствующих/лишних кодов на frontend пересмотрены без потери текущего поведения access-loss; соответствующие проверки backend/frontend проходят. - [ ] Изменения в двух самостоятельных репозиториях проверены и приняты вместе; порядок поставки backend contract → frontend consumer зафиксирован. Источник: аудит 2026-10-19, CQ-003 (CQ-014/OE-08 лишь смежны), план, пункт 4. Отдельные внутренние перестановки всех enum не входят в эту задачу.
codex-bot added the
Priority
Medium
3
Kind/Refactor labels 2026-10-20 05:00:26 +03:00
codex-bot commented 2026-10-28 15:42:56 +03:00
Author
Owner
Copy Link
Copy Source

Delivery order: backend contract WealthLedger/backend#144 → frontend consumer WealthLedger/frontend#123. Close after both are merged.

Delivery order: backend contract WealthLedger/backend#144 → frontend consumer WealthLedger/frontend#123. Close after both are merged.
codex-bot commented 2026-10-28 17:32:04 +03:00
Author
Owner
Copy Link
Copy Source

Delivered in order: backend #144 (d37fa2c) → frontend WealthLedger/frontend#123 (32e8fe9). Both CI green. Follow-up (out of scope): type thrown exception payload code so a new code cannot bypass PROBLEM_CODES.

Delivered in order: backend #144 (d37fa2c) → frontend WealthLedger/frontend#123 (32e8fe9). Both CI green. Follow-up (out of scope): type thrown exception payload `code` so a new code cannot bypass `PROBLEM_CODES`.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Kind/Dependencies
Dependency update or dependency-management work
 Kind/Investigation
Research or decision required before implementation
 Kind/Process
Developer workflow, CI/CD, tooling, or process improvement
 Kind/Refactor
Internal code or configuration restructuring without new product behavior
 audit/2026-10-11
Technical Audit Remediation — 2026-10-11
 kind/investigation
Нужна проверка evidence до решения; runtime-дефект не утверждается
Compat/Breaking
Breaking change that won't be backward compatible
 Kind/Bug
Something is not working
 Kind/Documentation
Documentation changes
 Kind/Enhancement
Improve existing functionality
 Kind/Feature
New functionality
 Kind/Security
This is security issue
 Kind/Testing
Issue or pull request related to testing
Priority
Critical
1
The priority is critical
Priority
High
2
The priority is high
Priority
Medium
3
The priority is medium
Priority
Low
4
The priority is low
Reviewed
Confirmed
1
Issue has been confirmed
Reviewed
Duplicate
2
This issue or pull request already exists
Reviewed
Invalid
3
Invalid issue
Reviewed
Won't Fix
3
This issue won't be fixed
Status
Blocked
1
Something is blocking this issue or pull request
Status
Need More Info
2
Feedback is required to reproduce issue or to continue work
Status
Abandoned
3
Somebody has started to work on this but abandoned work
No labels Kind/Refactor
Priority
Medium
3
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
codex-bot hermes-agent ksv741 publisher-bot renovate-bot
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: WealthLedger/backend#117