# kavilaxtech/it-support-ticket-intelligence-routing architecture

> Architecture diagram of the GitHub repository kavilaxtech/it-support-ticket-intelligence-routing, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kavilaxtech/it-support-ticket-intelligence-routing
- Repository: https://github.com/kavilaxtech/it-support-ticket-intelligence-routing

## Overview

This is a Streamlit application for analyzing incoming IT support tickets. The main workflow loads and preprocesses historical ticket data, trains category, issue-type, and priority classifiers, then uses an entered ticket to predict labels and confidence, assign a team, find similar tickets, and suggest a resolution. The dashboard also exposes model evaluation and historical-data views. The graph reflects documented capabilities, but the excerpts do not show all of the system-building code or every dashboard interaction.

Main entry points: [`app.py`](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/app.py) (Streamlit dashboard), [`data/it_support_tickets.csv`](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/data/it_support_tickets.csv) (Ticket dataset), [`src/text_preprocessing.py`](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/src/text_preprocessing.py) (Text preprocessing), [`src/models.py`](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/src/models.py) (Multi-task classifiers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Dashboard and workflow"]
  node_dashboard["Streamlit dashboard<br/>[app.py]"]
  node_ticket_input["Ticket analysis and routing<br/>[app.py]"]
  node_historical_view["Historical data view<br/>[app.py]"]
end

subgraph group_nlp["Text and classification"]
  node_preprocessing["Text preprocessing"]
  node_classifiers["Multi-task classifiers<br/>[models.py]"]
end

subgraph group_retrieval["Historical ticket retrieval"]
  node_ticket_data["Ticket dataset"]
  node_similarity["Ticket similarity engine<br/>[similarity.py]"]
  node_resolution["Similar-ticket resolution suggestion<br/>[app.py]"]
end

subgraph group_evaluation["Model evaluation"]
  node_evaluation_metrics["Classification metrics<br/>[evaluation.py]"]
  node_evaluation_view["Metrics and confusion matrices<br/>[app.py]"]
end

node_operator(("Support analyst"))

node_operator -->|"uses"| node_dashboard
node_dashboard -->|"loads"| node_ticket_data
node_dashboard -->|"preprocesses data"| node_preprocessing
node_dashboard -->|"trains models"| node_classifiers
node_dashboard -->|"computes metrics"| node_evaluation_metrics
node_operator -->|"enters ticket"| node_ticket_input
node_ticket_input -->|"cleans ticket"| node_preprocessing
node_ticket_input -->|"predicts labels"| node_classifiers
node_ticket_input -->|"searches tickets"| node_similarity
node_ticket_input -->|"selects resolution"| node_resolution
node_ticket_data -->|"displays records"| node_historical_view
node_operator -->|"browses data"| node_historical_view
node_operator -->|"reviews results"| node_evaluation_view
node_evaluation_view -->|"shows metrics"| node_evaluation_metrics

click node_dashboard "https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/app.py"
click node_ticket_input "https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/app.py"
click node_historical_view "https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/app.py"
click node_ticket_data "https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/data/it_support_tickets.csv"
click node_preprocessing "https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/src/text_preprocessing.py"
click node_classifiers "https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/src/models.py"
click node_similarity "https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/src/similarity.py"
click node_resolution "https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/app.py"
click node_evaluation_metrics "https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/src/evaluation.py"
click node_evaluation_view "https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/app.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_ticket_input,node_historical_view toneBlue
class node_preprocessing,node_classifiers toneAmber
class node_ticket_data,node_similarity,node_resolution toneMint
class node_evaluation_metrics,node_evaluation_view toneRose
class node_operator toneIndigo
```

## Components

### Dashboard and workflow

- [Streamlit dashboard](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/app.py): `app.py`
- [Ticket analysis and routing](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/app.py): `app.py`
- [Historical data view](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/app.py): `app.py`

### Text and classification

- [Text preprocessing](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/src/text_preprocessing.py): `src/text_preprocessing.py`
- [Multi-task classifiers](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/src/models.py): `src/models.py`

### Historical ticket retrieval

- [Ticket dataset](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/data/it_support_tickets.csv): `data/it_support_tickets.csv`
- [Ticket similarity engine](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/src/similarity.py): `src/similarity.py`
- [Similar-ticket resolution suggestion](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/app.py): `app.py`

### Model evaluation

- [Classification metrics](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/src/evaluation.py): `src/evaluation.py`
- [Metrics and confusion matrices](https://github.com/kavilaxtech/it-support-ticket-intelligence-routing/blob/main/app.py): `app.py`

### Other components

- **Support analyst**

## Connections

- Support analyst → Streamlit dashboard: uses (evidence: `README.md`)
- Streamlit dashboard → Ticket dataset: loads (evidence: `app.py`)
- Streamlit dashboard → Text preprocessing: preprocesses data (evidence: `app.py`)
- Streamlit dashboard → Multi-task classifiers: trains models (evidence: `app.py`)
- Streamlit dashboard → Classification metrics: computes metrics (evidence: `app.py`)
- Support analyst → Ticket analysis and routing: enters ticket (evidence: `README.md`)
- Ticket analysis and routing → Text preprocessing: cleans ticket (evidence: `app.py`)
- Ticket analysis and routing → Multi-task classifiers: predicts labels (evidence: `app.py`)
- Ticket analysis and routing → Ticket similarity engine: searches tickets (evidence: `app.py`)
- Ticket analysis and routing → Similar-ticket resolution suggestion: selects resolution (evidence: `app.py`)
- Ticket dataset → Historical data view: displays records (evidence: `app.py`)
- Support analyst → Historical data view: browses data (evidence: `README.md`)
- Support analyst → Metrics and confusion matrices: reviews results (evidence: `README.md`)
- Metrics and confusion matrices → Classification metrics: shows metrics (evidence: `app.py`)
