# aditya0252/ticket-analysis-tool architecture

> Architecture diagram of the GitHub repository aditya0252/ticket-analysis-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aditya0252/ticket-analysis-tool
- Repository: https://github.com/aditya0252/ticket-analysis-tool

## Overview

This repository implements network-support ticket analysis, with a broader diagnostic workflow that enriches tickets using customer network data and command recommendations. The ticket API extracts issue details, persists analysis, and supports feedback; the richer app also coordinates vendor-specific lookups, event analysis, and network assessment. Phase 2 provides issue knowledge matching, while Phase 3 provides vendor retrieval and command tooling. Some subsystem links are based on the SOURCE INDEX’s import/reference lists rather than inspected call sites; those lists do not establish exact runtime sequencing.

Main entry points: [`folder/app_new.py`](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/app_new.py) (Diagnostic app), [`folder/ticket_processor.py`](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/ticket_processor.py) (Ticket processor), [`phase3/command_extractor.py`](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/command_extractor.py) (Command extraction), [`phase3/config.py`](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/config.py) (Vendor configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ticket["Ticket analysis"]
  node_api["Ticket API<br/>[app.py]"]
  node_orchestrator["Diagnostic app<br/>[app_new.py]"]
  node_processor["Ticket processor"]
  node_db_access["Ticket persistence<br/>[db_execute.py]"]
  node_database[("PostgreSQL")]
  node_reply["Ticket reply<br/>[ticket_reply.py]"]
  node_zoho["Zoho integration<br/>[zoho_utils.py]"]
end

subgraph group_knowledge["Issue knowledge"]
  node_issue_loader["Issue data loader<br/>[load_data.py]"]
  node_llm_issue["LLM issue matching<br/>[llm_load_data.py]"]
  node_split_cases["Use-case splitting<br/>[split_use_cases.py]"]
end

subgraph group_diagnostics["Network diagnostics"]
  node_network_utils["Network utilities<br/>[utils.py]"]
  node_linkeye["LinkEye fetch"]
  node_nautobot["Nautobot connectivity"]
  node_aruba["Aruba Central data"]
  node_juniper["Juniper Mist data"]
  node_event_analysis["Event analysis"]
  node_event_tools["Event test bed<br/>[dec_test_bed.py]"]
  node_config["Vendor configuration<br/>[config.py]"]
end

subgraph group_retrieval["Vendor retrieval"]
  node_command_extractor["Command extraction"]
  node_embeddings["Vendor retrieval<br/>[load_embeddings.py]"]
  node_vendor_loader["Collection loader<br/>[vendor_loader.py]"]
end

node_user(("Support user"))
node_llm_service{{"LLM service"}}
node_aruba_service{{"Aruba Central"}}

node_user -->|"submits ticket"| node_api
node_api -->|"processes ticket"| node_processor
node_api -->|"saves analysis"| node_db_access
node_processor -->|"persists ticket"| node_db_access
node_db_access -->|"reads and writes"| node_database
node_processor -->|"uses reply logic"| node_reply
node_processor -->|"uses ticket utilities"| node_zoho
node_orchestrator -->|"uses processor"| node_processor
node_orchestrator -->|"uses issue data"| node_issue_loader
node_issue_loader -->|"imports matching"| node_llm_issue
node_llm_issue -->|"requests matches"| node_llm_service
node_orchestrator -->|"uses utilities"| node_network_utils
node_orchestrator -->|"uses LinkEye data"| node_linkeye
node_orchestrator -->|"uses connectivity"| node_nautobot
node_orchestrator -->|"uses Aruba data"| node_aruba
node_orchestrator -->|"uses Mist data"| node_juniper
node_orchestrator -->|"uses event analysis"| node_event_analysis
node_event_analysis -->|"imports event tools"| node_event_tools
node_orchestrator -->|"uses commands"| node_command_extractor
node_command_extractor -->|"imports utilities"| node_network_utils
node_command_extractor -->|"retrieves context"| node_embeddings
node_command_extractor -->|"uses collections"| node_vendor_loader
node_embeddings -->|"loads collections"| node_vendor_loader
node_aruba -->|"imports settings"| node_config
node_juniper -->|"imports settings"| node_config
node_nautobot -->|"imports settings"| node_config
node_linkeye -->|"imports settings"| node_config
node_aruba -->|"calls API"| node_aruba_service

click node_api "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/app.py"
click node_orchestrator "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/app_new.py"
click node_processor "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/ticket_processor.py"
click node_db_access "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/db_config/db_execute.py"
click node_reply "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/ticket_reply.py"
click node_zoho "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/zoho_utils.py"
click node_issue_loader "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase2/load_data.py"
click node_llm_issue "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase2/llm_load_data.py"
click node_split_cases "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase2/split_use_cases.py"
click node_network_utils "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/utils.py"
click node_linkeye "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/linkeye_data_fetch.py"
click node_nautobot "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/nautobot_connectivity.py"
click node_aruba "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/aruba_central_info.py"
click node_juniper "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/juniper_mist_data.py"
click node_event_analysis "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/dec_event_analysis.py"
click node_event_tools "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/dec_test_bed.py"
click node_command_extractor "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/command_extractor.py"
click node_embeddings "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/load_embeddings.py"
click node_vendor_loader "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/vendor_loader.py"
click node_config "https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/config.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_api,node_orchestrator,node_processor,node_db_access,node_database,node_reply,node_zoho,node_user toneBlue
class node_issue_loader,node_llm_issue,node_split_cases toneAmber
class node_network_utils,node_linkeye,node_nautobot,node_aruba,node_juniper,node_event_analysis,node_event_tools,node_config toneMint
class node_command_extractor,node_embeddings,node_vendor_loader toneRose
class node_llm_service,node_aruba_service toneIndigo
```

## Components

### Ticket analysis

- [Ticket API](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/app.py): `folder/app.py`
- [Diagnostic app](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/app_new.py): `folder/app_new.py`
- [Ticket processor](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/ticket_processor.py): `folder/ticket_processor.py`
- [Ticket persistence](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/db_config/db_execute.py): `folder/db_config/db_execute.py`
- **PostgreSQL**
- [Ticket reply](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/ticket_reply.py): `folder/ticket_reply.py`
- [Zoho integration](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/folder/zoho_utils.py): `folder/zoho_utils.py`

### Issue knowledge

- [Issue data loader](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase2/load_data.py): `phase2/load_data.py`
- [LLM issue matching](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase2/llm_load_data.py): `phase2/llm_load_data.py`
- [Use-case splitting](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase2/split_use_cases.py): `phase2/split_use_cases.py`

### Network diagnostics

- [Network utilities](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/utils.py): `phase3/utils.py`
- [LinkEye fetch](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/linkeye_data_fetch.py): `phase3/linkeye_data_fetch.py`
- [Nautobot connectivity](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/nautobot_connectivity.py): `phase3/nautobot_connectivity.py`
- [Aruba Central data](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/aruba_central_info.py): `phase3/aruba_central_info.py`
- [Juniper Mist data](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/juniper_mist_data.py): `phase3/juniper_mist_data.py`
- [Event analysis](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/dec_event_analysis.py): `dec_event_analysis.py`
- [Event test bed](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/dec_test_bed.py): `dec_test_bed.py`
- [Vendor configuration](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/config.py): `phase3/config.py`

### Vendor retrieval

- [Command extraction](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/command_extractor.py): `phase3/command_extractor.py`
- [Vendor retrieval](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/load_embeddings.py): `phase3/load_embeddings.py`
- [Collection loader](https://github.com/aditya0252/ticket-analysis-tool/blob/Adity_dDev/phase3/vendor_loader.py): `phase3/vendor_loader.py`

### Other components

- **Support user**
- **LLM service**
- **Aruba Central**

## Connections

- Support user → Ticket API: submits ticket (evidence: `folder/app.py`)
- Ticket API → Ticket processor: processes ticket (evidence: `folder/app.py`)
- Ticket API → Ticket persistence: saves analysis (evidence: `folder/app.py`)
- Ticket processor → Ticket persistence: persists ticket (evidence: `folder/ticket_processor.py`)
- Ticket persistence → PostgreSQL: reads and writes (evidence: `folder/db_config/db_execute.py`)
- Ticket processor → Ticket reply: uses reply logic (evidence: `folder/ticket_processor.py`)
- Ticket processor → Zoho integration: uses ticket utilities (evidence: `folder/ticket_processor.py`)
- Diagnostic app → Ticket processor: uses processor (evidence: `folder/app_new.py`)
- Diagnostic app → Issue data loader: uses issue data (evidence: `folder/app_new.py`)
- Issue data loader → LLM issue matching: imports matching (evidence: `phase2/load_data.py`)
- LLM issue matching → LLM service: requests matches (evidence: `phase2/llm_load_data.py`)
- Diagnostic app → Network utilities: uses utilities (evidence: `folder/app_new.py`)
- Diagnostic app → LinkEye fetch: uses LinkEye data (evidence: `folder/app_new.py`)
- Diagnostic app → Nautobot connectivity: uses connectivity (evidence: `folder/app_new.py`)
- Diagnostic app → Aruba Central data: uses Aruba data (evidence: `folder/app_new.py`)
- Diagnostic app → Juniper Mist data: uses Mist data (evidence: `folder/app_new.py`)
- Diagnostic app → Event analysis: uses event analysis (evidence: `folder/app_new.py`)
- Event analysis → Event test bed: imports event tools (evidence: `dec_event_analysis.py`)
- Diagnostic app → Command extraction: uses commands (evidence: `folder/app_new.py`)
- Command extraction → Network utilities: imports utilities (evidence: `phase3/command_extractor.py`)
- Command extraction → Vendor retrieval: retrieves context (evidence: `phase3/command_extractor.py`)
- Command extraction → Collection loader: uses collections (evidence: `phase3/command_extractor.py`)
- Vendor retrieval → Collection loader: loads collections (evidence: `phase3/load_embeddings.py`)
- Aruba Central data → Vendor configuration: imports settings (evidence: `phase3/aruba_central_info.py`)
- Juniper Mist data → Vendor configuration: imports settings (evidence: `phase3/juniper_mist_data.py`)
- Nautobot connectivity → Vendor configuration: imports settings (evidence: `phase3/nautobot_connectivity.py`)
- LinkEye fetch → Vendor configuration: imports settings (evidence: `phase3/linkeye_data_fetch.py`)
- Aruba Central data → Aruba Central: calls API (evidence: `phase3/aruba_central_info.py`)
