Назначение
Опиши внешний provider, capability, owning service и anti-corruption boundary. Provider input считается недоверенным внешним вводом.
Границы Adapter-а
| Поле | Значение |
|---|
| Provider | <ProviderName> |
| Сервис | <service-name> |
| Capability | <геокодинг/импорт каталога застройщика/уведомления> |
| Adapter class | <AdapterName> |
| Typed client | <ClientName> |
| Внутренняя операция | <имя операции> |
Контракты Provider-а
| Операция Provider-а | Direction | Internal model | Provider-specific model |
|---|
<operation> | outbound / callback | <InternalModel> | <ProviderModel> |
Модель Internal <InternalModel>
| Поле | Тип | Обязательность | Описание | Mapping |
|---|
<FieldName> | <Type> | Да/Нет | <описание> | <provider field/rule> |
Модель Provider-Specific <ProviderModel>
| Поле | Тип | Обязательность | Provider format | Validation | Internal mapping |
|---|
<providerField> | <Type> | Да/Нет | <format> | <signature/range/enum> | <InternalField> |
Безопасность
| Контроль | Правило |
|---|
| Authentication | <api key/oauth/mTLS/signature> |
| Signature validation | <algorithm, signed fields, replay window> |
| Secrets | <secret names, storage, rotation> |
| PII | <masked/excluded fields> |
| Tenant binding | <provider account to TenantId/BrandId mapping> |
Resilience И Устойчивость
| Аспект | Правило |
|---|
| Timeout | <duration> |
| Retry | <policy and retryable errors> |
| Circuit breaker | <policy> |
| Idempotency | <key source> |
| Rate limit | <provider limit and local throttle> |
Обработка Callback
| Шаг | Правило |
|---|
| Verify | <signature, timestamp, source account> |
| Normalize | <ProviderModel -> InternalModel> |
| Validate | <validator and typed errors> |
| Dispatch | <запустить внутреннюю операцию обработки> |
| Store | <typed callback record with safe fields> |
Маппинг Ошибок
| Provider code | Internal error | Повторяемость | Видно пользователю |
|---|
<code> | <ErrorCode> | Да/Нет | Да/Нет |
Наблюдаемость
| Тип | Правило |
|---|
| Logs | <request started/success/provider error/signature failure> |
| Metrics | <latency/error rate/retry count/circuit state> |
| Traces | correlationId, provider request id, tenant id |
| Redaction | Provider secrets и raw sensitive fields исключаются. |
Обратные ссылки
Автоссылки: где используется этот документ.