Developing Locally

Prerequisites

WEB (front-end)

• Node JS (>6.11.4 && <= 8.0.0)
• NPM (>5.3.0 && <= 5.3.0)

API (back-end)

• Visual Studio (>2015)
• Download smtp dummy server
• DB2
  • download and install VS 2015 with update 3
  • download install DB2 express-c (Not Docker version)
  • download and install IBM Data studio
  • download and install "IBM Data Server Client Packages" special_35279_ntx64_dsdriver_EN.exe
  • download and install "IBM Database Add-Ins for Visual Studio" [ibm_database_addins_for_visualstudio_v11.1.exe] (https://www-01.ibm.com/marketing/iwm/iwm/web/reg/pick.do?source=swg-daivs&lang=en_US)
  • download and install "dotConnect for DB2" dotConnect for DB2 2.2 Professional Trial

Setup

1. Clone this repository to your local machine

git clone "https://github.com/18F/dol-whd-14c.git"
cd dol-whd-14c

Front-End

1. cd into DOL.WHD.Section14c-WEB
2. checkout desired branch in git

git checkout <branch-name>

4. edit env.js environment variables; use api_url of integration environment -- changes to this file will not effect deployment. If you add variables to this file, they will not be used in deployment. If you need to add additional environment variables that will be used in deployment, you must also edit the src/deploy/env.js file to include placeholders that can be recognized by the parameters.xml in the same directory (this env.js file should not contain any actual values, secrets, or urls).

5. run

npm install && npm start

6. visit https://localhost:3333 in your browser

** NOTE: use log.info instead of console.log for development

Backend

1. Start local db2 server
2. Open Visual Studio solution file in DOL.WHD.Section14c.API folder
3. Edit connection string in DOL.WHD.Section14c.API/Web.config with your username and password for db2.
4. Build project and visit https://localhost:44399 in your browser to browse the API.