https://github.com/veliovgroup/near-jobs

https://github.com/veliovgroup/near-jobs

Last synced: 2 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/veliovgroup/near-jobs
• Owner: veliovgroup
• Created: 2021-04-14T12:28:54.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2022-10-19T08:14:05.000Z (over 2 years ago)
• Last Synced: 2025-03-01T02:33:47.784Z (4 months ago)
• Language: JavaScript
• Size: 1.47 MB
• Stars: 0
• Watchers: 3
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Jobs board for NEAR project

Jobs board website for NEAR project powered by GitHub issues

Stack:

- Node.js / Meteor.js

- MongoDB

- Jade / Blaze

- SASS

- PWA

## Functional description

- Repositories:

  1. [`jobs`](https://github.com/near/openweb-jobs) — Where issues are job posts only

  2. [`profiles`](https://github.com/near/openweb-profiles) — Where issues are either candidates or companies/projects

- Data entities:

  - Candidate (job seeker's page) - GitHub issue from `profiles` repository with `candidate` label

  - Company/Project - GitHub issue from `profiles` repository with `company` label

  - Job posts - GitHub issue from `jobs` repository with `job` label

  - Job response — GitHub issue' comment under issue at `jobs` repository with `job` label

  - Job offer — GitHub issue' comment under issue at `profiles` repository with `candidate` label

- Tags/Labels

  - `candidate`

  - `company`

  - `job`

  - Prefixed with `type:` are job type labels, e.g. `type:full-time`

  - Prefixed with `category:` are category type labels, e.g. `category:evangelist`

  - Prefixed with `skill:` are skills type labels, e.g. `skill:javascript`

## Pages

- Landing page

  - Search (fully featured text search)

    - Search through job posts

    - Search through candidates

    - Search through companies/projects

  - Latest jobs list

- Search results page

  - Search field

  - Filter options

  - List of search results

- Create new account/sign up

  - Login via GitHub

  - Select account type `['candidate', 'company']`

- Job post page

  - Description

  - Link: Apply to job

  - Link: Open company/project page

  - Tags

    - Type

    - Category

    - Required Skills

- Apply to a job page/form

- Post a job page/form

- Projects list page

  - List of companies/projects with title, short description, and link

  - Pagination

- Project/Company page

  - Description

  - List of open jobs posted under this project/company

- My profile page (Company/Project)

  - Company/Project description

  - Add/Update company/project description

  - Link to "my" jobs page (search page with filter by creator)

- My profile page (Candidate)

  - Candidate description

  - Add/Update candidate description

  - List of applied jobs

## UX (user story)

- Post a job

    a. Post an issue via Near `jobs` repository. It would get synced to the website

    b. Post a new job via the website form. It would get synced to GitHub issues

- Post candidate/CV

    a. Post an issue via Near `profiles` repository following "issue template," it would get synced to the website

    b. Fill candidate form via the website. It would get synced to GitHub issues

- Post project/company profile

    a. Post an issue via Near `profiles` repository following "issue template," it would get synced to the website

    b. Fill company form via the website. It would get synced to GitHub issues

- Apply for a job

    a. Post a comment under an issue at Near `jobs` repository

    b. Fill "apply for a job" form via the website. It would get posted as a comment under "job" issue at to GitHub `jobs` repository

When creating an issue via GitHub, we will use "issue template" to suggest the user follow the same template across all job posts and profiles. When creating the issue via website UI, all fields will be composed together following the same template across all job posts and profiles.

## Development stage instructions

This project is build on top of Meteor.js, Blaze, SASS, and Node.js

### Prerequisites

1. [Install meteor.js](https://www.meteor.com/developers/install)

2. Install NPM dependencies by executing `meteor npm install` within project's directory

### Running locally

To run project locally two environment variables are required `ACCOUNTS_GITHUB_ID` and `ACCOUNTS_GITHUB_SEC`:

```shell

ACCOUNTS_GITHUB_ID="xxx" ACCOUNTS_GITHUB_SEC="yyyyy" ROOT_URL="http://127.0.0.1:5555" meteor --port 5555

```

`ROOT_URL` variable and `--port` flag are optional.