GHOST PROTOCOL HELPDESK

Enterprise-Grade Incident Management & Help Desk System for Windows

⬇️ Download

   

	File	Description
🖥️	GhostProtocol-1.0.0-Setup.exe	Windows installer — recommended for end users
📦	Source Code (.zip)	Full source — for developers

Features  •  Screenshots  •  Installation  •  Roles  •  Building

Why Ghost Protocol?

Managing IT incidents without the right tools leads to chaos — missed tickets, no accountability, zero visibility into operations. Ghost Protocol delivers a complete, offline-capable desktop command center for IT teams: from incident intake to resolution, knowledge sharing, comprehensive audit trails, and actionable analytics — all in one secure, self-contained application that runs entirely on your infrastructure.

---

✨ Features

🎫 Incident Management Full CRUD with role-based access control Status tracking: New, In Progress, Escalated, Resolved, Closed Priority levels: Critical, High, Medium, Low Department and assignee management Bulk actions: Assign, Priority change, Delete Smart deletion rules enforced per role	📊 Operations Dashboard Real-time incident metrics and KPIs Department load visualization chart Live activity feed with quick actions Critical incident alerts Today's resolution stats Auto-refresh polling
📚 Knowledge Base Markdown article editor with preview Category organization and filtering Full-text search across articles YES/NO feedback rating system Report an Issue functionality Real-time notifications bell	👥 User & Department Management End user (reporter) directory Ticket reassignment on user deletion Company department organization Incident reassignment protection Capacity tracking per department Active/Inactive status management
🔒 Security & Audit RBAC with 4 roles: Owner, Admin, Operator, Viewer bcrypt password hashing Session-based auth (auto-logout on close) Complete audit log with filtering User approval workflow Role hierarchy enforcement	📈 Reports & Analytics Incidents by status, priority, department Trend analysis over time Resolution rate metrics PDF report generation Excel/CSV data export Date range filtering
💾 Backup & Restore One-click database backup (Owner only) Restore from any backup point Backup history management JSON export for portability Data stored in %APPDATA% Survives app uninstall	🎨 User Experience Dark Intelligence Theater theme Cinematic splash screen with skip Smooth Framer Motion animations Custom window controls Responsive sidebar navigation Context-aware help system

---

📸 Screenshots

🔐 Login Screen

📂 View All Screenshots — click to expand

📊 Operations Dashboard

🎫 Incident Management
 

 

📚 Knowledge Base

👥 Users & Departments
 

📈 Reports & Audit
 

⚙️ Settings & Help
 

---

🎬 Demo Video

🎥 Full demo video coming soon — showcasing Ghost Protocol's complete workflow from incident intake to resolution.

---

🔐 Roles & Permissions

Role	Access Level	Capabilities
👑 OWNER	Full	Everything: Backup/Restore, Audit Log deletion, delete any ticket regardless of status
🛡️ ADMIN	High	Full management except Backup; cannot delete Closed/Resolved tickets
✏️ OPERATOR	Medium	Create and update tickets, manage end users
👁️ VIEWER	Read-only	View all data, no modifications allowed

---

🔑 Default Credentials

⚠️ Security Notice: Change default credentials immediately after first login in a production environment.

Role	Username	Password
👑 OWNER	pro	Ghost2026
🛡️ ADMIN	admin	Ghost2026

---

🛠️ Tech Stack

Category	Technologies
Frontend	React 18, Vite, Tailwind CSS, Framer Motion, GSAP
Backend	Electron, SQLite (better-sqlite3)
State	Zustand, React Hooks
Auth	bcryptjs, RBAC (Role-Based Access Control)

---

💻 System Requirements

Requirement	Specification
OS	Windows 10 or later
Resolution	1920×1080 recommended
Display Scaling	100%
Disk Space	~200 MB

---

🔧 Prerequisites (Development)

Tool	Version	Download
Node.js	18.x or later	https://nodejs.org/
npm	9.x or later	Included with Node.js
Git	Any recent version	https://git-scm.com/
Inno Setup 6	6.x (for building installer)	https://jrsoftware.org/isdl.php

Inno Setup PATH Setup

After installing Inno Setup, add it to your system PATH:

1. Find your Inno Setup install folder (default: C:\Program Files (x86)\Inno Setup 6)
2. Open System Properties → Environment Variables
3. Under System variables, select Path and click Edit
4. Click New and add: C:\Program Files (x86)\Inno Setup 6
5. Click OK and restart your terminal

