azy64/azaria-fork

A kind of freelancing website for College.

PHive

A kind of freelancing website for College
Explore the docs »

View Demo · Report Bug · Request Feature

About The Project

A kind of freelancing website for College. Where Lecturer can publish his/her project here waiting students apply to work on the project. Student will get some kind of rewards like salary and/or certification.

Features:

• Commons
  • Explore Project
  • Leaderboard
  • Profile
  • Message
  • Inbox
• Lecturer
  • Project Publications (Posting - Recruit - Review)
  • Project Box (to Organize Project)
  • Hire Student
• Student
  • Apply Project (as Individual / as Team)
  • Party (for make the Team)
  • Project Box (to See current Apply/Ongoing/Finished projects)
  • Wishlist Project
• Experiment
  • Adaptive while being Responsive (Mobile version is Mobile Apps-like)

Built With

• Laravel
• VueJS
• Sass

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

• npm
• composer
• AMP stack
  • Apache HTTP Server
  • MySQL
  • PHP

Installation

1. Clone the repo

   git clone https://github.com/ivqonsanada/phive.git

2. Get into the project

   cd phive

3. Install the frontend packages (NPM)

   npm install

4. Install the backend packages

   composer install

Usage

Bare Metal

1. Make .env file by copy the .env.example

   cp .env.example .env

2. Edit .env file to setup database connection

   DB_DATABASE=db_name
   DB_USERNAME=user_to_access_the_db
   DB_PASSWORD=user_password

3. Set application key

   php artisan key:generate

4. Create tables using migration with dummy data

   php artisan migrate:fresh --seed

5. Create the frontend production ready files

   npm run prod

6. Run the app

   php artisan serve

7. Try dummy account

   # student
   username = student@example.com
   password = password
   
   # lecturer
   username = lecturer@example.ac.id
   password = password

Using Docker Compose

1. Install Docker and Docker Compose

2. Run through steps 1 and 2 from bare metal installation

   DB_HOST=db

3. Start the containers

   docker compose up -d

4. Try dummy account

   # student
   username = student@example.com
   password = password
   
   # lecturer
   username = lecturer@example.ac.id
   password = password

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Team:

• Ivqonnada Al Mufarrih - Full Stack Engineer - @ivqonsanada - ivqonnada@gmail.com
• Verrel Radiman - Designer - @verrel
• Aji R. Gumiwang - Tester

Project Link: https://github.com/ivqonsanada/phive

Acknowledgements

• Laravel-Vue SPA starter kit