solar-configurator-microsite-offset-service

Offset Service (BFF - Backend for Frontend)

This service handles any Salesforce interactions for the solar configurator front-end, including getting offset information, access token.

This app was created with a cdk init --language=typescript and modified from there.

Please see the companion Postman collection for demonstration on use.

Useful commands

These commands from the CDK init boilerplate

• npm run build compile typescript to js
• npm run watch watch for changes and compile
• npm run test perform the jest unit tests
• cdk deploy deploy this stack to your default AWS account/region
• cdk diff compare deployed stack with current state
• cdk synth emits the synthesized CloudFormation template

Deploying

This package runs within the Lerna-controlled monorepo, and is deployed by using GitHub Actions from the root directory of the repository (../.github/workflows).

Service Endpoint details

Get Offset

This endpoint returns the offset data from SFDC and an access token that can be used for other endpoints that need authorization.

Request

POST /ecomm-offset/offset

type body = {
  address: string;
  state: string;
  utility: string;
};

Response

type response = {
  access_token: string; // JWT
  maxBatteriesAllowed: number;
  maxProductionOffset: number;
  statesAllowed: Array<string>;
};

AWS Resources

Dashboard

Environment	URL
Production	prd-Quote-Dashboard
Staging	majstg-Quote-Dashboard
Development	devmaj-Quote-Dashboard

Lambdas

Get JWT Function

Environment	URL
Production	prd-GetJWT
Staging	majstg-GetJWT
Development	devmaj-GetJWT

Offset Rules Function

Environment	URL
Production	prd-OffsetRules
Staging	majstg-OffsetRules
Development	devmaj-OffsetRules

Disaster Recovery

Please read the disaster recovery plan.