bcgov / bcgov/lcfs

User Story

Open
#618 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
6
Forks
6
Avg merge
2d 7h
Merged PRs (30d)
87

Description

**Title:**

**Description:**

**Wireframe:**

**Purpose and benefit to user:**

### Acceptance Criteria

- **Given** I am a BCeID user, **when** I open the Notional Transfer Input Form page, **then** I see the title "Notional transfer of eligible renewable fuel".
- **Given** I am a BCeID user, **when** I view the form, **then** I see an explanation text explaining the purpose of the form.
- **Given** I am a BCeID user, **when** I input information into the form, **then** I can see the validation component display to check for errors.
- **Given** I am a BCeID user, **when** I input data into the form, **then** I can enter the legal name of the trading partner, the address for service, select a fuel category from a dropdown, select either "Received" or "Transferred" from a dropdown, and enter a quantity (in liters) that cannot be negative.
- **Given** I am a BCeID user, **when** I need to add more entries, **then** I can click the "Add rows" button to add five more rows.
- **Given** I am a BCeID user, **when** I have completed the form, **then** I can click the "Save & return to report" button to save the data and return to the main report.

### Development Checklist

- [ ] Create the Notional Transfer Input Form page with the title "Notional transfer of eligible renewable fuel".
- [ ] Add an explanation text section to the form (text to be confirmed by the business area).
- [ ] Implement a validation component that checks for errors in the form.
- [ ] Use AG Grid to create a table with the following columns:
- Legal name of trading partner | Free form text | No validation required
- Address for service | Free form text (or predictive text) | No validation required
- Fuel Category | Dropdown | No input allowed
- Received OR Transferred | Dropdown | No input allowed
- Quantity (L) | Free form text | Must be non-negative
- [ ] Add a button labeled "Add rows" below the table to add five more rows at a time.
- [ ] Include AG Grid validation for each column to ensure correct data entry.
- [ ] Add a "Save & return to report" button to save the form data and return to the main compliance report.

### Notes

- Ensure the form adheres to Section 30 of the Low Carbon Fuels Act, which requires reporting notional transfers of renewable fuel volumes.
- Validation checks should be robust to prevent incorrect data entry, especially for the quantity column.
- Ensure the user interface is intuitive and user-friendly for BCeID users.
- The form should be tested thoroughly to ensure all acceptance criteria are met.

Contributor guide

Open the contributing guide

Research direction

No files or tests are named. Start by locating the existing main compliance report and related form patterns, then review how AG Grid tables and validation are used. Done means the new form meets the listed fields, row-addition behavior, validation rules, save-and-return flow, and acceptance criteria.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
frontend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.