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:
- Go: Version
1.21or higher (go version) - Fish Shell: For running the automatic process recovery script (
fish) - Make & GCC: Standard compilation build essentials
- PostgreSQL: Required for Khira Dev Ticketing storage
- 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):
KHIRA_PRIMARY_DB_URL:postgres://[email protected]:5432/khira_primary?sslmode=disableKHIRA_BACKUP_DB_URL:postgres://[email protected]:5432/khira_backup?sslmode=disable
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-gatewaybin/bulk-api-testerbin/image-manipulatorbin/image-hosterbin/image-mergerbin/json-suitebin/json-image-downloaderbin/png-frame-detectorbin/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:
- Zero Port Conflicts: Automatically checks and kills any lingering or orphaned processes on ports
10000,5001,5002,5003,5004,5005,5006,5007,5008,5009,5010usinglsof/fuser. - Directory Resolution: Dynamically locates the repository root.
- Gateway Orchestration: Starts
nexus-gatewayon port10000, which automatically readsconfigs/tools.yamland 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
configs/tools.yaml: Defines all tool definitions, port numbers, launch commands, working directories, and log destinations.launch_dashboard_go.fish: Process killer and gateway launcher script.data/bulk-api-tester/spaces.json: Workspace collections, tabs, and bulk tester requests.data/bulk-api-tester/docs_apis.json: Interactive API catalog for instant import.
🔍 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:
The script automatically cleans up any zombie PIDs bound to the suite's port range.
./launch_dashboard_go.fish