Super Simple Ticketing System [SSTS]
Report a Bug · Request a Feature . Ask a Question

Table of Contents

• About
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Support
• Project assistance
• Contributing
• Authors & contributors
• Security
• Acknowledgements

---

About

Super Simple Ticketing System aims to fix a bit of the issues that plague other ticketing softwares. Issues such as slowness, dated interfaces, and miles of training needed to get the fullest out of the software.

Built With

Python Flask MongoDB HTML/CSS

Getting Started

Prerequisites

Python 3.12 Flask NGINX MongoDB Database requirements.txt

Installation

Install NGINX on your favorite Linux OS Install Python < 3.12-full and Python-is-Python3 as packages Clone our stable/main branch with (git clone https://github.com/oliveoil222/CS386-Project) Then, (cd CS386-Project) Spin up a virtual environment with (python -m venv .venv) Activate the virtual environment with (. .venv/bin/activate) Use (pip install -r requirements.txt) to install the prerequisites Locate and edit the backendDB file with the (server-url) placeholder, and put your MongoDB address there. Install GUnicorn as a pip package with (pip install gunicorn) Run (gunicorn -w 4 'ssts:app') to start the application Proxy with NGINX to the listening port. Open your web-app via your domain, given you've set DNS records and such.

Usage

Visit https://your-domain-here.tld to use the web application. Our intuitive web interface should be able to adequately guide a user through using our application. Honestly, play around with it, there isn't too much to mess up! Check out our demo application on https://ssts.app!

Roadmap

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

• Top Feature Requests (Add your votes using the 👍 reaction)
• Top Bugs (Add your votes using the 👍 reaction)
• Newest Bugs

Support

Reach out to the maintainer at one of the following places:

• GitHub issues
• Contact mainline contributors through their GitHub Profiles. (See Authors and Contributors)

Project assistance

If you want to say thank you or/and support active development of Super Simple Ticketing System [SSTS]:

• Add a GitHub Star to the project.
• Tweet about the Super Simple Ticketing System [SSTS].
• Write interesting articles about the project on Dev.to, Medium or your personal blog.

Together, we can make Super Simple Ticketing System [SSTS] better!

Contributing

Please read our contribution guidelines, and thank you for being involved!

Authors & contributors

The original setup of this repository is by Olivia Vester. Main repository contributors are

• Olivia V. oliveoil222
• Hannah P. hannahpenado
• Charles D. cmd644
• Dallon J. dallonjarman
• Sam C. SamCain04
• Jared K. jjkagie

For a full list of all authors and contributors, see the contributors page.

Security

Super Simple Ticketing System [SSTS] follows good practices of security, but 100% security cannot be assured. Super Simple Ticketing System [SSTS] is provided "as is" without any warranty. Use at your own risk.

License

This project is licensed under the Unlicense.

See LICENSE for more information.

Acknowledgements

• Dr. Ana Chaves chavesana for the opportunity to develop this Python Application.