# Khira — Engineering Ticketing, Defect Tracking & Telemetry Suite
### Complete System Documentation & Frontend Developer Guide
---
## 1. Overview & System Architecture
**Khira** is a high-performance, enterprise-grade engineering ticketing, issue management, and application runtime error tracking suite designed specifically for cross-functional engineering teams (Frontend Developers, Backend Developers, QA / Testers, and Team Leads).
Khira is built natively into the **Unified Dashboard Suite (Go Gateway)**, serving live from port `10000` under the `/khira/` URL path.
```mermaid
flowchart TD
subgraph Client["Browser Clients & Unified Dashboard"]
UD["Unified Dashboard Hub (/dashboard/)"] -->|Shortcut / Card Click| KHIRA_UI["Khira Web SPA (/khira/)"]
FASTAPI_DOCS["FastAPI Docs (/docs/)"] -->|Navbar Link| KHIRA_UI
KHIRA_UI --> TICKET_VIEW["Tickets & Tasks (Kanban / Table)"]
KHIRA_UI --> ERROR_VIEW["Error Telemetry & Crash Tracking"]
end
subgraph Gateway["Go Nexus Gateway (Port 10000)"]
ROUTER["Chi Router (internal/gateway/router.go)"]
KHIRA_SERVER["Khira Server (internal/khira/handlers.go)"]
KHIRA_STORE["Khira In-Memory + JSON Store (internal/khira/store.go)"]
ROUTER -->|/khira/*| KHIRA_SERVER
ROUTER -->|/khira/api/*| KHIRA_SERVER
KHIRA_SERVER --> KHIRA_STORE
end
subgraph Persistence["JSON Persistence (data/khira/)"]
USERS_DB["data/khira/users.json"]
TICKETS_DB["data/khira/tickets.json"]
ERRORS_DB["data/khira/errors.json"]
NOTIFS_DB["data/khira/notifications.json"]
UPLOADS_DIR["data/khira/uploads/"]
KHIRA_STORE <--> USERS_DB
KHIRA_STORE <--> TICKETS_DB
KHIRA_STORE <--> ERRORS_DB
KHIRA_STORE <--> NOTIFS_DB
KHIRA_SERVER <--> UPLOADS_DIR
end
```
---
## 2. Frontend Code Files Breakdown
If you or an external AI coding assistant need to make changes to Khira's frontend UI, layout, styling, interactions, or client-side logic, **these are the exact frontend code files**:
### 🎯 Primary Frontend File
| File Path | Description | Lines of Code |
| :--- | :--- | :--- |
| **`web/khira/index.html`**
`/home/creserver/Desktop/Vaishno_workspace/Unified_Dashboard_Suite_Go/web/khira/index.html` | **The Complete Single-Page Application (SPA)** containing all HTML structure, all CSS styling variables and responsive rules, and all client JavaScript logic. | ~5,500 lines |
> [!IMPORTANT]
> **Why is Khira structured in a single file?**
> `web/khira/index.html` is an autonomous, self-contained Single-Page Application (SPA) designed to load with zero external build-step overhead (no webpack/vite compile delay). It uses pure vanilla JavaScript (ES6+), modern CSS Custom Properties, Google Fonts (Inter, Plus Jakarta Sans, JetBrains Mono), and FontAwesome 6.5.1 CDN icons. An external AI can modify `web/khira/index.html` directly without needing to run `npm build` or restart frontend bundlers.
### 🔗 Integration Points in Other Frontends
| File Path | Integration Purpose |
| :--- | :--- |
| **`web/dashboard/index.html`**
`/home/creserver/Desktop/Vaishno_workspace/Unified_Dashboard_Suite_Go/web/dashboard/index.html` | The main Unified Dashboard portal. Contains the **Khira Exclusive Showcase Card** (`#khiraToolCard`), top navigation shortcut button (`highlight-khira`), search filtering, and click-to-open handlers. |
| **`web/docs/index.html`**
`/home/creserver/Desktop/Vaishno_workspace/Unified_Dashboard_Suite_Go/web/docs/index.html` | The FastAPI Documentation UI. Contains the dedicated **Khira Hub** navigation button (`.btn-khira`) in the header navbar linking directly to `/khira/`. |
---
## 3. Detailed Anatomy of `web/khira/index.html`
To direct an external AI agent or developer to specific regions of `web/khira/index.html`, refer to this internal structure map:
### Part 1: CSS Design System (`