Admin track applicants frontend

.github/workflows/backend_build.yml

@@ -0,0 +1,34 @@
+name: Backend build
+
+on:
+  push:
+    branches: ['main']
+  pull_request:
+    branches: ['main']
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Use NodeJS 24.x
+      uses: actions/setup-node@v4
+      with:
+        node-version: 24.x
+        cache: 'yarn'
+
+    - name: Create .env file
+      run: |
+
+        echo "AWS_BUCKET_NAME=dummy" >> .env
+        echo "AWS_SECRET_ACCESS_KEY=dummy" >> .env
+        echo "AWS_ACCESS_KEY_ID=dummy" >> .env
+        echo "AWS_REGION=us-east-2" >> .env
+
+    - name: Install Dependencies
+      run: yarn install
+
+    - name: Build backend
+      run: npx nx build backend

.github/workflows/frontend_build.yml

@@ -0,0 +1,34 @@
+name: Frontend build
+
+on:
+  push:
+    branches: ['main']
+  pull_request:
+    branches: ['main']
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Use NodeJS 24.x
+      uses: actions/setup-node@v4
+      with:
+        node-version: 24.x
+        cache: 'yarn'
+
+    - name: Create .env file
+      run: |
+
+        echo "AWS_BUCKET_NAME=dummy" >> .env
+        echo "AWS_SECRET_ACCESS_KEY=dummy" >> .env
+        echo "AWS_ACCESS_KEY_ID=dummy" >> .env
+        echo "AWS_REGION=us-east-2" >> .env
+
+    - name: Install Dependencies
+      run: yarn install
+
+    - name: Build frontend
+      run: npx nx build frontend

.github/workflows/jest.yml

@@ -0,0 +1,35 @@
+name: Jest run
+
+on:
+  push:
+    branches: ['main']
+  pull_request:
+    branches: ['main']
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Use NodeJS 24.x
+      uses: actions/setup-node@v4
+      with:
+        node-version: 24.x
+        cache: 'yarn'
+
+    - name: Create .env file
+      run: |
+
+        echo "AWS_BUCKET_NAME=dummy" >> .env
+        echo "AWS_SECRET_ACCESS_KEY=dummy" >> .env
+        echo "AWS_ACCESS_KEY_ID=dummy" >> .env
+        echo "AWS_REGION=us-east-2" >> .env
+
+    - name: Install Dependencies
+      run: yarn install
+
+    - name: Run Jest tests 
+      run: yarn test

.github/workflows/lint.yml

@@ -0,0 +1,27 @@
+name: Linter run
+
+on:
+  push:
+    branches: ['main']
+  pull_request:
+    branches: ['main']
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Use Node.js 24.x
+      uses: actions/setup-node@v4
+      with:
+        node-version: 24.x
+        cache: 'yarn'
+
+    - name: Install Dependencies
+      run: yarn install
+
+    - name: Run linter
+      run: yarn lint

README.md

@@ -1,41 +1,63 @@
-# Scaffolding
+## BHCHP Application and Admin Portal - Setup for local development
 
