42 lines
5.1 KiB
Markdown
42 lines
5.1 KiB
Markdown
# frontend-query-coherence Specification
|
|
|
|
## Purpose
|
|
|
|
Гарантирует, что frontend читает, обновляет и инвалидирует один и тот же кэш API-данных после связанных пользовательских действий.
|
|
|
|
## Requirements
|
|
|
|
### Requirement: Frontend сохраняет когерентность кэша T-Bank connection
|
|
Frontend MUST считать успешное создание, замену или удаление T-Bank connection новой границей повторного использования финансовых данных. Статус connection MUST сразу отражать результат успешной операции, а ни один последующий потребитель Brokerage Accounts, Portfolio, Operations, Events, Income Summary или Income Analytics MUST NOT использовать данные, загруженные до этой границы. Неуспешная операция MUST сохранять текущий статус connection и доступные данные его границы. Временная ошибка обычного фонового обновления MUST сохранять Client Cached Snapshot текущей границы, а logout MUST независимо очищать статус connection и связанные с ним данные пользовательской сессии.
|
|
|
|
#### Scenario: Успешное создание подключения обновляет status и границу данных
|
|
- **WHEN** User успешно создаёт T-Bank connection в настройках
|
|
- **THEN** frontend показывает статус из успешного ответа, и следующий потребитель любой связанной финансовой выборки не использует данные, загруженные до создания connection
|
|
|
|
#### Scenario: Успешная замена подключения обновляет status и accounts
|
|
- **WHEN** User успешно заменяет T-Bank connection в настройках
|
|
- **THEN** frontend показывает статус из успешного ответа, и следующий потребитель любой связанной финансовой выборки не использует данные, загруженные до замены connection
|
|
|
|
#### Scenario: Успешное удаление подключения обновляет status и accounts
|
|
- **WHEN** User подтверждает успешное удаление T-Bank connection
|
|
- **THEN** frontend показывает состояние без подключения, и следующий потребитель любой связанной финансовой выборки не использует данные, загруженные до удаления connection
|
|
|
|
#### Scenario: Неуспешная операция не меняет границу connection
|
|
- **WHEN** создание, замена или удаление T-Bank connection завершается ошибкой
|
|
- **THEN** frontend сохраняет текущий статус connection и доступные Brokerage Accounts, Portfolio, Operations, Events, Income Summary и Income Analytics его границы
|
|
|
|
#### Scenario: Временная ошибка фонового обновления сохраняет snapshot
|
|
- **WHEN** обычное фоновое обновление финансовой выборки текущего T-Bank connection завершается временной ошибкой
|
|
- **THEN** frontend сохраняет её Client Cached Snapshot как данные текущей границы connection
|
|
|
|
#### Scenario: Logout очищает данные пользовательской сессии
|
|
- **WHEN** User выходит из текущей сессии
|
|
- **THEN** frontend очищает статус T-Bank connection и все связанные с ним финансовые данные этой пользовательской сессии
|
|
|
|
### Requirement: Generated API queries сохраняют транспортную и cache identity
|
|
Frontend MUST сохранять сгенерированную API-клиентом идентичность для запросов Brokerage Accounts, операций Brokerage Account, событий Brokerage Account, Portfolio и T-Bank connection. Потребитель, которому требуется прочитать или инвалидировать один из этих кэшей вне hook, MUST получать его идентичность из владельца соответствующего query, а не формировать отдельный ключ.
|
|
|
|
#### Scenario: Потребитель читает кэш списка счетов
|
|
- **WHEN** frontend определяет Brokerage Account для уже открытого account route
|
|
- **THEN** он читает тот же кэш списка Brokerage Accounts, который использует его query hook
|