Feature: Environment.ts Updates [ Work in Progress ]

.docker/init.sql

@@ -0,0 +1,2 @@
+create database if not exists involvemint;
+

.gitignore

@@ -2,9 +2,6 @@
 # environment file
 environment.ts
 
-# Ignore package lock files
-package-lock.json
-
 # compiled output
 /dist
 /tmp

README.md

@@ -1,41 +1,115 @@
 # Official involveMINT Web App Repository
 
-## Setting Up Environment
+## Build Prerequisites
 
 Prerequisites:
 
-- Nodejs
-- Postgres database named `involvemint` running on localhost port 5432 with username `postgres` and password `1Qazxsw2`
-- Visual Studio Code
+- Node.js
+- Docker
 
-### Steps
+## Steps to Set Up Environment
 
-1. Clone repository
+1. Fork and clone this repository. Ensure that you uncheck the "copy main branch only" checkbox. Once you forked the repository, clone it to a directory on your local machine and `cd` into it.
 
-```sh
-git clone [email protected]:v3/involvemint/involveMINT/involvemint2.0
-```
+2. Checkout the "develop" branch: `git checkout develop`.
+3. Ensure you have Node.js installed. If you don't, please look at the section on [installing node.js](#installing-nodejs).
+4. Ensure you have Docker installed. If you don't, please navigate to the [official website](https://docs.docker.com/get-docker/) and follow the instructions. Run `docker --version` in your terminal after it's installed to ensure you have installed everything correctly.
 
-2. Change directory into repository
+### Installing Node.js
 
-```sh
-cd involvemint2.0
-```
+Run the following commands.
 
-3. Install dependencies
+1. `curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash`
+2. `export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"`
+3. `[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"`
+4. Refresh your shell (close and reopen). If you're using zsh, here's a shortcut: `source ~/.zshrc`
+5. If the following command does not throw an error, you're good so far: `nvm -v`
+6. `nvm install --lts`
+7. `nvm use --lts`
 
-```sh
-npm install
-```
+### Configuring Firebase
 
