jmooo / cujo

Django ticketing system to manage custom work requests, job logs and service tickets.

Custom Job (cujo) Work Ticket Manager

Ticket system combines management of several concepts, such as work requests, job logs, and service tickets.

Technologies

• Python 3
• Django 2
• PostgreSQL: Full-text search with tsvector? Yes please.
• Bootstrap 4: Longest alpha in history
• Gulp.js: Webpack seems like overkill, currently.
• Tox: Pull all the test tools together
• Pytest: Writing tests with a simple assert is the life
• Coverage.py: HTML formatted code coverage reports

Installation

• mkvirtualenv --python=`which python3` cujo - Create new python3 venv, for when homebrew wrecks yours
• pip install --editable .[tests] - Install required components
• npm install - Install requirements from project.json
• gulp watch - Build and auto-reload changes to your scss & js
• ./manage.py makemigrations - Prepare migrations
• ./manage.py migrate - Run migrations (needs all db privs for this, not just I.S.U.D)
• tox - Run test suite
• View coverage reports at: cujo/htmlcov/index.html

Managing settings and secrets

To choose between dev/stage/prod.py settings append this to your env file, probably at /<venvs>/cujo/bin/postactivate:

• export DJANGO_SETTINGS_MODULE="cujo.settings.dev"

To keep your usernames/passwords out of git rename secrets.json.example to secrets.json in the root project folder.

Hot tips

• ./manage.py runserver - Run Django development server
• django-admin startapp module_name - Create file layout for a new Django module
• pip list -o - List outdated packages
• npm outdated - Find your old garbage

License

MIT (see LICENSE)