Skip to content

Ivan-Wang-tech/firepit

 
 

Repository files navigation

Product vision statement

Our vision is to build an interactive and inclusive Job Forum web application where students and professionals can discover job opportunities, share experiences, and connect through posts and comments.

User stories

As a visitor:

  • I want to browse available job listings so that I can learn about open opportunities.
  • I want to register or sign in easily so that I can set up my own account.

As a user:

  • I want to search job posts by keyword, location, or company so that I can quickly find relevant openings.
  • I want to comment under posts so that I can discuss or ask questions.
  • I want to delete my own comments so that I can manage my interactions responsibly.
  • I want to create new posts so that I can share insights or opportunities with others.
  • I want to be able to edit my posts so that I can upadte new info
  • I want to able to delete my posts so that I can remove mistaken contents
  • I want to save or bookmark posts that I find useful so that I can easily revisit them later
  • I want to reply to comments under my post so that I can engage in direct conversations and clarify information.
  • I want to upvote/like posts and comments so that helpful content surfaces.
  • I want to edit my profile so that others understand my background.

As an admin:

  • I want to review and remove inappropriate content so that the community stays professional and safe.
  • I want to suspend or reinstate user accounts so that the community stays safe.

Steps necessary to run the software

1) Clone

git clone https://github.com/swe-students-fall2025/2-web-app-404found.git
cd 2-web-app-404found

2) Env

cp env.example .env

Tip: Edit .env with real values: MONGO_URI / NAME

3) Deps

python -m pip install --user pipenv Windows: py -m pip install --user pipenv
pipenv install
pipenv shell

4) Run

flask run

Notice

  • Click the link shown in terminal to open the site
  • When finished: Ctrl + C to stop, exit to leave the shell, and exit VPN if needed

Task boards

We use GitHub Projects to track progress during each sprint:

About

Firepit is an interactive and inclusive job forum web application designed for students and professionals to discover job opportunities, share career experiences, and build meaningful connections through posts and discussions.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages

  • HTML 92.1%
  • Python 3.9%
  • CSS 3.7%
  • Shell 0.3%