vaishnosingh cc6bed127b feat(khira): complete remediation, performance optimization, and Cloudflare Turnstile integration
- Backend:
  - Fix ListTickets parameter order mismatch for assignee filtering
  - Replicate all 13 PostgreSQL tables and columns during disaster recovery sync and rollback
  - Implement server-side session store with HttpOnly cookies and Bearer tokens
  - Add profile update verification requiring current password
  - Whitelist allowed file uploads and apply strict security headers (nosniff, CSP)
  - Enforce role check on error deletion (admin/lead/tester only) and authenticate SSE stream
  - Align foreign key user_id for saved filters and api tokens
  - Add ReopenTicket endpoint and workflow
  - Integrate Cloudflare Turnstile verification with testing/production key support
- Frontend:
  - Remove liquid glass displacement filter and lens capsule for high-performance UI
  - Eliminate recursive backdrop-filters and heavy inset shadows
  - Add debounced search and optimize SSE re-rendering
  - Wire Saved Views filter bar with creation, active indicators, and deletion
  - Add Linked & Related Tickets management UI to sheet
  - Seed 6 demo personas in PostgreSQL with instant sign-in
  - Add Cloudflare Turnstile widgets to authentication modals
  - Add keyboard arrow navigation to Command Palette
- Image Manipulator, Docs & Tooling:
  - Sync image manipulator updates, docs, and test coordinates
2026-11-17 18:39:25 +05:30

Unified Dashboard Suite (Go Edition)

A high-performance, unified developer & QA dashboard suite engineered in Go. Orchestrates micro-services, visual AI processing pipelines, automated testing tools, and project management into a single cohesive interface powered by nexus-gateway.


⚡ Architectural Overview

The suite runs on a lightweight Go reverse-proxy and process manager (nexus-gateway) on port 10000. The gateway dynamically monitors, manages, and routes traffic to all individual tool micro-services:

Service Port Description
Nexus Gateway 10000 Main entry point & unified tool dashboard
Image Manipulator Pro 5001 High-throughput image resizing, cropping, rotation, batch filters
JSON Suite 5002 Interactive JSON schema manipulation, validation, and testing
PNG Frame Detector 5003 Computer vision boundary detection for multi-frame PNG sprite sheets
JSON Image Downloader 5004 Asynchronous multi-threaded image asset downloader from JSON datasets
Image Merger 5005 Canvas stitching and multi-layer asset merging
Bulk API Tester 5006 Advanced bulk API testing with Black Obsidian Liquid Glass UI, batch runs, and real-time doc import
Facial Rotation Detector 5007 MediaPipe + ONNX AI angle and pose orientation detector
Host It Now 5008 Instant local image hosting with public tunnel and clip management
AI Caricature JSONMaker 5009 AI coordinate mapping and caricature dataset generation
PSD Reader 5010 Layer extraction and asset parsing from Adobe Photoshop PSDs
Khira Dev Ticketing Integrated Cross-team issue tracking, hold/resume workflows, and PostgreSQL dual-DB sync

📋 Prerequisites

Ensure the following tools are installed on your Linux environment:

  1. Go: Version 1.21 or higher (go version)
  2. Fish Shell: For running the automatic process recovery script (fish)
  3. Make & GCC: Standard compilation build essentials
  4. PostgreSQL: Required for Khira Dev Ticketing storage
  5. Python 3.10+ & Virtual Environment: For AI and Computer Vision worker scripts (e.g. OpenCV, MediaPipe, ONNXRuntime)

🚀 Setup & Installation

1. Clone & Navigate to Repository

git clone https://github.com/vaishnosingh/Unified_Dashboard_Suite_Go.git
cd Unified_Dashboard_Suite_Go

2. Go Dependencies

Download all required Go modules:

go mod download

3. PostgreSQL Database Setup (for Khira Ticketing)

Khira uses a resilient dual-database architecture (khira_primary and khira_backup). Create the databases in your local PostgreSQL instance:

# Switch to postgres user and create databases
sudo -u postgres psql -c "CREATE DATABASE khira_primary;"
sudo -u postgres psql -c "CREATE DATABASE khira_backup;"

Default connection strings (configured via environment variables or defaults in internal/khira/store.go):

4. Python Virtual Environment Setup

For Python-based tools (Facial Rotation Detector, PNG Frame Detector):

# Activate your local Python venv (in Fish shell)
source /home/creserver/extras/local_venv/bin/activate.fish

# Ensure required libraries are installed
pip install opencv-python numpy mediapipe onnxruntime pillow flask

5. Build All Go Binaries

Compile all micro-services and the gateway into the ./bin/ directory:

make build-go

This compiles:

  • bin/nexus-gateway
  • bin/bulk-api-tester
  • bin/image-manipulator
  • bin/image-hoster
  • bin/image-merger
  • bin/json-suite
  • bin/json-image-downloader
  • bin/png-frame-detector
  • bin/facial-rotation-detector

🔄 Running the Suite (Restart Script)

The recommended way to launch or restart the suite is using the included launch_dashboard_go.fish script.

What the Script Does:

  1. Zero Port Conflicts: Automatically checks and kills any lingering or orphaned processes on ports 10000, 5001, 5002, 5003, 5004, 5005, 5006, 5007, 5008, 5009, 5010 using lsof/fuser.
  2. Directory Resolution: Dynamically locates the repository root.
  3. Gateway Orchestration: Starts nexus-gateway on port 10000, which automatically reads configs/tools.yaml and launches all child services.

How to Run:

# Using Fish shell:
./launch_dashboard_go.fish

Or from outside the repository:

fish /home/creserver/launch_dashboard_go.fish

Once running, access the unified dashboard in your browser: 👉 http://localhost:10000


🛠 Manual Execution Options

Launch via Makefile:

make run

Run an Individual Micro-Service Directly:

If you only need to work on a specific tool (e.g. Bulk API Tester):

# Start Bulk API Tester standalone on port 5006:
./bin/bulk-api-tester

Then visit http://localhost:5006.


⚙️ Configuration Files


🔍 Troubleshooting & Logs

  • Service Logs: All output from individual tools is logged in the logs/ directory:
    tail -f logs/nexus-gateway.log
    tail -f logs/bulk-api-tester.log
    
  • Stuck Ports: If a port remains occupied, run:
    ./launch_dashboard_go.fish
    
    The script automatically cleans up any zombie PIDs bound to the suite's port range.
S
Description
No description provided
Readme
33 MiB
Languages
HTML 47%
JavaScript 22.9%
CSS 11.6%
Go 11.3%
Python 7.1%