LCFS - Calculate and display compliance units issued for the export of fuel in the compliance period (line 19 of the compliance summary section)
- Dominant language
- Python
- Stars
- 6
- Forks
- 6
- Avg merge
- 2d 4h
- Merged PRs (30d)
- 87
Description
**Description:**
Add functionality to calculate and display compliance units issued for the export of fuel in the current compliance period. This involves calculating negative compliance units to neutralize positive compliance units previously earned for fuel supply in B.C. using the reported volumes in the Fuel for Export schedule.
**Wireframe:** [Link](https://preview.uxpin.com/da68049c0af15edd7ce4e47e4bee431fed40c30d#/pages/169090266/simulate/sitemap)
**Purpose and benefit to user:**
To provide users with a precise calculation of the negative compliance units being issued for the export of fuel in the current period, ensuring compliance with the new Act and neutralizing previously earned credits for exported fuel.
**Acceptance Criteria:**
- [ ] Given I am a BCeID user, When I view the compliance report, then I see the total amount of negative compliance units being issued for the export of fuel in the current period displayed in Line 19.
- [ ] Given I am a BCeID user, When the system calculates the compliance units for exported fuel, then it uses the specified formula for each line of volume reported in the Fuel for Export schedule and multiplies the result by -1:
- Compliance Units = ((TCI - (RCI + UCI)) / EER) * (Q * ED) * -1
- [ ] Given I am a BCeID user, When the system pulls data from the Fuel for Export schedule, then it accurately calculates and displays the negative compliance units in Line 19.
**Development Checklist:**
- [ ] Implement logic to calculate compliance units using the formula for each line of volume reported in the Fuel for Export schedule:
- Compliance Units = ((TCI - (RCI + UCI)) / EER) * (Q * ED) * -1
- [ ] Sum the calculated negative compliance units for the current period and display the total in Line 19.
- [ ] Ensure the calculation handles volumes reported in the Fuel for Export schedule correctly and multiplies the result by -1 to display negative compliance units.
- [ ] Test the calculation logic, data retrieval, and display to ensure accuracy and proper functionality.
- [ ]
**Notes:**
- Confirm the data retrieval process for reported volumes in the Fuel for Export schedule.
- Ensure the calculation formula is accurately implemented and tested for various scenarios.
- Refer to Section 30 of the Low Carbon Fuels Act for reporting requirement is needed.
Contributor guide
Research direction
Locate the Fuel for Export schedule data path and the compliance report's Line 19 display entry point. Start by tracing how reported volumes are retrieved, then review Section 30 of the Low Carbon Fuels Act and the stated formula. Done means the current-period negative units are summed, displayed in Line 19, and covered by calculation, retrieval, and display tests.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- full-stack
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 38/100