Lightning ITSM

Enterprise IT Service Management built for AI. Full ITIL compliance with Projects, Tasks, Incidents, Changes, Knowledge, Problems, and Product Version tracking.

v3.4.0 Production

Architecture

                    ┌─────────────────────────────────────┐
                    │         Lightning ITSM v3.4.0       │
                    │    FastAPI + Redis + PostgreSQL     │
                    └──────────────────┬──────────────────┘
                                       │
          ┌────────────────────────────┼────────────────────────────┐
          │                            │                            │
    ┌─────▼─────┐              ┌───────▼───────┐            ┌───────▼───────┐
    │  REST API │              │   MCP Tools   │            │    Web UI     │
    │  :API_PORT   │              │  (Singularity)│            │    :API_PORT     │
    └───────────┘              └───────────────┘            └───────────────┘
          │
    ┌─────▼─────────────────────────────────────────────────────────────────┐
    │  PRJ │ TSK │ INC │ CHG │ KB │ PRB │ AST │ WL │ PMV                     │
    │  Projects│Tasks│Incidents│Changes│Knowledge│Problems│Assets│Worklogs│Versions│
    └───────────────────────────────────────────────────────────────────────┘

Record Types

PRJ - Projects

Track initiatives with status, priority, assignments, and linked tasks.

TSK - Tasks

Actionable work items linked to projects with effort tracking.

INC - Incidents

Service disruptions with severity, impact, and resolution tracking.

CHG - Changes

ITIL change management with rollback plans and approvals.

KB - Knowledge

Articles, solutions, and documentation with categories.

PMV - Product Versions

Track product versions, dev/prod paths, containers, and status.

API Examples

Create a Change Record

POST http://[node-ip]:API_PORT/changes
{
  "title": "Deploy ITSM API v3.4.0",
  "description": "Add PMV table for version tracking",
  "priority": "Medium",
  "category": "Software",
  "submitter": "claude",
  "rollback_plan": "Restore v3.3.0 symlink"
}

Response:
{
  "change_id": "CHG:0000000161",
  "uuid": "4348...",
  "status": "New"
}

Track Product Versions

POST http://[node-ip]:API_PORT/versions
{
  "product_name": "Lightning-ITSM",
  "version": "3.4.0",
  "status": "Production",
  "dev_path": "/mnt/storage/development/Lightning-ITSM",
  "prod_path": "/brain/infrastructure/lightning-api/itsm",
  "docker_container": "lightning-itsm-api",
  "port": API_PORT
}

Response:
{
  "pmv_id": "PMV:0000000003",
  "product_name": "Lightning-ITSM",
  "version": "3.4.0",
  "status": "Production"
}

MCP Integration

AI-Native: Lightning ITSM integrates directly with MCP tools. Claude can create incidents, track changes, and update knowledge bases through natural conversation.

# MCP Tool Call Example
Lightning-MCP:itsm_create_change
{
  "title": "Update singularity.py",
  "description": "Add new module",
  "rollback_plan": "Restore from backup"
}

# Returns: CHG:0000000162

Technical Details

Component	Details
API Port	API_PORT
Web UI Port	API_PORT
Redis Port	10006
PostgreSQL Port	10007
Container	lightning-itsm-api
Framework	FastAPI + Uvicorn
Dev Path	/mnt/storage/development/Lightning-ITSM/
Prod Path	/brain/infrastructure/lightning-api/itsm/