How dfe-digital/fh-connect-families-support-testing works
Project type and purpose
• This is a test-automation repository (“fh-connect-families-support-testing”) built on Node.js/Yarn and Cypress.
• Its sole purpose is to validate the Referral Service and Dashboard applications across development and test environments, via end-to-end and regression suites.
File structure
• Top-level tooling/config:
• .github/workflows/test-referralUi-regression.yml → CI pipeline for regression on GitHub Actions
• config.json → likely hostnames, API keys or environment flags
• package.json / yarn.lock → Node dependencies (Cypress, plugins)
• Cypress test organization:
• cypress/e2e/01-referral-service/... → grouped by feature (Dashboard, Professional Form, Service Directory Filters, VCS Dashboard, end-to-end tests)
• cypress/fixtures → test data (Excel, JSON)
• cypress/support → custom commands and global hooks (adminCommands.js, apiCommands.js, referralCommands.js)
• No backend code here—tests invoke deployed applications or local instances.
README insights
• Describes two target applications (Referral service, Dashboard) and two environments (development on “develop” branch; test on “main”).
• Cypress tests are invoked via Yarn scripts, and regression is automated through GitHub Actions.
Elements
• Developer → Yarn script → Cypress
• Cypress → SUT (HTTP / UI)
• GitHub Actions → Yarn install / cypress run
• Cypress → Report Store
• Rectangles for compute components (Developer, CI, Cypress)
• Rounded rectangles for external systems (Referral Service, Dashboard)