laravel-gitscrum

Laravel GitScrum is a free application to task management of the day-to-day. Git + Scrum = Team More Productive

Laravel GitScrum

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


Laravel 5.4 Build Status Codacy Badge Total Downloads License OpenCollective OpenCollective


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, Spanish, Portuguese, Italian, French, Indonesian and Hungarian.

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

Features

GitScrum can be integrated with Github or Gitlab.

  • 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 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.

Installation

The requirements to Laravel GitScrum application is:

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

Use Docker - Containers: php7, nginx and mysql57

Composer Package

$ composer create-project renatomarinho/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 [email protected]:renatomarinho/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/renatomarinho/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 --seed

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/

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


Questions and issues

The github issue tracker is only for bug reports and feature requests. Anything else, such as questions for help in using the Laravel Gitscrum, should be posted in StackOverflow under tag gitscrum.

Do you need help?

Renato Marinho: Facebook / LinkedIn / Skype: renatomarinho13

Contributing

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

License

Laravel GitScrum is licensed under the MIT license.

Thanks

Translate Team : @orionlu0916 , @Bebbolus , @dongm2ez, @rizalio, @ddmler, @Assada, @edbizarro, @ngabor84 and Manuel Ortega

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

Related Repositories

docker-gitscrum

docker-gitscrum

Docker containers for Laravel GitScrum ...