# vimalkishor83/ticket_tracker architecture

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

- Interactive diagram: https://gitdiagram.com/vimalkishor83/ticket_tracker
- Repository: https://github.com/vimalkishor83/ticket_tracker

## Overview

This is a Flask ticket-tracking application for managing tickets, approvals, users, and operational reporting. Users sign in and work with tickets through the web routes; ticket additions, edits, and deletions can enter an admin approval workflow before changes are applied and recorded in history. The application also supports dashboards and exports, bulk upload, comments, user administration, freeze settings, and email-based password setup and notifications. The graph reflects the sampled code and SOURCE INDEX; several route capabilities are indexed but not excerpted, so their internal behavior is not expanded.

Main entry points: [`routes/approvals.py`](https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/approvals.py) (Approval workflow), [`app.py`](https://github.com/vimalkishor83/ticket_tracker/blob/main/app.py) (Flask application), [`routes/admin.py`](https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/admin.py) (Administration), [`db.py`](https://github.com/vimalkishor83/ticket_tracker/blob/main/db.py) (Database extensions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Flask application<br/>[app.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_dashboard["Dashboard and export<br/>[dashboard.py]"]
  node_admin["Administration<br/>[admin.py]"]
  node_comments["Ticket comments<br/>[comments.py]"]
end

subgraph group_workflow["Ticket workflow"]
  node_tickets["Ticket operations<br/>[tickets.py]"]
  node_approvals["Approval workflow<br/>[approvals.py]"]
end

subgraph group_records["Domain records"]
  node_ticket_model[("Ticket records<br/>[ticket.py]")]
  node_approval_model[("Approval records<br/>[approval.py]")]
  node_user_model[("User records<br/>[user.py]")]
  node_settings_model[("System settings<br/>[settings.py]")]
  node_comment_model[("Comment records<br/>[comment.py]")]
  node_history_model[("History records<br/>[history.py]")]
end

subgraph group_support["Shared services"]
  node_db["Database extensions<br/>[db.py]"]
  node_history_service["History service<br/>[history_service.py]"]
  node_email_service["Email service<br/>[email_service.py]"]
  node_field_labels["Field labels<br/>[field_labels.py]"]
  node_ticket_constants["Ticket constants"]
  node_decorators["Route authorization<br/>[decorators.py]"]
end

node_user(("User"))
node_mail["Mail service"]

node_user -->|"uses"| node_app
node_app -->|"registers"| node_auth
node_app -->|"registers"| node_dashboard
node_app -->|"registers"| node_tickets
node_app -->|"registers"| node_approvals
node_app -->|"registers"| node_admin
node_app -->|"registers"| node_comments
node_app -->|"initializes"| node_db
node_auth -->|"queries"| node_user_model
node_auth -->|"writes"| node_db
node_auth -->|"sends mail"| node_email_service
node_dashboard -->|"queries"| node_ticket_model
node_dashboard -->|"counts"| node_approval_model
node_dashboard -->|"queries"| node_user_model
node_dashboard -->|"uses"| node_ticket_constants
node_tickets -->|"reads and writes"| node_ticket_model
node_tickets -->|"creates requests"| node_approval_model
node_tickets -->|"checks freeze"| node_settings_model
node_tickets -->|"queries"| node_user_model
node_approvals -->|"applies changes"| node_ticket_model
node_approvals -->|"processes requests"| node_approval_model
node_approvals -->|"finds requester"| node_user_model
node_approvals -->|"uses ticket helper"| node_tickets
node_approvals -->|"records changes"| node_history_service
node_approvals -->|"notifies requester"| node_email_service
node_approvals -->|"requires admin"| node_decorators
node_approvals -->|"labels fields"| node_field_labels
node_admin -->|"queries"| node_user_model
node_admin -->|"queries"| node_ticket_model
node_admin -->|"updates settings"| node_settings_model
node_admin -->|"records changes"| node_history_service
node_admin -->|"sends mail"| node_email_service
node_admin -->|"requires admin"| node_decorators
node_comments -->|"queries"| node_ticket_model
node_comments -->|"reads and writes"| node_comment_model
node_history_service -->|"writes history"| node_history_model
node_history_service -->|"uses labels"| node_field_labels
node_email_service -->|"sends messages"| node_mail
node_ticket_model -->|"maps with"| node_db
node_approval_model -->|"maps with"| node_db
node_user_model -->|"maps with"| node_db
node_settings_model -->|"maps with"| node_db
node_comment_model -->|"maps with"| node_db
node_history_model -->|"maps with"| node_db

click node_app "https://github.com/vimalkishor83/ticket_tracker/blob/main/app.py"
click node_auth "https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/auth.py"
click node_dashboard "https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/dashboard.py"
click node_admin "https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/admin.py"
click node_comments "https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/comments.py"
click node_tickets "https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/tickets.py"
click node_approvals "https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/approvals.py"
click node_ticket_model "https://github.com/vimalkishor83/ticket_tracker/blob/main/models/ticket.py"
click node_approval_model "https://github.com/vimalkishor83/ticket_tracker/blob/main/models/approval.py"
click node_user_model "https://github.com/vimalkishor83/ticket_tracker/blob/main/models/user.py"
click node_settings_model "https://github.com/vimalkishor83/ticket_tracker/blob/main/models/settings.py"
click node_comment_model "https://github.com/vimalkishor83/ticket_tracker/blob/main/models/comment.py"
click node_history_model "https://github.com/vimalkishor83/ticket_tracker/blob/main/models/history.py"
click node_db "https://github.com/vimalkishor83/ticket_tracker/blob/main/db.py"
click node_history_service "https://github.com/vimalkishor83/ticket_tracker/blob/main/services/history_service.py"
click node_email_service "https://github.com/vimalkishor83/ticket_tracker/blob/main/services/email_service.py"
click node_field_labels "https://github.com/vimalkishor83/ticket_tracker/blob/main/services/field_labels.py"
click node_ticket_constants "https://github.com/vimalkishor83/ticket_tracker/blob/main/services/ticket_constants.py"
click node_decorators "https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/decorators.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_app,node_auth,node_dashboard,node_admin,node_comments,node_user toneBlue
class node_tickets,node_approvals toneAmber
class node_ticket_model,node_approval_model,node_user_model,node_settings_model,node_comment_model,node_history_model toneMint
class node_db,node_history_service,node_email_service,node_field_labels,node_ticket_constants,node_decorators toneRose
class node_mail toneIndigo
```

## Components

### Web application

- [Flask application](https://github.com/vimalkishor83/ticket_tracker/blob/main/app.py): `app.py`
- [Authentication](https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/auth.py): `routes/auth.py`
- [Dashboard and export](https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/dashboard.py): `routes/dashboard.py`
- [Administration](https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/admin.py): `routes/admin.py`
- [Ticket comments](https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/comments.py): `routes/comments.py`

### Ticket workflow

- [Ticket operations](https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/tickets.py): `routes/tickets.py`
- [Approval workflow](https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/approvals.py): `routes/approvals.py`

### Domain records

- [Ticket records](https://github.com/vimalkishor83/ticket_tracker/blob/main/models/ticket.py): `models/ticket.py`
- [Approval records](https://github.com/vimalkishor83/ticket_tracker/blob/main/models/approval.py): `models/approval.py`
- [User records](https://github.com/vimalkishor83/ticket_tracker/blob/main/models/user.py): `models/user.py`
- [System settings](https://github.com/vimalkishor83/ticket_tracker/blob/main/models/settings.py): `models/settings.py`
- [Comment records](https://github.com/vimalkishor83/ticket_tracker/blob/main/models/comment.py): `models/comment.py`
- [History records](https://github.com/vimalkishor83/ticket_tracker/blob/main/models/history.py): `models/history.py`

### Shared services

- [Database extensions](https://github.com/vimalkishor83/ticket_tracker/blob/main/db.py): `db.py`
- [History service](https://github.com/vimalkishor83/ticket_tracker/blob/main/services/history_service.py): `services/history_service.py`
- [Email service](https://github.com/vimalkishor83/ticket_tracker/blob/main/services/email_service.py): `services/email_service.py`
- [Field labels](https://github.com/vimalkishor83/ticket_tracker/blob/main/services/field_labels.py): `services/field_labels.py`
- [Ticket constants](https://github.com/vimalkishor83/ticket_tracker/blob/main/services/ticket_constants.py): `services/ticket_constants.py`
- [Route authorization](https://github.com/vimalkishor83/ticket_tracker/blob/main/routes/decorators.py): `routes/decorators.py`

### Other components

- **User**
- **Mail service**

## Connections

- User → Flask application: uses
- Flask application → Authentication: registers (evidence: `app.py`)
- Flask application → Dashboard and export: registers (evidence: `app.py`)
- Flask application → Ticket operations: registers (evidence: `app.py`)
- Flask application → Approval workflow: registers (evidence: `app.py`)
- Flask application → Administration: registers (evidence: `app.py`)
- Flask application → Ticket comments: registers (evidence: `app.py`)
- Flask application → Database extensions: initializes (evidence: `app.py`)
- Authentication → User records: queries (evidence: `routes/auth.py`)
- Authentication → Database extensions: writes (evidence: `routes/auth.py`)
- Authentication → Email service: sends mail (evidence: `routes/auth.py`)
- Dashboard and export → Ticket records: queries (evidence: `routes/dashboard.py`)
- Dashboard and export → Approval records: counts (evidence: `routes/dashboard.py`)
- Dashboard and export → User records: queries (evidence: `routes/dashboard.py`)
- Dashboard and export → Ticket constants: uses (evidence: `routes/dashboard.py`)
- Ticket operations → Ticket records: reads and writes (evidence: `routes/tickets.py`)
- Ticket operations → Approval records: creates requests (evidence: `routes/tickets.py`)
- Ticket operations → System settings: checks freeze (evidence: `routes/tickets.py`)
- Ticket operations → User records: queries (evidence: `routes/tickets.py`)
- Approval workflow → Ticket records: applies changes (evidence: `routes/approvals.py`)
- Approval workflow → Approval records: processes requests (evidence: `routes/approvals.py`)
- Approval workflow → User records: finds requester (evidence: `routes/approvals.py`)
- Approval workflow → Ticket operations: uses ticket helper (evidence: `routes/approvals.py`)
- Approval workflow → History service: records changes (evidence: `routes/approvals.py`)
- Approval workflow → Email service: notifies requester (evidence: `routes/approvals.py`)
- Approval workflow → Route authorization: requires admin (evidence: `routes/approvals.py`)
- Approval workflow → Field labels: labels fields (evidence: `routes/approvals.py`)
- Administration → User records: queries (evidence: `routes/admin.py`)
- Administration → Ticket records: queries (evidence: `routes/admin.py`)
- Administration → System settings: updates settings (evidence: `routes/admin.py`)
- Administration → History service: records changes (evidence: `routes/admin.py`)
- Administration → Email service: sends mail (evidence: `routes/admin.py`)
- Administration → Route authorization: requires admin (evidence: `routes/admin.py`)
- Ticket comments → Ticket records: queries (evidence: `routes/comments.py`)
- Ticket comments → Comment records: reads and writes (evidence: `routes/comments.py`)
- History service → History records: writes history (evidence: `services/history_service.py`)
- History service → Field labels: uses labels (evidence: `services/history_service.py`)
- Email service → Mail service: sends messages (evidence: `services/email_service.py`)
- Ticket records → Database extensions: maps with (evidence: `models/ticket.py`)
- Approval records → Database extensions: maps with (evidence: `models/approval.py`)
- User records → Database extensions: maps with (evidence: `models/user.py`)
- System settings → Database extensions: maps with (evidence: `models/settings.py`)
- Comment records → Database extensions: maps with (evidence: `models/comment.py`)
- History records → Database extensions: maps with (evidence: `models/history.py`)
