# 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 (`