Account Settings V2 (AccountSettingsV2Service) Class

Namespace: CXT.IO.Dashboard.Api.ServicesImplements: IAccountSettingsV2Service

This class is the concrete implementation of IAccountSettingsV2Service. It acts as a BFF orchestrator, handling the business logic for V2 account visibility by fetching from and saving to one or more downstream V1 Account Settings APIs.

Purpose

• Aggregates account settings from multiple underlying API instances, each representing a different business unit.
• Routes "save" requests to the correct downstream API based on the business unit of the accounts being modified.
• Adapts V2 BFF models to the V1 models used by the downstream APIs.
• Handles authentication (via JWT) when communicating with downstream services.

Dependencies

• ILogger<AccountSettingsV2Service>: For logging.
• IConfiguration: To access application settings.
• IJwtAccessTokenService: A service to obtain JWT access tokens required for authenticating requests to downstream APIs.
• IHttpClientFactory: Used to create HttpClient instances.
• ASEndpointConfiguration: A runtime configuration (asendpoints.json) defining the list of downstream Account Settings API endpoints and their associated business units.

Method Implementations

Get account settings

public async Task<List<AccountSettingsV2ResponseModel>> GetAccountSettings(string gcn, CancellationToken cancellationToken)

• Description: Retrieves and aggregates all V2 account settings for a client from all configured downstream API endpoints.
• Logic:
  1. Iterates through all ASEndpoint entries defined in the injected ASEndpointConfiguration.
  2. For each endpoint, it asynchronously calls a private GetAccountSettingsFromEndpoint helper method.
  3. The helper method obtains a JWT, creates an authenticated HttpClient, and makes a GET request to the api/v1/account-settings/{gcn} endpoint of the downstream API. Note: The V2 BFF service calls V1 of the core API.
  4. It deserializes the JSON response into an AccountSettingsResponse object (from the NuGet package).
  5. The results from all endpoints are aggregated.
  6. The aggregated data is transformed into a List<AccountSettingsV2ResponseModel> (the V2 BFF response model) and returned. During this mapping, the ApiVersion property is set to "v2".

Save account settings

public async Task<bool> SaveAccountSettings(string gcn, AccountSettingsV2SaveRequestModel accounts, CancellationToken cancellationToken)

• Description: Saves or updates V2 account settings, routing them to the correct downstream APIs based on business unit.
• Logic:
  1. Groups the incoming accounts.Records by BusinessUnit.
  2. For each BusinessUnit group:
     • It finds the corresponding downstream ASEndpoint from the configuration.
     • It transforms the list of V2 records (AccountSettingsV2RecordsModel) into a V1 AccountSettingsAddRequest object, which is the model expected by the downstream API.
     • It calls a private SaveAccountSettingsToEndpoint helper method.
  3. The helper method obtains a JWT, creates an authenticated HttpClient, and makes a POST request with the AccountSettingsAddRequest payload to the api/v1/account-settings endpoint of the downstream API. Note: The V2 BFF service calls V1 of the core API.
  4. The method tracks the success of each individual save operation. It returns true only if all operations, across all targeted business units, were successful.

Key Private Helpers

• AccessToken(): A private async method that uses the injected _jwtTokenService to fetch a valid JWT access token.
• CreateAuthenticatedHttpClient(...): A private method that uses IHttpClientFactory to create an HttpClient, sets its BaseAddress, and adds the Authorization: Bearer <token> header.