# kalus-msic/ticketbadgemanager architecture

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

- Interactive diagram: https://gitdiagram.com/kalus-msic/ticketbadgemanager
- Repository: https://github.com/kalus-msic/ticketbadgemanager

## Overview

TicketBadgeManager is a Django event check-in and badge-printing application. Organizers import ticket data and manage events; attendees are searched or scanned, checked in, and issued badges, with optional kiosk, bulk-print, special-label, Eventee, bilingual, and audit capabilities. The graph separates web workflows, ticket/event state, integrations, and printer rendering/dispatch. Sampled sources substantiate the import, check-in, Eventee, and print links; other documented capabilities are shown without speculative internal call chains.

Main entry points: [`ticket_badge_manager/urls.py`](https://github.com/kalus-msic/ticketbadgemanager/blob/main/ticket_badge_manager/urls.py) (Web routing), [`tickets/services/ticket_service.py`](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/services/ticket_service.py) (Ticket services), [`tickets/models.py`](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/models.py) (Event and ticket state), [`tickets/views/ticket_views.py`](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/ticket_views.py) (Ticket operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_web_routes["Web routing<br/>[urls.py]"]
  node_import_workflow["CSV import<br/>[import_views.py]"]
  node_checkin_workflow["Scan check-in<br/>[scanner_views.py]"]
  node_ticket_workflow["Ticket operations<br/>[ticket_views.py]"]
  node_search_workflow["Ticket search<br/>[search_views.py]"]
  node_settings_workflow["Event settings<br/>[settings_views.py]"]
  node_kiosk_workflow["Kiosk check-in<br/>[kiosk_views.py]"]
  node_bulk_workflow["Bulk printing"]
  node_special_labels["Special labels"]
  node_dashboard["Dashboard and statistics<br/>[dashboard_views.py]"]
  node_audit_views["Activity history<br/>[log_views.py]"]
  node_language_workflow["Language settings<br/>[language_views.py]"]
end

subgraph group_domain["Ticket and event domain"]
  node_ticket_service["Ticket services<br/>[ticket_service.py]"]
  node_domain_models[("Event and ticket state<br/>[models.py]")]
  node_activity_logs[("Activity logging<br/>[models.py]")]
end

subgraph group_printing["Badge printing"]
  node_print_manager["Print dispatch<br/>[manager.py]"]
  node_tspl_profile["TSPL profile<br/>[tspl.py]"]
  node_direct_backend["Direct printer<br/>[direct.py]"]
  node_browser_print["Browser printing<br/>[webusb-backend.js]"]
end

subgraph group_integrations["External integrations"]
  node_eventee_service["Eventee service<br/>[eventee_service.py]"]
  node_eventee_api["Eventee API"]
end

subgraph group_support["Shared services"]
  node_shared_security["Access and validation<br/>[decorators.py]"]
end

node_organizer(("Organizer"))
node_attendee(("Attendee"))

node_organizer -->|"uses"| node_web_routes
node_attendee -->|"checks in"| node_web_routes
node_web_routes -->|"routes"| node_import_workflow
node_web_routes -->|"routes"| node_checkin_workflow
node_web_routes -->|"routes"| node_ticket_workflow
node_web_routes -->|"routes"| node_search_workflow
node_web_routes -->|"routes"| node_settings_workflow
node_web_routes -->|"routes"| node_kiosk_workflow
node_web_routes -->|"routes"| node_bulk_workflow
node_web_routes -->|"routes"| node_special_labels
node_web_routes -->|"routes"| node_dashboard
node_web_routes -->|"routes"| node_audit_views
node_web_routes -->|"routes"| node_language_workflow
node_import_workflow -->|"uses"| node_ticket_service
node_import_workflow -->|"writes tickets"| node_domain_models
node_checkin_workflow -->|"uses"| node_ticket_service
node_checkin_workflow -->|"reads tickets"| node_domain_models
node_ticket_service -->|"updates state"| node_domain_models
node_ticket_service -->|"records activity"| node_activity_logs
node_search_workflow -->|"searches tickets"| node_domain_models
node_ticket_workflow -->|"manages tickets"| node_domain_models
node_ticket_workflow -->|"uses"| node_ticket_service
node_ticket_workflow -->|"invites attendees"| node_eventee_service
node_settings_workflow -->|"configures integration"| node_eventee_service
node_eventee_service -->|"calls"| node_eventee_api
node_print_manager -->|"generates print data"| node_tspl_profile
node_print_manager -->|"dispatches direct"| node_direct_backend
node_direct_backend -->|"uses layout constants"| node_tspl_profile
node_organizer -->|"prints badges"| node_bulk_workflow
node_organizer -->|"prints labels"| node_special_labels
node_attendee -->|"self checks in"| node_kiosk_workflow
node_browser_print -.->|"alternative backend"| node_direct_backend
node_organizer -->|"selects language"| node_language_workflow
node_organizer -->|"reviews activity"| node_audit_views
node_shared_security -.->|"protects requests"| node_checkin_workflow

click node_web_routes "https://github.com/kalus-msic/ticketbadgemanager/blob/main/ticket_badge_manager/urls.py"
click node_import_workflow "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/import_views.py"
click node_checkin_workflow "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/scanner_views.py"
click node_ticket_workflow "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/ticket_views.py"
click node_search_workflow "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/search_views.py"
click node_settings_workflow "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/settings_views.py"
click node_kiosk_workflow "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/kiosk_views.py"
click node_bulk_workflow "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/bulk_print_views.py"
click node_special_labels "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/special_label_views.py"
click node_ticket_service "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/services/ticket_service.py"
click node_domain_models "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/models.py"
click node_activity_logs "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/models.py"
click node_eventee_service "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/services/eventee_service.py"
click node_print_manager "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/printing/manager.py"
click node_tspl_profile "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/printing/profiles/tspl.py"
click node_direct_backend "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/printing/backends/direct.py"
click node_browser_print "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/static/js/webusb-backend.js"
click node_shared_security "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/decorators.py"
click node_dashboard "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/dashboard_views.py"
click node_audit_views "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/log_views.py"
click node_language_workflow "https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/language_views.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_web_routes,node_import_workflow,node_checkin_workflow,node_ticket_workflow,node_search_workflow,node_settings_workflow,node_kiosk_workflow,node_bulk_workflow,node_special_labels,node_dashboard,node_audit_views,node_language_workflow toneBlue
class node_ticket_service,node_domain_models,node_activity_logs toneAmber
class node_print_manager,node_tspl_profile,node_direct_backend,node_browser_print toneMint
class node_eventee_service,node_eventee_api toneRose
class node_shared_security,node_organizer,node_attendee toneIndigo
```

## Components

### Web workflows

- [Web routing](https://github.com/kalus-msic/ticketbadgemanager/blob/main/ticket_badge_manager/urls.py): `ticket_badge_manager/urls.py`
- [CSV import](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/import_views.py): `tickets/views/import_views.py`
- [Scan check-in](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/scanner_views.py): `tickets/views/scanner_views.py`
- [Ticket operations](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/ticket_views.py): `tickets/views/ticket_views.py`
- [Ticket search](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/search_views.py): `tickets/views/search_views.py`
- [Event settings](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/settings_views.py): `tickets/views/settings_views.py`
- [Kiosk check-in](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/kiosk_views.py): `tickets/views/kiosk_views.py`
- [Bulk printing](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/bulk_print_views.py): `tickets/views/bulk_print_views.py`
- [Special labels](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/special_label_views.py): `tickets/views/special_label_views.py`
- [Dashboard and statistics](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/dashboard_views.py): `tickets/views/dashboard_views.py`
- [Activity history](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/log_views.py): `tickets/views/log_views.py`
- [Language settings](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/views/language_views.py): `tickets/views/language_views.py`

### Ticket and event domain

- [Ticket services](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/services/ticket_service.py): `tickets/services/ticket_service.py`
- [Event and ticket state](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/models.py): `tickets/models.py`
- [Activity logging](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/models.py): `tickets/models.py`

### Badge printing

- [Print dispatch](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/printing/manager.py): `tickets/printing/manager.py`
- [TSPL profile](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/printing/profiles/tspl.py): `tickets/printing/profiles/tspl.py`
- [Direct printer](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/printing/backends/direct.py): `tickets/printing/backends/direct.py`
- [Browser printing](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/static/js/webusb-backend.js): `tickets/static/js/webusb-backend.js`

### External integrations

- [Eventee service](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/services/eventee_service.py): `tickets/services/eventee_service.py`
- **Eventee API**

### Shared services

- [Access and validation](https://github.com/kalus-msic/ticketbadgemanager/blob/main/tickets/decorators.py): `tickets/decorators.py`

### Other components

- **Organizer**
- **Attendee**

## Connections

- Organizer → Web routing: uses
- Attendee → Web routing: checks in
- Web routing → CSV import: routes
- Web routing → Scan check-in: routes
- Web routing → Ticket operations: routes
- Web routing → Ticket search: routes
- Web routing → Event settings: routes
- Web routing → Kiosk check-in: routes
- Web routing → Bulk printing: routes
- Web routing → Special labels: routes
- Web routing → Dashboard and statistics: routes
- Web routing → Activity history: routes
- Web routing → Language settings: routes
- CSV import → Ticket services: uses (evidence: `tickets/views/import_views.py`)
- CSV import → Event and ticket state: writes tickets (evidence: `tickets/views/import_views.py`)
- Scan check-in → Ticket services: uses (evidence: `tickets/views/scanner_views.py`)
- Scan check-in → Event and ticket state: reads tickets (evidence: `tickets/views/scanner_views.py`)
- Ticket services → Event and ticket state: updates state (evidence: `tickets/services/ticket_service.py`)
- Ticket services → Activity logging: records activity (evidence: `tickets/services/ticket_service.py`)
- Ticket search → Event and ticket state: searches tickets (evidence: `tickets/views/search_views.py`)
- Ticket operations → Event and ticket state: manages tickets (evidence: `tickets/views/ticket_views.py`)
- Ticket operations → Ticket services: uses (evidence: `tickets/views/ticket_views.py`)
- Ticket operations → Eventee service: invites attendees (evidence: `tickets/views/ticket_views.py`)
- Event settings → Eventee service: configures integration (evidence: `tickets/views/settings_views.py`)
- Eventee service → Eventee API: calls (evidence: `tickets/services/eventee_service.py`)
- Print dispatch → TSPL profile: generates print data (evidence: `tickets/printing/manager.py`)
- Print dispatch → Direct printer: dispatches direct (evidence: `tickets/printing/manager.py`)
- Direct printer → TSPL profile: uses layout constants (evidence: `tickets/printing/backends/direct.py`)
- Organizer → Bulk printing: prints badges
- Organizer → Special labels: prints labels
- Attendee → Kiosk check-in: self checks in
- Browser printing → Direct printer: alternative backend
- Organizer → Language settings: selects language
- Organizer → Activity history: reviews activity
- Access and validation → Scan check-in: protects requests (evidence: `tickets/views/scanner_views.py`)
