Skip to content
forked from bcgov/embc-ess

Emergency Management BC - Emergency Social Services Modernization

License

Notifications You must be signed in to change notification settings

asanchezr/embc-ess

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

embc-ess

Emergency Management BC - Emergency Support Services Modernization

Technology Stack

Layer Technology
Presentation Angular 7
API and Business Logic C# - Dotnet Core 2.1
Web Server Kestrel
Runtime OpenShift containers

Knowledgebase

Throughout the project there are readme documents. Those specific documents can be browsed from the knowledgebase.

Installation

This application is meant to be deployed to RedHat OpenShift version 3. Full instructions to deploy to OpenShift are in the openshift directory.

Developer Prerequisites

  • .Net Core 2.1 SDK
  • Node.js version 8 LTS
  • Angular 6

Project structure

project
+-- embc-app
|  +-- embc-app.sln             (solution file for Visual Studio 2017+)
|  +-- embc-app.csproj          (main application project)
+-- embc-interfaces
|  +-- BCeID 
|     +-- BCeID.csproj          (proxy to consume BCeID web services)
+-- embc-unit-tests
|  +-- embc-unit-tests.csproj
+-- openshift
|  +-- other-templates
|  |  +-- sql-server             (sql server templates)
|  +-- templates
|  |  +-- embcess                (main app templates)
|  |  +-- pdf-service            (pdf rendering service templates)
+-- pdf-service                 (pdf rendering service code
+-- sql-scripts                 (scripts for backend ops on the data)
+-- sql-server                  (SQL Server docker scripts) 

Backend Unit Tests

Run dotnet test from embc-app folder

Backend local machine debugging

Set the following environment variables:

SET ASPNETCORE_Environment=Development
//WIP: SET BASE_URL=/embcess

Execute dotnet run from embc-app folder

Environment Variables

Name Value

|

DevOps

  • RedHat OpenShift tools
  • Docker
  • A familiarity with Jenkins

DevOps Process

Jenkins

If any pipeline steps do not start, a common root cause is issues with Jenkins. Restart the Jenkins service by scaling it down to 0 pods, then back up to 1 pod.

DEV builds

Dev builds are triggered by source code being committed to the repository. This process triggers a webhook which initiates the DEV build pipeline.

Promotion to TEST

Login to the OpenShift Web Console and navigate to the Tools project for the system. Go to Builds->Pipelines. Click Start Pipeline on the Test Pipeline.

Promotion to PROD

Login to the OpenShift Web Console and navigate to the Tools project for the system. Go to Builds->Pipelines. Click Start Pipeline on the Prod Pipeline.

Authentication

BCeID

Business BCeID may be used to login as a Volunteer.

IDIR

Government users may use IDIR to login as an Administrator.

Development Users

Access /login/token/username to login as a test BCeID user for development purposes.

Environments

Environment URL VPN Required?
DEV https://dev.justice.gov.bc.ca/embcess Yes
TEST https://test.justice.gov.bc.ca/embcess Yes
PROD https://justice.gov.bc.ca/embcess No

Contribution

Please report any issues.

Pull requests are always welcome.

If you would like to contribute, please see our contributing guidelines.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

License

Copyright 2019 Province of British Columbia

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at 

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Maintenance

This repository is maintained by BC Attorney General.

About

Emergency Management BC - Emergency Social Services Modernization

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 68.2%
  • HTML 27.0%
  • TypeScript 4.3%
  • CSS 0.3%
  • Shell 0.1%
  • Dockerfile 0.1%