README.md

Digital Apprenticeships Service

RoATP Apply Service

This incorporates the web front end (SFA.DAS.ApplyService.Web) and the api that services it (SFA.DAS.ApplyService.InternalApi) Licensed under the MIT license

	RoATP Apply Service
Info	A service which allows an 'approved' Training Provider (ATP) to register (on RoATP).
Build
Web	https://localhost:6016/

Description

Developer Setup

Requirements

• Install .NET Core 8 SDK
• Install [SQL Server 2017 Developer Edition] or later (https://go.microsoft.com/fwlink/?linkid=853016)
• Install SQL Management Studio
• Install Azure Storage Emulator (Make sure you are on v5.3)
• Install Azure Storage Explorer
• Install the editor of your choice:
  • Jetbrains Rider
  • Visual Studio Code
  • Visual Studio 2019 with these workloads:
    • ASP.NET and web development

Setup

• Clone this repository
• Open Visual Studio as an administrator

Publish Database

• Build the solution SFA.DAS.ApplyService.sln
• Either use Visual Studio's Publish Database tool to publish the database project SFA.DAS.ApplyService.Database to name {{database name}} on {{local instance name}}

Config

• Grab the das-apply-service configuration json file from das-employer-config
• Create a Configuration table in your (Development) local Azure Storage account.
• Add a row to the Configuration table with fields: PartitionKey: LOCAL, RowKey: SFA.DAS.ApplyService_1.0, Data: {The contents of the local config json file}.
• Alter the SqlConnectionString value in the json to point to your database.
• Grab the GovSignIn configuration json file from das-employer-config
• Create a Configuration table in your (Development) local Azure Storage account.
• Add a row to the Configuration table with fields: PartitionKey: LOCAL, RowKey: SFA.DAS.Apply.GovSignIn_1.0, Data: {The contents of the local config json file}.

To run a local copy you will also require

• Login Service
• QnA API
• RoATP Service

To use RoATP admin functionality; you will need to have the following projects running:

• Admin Service
• RoATP Service
• RoATP Gateway
• RoATP Assessor
• RoATP Oversight

Running the code

The default JSON configuration was created to work with dotnet run:

• Navigate to src/SFA.DAS.ApplyService.Web/

  • run dotnet restore
  • run dotnet run
  • Open https://localhost:6016

• Navigate to src/SFA.DAS.ApplyService.InternalApi/

  • run dotnet restore
  • run dotnet run

Sign Up

If you need to use the Sign Up functionality, there's some additional setup required:

• Install ngrok
• Run ngrok http 5999 (This will create a secure tunnel to your local Internal API that can be called from the outside world, specifically DfE SignIn)
• Edit your json config in Azure Storage and set the DfeSignIn.CallbackUri value to {the secure url ngrok gave you}/Account/Callback. For example, https://c226e61e.ngrok.io/Account/Callback.
• This will enable DfE SignIn to send a message back when Sign Up is complete with the DfE SignIn Id.

Other Useful Information

Confluence JIRA

Initial application process is as follows:

• Create Sign In Account
• Read & accept Conditions of Acceptance
• Enter UKPRN to find company deals
• Enter 'Preamble' information
• Decide which type of Training Provider type you are

You will then be presented with a Task List with a list of sections containing questions, which must be answered appropriately.

Depending on your Training Provider type, some questions & sections may be Not Required

Depending on how you answered some questions, you may be presented with a Shutter Page which means you cannot proceed futher with your application.

Once you have filled out an application, you will then submit it for Assessment - Gateway Assessment - (i.e. legal checks) - Financial Assessment - Blind Assessor & Moderation - Oversight