docs: reorganize system knowledge by domain
This commit is contained in:
+21
-7
@@ -1,9 +1,23 @@
|
||||
# Архитектура
|
||||
# Архитектура WealthLedger
|
||||
|
||||
Здесь описывается фактическое устройство WealthLedger и границы компонентов.
|
||||
Архитектурное описание объясняет границы приложений, владение данными и
|
||||
взаимодействия. Для знакомства с пользовательскими задачами начните с
|
||||
[обзора продукта](../overview.md), затем прочитайте Context и Container.
|
||||
|
||||
- [Обзор системы](system-overview.md) — поставленные возможности, локальные
|
||||
границы и основные потоки данных.
|
||||
- [HTTP API и ошибки](http-api.md) — validation, error envelope и границы доказательства.
|
||||
- [Глоссарий домена](domain-glossary.md) — канонические значения терминов.
|
||||
- [ADR](../adr/README.md) — долгоживущие решения и их последствия.
|
||||
| Вопрос | Где искать |
|
||||
| --- | --- |
|
||||
| Кто пользуется системой и какие поставщики находятся снаружи? | [C4 System Context](context.md), [внешние интеграции](../integrations/README.md) |
|
||||
| Из каких приложений и хранилищ состоит система? | [C4 Container](containers.md) |
|
||||
| Как разделены данные, полномочия и secrets? | [Хранение и доступ](containers.md#хранимые-данные-и-границы-доступа), [аутентификация](../domains/authentication/overview.md), [подключение брокера](../integrations/tbank.md) |
|
||||
| На каких решениях основано устройство системы? | [Стратегия](containers.md#стратегия-решения-и-её-основания), [ADR](../adr/README.md) |
|
||||
| Что ограничивает точность, свежесть и эксплуатацию? | [Качество и ограничения](containers.md#качество-и-ограничения) |
|
||||
| Как взаимодействуют части во время запроса? | [Загрузка портфеля](../domains/portfolio/flows/portfolio-loading.md), [восстановление сессии](../domains/authentication/overview.md#восстановление-сессии), [сохранение подключения](../integrations/tbank.md#проверка-и-сохранение-подключения) |
|
||||
| Что считается кэшем и когда прежние данные теряют право на повторное использование? | [Свежесть данных](cross-cutting/data-freshness.md) |
|
||||
| Как обрабатываются ошибки и ожидание? | [HTTP API и ошибки](http-api.md), [состояния интерфейса](cross-cutting/ui-resilience.md) |
|
||||
| Как связать ошибку с обработкой запроса? | [Наблюдаемость](http-api.md#наблюдаемость) |
|
||||
| Как устроено подтверждённое локальное окружение? | [Container](containers.md#представление-container), [локальная диагностика](../development/local-workspace.md) |
|
||||
| Что означают предметные термины? | [Глоссарий](../glossary.md) |
|
||||
|
||||
Эта карта покрывает вопросы архитектуры там, где о них есть подтверждённое
|
||||
содержание. Правила размещения и изменения кода находятся в локальных
|
||||
инструкциях frontend/backend; системные объяснения остаются здесь.
|
||||
|
||||
Reference in New Issue
Block a user