-<a alt="Nx logo" href="https://nx.dev" target="_blank" rel="noreferrer"><img src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-logo.png" width="45"></a>
+### Setting up the database
+Windows
+- Download [PostgreSQL](https://www.postgresql.org/download/windows/)
+- Say yes/ or check the box when it asks if you want to install PgAdmin with it
+  - Alternatively install [PgAdmin 4](https://www.pgadmin.org/download/) separately
+- Make username postgres, password can be anything you will remember
 
-✨ **This workspace has been generated by [Nx, a Smart, fast and extensible build system.](https://nx.dev)** ✨
-
-## Setup
-
-Clone this repo and run `yarn` at the root to install this project's dependencies.
+MacOS
+- You can use brew to install. You may need to install pgadmin separately, [link](https://www.postgresql.org/download/macosx/)
+```
+brew install postrgesql
+```
+- Also you need to start postgres
+```
+brew services start postgresql
+```
+- Make username postgres, password can be anything you will remember 
 
-You can optionally install `nx` globally with `npm install -g nx` - if you don't, you'll just need to prefix the commands below with `npx` (e.g. `npx nx serve frontend`).
+To set up the database, open PgAdmin. Once you have set up your postgres credentials, right click on the Databases dropdown. You may need to create a Server first. You will need the default password for postgres to do this, which is root. Select “Create/-> “Database…”. Name the database exactly bhchp. 
 
-## Start the app
+### Adding tables and dummy data
+You will need to run the migrations which adds the tables from the repo to your database
+```
+npm run migration:run 
+```
 
-To start the development server run `nx serve frontend`. Open your browser and navigate to http://localhost:4200/. Happy coding!
 
-## Running tasks
+### Setting up the dependencies
+- Clone this repo
+- Run `yarn` at the root (in vscode) to install this project's dependencies.
+- You can optionally install nx globally with:
+```
+npm install -g nx
+```
+- if you don't, you'll just need to prefix the commands below with `npx` (e.g. `npx nx serve frontend`).
 
-To run just the frontend (port 4200):
+### Setting up your environment
+- Make a copy of `example.env` (in `/apps/example.env`)
+- Rename the copy to EXACTLY `.env` - If you name it anything else you risk leaking security credentials!
 
+### Running the application
+- To run just the frontend (port 4200):
 ```
 nx serve frontend
 ```
-
-To run just the backend (port 3000):
-
+- To run just the backend (port 3000):
 ```
 nx serve backend
 ```
-
-To run both the frontend and backend with one command:
-
+- Run both in the same terminal:
 ```
 nx run-many -t serve -p frontend backend
 ```
 
-## Other commands
-
-Run `git submodule update --remote` to pull the latest changes from the component library
-
-When cloning the repo, make sure to add the `--recurse-modules` flag to also clone the component library submodule (e.g. `git clone --recurse-submodules https://github.com/Code-4-Community/scaffolding.git` for the `scaffolding` repo)
+### Testing with Postman
+- Download [Postman](https://www.postman.com/)
+- Open postman
+- Set the parameter to GET
+- Enter `http://localhost:3000/api`
+- Press SEND
+- if the backend setup was successful, you should see a 200 OK response

apps/backend/src/app.controller.spec.ts

@@ -1,5 +1,4 @@
 import { Test, TestingModule } from '@nestjs/testing';
-
 import { AppController } from './app.controller';
 import { AppService } from './app.service';
 

apps/backend/src/app.controller.ts

@@ -2,6 +2,9 @@ import { Controller, Get } from '@nestjs/common';
 
 import { AppService } from './app.service';
 
+/**
+ * Higher-level controller that exposes all sub-controller endpoints.
+ */
 @Controller()
 export class AppController {
   constructor(private readonly appService: AppService) {}

apps/backend/src/app.module.ts

@@ -3,11 +3,41 @@
 
 import { AppController } from './app.controller';
 import { AppService } from './app.service';
-import { TaskModule } from './task/task.module';
+import { AWSS3Module } from './aws-s3/aws-s3.module';
 import AppDataSource from './data-source';
+import { UtilModule } from './util/util.module';
+import { ApplicationsModule } from './applications/applications.module';
+import { ApplicantsModule } from './applicants/applicants.module';
+import { LearnerInfoModule } from './learner-info/learner-info.module';
+import { VolunteerInfoModule } from './volunteer-info/volunteer-info.module';
+import { Application } from './applications/application.entity';
+import { AdminsModule } from './users/admins.module';
+import { UsersModule } from './users/users.module';
+import { Admin } from './users/admin.entity';
+import { ConfigModule } from '@nestjs/config';
+import { DisciplinesModule } from './disciplines/disciplines.module';
 
 @Module({
-  imports: [TypeOrmModule.forRoot(AppDataSource.options), TaskModule],
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+      envFilePath: '../../.env',
+    }),
+    TypeOrmModule.forRoot({
+      ...AppDataSource.options,
+      migrations: [], // Don't load migrations when server starts - only load them when running migration commands (i had to add this to get the server to run without errors)
+    }),
+    UtilModule,
+    AdminsModule,
+    UsersModule,
+    AWSS3Module,
+    TypeOrmModule.forFeature([Application]),
+    DisciplinesModule,
+    LearnerInfoModule,
+    VolunteerInfoModule,
+    ApplicationsModule,
+    ApplicantsModule,
+  ],
   controllers: [AppController],
   providers: [AppService],
 })