Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
H
Hire-Guru
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Analytics
Analytics
CI / CD
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Rishikumar
Hire-Guru
Commits
4cb9d4b1
Commit
4cb9d4b1
authored
May 21, 2026
by
Aravind RK
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
added gitignore and updated readme file
parent
1f589799
Changes
4
Show whitespace changes
Inline
Side-by-side
Showing
4 changed files
with
123 additions
and
91 deletions
+123
-91
.gitignore
.gitignore
+40
-0
Backend/.gitignore
Backend/.gitignore
+5
-0
Frontend/.gitignore
Frontend/.gitignore
+4
-44
README.md
README.md
+74
-47
No files found.
.gitignore
0 → 100644
View file @
4cb9d4b1
# Dependency directories
node_modules/
**/node_modules/
# Local env configs
.env
.env.local
.env.*.local
**/.env
**/.env.local
# Backend upload caches
Backend/uploads/*
!Backend/uploads/.gitkeep
# IDE / Editor configuration
.vscode/
.idea/
*.suo
*.ntvs*
*.njsproj
*.sln
*.swp
# Angular build caches
.angular/
Frontend/.angular/
Frontend/dist/
dist/
# OS-generated files
.DS_Store
Thumbs.db
ehthumbs.db
# Log files
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
Backend/.gitignore
0 → 100644
View file @
4cb9d4b1
node_modules/
.env
uploads/*
!uploads/.gitkeep
*.log
Frontend/.gitignore
View file @
4cb9d4b1
# See https://docs.github.com/get-started/getting-started-with-git/ignoring-files for more about ignoring files.
# Compiled output
/dist
/tmp
/out-tsc
/bazel-out
# Node
/node_modules
npm-debug.log
yarn-error.log
# IDEs and editors
.idea/
.project
.classpath
.c9/
*.launch
.settings/
*.sublime-workspace
# Visual Studio Code
.vscode/*
!.vscode/settings.json
!.vscode/tasks.json
!.vscode/launch.json
!.vscode/extensions.json
!.vscode/mcp.json
.history/*
# Miscellaneous
/.angular/cache
.sass-cache/
/connect.lock
/coverage
/libpeerconnection.log
testem.log
/typings
__screenshots__/
# System files
.DS_Store
Thumbs.db
node_modules/
.angular/
dist/
*.log
README.md
View file @
4cb9d4b1
...
...
@@ -65,64 +65,91 @@ Hire Guru implements strict role-based dashboard layouts tailored to each stakeh
---
## 🛠️ Local Installation & Setup
## 🛠️ Local Machine Setup & Installation
Follow these exact steps to configure your local laptop environment after cloning the repository.
### 📋 Prerequisites to Install on Your Laptop
Before running the application, make sure you have the following installed globally on your machine:
1.
**Node.js (LTS Version 18 or 20+)**
*
Download from:
[
nodejs.org
](
https://nodejs.org/
)
2.
**MongoDB Community Server (v6.0 or v7.0+)**
*
Download from:
[
mongodb.com
](
https://www.mongodb.com/try/download/community
)
*
Ensure your MongoDB service is running locally on default port
`27017`
.
3.
**Ollama (Local AI Engine)**
*
Download from:
[
ollama.com
](
https://ollama.com/
)
*
After installation, open your terminal/command prompt and pull the default Llama model:
```
bash
ollama pull llama3.2
```
*
Ensure the Ollama application is running in the background (
`ollama serve`
).
### 1. Clone the Repository
```
bash
git clone https://github.com/AravindR-K/Quiz-Master.git
cd
Quiz-Master
```
### 2. Backend Configuration
Open the
`Backend`
directory and install dependencies:
```
bash
cd
Backend
npm
install
```
Create a
`.env`
file inside the
`Backend`
folder:
```
env
PORT=3000
MONGODB_URI=your_mongodb_connection_uri
JWT_SECRET=your_secure_jwt_secret_key
OLLAMA_URL=http://localhost:11434
```
To seed the initial administrative accounts and sample data:
```
bash
npm run seed
```
---
Start the backend node dev server:
```
bash
npm run dev
```
### 🚀 Step-by-Step Setup Guide
### 3. Frontend Setup
Open a new terminal session in the project root:
#### **Step 1: Clone the Repository**
```
bash
cd
Frontend
npm
install
git clone https://github.com/AravindR-K/Quiz-Master.git
cd
Quiz-Master
```
Start the Angular server:
```
bash
npm run start
# or: ng serve
```
Open
[
http://localhost:4200/
](
http://localhost:4200/
)
in your web browser.
#### **Step 2: Configure and Run Backend Server**
1.
Navigate into the
`Backend`
directory:
```
bash
cd
Backend
```
2.
Install all backend packages:
```
bash
npm
install
```
3.
Create a
`.env`
file in the
`Backend`
folder to configure local credentials:
```
env
PORT=3000
MONGODB_URI=mongodb://127.0.0.1:27017/hireguru
JWT_SECRET=super_secure_hire_guru_jwt_token_secret_key_98765
OLLAMA_URL=http://127.0.0.1:11434
OLLAMA_MODEL=llama3.2
```
4.
**Seed the Database**
: Populate default administrative, staff, candidate accounts, and default questionnaires:
```
bash
npm run seed
```
5.
Start the Backend Node development server:
```
bash
npm run dev
```
*The server will boot and listen on: `http://localhost:3000`*
#### **Step 3: Configure and Run Frontend Client**
1.
Open a new terminal window or tab, return to the project root, and enter the
`Frontend`
folder:
```
bash
cd
Frontend
```
2.
Install all frontend Angular packages:
```
bash
npm
install
```
3.
Start the Angular local web server:
```
bash
npm run start
```
*The frontend will run and serve on: `http://localhost:4200`*
---
## 🔑
Seeding / Default Login Credentials
## 🔑
Default Login Credentials (After Seeding)
If the database seed script is executed successfully, use the following details to log in and inspect the dashboard
s:
Once you navigate to
`http://localhost:4200/login`
, you can inspect each role's dashboard panel using these pre-seeded profile
s:
*
**Administrator**
:
`admin@quizapp.com`
/
`admin123`
*
**HR Coordinator**
:
`hr@quizapp.com`
/
`hr123`
*
**Project Manager**
:
`pm@quizapp.com`
/
`pm123`
*
**Interviewer**
:
`interviewer@quizapp.com`
/
`interviewer123`
*
**Sample Candidate**
:
`candidate@quizapp.com`
/
`candidate123`
| Role | Email Address | Password |
| :--- | :--- | :--- |
|
**Administrator**
|
`admin@quizapp.com`
|
`admin123`
|
|
**HR Coordinator**
|
`hr@quizapp.com`
|
`hr123`
|
|
**Project Manager (PM)**
|
`pm@quizapp.com`
|
`pm123`
|
|
**Interviewer**
|
`interviewer@quizapp.com`
|
`interviewer123`
|
|
**Candidate (Student)**
|
`candidate@quizapp.com`
|
`candidate123`
|
---
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment