feat: added interaface for processing product coupon assignment sheets

[Anas12091101]

What are the relevant tickets?

https://github.com/mitodl/hq/issues/6582

Description (What does it do?)

This PR adds the interface for processing product coupon assignment sheets in ecommerce admin. The UI will only be accessible to people having permissions to add and update ProductCouponAssignment model.

Screenshots (if appropriate):

Users with only adding and deleting a coupon permissions

Users with adding and changing ProductCouponAssignment model permissions

Form Validations when using ID

Form Validations when using Title

Success response from API

Error response from API

How can this be tested?

• Create some test coupons on http://localhost:8053/ecommerce/admin/coupons/. Make sure you select only one product at the time of coupon creation to automatically create CouponEligibility object which is required for processing sheets.
• Follow https://pygsheets.readthedocs.io/en/stable/authorization.html to get the Service Account Key. Set this key in DRIVE_SERVICE_ACCOUNT_CREDS environment variable
• Grant your service account owner permissions
• Now, create a Shared Drive folder in your google drive.
• Create a folder inside the shared drive. I named it Sheets xPRO when creating one for local testing.
• In the Sheets xPRO folder, create a spread sheet with name prefixed by Enrollment Codes - . See this shared drive I created when testing for reference. I would still need to give you access so feel free to request one.
• In the .env file add the following variables:

  SHEETS_ADMIN_EMAILS = "[email protected], [email protected]" # Your main and service account emails
  DRIVE_OUTPUT_FOLDER_ID=1vz6ZepeCX4lGMrFQmy8PB3Kk6IDGbfQ2 # Id of the folder Sheets xPRO (Can be found in URL)
  DRIVE_SHARED_ID=0AIbxGdFEImI3Uk9PVA # Id of the shared drive (Can be found in URL)
  

• Give editor access to service account in both spreadsheet and parent folder(Sheets xPRO in our case)
• Your sheets setup is complete and ready to use.
• On a private window login with a test account with no permissions assigned
• From the test account go to http://localhost:8053/ecommerce/admin/. You should get a 403
• Grant the test account permissions to add and update ProductCouponAssignment.
• Now reload the ecommerce/admin page. Click the Process Coupon AssignmentSheet link.
• In the spreadsheet you created in the above steps, add the following row:

| Coupon Code | Email (Assignee) | Status   | Status Date         | URL                | Redeemed |
|-------------|-----------------|----------|----------------------|---------------------|----------|
| {Code you created above} | [email protected] | enrolled | 2/18/2025 6:50:18 | [xpro.mit.e](https://xpro.mit.e) | 0 |

• Copy the spreadsheet ID from the spreadsheet URL and paste it in the text box at /ecommerce/admin/process-coupon-assignment-sheets/
• Click the Process Coupon Sheet button
• You should be able to see a success page (see the screenshot above)
• You should also receive an email:

• Clicking the email link should open the checkout page with the coupon applied.
• For processing the sheet with title, add another row with the code (created for a different product) in the sheet
• Select the Use Title Sheet radio button and enter the title of the sheet in the text box
• You should be able to see a success page (see the screenshot above). You should receive an enrollment email.
• Clicking the email link should open the checkout page with the coupon applied.
• In the form, inputting an invalid ID or title should result in the error page as shown in the screenshots above.

Additional Context

To fix the problem, we need to ensure that detailed error messages are logged on the server side, and a generic error message is returned to the user. This can be achieved by modifying the exception handling block to log the exception message and return a generic error message.

1. Import the logging module if not already imported.
2. Log the detailed error message using the log object.
3. Return a generic error message to the user.