The New Job Survey Admin tool will assist BC Stats in administering the BCPS New Job Survey.
- Ensure the .NET Core SDK 3.1.20 (on the linked page, scroll down and expand the 3.1.2 disclosure arrow to find the correct SDK) is installed.
- Ensure you have the .NET EF Core CLI installed:
dotnet tool install dotnet-ef --version 6.0.0 - Ensure the .NET Core HTTPS development certificate is trusted.
- Install Postgres and create a
database named
njsa. - Check out the code from this repository.
NB. To be fully functional, the application should be run in conjunction with the CallWeb API. The code for the CallWeb API is not publicly available. Please reach out to the project team for access. However, the project will still build and run without the CallWeb API.
dotnet tool install dotnet-ef --version 6.0.0
dotnet add package Microsoft.EntityFrameworkCore --version 3.1.4
dotnet add package Microsoft.EntityFrameworkCore.Design --version 3.1.4
The application uses two appsettings.json files, one in the /config
directory and one in /secret. This mirrors how the application gets
deployed to OpenShift. /config/appsettings.json contains non-sensitive
configuration for the application, while /secret/appsettings.json contains
configuration that should not readily visible.
See also the comments in Program.cs about how the files get resolved when the application is deployed to OpenShift.
To get set up:
-
Copy the contents of
/config/appsettings.config-template.jsoninto a new file,/config/appsettings.json, and update the values as appropriate. -
Do the same with
/secret/appsettings.secret-template.json, copying it into/secret/appsettings.json. -
We also need to set up the frontend environment. In the
/ClientAppdirectory, copyenv.exampleinto.env, and update the values as appropriate.
-
From the root project directory, run
dotnet ef database update. This will run the migrations and set up your development database. ENSURE THAT dotnet add package Microsoft.EntityFrameworkCore --version 3.1.4 dotnet add package Microsoft.EntityFrameworkCore.design --version 3.1.4Note that the database will be seeded automatically when the application is started.
- Open the root code directory in Visual Studio Code. You may be prompted to add required assets and/or resolve dependencies; do so.
- While in Visual Studio Code, press CTRL + F5 to launch the API.
- Test that the API is running correctly by checking the HealthStatus. If
the project is running at the default location and port:
curl http://localhost:5050/api/HealthStatus/Status.
- From the
/ClientAppdirectory runyarn install.
- Still in the
/ClientAppdirectory, runyarn startto launch the front-end. You should see the application open in a new browser.
This command will quickly drop the database, delete migrations, create an initial migration, and update the database.
dotnet ef database drop --force;rm -rf Migrations/*.cs;dotnet ef migrations add InitialCreate;dotnet ef database update
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent