QA Test Script: Rulemaking search & commenting application #6918
Description
Tested on stage environment.
Reporting Issues
When reporting issues, please include:
- Section & Test Case: Reference the specific test from this script
- Steps to Reproduce: Detailed steps that led to the issue
- Expected Result: What should have happened
- Actual Result: What actually happened
- Environment: Browser, device, OS
- Screenshots: If applicable
Related Pull Requests
1. Data Synchronization & Integrity (ITSS team, website and OGC)
1.1 Real-Time Data Sync
New Rulemaking Creation
- Create a new rulemaking in the internal application (OGC in FRAPS)
- Verify it appears on the website within expected timeframe (all)
- Check all fields display correctly (REG number, name, status, dates, etc.) (OGC/all)
Rulemaking Updates
- Update an existing rulemaking's comment period (open/close dates) (OGC)
- Verify changes reflect on the website in real-time (all)
- Test updating document associations (OGC)
- Confirm "Open for comments" status updates correctly (all)
Document Updates
- Add new documents to a rulemaking (OGC)
- Remove documents from a rulemaking (OGC)
- Verify document list updates on both datatable and single pages (all)
1.2 S3 Bucket Validation
File Structure (ITSS/website team)
- Verify correct folder organization in S3
- Check file naming conventions are consistent
File Accessibility (ITSS/website team)
- Test team's direct S3 access for documents
- Verify PDF viewer loads documents correctly on single rulemaking pages (all)
- Random sample of PDFs open correctly (all)
- Files match what's in the internal system (all)
2. Search & Datatable Functionality (OGC/website team)
2.1 Keyword Search
Basic Search
- Simple single keyword search
- Multi-word keyword search
- Boolean operators (+ (and), | (or), - (not))
- Quoted phrases ("exact match")
Proximity Search
- Test proximity searches with different gap values
- Combine proximity with keyword searches
- Verify modal functionality for proximity search
- Try searching very long search strings
- Search with no results
2.2 Filtering
Document Type Filter
- Filter by single document type
- Combine document type with keyword search
- Clear filters and verify reset
"Open for Comment" Checkbox
- Check the box and verify only open rulemakings show
- Uncheck and verify all rulemakings return
- Combine with other filters
2.3 DataTable Functionality
Sorting
- Sort by REG number (ascending/descending)
- Sort by name
- Sort by "Open for comments" date
- Verify sorting works with filters active
Pagination
- Navigate through multiple pages
- Change page size (10, 25, 50, 100 entries)
- Verify counts are accurate
- Test pagination with filters
Column Display
- REG number links work correctly
- REG name and documents display properly
- "Open for comments" status shows correctly
- Comment deadline dates format: "[full month name] [date], [YYYY]"
3. Single Rulemaking Page (OGC/website team)
3.1 Page Layout
Basic Information
- REG number displays correctly
- REG name displays correctly
- Comment period information (if applicable)
- Key documents section (hides if empty)
Document Display
- All documents list correctly
- Document links work
- PDF viewer loads and displays documents
- Responsive layout across device widths
3.2 PDF Viewer
- Test PDF loading from S3
- Test navigation within PDFs
- Test on multiple browsers (Chrome, Firefox, Safari, Edge)
3.3 Entity Tables
- Verify entity data displays correctly
- Test sorting functionality
- Check responsive behavior
3.4 Navigation
- Breadcrumb navigation works
- Link back to datatable works
- Direct URL access to specific rulemaking works (e.g.,
/legal/rulemakings/2024-10/)
4. Commenting Interface (OGC/website team)
4.1 Form Flow & Progress
Initial Selection
- "Self" option skips additional commenters screen
- "Counsel" option shows law firm fields
- "Other" option shows connection description
- Progress bar updates correctly at each step
- Progress bar has visible boundary
Multi-Step Navigation
- "Next step" button works
- Form "Back" button maintains form data
- Breadcrumb navigation is clear
- Step indicators update correctly
4.2 Form Validation
Required Fields
- Name fields (submitter and commenters)
- Email addresses
- Comment text
- "I'm not a robot" reCAPTCHA
Field-Specific Validation
- Email format validation
- Phone number format (only for if testifying)
- Connection description (for "Other" option)
- Law firm information (for "Counsel" option)
Dynamic Fields
- Add multiple commenters functionality
- Remove commenters functionality
- Testify checkbox shows/hides phone field
- Field labels change based on initial selection
4.3 File Upload
Allowed File Types
- Upload .pdf, .doc, .docx files successfully
- Block disallowed file types
File Size Limits
- Test individual file size limit (MAX_FILE_SIZE)
- Test 3 files can be uploaded per form submission
- Check error messages are clear
Upload Process
- Progress indicators work
- Multiple file uploads
- File removal before submission
- Upload success/failure messages
4.4 reCAPTCHA
- reCAPTCHA displays correctly
- Cannot submit without completing reCAPTCHA
4.5 Submission
Successful Submission
- Form submits without errors
- Success message displays
- Prevent duplicate submissions
- Data appears in internal system
- Files uploaded to correct storage location
4.6 UI/UX
- Tooltip icons display correctly and associate with proper fields
- Tooltip auto-closes when moving to next step
- Responsive design across devices:
- Mobile
- Tablet
- Desktop
- All text is readable and properly sized
- Form fields have appropriate padding/spacing
5. API Integration (OGC/website team)
- Datatable API returns correct data
- Single rulemaking API returns complete information
- Comment submission API works
6. Accessibility (OGC/website team)
Keyboard Navigation
- All form fields accessible via Tab
- Submit buttons keyboard accessible
- Search and filters keyboard accessible
Metadata
Metadata
Assignees
Type
Projects
Status