Skip to content

Open edX micro-frontend application for managing e-commerce information.

License

Notifications You must be signed in to change notification settings

Syed-Ali-Abbas-Zaidi/frontend-app-ecommerce

 
 

Repository files navigation

Build Status Codecov npm_version npm_downloads license semantic-release

frontend-app-ecommerce

Please tag @edx/revenue-squad on any PRs or issues.

Introduction

This is a micro-frontend application responsible for the display of an authenticated user's single purchase order history and subscription history. Additional work has been done and is in-progress to enable receipt pages in this application, currently hosted in ecommerce.

Installation

This MFE is bundled with Devstack, see the Getting Started section for setup instructions.

  1. Install Devstack using the Getting Started instructions.

  2. Start up Devstack, if it's not already started.

  3. Log in to Devstack (http://localhost:18000/login )

  4. Within this project, install requirements and start the development server:

    npm ci
    npm start # The server will run on port 1996
    

    Note: We prefer npm ci over npm install to match the way CI and production builds work and avoid unintentional changes to package-lock.json when doing other work. Note, however, that using npm ci can obscure necessary updates to package-lock.json that may have accidentally been left out of prior commits. If npm install changes package-lock.json, those are changes that should be checked in.

  5. Once the dev server is up, visit http://localhost:1996 to access the MFE

    ./docs/images/localhost_preview.png

    Note: the alert will always display if subscriptions repo is not setup locally

  6. (Optional) For edx developers, they can set up the subscriptions repo for viewing subscription history

Environment Variables/Setup Notes

This MFE is configured via environment variables supplied at build time. All micro-frontends have a shared set of required environment variables, as documented in the Open edX Developer Guide under Required Environment Variables.

To have ecommerce send users to this receipt page (instead of its own), there are two items to set in ecommerce: 1) Django admin waffle flag: enable_receipts_via_ecommerce_mfe 2) ECOMMERCE_MICROFRONTEND_URL environment variable

This micro-frontend has no additional required environment variables.

Known Issues

None

Development Roadmap

This MFE is currently in maintenance mode, as we have no further development planned for it. However, if we want to pull more ecommerce interfaces out into a micro-frontend, this would be where they should live. Note that frontend-app-payment contains the checkout flow.

Anyone merging to this repository is expected to release and monitor their changes; if you are not able to do this DO NOT MERGE, please coordinate with someone who can to ensure that the changes are released.


About

Open edX micro-frontend application for managing e-commerce information.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 94.4%
  • Makefile 3.2%
  • SCSS 1.9%
  • HTML 0.5%