PeerPrep Monorepo User Guide

Prerequisites for PeerPrep Monorepo:

1. Yarn: Ensure you have the latest version of Yarn installed. Yarn Workspaces is available in Yarn v1.0 and later.

2. Installation (if not already installed):

   npm install -g yarn

3. Node.js: Check each application's documentation for the recommended Node.js version.

4. Git (Optional but Recommended):

5. Docker (If deploying with Docker):

6. Kubernetes Tools (If deploying with Kubernetes):

---

Adjust these prerequisites based on the specific requirements of your services / frontend.

Structure:

/peerprep
├── /services
│   ├── /admin-service (express application)
│   ├── /user-service (express application)
│   ├── /matching-service (express application)
│   ├── /question-service (express application)
│   ├── /collaboration-service (express application)
│   └── /gateway (express application)
├── /frontend
│   └── /pages for peerprep (NextJs application)
├── /deployment
│   ├── /docker
│   └── /kubernetes
├── .env (not in git)
├── .env.firebase_emulators_test (not in git)
└── README.md (and other root-level files & docs)

Getting Started - Local Development:

1. Ensure that you have an .env file at the root directory with the following variables:

   PRISMA_DATABASE_URL=<redacted>
   MONGO_ATLAS_URL=<redacted>
   FIREBASE_SERVICE_ACCOUNT=<redacted>
   NEXT_PUBLIC_FRONTEND_FIREBASE_CONFIG={"apiKey": <redacted>,"authDomain": <redacted>,"projectId": <redacted>,"storageBucket": <redacted>,"messagingSenderId": <redacted>,"appId": <redacted>}

Note: For NEXT_PUBLIC_FRONTEND_FIREBASE_CONFIG, the JSON should not have newlines since Next.js may not process it correctly.

1. Installing secret detection hooks: From the root directory, run:

   pip install pre-commit
   pre-commit install

Disclaimer: There is no guarantee that all secrets will be detected. As a tip, if you think a file will eventually store secrets, immediately add it to .gitignore upon creating it in case you forget later on when you have a lot more files to commit.

1. Installing Dependencies: From the root directory (/peerprep), run:

   yarn install

   or

   yarnpkg install

   (if you have hadoop yarn installed)

   This command will install dependencies for all services and the frontend in a centralized node_modules directory at the root.

2. Adding Dependencies: To add a dependency to a specific workspace (e.g., user-service), use:

   yarn workspace user-service add [dependency-name]

3. Initializing Prisma: In the root file, run the following:

   yarn prisma generate ## Do this whenever we change the models in schema.prisma

4. Running Backend Scripts: To run a script specific to a workspace (e.g., the start script for user-service), use:

   yarn workspace user-service start

5. Running Frontend Scripts: To run the frontend cod, use:

   yarn workspace frontend dev ## For development
   
   # or
   
   yarn workspace frontend build ## For first time setup run the build command
   yarn workspace frontend start ## For subsequent runs

6. Running everything at once: To run everything at once and still maintain the ability to hot-reload your changes, use:

   ./start-app-no-docker.sh # on mac /linus
   
   # You can also use the above command on Windows with Git Bash
   

Getting Started - Docker:

Docker and Docker Compose are used to set up a simulated production build (meaning that the Docker images and containers that will be spun up locally are almost identical to those in the production environment, with the exception of some environment variables).

1. Run yarn docker:build: From the root repo, run

yarn docker:build 

This will create new Docker images.

1. Run yarn docker:devup: From the root repo, run

yarn docker:devup 

This will start all the containers.

1. Once done, run yarn docker:devdown: From the root repo, run

yarn docker:devdown 

This will stop and delete all the containers.

If you want to do all the above steps at once, see the below section

Run the start-app-with-docker.sh script: From the root repo, run

./start-app-with-docker.sh # on mac / linus

# You can also use the above command on Windows with Git Bash

This will create new Docker images everytime it is run. Be careful of how much disk space you have left.

Any edits you make to the source code will not be automatically reflected on the site. We recommend using Docker Compose to check if your changes are likely to work on the production environment once they have been proven to work in your local development environment.

Notes:

• After setting up Yarn Workspaces, any node_modules directories in individual services or applications can be safely removed.
• Always ensure thorough testing after adding or updating dependencies to ensure all parts of the system function as expected.

Prisma Notes

Next steps:

1. Set the PRISMA_DATABASE_URL in the .env file to point to your existing database. If your database has no tables yet, read https://pris.ly/d/getting-started
2. Set the provider of the datasource block in schema.prisma to match your database: postgresql, mysql, sqlite, sqlserver, mongodb or cockroachdb.
3. Run prisma db pull to turn your database schema into a Prisma schema.
4. Run prisma generate to generate the Prisma Client. You can then start querying your database.

Firebase Local Emulator Suite

The Firebase Local Emulator Suite is used to support automated testing of any Firebase-related functionality.

The following files at the project root define the Firebase project as well as the emulators used:

• .firebaserc - The Firebase project definitions
• firebase.json - The emulators that are used

For local testing, the file used for passing in environment variables has to be named:

.env.firebase_emulators_test

This file should contain the following environment variables:

FIREBASE_AUTH_EMULATOR_HOST="127.0.0.1:9099"
FIREBASE_SERVICE_ACCOUNT={insert secret JSON value here}

In the CI environment, the environment variables have to be defined separately. For example, FIREBASE_SERVICE_ACCOUNT will be passed in as a secret on GitHub Actions.