cis-contractor-frontend

A Scala/Play frontend service for the Construction Industry Scheme (CIS), enabling contractors to manage their subcontractors on the HMRC Tax Platform.

The service supports the following journeys:

• Adding subcontractors — individuals, companies, partnerships, and trusts
• Verifying subcontractor details with HMRC
• Amending existing subcontractor records
• Managing contractor details

The service is bilingual, supporting both English and Welsh.

Running the service

Start all dependent services via Service Manager:

sm2 --start CIS_ALL

To run locally (default port 6998):

sbt run

Upstream dependencies

Service	Port
auth	8500
construction-industry-scheme	6994
construction-industry-scheme-external-stub	6997
address-lookup-frontend	9028
feedback-frontend	9514

Testing

Run unit tests:

sbt test

Run integration tests:

sbt it/test

Check code coverage (minimum 78% statement coverage required):

sbt clean coverage test it/test coverageOff coverageReport

Before committing, run the full pre-commit script which formats code, compiles, runs all tests, and checks coverage:

./run_all_tests.sh

License

This code is open source software licensed under the Apache 2.0 License.