A Powerful Laravel Help Desk and Lead Management App
BadChoice Merge pull request #177 from BadChoice/dependabot/composer/phpunit/ph…
…punit-7.3.5

Bump phpunit/phpunit from 6.5.9 to 7.3.5
Latest commit eb086c2 Sep 25, 2018
Permalink
Failed to load latest commit information.
app Moved helpers.php to composer.json file Aug 27, 2018
bootstrap Initial comit : Fresh laravel install Aug 3, 2017
config added max log files variable Apr 20, 2018
database refs #132 Mentions are working, final tests left Apr 25, 2018
helpers Apply fixes from StyleCI Apr 25, 2018
nginx Add support for docker setup, xdebug, new-relic monitoring, nginx and… Sep 10, 2017
public Can filter by team, requester, status and priority Jul 24, 2018
resources Merge pull request #171 from Paplow/dev Sep 21, 2018
routes A fix to PR #158 Aug 22, 2018
scripts Add support for docker setup, xdebug, new-relic monitoring, nginx and… Sep 10, 2017
storage Adding required folders to git Sep 8, 2017
tests added get team leads api Apr 29, 2018
.dockerignore Add support for docker setup, xdebug, new-relic monitoring, nginx and… Sep 10, 2017
.env.docker created .env.docker by now Sep 10, 2017
.env.example Added MAIL_FETCH_USE_SSL variable to example .env Apr 8, 2018
.env.nginx Add support for docker setup, xdebug, new-relic monitoring, nginx and… Sep 10, 2017
.gitattributes Initial comit : Fresh laravel install Aug 3, 2017
.gitignore Initial comit : Fresh laravel install Aug 3, 2017
.styleci.yml Disabled the risky strict fixer Sep 18, 2017
.travis.yml travis --no-interaction Sep 8, 2017
Dockerfile Add support for docker setup, xdebug, new-relic monitoring, nginx and… Sep 10, 2017
_ide_helper.php Basic leads controller Aug 11, 2017
artisan Initial comit : Fresh laravel install Aug 3, 2017
composer.json Bump phpunit/phpunit from 6.5.9 to 7.3.5 Sep 25, 2018
composer.lock Merge pull request #177 from BadChoice/dependabot/composer/phpunit/ph… Sep 25, 2018
deploy.sh added deploy script Mar 22, 2018
docker-compose.yml Add support for docker setup, xdebug, new-relic monitoring, nginx and… Sep 10, 2017
docker-installation.md created .env.docker by now Sep 10, 2017
package.json Quick commit : Initial commit Sep 7, 2017
phpunit.xml Moving eloquent tests into Unit Tests Sep 9, 2017
readme.md Update readme.md Jun 26, 2018
run-local Add support for docker setup, xdebug, new-relic monitoring, nginx and… Sep 10, 2017
server.php Apply fixes from StyleCI Sep 19, 2017
webpack-mix-workflow.md Quick commit : Initial commit Sep 7, 2017
webpack.mix.js starting with mentions Apr 23, 2018

readme.md

Handesk

Description

Handesk has been created by our need (At Revo Systems www.revo.works) to have a powerful yet simple Ticketing system, we needed a system that allowed us to have multiple teams, with multiple users, easy and efficient reporting by all/team/user as well as lead management.

Landing page: http://handesk.io

Check out the screenshots to see how nice it looks, and feel fee to contribute by sending us PRs. We will keep adding features as we need them, but our basic workflow is totally covered :D

Features

· Email polling (new tickets and tickets updates)
· Email attachments as ticket attachments (using laravel storage driver) · API for creating/updating/fetching tickets/leads so you can display them into your main app
· Instant email/slack notifications when tickets are created/updated
· Everything is unlimited
· Lead management (With its API as well)
· Auto lead subscription to mailChimp based on its tags
· Tickets reporting
· Tickets internal notes
· Tickets can be escalated, so assistants can comment on them to help the teams
· Can merge tickets
· Mention agents with @name so they get notified · Lead tasks, that can have a due date, and sending daily tasks email
· Create issues to your code repository directly from the ticket
· Updating the ticket automatically when an issue is marked as resolved
· UI multi language support (default en, alternative ca, de, fr, es)
· Roadmap module, you can create ideas that come from your customers or your own, give them deadlines and integrate them with your repository manager, you can even create ideas from support tickets so you never lose track.
· You can also create ideas by sending an email to you support accounts starting with Idea: it will create an idea instead of a ticket

Follow us on twitter @codepassion to stay tuned

Installation

Its very simple, you just need to follow the standard Laravel installation

git clone https://github.com/BadChoice/handesk.git
cd handesk
composer install
# Setup your .env file to match you desired database
php artisan key:generate
php artisan migrate --seed
php artisan storage:link #if you use the local driver

Alternatively, you can use the following docker setup

The default admin user is admin@handesk.io / admin If you want email pulling, you need to enable the imap extension on php (note that on mac the php-cli runs very slow, you need to update your /etc/hosts file

::1         localhost YourMac.local
127.0.0.1   localhost YourMac.local

Open your app/Console/Kernel.php to update the schedulers as you want (comment them if not needed) Add the cron job * * * * * php /path-to-your-project/artisan schedule:run >> /dev/null 2>&1

Further configuration

Email pulling

Enter your mail credentials in .env

MAIL_FETCH_HOST=pop3.handesk.com   
MAIL_FETCH_PORT=110   
MAIL_FETCH_USERNAME=hello@handesk.com   
MAIL_FETCH_PASSWORD=secret-password   

Mailchimp

Set your mailchimp key in .env MAILCHIMP_API_KEY=448027f3acac5594605be3adf78be862-us15

And enter the relation of tags => list id in config/services.php mailchimp section

Bitbucket

You can create issues directly to your code repository from tickets. You need to setup your credentials in the .env

BITBUCKET_USER=bitbucket-user-if-using-basic-auth
BITBUCKET_PASSWORD=bitbucket-password-if-using-basic-auth

And enter your repositories list in config/issues.php file, filling the repositories field.

You can event update the tickets automatically (adding a private note using bitbucket webhooks). You just need to go to your report webhooks settings and add a new webhook with the url

http://{handesk.io}/webhook/bitbucket

You just need to check the issues updated option

Api Token

Set your desired API token in the .env

API_TOKEN=the-api-token

We have the following SDK's to easily interact with Handesk api
There is the badchoice/handesk-php package in packagist to easily talk with the api. Handesk-php
Handesk-ios In progress

Screenshots

Tickets screenshot Ticket screenshot Leads screenshot Lead screenshot Invitation screenshot Email screenshot

Community

We have a slack channel at https://handesk.slack.com/ And you can join with the following invitation

Join in with the following link

Join handesk slack

Development

We try to follow a TDD approach as well as some mixed functional CSS for the frontend.

PRs are welcome!

License

Handesk is open-sourced software licensed under the MIT license.