/laravel-gitscrum

GitScrum is powerful Virtual Assistant that lets you control your issues, user stories and sprints - Free, open and simple

Primary LanguagePHPMIT LicenseMIT

Laravel GitScrum


Site: https://www.gitscrum.com | Community and Issues : https://www.gitscrum.com/community


Overview | Installation | Setup | Screens | Questions and Issues | Contributing | License


Facebook Group: https://www.facebook.com/groups/gitscrum/


Laravel 5.4 Total Downloads License


Login GitScrum


Overview

Laravel GitScrum is a free application developed in Laravel 5.4. The aim is help the developer teams to use Git and Scrum on task management of the day-to-day.

Available in English, Chinese, Russian, German, Arabic, Spanish, Portuguese, Italian, French, Indonesian, Serbian, Hungarian and Vietnamese.

Laravel GitScrum in gitter.im : https://gitter.im/laravel-gitscrum/Lobby

Features

GitScrum can be integrated with Github or Gitlab or Bitbucket.

  • Product Backlog contains the Product Owner's assessment of business value

  • User Story is a description consisting of one or more sentences in the everyday or business language that captures what a user does or needs to do as part of his or her job function.

    Features: Acceptance criteria, prioritization using MoSCoW, definition of done checklist, pie chart, assign labels, team members, activities, comments and issues.

  • Sprint Backlog is the property of the development team and all included estimates are provided by development team. Often an accompanying sprint planning is the board used to see and change state of the issues.

    Features: Sprint planning using Kanban board, burndown chart, definition of done checklist, effort, attachments, activities, comments and issues.

  • Issue is added in user story to one sprint backlog, or directly in sprint backlog. Generally, each issue should be small enough to be easily completed within a single day.

    Features: Progress state (e.g. to do, in progress, done or archived), issue type (e.g. Improvement, Support Request, Feedback, Customer Problem, UX, Infrastructure, Testing Task, etc...), definition of done checklist, assign labels, effort, attachments, comments, activities, team members.

GitScrum Dashboard

GitScrum Board

GitScrum Sprint

Installation

The requirements to Laravel GitScrum application is:

  • PHP - Supported Versions: >= 7.1
  • Webserver: Nginx or Apache
  • Database: MySQL, or Maria DB

Use Docker - Containers: php7, nginx and mysql57

Composer Package

$ composer create-project gitscrum-community/laravel-gitscrum --stability=stable --keep-vcs
$ cd laravel-gitscrum

Important: If you have not yet installed composer: Installation - Linux / Unix / OSX

Git Clone

$ git clone git@github.com:GitScrum-Community/laravel-gitscrum.git
$ cd laravel-gitscrum
$ composer update
$ composer run-script post-root-package-install

Setup

Important: If you have not the .env file in root folder, you must copy or rename the .env.example to .env

Application URL

.env file

APP_URL=http://yourdomain.tld (you must use protocol http or https)

Language

Options: en | zh | zh_cn | ru | de | es | pt | it | id | fr | hu

.env file

APP_LANG=en

Can you help us translate a few phrases into different languages? See: https://github.com/GitScrum-Community/laravel-gitscrum/tree/feature/language-pack/resources/lang

Database

.env file


DB_CONNECTION=mysql
DB_HOST=XXXXXX
DB_PORT=3306
DB_DATABASE=XXXXX
DB_USERNAME=XXXX
DB_PASSWORD=XXXXX

Remember: Create the database for GitScrum before run artisan command.

php artisan migrate
php artisan db:seed --class=SettingSeeder

Github

You must create a new Github App, visit GitHub's New OAuth Application page, fill out the form, and grab your Client ID and Secret.

Application name: gitscrum
Homepage URL: URL (Same as APP_URL at .env)
Application description: gitscrum
Authorization callback URL: http://{URL is the SAME APP_URL}/auth/provider/github/callback

.env file

GITHUB_CLIENT_ID=XXXXX
GITHUB_CLIENT_SECRET=XXXXXXXXXXXXXXXXXX

Gitlab

You must create a new Gitlab App, visit Gitlab new application, fill out the form, and grab your Application ID and Secret.

name: gitscrum
Redirect URI: http://{URL is the SAME APP_URL}/auth/provider/gitlab/callback
Scopes: api and read_user

.env file

GITLAB_KEY=XXXXX -> Application Id
GITLAB_SECRET=XXXXXXXXXXXXXXXXXX
GITLAB_INSTANCE_URI=https://gitlab.com/

Bitbucket

You must create a new Bitbucket OAuth Consumer, visit Bitbucket new consumer guide, and make sure you give write permissions when creating the consumer specially on (repositories , issues)

name: gitscrum
Callback URL: http://{URL is the SAME APP_URL}/auth/provider/bitbucket/callback
URL: http://{URL is the SAME APP_URL}
Uncheck (This is a private consumer)

.env file

BITBUCKET_CLIENT_ID=XXXXX -> Bitbucket Key
BITBUCKET_CLIENT_SECRET=XXXXXXXXXXXXXXXXXX Bitbucket Secret
BITBUCKET_INSTANCE_URI=https://api.bitbucket.org

Proxy

.env file

PROXY_PORT=
PROXY_METHOD=
PROXY_SERVER=
PROXY_USER=
PROXY_PASS=

Screens

Screenshot 0 Screenshot 0 Screenshot 0 Screenshot 0 Screenshot 0 Screenshot 0 Screenshot 0


Database schema

Screenshot 1


Do you need help?

Renato Marinho: Facebook / LinkedIn / Skype: renatomarinho13

Contributing

Contributions are always welcome! https://github.com/GitScrum-Community/laravel-gitscrum/graphs/contributors

License

Laravel GitScrum is licensed under the MIT license.

Thanks