Dealer_Fusion_Workspace/
  dealer_fusion_mock_data_stub_v1/   — 31 JSONL data files + 11 JSON schemas
  dealer_fusion_core/                — shared DuckDB loader + privacy helper
  dealer_fusion_mcp/                 — FastMCP server  (port 4010, Bearer auth)
  dealer_fusion_explorer/
    backend/                         — FastAPI CRUD + graph API  (port 8020)
    frontend/                        — React + Vite + TypeScript  (port 5200)
  start_explorer.sh                  — stable backend start script

# 1 — Install Python dependencies
pip install -e dealer_fusion_core/
pip install -r requirements.txt

# 2 — Terminal 1: MCP server
cd /path/to/Dealer_Fusion_Workspace
python3 -m dealer_fusion_mcp.server

# 3 — Terminal 2: Explorer backend  (use the script — limits file-watching to src dirs only)
./start_explorer.sh

# 4 — Terminal 3: Explorer frontend
cd dealer_fusion_explorer/frontend
npm install
npm run dev -- --port 5200

GET  /api/entities                              — all 31 entity types with record counts
GET  /api/{entity}/list?page=&limit=&search=    — paginated, searchable table
GET  /api/{entity}/{id}                         — single record
POST /api/{entity}                              — create record
PUT  /api/{entity}/{id}                         — update record
DELETE /api/{entity}/{id}                       — soft-delete (sets deleted_at)
GET  /api/customers/{customer_key}/golden-record — force-graph payload for Golden Record view
GET  /api/search?q=                             — cross-entity full-text search
GET  /api/schema                                — all 31 tables with columns, row counts, and FK relationships
GET  /health                                    — health check

# Python — MCP server + Explorer backend
python3 -m pytest dealer_fusion_mcp/tests/ dealer_fusion_explorer/backend/tests/ -v

# Frontend — Vitest
cd dealer_fusion_explorer/frontend && npx vitest run

# Quick connectivity check using the MCP JSON-RPC protocol
python3 - << 'EOF'
import requests, json
r = requests.post("http://localhost:4010/mcp",
    headers={"Authorization": "Bearer dev-token",
             "Content-Type": "application/json",
             "Accept": "application/json, text/event-stream"},
    json={"jsonrpc":"2.0","id":1,"method":"initialize","params":{
        "protocolVersion":"2024-11-05","capabilities":{},
        "clientInfo":{"name":"test","version":"1"}}},
    stream=True, timeout=10)
sid = r.headers.get("mcp-session-id")
for line in r.iter_lines():
    line = line.decode() if isinstance(line, bytes) else line
    if line.startswith("data:"):
        d = json.loads(line[5:])
        print("Server:", d["result"]["serverInfo"])
        print("Session:", sid)
        break
EOF

--ps-bg-primary:     #0A0B0D
--ps-bg-surface:     #141518
--ps-bg-elevated:    #1E2025
--ps-text-primary:   #FFFFFF
--ps-text-secondary: #9CA3AF
--ps-accent:         #E63312
--ps-border:         rgba(255,255,255,0.10)