-4. Start client
+In order to run this code, you will need to navigate to [firebase](https://console.firebase.google.com/). You will see a screen that looks like ![firebase-landing](/assets/firebase-landing.png) and click "Create a project" (if you don't already have a GCP account and an existing project where you want to use Firebase). Once you have a project, you should see a screen like ![this](assets/firebase-dashboard.png) Once here, click the little gear and you'll see a screen that looks like ![this](assets/firebase-settings.png) Select the "Service accounts" tab and you'll see a screen that looks like ![this](assets/firebase-service-accounts.png) Hit the "Manage service account permissions" hyperlink which will take you to your GCP project. You will see a screen that looks like ![this](/assets/googlecloud-service-accounts.png). Click the account and then hit the "Keys" tab. You should see a screen that looks like ![this](/assets/service-account-keys.png). Click "Add Key" and then choose the "JSON" option to download it as a JSON file.
 
-```sh
-npx ng s
-```
+Ensure you are in the project directory (the directory that this file is in). Run the following command: `cp libs/shared/domain/src/lib/environments/environment.ts libs/shared/domain/src/lib/environments/environment.prod.ts` and open the new file (environment.prod.ts) in your editor. It should look like this at first:
+
+```typescript
+import { Env } from './environment.interface';
 
-5. In another terminal, start server
+const host = 'localhost';
 
-```sh
-npx ng s api
+/** Develop environment variables. */
+export const environment: Env = {
+  production: false,
+  test: false,
+  host,
+  apiUrl: `http://${host}:3335`,
+  appUrl: `http://${host}:4202`,
+  storageBucket: 'your storage bucket',
+  adminPasswordHash:
+    'sZfCJx5X3sGSwkokIs9IVFxDfxWd2lEKsAhkOSDfEK8u2YS98y5rJAmXmtrJs7AQ29xkHMmz0bDfLkXCKS9/+A==',
+  gcpApiKey: 'insert your key here',
+  typeOrmConfig: {
+    type: 'postgres',
+    host: '127.0.0.1',
+    port: 5432,
+    username: 'postgres',
+    password: '1Qazxsw2',
+    database: 'involvemint',
+    synchronize: true,
+    autoLoadEntities: true,
+    ssl: false,
+  },
+  firebaseEnv: {
+    apiKey: 'insert your key here',
+    authDomain: 'firebase auth domain',
+    databaseURL: '',
+    projectId: 'your project id',
+    storageBucket: 'Your project storage bucket', //your-something.appspot.com
+    messagingSenderId: '',
+    appId: 'your app id',
+    measurementId: 'Your measurementId',
+  },
+  // mailgun and twilio are optional
+  mailgun: {
+    apiKey: '',
+    domain: '',
+  },
+  twilio: {
+    accountSid: '',
+    authToken: '',
+    sendingPhone: '',
+  },
+  gcp: {
+    type: 'service_account',
+    project_id: 'project-id',
+    private_key_id: 'Your Private Key',
+    private_key: '-----BEGIN PRIVATE KEY-----\nYour Private Key\n-----END PRIVATE KEY-----\n',
+    client_email: 'Your client email',
+    client_id: 'client id',
+    auth_uri: 'https://accounts.google.com/o/oauth2/auth',
+    token_uri: 'https://oauth2.googleapis.com/token',
+    auth_provider_x509_cert_url: 'https://www.googleapis.com/oauth2/v1/certs',
+    client_x509_cert_url: 'cert url',
+  },
+  // I don't think this is used
+  scrypt: {
+    memCost: 14,
+    rounds: 8,
+    saltSeparator: 'Bw==',
+    signerKey: 'de/PQ/Gy53mgslvUgDUKDCgHJPArYqbFnGILLQZNe5My/CvqIThVL/CsndU8oudZ9lc4B7PT8w3sAar2/luQxA==',
+  },
+};
 ```
+
+Under the key "typeOrmConfig", please change the password field to "postgres". Under the key "gcp", please change the fields to match the fields in your service account JSON file that you just downloaded in the previous step.
+
+### Starting the Containers
+
+Run `docker compose up` in the root directory, which will spin up a PostgreSQL database on port 5432 and a PgAdmin UI on port 8889.
+
+### Starting the Apps
+
+Open a terminal and run `npm i` to install all the required packages. Once done, run `export NODE_OPTIONS=--openssl-legacy-provider` because otherwise there will be an error with OpenSSL. To start the client, run `npm run start:client`. To start the server, open a new terminal, export the same environment variable as before (`export NODE_OPTIONS=--openssl-legacy-provider`), run `npm run build`, and then `npm run start`.
+
+For any issues, or to suggest improvements to this documentation, please contact Anish Sinha <<[email protected]>>

angular.json

@@ -99,6 +99,14 @@
                   "maximumError": "10kb"
                 }
               ]
+            },
+            "org": {
+              "fileReplacements":[
+                {
+                  "replace": "libs/shared/domain/src/lib/environments/environment.ts",
+                  "with": "libs/shared/domain/src/lib/environments/environment.org.ts"
+                }
+              ]
             }
           }
         },
@@ -115,6 +123,9 @@
             },
             "test": {
               "browserTarget": "involvemint:build:test"
+            },
+            "org": {
+              "browserTarget": "involvemint:build:org"
             }
           }
         },
@@ -158,6 +169,9 @@
             },
             "test": {
               "devServerTarget": "involvemint:serve:test"
+            },
+            "org": {
+              "devServerTarget": "involvemint:serve"
             }
           }
         },
@@ -192,6 +206,10 @@
                 {
                   "replace": "libs/shared/domain/src/lib/environments/environment.ts",
                   "with": "libs/shared/domain/src/lib/environments/environment.prod.ts"
+                },
+                {
+                  "replace": "libs/shared/domain/src/lib/environments/environment.api.ts",
+                  "with": "libs/shared/domain/src/lib/environments/environment.prod.api.ts"
                 }
               ]
             },
@@ -203,6 +221,22 @@
                 {
                   "replace": "libs/shared/domain/src/lib/environments/environment.ts",
                   "with": "libs/shared/domain/src/lib/environments/environment.test.ts"
+                },
+                {
+                  "replace": "libs/shared/domain/src/lib/environments/environment.api.ts",
+                  "with": "libs/shared/domain/src/lib/environments/environment.test.api.ts"
+                }
+              ]
+            },
+            "org": {
+              "fileReplacements":[
+                {
+                  "replace": "libs/shared/domain/src/lib/environments/environment.ts",
+                  "with": "libs/shared/domain/src/lib/environments/environment.org.ts"
+                },
+                {
+                  "replace": "libs/shared/domain/src/lib/environments/environment.api.ts",
+                  "with": "libs/shared/domain/src/lib/environments/environment.org.api.ts"
                 }
               ]
             }
@@ -213,6 +247,11 @@
           "options": {
             "buildTarget": "api:build",
             "port": 2324
+          },
+          "configurations": {
+            "org":{
+              "buildTarget": "api:build:org"
+            }
           }
         },
         "lint": {

apps/api/src/main.ts

@@ -1,4 +1,4 @@
-import { environment } from '@involvemint/shared/domain';
+import { apiEnvironment, environment } from '@involvemint/shared/domain';
 import { NestFactory } from '@nestjs/core';
 import * as admin from 'firebase-admin';
 import {
@@ -10,7 +10,7 @@ import { AppModule } from './app/app.module';
 initializeTransactionalContext();
 patchTypeORMRepositoryWithBaseRepository();
 
-admin.initializeApp({ credential: admin.credential.cert(environment.gcp) });
+admin.initializeApp({ credential: admin.credential.cert(apiEnvironment.gcp) });
 
 async function bootstrap() {
   // const app = await NestFactory.create<NestFastifyApplication>(AppModule, new FastifyAdapter());

apps/migrate/src/app/app.service.ts

@@ -24,6 +24,7 @@ import {
 } from '@involvemint/server/core/domain-services';
 import {
   Address,
+  apiEnvironment,
   ChangeMaker,
   Credit,
   Enrollment,
@@ -855,7 +856,7 @@ export class AppService {
       return null;
     }
 
-    const geo = geocoder.default({ provider: 'google', apiKey: environment.gcpApiKey });
+    const geo = geocoder.default({ provider: 'google', apiKey: apiEnvironment.gcpApiKey });
     const res = await geo.geocode(address);
 
     const a = res[0];

docker-compose.yml

@@ -0,0 +1,27 @@
+version: '3.8'
+
+services:
+  postgres:
+    hostname: postgres
+    container_name: postgres
+    image: postgres
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: postgres
+      POSTGRES_INITDB_ARGS: '-A md5'
+    ports:
+      - '5432:5432'
+    volumes:
+      - ./.docker/init.sql:/docker-entrypoint-initdb.d/init.sql
+  pgadmin:
+    container_name: pgadmin
+    image: dpage/pgadmin4
+    environment:
+      PGADMIN_DEFAULT_EMAIL: [email protected]
+      PGADMIN_DEFAULT_PASSWORD: involvemint
+    ports:
+      - '8889:80'
+    hostname: pgadmin
+    depends_on:
+      - postgres

libs/server/core/application-services/src/lib/ep-application/ep-application.service.ts

@@ -4,6 +4,7 @@ import {
   HandleRepository,
 } from '@involvemint/server/core/domain-services';
 import {
+  apiEnvironment,
   BaSubmitEpApplicationDto,
   defaultStorefrontListingStatus,
   environment,
@@ -172,7 +173,7 @@ export class EpApplicationService {
       user: { id: true, changeMaker: { firstName: true } },
     });
 
-    const geo = geocoder.default({ provider: 'google', apiKey: environment.gcpApiKey });
+    const geo = geocoder.default({ provider: 'google', apiKey: apiEnvironment.gcpApiKey });
     const res = await geo.geocode(Object.entries(epApp.address).join(' '));
 
     const lat = Number(res[0]?.latitude?.toFixed(4));

libs/server/core/application-services/src/lib/exchange-partner/exchange-partner.service.ts

@@ -1,5 +1,6 @@
 import { ExchangePartnerRepository } from '@involvemint/server/core/domain-services';
 import {
+  apiEnvironment,
   DeleteEpImageDto,
   EditEpProfileDto,
   environment,
@@ -79,7 +80,7 @@ export class ExchangePartnerService {
     }
 
     if (dto.changes.address) {
-      const geo = geocoder.default({ provider: 'google', apiKey: environment.gcpApiKey });
+      const geo = geocoder.default({ provider: 'google', apiKey: apiEnvironment.gcpApiKey });
       const res = await geo.geocode(Object.entries(dto.changes.address).join(' '));
       dto.changes.latitude = Number(res[0]?.latitude?.toFixed(4));
       dto.changes.longitude = Number(res[0]?.longitude?.toFixed(4));

libs/server/core/application-services/src/lib/sp-application/sp-application.service.ts

@@ -4,6 +4,7 @@ import {
   SpApplicationRepository,
 } from '@involvemint/server/core/domain-services';
 import {
+  apiEnvironment,
   environment,
   ImConfig,
   ProcessSpApplicationDto,
@@ -99,7 +100,7 @@ export class SpApplicationService {
       user: { id: true, changeMaker: { firstName: true } },
     });
 
-    const geo = geocoder.default({ provider: 'google', apiKey: environment.gcpApiKey });
+    const geo = geocoder.default({ provider: 'google', apiKey: apiEnvironment.gcpApiKey });
     const res = await geo.geocode(Object.entries(spApp.address).join(' '));
 
     const lat = Number(res[0]?.latitude?.toFixed(4));

libs/shared/domain/src/lib/environments/.gitignore

@@ -1,3 +1,6 @@
 environment.prod.ts
+environment.prod.api.ts
 environment.test.ts
-environment.ts
+environment.test.api.ts
+environment.org.ts
+environment.org.api.ts

libs/shared/domain/src/lib/environments/environment.api.ts

@@ -0,0 +1,20 @@
+import { ServiceEnv } from "./environment.interface.api";
+/** Develop environment variables. */
+export const apiEnvironment: ServiceEnv = {
+    gcp: {
+        type: 'service_account',
+        project_id: 'project-id',
+        private_key_id: 'Your Private Key',
+        private_key:
+            '-----BEGIN PRIVATE KEY-----\nYour Private Key\n-----END PRIVATE KEY-----\n',
+        client_email: 'Your client email',
+        client_id: 'client id',
+        auth_uri: 'https://accounts.google.com/o/oauth2/auth',
+        token_uri: 'https://oauth2.googleapis.com/token',
+        auth_provider_x509_cert_url: 'https://www.googleapis.com/oauth2/v1/certs',
+        client_x509_cert_url:
+            'cert url',
+    },
+    gcpApiKey: 'insert your key here',
+    production: false
+}

libs/shared/domain/src/lib/environments/environment.interface.api.ts

@@ -0,0 +1,10 @@
+/**
+ * Environment file for api
+ * @type {{production: boolean; gcpApiKey: string; gcp: {}}}
+ */
+export interface ServiceEnv {
+    production: boolean;
+    gcpApiKey: string;
+    // eslint-disable-next-line @typescript-eslint/ban-types
+    gcp: object;
+}