Verify with:

iscc /?

---

📦 Installation

1. Clone the repository

git clone https://github.com/moner-dev/ghost-protocol-helpdesk.git
cd ghost-protocol-helpdesk

2. Install dependencies

npm install

---

🚀 Development

Start with Electron (full app)

npm run electron:dev

Launches the Vite dev server and opens the Electron window with hot reload. The SQLite database is created automatically in %APPDATA%\ghost-protocol\.

Start the dev server (browser only)

npm run dev

Opens the React app at http://localhost:5173 (no Electron shell, no database).

Preview a production build locally

npm run electron:preview

Builds the Vite bundle and runs it inside Electron without packaging.

---

🔨 Building

Step 1: Build the Vite bundle

npm run build

Compiles the React app into the dist/ folder.

Step 2: Package with Electron Builder

npm run electron:build

Runs vite build and then electron-builder --win. Output goes to:

release/
  win-unpacked/                    ← Portable app
  GHOST PROTOCOL-1.0.0-Setup.exe   ← NSIS installer

Step 3: Build the Inno Setup installer

npm run build:inno

Compiles installer.iss into a standalone installer. Output:

release/
  installer/
    GhostProtocol-1.0.0-Setup.exe

All-in-one build

npm run build:installer

Runs all three steps in sequence: vite build → electron-builder --win → iscc installer.iss.

---

📋 NPM Scripts Reference

Script	Command	Description
dev	vite	Start Vite dev server (browser only)
build	vite build	Build the React bundle to dist/
preview	vite preview	Preview the built bundle in browser
electron:dev	concurrently vite + electron	Full Electron dev mode with hot reload
electron:build	vite build && electron-builder	Package the app for Windows
electron:preview	vite build && electron .	Quick preview in Electron
build:installer	vite build && electron-builder && iscc	Full build + Inno Setup installer
build:inno	iscc installer.iss	Compile only the Inno Setup installer

---

🗂️ Project Structure

ghost-protocol/
├── electron/
│   ├── main.cjs              # Electron main process
│   ├── preload.cjs           # Context bridge (secure IPC)
│   └── database/
│       └── db.cjs            # SQLite database layer
├── src/
│   ├── main.jsx              # React entry point
│   ├── App.jsx               # Router and app shell
│   ├── pages/                # Full-page components
│   ├── components/
│   │   ├── dashboard/        # Dashboard feature components
│   │   ├── knowledge/        # Knowledge base components
│   │   ├── shared/           # AuthGuard, WindowControls, etc.
│   │   └── ui/               # Reusable UI components
│   ├── hooks/                # Custom React hooks (data + auth)
│   ├── utils/                # Formatters, export helpers
│   ├── constants/            # Theme, options
│   ├── styles/               # Global CSS, variables
│   └── assets/               # Icons, images
├── screenshots/              # Screenshot images for README
├── installer.iss             # Inno Setup installer script
├── electron-builder.config.cjs
├── vite.config.js
├── tailwind.config.js
└── package.json

---

🗄️ Data Storage

The SQLite database is created automatically on first launch at:

%APPDATA%\ghost-protocol\ghost-protocol.db

This directory is not included in the installer. Uninstalling the app does not delete user data.

---

🛠️ Troubleshooting

iscc is not recognized

Inno Setup is not in your PATH. See the Inno Setup PATH Setup section above.

better-sqlite3 build fails

This native module must be compiled for your Electron version:

npm run electron:build

Electron Builder handles the native rebuild automatically. If it still fails:

npx electron-rebuild -f -w better-sqlite3

Electron Builder symlink error (winCodeSign)

If you see Cannot create symbolic link errors during electron-builder, the code signing cache extraction is failing. This is cosmetic — the app still packages correctly.

Large chunk warnings during Vite build

The markdown and index chunks exceed 500 KB. This is expected due to the markdown editor and main application bundle. It does not affect functionality.

---

📋 Roadmap

• v1.0.0 — Initial public release
• bcrypt full migration (replace simpleHash fallback)
• Check for Updates — GitHub Releases API integration
• Demo video & marketing materials
• v1.1.0 — Enhanced reporting & analytics
• Email notifications integration
• Multi-language support

---

📄 License

MIT License — See LICENSE

Copyright (c) 2026 MONER INTELLIGENCE SYSTEMS

---

👻 Ghost Protocol

Built with ❤️ by MONER INTELLIGENCE SYSTEMS
Application Developer & AI Specialist