Skip to content

xtinghw/taskTicketSystem

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Helpdesk Ticketing System Project

A Flask and SQLite helpdesk workflow prototype designed for ICT support, retail technology support, and repair-oriented service environments.

This project demonstrates ticket intake, staff and manager workflows, assignment, status tracking, proof submission, manager review, rejection and resubmission, closure decisions, and audit history.

It was built as part of my ICT support portfolio to show practical understanding of support records, escalation, follow-up visibility, handover, documentation, and workflow improvement.

This is a local learning prototype, not a production ITSM system. All data used in this project is fake demo data.


Purpose

In ICT support and retail technology environments, resolving an issue is only one part of good service delivery.

A useful workflow also needs clear intake, accurate status tracking, service notes, follow-up records, manager review, escalation history, and enough context for another person to understand what happened.

This project was created to practise those support behaviours through a simple ticket workflow.


Current Features

Ticket Management

  • Create tickets with title, description, category, priority, visibility, and assigned staff
  • Track ticket status across pending, assigned, in progress, submitted, approved, rejected, closed, and voided states
  • Edit ticket details and assignment as a manager
  • Use fake demo ticket data for safe local testing

Staff Workflow

  • View assigned tickets
  • Start assigned work
  • Submit proof notes or completion evidence
  • View rejected tickets requiring follow-up
  • Resubmit corrected work after manager feedback

Manager Workflow

  • Assign or edit ticket ownership
  • Review submitted work
  • Approve, reject, close, or void tickets
  • Add manager notes and rejection comments
  • Return work with clear correction reasons

Record Keeping

  • Maintain audit history for ticket actions
  • Show dashboard-style ticket summaries
  • Track workload and follow-up needs
  • Keep records clear enough for handover and later review

Support Workflow

The system follows a basic support lifecycle:

  1. Create a support request or operational task
  2. Record the issue, category, priority, and assigned staff member
  3. Track the ticket as work moves forward
  4. Staff starts work and submits proof notes
  5. Manager reviews the submitted work
  6. Manager approves, rejects, closes, or requests follow-up
  7. Staff corrects and resubmits if required
  8. The system keeps an audit history of ticket actions

Project Screenshots

Staff Dashboard and Ticket Overview

The dashboard gives staff and managers a quick view of ticket volume, status counts, assigned work, and demo login access.

Staff dashboard summary with login and ticket status counts

Ticket Search and Filtering

Tickets can be searched, filtered, sorted, and reviewed from a single operational list.

Ticket list with search, filters, priority sorting, and assigned staff information

Staff Issue Reporting

Staff can report an issue with type, title, description, visibility, and proof type.

Staff report issue form with proof type options

Manager Task Creation

Managers can create tasks, assign staff, set visibility, and choose proof requirements.

Manager create and assign task form

Manager Review Actions

Managers can open ticket actions such as viewing details, assigning staff, editing tickets, approving proof, returning work for follow-up, or voiding a ticket.

Manager ticket actions menu with review and follow-up options

More workflow details

Ticket Details

The ticket detail view shows the issue description, assignment, reporter information, visibility, proof reference, staff notes, manager notes, and timestamps.

Ticket details modal showing description, assignment, proof, and staff notes

Activity History

Each ticket keeps an activity record so the workflow can be reviewed later for handover, follow-up, and accountability.

Ticket activity history showing created, assigned, started, submitted, and manager note events

Staff Follow-up Review

The manager follow-up view highlights rejected or returned work that may require correction, resubmission, or coaching.

Manager staff follow-up details showing rejected or follow-up ticket counts by staff member

Example Use Case

A staff member is assigned a device check, repair follow-up, customer issue, or store technology task.

They complete the work and submit supporting notes. A manager reviews the submission and either approves it or returns it with feedback. If returned, the staff member corrects the issue and resubmits.

The record can later support handover, repeated issue review, SOP improvement, and staff training.


Technology Used

  • Python
  • Flask
  • SQLite
  • HTML templates
  • Vanilla JavaScript
  • Local fake demo data

How to Run Locally

pip install -r requirements.txt
python app.py

Then open:

http://127.0.0.1:5002/

Demo Login

Update this section with the actual safe demo accounts before publishing.

Role Username Password
Manager manager 1234
Staff staffa 1234
Staff staffb 1234

Privacy and Safety Boundary

This project only uses fake or recreated demo information.

It must not include:

  • Real customer names
  • Real staff names
  • Real business names
  • Real workplace screenshots
  • Real SOP documents
  • Real payment, warranty, refund, or repair records
  • Real phone numbers, emails, addresses, serial numbers, IMEI numbers, or internal records

What This Demonstrates

This project demonstrates practical ICT support thinking, including:

  • Clear ticket intake and status tracking
  • Role-based staff and manager workflows
  • Service notes and proof submission
  • Manager review and correction logic
  • Rejection, follow-up, and resubmission handling
  • Audit history and handover visibility
  • Privacy-aware use of fake demo data
  • Workflow improvement thinking for SOPs, onboarding, and training

Roadmap

Planned improvements:

  • Improve manager assignment and edit flows
  • Strengthen ticket status transitions
  • Add focused tests for key workflow actions
  • Add a guided demo route with fake users and fake tickets
  • Add structured SOP guidance cards using fake demo content
  • Improve screenshots and demo presentation

Current Status

This is an active learning prototype intended for local demonstration and portfolio discussion.

The current focus is to keep the workflow stable, use safe fake demo data, and present the project clearly as an ICT support and retail operations workflow example.

About

Flask and SQLite workflow prototype for ICT support and repair-oriented retail teams, covering ticket intake, staff/manager review, proof submission, follow-up, status tracking, and audit history with safe fake demo data.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors