Add DECOM workflow type, auto-note/hide on decom, show CVEs on CARD queue items, auto-run migrations in pipeline

- Add DECOM to queue workflow types (red badge, inventory-style display)
- When findings are added as DECOM, auto-set note to 'DECOM' and hide row
- Hidden rows are excluded from donut charts (removes from pending count)
- Show CVEs on CARD/GRANITE/DECOM queue items (was previously omitted)
- Add backend/migrations/run-all.js for CI/CD auto-migration execution
- Pipeline now runs migrations before service restart on both staging and prod
- Add add_decom_workflow_type.js migration (updates CHECK constraint)

.gitignore

@@ -1,6 +1,5 @@
 # Node modules
 node_modules/
-package-lock.json
 
 # Database
 backend/cve_database.db
@@ -39,10 +38,6 @@ frontend.pid
 backend/uploads/temp/
 feature_request*.md
 
-# Planning docs
-docs/aeo-compliance-ui-plan.md
-docs/aeo-compliance-wireframe.md
-
 # AI tooling config
 .claude/
 ai_notes.md
@@ -51,3 +46,28 @@ backend/add_vendor_to_documents.js
 backend/fix_multivendor_constraint.js
 backend/server.js-backup
 backend/setup.js-backup
+
+# Compliance staging — keep folder, ignore contents
+.compliance-staging/*
+!.compliance-staging/.gitkeep
+
+# Kiro agents (local only)
+.kiro/
+
+# Zip files
+*.zip
+
+# Production DB copies
+cve_database_prod.db
+cve_database.db.prod
+cve_database.db.backup
+database.db
+
+# Operations — local admin records, UAT logs, firewall requests, data exports
+docs/operations/
+
+# Data exports — local spreadsheets
+docs/data-exports/
+
+# Python cache
+__pycache__/

.gitlab-ci.yml

@@ -0,0 +1,300 @@
+# =============================================================================
+# GitLab CI/CD Pipeline — STEAM Security Dashboard
+# =============================================================================
+#
+# Pipeline stages:
+#   1. install   — install dependencies for backend and frontend
+#   2. lint      — run linters / static checks
+#   3. test      — run backend (Jest) and frontend (react-scripts) tests
+#   4. build     — produce the production frontend bundle
+#   5. deploy    — deploy to staging (local) or production (SSH to 71.85.90.6)
+#   6. verify    — post-deploy health checks
+#
+# Environments:
+#   staging    — dashboard-dev:3100 (auto-deploy on main/master)
+#   production — 71.85.90.6:3001 (manual trigger, requires staging verification)
+#
+# Executor: shell (runs on dashboard-dev using system Node.js)
+# =============================================================================
+
+# ---------------------------------------------------------------------------
+# Variables
+# ---------------------------------------------------------------------------
+variables:
+  PROD_HOST: "71.85.90.6"
+  PROD_USER: "root"
+  PROD_DIR: "/home/cve-dashboard"
+  STAGING_DIR: "/home/cve-dashboard-staging"
+
+# ---------------------------------------------------------------------------
+# Global cache — persists node_modules between pipeline runs
+# ---------------------------------------------------------------------------
+cache:
+  key: ${CI_COMMIT_REF_SLUG}
+  paths:
+    - node_modules/
+    - frontend/node_modules/
+  policy: pull
+
+# ---------------------------------------------------------------------------
+# Stages
+# ---------------------------------------------------------------------------
+stages:
+  - install
+  - lint
+  - test
+  - build
+  - deploy
+  - verify
+
+# =============================================================================
+# STAGE 1: Install dependencies
+# =============================================================================
+
+install-backend:
+  stage: install
+  script:
+    - npm ci --prefer-offline
+  cache:
+    key: ${CI_COMMIT_REF_SLUG}
+    paths:
+      - node_modules/
+    policy: pull-push
+
+install-frontend:
+  stage: install
+  script:
+    - cd frontend && npm ci --prefer-offline
+  cache:
+    key: ${CI_COMMIT_REF_SLUG}
+    paths:
+      - frontend/node_modules/
+    policy: pull-push
+
+# =============================================================================
+# STAGE 2: Lint / static analysis
+# =============================================================================
+
+lint-frontend:
+  stage: lint
+  script:
+    - cd frontend && npm ci --prefer-offline && npx eslint src/ --ignore-pattern '**/__tests__/**' --ignore-pattern '**/*.test.js' --max-warnings 10
+  needs:
+    - install-frontend
+
+lint-backend:
+  stage: lint
+  script:
+    - npm ci --prefer-offline
+    - node -c backend/server.js
+    - node -c backend/routes/*.js
+    - node -c backend/helpers/*.js
+    - node -c backend/middleware/*.js
+  needs:
+    - install-backend
+
+# =============================================================================
+# STAGE 3: Tests
+# =============================================================================
+
+test-backend:
+  stage: test
+  script:
+    - npm ci --prefer-offline
+    - ./node_modules/.bin/jest --ci --forceExit backend/__tests__/
+  timeout: 5 minutes
+  needs:
+    - install-backend
+
+test-frontend:
+  stage: test
+  script:
+    - npm ci --prefer-offline
+    - cd frontend && npm ci --prefer-offline && CI=true npx react-scripts test --watchAll=false --ci
+  timeout: 5 minutes
+  needs:
+    - install-frontend
+
+# =============================================================================
+# STAGE 4: Build
+# =============================================================================
+
+build-frontend:
+  stage: build
+  script:
+    - cd frontend && npm ci --prefer-offline && CI=false REACT_APP_API_BASE=/api REACT_APP_API_HOST="" npm run build
+  artifacts:
+    paths:
+      - frontend/build/
+    expire_in: 7 days
+  needs:
+    - test-frontend
+    - lint-frontend
+
+# =============================================================================
+# STAGE 5: Deploy
+# =============================================================================
+
+# ---------------------------------------------------------------------------
+# Staging — auto-deploys on main/master to dashboard-dev:3100
+# ---------------------------------------------------------------------------
+deploy-staging:
+  stage: deploy
+  rules:
+    - if: $CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH == "master"
+      when: on_success
+  environment:
+    name: staging
+    url: http://localhost:3100
+  script:
+    - echo "Deploying to staging (dashboard-dev:3100)..."
+    # Ensure staging directory exists
+    - mkdir -p ${STAGING_DIR}
+    # Sync code (exclude .git, node_modules, uploads, logs)
+    - rsync -a --delete
+        --exclude='.git'
+        --exclude='node_modules'
+        --exclude='frontend/node_modules'
+        --exclude='frontend/build'
+        --exclude='backend/uploads'
+        --exclude='*.log'
+        --exclude='*.db'
+        --exclude='.env'
+        ${CI_PROJECT_DIR}/ ${STAGING_DIR}/
+    # Copy built frontend
+    - cp -r ${CI_PROJECT_DIR}/frontend/build ${STAGING_DIR}/frontend/build
+    # Install deps in staging
+    - cd ${STAGING_DIR} && npm ci --prefer-offline
+    - cd ${STAGING_DIR}/frontend && npm ci --prefer-offline
+    # Ensure staging .env exists
+    - |
+      if [ ! -f "${STAGING_DIR}/backend/.env" ]; then
+        cp ${CI_PROJECT_DIR}/backend/.env ${STAGING_DIR}/backend/.env
+        sed -i 's/^PORT=.*/PORT=3100/' ${STAGING_DIR}/backend/.env
+        grep -q "^PORT=" ${STAGING_DIR}/backend/.env || echo "PORT=3100" >> ${STAGING_DIR}/backend/.env
+      fi
+    # Run migrations
+    - cd ${STAGING_DIR}/backend && node migrations/run-all.js
+    # Restart staging service
+    - sudo systemctl restart cve-backend-staging || sudo systemctl start cve-backend-staging || true
+    - echo "Staging deploy complete."
+  needs:
+    - build-frontend
+    - test-backend
+
+# ---------------------------------------------------------------------------
+# Production — manual trigger, SSH to 71.85.90.6
+# ---------------------------------------------------------------------------
+deploy-production:
+  stage: deploy
+  rules:
+    - if: $CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH == "master"
+      when: manual
+  environment:
+    name: production
+    url: http://71.85.90.6:3001
+  script:
+    - echo "Deploying to production (${PROD_HOST})..."
+    # Record current commit on prod for rollback
+    - ssh ${PROD_USER}@${PROD_HOST} "cd ${PROD_DIR} && git rev-parse HEAD 2>/dev/null || echo none" > /tmp/prod-prev-commit
+    - echo "Previous production commit:$(cat /tmp/prod-prev-commit)"
+    # Sync code to production (exclude local-only files)
+    - rsync -az --delete
+        --exclude='.git'
+        --exclude='node_modules'
+        --exclude='frontend/node_modules'
+        --exclude='frontend/build'
+        --exclude='backend/uploads'
+        --exclude='*.log'
+        --exclude='*.db'
+        --exclude='.env'
+        --exclude='.compliance-staging'
+        ${CI_PROJECT_DIR}/ ${PROD_USER}@${PROD_HOST}:${PROD_DIR}/
+    # Copy built frontend
+    - rsync -az ${CI_PROJECT_DIR}/frontend/build/ ${PROD_USER}@${PROD_HOST}:${PROD_DIR}/frontend/build/
+    # Install deps on production
+    - ssh ${PROD_USER}@${PROD_HOST} "cd ${PROD_DIR} && npm ci --prefer-offline"
+    - ssh ${PROD_USER}@${PROD_HOST} "cd ${PROD_DIR}/frontend && npm ci --prefer-offline"
+    # Run migrations
+    - ssh ${PROD_USER}@${PROD_HOST} "cd ${PROD_DIR}/backend && node migrations/run-all.js"
+    # Restart services — install systemd unit if not present
+    - ssh ${PROD_USER}@${PROD_HOST} "test -f /etc/systemd/system/cve-backend.service" || scp ${CI_PROJECT_DIR}/deploy/cve-backend-production.service ${PROD_USER}@${PROD_HOST}:/etc/systemd/system/cve-backend.service
+    - ssh ${PROD_USER}@${PROD_HOST} "systemctl daemon-reload && systemctl enable cve-backend && systemctl restart cve-backend"
+    - echo "Production deploy complete."
+  needs:
+    - build-frontend
+    - test-backend
+
+# =============================================================================
+# STAGE 6: Post-deploy verification
+# =============================================================================
+
+# ---------------------------------------------------------------------------
+# Staging health check
+# ---------------------------------------------------------------------------
+verify-staging:
+  stage: verify
+  rules:
+    - if: $CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH == "master"
+      when: on_success
+  script:
+    - echo "Verifying staging..."
+    - sleep 3
+    - |
+      for i in 1 2 3 4 5; do
+        STATUS=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:3100/api/health 2>/dev/null || echo "000")
+        if [ "$STATUS" = "200" ]; then
+          echo "Staging health check passed (attempt $i)"
+          break
+        fi
+        echo "Staging not ready (status: $STATUS), retrying... (attempt $i/5)"
+        sleep 3
+      done
+      if [ "$STATUS" != "200" ]; then
+        echo "FAILED: Staging health check failed after 5 attempts"
+        exit 1
+      fi
+    - echo "Staging verification passed."
+  needs:
+    - deploy-staging
+
+# ---------------------------------------------------------------------------
+# Production health check — rolls back on failure
+# ---------------------------------------------------------------------------
+verify-production:
+  stage: verify
+  rules:
+    - if: $CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH == "master"
+      when: on_success
+  script:
+    - echo "Verifying production..."
+    - sleep 3
+    - |
+      for i in 1 2 3 4 5 6 7 8 9 10; do
+        STATUS=$(curl -s -o /dev/null -w "%{http_code}" http://${PROD_HOST}:3001/api/health 2>/dev/null || echo "000")
+        if [ "$STATUS" = "200" ]; then
+          echo "Production health check passed (attempt $i)"
+          break
+        fi
+        echo "Production not ready (status: $STATUS), retrying... (attempt $i/10)"
+        sleep 3
+      done
+      if [ "$STATUS" != "200" ]; then
+        echo "FAILED: Production health check failed — initiating rollback"
+        PREV_COMMIT=$(cat /tmp/prod-prev-commit 2>/dev/null || echo "")
+        if [ -n "$PREV_COMMIT" ] && [ "$PREV_COMMIT" != "none" ]; then
+          echo "Rolling back to $PREV_COMMIT..."
+          # Re-sync the previous version
+          ssh ${PROD_USER}@${PROD_HOST} "cd ${PROD_DIR} && git checkout ${PREV_COMMIT} --force 2>/dev/null" || true
+          ssh ${PROD_USER}@${PROD_HOST} "cd ${PROD_DIR} && npm ci --prefer-offline"
+          ssh ${PROD_USER}@${PROD_HOST} "systemctl restart cve-backend"
+          echo "Rollback complete. Verify manually."
+        else
+          echo "No previous commit recorded — manual intervention required."
+        fi
+        exit 1
+      fi
+    - echo "Production verification passed."
+  needs:
+    - deploy-production
+  allow_failure: false

CHANGELOG.md

@@ -0,0 +1,59 @@
+# Changelog
+
+## v1.0.0 — 2026-05-01
+
+First official release. Consolidates all features developed since initial commit into a stable, documented, deployment-ready package.
+
+### Core Platform
+- CVE tracking with multi-vendor support, document storage, and NVD API auto-fill
+- Session-based authentication with four user groups (Admin, Standard_User, Leadership, Read_Only)
+- Full audit logging of all state-changing actions
+- Dark tactical intelligence UI theme with monospace typography
+
+### Ivanti Integration
+- Live sync of open host findings from Ivanti/RiskSense API (auto-sync every 24h)
+- Reporting page with donut metric charts, advanced per-column filtering, inline editing
+- FP workflow submission directly to Ivanti API with file attachments
+- Ivanti Queue — personal staging list for batch FP, Archer, CARD, and Granite workflows
+- Queue item redirect between workflow types after completion
+- Row visibility controls with localStorage persistence
+
+### Archive and Anomaly Tracking
+- Automatic detection of disappeared and returned findings across syncs
+- BU drift checker — classifies archived findings by reason (BU reassignment, severity drift, closed on platform, decommissioned)
+- Return classification — explains why findings came back (BU reassigned back, severity re-escalated, etc.)
+- Findings Trend chart with archive activity sparkline and shift reason tooltips
+- Anomaly banner for significant archive events
+
+### Compliance (AEO Posture)
+- Weekly NTS_AEO xlsx upload with diff preview (new, resolved, recurring)
+- Schema drift detection with breaking/silent-miss/cosmetic classification
+- Admin config reconciliation for parser updates
+- Per-team metric health cards with grouped categories and variant pills
+- Device-level violation tracking with timestamped notes history
+- Multi-metric note grouping
+- Upload rollback support
+
+### Integrations
+- Jira Data Center — create, sync, and track tickets linked to CVE/vendor pairs
+- Archer — risk acceptance exception tracking (EXC numbers)
+- Atlas InfoSec — action plan cache, bulk creation from row selection, metrics reporting
+- CARD API — Granite/CARD asset lookup for network device workflows
+- NVD API — auto-fill CVE metadata with bulk sync support
+
+### Knowledge Base
+- Internal document library with inline PDF and Markdown rendering
+- Category-based browsing and search
+
+### Admin
+- Full-page admin panel with user management, audit log, and system info tabs
+- Themed confirm modals replacing browser dialogs
+- User profile panel with self-service password change
+
+### Infrastructure
+- Consolidated `setup.js` with complete database schema (27 tables, all indexes and triggers)
+- systemd service files for persistent deployment
+- GitLab CI/CD pipeline (install, lint, test, build, deploy)
+- GPG-signed commits for code provenance
+- Organized documentation structure (api, design, guides, security, testing, troubleshooting)
+- Migration scripts documented and retained for existing deployment upgrades

README.md

@@ -1,820 +1,141 @@
-# STEAM Security Dashboard
+# STEAM Security Dashboard v1.0.0
 
-A self-hosted vulnerability management dashboard for the NTS-AEO-STEAM and NTS-AEO-ACCESS-ENG business units. Centralises CVE tracking, Ivanti host finding triage, AEO compliance posture, FP and Archer exception workflows, and internal documentation in a single interface.
+A self-hosted vulnerability management dashboard for the NTS-AEO-STEAM and NTS-AEO-ACCESS-ENG business units. Centralises CVE tracking, Ivanti host finding triage, AEO compliance posture, FP/Archer/CARD exception workflows, and internal documentation in a single interface.
 
----
+## Quick Start
 
-## Table of Contents
+### Prerequisites
 
-- [Overview](#overview)
-- [Tech Stack](#tech-stack)
-- [Prerequisites](#prerequisites)
-- [Installation](#installation)
-- [Configuration](#configuration)
-- [Running the Application](#running-the-application)
-- [Features](#features)
-  - [Authentication and User Roles](#authentication-and-user-roles)
-  - [Home — CVE Management](#home--cve-management)
-  - [Reporting — Host Findings](#reporting--host-findings)
-  - [Ivanti Queue](#ivanti-queue)
-  - [Compliance — AEO Posture](#compliance--aeo-posture)
-  - [Knowledge Base](#knowledge-base)
-  - [Exports](#exports)
-  - [Archer Risk Acceptance Tickets](#archer-risk-acceptance-tickets)
-  - [User Management (Admin)](#user-management-admin)
-  - [Audit Log (Admin)](#audit-log-admin)
-- [Scripts](#scripts)
-- [API Reference](#api-reference)
-- [Architecture](#architecture)
-- [Database Schema](#database-schema)
-- [Security Model](#security-model)
-- [Migrations](#migrations)
+- Node.js 18+
+- Docker (for PostgreSQL 16 container)
+- Python 3 with `python3-pandas` and `python3-openpyxl` (for compliance xlsx parsing)
 
----
-
-## Overview
-
-The STEAM Security Dashboard answers a common problem in vulnerability management: tracking which CVEs have been addressed, whether supporting vendor documentation exists, where each finding is in the remediation or exception workflow, and how the team's overall AEO compliance posture is trending week over week.
-
-The application provides:
-
-- A searchable, filterable CVE list with per-vendor tracking and document storage
-- NVD API integration to auto-populate CVE metadata
-- **Ivanti/RiskSense integration** — sync open host findings with live FP workflow tracking
-- **Reporting page** with donut charts, advanced per-column filtering, inline editing, Ivanti Queue, and CSV/XLSX export
-- **Ivanti Queue** — personal staging list for batch-processing FP, Archer, and CARD workflows
-- **AEO Compliance page** — weekly xlsx upload, diff preview, per-team metric health cards, device-level violation tracking with notes history
-- Archer risk acceptance ticket tracking (EXC numbers) linked to CVE/vendor pairs
-- A knowledge base for internal documentation and policies
-- Role-based access control with a full audit trail
-
----
-
-## Tech Stack
-
-| Layer | Technology |
-|---|---|
-| Backend | Node.js, Express 5 |
-| Database | SQLite3 |
-| File uploads | Multer 2 |
-| Auth | bcryptjs, cookie-based sessions |
-| Frontend | React 19, lucide-react, xlsx |
-| Compliance xlsx parsing | Python 3, pandas, openpyxl |
-| Bulk notes import | Python 3 (stdlib only) |
-
----
-
-## Prerequisites
-
-- Node.js 18 or later
-- npm
-- Python 3 with `python3-pandas` and `python3-openpyxl` apt packages (required for compliance xlsx parsing)
-
----
-
-## Installation
-
-### 1. Clone the repository
+### Install
 
 ```bash
 git clone <repo-url>
 cd cve-dashboard
-```
 
-### 2. Install backend dependencies
-
-```bash
-cd backend
+# Backend dependencies
 npm install
-```
 
-### 3. Install frontend dependencies
+# Frontend dependencies
+cd frontend && npm install && cd ..
 
-```bash
-cd frontend
-npm install
-```
-
-### 4. Install Python dependencies
-
-Install via apt — this is the correct approach on Ubuntu/Debian and mirrors the dev server setup:
-
-```bash
+# Python dependencies (Ubuntu/Debian)
 apt install -y python3-pandas python3-openpyxl
 ```
 
-> If apt packages are unavailable or you need a specific version, see `docs/python-venv-setup.md` for the venv fallback approach.
-
-> The bulk notes import script (`import_notes_from_csv.py`) uses only Python stdlib and does **not** require these packages.
-
-### 5. Initialize the database
-
-Run once from the `backend/` directory to create the SQLite database, all tables, indexes, and a default admin user:
+### Configure
 
 ```bash
-cd backend
-node setup.js
+cp backend/.env.example backend/.env
+# Edit backend/.env — at minimum set SESSION_SECRET and DATABASE_URL:
+#   openssl rand -base64 32
 ```
 
-This creates `backend/cve_database.db` and a default admin account:
-- Username: `admin`
-- Password: `admin123`
+See `backend/.env.example` for all available options including `DATABASE_URL`, Ivanti API, Jira, and Atlas integration keys.
 
-**Change the admin password immediately after first login.**
+### Start PostgreSQL
 
-### 6. Run database migrations
-
-Apply all feature migrations in order:
+The deploy script handles the full Postgres setup — container, schema, dependencies, and data migration from SQLite:
 
 ```bash
-cd backend
-node migrations/add_knowledge_base_table.js
-node migrations/add_archer_tickets_table.js
-node migrations/add_ivanti_sync_table.js
-node migrations/add_ivanti_findings_tables.js
-node migrations/add_ivanti_todo_queue_table.js
-node migrations/add_card_workflow_type.js
-node migrations/add_todo_queue_ip_address.js
-node migrations/add_compliance_tables.js
+chmod +x scripts/deploy-postgres.sh
+./scripts/deploy-postgres.sh
 ```
 
-### 7. Build the frontend
+For fresh installs without an existing SQLite database, the script creates the schema and skips migration.
+
+### Build and Run
 
 ```bash
-cd frontend
-npm run build
+# Build frontend
+cd frontend && npm run build && cd ..
+
+# Start servers
+./start-servers.sh
 ```
 
-Or use `npm start` for the development server (see [Running the Application](#running-the-application)).
+Dashboard: http://localhost:3000 · API: http://localhost:3001
 
----
-
-## Configuration
-
-The application is configured via `.env` files. These files are gitignored and must be created manually per environment.
-
-### Backend: `backend/.env`
-
-```env
-PORT=3001
-API_HOST=localhost
-CORS_ORIGINS=http://YOUR_IP:3000
-SESSION_SECRET=change-this-to-a-long-random-string
-NODE_ENV=production
-
-# Optional: NVD API key for higher rate limits (50 req/30s vs 5 req/30s)
-# Register at https://nvd.nist.gov/developers/request-an-api-key
-NVD_API_KEY=your-key-here
-
-# Ivanti / RiskSense integration (required for Reporting page sync)
-IVANTI_API_KEY=your-ivanti-api-key
-IVANTI_CLIENT_ID=1550
-# Optional: filter workflows to a specific person's submissions
-IVANTI_FIRST_NAME=
-IVANTI_LAST_NAME=
-# Set to 'true' if your network has SSL inspection / self-signed certs
-IVANTI_SKIP_TLS=false
-```
-
-### Frontend: `frontend/.env`
-
-```env
-REACT_APP_API_BASE=http://YOUR_IP:3001/api
-REACT_APP_API_HOST=http://YOUR_IP:3001
-```
-
-Replace `YOUR_IP` with the machine's IP address or hostname. Use `localhost` for local-only access.
-
-> **Important:** React caches environment variables at build/start time. After changing `frontend/.env`, fully restart the frontend process — a browser refresh alone is not sufficient.
-
----
-
-## Running the Application
-
-### Using the helper scripts (recommended)
-
-From the project root:
-
-```bash
-./start-servers.sh   # Starts backend and frontend in the background
-./stop-servers.sh    # Stops all servers
-```
-
-The start script saves PIDs to `backend.pid` and `frontend.pid`. Logs are written to `backend/backend.log` and `frontend/frontend.log`.
-
-### Running manually
-
-```bash
-# Terminal 1 — backend
-cd backend
-node server.js
-
-# Terminal 2 — frontend (development server)
-cd frontend
-npm start
-```
-
-### Default ports
-
-| Service | URL |
-|---|---|
-| Frontend | http://localhost:3000 |
-| Backend API | http://localhost:3001 |
-
----
+The helper scripts use `systemctl` under the hood — the systemd units in `systemd/` must be installed first. See the full manual for setup instructions.
 
 ## Features
 
-### Authentication and User Roles
-
-All routes require authentication. Three roles are supported:
-
-| Role | Permissions |
-|---|---|
-| `viewer` | Read-only: CVEs, documents, findings, reports, knowledge base, Archer tickets, compliance data |
-| `editor` | All viewer permissions plus: create/update CVEs, upload documents, sync Ivanti findings, save notes and overrides, manage knowledge base, manage Archer tickets, upload compliance reports, manage Ivanti Queue |
-| `admin` | All editor permissions plus: delete documents, delete reports, manage users, view audit logs |
-
-Sessions expire after 24 hours. Session tokens are stored in `httpOnly` cookies.
-
----
-
-### Home — CVE Management
-
-The home page is the primary CVE research and tracking tool.
-
-**CVE List**
-- Search CVEs by keyword (matches CVE ID, vendor, description)
-- Filter by vendor, severity (Critical / High / Medium / Low), and status
-- Color-coded severity badges: Critical (red), High (amber), Medium (sky blue), Low (green)
-- Paginated list view
-
-**CVE Operations (editor/admin)**
-- Add a new CVE entry — NVD auto-fill populates description, severity, and published date automatically
-- Edit any field on an existing CVE entry
-- Update status for all vendor rows matching a CVE ID in one click
-- Delete a single vendor entry or all vendor entries for a CVE ID
-- The same CVE ID can be tracked across multiple vendors independently
-
-**Document Management**
-- Upload documents attached to a CVE/vendor pair
-- Supported document types: `advisory`, `email`, `screenshot`, `patch`, `other`
-- Allowed file extensions: PDF, images (PNG, JPG, GIF, BMP, TIFF), Office documents (DOC, DOCX, XLS, XLSX, PPT, PPTX), text files (TXT, MD, CSV, LOG), email files (MSG, EML), and others (RTF, HTML, XML, JSON, YAML, ODF variants, ZIP, GZ, TAR, 7Z)
-- File size limit: 10 MB per upload
-- Admins can delete documents
-
-**NVD Integration**
-- Auto-fill CVE description, severity, and published date from the NIST NVD API 2.0 when adding a new CVE
-- Bulk NVD Sync (editor/admin): fetch updated metadata for all CVEs in the database in one operation
-- CVSS severity cascade: v3.1 preferred, then v3.0, then v2.0
-- Rate-limit aware: respects NVD's 5 req/30s unauthenticated limit; with `NVD_API_KEY` the limit increases to 50 req/30s
-
-**Archer Ticket Quick Navigation**
-- Archer EXC numbers shown on CVE rows
-- Clicking an EXC badge navigates to the Reporting page pre-filtered to findings with that EXC number
-
-**Calendar Widget**
-- Shows current month with red dot indicators on dates where Ivanti findings are due
-- Click a date to navigate to the Reporting page filtered to that due date
-
----
-
-### Reporting — Host Findings
-
-The Reporting page is the core operational view for remediation tracking. It integrates with Ivanti/RiskSense to show all host findings for the configured business units.
-
-#### Syncing Data
-
-Click **Sync** (top right) to pull the latest findings from Ivanti. The sync:
-1. Fetches all open host findings matching your BU filters and severity range (8.5–9.9 VRR)
-2. Fetches the closed finding count separately
-3. Sweeps closed findings to capture FP workflow states (including Approved FPs now closed)
-4. Stores everything in the local SQLite cache
-
-Findings are also auto-synced on a 24-hour schedule. The last sync timestamp is shown at the top of the page.
-
-> `IVANTI_API_KEY` must be set in `backend/.env` for sync to work.
-
-#### Metric Charts
-
-| Chart | What it shows |
-|---|---|
-| **Open vs Closed** | Total open vs closed host findings direct from the Ivanti API |
-| **Action Coverage** | Findings by action taken: FP Request · Archer Exception · Pending. Click a segment to filter the table. |
-| **FP Finding Status** | How many *findings* are in each FP workflow state (Actionable, Requested, Reworked, Approved, Rejected, Expired) |
-| **FP Workflow Status** | How many *unique FP# ticket IDs* are in each state — one ticket can cover many findings |
-
-#### Findings Table
-
-Each row represents a single Ivanti host finding.
-
-| Column | Description |
-|---|---|
-| Finding ID | Ivanti finding identifier |
-| Severity | Numerical VRR score with group label (CRITICAL / HIGH) |
-| Title | Vulnerability title |
-| CVEs | Associated CVE IDs — up to 2 shown, remainder as "+N" badge |
-| Host | Hostname — inline editable |
-| IP Address | Host IP address |
-| DNS | DNS/FQDN — inline editable |
-| Due Date | Remediation due date; red if overdue, amber if within 30 days |
-| SLA | SLA status: OVERDUE / AT_RISK / WITHIN_SLA |
-| BU | Business unit |
-| Workflow | FP# ticket ID and state badge — colour-coded by urgency |
-| Last Found | Last detection date from Ivanti |
-| Notes | Free-form notes — inline editable, persists across syncs |
-
-**Inline editing:** Click a Host or DNS cell to override the Ivanti value. An amber dot (●) marks overridden cells; use the revert button (↻) to restore the original. Overrides survive re-syncs.
-
-**Filtering:** Click ⊙ on any column header for multi-select filtering. The `— empty —` option filters to findings with no value in that column. Multiple filters are ANDed. The Action Coverage chart also acts as a filter.
-
-**Column management:** Toggle visibility and drag to reorder via the **Columns** button. Order and visibility persist to `localStorage`.
-
-**Export:** Click **Export** to download the current filtered view as CSV or XLSX.
-
----
-
-### Ivanti Queue
-
-A personal staging list for batch-processing FP, Archer, and CARD workflows without context-switching into Ivanti mid-review.
-
-**Adding items:** Check the checkbox at the far left of any finding row. A popover appears:
-- For **FP** and **Archer** items: enter the Vendor / Platform (e.g., "Juniper MX", "Cisco IOS-XE")
-- For **CARD** items: no vendor entry required — the IP address is captured automatically
-- Select the workflow type: **FP**, **Archer**, or **CARD**
-- Click **Add to Queue** — the row checkbox turns solid blue
-
-**Queue panel:** Click the **Queue** button (top right of Reporting page) to open the slide-out panel:
-- **CARD** items appear at the top in their own section with the IP address displayed
-- **FP and Archer** items are grouped alphabetically by vendor below
-- Badges show workflow type: amber = FP, sky = Archer, green = CARD
-
-**Working the queue:**
-- Check the green checkbox on an item to mark it complete (strikethrough at reduced opacity)
-- Delete individual items with the trash icon, or select multiple and use **Delete (N)**
-- **Clear Completed** removes all marked-complete items at once
-
-Queue items are stored in the database, are **personal to your login**, and persist across sessions and page refreshes.
-
----
-
-### Compliance — AEO Posture
-
-The Compliance page tracks NTS-AEO team posture against the AEO compliance framework using weekly xlsx reports exported from the NTS_AEO reporting system.
-
-#### Upload Workflow
-
-Editors and admins can upload a new compliance report via the **Upload Report** button:
-
-1. Drop or browse for the `NTS_AEO_YYYY_MM_DD.xlsx` file
-2. The report is parsed server-side and a **diff preview** is shown — new violations, resolved items, and recurring items since the last upload
-3. Click **Confirm Upload** to commit. The upload is recorded and the device table updates immediately.
-
-The report date is extracted automatically from the filename.
-
-#### Metric Health Cards
-
-Each AEO metric (e.g., `2.3.4i`, `5.2.4`) is shown as a health card displaying:
-- Compliance percentage vs target
-- Status: Meets/Exceeds Target · Within 15% of Target · Below 15% of Target
-
-Click a card to filter the device table to only devices failing that metric.
-
-#### Device Table
-
-Shows all devices currently failing one or more metrics (Active tab) or previously resolved (Resolved tab). Columns: Hostname, IP Address, Type, Failing Metrics, Times Seen. Click a row to open the detail panel.
-
-#### Detail Panel
-
-A slide-out panel for a selected device showing:
-- **Failing Metrics** — each metric with surfaced extra fields (CVEs, SLA status, due date, OS, EoL, Splunk last seen, MFA software)
-- For **2.3.x vulnerability metrics**: the `Ivanti_Vulnerability_ID` is displayed with a **View in Reporting →** button that navigates directly to the Reporting page
-- **Resolved Metrics** — previously failing metrics now back in compliance
-- **History** — how many times the device has appeared on the report and since when
-- **Notes** — timestamped notes per metric with a multi-metric selector if multiple metrics are failing
-
-Notes persist across uploads and are keyed to the device hostname and metric ID.
-
-#### Teams
-
-Only **STEAM** and **ACCESS-ENG** teams are tracked. The team selector at the top of the page switches context between them.
-
----
-
-### Knowledge Base
-
-A document library for internal reference material — policies, runbooks, vendor advisories, and process guides.
-
-- Upload documents with a title, optional description, and category
-- View documents inline in the browser (PDFs render in an iframe; Markdown files render as HTML)
-- Download any document
-- Filter and browse by category
-- Editors and admins can upload and delete; all authenticated users can view
-
-Allowed file types: PDF, Markdown, TXT, Office documents (DOC, DOCX, XLS, XLSX, PPT, PPTX), HTML, JSON, YAML, and images (PNG, JPG, GIF).
-
----
-
-### Exports
-
-Bulk export tools for reports and data extracts.
-
----
-
-### Archer Risk Acceptance Tickets
-
-Track Archer exception tickets (EXC numbers) linked to specific CVE/vendor pairs.
-
-- EXC number format: `EXC-NNNNN`
-- Statuses: `Draft`, `Open`, `Under Review`, `Accepted`
-- Optional Archer URL field for deep-linking to the Archer record
-- Filter tickets by CVE ID, vendor, or status
-- Clicking an EXC badge on the Home page navigates to the Reporting page pre-filtered to findings with that EXC number in their notes
-
----
-
-### User Management (Admin)
-
-- Create users with a role assignment
-- Change username, email, password, role, or active status
-- Deactivating a user immediately invalidates all their active sessions
-- Admins cannot demote themselves or deactivate their own account
-
----
-
-### Audit Log (Admin)
-
-Every state-changing action is recorded with the user identity, IP address, action type, target entity, and a before/after payload. Admins can view the log filtered by user, action type, entity type, and date range. Results are paginated (25 per page).
-
----
-
-## Scripts
-
-### `backend/scripts/parse_compliance_xlsx.py`
-
-Called automatically by the compliance upload flow. Parses the NTS_AEO xlsx report and outputs structured JSON to stdout for consumption by the Node compliance route.
-
-- Reads all detail sheets; skips `Summary` and `CMDB_9box`
-- Filters to rows where `Compliant == False`
-- Extracts hostname, IP, device type, team, and metric ID per row
-- Captures all non-core columns in `extra_json` (CVEs, SLA status, OS, EoL, Splunk, MFA, Ivanti_Vulnerability_ID, etc.)
-- Parses `Summary` sheet for per-team metric health (compliance_pct, target, status)
-- Extracts report date from the filename (`NTS_AEO_YYYY_MM_DD.xlsx`)
-
-**Dependencies:** `pandas>=2.0.0`, `openpyxl>=3.0.0`
-
----
-
-### `backend/scripts/import_notes_from_csv.py`
-
-Bulk-import notes into the findings cache from a CSV file. Useful for onboarding existing notes or migrating from a spreadsheet.
-
-**CSV format:**
-```csv
-ID,NOTES
-12345678,EXC-5754
-87654321,Patched in Feb maintenance window
-```
-
-**Usage:**
-```bash
-cd backend/scripts
-
-# Preview what would be imported (no writes)
-python3 import_notes_from_csv.py input.csv --dry-run
-
-# Import against the default database path
-python3 import_notes_from_csv.py input.csv
-
-# Import against a specific database
-python3 import_notes_from_csv.py input.csv --db /path/to/cve_database.db
-```
-
-| Argument | Description |
-|---|---|
-| `csv_file` | Path to the input CSV (required) |
-| `--db` | Path to the SQLite database (default: `../cve_database.db`) |
-| `--dry-run` | Preview changes without writing to the database |
-
-- Notes longer than 255 characters are truncated with a warning
-- Finding IDs not present in the active Ivanti cache are skipped
-- Uses UPSERT — running the same CSV twice is safe
-
-**Dependencies:** Python stdlib only (no pip install required).
-
----
-
-## API Reference
-
-All endpoints are prefixed with `/api`. All endpoints except `/api/auth/login` and `/api/auth/logout` require a valid session cookie.
-
-### Auth
-
-| Method | Path | Auth | Description |
-|---|---|---|---|
-| POST | `/api/auth/login` | Public | Log in, receive session cookie |
-| POST | `/api/auth/logout` | Public | Invalidate session |
-| GET | `/api/auth/me` | Session | Get current user info |
-| POST | `/api/auth/cleanup-sessions` | Session | Delete expired sessions |
-
-### CVEs
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| GET | `/api/cves` | viewer+ | List CVEs; query params: `search`, `vendor`, `severity`, `status` |
-| POST | `/api/cves` | editor+ | Create a new CVE entry |
-| PUT | `/api/cves/:id` | editor+ | Update a CVE entry by row ID |
-| PATCH | `/api/cves/:cveId/status` | editor+ | Update status for all vendor rows matching a CVE ID |
-| DELETE | `/api/cves/:id` | editor+ | Delete a single CVE vendor entry |
-| DELETE | `/api/cves/by-cve-id/:cveId` | editor+ | Delete all vendor entries for a CVE ID |
-| GET | `/api/cves/check/:cveId` | viewer+ | Quick check: existence and status of a CVE |
-| GET | `/api/cves/distinct-ids` | viewer+ | All distinct CVE IDs (used by NVD sync) |
-| GET | `/api/cves/:cveId/vendors` | viewer+ | All vendor entries for a specific CVE ID |
-
-### Documents
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| GET | `/api/cves/:cveId/documents` | viewer+ | List documents for a CVE; optional `?vendor=` filter |
-| POST | `/api/cves/:cveId/documents` | editor+ | Upload a document for a CVE/vendor pair |
-| DELETE | `/api/documents/:id` | admin | Delete a document and its file from disk |
-
-### NVD
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| GET | `/api/nvd/lookup/:cveId` | viewer+ | Look up a single CVE in the NVD 2.0 API |
-| POST | `/api/cves/nvd-sync` | editor+ | Bulk update CVE metadata from NVD |
-
-### Ivanti — Host Findings
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| GET | `/api/ivanti/findings` | viewer+ | Get cached findings with notes and overrides merged in |
-| POST | `/api/ivanti/findings/sync` | viewer+ | Trigger an immediate findings sync from Ivanti |
-| GET | `/api/ivanti/findings/counts` | viewer+ | Open vs closed finding totals |
-| GET | `/api/ivanti/findings/fp-workflow-counts` | viewer+ | FP workflow state breakdown |
-| PUT | `/api/ivanti/findings/:findingId/override` | editor+ | Override `hostName` or `dns`; empty value clears the override |
-| PUT | `/api/ivanti/findings/:findingId/note` | viewer+ | Save or update a finding note (max 255 chars) |
-
-### Ivanti — Workflows
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| GET | `/api/ivanti/workflows` | viewer+ | Get cached workflow data |
-| POST | `/api/ivanti/workflows/sync` | viewer+ | Trigger an immediate workflow sync |
-
-### Ivanti Queue
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| GET | `/api/ivanti/queue` | viewer+ | Get all queue items for the current user |
-| POST | `/api/ivanti/queue` | editor+ | Add a finding to the queue |
-| PATCH | `/api/ivanti/queue/:id` | editor+ | Update a queue item (mark complete, edit vendor/type) |
-| DELETE | `/api/ivanti/queue/:id` | editor+ | Delete a single queue item |
-| DELETE | `/api/ivanti/queue` | editor+ | Delete multiple queue items (body: `{ ids: [...] }`) |
-
-### Compliance
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| POST | `/api/compliance/preview` | editor+ | Parse an xlsx upload and return diff + temp file path |
-| POST | `/api/compliance/commit` | editor+ | Commit a previewed upload to the database |
-| GET | `/api/compliance/uploads` | viewer+ | List all compliance upload records |
-| GET | `/api/compliance/summary` | viewer+ | Metric health summary; `?team=STEAM` |
-| GET | `/api/compliance/items` | viewer+ | Device list; `?team=STEAM&status=active` |
-| GET | `/api/compliance/items/:hostname` | viewer+ | Full detail for a device (metrics + notes) |
-| GET | `/api/compliance/notes/:hostname/:metricId` | viewer+ | Notes for a specific hostname/metric |
-| POST | `/api/compliance/notes` | editor+ | Add a note for a hostname/metric |
-
-### Knowledge Base
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| POST | `/api/knowledge-base/upload` | editor+ | Upload a new knowledge base document |
-| GET | `/api/knowledge-base` | viewer+ | List all articles |
-| GET | `/api/knowledge-base/:id` | viewer+ | Get article metadata |
-| GET | `/api/knowledge-base/:id/content` | viewer+ | Get file content for inline display |
-| GET | `/api/knowledge-base/:id/download` | viewer+ | Download the file |
-| DELETE | `/api/knowledge-base/:id` | editor+ | Delete article and file |
-
-### Archer Tickets
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| GET | `/api/archer-tickets` | viewer+ | List tickets; optional filters: `cve_id`, `vendor`, `status` |
-| POST | `/api/archer-tickets` | editor+ | Create a new Archer ticket |
-| PUT | `/api/archer-tickets/:id` | editor+ | Update an Archer ticket |
-| DELETE | `/api/archer-tickets/:id` | editor+ | Delete an Archer ticket |
-
-### Users (Admin only)
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| GET | `/api/users` | admin | List all users |
-| GET | `/api/users/:id` | admin | Get a single user |
-| POST | `/api/users` | admin | Create a user |
-| PATCH | `/api/users/:id` | admin | Update a user |
-| DELETE | `/api/users/:id` | admin | Delete a user |
-
-### Audit Logs (Admin only)
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| GET | `/api/audit-logs` | admin | Paginated audit log; filters: `user`, `action`, `entityType`, `startDate`, `endDate` |
-| GET | `/api/audit-logs/actions` | admin | List distinct action types for filter dropdowns |
-
-### Utility
-
-| Method | Path | Role | Description |
-|---|---|---|---|
-| GET | `/api/vendors` | viewer+ | List all distinct vendor names |
-| GET | `/api/stats` | viewer+ | Dashboard statistics |
-
----
-
-## Architecture
+| Feature | Description |
+|---------|-------------|
+| **CVE Management** | Track CVEs across multiple vendors with document storage and NVD auto-fill |
+| **Reporting** | Ivanti host finding triage with donut charts, inline editing, advanced filtering, CSV/XLSX export |
+| **Ivanti Queue** | Personal staging list for batch FP, Archer, CARD, and Granite workflows |
+| **FP Workflow** | Submit false positive workflows directly to Ivanti API with attachments |
+| **Compliance** | Weekly AEO xlsx upload with diff preview, drift detection, per-team metric health cards |
+| **Archive Tracking** | Automatic detection of disappeared/returned findings with BU reassignment classification |
+| **Findings Trend** | Historical open vs closed chart with archive activity sparkline and shift reason tooltips |
+| **Jira Integration** | Create, sync, and track Jira Data Center tickets linked to CVE/vendor pairs |
+| **Archer Tickets** | Track risk acceptance exceptions (EXC numbers) linked to findings |
+| **CARD API** | Granite/CARD asset lookup integration for network device workflows |
+| **Knowledge Base** | Internal document library with inline PDF/Markdown viewing |
+| **Access Control** | Four user groups (Admin, Standard_User, Leadership, Read_Only) with full audit trail |
+
+## Project Structure
 
 ```
 cve-dashboard/
-├── start-servers.sh          # Start backend + frontend in background
-├── stop-servers.sh           # Stop all servers
-│
 ├── backend/
-│   ├── server.js             # Express app — routes, middleware, security headers
-│   ├── setup.js              # One-time DB initialization and default admin creation
-│   ├── cve_database.db       # SQLite database (gitignored)
-│   ├── uploads/              # File storage root (gitignored)
-│   │   ├── <CVE-ID>/<vendor>/    # CVE documents
-│   │   ├── knowledge_base/       # Knowledge base documents
-│   │   └── temp/                 # Temporary upload staging
-│   ├── routes/
-│   │   ├── auth.js               # Login, logout, session check
-│   │   ├── users.js              # User CRUD (admin)
-│   │   ├── auditLog.js           # Audit log viewer (admin)
-│   │   ├── nvdLookup.js          # NVD API proxy
-│   │   ├── knowledgeBase.js      # Knowledge base document management
-│   │   ├── archerTickets.js      # Archer EXC ticket CRUD
-│   │   ├── ivantiWorkflows.js    # Ivanti workflow batch sync and cache
-│   │   ├── ivantiFindings.js     # Ivanti host findings sync, notes, overrides, FP counts
-│   │   ├── ivantiTodoQueue.js    # Ivanti Queue — personal FP/Archer/CARD staging list
-│   │   └── compliance.js         # AEO compliance upload, diff, device tracking, notes
-│   ├── middleware/
-│   │   └── auth.js               # requireAuth and requireRole middleware
-│   ├── helpers/
-│   │   ├── auditLog.js           # logAudit helper (fire-and-forget)
-│   ├── migrations/
-│   │   ├── add_knowledge_base_table.js
-│   │   ├── add_archer_tickets_table.js
-│   │   ├── add_ivanti_sync_table.js
-│   │   ├── add_ivanti_findings_tables.js
-│   │   ├── add_ivanti_todo_queue_table.js  # Ivanti Queue table
-│   │   ├── add_card_workflow_type.js       # CARD workflow type support
-│   │   ├── add_todo_queue_ip_address.js    # IP address column on queue items
-│   │   └── add_compliance_tables.js        # AEO compliance tables
-│   └── scripts/
-│       ├── parse_compliance_xlsx.py      # Parses NTS_AEO xlsx compliance reports
-│       ├── import_notes_from_csv.py      # Bulk-import finding notes from CSV
-│       └── requirements.txt              # pandas, openpyxl
-│
-└── frontend/
-    └── src/
-        ├── App.js                    # Home dashboard — CVE list, filters, modals, calendar
-        ├── App.css                   # Global styles and CSS variables
-        ├── contexts/
-        │   └── AuthContext.js        # Auth state provider (login, logout, role helpers)
-        └── components/
-            ├── LoginForm.js              # Login page
-            ├── NavDrawer.js              # Side navigation drawer
-            ├── UserMenu.js               # User dropdown in header
-            ├── CalendarWidget.js         # Due-date calendar with Ivanti finding indicators
-            ├── UserManagement.js         # Admin user management panel
-            ├── AuditLog.js               # Admin audit log viewer
-            ├── NvdSyncModal.js           # Bulk NVD sync dialog
-            ├── KnowledgeBaseModal.js     # Knowledge base upload/list modal
-            ├── KnowledgeBaseViewer.js    # Inline document viewer
-            └── pages/
-                ├── ReportingPage.js          # Host findings: charts, table, queue, export
-                ├── CompliancePage.js         # AEO compliance: metric cards, device table
-                ├── ComplianceUploadModal.js  # xlsx upload with diff preview
-                ├── ComplianceDetailPanel.js  # Per-device metrics, history, notes
-                ├── KnowledgeBasePage.js      # Knowledge base page
-                └── ExportsPage.js            # Exports page
+│   ├── server.js              # Express API server
+│   ├── db.js                  # PostgreSQL connection pool (pg)
+│   ├── db-schema.sql          # Complete DDL for fresh Postgres setup
+│   ├── setup-postgres.js      # Schema initializer (runs db-schema.sql)
+│   ├── routes/                # API route handlers
+│   ├── helpers/               # API clients (Ivanti, Jira, Atlas, CARD)
+│   ├── middleware/            # Auth middleware
+│   ├── migrations/            # Schema migrations (legacy SQLite deployments)
+│   └── scripts/               # Compliance parser, data import utilities
+├── frontend/
+│   ├── src/
+│   │   ├── App.js             # Main app with routing
+│   │   ├── components/        # React components
+│   │   └── contexts/          # Auth context
+│   └── public/
+├── docs/
+│   ├── api/                   # API specs (Ivanti, Atlas, Jira)
+│   ├── design/                # Design system, workflow diagrams
+│   ├── guides/                # User guides, full reference manual
+│   ├── security/              # Security audits and remediation plans
+│   ├── testing/               # Test plans and scripts
+│   └── troubleshooting/       # Investigation scripts and reports
+├── docker-compose.yml         # PostgreSQL 16 container definition
+├── scripts/
+│   └── deploy-postgres.sh     # One-time deployment: container, schema, migration
+├── systemd/                   # systemd service files
+├── start-servers.sh
+└── stop-servers.sh
 ```
 
----
+## Tech Stack
 
-## Database Schema
+| Layer | Technology |
+|-------|------------|
+| Backend | Node.js 18+, Express 5 |
+| Database | PostgreSQL 16 (Docker, port 5433) |
+| Frontend | React 19, Recharts, Lucide React |
+| Auth | bcryptjs, cookie-based sessions, express-rate-limit |
+| Compliance | Python 3, pandas, openpyxl |
 
-### Core tables (created by `setup.js`)
+## Documentation
 
-**`cves`** — One row per CVE/vendor pair. `UNIQUE(cve_id, vendor)`.
+- **[Full Reference Manual](docs/guides/full-reference-manual.md)** — comprehensive feature documentation, API reference, database schema, security model, and configuration details
+- **[Postgres Migration Plan](docs/guides/postgres-migration-plan.md)** — architecture decisions, schema design, and cutover procedure for the SQLite to PostgreSQL migration
+- **[Migration Guide](backend/migrations/README.md)** — schema migration scripts for upgrading existing deployments
+- **[Design System](docs/design/design-system.md)** — UI component patterns and color system
+- **[Ivanti API Reference](docs/api/ivanti-api-reference.md)** — Ivanti/RiskSense API integration details
+- **[Jira API Use Cases](docs/api/jira-api-use-cases.md)** — Jira Data Center API compliance summary
 
-**`documents`** — Files attached to a CVE/vendor pair. Foreign key to `cves(cve_id)`.
+## License
 
-**`required_documents`** — Vendor-specific document requirements.
-
-**`users`** — Accounts with roles: `admin`, `editor`, `viewer`.
-
-**`sessions`** — Active sessions with 24-hour expiry.
-
-**`audit_logs`** — Append-only log of all state-changing actions.
-
-### Feature tables (added by migrations)
-
-**`knowledge_base`** — Document library entries with title, slug, category, description, and file metadata.
-
-**`archer_tickets`** — Archer EXC exception tickets linked to CVE/vendor pairs. `UNIQUE(exc_number)`.
-
-**`ivanti_sync_state`** — Single-row cache for Ivanti workflow batch data.
-
-**`ivanti_findings_cache`** — Single-row cache for Ivanti host findings.
-
-**`ivanti_finding_notes`** — Persistent per-finding notes keyed by finding ID. Survives cache refreshes. `UNIQUE(finding_id)`.
-
-**`ivanti_counts_cache`** — Single-row cache for finding metrics: open/closed counts, FP workflow state breakdowns by finding and by unique ticket ID.
-
-**`ivanti_finding_overrides`** — Editor-applied overrides for `hostName` and `dns` fields. `UNIQUE(finding_id, field)`.
-
-**`ivanti_todo_queue`** — Personal per-user queue of findings staged for FP, Archer, or CARD processing. Keyed by `(user_id, finding_id)`.
-
-**`compliance_uploads`** — Record of each compliance xlsx upload: filename, report date, uploader, timestamp, and new/resolved/recurring counts.
-
-**`compliance_items`** — One row per device/metric violation. Tracks hostname, IP, device type, team, metric ID, category, `extra_json` (all non-core xlsx columns), status (active/resolved), first seen upload, and times seen. Identity key: `(hostname, metric_id)`.
-
-**`compliance_notes`** — Timestamped notes per hostname/metric. Multiple notes per combination are supported. Foreign-key linked to compliance items.
-
-### View
-
-**`cve_document_status`** — Aggregates document counts per CVE/vendor and derives a `compliance_status` (`Complete` when an advisory is present, otherwise `Missing Required Docs`).
+Internal use only — Charter Communications / NTS-AEO.
 
 ---
 
-## Security Model
-
-### File upload security
-
-- Extension allowlist enforced by Multer; executables (`.exe`, `.js`, `.sh`, `.py`, `.bat`, etc.) are blocked
-- MIME type prefix validation in addition to extension checking
-- 10 MB per-file size limit
-- Filenames are sanitized: path separators, `..` sequences, null bytes, and non-alphanumeric characters are removed
-
-### Path traversal prevention
-
-- `sanitizePathSegment()` strips `/`, `\`, `..`, and null bytes from any value used in `path.join()`
-- `isPathWithinUploads()` verifies resolved paths stay within the uploads root before any file operation
-
-### Input validation
-
-- CVE ID must match `/^CVE-\d{4}-\d{4,}$/`
-- Severity must be one of: `Critical`, `High`, `Medium`, `Low`
-- Status must be one of: `Open`, `Addressed`, `In Progress`, `Resolved`
-- Archer EXC numbers must match `/^EXC-\d+$/`
-- Finding override field must be one of: `hostName`, `dns`
-- All database operations use prepared statements — no string interpolation in SQL
-
-### Error handling
-
-- 500 responses never expose internal error messages to the client
-- Full errors are logged server-side only
-- Descriptive 400/409 responses contain only application-authored validation messages
-
-### Security headers
-
-Applied to all responses:
-
-- `X-Content-Type-Options: nosniff`
-- `X-Frame-Options: SAMEORIGIN`
-- `X-XSS-Protection: 1; mode=block`
-- `Referrer-Policy: strict-origin-when-cross-origin`
-- `Permissions-Policy: camera=(), microphone=(), geolocation=()`
-
-### Session cookies
-
-`httpOnly: true`, `sameSite: lax`, `secure: true` in production (`NODE_ENV=production`).
-
----
-
-## Migrations
-
-Migrations are standalone Node.js scripts. Run them in the listed order on a fresh install. All use `CREATE TABLE IF NOT EXISTS` or `ALTER TABLE ... ADD COLUMN IF NOT EXISTS` and are safe to re-run.
-
-```bash
-cd backend
-node migrations/add_knowledge_base_table.js
-node migrations/add_archer_tickets_table.js
-node migrations/add_ivanti_sync_table.js
-node migrations/add_ivanti_findings_tables.js
-node migrations/add_ivanti_todo_queue_table.js
-node migrations/add_card_workflow_type.js
-node migrations/add_todo_queue_ip_address.js
-node migrations/add_compliance_tables.js
-```
-
-For deployments upgrading from an older schema, the following legacy migration scripts are also available in `backend/`:
-
-- `migrate_multivendor.js` — Adds multi-vendor support to an older single-vendor schema
-- `migrate-audit-log.js` — Adds the `audit_logs` table to pre-auth deployments
-- `migrate-to-1.1.js` — General 1.0 → 1.1 schema update
-
-> Several columns (`fp_workflow_counts_json`, `fp_id_counts_json`, `seen_count`, `summary_json`) are added automatically via idempotent `ALTER TABLE` statements each time the server starts. No manual re-run is needed.
+*Designed and built by Jordan Ramos (jordan.ramos@spectrum.com)*

backend/.env.example

@@ -3,6 +3,10 @@ PORT=3001
 API_HOST=localhost
 CORS_ORIGINS=http://localhost:3000
 
+# Session secret — REQUIRED. Server will not start without this.
+# Generate with: openssl rand -base64 32
+SESSION_SECRET=
+
 # NVD API Key (optional - increases rate limit from 5 to 50 requests per 30s)
 # Request one at https://nvd.nist.gov/developers/request-an-api-key
 NVD_API_KEY=
@@ -13,5 +17,56 @@ IVANTI_API_KEY=
 IVANTI_CLIENT_ID=1550
 IVANTI_FIRST_NAME=
 IVANTI_LAST_NAME=
+# Comma-separated list of BU values to sync from Ivanti.
+# Broadening this pulls findings for additional BUs into the local cache.
+# Users see only their assigned teams' findings (filtered at query time).
+# Default if unset: NTS-AEO-ACCESS-ENG,NTS-AEO-STEAM
+IVANTI_BU_FILTER=NTS-AEO-ACCESS-ENG,NTS-AEO-STEAM
 # Set to true if behind Charter's SSL inspection proxy (replicates Python verify=False)
 IVANTI_SKIP_TLS=false
+
+# Atlas InfoSec API (atlas-infosec.caas.charterlab.com)
+# Service account credentials for Basic Auth — used to sync and manage action plans
+ATLAS_API_URL=
+ATLAS_API_USER=
+ATLAS_API_PASS=
+# Set to true if behind Charter's SSL inspection proxy (disables TLS cert verification)
+ATLAS_SKIP_TLS=false
+
+# Jira Data Center REST API
+# VPN or Charter Network connection required for all Jira instances.
+# Service accounts use Basic Auth (JIRA_API_USER + JIRA_API_TOKEN).
+# PATs require ATLSUP approval and naming convention: Function - Team - ATLSUP-XXXXX
+# Rate limits: 1440 requests/day, burst of 60/minute.
+JIRA_BASE_URL=
+JIRA_AUTH_METHOD=basic
+# Basic Auth — service account credentials
+JIRA_API_USER=
+JIRA_API_TOKEN=
+# PAT Auth — set JIRA_AUTH_METHOD=pat to use
+JIRA_PAT=
+# Default project key and issue type for creating issues from the dashboard
+JIRA_PROJECT_KEY=
+JIRA_ISSUE_TYPE=Task
+# Set to true if behind Charter's SSL inspection proxy
+JIRA_SKIP_TLS=false
+
+# CARD Asset Ownership API (card.charter.com / card.caas.stage.charterlab.com)
+# OAuth Bearer token auth — service account must be onboarded with the CARD team.
+# Tokens are acquired automatically via Basic Auth and cached for 1 hour.
+CARD_API_URL=
+CARD_API_USER=
+CARD_API_PASS=
+# Set to true if behind Charter's SSL inspection proxy
+CARD_SKIP_TLS=false
+
+# PostgreSQL Database (Docker container steam-postgres)
+# If set, the backend uses Postgres instead of SQLite.
+# Format: postgresql://user:password@host:port/database
+DATABASE_URL=postgresql://steam:<password>@localhost:5433/cve_dashboard
+
+# GitLab Feedback Integration (bug reports and feature requests from the dashboard)
+# PAT needs 'api' scope. Project ID is the numeric ID from GitLab project settings.
+GITLAB_URL=http://steam-gitlab.charterlab.com
+GITLAB_PROJECT_ID=
+GITLAB_PAT=

backend/__tests__/auth-password-change.property.test.js

@@ -0,0 +1,48 @@
+/**
+ * Property-Based Test: Password Change Round-Trip
+ *
+ * Feature: user-profile, Property 3: Password change round-trip
+ *
+ * For any valid current password and any new password of 8+ characters,
+ * after a successful change, bcrypt.compare(newPassword, storedHash) returns true.
+ *
+ * Validates: Requirements 2.2, 2.7
+ */
+
+const fc = require('fast-check');
+const bcrypt = require('bcryptjs');
+
+// bcrypt cost factor — production uses 10, but we use 4 (the minimum) here
+// to keep 100 iterations feasible within test timeouts. The round-trip property
+// holds regardless of cost factor.
+const BCRYPT_COST = 4;
+
+describe('Feature: user-profile, Property 3: Password change round-trip', () => {
+  it('after a password change, bcrypt.compare(newPassword, newHash) returns true', async () => {
+    await fc.assert(
+      fc.asyncProperty(
+        // Current password: any non-empty string (length >= 1)
+        fc.string({ minLength: 1, maxLength: 72 }),
+        // New password: any string of length >= 8 (bcrypt max input is 72 bytes)
+        fc.string({ minLength: 8, maxLength: 72 }),
+        async (currentPassword, newPassword) => {
+          // Step 1: Hash the current password (simulates existing stored hash)
+          const currentHash = await bcrypt.hash(currentPassword, BCRYPT_COST);
+
+          // Step 2: Verify the current password against the stored hash
+          // (simulates the bcrypt.compare check in the change-password route)
+          const currentPasswordValid = await bcrypt.compare(currentPassword, currentHash);
+          expect(currentPasswordValid).toBe(true);
+
+          // Step 3: Hash the new password (simulates bcrypt.hash(newPassword, 10) in the route)
+          const newHash = await bcrypt.hash(newPassword, BCRYPT_COST);
+
+          // Step 4: Verify the new password matches the new hash (round-trip property)
+          const newPasswordValid = await bcrypt.compare(newPassword, newHash);
+          expect(newPasswordValid).toBe(true);
+        }
+      ),
+      { numRuns: 100 }
+    );
+  }, 120000); // 2-minute timeout for 100 bcrypt iterations
+});

backend/__tests__/auth-profile-completeness.property.test.js

@@ -0,0 +1,84 @@
+/**
+ * Property-Based Test: Profile API Returns Complete User Data Matching Database
+ *
+ * Feature: user-profile, Property 2: Profile API returns complete user data matching database
+ *
+ * For any active user record, the profile route's mapping logic produces a
+ * response object with all 6 required fields (id, username, email, group,
+ * created_at, last_login) and each value matches the corresponding column
+ * in the users table. The `group` field maps from the `user_group` column.
+ *
+ * Validates: Requirements 4.1
+ */
+
+const fc = require('fast-check');
+
+/**
+ * Simulates the exact mapping logic from GET /api/auth/profile in routes/auth.js:
+ *
+ *   res.json({
+ *       id: user.id,
+ *       username: user.username,
+ *       email: user.email,
+ *       group: user.user_group,
+ *       created_at: user.created_at,
+ *       last_login: user.last_login
+ *   });
+ */
+function mapUserRowToProfileResponse(user) {
+  return {
+    id: user.id,
+    username: user.username,
+    email: user.email,
+    group: user.user_group,
+    created_at: user.created_at,
+    last_login: user.last_login
+  };
+}
+
+describe('Feature: user-profile, Property 2: Profile API returns complete user data matching database', () => {
+  it('profile response contains all 6 required fields matching the database row', () => {
+    fc.assert(
+      fc.property(
+        // Generate arbitrary user rows matching the users table schema
+        fc.record({
+          id: fc.integer({ min: 1, max: 1000000 }),
+          username: fc.string({ minLength: 1, maxLength: 50 }),
+          email: fc.string({ minLength: 3, maxLength: 255 }),
+          user_group: fc.constantFrom('Admin', 'Standard_User', 'Read_Only'),
+          created_at: fc.integer({ min: 1577836800000, max: 1924991999000 })
+            .map(ts => new Date(ts).toISOString().replace('T', ' ').slice(0, 19)),
+          last_login: fc.oneof(
+            fc.integer({ min: 1577836800000, max: 1924991999000 })
+              .map(ts => new Date(ts).toISOString().replace('T', ' ').slice(0, 19)),
+            fc.constant(null)
+          ),
+          is_active: fc.constant(1)
+        }),
+        (userRow) => {
+          const response = mapUserRowToProfileResponse(userRow);
+
+          // Assert all 6 required fields are present
+          expect(response).toHaveProperty('id');
+          expect(response).toHaveProperty('username');
+          expect(response).toHaveProperty('email');
+          expect(response).toHaveProperty('group');
+          expect(response).toHaveProperty('created_at');
+          expect(response).toHaveProperty('last_login');
+
+          // Assert each value matches the corresponding database column
+          expect(response.id).toBe(userRow.id);
+          expect(response.username).toBe(userRow.username);
+          expect(response.email).toBe(userRow.email);
+          expect(response.group).toBe(userRow.user_group); // group maps from user_group
+          expect(response.created_at).toBe(userRow.created_at);
+          expect(response.last_login).toBe(userRow.last_login);
+
+          // Assert exactly 6 keys — no extra fields leaked
+          expect(Object.keys(response)).toHaveLength(6);
+        }
+      ),
+      { numRuns: 100 }
+    );
+  });
+});

backend/__tests__/auth-short-password.property.test.js

@@ -0,0 +1,39 @@
+/**
+ * Property-Based Test: Short Passwords Are Rejected (Server-Side)
+ *
+ * Feature: user-profile, Property 6 (server-side): Short passwords are rejected
+ *
+ * For any string of length 0 to 7, the server-side validation logic
+ * (newPassword.length < 8) correctly identifies them as too short,
+ * meaning the password change would return 400 and the stored hash
+ * would remain unchanged.
+ *
+ * Validates: Requirements 2.5, 5.4
+ */
+
+const fc = require('fast-check');
+
+describe('Feature: user-profile, Property 6 (server-side): Short passwords are rejected', () => {
+  it('any string of length 0–7 is rejected by the server-side length validation', () => {
+    fc.assert(
+      fc.property(
+        // Generate arbitrary strings of length 0 to 7
+        fc.string({ minLength: 0, maxLength: 7 }),
+        (shortPassword) => {
+          // This is the exact validation check from POST /api/auth/change-password:
+          //   if (newPassword.length < 8) return res.status(400).json({ error: '...' })
+          const wouldBeRejected = shortPassword.length < 8;
+
+          // Every generated string must be rejected by the validation
+          expect(wouldBeRejected).toBe(true);
+
+          // The stored hash remains unchanged because the route returns
+          // early before reaching the bcrypt.hash / UPDATE query.
+          // This is a structural guarantee — the early return prevents
+          // any mutation of the password_hash column.
+        }
+      ),
+      { numRuns: 100 }
+    );
+  });
+});

backend/__tests__/auth-wrong-password.property.test.js

@@ -0,0 +1,53 @@
+/**
+ * Property-Based Test: Incorrect Current Password Is Always Rejected
+ *
+ * Feature: user-profile, Property 4: Incorrect current password is always rejected
+ *
+ * For any password string that does not match the user's current password,
+ * the endpoint returns 401 and the stored hash remains unchanged.
+ *
+ * Validates: Requirements 2.3
+ */
+
+const fc = require('fast-check');
+const bcrypt = require('bcryptjs');
+
+// bcrypt cost factor — production uses 10, but we use 4 (the minimum) here
+// to keep 100 iterations feasible within test timeouts. The rejection property
+// holds regardless of cost factor.
+const BCRYPT_COST = 4;
+
+describe('Feature: user-profile, Property 4: Incorrect current password is always rejected', () => {
+  it('bcrypt.compare rejects any wrong password and the stored hash remains unchanged', async () => {
+    await fc.assert(
+      fc.asyncProperty(
+        // Current password: any non-empty string (bcrypt max input is 72 bytes)
+        fc.string({ minLength: 1, maxLength: 72 }),
+        // Wrong password: any non-empty string (will be filtered to differ from current)
+        fc.string({ minLength: 1, maxLength: 72 }),
+        async (currentPassword, wrongPassword) => {
+          // Ensure the wrong password is always different from the current password
+          fc.pre(wrongPassword !== currentPassword);
+
+          // Step 1: Hash the current password (simulates existing stored hash)
+          const currentHash = await bcrypt.hash(currentPassword, BCRYPT_COST);
+
+          // Capture the hash before the failed attempt
+          const hashBefore = currentHash;
+
+          // Step 2: Attempt to verify the wrong password against the stored hash
+          // (simulates the bcrypt.compare check in the change-password route)
+          const isValid = await bcrypt.compare(wrongPassword, currentHash);
+
+          // The wrong password must always be rejected
+          expect(isValid).toBe(false);
+
+          // Step 3: The stored hash remains unchanged after the failed attempt
+          // (no mutation should occur on rejection)
+          expect(currentHash).toBe(hashBefore);
+        }
+      ),
+      { numRuns: 100 }
+    );
+  }, 120000); // 2-minute timeout for 100 bcrypt iterations
+});

backend/__tests__/jira-jql-window-invariant.property.test.js

@@ -0,0 +1,108 @@
+/**
+ * Property-Based Test: JQL Window Invariant
+ *
+ * Feature: jira-api-compliance-cleanup, Property 1: JQL window is always 72 hours in bulk sync
+ *
+ * For any non-empty array of valid-looking issue keys passed to searchIssuesByKeys(),
+ * the generated JQL string SHALL contain the substring `updated >= -72h` and
+ * SHALL contain the substring `project =`.
+ *
+ * Validates: Requirements 2.1, 2.3
+ */
+
+const fc = require('fast-check');
+
+// Capture the JQL that flows through the HTTP layer.
+let capturedJql = null;
+
+// Mock https to intercept the request URL (which contains the JQL) and return
+// a fake 200 response. This prevents real network calls while letting the
+// real searchIssuesByKeys → searchIssues → jiraGet → jiraRequest chain execute.
+jest.mock('https', () => ({
+  request: jest.fn((options, callback) => {
+    const fullPath = options.path || '';
+    const jqlMatch = fullPath.match(/[?&]jql=([^&]*)/);
+    if (jqlMatch) {
+      capturedJql = decodeURIComponent(jqlMatch[1]);
+    }
+
+    const mockResponse = {
+      statusCode: 200,
+      on: jest.fn((event, handler) => {
+        if (event === 'data') {
+          handler(JSON.stringify({ total: 0, issues: [] }));
+        }
+        if (event === 'end') {
+          handler();
+        }
+      }),
+    };
+    // Use setImmediate so the callback fires on the same tick after promises
+    // resolve, but still asynchronously as Node's http expects.
+    setImmediate(() => callback(mockResponse));
+
+    return {
+      on: jest.fn(),
+      write: jest.fn(),
+      end: jest.fn(),
+      destroy: jest.fn(),
+    };
+  }),
+}));
+
+// Set required env vars before requiring the module so the module-level
+// constants pick them up.
+process.env.JIRA_PROJECT_KEY = 'TESTPROJ';
+process.env.JIRA_BASE_URL = 'https://jira.example.com';
+process.env.JIRA_API_USER = 'testuser';
+process.env.JIRA_API_TOKEN = 'testtoken';
+
+const jiraApi = require('../helpers/jiraApi');
+
+describe('Feature: jira-api-compliance-cleanup, Property 1: JQL window is always 72h in bulk sync', () => {
+  // Use fake timers so the rate-limiter's inter-request delays (1–2 seconds)
+  // resolve instantly. We preserve setImmediate so the https mock callback
+  // still fires asynchronously as expected.
+  beforeAll(() => {
+    jest.useFakeTimers({ doNotFake: ['setImmediate', 'nextTick'] });
+  });
+
+  afterAll(() => {
+    jest.useRealTimers();
+  });
+
+  beforeEach(() => {
+    capturedJql = null;
+  });
+
+  // Generator: produces a valid Jira issue key like "AB-1", "PROJ-42", etc.
+  const issueKeyArb = fc.tuple(
+    fc.stringMatching(/^[A-Z]{2,10}$/),
+    fc.integer({ min: 1, max: 99999 })
+  ).map(([prefix, num]) => `${prefix}-${num}`);
+
+  // Generator: non-empty array of issue keys (1 to 50 keys)
+  const issueKeysArb = fc.array(issueKeyArb, { minLength: 1, maxLength: 50 });
+
+  it('searchIssuesByKeys() always generates JQL containing `updated >= -72h` and `project =`', async () => {
+    await fc.assert(
+      fc.asyncProperty(issueKeysArb, async (issueKeys) => {
+        capturedJql = null;
+
+        // Start the call — it will hit waitForDelay which uses setTimeout
+        const promise = jiraApi.searchIssuesByKeys(issueKeys);
+
+        // Advance fake timers to resolve any pending setTimeout from the
+        // rate limiter's waitForDelay function.
+        jest.advanceTimersByTime(5000);
+
+        await promise;
+
+        expect(capturedJql).not.toBeNull();
+        expect(capturedJql).toContain('updated >= -72h');
+        expect(capturedJql).toContain('project =');
+      }),
+      { numRuns: 100 }
+    );
+  }, 60000);
+});

backend/__tests__/jira-route-removal.test.js

@@ -0,0 +1,151 @@
+/**
+ * Example-Based Tests: Route Removal and Remaining Routes
+ *
+ * Feature: jira-api-compliance-cleanup
+ *
+ * Property 2: Search route is absent from router (Example)
+ *   After the route removal, a POST request to /api/jira/search SHALL return HTTP 404.
+ *   Validates: Requirements 1.1, 1.2
+ *
+ * Property 3: Existing routes remain functional after search route removal (Example)
+ *   The routes GET /lookup/:issueKey, POST /sync-all, POST /:id/sync, and
+ *   POST /create-in-jira SHALL continue to respond with non-404 status codes.
+ *   Validates: Requirements 1.3, 1.4, 1.5, 1.6
+ */
+
+const http = require('http');
+const express = require('express');
+
+// Mock the auth middleware so routes don't require real sessions/cookies.
+jest.mock('../middleware/auth', () => ({
+  requireAuth: () => (req, res, next) => {
+    req.user = { id: 1, username: 'test', group: 'Admin' };
+    next();
+  },
+  requireGroup: () => (req, res, next) => next(),
+}));
+
+// Mock the audit log helper to be a no-op.
+jest.mock('../helpers/auditLog', () => jest.fn());
+
+// Mock the db module to avoid requiring DATABASE_URL in CI
+jest.mock('../db', () => ({
+  query: jest.fn(() => Promise.resolve({ rows: [] })),
+}));
+
+// Mock the jiraApi helper — mark it as not configured so routes return 503
+// (which is fine; we only care that they are NOT 404).
+jest.mock('../helpers/jiraApi', () => ({
+  isConfigured: false,
+  getRateLimitStatus: jest.fn(() => ({
+    burst: { remaining: 60, limit: 60 },
+    daily: { remaining: 1440, limit: 1440 },
+  })),
+}));
+
+const createJiraTicketsRouter = require('../routes/jiraTickets');
+
+// Minimal db mock — callback-style methods that return empty results.
+function createMockDb() {
+  return {
+    get: jest.fn((_sql, _params, cb) => cb(null, null)),
+    all: jest.fn((_sql, _params, cb) => cb(null, [])),
+    run: jest.fn(function (_sql, _params, cb) {
+      if (typeof cb === 'function') cb.call({ lastID: 1, changes: 0 }, null);
+    }),
+  };
+}
+
+/**
+ * Helper: send an HTTP request to the test server and return { statusCode }.
+ */
+function request(server, method, path, body) {
+  return new Promise((resolve, reject) => {
+    const addr = server.address();
+    const options = {
+      hostname: '127.0.0.1',
+      port: addr.port,
+      path,
+      method,
+      headers: { 'Content-Type': 'application/json' },
+    };
+
+    const req = http.request(options, (res) => {
+      // Consume the response body so the socket closes cleanly.
+      const chunks = [];
+      res.on('data', (chunk) => chunks.push(chunk));
+      res.on('end', () => {
+        resolve({ statusCode: res.statusCode });
+      });
+    });
+
+    req.on('error', reject);
+
+    if (body) {
+      req.write(JSON.stringify(body));
+    }
+    req.end();
+  });
+}
+
+describe('Feature: jira-api-compliance-cleanup — route removal tests', () => {
+  let app;
+  let server;
+
+  beforeAll((done) => {
+    const db = createMockDb();
+    app = express();
+    app.use(express.json());
+    app.use('/api/jira-tickets', createJiraTicketsRouter(db));
+
+    // Listen on a random available port.
+    server = app.listen(0, '127.0.0.1', done);
+  });
+
+  afterAll((done) => {
+    server.close(done);
+  });
+
+  // ---------------------------------------------------------------------------
+  // Property 2: POST /api/jira-tickets/search returns 404
+  // Validates: Requirements 1.1, 1.2
+  // ---------------------------------------------------------------------------
+  describe('Property 2: Search route is absent', () => {
+    it('POST /api/jira-tickets/search returns HTTP 404', async () => {
+      const res = await request(server, 'POST', '/api/jira-tickets/search', {
+        jql: 'project = TEST',
+      });
+      expect(res.statusCode).toBe(404);
+    });
+  });
+
+  // ---------------------------------------------------------------------------
+  // Property 3: Remaining routes respond with non-404 status codes
+  // Validates: Requirements 1.3, 1.4, 1.5, 1.6
+  // ---------------------------------------------------------------------------
+  describe('Property 3: Existing routes remain functional', () => {
+    it('GET /api/jira-tickets/lookup/:issueKey returns non-404', async () => {
+      const res = await request(server, 'GET', '/api/jira-tickets/lookup/TEST-1');
+      expect(res.statusCode).not.toBe(404);
+    });
+
+    it('POST /api/jira-tickets/sync-all returns non-404', async () => {
+      const res = await request(server, 'POST', '/api/jira-tickets/sync-all');
+      expect(res.statusCode).not.toBe(404);
+    });
+
+    it('POST /api/jira-tickets/:id/sync returns non-404', async () => {
+      const res = await request(server, 'POST', '/api/jira-tickets/1/sync');
+      expect(res.statusCode).not.toBe(404);
+    });
+
+    it('POST /api/jira-tickets/create-in-jira returns non-404', async () => {
+      const res = await request(server, 'POST', '/api/jira-tickets/create-in-jira', {
+        cve_id: 'CVE-2024-12345',
+        vendor: 'TestVendor',
+        summary: 'Test summary',
+      });
+      expect(res.statusCode).not.toBe(404);
+    });
+  });
+});

backend/db-schema.sql

@@ -0,0 +1,479 @@
+-- =============================================================================
+-- CVE Dashboard — Complete PostgreSQL Schema (v1.0.0)
+-- =============================================================================
+-- Translates the full SQLite schema (setup.js) to PostgreSQL 16.
+-- Designed for idempotent execution: safe to run multiple times via psql or
+-- pool.query() without errors or duplicate data.
+--
+-- Usage:
+--   psql -h localhost -p 5433 -U steam -d cve_dashboard -f backend/db-schema.sql
+--   OR
+--   const schema = fs.readFileSync('backend/db-schema.sql', 'utf8');
+--   await pool.query(schema);
+-- =============================================================================
+
+-- =============================================================================
+-- Core CVE tracking tables
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS cves (
+    id SERIAL PRIMARY KEY,
+    cve_id VARCHAR(20) NOT NULL,
+    vendor VARCHAR(100) NOT NULL,
+    severity VARCHAR(20) NOT NULL,
+    description TEXT,
+    published_date DATE,
+    status VARCHAR(50) DEFAULT 'Open',
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW(),
+    created_by INTEGER,
+    UNIQUE(cve_id, vendor)
+);
+
+CREATE INDEX IF NOT EXISTS idx_cve_id ON cves(cve_id);
+CREATE INDEX IF NOT EXISTS idx_vendor ON cves(vendor);
+CREATE INDEX IF NOT EXISTS idx_severity ON cves(severity);
+CREATE INDEX IF NOT EXISTS idx_status ON cves(status);
+
+CREATE TABLE IF NOT EXISTS documents (
+    id SERIAL PRIMARY KEY,
+    cve_id VARCHAR(20) NOT NULL,
+    vendor VARCHAR(100) NOT NULL,
+    name VARCHAR(255) NOT NULL,
+    type VARCHAR(50) NOT NULL,
+    file_path VARCHAR(500) NOT NULL,
+    file_size VARCHAR(20),
+    mime_type VARCHAR(100),
+    uploaded_at TIMESTAMPTZ DEFAULT NOW(),
+    notes TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_doc_cve_id ON documents(cve_id);
+CREATE INDEX IF NOT EXISTS idx_doc_vendor ON documents(vendor);
+CREATE INDEX IF NOT EXISTS idx_doc_type ON documents(type);
+
+CREATE TABLE IF NOT EXISTS required_documents (
+    id SERIAL PRIMARY KEY,
+    vendor VARCHAR(100) NOT NULL,
+    document_type VARCHAR(50) NOT NULL,
+    is_mandatory BOOLEAN DEFAULT TRUE,
+    description TEXT,
+    UNIQUE(vendor, document_type)
+);
+
+-- =============================================================================
+-- Authentication and session management
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS users (
+    id SERIAL PRIMARY KEY,
+    username VARCHAR(50) UNIQUE NOT NULL,
+    email VARCHAR(255) UNIQUE NOT NULL,
+    password_hash VARCHAR(255) NOT NULL,
+    role VARCHAR(20) NOT NULL DEFAULT 'viewer' CHECK (role IN ('admin', 'editor', 'viewer')),
+    is_active BOOLEAN DEFAULT TRUE,
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    last_login TIMESTAMPTZ,
+    user_group VARCHAR(20) NOT NULL DEFAULT 'Read_Only'
+        CHECK (user_group IN ('Admin', 'Standard_User', 'Leadership', 'Read_Only')),
+    bu_teams TEXT NOT NULL DEFAULT ''
+);
+
+CREATE INDEX IF NOT EXISTS idx_users_username ON users(username);
+CREATE INDEX IF NOT EXISTS idx_users_user_group ON users(user_group);
+
+CREATE TABLE IF NOT EXISTS sessions (
+    id SERIAL PRIMARY KEY,
+    session_id VARCHAR(255) UNIQUE NOT NULL,
+    user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+    expires_at TIMESTAMPTZ NOT NULL,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_sessions_session_id ON sessions(session_id);
+CREATE INDEX IF NOT EXISTS idx_sessions_user_id ON sessions(user_id);
+CREATE INDEX IF NOT EXISTS idx_sessions_expires ON sessions(expires_at);
+
+-- =============================================================================
+-- Audit logging
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS audit_logs (
+    id SERIAL PRIMARY KEY,
+    user_id INTEGER,
+    username VARCHAR(50) NOT NULL,
+    action VARCHAR(50) NOT NULL,
+    entity_type VARCHAR(50) NOT NULL,
+    entity_id VARCHAR(100),
+    details TEXT,
+    ip_address VARCHAR(45),
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_audit_user_id ON audit_logs(user_id);
+CREATE INDEX IF NOT EXISTS idx_audit_action ON audit_logs(action);
+CREATE INDEX IF NOT EXISTS idx_audit_entity_type ON audit_logs(entity_type);
+CREATE INDEX IF NOT EXISTS idx_audit_created_at ON audit_logs(created_at);
+
+-- =============================================================================
+-- Jira integration
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS jira_tickets (
+    id SERIAL PRIMARY KEY,
+    cve_id TEXT NOT NULL,
+    vendor TEXT NOT NULL,
+    ticket_key TEXT NOT NULL,
+    url TEXT,
+    summary TEXT,
+    status TEXT DEFAULT 'Open' CHECK (status IN ('Open', 'In Progress', 'Closed')),
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_jira_tickets_cve ON jira_tickets(cve_id, vendor);
+CREATE INDEX IF NOT EXISTS idx_jira_tickets_status ON jira_tickets(status);
+
+-- =============================================================================
+-- Archer integration
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS archer_tickets (
+    id SERIAL PRIMARY KEY,
+    exc_number TEXT NOT NULL UNIQUE,
+    archer_url TEXT,
+    status TEXT DEFAULT 'Draft' CHECK (status IN ('Draft', 'Open', 'Under Review', 'Accepted')),
+    cve_id TEXT NOT NULL,
+    vendor TEXT NOT NULL,
+    created_by INTEGER REFERENCES users(id),
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_archer_tickets_cve ON archer_tickets(cve_id, vendor);
+CREATE INDEX IF NOT EXISTS idx_archer_tickets_status ON archer_tickets(status);
+CREATE INDEX IF NOT EXISTS idx_archer_tickets_exc ON archer_tickets(exc_number);
+
+-- =============================================================================
+-- Knowledge base
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS knowledge_base (
+    id SERIAL PRIMARY KEY,
+    title VARCHAR(255) NOT NULL,
+    slug VARCHAR(255) UNIQUE NOT NULL,
+    description TEXT,
+    category VARCHAR(100),
+    file_path VARCHAR(500),
+    file_name VARCHAR(255),
+    file_type VARCHAR(50),
+    file_size INTEGER,
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW(),
+    created_by INTEGER REFERENCES users(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_base_slug ON knowledge_base(slug);
+CREATE INDEX IF NOT EXISTS idx_knowledge_base_category ON knowledge_base(category);
+CREATE INDEX IF NOT EXISTS idx_knowledge_base_created_at ON knowledge_base(created_at DESC);
+
+-- =============================================================================
+-- Ivanti findings — individual rows (replaces findings_json blob)
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS ivanti_findings (
+    id TEXT PRIMARY KEY,
+    host_id INTEGER,
+    title TEXT NOT NULL DEFAULT '',
+    severity NUMERIC(4,2) NOT NULL DEFAULT 0,
+    vrr_group TEXT NOT NULL DEFAULT '',
+    host_name TEXT NOT NULL DEFAULT '',
+    ip_address TEXT NOT NULL DEFAULT '',
+    dns TEXT NOT NULL DEFAULT '',
+    status TEXT NOT NULL DEFAULT '',
+    sla_status TEXT NOT NULL DEFAULT '',
+    due_date DATE,
+    last_found_on DATE,
+    bu_ownership TEXT NOT NULL DEFAULT '',
+    cves TEXT[] DEFAULT '{}',
+    workflow_id TEXT,
+    workflow_state TEXT,
+    workflow_type TEXT,
+    state TEXT NOT NULL DEFAULT 'open' CHECK (state IN ('open', 'closed')),
+    note TEXT NOT NULL DEFAULT '',
+    override_host_name TEXT,
+    override_dns TEXT,
+    synced_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_findings_state ON ivanti_findings(state);
+CREATE INDEX IF NOT EXISTS idx_findings_bu ON ivanti_findings(bu_ownership);
+CREATE INDEX IF NOT EXISTS idx_findings_severity ON ivanti_findings(severity);
+CREATE INDEX IF NOT EXISTS idx_findings_state_bu ON ivanti_findings(state, bu_ownership);
+
+-- =============================================================================
+-- Ivanti sync state (single-row pattern — replaces ivanti_findings_cache metadata)
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS ivanti_sync_state (
+    id INTEGER PRIMARY KEY DEFAULT 1 CHECK (id = 1),
+    total INTEGER DEFAULT 0,
+    workflows_json TEXT DEFAULT '[]',
+    synced_at TIMESTAMPTZ,
+    sync_status TEXT DEFAULT 'never',
+    error_message TEXT
+);
+
+-- =============================================================================
+-- Ivanti counts cache (single-row pattern for FP workflow counts)
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS ivanti_counts_cache (
+    id INTEGER PRIMARY KEY DEFAULT 1 CHECK (id = 1),
+    open_count INTEGER DEFAULT 0,
+    closed_count INTEGER DEFAULT 0,
+    synced_at TIMESTAMPTZ,
+    fp_workflow_counts_json TEXT DEFAULT '{}',
+    fp_id_counts_json TEXT DEFAULT '{}'
+);
+
+-- =============================================================================
+-- Ivanti counts history
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS ivanti_counts_history (
+    id SERIAL PRIMARY KEY,
+    open_count INTEGER NOT NULL,
+    closed_count INTEGER NOT NULL,
+    recorded_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE TABLE IF NOT EXISTS ivanti_counts_history_by_bu (
+    id SERIAL PRIMARY KEY,
+    bu_ownership TEXT NOT NULL,
+    state TEXT NOT NULL CHECK (state IN ('open', 'closed')),
+    count INTEGER NOT NULL DEFAULT 0,
+    recorded_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_counts_history_bu ON ivanti_counts_history_by_bu(bu_ownership);
+CREATE INDEX IF NOT EXISTS idx_counts_history_bu_date ON ivanti_counts_history_by_bu(recorded_at);
+
+-- =============================================================================
+-- Ivanti FP (False Positive) submissions
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS ivanti_fp_submissions (
+    id SERIAL PRIMARY KEY,
+    user_id INTEGER NOT NULL,
+    username TEXT NOT NULL,
+    ivanti_workflow_batch_id INTEGER,
+    ivanti_generated_id TEXT,
+    ivanti_workflow_batch_uuid TEXT,
+    workflow_name TEXT NOT NULL,
+    reason TEXT NOT NULL,
+    description TEXT,
+    expiration_date TEXT NOT NULL,
+    scope_override TEXT NOT NULL DEFAULT 'Authorized',
+    finding_ids_json TEXT NOT NULL,
+    queue_item_ids_json TEXT NOT NULL,
+    attachment_count INTEGER DEFAULT 0,
+    attachment_results_json TEXT,
+    status TEXT NOT NULL DEFAULT 'success' CHECK (status IN ('success', 'partial', 'failed')),
+    lifecycle_status TEXT NOT NULL DEFAULT 'submitted'
+        CHECK (lifecycle_status IN ('submitted', 'approved', 'rejected', 'rework', 'resubmitted')),
+    error_message TEXT,
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_fp_submissions_user ON ivanti_fp_submissions(user_id);
+CREATE INDEX IF NOT EXISTS idx_fp_submissions_ivanti_id ON ivanti_fp_submissions(ivanti_generated_id);
+
+CREATE TABLE IF NOT EXISTS ivanti_fp_submission_history (
+    id SERIAL PRIMARY KEY,
+    submission_id INTEGER NOT NULL REFERENCES ivanti_fp_submissions(id) ON DELETE CASCADE,
+    user_id INTEGER NOT NULL,
+    username TEXT NOT NULL,
+    change_type TEXT NOT NULL CHECK (change_type IN (
+        'created', 'fields_updated', 'findings_added',
+        'attachments_added', 'status_changed'
+    )),
+    change_details_json TEXT,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_fp_history_submission ON ivanti_fp_submission_history(submission_id);
+
+-- =============================================================================
+-- Ivanti todo queue (FP, Archer, CARD, GRANITE workflows)
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS ivanti_todo_queue (
+    id SERIAL PRIMARY KEY,
+    user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+    finding_id TEXT NOT NULL,
+    finding_title TEXT,
+    cves_json TEXT,
+    ip_address TEXT,
+    hostname TEXT,
+    vendor TEXT NOT NULL,
+    workflow_type TEXT NOT NULL CHECK (workflow_type IN ('FP', 'Archer', 'CARD', 'GRANITE', 'DECOM')),
+    status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending', 'complete')),
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_todo_queue_user ON ivanti_todo_queue(user_id, status);
+
+-- =============================================================================
+-- Ivanti archive detection and anomaly tracking
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS ivanti_finding_archives (
+    id SERIAL PRIMARY KEY,
+    finding_id TEXT NOT NULL UNIQUE,
+    finding_title TEXT NOT NULL DEFAULT '',
+    host_name TEXT NOT NULL DEFAULT '',
+    ip_address TEXT NOT NULL DEFAULT '',
+    current_state TEXT NOT NULL CHECK (current_state IN ('ARCHIVED', 'RETURNED', 'CLOSED', 'CLOSED_GONE')),
+    last_severity NUMERIC(4,2) NOT NULL DEFAULT 0,
+    first_archived_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    last_transition_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_archive_finding_id ON ivanti_finding_archives(finding_id);
+CREATE INDEX IF NOT EXISTS idx_archive_current_state ON ivanti_finding_archives(current_state);
+
+CREATE TABLE IF NOT EXISTS ivanti_archive_transitions (
+    id SERIAL PRIMARY KEY,
+    archive_id INTEGER NOT NULL REFERENCES ivanti_finding_archives(id),
+    from_state TEXT NOT NULL,
+    to_state TEXT NOT NULL,
+    severity_at_transition NUMERIC(4,2) NOT NULL DEFAULT 0,
+    reason TEXT NOT NULL DEFAULT '',
+    transitioned_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_transition_archive_id ON ivanti_archive_transitions(archive_id);
+
+CREATE TABLE IF NOT EXISTS ivanti_sync_anomaly_log (
+    id SERIAL PRIMARY KEY,
+    sync_timestamp TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    open_count_delta INTEGER NOT NULL DEFAULT 0,
+    closed_count_delta INTEGER NOT NULL DEFAULT 0,
+    newly_archived_count INTEGER NOT NULL DEFAULT 0,
+    returned_count INTEGER NOT NULL DEFAULT 0,
+    classification_json TEXT NOT NULL DEFAULT '{}',
+    return_classification_json TEXT NOT NULL DEFAULT '{}',
+    is_significant BOOLEAN NOT NULL DEFAULT FALSE,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_anomaly_sync_timestamp ON ivanti_sync_anomaly_log(sync_timestamp);
+
+CREATE TABLE IF NOT EXISTS ivanti_finding_bu_history (
+    id SERIAL PRIMARY KEY,
+    finding_id TEXT NOT NULL,
+    finding_title TEXT NOT NULL DEFAULT '',
+    host_name TEXT NOT NULL DEFAULT '',
+    previous_bu TEXT NOT NULL,
+    new_bu TEXT NOT NULL,
+    detected_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_bu_history_finding_id ON ivanti_finding_bu_history(finding_id);
+CREATE INDEX IF NOT EXISTS idx_bu_history_detected_at ON ivanti_finding_bu_history(detected_at);
+
+-- =============================================================================
+-- Atlas action plans cache
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS atlas_action_plans_cache (
+    id SERIAL PRIMARY KEY,
+    host_id INTEGER NOT NULL UNIQUE,
+    has_action_plan BOOLEAN NOT NULL DEFAULT FALSE,
+    plan_count INTEGER NOT NULL DEFAULT 0,
+    plans_json TEXT NOT NULL DEFAULT '[]',
+    synced_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_atlas_cache_host_id ON atlas_action_plans_cache(host_id);
+
+-- =============================================================================
+-- Compliance (NTS AEO) tracking
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS compliance_uploads (
+    id SERIAL PRIMARY KEY,
+    filename TEXT NOT NULL,
+    report_date TEXT,
+    uploaded_by INTEGER REFERENCES users(id) ON DELETE SET NULL,
+    uploaded_at TIMESTAMPTZ DEFAULT NOW(),
+    new_count INTEGER DEFAULT 0,
+    resolved_count INTEGER DEFAULT 0,
+    recurring_count INTEGER DEFAULT 0,
+    summary_json TEXT
+);
+
+CREATE TABLE IF NOT EXISTS compliance_items (
+    id SERIAL PRIMARY KEY,
+    upload_id INTEGER NOT NULL REFERENCES compliance_uploads(id) ON DELETE CASCADE,
+    hostname TEXT NOT NULL,
+    ip_address TEXT,
+    device_type TEXT,
+    team TEXT,
+    metric_id TEXT NOT NULL,
+    metric_desc TEXT,
+    category TEXT,
+    extra_json TEXT,
+    status TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active', 'resolved')),
+    first_seen_upload_id INTEGER REFERENCES compliance_uploads(id) ON DELETE SET NULL,
+    resolved_upload_id INTEGER REFERENCES compliance_uploads(id) ON DELETE SET NULL,
+    seen_count INTEGER DEFAULT 1,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_compliance_items_upload ON compliance_items(upload_id);
+CREATE INDEX IF NOT EXISTS idx_compliance_items_identity ON compliance_items(hostname, metric_id);
+CREATE INDEX IF NOT EXISTS idx_compliance_items_team_status ON compliance_items(team, status);
+
+CREATE TABLE IF NOT EXISTS compliance_notes (
+    id SERIAL PRIMARY KEY,
+    hostname TEXT NOT NULL,
+    metric_id TEXT NOT NULL,
+    note TEXT NOT NULL,
+    group_id TEXT,
+    created_by INTEGER REFERENCES users(id) ON DELETE SET NULL,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_compliance_notes_identity ON compliance_notes(hostname, metric_id);
+CREATE INDEX IF NOT EXISTS idx_compliance_notes_group ON compliance_notes(group_id);
+
+-- =============================================================================
+-- Seed data
+-- =============================================================================
+
+-- Required documents (idempotent via unique constraint on vendor + document_type)
+INSERT INTO required_documents (vendor, document_type, is_mandatory, description) VALUES
+    ('Microsoft', 'advisory', TRUE, 'Official Microsoft Security Advisory'),
+    ('Microsoft', 'screenshot', FALSE, 'Proof of patch application'),
+    ('Cisco', 'advisory', TRUE, 'Cisco Security Advisory'),
+    ('Oracle', 'advisory', TRUE, 'Oracle Security Alert'),
+    ('VMware', 'advisory', TRUE, 'VMware Security Advisory'),
+    ('Adobe', 'advisory', TRUE, 'Adobe Security Bulletin')
+ON CONFLICT (vendor, document_type) DO NOTHING;
+
+-- Ivanti sync state — ensure single row exists
+INSERT INTO ivanti_sync_state (id, total, workflows_json, sync_status)
+VALUES (1, 0, '[]', 'never')
+ON CONFLICT (id) DO NOTHING;
+
+-- Ivanti counts cache — ensure single row exists
+INSERT INTO ivanti_counts_cache (id, open_count, closed_count, fp_workflow_counts_json, fp_id_counts_json)
+VALUES (1, 0, 0, '{}', '{}')
+ON CONFLICT (id) DO NOTHING;

backend/db.js

@@ -0,0 +1,46 @@
+// PostgreSQL Connection Pool
+// All route files import this module instead of receiving a sqlite3 `db` parameter.
+// Configured via DATABASE_URL environment variable.
+
+// Ensure dotenv is loaded before accessing env vars
+require('dotenv').config({ path: require('path').join(__dirname, '.env') });
+
+const { Pool } = require('pg');
+
+if (!process.env.DATABASE_URL) {
+    console.error('[DB] FATAL: DATABASE_URL environment variable is not set.');
+    console.error('[DB] Expected format: postgresql://user:password@host:port/database');
+    process.exit(1);
+}
+
+const pool = new Pool({
+    connectionString: process.env.DATABASE_URL,
+    max: 10,                        // Maximum connections in pool
+    idleTimeoutMillis: 30000,       // Close idle connections after 30s
+    connectionTimeoutMillis: 5000,  // Fail if connection takes >5s
+});
+
+// Log unexpected pool errors (connection drops, etc.)
+pool.on('error', (err) => {
+    console.error('[DB Pool] Unexpected error on idle client:', err.message);
+});
+
+// Track active connections and warn when approaching exhaustion
+let _activeCount = 0;
+pool.on('acquire', () => {
+    _activeCount++;
+    if (_activeCount >= 8) {
+        console.warn(`[DB Pool] WARNING: ${_activeCount}/10 connections active — approaching exhaustion`);
+    }
+});
+pool.on('release', () => { _activeCount--; });
+
+// Health check — verify connection on startup
+pool.query('SELECT NOW()')
+    .then(() => console.log('[DB Pool] Connected to PostgreSQL'))
+    .catch((err) => {
+        console.error('[DB Pool] Failed to connect:', err.message);
+        console.error('[DB Pool] Check DATABASE_URL and ensure Postgres is running on port 5433');
+    });
+
+module.exports = pool;

backend/helpers/atlasApi.js

@@ -0,0 +1,104 @@
+// Shared Atlas InfoSec API helpers
+// Centralizes HTTP calls so the atlas router uses a single implementation.
+// Follows the same promise-based pattern as ivantiApi.js.
+
+const https = require('https');
+const http = require('http');
+
+// ---------------------------------------------------------------------------
+// Configuration — read from process.env at module load
+// ---------------------------------------------------------------------------
+const ATLAS_API_URL = process.env.ATLAS_API_URL || '';
+const ATLAS_API_USER = process.env.ATLAS_API_USER || '';
+const ATLAS_API_PASS = process.env.ATLAS_API_PASS || '';
+const ATLAS_SKIP_TLS = process.env.ATLAS_SKIP_TLS === 'true';
+
+const requiredVars = ['ATLAS_API_URL', 'ATLAS_API_USER', 'ATLAS_API_PASS'];
+const missingVars = requiredVars.filter((v) => !process.env[v]);
+if (missingVars.length > 0) {
+    console.warn(`[atlas-api] WARNING: Missing required environment variables: ${missingVars.join(', ')}. Atlas API calls will fail.`);
+}
+
+const isConfigured = missingVars.length === 0;
+
+// ---------------------------------------------------------------------------
+// Generic request — supports GET, PUT, PATCH, POST
+// ---------------------------------------------------------------------------
+function atlasRequest(method, urlPath, body, options) {
+    const timeout = (options && options.timeout) || 15000;
+    const authString = Buffer.from(ATLAS_API_USER + ':' + ATLAS_API_PASS).toString('base64');
+    const fullUrl = new URL(ATLAS_API_URL + urlPath);
+    const isHttps = fullUrl.protocol === 'https:';
+    const transport = isHttps ? https : http;
+
+    const headers = {
+        'accept': 'application/json',
+        'authorization': 'Basic ' + authString
+    };
+
+    let bodyStr = null;
+    if (body !== null && body !== undefined) {
+        bodyStr = JSON.stringify(body);
+        headers['content-type'] = 'application/json';
+        headers['content-length'] = Buffer.byteLength(bodyStr);
+    }
+
+    return new Promise((resolve, reject) => {
+        const reqOptions = {
+            hostname: fullUrl.hostname,
+            port: fullUrl.port || (isHttps ? 443 : 80),
+            path: fullUrl.pathname + fullUrl.search,
+            method: method,
+            headers: headers,
+            timeout: timeout
+        };
+
+        if (isHttps) {
+            reqOptions.rejectUnauthorized = !ATLAS_SKIP_TLS;
+        }
+
+        const req = transport.request(reqOptions, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => resolve({ status: res.statusCode, body: data }));
+        });
+
+        req.on('timeout', () => req.destroy(new Error(method + ' ' + urlPath + ' timed out')));
+        req.on('error', (err) => {
+            reject(new Error(method + ' ' + urlPath + ' failed: ' + err.message));
+        });
+
+        if (bodyStr) {
+            req.write(bodyStr);
+        }
+        req.end();
+    });
+}
+
+// ---------------------------------------------------------------------------
+// Convenience wrappers
+// ---------------------------------------------------------------------------
+function atlasGet(urlPath, options) {
+    return atlasRequest('GET', urlPath, null, options);
+}
+
+function atlasPut(urlPath, body, options) {
+    return atlasRequest('PUT', urlPath, body, options);
+}
+
+function atlasPatch(urlPath, body, options) {
+    return atlasRequest('PATCH', urlPath, body, options);
+}
+
+function atlasPost(urlPath, body, options) {
+    return atlasRequest('POST', urlPath, body, options);
+}
+
+module.exports = {
+    isConfigured,
+    atlasRequest,
+    atlasGet,
+    atlasPut,
+    atlasPatch,
+    atlasPost
+};

backend/helpers/auditLog.js

@@ -1,21 +1,19 @@
 // Audit Log Helper
 // Fire-and-forget insert - never blocks the response
+const pool = require('../db');
 
-function logAudit(db, { userId, username, action, entityType, entityId, details, ipAddress }) {
+function logAudit({ userId, username, action, entityType, entityId, details, ipAddress }) {
     const detailsStr = details && typeof details === 'object'
         ? JSON.stringify(details)
         : details || null;
 
-    db.run(
+    pool.query(
         `INSERT INTO audit_logs (user_id, username, action, entity_type, entity_id, details, ip_address)
-         VALUES (?, ?, ?, ?, ?, ?, ?)`,
-        [userId || null, username || 'unknown', action, entityType, entityId || null, detailsStr, ipAddress || null],
-        (err) => {
-            if (err) {
-                console.error('Audit log error:', err.message);
-            }
-        }
-    );
+         VALUES ($1, $2, $3, $4, $5, $6, $7)`,
+        [userId || null, username || 'unknown', action, entityType, entityId || null, detailsStr, ipAddress || null]
+    ).catch((err) => {
+        console.error('Audit log error:', err.message);
+    });
 }
 
 module.exports = logAudit;

backend/helpers/cardApi.js

@@ -0,0 +1,305 @@
+// Shared CARD API helpers
+// Centralizes HTTP calls for the CARD asset ownership API.
+// Follows the same promise-based pattern as atlasApi.js, with the addition
+// of OAuth Bearer token management (auto-acquire, cache, refresh, 401 retry).
+//
+// CARD API versioning:
+//   - Read endpoints (GET):    /api/v1/...
+//   - Mutation endpoints (POST): /api/v2/...
+
+const https = require('https');
+const http  = require('http');
+
+// ---------------------------------------------------------------------------
+// Configuration — read from process.env at module load
+// ---------------------------------------------------------------------------
+const CARD_API_URL  = process.env.CARD_API_URL  || '';
+const CARD_API_USER = process.env.CARD_API_USER || '';
+const CARD_API_PASS = process.env.CARD_API_PASS || '';
+const CARD_SKIP_TLS = process.env.CARD_SKIP_TLS === 'true';
+
+const requiredVars = ['CARD_API_URL', 'CARD_API_USER', 'CARD_API_PASS'];
+const missingVars  = requiredVars.filter((v) => !process.env[v]);
+if (missingVars.length > 0) {
+    console.warn(`[card-api] WARNING: Missing required environment variables: ${missingVars.join(', ')}. CARD API calls will fail.`);
+}
+
+const isConfigured = missingVars.length === 0;
+
+// ---------------------------------------------------------------------------
+// Token Manager — OAuth Bearer token with 1-hour TTL
+// ---------------------------------------------------------------------------
+let cachedToken  = null;   // { token: string, expiresAt: number (epoch ms) }
+
+function tokenIsValid() {
+    if (!cachedToken) return false;
+    // Refresh if within 60 seconds of expiry
+    return cachedToken.expiresAt - Date.now() > 60_000;
+}
+
+function invalidateToken() {
+    cachedToken = null;
+}
+
+/**
+ * Acquire a new Bearer token from CARD /api/v1/auth/get_token using Basic Auth.
+ * Caches the token in memory with a 1-hour TTL.
+ */
+function acquireToken(timeout) {
+    const authString = Buffer.from(CARD_API_USER + ':' + CARD_API_PASS).toString('base64');
+    const fullUrl    = new URL(CARD_API_URL + '/api/v1/auth/get_token');
+    const isHttps    = fullUrl.protocol === 'https:';
+    const transport  = isHttps ? https : http;
+
+    return new Promise((resolve, reject) => {
+        const reqOptions = {
+            hostname: fullUrl.hostname,
+            port:     fullUrl.port || (isHttps ? 443 : 80),
+            path:     fullUrl.pathname + fullUrl.search,
+            method:   'POST',
+            headers:  {
+                'accept':        'application/json',
+                'authorization': 'Basic ' + authString,
+                'content-length': '0',
+            },
+            timeout: timeout || 15000,
+        };
+
+        if (isHttps) {
+            reqOptions.rejectUnauthorized = !CARD_SKIP_TLS;
+        }
+
+        const req = transport.request(reqOptions, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => {
+                if (res.statusCode < 200 || res.statusCode >= 300) {
+                    return reject(new Error(
+                        `[card-api] Token acquisition failed with HTTP ${res.statusCode}: ${data.substring(0, 500)}`
+                    ));
+                }
+
+                // The CARD API returns the token as a JSON string or object.
+                // Try to parse; fall back to raw body as the token string.
+                let token;
+                try {
+                    const parsed = JSON.parse(data);
+                    token = typeof parsed === 'string' ? parsed
+                          : parsed.token || parsed.access_token || data.trim();
+                } catch (_) {
+                    // Response may be a plain token string (unquoted)
+                    token = data.trim();
+                }
+
+                if (!token) {
+                    return reject(new Error('[card-api] Token parse failure: empty token in response body.'));
+                }
+
+                cachedToken = {
+                    token,
+                    expiresAt: Date.now() + 60 * 60 * 1000, // 1-hour TTL
+                };
+                resolve(cachedToken.token);
+            });
+        });
+
+        req.on('timeout', () => req.destroy(new Error('GET /api/v1/auth/get_token timed out')));
+        req.on('error', (err) => {
+            reject(new Error(`[card-api] GET /api/v1/auth/get_token failed: ${err.message}`));
+        });
+        req.end();
+    });
+}
+
+/**
+ * Ensure we have a valid Bearer token, acquiring or refreshing as needed.
+ */
+async function ensureToken(timeout) {
+    if (tokenIsValid()) return cachedToken.token;
+    return acquireToken(timeout);
+}
+
+// ---------------------------------------------------------------------------
+// Generic request — supports GET and POST with Bearer auth + 401 retry
+// ---------------------------------------------------------------------------
+async function cardRequest(method, urlPath, body, options) {
+    const timeout = (options && options.timeout) || 15000;
+    const skipAuth = (options && options.skipAuth) || false;
+
+    async function doRequest(bearerToken) {
+        const fullUrl   = new URL(CARD_API_URL + urlPath);
+        const isHttps   = fullUrl.protocol === 'https:';
+        const transport = isHttps ? https : http;
+
+        const headers = { 'accept': 'application/json' };
+
+        if (bearerToken) {
+            headers['authorization'] = 'Bearer ' + bearerToken;
+        }
+
+        let bodyStr = null;
+        if (body !== null && body !== undefined) {
+            bodyStr = JSON.stringify(body);
+            headers['content-type']   = 'application/json';
+            headers['content-length'] = Buffer.byteLength(bodyStr);
+        }
+
+        return new Promise((resolve, reject) => {
+            const reqOptions = {
+                hostname: fullUrl.hostname,
+                port:     fullUrl.port || (isHttps ? 443 : 80),
+                path:     fullUrl.pathname + fullUrl.search,
+                method,
+                headers,
+                timeout,
+            };
+
+            if (isHttps) {
+                reqOptions.rejectUnauthorized = !CARD_SKIP_TLS;
+            }
+
+            const req = transport.request(reqOptions, (res) => {
+                let data = '';
+                res.on('data', (chunk) => { data += chunk; });
+                res.on('end', () => resolve({ status: res.statusCode, body: data }));
+            });
+
+            req.on('timeout', () => req.destroy(new Error(`${method} ${urlPath} timed out`)));
+            req.on('error', (err) => {
+                reject(new Error(`[card-api] ${method} ${urlPath} failed: ${err.message}`));
+            });
+
+            if (bodyStr) req.write(bodyStr);
+            req.end();
+        });
+    }
+
+    // Skip auth for the token endpoint itself
+    if (skipAuth) {
+        return doRequest(null);
+    }
+
+    // Normal flow: ensure token → request → retry once on 401
+    let token = await ensureToken(timeout);
+    let result = await doRequest(token);
+
+    if (result.status === 401) {
+        // Invalidate and retry exactly once
+        invalidateToken();
+        token = await ensureToken(timeout);
+        result = await doRequest(token);
+    }
+
+    return result;
+}
+
+// ---------------------------------------------------------------------------
+// Convenience wrappers
+// ---------------------------------------------------------------------------
+function cardGet(urlPath, options) {
+    return cardRequest('GET', urlPath, null, options);
+}
+
+function cardPost(urlPath, body, options) {
+    return cardRequest('POST', urlPath, body, options);
+}
+
+// ---------------------------------------------------------------------------
+// High-level helpers used by the UAT test and routes
+// ---------------------------------------------------------------------------
+
+/**
+ * Test connection by acquiring a token. Returns { ok, token } or { ok, error }.
+ */
+async function testConnection() {
+    try {
+        const token = await acquireToken();
+        return { ok: true, token: token.substring(0, 12) + '...' };
+    } catch (err) {
+        return { ok: false, error: err.message };
+    }
+}
+
+/**
+ * GET /api/v1/teams — list all CARD teams.
+ */
+async function getTeams() {
+    const res = await cardGet('/api/v1/teams');
+    return { status: res.status, body: res.body, ok: res.status >= 200 && res.status < 300 };
+}
+
+/**
+ * GET /api/v1/team/{teamName}/assets — list assets for a team.
+ */
+async function getTeamAssets(teamName, { disposition, page, pageSize } = {}) {
+    const params = new URLSearchParams();
+    if (disposition) params.set('disposition', disposition);
+    if (page)        params.set('page', String(page));
+    params.set('page_size', String(pageSize || 50));
+
+    const qs = params.toString();
+    const res = await cardGet(`/api/v1/team/${encodeURIComponent(teamName)}/assets${qs ? '?' + qs : ''}`);
+    return { status: res.status, body: res.body, ok: res.status >= 200 && res.status < 300 };
+}
+
+/**
+ * GET /api/v1/owner/{assetId} — get owner record including update_token.
+ */
+async function getOwner(assetId) {
+    const res = await cardGet(`/api/v1/owner/${encodeURIComponent(assetId)}`);
+    return { status: res.status, body: res.body, ok: res.status >= 200 && res.status < 300 };
+}
+
+/**
+ * POST /api/v2/owner/{assetId}/confirm — confirm asset to a team.
+ */
+async function confirmAsset(assetId, teamName, updateToken, comment) {
+    const params = new URLSearchParams({ update_token: updateToken });
+    if (comment) params.set('comment', comment);
+    const res = await cardPost(
+        `/api/v2/owner/${encodeURIComponent(assetId)}/confirm?${params.toString()}`,
+        { name: teamName }
+    );
+    return { status: res.status, body: res.body, ok: res.status >= 200 && res.status < 300 };
+}
+
+/**
+ * POST /api/v2/owner/{assetId}/decline — decline asset from a team.
+ */
+async function declineAsset(assetId, teamName, updateToken, comment) {
+    const params = new URLSearchParams({ update_token: updateToken });
+    if (comment) params.set('comment', comment);
+    const res = await cardPost(
+        `/api/v2/owner/${encodeURIComponent(assetId)}/decline?${params.toString()}`,
+        { name: teamName }
+    );
+    return { status: res.status, body: res.body, ok: res.status >= 200 && res.status < 300 };
+}
+
+/**
+ * POST /api/v2/owner/{assetId}/{fromTeam}/redirect — redirect asset between teams.
+ */
+async function redirectAsset(assetId, fromTeam, toTeam, updateToken) {
+    const params = new URLSearchParams({ update_token: updateToken });
+    const res = await cardPost(
+        `/api/v2/owner/${encodeURIComponent(assetId)}/${encodeURIComponent(fromTeam)}/redirect?${params.toString()}`,
+        { name: toTeam }
+    );
+    return { status: res.status, body: res.body, ok: res.status >= 200 && res.status < 300 };
+}
+
+module.exports = {
+    isConfigured,
+    missingVars,
+    cardRequest,
+    cardGet,
+    cardPost,
+    testConnection,
+    getTeams,
+    getTeamAssets,
+    getOwner,
+    confirmAsset,
+    declineAsset,
+    redirectAsset,
+    invalidateToken,
+};

backend/helpers/driftChecker.js

@@ -0,0 +1,332 @@
+// Drift Checker — compares xlsx schema against parser config to detect structural drift
+// Returns categorised findings: breaking, silent_miss, cosmetic
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Load and validate the compliance parser configuration file.
+ * @param {string} configPath — absolute or relative path to compliance_config.json
+ * @returns {object} parsed config with metric_categories, core_cols, skip_sheets
+ * @throws {Error} descriptive error if file missing, invalid JSON, or missing required keys
+ */
+function loadConfig(configPath) {
+  let raw;
+  try {
+    raw = fs.readFileSync(configPath, 'utf8');
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      throw new Error(`Configuration file not found: ${configPath}`);
+    }
+    throw new Error(`Failed to read configuration file: ${err.message}`);
+  }
+
+  let config;
+  try {
+    config = JSON.parse(raw);
+  } catch (err) {
+    throw new Error(`Configuration file contains invalid JSON: ${err.message}`);
+  }
+
+  if (!config.metric_categories || typeof config.metric_categories !== 'object' || Array.isArray(config.metric_categories)) {
+    throw new Error('Configuration file is missing required key "metric_categories" (must be an object)');
+  }
+  if (!Array.isArray(config.core_cols)) {
+    throw new Error('Configuration file is missing required key "core_cols" (must be an array)');
+  }
+  if (!Array.isArray(config.skip_sheets)) {
+    throw new Error('Configuration file is missing required key "skip_sheets" (must be an array)');
+  }
+
+  return config;
+}
+
+/**
+ * Compare an xlsx schema against the parser config and produce a drift report.
+ * @param {object} schema — output of extract_xlsx_schema.py: { sheets: [{ name, columns, metric_values? }] }
+ * @param {object} config — parsed compliance_config.json: { metric_categories, core_cols, skip_sheets }
+ * @returns {{ breaking: Array, silent_miss: Array, cosmetic: Array }}
+ */
+function compareSchemaToDrift(schema, config) {
+  const breaking = [];
+  const silent_miss = [];
+  const cosmetic = [];
+
+  const metricCategoryKeys = new Set(Object.keys(config.metric_categories));
+  const coreCols = new Set(config.core_cols);
+  const skipSheets = new Set(config.skip_sheets);
+
+  // Build lookup of xlsx sheet names and find the Summary sheet
+  const xlsxSheetNames = new Set();
+  let summarySheet = null;
+
+  for (const sheet of schema.sheets) {
+    xlsxSheetNames.add(sheet.name);
+    if (sheet.name === 'Summary') {
+      summarySheet = sheet;
+    }
+  }
+
+  // Identify detail sheets: present in xlsx AND not in skip_sheets
+  const detailSheets = schema.sheets.filter(s => !skipSheets.has(s.name));
+
+  // Build set of metric values from the Summary sheet (used by multiple rules)
+  const summaryMetrics = new Set(
+    (summarySheet && Array.isArray(summarySheet.metric_values)) ? summarySheet.metric_values : []
+  );
+
+  // --- Breaking rules ---
+
+  // Missing core column: a detail sheet is missing a column from core_cols.
+  // Collect per-column stats first, then classify: if a column is missing from
+  // ALL detail sheets it's breaking. If missing from only some (e.g. 5.8.1 uses
+  // CMDB columns), it's cosmetic — the parser handles it via extra_json.
+  const coreColMissingMap = {};  // col -> [sheet names missing it]
+  for (const sheet of detailSheets) {
+    const sheetCols = new Set(sheet.columns || []);
+    for (const coreCol of config.core_cols) {
+      if (!sheetCols.has(coreCol)) {
+        if (!coreColMissingMap[coreCol]) coreColMissingMap[coreCol] = [];
+        coreColMissingMap[coreCol].push(sheet.name);
+      }
+    }
+  }
+
+  for (const coreCol of Object.keys(coreColMissingMap)) {
+    const missingSheets = coreColMissingMap[coreCol];
+    if (detailSheets.length > 0 && missingSheets.length >= detailSheets.length) {
+      // Missing from ALL detail sheets — genuinely breaking
+      breaking.push({
+        severity: 'breaking',
+        message: `Core column "${coreCol}" is missing from all ${detailSheets.length} detail sheet(s)`,
+        value: coreCol,
+        sheet: null
+      });
+    } else {
+      // Missing from some sheets — structural difference, not drift
+      cosmetic.push({
+        severity: 'cosmetic',
+        message: `Core column "${coreCol}" is missing from ${missingSheets.length} of ${detailSheets.length} detail sheet(s): ${missingSheets.join(', ')}`,
+        value: coreCol,
+        sheet: null
+      });
+    }
+  }
+
+  // Missing detail sheet: a sheet in metric_categories (not in skip_sheets) is absent from xlsx.
+  // If the metric still appears in the Summary's metric_values, it's tracked but has zero
+  // violations this week — downgrade to cosmetic instead of breaking.
+  for (const metricKey of metricCategoryKeys) {
+    if (!skipSheets.has(metricKey) && !xlsxSheetNames.has(metricKey)) {
+      if (summaryMetrics.has(metricKey)) {
+        cosmetic.push({
+          severity: 'cosmetic',
+          message: `Metric "${metricKey}" has no detail sheet this week — still tracked in Summary (zero violations)`,
+          value: metricKey,
+          sheet: null
+        });
+      } else {
+        breaking.push({
+          severity: 'breaking',
+          message: `Expected detail sheet "${metricKey}" (metric category) is missing from the workbook`,
+          value: metricKey,
+          sheet: null
+        });
+      }
+    }
+  }
+
+  // --- Silent-miss rules ---
+
+  // Unknown metric value: a metric value in Summary is not a key in metric_categories
+  if (summarySheet && Array.isArray(summarySheet.metric_values)) {
+    for (const metricVal of summarySheet.metric_values) {
+      if (!metricCategoryKeys.has(metricVal)) {
+        silent_miss.push({
+          severity: 'silent_miss',
+          message: `Unknown metric "${metricVal}" in Summary — not in metric_categories`,
+          value: metricVal,
+          sheet: 'Summary'
+        });
+      }
+    }
+  }
+
+  // Unknown sheet: an xlsx sheet not in skip_sheets and not in metric_categories
+  for (const sheet of schema.sheets) {
+    if (!skipSheets.has(sheet.name) && !metricCategoryKeys.has(sheet.name)) {
+      silent_miss.push({
+        severity: 'silent_miss',
+        message: `Unknown sheet "${sheet.name}" — not in skip_sheets or metric_categories`,
+        value: sheet.name,
+        sheet: sheet.name
+      });
+    }
+  }
+
+  // --- Cosmetic rules ---
+
+  // New column in detail sheet: a detail sheet has columns not in core_cols
+  for (const sheet of detailSheets) {
+    for (const col of (sheet.columns || [])) {
+      if (!coreCols.has(col)) {
+        cosmetic.push({
+          severity: 'cosmetic',
+          message: `New column "${col}" in sheet "${sheet.name}" — will be captured in extra_json`,
+          value: col,
+          sheet: sheet.name
+        });
+      }
+    }
+  }
+
+  // Stale metric category: a key in metric_categories not in Summary metric values
+  for (const metricKey of metricCategoryKeys) {
+    if (!summaryMetrics.has(metricKey)) {
+      cosmetic.push({
+        severity: 'cosmetic',
+        message: `Stale metric category "${metricKey}" — not found in Summary sheet metric values`,
+        value: metricKey,
+        sheet: null
+      });
+    }
+  }
+
+  return { breaking, silent_miss, cosmetic };
+}
+
+/**
+ * Reconcile the parser config to resolve breaking drift findings.
+ *
+ * Breaking — "missing detail sheet":
+ *   A metric_categories key has no matching xlsx sheet. But if the metric
+ *   still appears in the Summary sheet's metric_values, it's a legitimate
+ *   tracked metric that simply doesn't have violations this week — keep it.
+ *   Only remove metrics absent from BOTH the xlsx sheets AND the Summary.
+ *
+ * Breaking — "missing core column":
+ *   A core_cols entry is absent from one or more detail sheets. Only remove
+ *   if the column is missing from ALL detail sheets (some sheets like 5.8.1
+ *   have a completely different column structure and shouldn't cause removal).
+ *
+ * Silent-miss — "unknown metric":
+ *   A metric value in the Summary is not in metric_categories. Add it as 'Other'.
+ *
+ * Silent-miss — "unknown sheet":
+ *   Left as a warning. Auto-adding unknown sheets creates a reconcile loop.
+ *
+ * @param {string} configPath — path to compliance_config.json
+ * @param {object} driftReport — the drift report from compareSchemaToDrift()
+ * @param {object} [schema] — optional xlsx schema (with sheets[].name and Summary metric_values)
+ * @returns {{ changes: Array<{ action: string, key: string, value: string }>, config: object }}
+ */
+function reconcileConfig(configPath, driftReport, schema) {
+  const config = loadConfig(configPath);
+  const changes = [];
+
+  // Build a set of metric values from the Summary sheet (if schema provided)
+  const summaryMetrics = new Set();
+  if (schema && Array.isArray(schema.sheets)) {
+    const summarySheet = schema.sheets.find(function(s) { return s.name === 'Summary'; });
+    if (summarySheet && Array.isArray(summarySheet.metric_values)) {
+      summarySheet.metric_values.forEach(function(v) { summaryMetrics.add(v); });
+    }
+  }
+
+  // Build a set of xlsx sheet names (if schema provided)
+  const xlsxSheetNames = new Set();
+  if (schema && Array.isArray(schema.sheets)) {
+    schema.sheets.forEach(function(s) { xlsxSheetNames.add(s.name); });
+  }
+
+  // Count how many detail sheets exist in the xlsx (excluding skip_sheets)
+  const skipSheets = new Set(config.skip_sheets);
+  const detailSheetCount = schema
+    ? schema.sheets.filter(function(s) { return !skipSheets.has(s.name); }).length
+    : 0;
+
+  // --- Resolve breaking findings ---
+
+  for (const finding of (driftReport.breaking || [])) {
+    // Missing detail sheet: remove from metric_categories ONLY if the metric
+    // is also absent from the Summary's metric_values. If it's in the Summary,
+    // it's still a tracked metric — the sheet just has zero violations this week.
+    if (finding.message.includes('is missing from the workbook') && finding.value in config.metric_categories) {
+      if (summaryMetrics.has(finding.value)) {
+        // Metric is in the Summary — keep it, just note it's sheet-less this week
+        changes.push({
+          action: 'kept',
+          key: 'metric_categories',
+          value: finding.value,
+          detail: `Kept metric "${finding.value}" — no detail sheet this week but still tracked in Summary`
+        });
+      } else {
+        const oldCategory = config.metric_categories[finding.value];
+        delete config.metric_categories[finding.value];
+        changes.push({
+          action: 'removed',
+          key: 'metric_categories',
+          value: finding.value,
+          detail: `Removed stale metric category "${finding.value}" (was "${oldCategory}") — absent from both workbook sheets and Summary`
+        });
+      }
+    }
+
+    // Missing core column: only remove if the column is missing from ALL detail sheets.
+    // Some sheets (e.g. 5.8.1 with CMDB columns) have a completely different structure
+    // and shouldn't cause removal of columns that exist in most other sheets.
+    if (finding.message.includes('is missing core column') && config.core_cols.includes(finding.value)) {
+      if (!changes.some(function(c) { return c.key === 'core_cols' && c.value === finding.value; })) {
+        const missingFromCount = (driftReport.breaking || []).filter(
+          function(f) { return f.message.includes('is missing core column') && f.value === finding.value; }
+        ).length;
+
+        if (detailSheetCount > 0 && missingFromCount >= detailSheetCount) {
+          // Missing from ALL detail sheets — safe to remove
+          config.core_cols = config.core_cols.filter(function(c) { return c !== finding.value; });
+          changes.push({
+            action: 'removed',
+            key: 'core_cols',
+            value: finding.value,
+            detail: `Removed core column "${finding.value}" — missing from all ${detailSheetCount} detail sheet(s)`
+          });
+        } else {
+          // Missing from some sheets but present in others — keep it
+          changes.push({
+            action: 'kept',
+            key: 'core_cols',
+            value: finding.value,
+            detail: `Kept core column "${finding.value}" — missing from ${missingFromCount} of ${detailSheetCount} detail sheet(s)`
+          });
+        }
+      }
+    }
+  }
+
+  // --- Resolve silent-miss findings ---
+
+  for (const finding of (driftReport.silent_miss || [])) {
+    // Unknown metric in Summary: add to metric_categories as 'Other'
+    if (finding.message.includes('not in metric_categories') && !(finding.value in config.metric_categories)) {
+      config.metric_categories[finding.value] = 'Other';
+      changes.push({
+        action: 'added',
+        key: 'metric_categories',
+        value: finding.value,
+        detail: `Added new metric "${finding.value}" to metric_categories as "Other"`
+      });
+    }
+
+    // Unknown sheet: left as a warning — auto-adding creates a reconcile loop.
+  }
+
+  // Only write if there were actual config mutations (not just 'kept' entries)
+  const hasMutations = changes.some(function(c) { return c.action !== 'kept'; });
+  if (hasMutations) {
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+  }
+
+  return { changes, config };
+}
+
+module.exports = { compareSchemaToDrift, loadConfig, reconcileConfig };

backend/helpers/ivantiApi.js

@@ -0,0 +1,154 @@
+// Shared Ivanti / RiskSense API helpers
+// Centralizes HTTP calls so ivantiWorkflows.js, ivantiFindings.js, and
+// ivantiFpWorkflow.js all use the same implementation.
+
+const https = require('https');
+
+const IVANTI_URL_BASE = 'https://platform4.risksense.com/api/v1';
+
+// ---------------------------------------------------------------------------
+// JSON POST — used for search, workflow creation, etc.
+// ---------------------------------------------------------------------------
+function ivantiPost(urlPath, body, apiKey, skipTls) {
+    const bodyStr = JSON.stringify(body);
+    const fullUrl = new URL(IVANTI_URL_BASE + urlPath);
+
+    return new Promise((resolve, reject) => {
+        const options = {
+            hostname: fullUrl.hostname,
+            path: fullUrl.pathname + fullUrl.search,
+            method: 'POST',
+            headers: {
+                'accept': '*/*',
+                'content-type': 'application/json',
+                'x-api-key': apiKey,
+                'x-http-client-type': 'browser',
+                'content-length': Buffer.byteLength(bodyStr)
+            },
+            rejectUnauthorized: !skipTls,
+            timeout: 15000
+        };
+
+        const req = https.request(options, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => resolve({ status: res.statusCode, body: data }));
+        });
+
+        req.on('timeout', () => req.destroy(new Error('Request timed out')));
+        req.on('error', reject);
+        req.write(bodyStr);
+        req.end();
+    });
+}
+
+// ---------------------------------------------------------------------------
+// Multipart POST — used for file attachment uploads.
+// Constructs multipart/form-data manually using Node's https module.
+// ---------------------------------------------------------------------------
+function ivantiMultipartPost(urlPath, fileBuffer, fileName, apiKey, skipTls) {
+    const boundary = '----IvantiUpload' + Date.now().toString(36) + Math.random().toString(36).slice(2);
+    const fullUrl = new URL(IVANTI_URL_BASE + urlPath);
+
+    // Build multipart body
+    const preamble = Buffer.from(
+        `--${boundary}\r\n` +
+        `Content-Disposition: form-data; name="file"; filename="${fileName}"\r\n` +
+        `Content-Type: application/octet-stream\r\n\r\n`
+    );
+    const epilogue = Buffer.from(`\r\n--${boundary}--\r\n`);
+    const bodyBuffer = Buffer.concat([preamble, fileBuffer, epilogue]);
+
+    return new Promise((resolve, reject) => {
+        const options = {
+            hostname: fullUrl.hostname,
+            path: fullUrl.pathname + fullUrl.search,
+            method: 'POST',
+            headers: {
+                'accept': '*/*',
+                'content-type': `multipart/form-data; boundary=${boundary}`,
+                'x-api-key': apiKey,
+                'x-http-client-type': 'browser',
+                'content-length': bodyBuffer.length
+            },
+            rejectUnauthorized: !skipTls,
+            timeout: 30000
+        };
+
+        const req = https.request(options, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => resolve({ status: res.statusCode, body: data }));
+        });
+
+        req.on('timeout', () => req.destroy(new Error('Request timed out')));
+        req.on('error', reject);
+        req.write(bodyBuffer);
+        req.end();
+    });
+}
+
+// ---------------------------------------------------------------------------
+// Multipart form POST — used for endpoints that accept mixed form fields + files.
+// fields: array of { name, value } for text form fields
+// files:  array of { name, buffer, filename } for file uploads
+// ---------------------------------------------------------------------------
+function ivantiFormPost(urlPath, fields, files, apiKey, skipTls) {
+    const boundary = '----IvantiForm' + Date.now().toString(36) + Math.random().toString(36).slice(2);
+    const fullUrl = new URL(IVANTI_URL_BASE + urlPath);
+
+    const parts = [];
+
+    // Text fields
+    for (const { name, value } of fields) {
+        parts.push(Buffer.from(
+            `--${boundary}\r\n` +
+            `Content-Disposition: form-data; name="${name}"\r\n\r\n` +
+            `${value}\r\n`
+        ));
+    }
+
+    // File fields
+    for (const { name, buffer, filename, contentType } of files) {
+        parts.push(Buffer.from(
+            `--${boundary}\r\n` +
+            `Content-Disposition: form-data; name="${name}"; filename="${filename}"\r\n` +
+            `Content-Type: ${contentType || 'application/octet-stream'}\r\n\r\n`
+        ));
+        parts.push(buffer);
+        parts.push(Buffer.from('\r\n'));
+    }
+
+    parts.push(Buffer.from(`--${boundary}--\r\n`));
+    const bodyBuffer = Buffer.concat(parts);
+
+    return new Promise((resolve, reject) => {
+        const options = {
+            hostname: fullUrl.hostname,
+            path: fullUrl.pathname + fullUrl.search,
+            method: 'POST',
+            headers: {
+                'accept': '*/*',
+                'content-type': `multipart/form-data; boundary=${boundary}`,
+                'x-api-key': apiKey,
+                'x-http-client-type': 'browser',
+                'content-length': bodyBuffer.length
+            },
+            rejectUnauthorized: !skipTls,
+            timeout: 60000
+        };
+
+        const req = https.request(options, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => resolve({ status: res.statusCode, body: data }));
+        });
+
+        req.on('timeout', () => req.destroy(new Error('Request timed out')));
+        req.on('error', reject);
+        req.write(bodyBuffer);
+        req.end();
+    });
+}
+
+module.exports = { IVANTI_URL_BASE, ivantiPost, ivantiMultipartPost, ivantiFormPost };

backend/helpers/jiraApi.js

@@ -0,0 +1,453 @@
+// Shared Jira Data Center REST API helpers
+// Centralizes HTTP calls for Jira issue operations.
+// Follows the same promise-based pattern as atlasApi.js and ivantiApi.js.
+//
+// =========================================================================
+// Charter Jira REST API Compliance
+// =========================================================================
+// Authentication:
+//   - Service accounts use Basic Auth (required for shared integrations).
+//   - PATs require ATLSUP approval and naming convention:
+//     Function - Team - Approved ATLSUP ticket
+//   - SSO must NOT be used for REST API integrations.
+//
+// Rate limiting (Charter-posted):
+//   - 1 440 requests/day max
+//   - Burst cap of 60 requests/minute (accumulates 1 req/idle minute)
+//   - 429 response when limits are hit server-side
+//
+// Automation delays (Charter requirement):
+//   - 1 second delay between GET requests
+//   - 2 second delay between PUT, POST, or DELETE requests
+//
+// Forbidden patterns:
+//   - /rest/api/2/field — must specify fields explicitly in every call
+//   - /rest/api/2/issue/bulk — bulk updates are not allowed
+//   - Single-issue GET loops — use bulk JQL search instead
+//
+// Required patterns:
+//   - All GET requests MUST include a ?fields= parameter
+//   - JQL MUST include at least one of: project+updated, assignee+updated,
+//     status+updated
+//   - JQL should use &updated>=-Xh to only fetch changed issues
+//   - maxResults=1000 for search queries
+//   - Issues must be updated one at a time (no bulk PUT)
+// =========================================================================
+
+const https = require('https');
+const http = require('http');
+
+// ---------------------------------------------------------------------------
+// Configuration — read from process.env at module load
+// ---------------------------------------------------------------------------
+const JIRA_BASE_URL = process.env.JIRA_BASE_URL || '';
+const JIRA_AUTH_METHOD = (process.env.JIRA_AUTH_METHOD || 'basic').toLowerCase();
+const JIRA_API_USER = process.env.JIRA_API_USER || '';
+const JIRA_API_TOKEN = process.env.JIRA_API_TOKEN || '';
+const JIRA_PAT = process.env.JIRA_PAT || '';
+const JIRA_SKIP_TLS = process.env.JIRA_SKIP_TLS === 'true';
+const JIRA_PROJECT_KEY = process.env.JIRA_PROJECT_KEY || '';
+const JIRA_ISSUE_TYPE = process.env.JIRA_ISSUE_TYPE || 'Task';
+
+const requiredVars = JIRA_AUTH_METHOD === 'pat'
+    ? ['JIRA_BASE_URL', 'JIRA_PAT']
+    : ['JIRA_BASE_URL', 'JIRA_API_USER', 'JIRA_API_TOKEN'];
+
+const missingVars = requiredVars.filter((v) => !process.env[v]);
+if (missingVars.length > 0) {
+    console.warn(`[jira-api] WARNING: Missing required environment variables: ${missingVars.join(', ')}. Jira API calls will fail.`);
+}
+
+const isConfigured = missingVars.length === 0;
+
+// ---------------------------------------------------------------------------
+// Default fields — every GET must specify fields explicitly.
+// /rest/api/2/field is forbidden; we define the field list here.
+// ---------------------------------------------------------------------------
+const DEFAULT_FIELDS = [
+    'summary', 'status', 'assignee', 'created', 'updated',
+    'priority', 'issuetype', 'project', 'resolution'
+];
+
+// ---------------------------------------------------------------------------
+// Rate limiter — enforces Charter's posted limits
+// 1 440 events/day, burst of 60 events/minute
+// ---------------------------------------------------------------------------
+const DAILY_LIMIT = 1440;
+const BURST_LIMIT = 60;
+const MINUTE_MS = 60 * 1000;
+const DAY_MS = 24 * 60 * 60 * 1000;
+
+let dailyLog = [];
+let minuteLog = [];
+
+function pruneLog(log, windowMs) {
+    const cutoff = Date.now() - windowMs;
+    while (log.length > 0 && log[0] < cutoff) {
+        log.shift();
+    }
+}
+
+function checkRateLimit() {
+    pruneLog(dailyLog, DAY_MS);
+    pruneLog(minuteLog, MINUTE_MS);
+
+    if (dailyLog.length >= DAILY_LIMIT) {
+        return { allowed: false, reason: `Daily Jira API limit reached (${DAILY_LIMIT}/day). Resets at midnight.` };
+    }
+    if (minuteLog.length >= BURST_LIMIT) {
+        return { allowed: false, reason: `Burst Jira API limit reached (${BURST_LIMIT}/min). Wait and retry.` };
+    }
+    return { allowed: true };
+}
+
+function recordRequest() {
+    const now = Date.now();
+    dailyLog.push(now);
+    minuteLog.push(now);
+}
+
+/**
+ * Return current rate limit usage for diagnostics.
+ */
+function getRateLimitStatus() {
+    pruneLog(dailyLog, DAY_MS);
+    pruneLog(minuteLog, MINUTE_MS);
+    return {
+        daily: { used: dailyLog.length, limit: DAILY_LIMIT, remaining: DAILY_LIMIT - dailyLog.length },
+        burst: { used: minuteLog.length, limit: BURST_LIMIT, remaining: BURST_LIMIT - minuteLog.length }
+    };
+}
+
+// ---------------------------------------------------------------------------
+// Inter-request delay — Charter automation requirements
+// 1s between GETs, 2s between PUT/POST/DELETE
+// ---------------------------------------------------------------------------
+const GET_DELAY_MS = 1000;
+const WRITE_DELAY_MS = 2000;
+
+let lastRequestTime = 0;
+let lastRequestMethod = '';
+
+/**
+ * Wait the required delay before issuing the next request.
+ * GET → 1s, PUT/POST/DELETE → 2s since the previous request.
+ */
+function waitForDelay(method) {
+    const now = Date.now();
+    const requiredDelay = (lastRequestMethod === 'GET') ? GET_DELAY_MS
+        : (lastRequestMethod !== '') ? WRITE_DELAY_MS : 0;
+    const elapsed = now - lastRequestTime;
+    const remaining = requiredDelay - elapsed;
+
+    if (remaining > 0) {
+        return new Promise(resolve => setTimeout(resolve, remaining));
+    }
+    return Promise.resolve();
+}
+
+// ---------------------------------------------------------------------------
+// Blocked endpoint guard
+// ---------------------------------------------------------------------------
+const BLOCKED_PATHS = [
+    '/rest/api/2/field',       // Must specify fields in call, not query field list
+    '/rest/api/2/issue/bulk',  // Bulk updates are not allowed
+];
+
+function isBlockedPath(urlPath) {
+    return BLOCKED_PATHS.some(blocked => urlPath.startsWith(blocked));
+}
+
+// ---------------------------------------------------------------------------
+// Generic request — supports GET, POST, PUT, DELETE
+// Enforces rate limits, inter-request delays, and blocked-path guards.
+// ---------------------------------------------------------------------------
+async function jiraRequest(method, urlPath, body, options) {
+    // Block forbidden endpoints
+    if (isBlockedPath(urlPath)) {
+        return Promise.reject(new Error(`Blocked: ${urlPath} is not allowed per Charter Jira API policy.`));
+    }
+
+    const limit = checkRateLimit();
+    if (!limit.allowed) {
+        return Promise.reject(new Error(limit.reason));
+    }
+
+    // Enforce inter-request delay
+    await waitForDelay(method);
+
+    const timeout = (options && options.timeout) || 15000;
+    const fullUrl = new URL(JIRA_BASE_URL + urlPath);
+    const isHttps = fullUrl.protocol === 'https:';
+    const transport = isHttps ? https : http;
+
+    const headers = {
+        'accept': 'application/json'
+    };
+
+    // Auth header
+    if (JIRA_AUTH_METHOD === 'pat') {
+        headers['authorization'] = 'Bearer ' + JIRA_PAT;
+    } else {
+        const authString = Buffer.from(JIRA_API_USER + ':' + JIRA_API_TOKEN).toString('base64');
+        headers['authorization'] = 'Basic ' + authString;
+    }
+
+    let bodyStr = null;
+    if (body !== null && body !== undefined) {
+        bodyStr = JSON.stringify(body);
+        headers['content-type'] = 'application/json';
+        headers['content-length'] = Buffer.byteLength(bodyStr);
+    }
+
+    recordRequest();
+    lastRequestTime = Date.now();
+    lastRequestMethod = method;
+
+    return new Promise((resolve, reject) => {
+        const reqOptions = {
+            hostname: fullUrl.hostname,
+            port: fullUrl.port || (isHttps ? 443 : 80),
+            path: fullUrl.pathname + fullUrl.search,
+            method: method,
+            headers: headers,
+            timeout: timeout
+        };
+
+        if (isHttps) {
+            reqOptions.rejectUnauthorized = !JIRA_SKIP_TLS;
+        }
+
+        const req = transport.request(reqOptions, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => {
+                if (res.statusCode === 429) {
+                    resolve({ status: 429, body: data, rateLimited: true });
+                } else {
+                    resolve({ status: res.statusCode, body: data });
+                }
+            });
+        });
+
+        req.on('timeout', () => req.destroy(new Error(method + ' ' + urlPath + ' timed out')));
+        req.on('error', (err) => {
+            reject(new Error(method + ' ' + urlPath + ' failed: ' + err.message));
+        });
+
+        if (bodyStr) {
+            req.write(bodyStr);
+        }
+        req.end();
+    });
+}
+
+// ---------------------------------------------------------------------------
+// Convenience wrappers
+// ---------------------------------------------------------------------------
+function jiraGet(urlPath, options) {
+    return jiraRequest('GET', urlPath, null, options);
+}
+
+function jiraPost(urlPath, body, options) {
+    return jiraRequest('POST', urlPath, body, options);
+}
+
+function jiraPut(urlPath, body, options) {
+    return jiraRequest('PUT', urlPath, body, options);
+}
+
+function jiraDelete(urlPath, options) {
+    return jiraRequest('DELETE', urlPath, null, options);
+}
+
+// ---------------------------------------------------------------------------
+// High-level Jira operations — all comply with Charter requirements
+// ---------------------------------------------------------------------------
+
+/**
+ * Fetch a single issue by key using a GET with explicit ?fields= parameter.
+ * Charter requires all GETs to specify fields — /rest/api/2/field is forbidden.
+ *
+ * NOTE: For syncing multiple tickets, prefer searchIssuesByKeys() which uses
+ * a single bulk JQL search instead of one GET per issue.
+ *
+ * @param {string} issueKey - e.g. "VULN-123"
+ * @param {string[]} [fields] - Jira field names to return
+ */
+async function getIssue(issueKey, fields) {
+    const jql = `key = "${issueKey}" AND project = ${JIRA_PROJECT_KEY}`;
+    const result = await searchIssues(jql, { fields: fields || DEFAULT_FIELDS, maxResults: 1, startAt: 0 });
+    if (result.ok && result.data.issues && result.data.issues.length > 0) {
+        return { ok: true, data: result.data.issues[0] };
+    }
+    if (result.ok && (!result.data.issues || result.data.issues.length === 0)) {
+        return { ok: false, status: 404, body: 'Issue not found' };
+    }
+    return result;
+}
+
+/**
+ * Bulk-fetch issues by their keys using a single JQL search.
+ * This is the Charter-compliant way to sync multiple tickets — avoids
+ * querying one issue at a time.
+ *
+ * @param {string[]} issueKeys - Array of Jira issue keys
+ * @param {object} [opts] - { fields, maxResults }
+ */
+async function searchIssuesByKeys(issueKeys, opts) {
+    if (!issueKeys || issueKeys.length === 0) {
+        return { ok: true, data: { total: 0, issues: [] } };
+    }
+
+    // Build JQL: key in (KEY-1, KEY-2, ...) — Charter requires project+updated
+    // or similar, but key-based search is inherently scoped. We add updated
+    // clause for compliance.
+    const keyList = issueKeys.map(k => `"${k}"`).join(', ');
+    const jql = `key in (${keyList}) AND updated >= -72h AND project = ${JIRA_PROJECT_KEY}`;
+    const fields = (opts && opts.fields) || DEFAULT_FIELDS;
+    const maxResults = Math.min((opts && opts.maxResults) || 1000, 1000);
+
+    return searchIssues(jql, { fields, maxResults, startAt: 0 });
+}
+
+/**
+ * Search issues via JQL (POST to /rest/api/2/search).
+ * Charter requirements enforced:
+ *   - fields array is always specified (never omitted)
+ *   - maxResults capped at 1000
+ *
+ * The caller is responsible for including an &updated clause in the JQL
+ * for recurring/scheduled queries.
+ *
+ * @param {string} jql - JQL query string
+ * @param {object} [opts] - { startAt, maxResults, fields }
+ */
+async function searchIssues(jql, opts) {
+    const startAt = (opts && opts.startAt) || 0;
+    const maxResults = Math.min((opts && opts.maxResults) || 1000, 1000);
+    const fields = (opts && opts.fields) || DEFAULT_FIELDS;
+
+    const fieldList = encodeURIComponent(fields.join(','));
+    const encodedJql = encodeURIComponent(jql);
+    const queryString = `?jql=${encodedJql}&fields=${fieldList}&maxResults=${maxResults}&startAt=${startAt}`;
+    const res = await jiraGet('/rest/api/2/search' + queryString);
+    if (res.status === 200) {
+        return { ok: true, data: JSON.parse(res.body) };
+    }
+    return { ok: false, status: res.status, body: res.body, rateLimited: res.rateLimited };
+}
+
+/**
+ * Create a new Jira issue (POST, subject to 2s delay).
+ * @param {object} fields - Jira issue fields object
+ */
+async function createIssue(fields) {
+    const res = await jiraPost('/rest/api/2/issue', { fields });
+    if (res.status === 201) {
+        return { ok: true, data: JSON.parse(res.body) };
+    }
+    return { ok: false, status: res.status, body: res.body, rateLimited: res.rateLimited };
+}
+
+/**
+ * Update a single Jira issue (PUT, subject to 2s delay).
+ * Charter forbids bulk updates — issues must be updated one at a time.
+ * @param {string} issueKey
+ * @param {object} fields - Fields to update
+ */
+async function updateIssue(issueKey, fields) {
+    const res = await jiraPut(
+        `/rest/api/2/issue/${encodeURIComponent(issueKey)}`,
+        { fields }
+    );
+    // Jira returns 204 on successful update
+    if (res.status === 204) {
+        return { ok: true };
+    }
+    return { ok: false, status: res.status, body: res.body, rateLimited: res.rateLimited };
+}
+
+/**
+ * Add a comment to an existing issue (POST, subject to 2s delay).
+ */
+async function addComment(issueKey, commentBody) {
+    const res = await jiraPost(
+        `/rest/api/2/issue/${encodeURIComponent(issueKey)}/comment`,
+        { body: commentBody }
+    );
+    if (res.status === 201) {
+        return { ok: true, data: JSON.parse(res.body) };
+    }
+    return { ok: false, status: res.status, body: res.body, rateLimited: res.rateLimited };
+}
+
+/**
+ * Transition an issue to a new status (POST, subject to 2s delay).
+ * @param {string} issueKey
+ * @param {string} transitionId
+ */
+async function transitionIssue(issueKey, transitionId) {
+    const res = await jiraPost(
+        `/rest/api/2/issue/${encodeURIComponent(issueKey)}/transitions`,
+        { transition: { id: transitionId } }
+    );
+    if (res.status === 204) {
+        return { ok: true };
+    }
+    return { ok: false, status: res.status, body: res.body, rateLimited: res.rateLimited };
+}
+
+/**
+ * Get available transitions for an issue.
+ * Uses GET with explicit fields parameter (transitions endpoint returns
+ * transitions by default, but we include the query param for compliance).
+ */
+async function getTransitions(issueKey) {
+    const res = await jiraGet(
+        `/rest/api/2/issue/${encodeURIComponent(issueKey)}/transitions`
+    );
+    if (res.status === 200) {
+        return { ok: true, data: JSON.parse(res.body) };
+    }
+    return { ok: false, status: res.status, body: res.body, rateLimited: res.rateLimited };
+}
+
+/**
+ * Test connectivity — calls /rest/api/2/myself to verify credentials.
+ * This is a lightweight GET that returns the authenticated user.
+ */
+async function testConnection() {
+    try {
+        const res = await jiraGet('/rest/api/2/myself');
+        if (res.status === 200) {
+            const user = JSON.parse(res.body);
+            return { ok: true, user: { name: user.name, displayName: user.displayName, emailAddress: user.emailAddress } };
+        }
+        return { ok: false, status: res.status, body: res.body };
+    } catch (err) {
+        return { ok: false, error: err.message };
+    }
+}
+
+module.exports = {
+    isConfigured,
+    jiraRequest,
+    jiraGet,
+    jiraPost,
+    jiraPut,
+    jiraDelete,
+    getIssue,
+    searchIssuesByKeys,
+    searchIssues,
+    createIssue,
+    updateIssue,
+    addComment,
+    transitionIssue,
+    getTransitions,
+    testConnection,
+    getRateLimitStatus,
+    DEFAULT_FIELDS,
+    JIRA_PROJECT_KEY,
+    JIRA_ISSUE_TYPE
+};

backend/helpers/teams.js

@@ -0,0 +1,26 @@
+// Shared BU team constants and validation
+// Used by user management routes, auth middleware, and frontend-facing endpoints.
+
+const KNOWN_TEAMS = ['STEAM', 'ACCESS-ENG', 'ACCESS-OPS', 'INTELDEV'];
+
+/**
+ * Parse and validate a comma-separated teams string.
+ * @param {string} teamsString - Comma-separated team identifiers (e.g. 'STEAM,ACCESS-ENG')
+ * @returns {{ valid: boolean, teams: string[], invalid: string[] }}
+ */
+function validateTeams(teamsString) {
+    if (!teamsString || typeof teamsString !== 'string' || teamsString.trim() === '') {
+        return { valid: true, teams: [], invalid: [] };
+    }
+
+    const teams = teamsString.split(',').map(t => t.trim()).filter(Boolean);
+    const invalid = teams.filter(t => !KNOWN_TEAMS.includes(t));
+
+    return {
+        valid: invalid.length === 0,
+        teams,
+        invalid
+    };
+}
+
+module.exports = { KNOWN_TEAMS, validateTeams };

backend/middleware/auth.js

@@ -1,7 +1,8 @@
 // Authentication Middleware
+const pool = require('../db');
 
-// Require authenticated user
-function requireAuth(db) {
+// Require authenticated user — no parameters needed, pool is imported directly
+function requireAuth() {
     return async (req, res, next) => {
         const sessionId = req.cookies?.session_id;
 
@@ -10,19 +11,15 @@ function requireAuth(db) {
         }
 
         try {
-            const session = await new Promise((resolve, reject) => {
-                db.get(
-                    `SELECT s.*, u.id as user_id, u.username, u.email, u.role, u.is_active
-                     FROM sessions s
-                     JOIN users u ON s.user_id = u.id
-                     WHERE s.session_id = ? AND s.expires_at > datetime('now')`,
-                    [sessionId],
-                    (err, row) => {
-                        if (err) reject(err);
-                        else resolve(row);
-                    }
-                );
-            });
+            const { rows } = await pool.query(
+                `SELECT s.*, u.id as user_id, u.username, u.email, u.role, u.user_group, u.bu_teams, u.is_active
+                 FROM sessions s
+                 JOIN users u ON s.user_id = u.id
+                 WHERE s.session_id = $1 AND s.expires_at > NOW()`,
+                [sessionId]
+            );
+
+            const session = rows[0];
 
             if (!session) {
                 return res.status(401).json({ error: 'Session expired or invalid' });
@@ -37,7 +34,9 @@ function requireAuth(db) {
                 id: session.user_id,
                 username: session.username,
                 email: session.email,
-                role: session.role
+                role: session.role,
+                group: session.user_group,
+                teams: session.bu_teams ? session.bu_teams.split(',').filter(Boolean) : []
             };
 
             next();
@@ -48,18 +47,18 @@ function requireAuth(db) {
     };
 }
 
-// Require specific role(s)
-function requireRole(...allowedRoles) {
+// Require specific group(s)
+function requireGroup(...allowedGroups) {
     return (req, res, next) => {
         if (!req.user) {
             return res.status(401).json({ error: 'Authentication required' });
         }
 
-        if (!allowedRoles.includes(req.user.role)) {
+        if (!allowedGroups.includes(req.user.group)) {
             return res.status(403).json({
                 error: 'Insufficient permissions',
-                required: allowedRoles,
-                current: req.user.role
+                required: allowedGroups,
+                current: req.user.group
             });
         }
 
@@ -67,4 +66,4 @@ function requireRole(...allowedRoles) {
     };
 }
 
-module.exports = { requireAuth, requireRole };
+module.exports = { requireAuth, requireGroup };

backend/migrate-audit-log.js

@@ -1,96 +0,0 @@
-#!/usr/bin/env node
-// Migration script: Add audit_logs table
-// Run: node migrate-audit-log.js
-
-const sqlite3 = require('sqlite3').verbose();
-const fs = require('fs');
-
-const DB_FILE = './cve_database.db';
-const BACKUP_FILE = `./cve_database_backup_${Date.now()}.db`;
-
-function run(db, sql, params = []) {
-    return new Promise((resolve, reject) => {
-        db.run(sql, params, function(err) {
-            if (err) reject(err);
-            else resolve(this);
-        });
-    });
-}
-
-function get(db, sql, params = []) {
-    return new Promise((resolve, reject) => {
-        db.get(sql, params, (err, row) => {
-            if (err) reject(err);
-            else resolve(row);
-        });
-    });
-}
-
-async function migrate() {
-    console.log('╔════════════════════════════════════════════════════════╗');
-    console.log('║       CVE Database Migration: Add Audit Logs          ║');
-    console.log('╚════════════════════════════════════════════════════════╝\n');
-
-    if (!fs.existsSync(DB_FILE)) {
-        console.log('❌ Database not found. Run setup.js for fresh install.');
-        process.exit(1);
-    }
-
-    // Backup database
-    console.log('📦 Creating backup...');
-    fs.copyFileSync(DB_FILE, BACKUP_FILE);
-    console.log(`   ✓ Backup saved to: ${BACKUP_FILE}\n`);
-
-    const db = new sqlite3.Database(DB_FILE);
-
-    try {
-        // Check if table already exists
-        const exists = await get(db,
-            "SELECT name FROM sqlite_master WHERE type='table' AND name='audit_logs'"
-        );
-
-        if (exists) {
-            console.log('⏭️  audit_logs table already exists, nothing to do.');
-        } else {
-            console.log('1️⃣  Creating audit_logs table...');
-            await run(db, `
-                CREATE TABLE audit_logs (
-                    id INTEGER PRIMARY KEY AUTOINCREMENT,
-                    user_id INTEGER,
-                    username VARCHAR(50) NOT NULL,
-                    action VARCHAR(50) NOT NULL,
-                    entity_type VARCHAR(50) NOT NULL,
-                    entity_id VARCHAR(100),
-                    details TEXT,
-                    ip_address VARCHAR(45),
-                    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-                )
-            `);
-            console.log('   ✓ Table created');
-
-            console.log('2️⃣  Creating indexes...');
-            await run(db, 'CREATE INDEX IF NOT EXISTS idx_audit_user_id ON audit_logs(user_id)');
-            await run(db, 'CREATE INDEX IF NOT EXISTS idx_audit_action ON audit_logs(action)');
-            await run(db, 'CREATE INDEX IF NOT EXISTS idx_audit_entity_type ON audit_logs(entity_type)');
-            await run(db, 'CREATE INDEX IF NOT EXISTS idx_audit_created_at ON audit_logs(created_at)');
-            console.log('   ✓ Indexes created');
-        }
-
-        console.log('\n╔════════════════════════════════════════════════════════╗');
-        console.log('║            MIGRATION COMPLETE!                         ║');
-        console.log('╚════════════════════════════════════════════════════════╝');
-        console.log('\n📋 Summary:');
-        console.log('   ✓ audit_logs table ready');
-        console.log(`\n💾 Backup saved: ${BACKUP_FILE}`);
-        console.log('\n🚀 Restart your server to apply changes.\n');
-
-    } catch (error) {
-        console.error('\n❌ Migration failed:', error.message);
-        console.log(`\n🔄 To restore from backup: cp ${BACKUP_FILE} ${DB_FILE}`);
-        process.exit(1);
-    } finally {
-        db.close();
-    }
-}
-
-migrate();

backend/migrate-to-1.1.js

@@ -1,289 +0,0 @@
-#!/usr/bin/env node
-// Migration script: v1.0.0 -> v1.1.0
-// Adds: users, sessions tables, multi-vendor support, vendor column in documents
-// Run: node migrate-to-1.1.js
-
-const sqlite3 = require('sqlite3').verbose();
-const bcrypt = require('bcryptjs');
-const fs = require('fs');
-const path = require('path');
-
-const DB_FILE = './cve_database.db';
-const BACKUP_FILE = `./cve_database_backup_${Date.now()}.db`;
-
-async function migrate() {
-    console.log('╔════════════════════════════════════════════════════════╗');
-    console.log('║       CVE Database Migration: v1.0.0 → v1.1.0          ║');
-    console.log('╚════════════════════════════════════════════════════════╝\n');
-
-    // Check if database exists
-    if (!fs.existsSync(DB_FILE)) {
-        console.log('❌ Database not found. Run setup.js for fresh install.');
-        process.exit(1);
-    }
-
-    // Backup database
-    console.log('📦 Creating backup...');
-    fs.copyFileSync(DB_FILE, BACKUP_FILE);
-    console.log(`   ✓ Backup saved to: ${BACKUP_FILE}\n`);
-
-    const db = new sqlite3.Database(DB_FILE);
-
-    try {
-        // Run migrations in sequence
-        await addUsersTable(db);
-        await addSessionsTable(db);
-        await addVendorToDocuments(db);
-        await updateCvesConstraint(db);
-        await createDefaultAdmin(db);
-        await updateView(db);
-
-        console.log('\n╔════════════════════════════════════════════════════════╗');
-        console.log('║            MIGRATION COMPLETE!                         ║');
-        console.log('╚════════════════════════════════════════════════════════╝');
-        console.log('\n📋 Summary:');
-        console.log('   ✓ Users table added');
-        console.log('   ✓ Sessions table added');
-        console.log('   ✓ Vendor column added to documents');
-        console.log('   ✓ Multi-vendor constraint applied to cves');
-        console.log('   ✓ Default admin user created (admin/admin123)');
-        console.log(`\n💾 Backup saved: ${BACKUP_FILE}`);
-        console.log('\n🚀 Restart your server to apply changes.\n');
-
-    } catch (error) {
-        console.error('\n❌ Migration failed:', error.message);
-        console.log(`\n🔄 To restore from backup: cp ${BACKUP_FILE} ${DB_FILE}`);
-        process.exit(1);
-    } finally {
-        db.close();
-    }
-}
-
-function run(db, sql, params = []) {
-    return new Promise((resolve, reject) => {
-        db.run(sql, params, function(err) {
-            if (err) reject(err);
-            else resolve(this);
-        });
-    });
-}
-
-function get(db, sql, params = []) {
-    return new Promise((resolve, reject) => {
-        db.get(sql, params, (err, row) => {
-            if (err) reject(err);
-            else resolve(row);
-        });
-    });
-}
-
-function all(db, sql, params = []) {
-    return new Promise((resolve, reject) => {
-        db.all(sql, params, (err, rows) => {
-            if (err) reject(err);
-            else resolve(rows);
-        });
-    });
-}
-
-async function addUsersTable(db) {
-    console.log('1️⃣  Adding users table...');
-
-    const exists = await get(db,
-        "SELECT name FROM sqlite_master WHERE type='table' AND name='users'"
-    );
-
-    if (exists) {
-        console.log('   ⏭️  Users table already exists, skipping');
-        return;
-    }
-
-    await run(db, `
-        CREATE TABLE users (
-            id INTEGER PRIMARY KEY AUTOINCREMENT,
-            username VARCHAR(50) UNIQUE NOT NULL,
-            email VARCHAR(255) UNIQUE NOT NULL,
-            password_hash VARCHAR(255) NOT NULL,
-            role VARCHAR(20) NOT NULL DEFAULT 'viewer',
-            is_active BOOLEAN DEFAULT 1,
-            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-            last_login TIMESTAMP,
-            CHECK (role IN ('admin', 'editor', 'viewer'))
-        )
-    `);
-
-    await run(db, 'CREATE INDEX IF NOT EXISTS idx_users_username ON users(username)');
-    console.log('   ✓ Users table created');
-}
-
-async function addSessionsTable(db) {
-    console.log('2️⃣  Adding sessions table...');
-
-    const exists = await get(db,
-        "SELECT name FROM sqlite_master WHERE type='table' AND name='sessions'"
-    );
-
-    if (exists) {
-        console.log('   ⏭️  Sessions table already exists, skipping');
-        return;
-    }
-
-    await run(db, `
-        CREATE TABLE sessions (
-            id INTEGER PRIMARY KEY AUTOINCREMENT,
-            session_id VARCHAR(255) UNIQUE NOT NULL,
-            user_id INTEGER NOT NULL,
-            expires_at TIMESTAMP NOT NULL,
-            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-            FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
-        )
-    `);
-
-    await run(db, 'CREATE INDEX IF NOT EXISTS idx_sessions_session_id ON sessions(session_id)');
-    await run(db, 'CREATE INDEX IF NOT EXISTS idx_sessions_user_id ON sessions(user_id)');
-    await run(db, 'CREATE INDEX IF NOT EXISTS idx_sessions_expires ON sessions(expires_at)');
-    console.log('   ✓ Sessions table created');
-}
-
-async function addVendorToDocuments(db) {
-    console.log('3️⃣  Adding vendor column to documents...');
-
-    // Check if vendor column exists
-    const columns = await all(db, "PRAGMA table_info(documents)");
-    const hasVendor = columns.some(col => col.name === 'vendor');
-
-    if (hasVendor) {
-        console.log('   ⏭️  Vendor column already exists, skipping');
-        return;
-    }
-
-    // Add vendor column
-    await run(db, "ALTER TABLE documents ADD COLUMN vendor VARCHAR(100)");
-
-    // Populate vendor from the cves table based on cve_id
-    await run(db, `
-        UPDATE documents
-        SET vendor = (
-            SELECT c.vendor
-            FROM cves c
-            WHERE c.cve_id = documents.cve_id
-            LIMIT 1
-        )
-        WHERE vendor IS NULL
-    `);
-
-    // Set default for any remaining nulls
-    await run(db, "UPDATE documents SET vendor = 'Unknown' WHERE vendor IS NULL");
-
-    await run(db, 'CREATE INDEX IF NOT EXISTS idx_doc_vendor ON documents(vendor)');
-    console.log('   ✓ Vendor column added and populated');
-}
-
-async function updateCvesConstraint(db) {
-    console.log('4️⃣  Updating CVEs table for multi-vendor support...');
-
-    // Check current schema
-    const tableInfo = await get(db,
-        "SELECT sql FROM sqlite_master WHERE type='table' AND name='cves'"
-    );
-
-    if (tableInfo.sql.includes('UNIQUE(cve_id, vendor)')) {
-        console.log('   ⏭️  Multi-vendor constraint already exists, skipping');
-        return;
-    }
-
-    // SQLite doesn't support ALTER CONSTRAINT, so we need to rebuild the table
-    console.log('   📋 Rebuilding table with new constraint...');
-
-    // Create new table with correct schema
-    await run(db, `
-        CREATE TABLE cves_new (
-            id INTEGER PRIMARY KEY AUTOINCREMENT,
-            cve_id VARCHAR(20) NOT NULL,
-            vendor VARCHAR(100) NOT NULL,
-            severity VARCHAR(20) NOT NULL,
-            description TEXT,
-            published_date DATE,
-            status VARCHAR(50) DEFAULT 'Open',
-            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-            updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-            UNIQUE(cve_id, vendor)
-        )
-    `);
-
-    // Copy data
-    await run(db, `
-        INSERT INTO cves_new (id, cve_id, vendor, severity, description, published_date, status, created_at, updated_at)
-        SELECT id, cve_id, vendor, severity, description, published_date, status, created_at, updated_at
-        FROM cves
-    `);
-
-    // Drop old table
-    await run(db, 'DROP TABLE cves');
-
-    // Rename new table
-    await run(db, 'ALTER TABLE cves_new RENAME TO cves');
-
-    // Recreate indexes
-    await run(db, 'CREATE INDEX IF NOT EXISTS idx_cve_id ON cves(cve_id)');
-    await run(db, 'CREATE INDEX IF NOT EXISTS idx_vendor ON cves(vendor)');
-    await run(db, 'CREATE INDEX IF NOT EXISTS idx_severity ON cves(severity)');
-    await run(db, 'CREATE INDEX IF NOT EXISTS idx_status ON cves(status)');
-
-    console.log('   ✓ Multi-vendor constraint applied');
-}
-
-async function createDefaultAdmin(db) {
-    console.log('5️⃣  Creating default admin user...');
-
-    const exists = await get(db, "SELECT id FROM users WHERE username = 'admin'");
-
-    if (exists) {
-        console.log('   ⏭️  Admin user already exists, skipping');
-        return;
-    }
-
-    const passwordHash = await bcrypt.hash('admin123', 10);
-
-    await run(db, `
-        INSERT INTO users (username, email, password_hash, role, is_active)
-        VALUES (?, ?, ?, ?, ?)
-    `, ['admin', 'admin@localhost', passwordHash, 'admin', 1]);
-
-    console.log('   ✓ Admin user created (admin/admin123)');
-}
-
-async function updateView(db) {
-    console.log('6️⃣  Updating document status view...');
-
-    // Drop old view if exists
-    await run(db, 'DROP VIEW IF EXISTS cve_document_status');
-
-    // Create updated view with multi-vendor support
-    await run(db, `
-        CREATE VIEW cve_document_status AS
-        SELECT
-            c.id as record_id,
-            c.cve_id,
-            c.vendor,
-            c.severity,
-            c.status,
-            COUNT(DISTINCT d.id) as total_documents,
-            COUNT(DISTINCT CASE WHEN d.type = 'advisory' THEN d.id END) as advisory_count,
-            COUNT(DISTINCT CASE WHEN d.type = 'email' THEN d.id END) as email_count,
-            COUNT(DISTINCT CASE WHEN d.type = 'screenshot' THEN d.id END) as screenshot_count,
-            CASE
-                WHEN COUNT(DISTINCT CASE WHEN d.type = 'advisory' THEN d.id END) > 0
-                THEN 'Complete'
-                ELSE 'Missing Required Docs'
-            END as compliance_status
-        FROM cves c
-        LEFT JOIN documents d ON c.cve_id = d.cve_id AND c.vendor = d.vendor
-        GROUP BY c.id, c.cve_id, c.vendor, c.severity, c.status
-    `);
-
-    console.log('   ✓ View updated');
-}
-
-// Run migration
-migrate();

backend/migrate_jira_tickets.js

@@ -1,39 +0,0 @@
-// Migration: Add jira_tickets table
-const sqlite3 = require('sqlite3').verbose();
-const path = require('path');
-
-const dbPath = path.join(__dirname, 'cve_database.db');
-const db = new sqlite3.Database(dbPath);
-
-console.log('Starting JIRA tickets migration...');
-
-db.serialize(() => {
-  // Create jira_tickets table
-  db.run(`
-    CREATE TABLE IF NOT EXISTS jira_tickets (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      cve_id TEXT NOT NULL,
-      vendor TEXT NOT NULL,
-      ticket_key TEXT NOT NULL,
-      url TEXT,
-      summary TEXT,
-      status TEXT DEFAULT 'Open' CHECK(status IN ('Open', 'In Progress', 'Closed')),
-      created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-      updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-      FOREIGN KEY (cve_id, vendor) REFERENCES cves(cve_id, vendor) ON DELETE CASCADE
-    )
-  `, (err) => {
-    if (err) console.error('Error creating table:', err);
-    else console.log('✓ jira_tickets table created');
-  });
-
-  // Create indexes
-  db.run('CREATE INDEX IF NOT EXISTS idx_jira_tickets_cve ON jira_tickets(cve_id, vendor)');
-  db.run('CREATE INDEX IF NOT EXISTS idx_jira_tickets_status ON jira_tickets(status)');
-
-  console.log('✓ Indexes created');
-});
-
-db.close(() => {
-  console.log('Migration complete!');
-});

backend/migrate_multivendor.js

@@ -1,128 +0,0 @@
-const sqlite3 = require('sqlite3').verbose();
-const db = new sqlite3.Database('./cve_database.db');
-
-console.log('🔄 Starting database migration for multi-vendor support...\n');
-
-db.serialize(() => {
-    // Backup existing data
-    console.log('📦 Creating backup tables...');
-    db.run(`CREATE TABLE IF NOT EXISTS cves_backup AS SELECT * FROM cves`, (err) => {
-        if (err) console.error('Backup error:', err);
-        else console.log('✓ CVEs backed up');
-    });
-
-    db.run(`CREATE TABLE IF NOT EXISTS documents_backup AS SELECT * FROM documents`, (err) => {
-        if (err) console.error('Backup error:', err);
-        else console.log('✓ Documents backed up');
-    });
-
-    // Drop old table
-    console.log('\n🗑️  Dropping old cves table...');
-    db.run(`DROP TABLE IF EXISTS cves`, (err) => {
-        if (err) {
-            console.error('Drop error:', err);
-            return;
-        }
-        console.log('✓ Old table dropped');
-
-        // Create new table with UNIQUE(cve_id, vendor) instead of UNIQUE(cve_id)
-        console.log('\n🏗️  Creating new cves table with multi-vendor support...');
-        db.run(`
-            CREATE TABLE cves (
-                id INTEGER PRIMARY KEY AUTOINCREMENT,
-                cve_id VARCHAR(20) NOT NULL,
-                vendor VARCHAR(100) NOT NULL,
-                severity VARCHAR(20) NOT NULL,
-                description TEXT,
-                published_date DATE,
-                status VARCHAR(50) DEFAULT 'Open',
-                created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-                updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-                UNIQUE(cve_id, vendor)
-            )
-        `, (err) => {
-            if (err) {
-                console.error('Create error:', err);
-                return;
-            }
-            console.log('✓ New table created with UNIQUE(cve_id, vendor)');
-
-            // Restore data
-            console.log('\n📥 Restoring data...');
-            db.run(`INSERT INTO cves SELECT * FROM cves_backup`, (err) => {
-                if (err) {
-                    console.error('Restore error:', err);
-                    return;
-                }
-                console.log('✓ Data restored');
-
-                // Recreate indexes
-                console.log('\n🔍 Creating indexes...');
-                db.run(`CREATE INDEX idx_cve_id ON cves(cve_id)`, () => {
-                    console.log('✓ Index: idx_cve_id');
-                });
-                db.run(`CREATE INDEX idx_vendor ON cves(vendor)`, () => {
-                    console.log('✓ Index: idx_vendor');
-                });
-                db.run(`CREATE INDEX idx_severity ON cves(severity)`, () => {
-                    console.log('✓ Index: idx_severity');
-                });
-                db.run(`CREATE INDEX idx_status ON cves(status)`, () => {
-                    console.log('✓ Index: idx_status');
-                });
-
-                // Update view
-                console.log('\n👁️  Updating cve_document_status view...');
-                db.run(`DROP VIEW IF EXISTS cve_document_status`, (err) => {
-                    if (err) console.error('Drop view error:', err);
-
-                    db.run(`
-                        CREATE VIEW cve_document_status AS
-                        SELECT 
-                            c.id as record_id,
-                            c.cve_id,
-                            c.vendor,
-                            c.severity,
-                            c.status,
-                            COUNT(DISTINCT d.id) as total_documents,
-                            COUNT(DISTINCT CASE WHEN d.type = 'advisory' THEN d.id END) as advisory_count,
-                            COUNT(DISTINCT CASE WHEN d.type = 'email' THEN d.id END) as email_count,
-                            COUNT(DISTINCT CASE WHEN d.type = 'screenshot' THEN d.id END) as screenshot_count,
-                            CASE 
-                                WHEN COUNT(DISTINCT CASE WHEN d.type = 'advisory' THEN d.id END) > 0 
-                                THEN 'Complete'
-                                ELSE 'Missing Required Docs'
-                            END as compliance_status
-                        FROM cves c
-                        LEFT JOIN documents d ON c.cve_id = d.cve_id AND c.vendor = d.vendor
-                        GROUP BY c.id, c.cve_id, c.vendor, c.severity, c.status
-                    `, (err) => {
-                        if (err) {
-                            console.error('Create view error:', err);
-                        } else {
-                            console.log('✓ View recreated');
-                        }
-
-                        console.log('\n✅ Migration complete!');
-                        console.log('\n📊 Summary:');
-                        
-                        db.get('SELECT COUNT(*) as count FROM cves', (err, row) => {
-                            if (!err) console.log(`   Total CVE entries: ${row.count}`);
-                            
-                            db.get('SELECT COUNT(DISTINCT cve_id) as count FROM cves', (err, row) => {
-                                if (!err) console.log(`   Unique CVE IDs: ${row.count}`);
-                                
-                                console.log('\n💡 Next steps:');
-                                console.log('   1. Restart backend: pkill -f "node server.js" && node server.js &');
-                                console.log('   2. Replace frontend/src/App.js with multi-vendor version');
-                                console.log('   3. Test by adding same CVE with multiple vendors\n');
-                                
-                                db.close();
-                            });
-                        });
-                    });
-                });
-            });
-        });
-    });
-});

backend/migrations/README.md

@@ -0,0 +1,41 @@
+# Database Migrations
+
+These migration scripts were used to evolve the database schema during development. **They are NOT needed for fresh deployments** — `setup.js` contains the complete v1.0.0 schema.
+
+These are retained for reference and for upgrading existing deployments that were set up before v1.0.0.
+
+## Schema Migrations (run in order for existing deployments)
+
+| Script | Purpose |
+|--------|---------|
+| `add_ivanti_sync_table.js` | Creates `ivanti_sync_state` table for tracking Ivanti sync status |
+| `add_ivanti_findings_tables.js` | Creates `ivanti_findings_cache`, `ivanti_finding_notes`, `ivanti_counts_cache`, `ivanti_finding_overrides` tables |
+| `add_ivanti_counts_history_table.js` | Creates `ivanti_counts_history` table for trend chart data |
+| `add_ivanti_todo_queue_table.js` | Creates `ivanti_todo_queue` table for FP/Archer workflow queuing |
+| `add_todo_queue_hostname.js` | Adds `hostname` column to `ivanti_todo_queue` |
+| `add_todo_queue_ip_address.js` | Adds `ip_address` column to `ivanti_todo_queue` |
+| `add_fp_submissions_table.js` | Creates `ivanti_fp_submissions` table for false positive workflow tracking |
+| `add_fp_submission_editing.js` | Adds `lifecycle_status`, `ivanti_workflow_batch_uuid`, `updated_at` columns and `ivanti_fp_submission_history` table |
+| `add_knowledge_base_table.js` | Creates `knowledge_base` table for KB article storage |
+| `add_user_groups.js` | Adds `user_group` column to `users` table with validation triggers |
+| `add_created_by_columns.js` | Adds `created_by` column to `compliance_notes` and `knowledge_base` tables |
+| `add_compliance_tables.js` | Creates `compliance_uploads`, `compliance_items`, `compliance_notes` tables |
+| `add_compliance_notes_group_id.js` | Adds `group_id` column to `compliance_notes` for multi-metric note grouping |
+| `add_archer_tickets_table.js` | Creates `archer_tickets` table for Archer exception tracking |
+| `add_archer_tickets_timestamps.js` | Adds `created_at` and `updated_at` columns to `archer_tickets` |
+| `add_jira_sync_columns.js` | Adds Jira sync-related columns to `jira_tickets` |
+| `add_card_workflow_type.js` | Adds `CARD` to `workflow_type` CHECK constraint on `ivanti_todo_queue` |
+| `add_granite_workflow_type.js` | Adds `GRANITE` to `workflow_type` CHECK constraint on `ivanti_todo_queue` |
+| `add_finding_archive_tables.js` | Creates `ivanti_finding_archives` and `ivanti_archive_transitions` tables |
+| `add_closed_gone_state.js` | Adds `CLOSED_GONE` to `current_state` CHECK constraint on `ivanti_finding_archives` |
+| `add_sync_anomaly_tables.js` | Creates `ivanti_sync_anomaly_log` and `ivanti_finding_bu_history` tables |
+| `add_atlas_action_plans_cache.js` | Creates `atlas_action_plans_cache` table for Atlas API caching |
+| `add_return_classification.js` | Adds `return_classification_json` column to `ivanti_sync_anomaly_log` |
+
+## Data Migrations (one-time backfills)
+
+| Script | Purpose |
+|--------|---------|
+| `backfill_anomaly_log.js` | Synthesizes anomaly log entries from existing archive transitions for historical chart data |
+| `backfill_return_classification.js` | Populates `return_classification_json` for existing anomaly rows with returned findings. Supports `--force` flag to re-run. |
+| `reclassify_bu_roundtrips.js` | Reclassifies archive transitions that were BU reassignment round-trips (archived then returned within 14 days) from the default `severity_score_drift` to `bu_reassignment` |

backend/migrations/add_archer_tickets_timestamps.js

@@ -0,0 +1,56 @@
+// Migration: Add created_at / updated_at columns to archer_tickets
+//
+// SQLite does not support ALTER TABLE ADD COLUMN IF NOT EXISTS, so we check
+// PRAGMA table_info first and only add the column when it is absent.
+//
+// Run on any instance where archer_tickets was created before these columns
+// were added to the schema (symptoms: every /api/archer-tickets call → 500).
+//
+// Usage: node backend/migrations/add_archer_tickets_timestamps.js
+
+const sqlite3 = require('sqlite3').verbose();
+const path    = require('path');
+
+const dbPath = path.join(__dirname, '..', 'cve_database.db');
+const db     = new sqlite3.Database(dbPath);
+
+console.log('Starting archer_tickets timestamp migration...');
+
+db.all('PRAGMA table_info(archer_tickets)', [], (err, columns) => {
+    if (err) {
+        console.error('Error reading table info:', err);
+        return db.close();
+    }
+
+    const names = columns.map(c => c.name);
+
+    db.serialize(() => {
+        if (!names.includes('created_at')) {
+            db.run(
+                `ALTER TABLE archer_tickets ADD COLUMN created_at DATETIME DEFAULT CURRENT_TIMESTAMP`,
+                (err) => {
+                    if (err) console.error('Error adding created_at:', err);
+                    else console.log('✓ created_at column added');
+                }
+            );
+        } else {
+            console.log('✓ created_at already exists — skipping');
+        }
+
+        if (!names.includes('updated_at')) {
+            db.run(
+                `ALTER TABLE archer_tickets ADD COLUMN updated_at DATETIME DEFAULT CURRENT_TIMESTAMP`,
+                (err) => {
+                    if (err) console.error('Error adding updated_at:', err);
+                    else console.log('✓ updated_at column added');
+                }
+            );
+        } else {
+            console.log('✓ updated_at already exists — skipping');
+        }
+    });
+
+    db.close(() => {
+        console.log('Migration complete. Restart the backend server.');
+    });
+});

backend/migrations/add_atlas_action_plans_cache.js

@@ -0,0 +1,37 @@
+// Migration: Add atlas_action_plans_cache table
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+const dbPath = path.join(__dirname, '..', 'cve_database.db');
+const db = new sqlite3.Database(dbPath);
+
+console.log('Starting Atlas action plans cache migration...');
+
+db.serialize(() => {
+    // Cache table — one row per host, holding cached Atlas action plan status
+    db.run(`
+        CREATE TABLE IF NOT EXISTS atlas_action_plans_cache (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            host_id INTEGER NOT NULL UNIQUE,
+            has_action_plan INTEGER NOT NULL DEFAULT 0,
+            plan_count INTEGER NOT NULL DEFAULT 0,
+            plans_json TEXT NOT NULL DEFAULT '[]',
+            synced_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+        )
+    `, (err) => {
+        if (err) console.error('Error creating atlas_action_plans_cache table:', err);
+        else console.log('✓ atlas_action_plans_cache table created');
+    });
+
+    db.run(`
+        CREATE INDEX IF NOT EXISTS idx_atlas_cache_host_id
+        ON atlas_action_plans_cache(host_id)
+    `, (err) => {
+        if (err) console.error('Error creating host_id index:', err);
+        else console.log('✓ idx_atlas_cache_host_id index created');
+    });
+});
+
+db.close(() => {
+    console.log('Migration complete!');
+});

backend/migrations/add_closed_gone_state.js

@@ -0,0 +1,130 @@
+// Migration: Add CLOSED_GONE state to ivanti_finding_archives
+//
+// The archive table tracks findings that disappear from the Open findings set.
+// Previously it only tracked: ARCHIVED → RETURNED → CLOSED.
+//
+// This migration adds a CLOSED_GONE state for findings that were confirmed
+// in the Ivanti Closed set but then disappeared from it on a subsequent sync.
+// This closes a visibility gap where findings could vanish from the Closed API
+// results (e.g., due to VRR rescore below the severity threshold) without
+// being tracked.
+//
+// SQLite does not support ALTER TABLE to modify CHECK constraints, so this
+// migration recreates the table with the expanded constraint.
+//
+// Safe to re-run — uses IF NOT EXISTS and checks for existing data.
+//
+// Usage: node backend/migrations/add_closed_gone_state.js
+
+const path    = require('path');
+const sqlite3 = require('sqlite3').verbose();
+const dbPath  = path.join(__dirname, '..', 'cve_database.db');
+const db      = new sqlite3.Database(dbPath);
+
+console.log('Starting CLOSED_GONE state migration...');
+
+function run(sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.run(sql, params, function (err) {
+            if (err) reject(err);
+            else resolve(this);
+        });
+    });
+}
+
+function all(sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.all(sql, params, (err, rows) => {
+            if (err) reject(err);
+            else resolve(rows || []);
+        });
+    });
+}
+
+async function migrate() {
+    // Check if the table already has the CLOSED_GONE state
+    const tableInfo = await all("SELECT sql FROM sqlite_master WHERE name='ivanti_finding_archives'");
+    if (tableInfo.length > 0 && tableInfo[0].sql.includes('CLOSED_GONE')) {
+        console.log('✓ ivanti_finding_archives already has CLOSED_GONE state — skipping');
+        return;
+    }
+
+    if (tableInfo.length === 0) {
+        // Table doesn't exist yet — create it fresh with the new constraint
+        await run(`
+            CREATE TABLE ivanti_finding_archives (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                finding_id TEXT NOT NULL UNIQUE,
+                finding_title TEXT NOT NULL DEFAULT '',
+                host_name TEXT NOT NULL DEFAULT '',
+                ip_address TEXT NOT NULL DEFAULT '',
+                current_state TEXT NOT NULL CHECK(current_state IN ('ARCHIVED','RETURNED','CLOSED','CLOSED_GONE')),
+                last_severity REAL NOT NULL DEFAULT 0,
+                first_archived_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+                last_transition_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+                created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+            )
+        `);
+        console.log('✓ Created ivanti_finding_archives with CLOSED_GONE state');
+        return;
+    }
+
+    // Table exists but needs the constraint updated — recreate with data migration
+    console.log('  Recreating table with expanded CHECK constraint...');
+
+    await run('BEGIN TRANSACTION');
+    try {
+        // 1. Rename existing table
+        await run('ALTER TABLE ivanti_finding_archives RENAME TO ivanti_finding_archives_old');
+
+        // 2. Create new table with expanded constraint
+        await run(`
+            CREATE TABLE ivanti_finding_archives (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                finding_id TEXT NOT NULL UNIQUE,
+                finding_title TEXT NOT NULL DEFAULT '',
+                host_name TEXT NOT NULL DEFAULT '',
+                ip_address TEXT NOT NULL DEFAULT '',
+                current_state TEXT NOT NULL CHECK(current_state IN ('ARCHIVED','RETURNED','CLOSED','CLOSED_GONE')),
+                last_severity REAL NOT NULL DEFAULT 0,
+                first_archived_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+                last_transition_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+                created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+            )
+        `);
+
+        // 3. Copy data
+        await run(`
+            INSERT INTO ivanti_finding_archives
+                (id, finding_id, finding_title, host_name, ip_address, current_state,
+                 last_severity, first_archived_at, last_transition_at, created_at)
+            SELECT id, finding_id, finding_title, host_name, ip_address, current_state,
+                   last_severity, first_archived_at, last_transition_at, created_at
+            FROM ivanti_finding_archives_old
+        `);
+
+        // 4. Recreate indexes
+        await run('CREATE INDEX IF NOT EXISTS idx_archive_finding_id ON ivanti_finding_archives(finding_id)');
+        await run('CREATE INDEX IF NOT EXISTS idx_archive_current_state ON ivanti_finding_archives(current_state)');
+
+        // 5. Drop old table
+        await run('DROP TABLE ivanti_finding_archives_old');
+
+        await run('COMMIT');
+        console.log('✓ ivanti_finding_archives updated with CLOSED_GONE state');
+    } catch (err) {
+        await run('ROLLBACK').catch(() => {});
+        throw err;
+    }
+}
+
+migrate()
+    .then(() => {
+        console.log('Migration complete.');
+        db.close();
+    })
+    .catch((err) => {
+        console.error('Migration failed:', err);
+        db.close();
+        process.exit(1);
+    });

backend/migrations/add_compliance_notes_group_id.js

@@ -0,0 +1,29 @@
+// Migration: Add group_id column to compliance_notes table
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+const dbPath = path.join(__dirname, '..', 'cve_database.db');
+const db = new sqlite3.Database(dbPath);
+
+console.log('Starting add_compliance_notes_group_id migration...');
+
+db.serialize(() => {
+    db.run(`ALTER TABLE compliance_notes ADD COLUMN group_id TEXT`, (err) => {
+        if (err) console.error('Error adding group_id column:', err);
+        else console.log('✓ group_id column added to compliance_notes');
+    });
+
+    db.run(`CREATE INDEX IF NOT EXISTS idx_compliance_notes_group ON compliance_notes(group_id)`, (err) => {
+        if (err) console.error('Error creating group_id index:', err);
+        else console.log('✓ idx_compliance_notes_group created');
+    });
+
+    db.run(`UPDATE compliance_notes SET group_id = 'legacy-' || id WHERE group_id IS NULL`, (err) => {
+        if (err) console.error('Error backfilling group_id:', err);
+        else console.log('✓ Existing rows backfilled with legacy group_id');
+    });
+});
+
+db.close(() => {
+    console.log('Migration complete!');
+});

backend/migrations/add_created_by_columns.js

@@ -0,0 +1,76 @@
+// Migration: Add created_by column to cves, archer_tickets, and jira_tickets tables
+// Stores the user ID of the creator for ownership-based delete checks.
+// Idempotent — safe to run multiple times.
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+/**
+ * Run the migration against the given database instance.
+ * Exported for testing with in-memory databases.
+ * @param {sqlite3.Database} db
+ * @returns {Promise<void>}
+ */
+function runMigration(db) {
+    return new Promise((resolve, reject) => {
+        const tables = ['cves', 'archer_tickets', 'jira_tickets'];
+        let completed = 0;
+
+        db.serialize(() => {
+            tables.forEach((table) => {
+                db.all(`PRAGMA table_info(${table})`, (err, columns) => {
+                    if (err) {
+                        // Table may not exist yet — skip gracefully
+                        console.log(`⚠ Could not inspect ${table}: ${err.message} — skipping`);
+                        completed++;
+                        if (completed === tables.length) resolve();
+                        return;
+                    }
+
+                    const hasCreatedBy = columns.some(col => col.name === 'created_by');
+
+                    if (hasCreatedBy) {
+                        console.log(`✓ ${table}.created_by already exists — skipping`);
+                        completed++;
+                        if (completed === tables.length) resolve();
+                        return;
+                    }
+
+                    db.run(
+                        `ALTER TABLE ${table} ADD COLUMN created_by INTEGER REFERENCES users(id)`,
+                        (err) => {
+                            if (err) {
+                                reject(err);
+                                return;
+                            }
+                            console.log(`✓ Added created_by column to ${table}`);
+                            completed++;
+                            if (completed === tables.length) resolve();
+                        }
+                    );
+                });
+            });
+        });
+    });
+}
+
+// Run directly if executed as a script
+if (require.main === module) {
+    const dbPath = path.join(__dirname, '..', 'cve_database.db');
+    const db = new sqlite3.Database(dbPath);
+    console.log('Starting add_created_by_columns migration...');
+
+    runMigration(db)
+        .then(() => {
+            console.log('Migration complete!');
+            db.close(() => {
+                console.log('Database connection closed.');
+            });
+        })
+        .catch((err) => {
+            console.error('Migration failed:', err);
+            db.close();
+            process.exit(1);
+        });
+}
+
+module.exports = { runMigration };

backend/migrations/add_decom_workflow_type.js

@@ -0,0 +1,33 @@
+// Migration: Add DECOM to workflow_type CHECK constraint on ivanti_todo_queue
+// Run from backend/: node migrations/add_decom_workflow_type.js
+
+const pool = require('../db');
+
+async function migrate() {
+    console.log('Starting add_decom_workflow_type migration...');
+
+    try {
+        // Drop the existing constraint and add the updated one
+        await pool.query(`
+            ALTER TABLE ivanti_todo_queue
+            DROP CONSTRAINT IF EXISTS ivanti_todo_queue_workflow_type_check
+        `);
+        console.log('✓ Dropped old workflow_type constraint');
+
+        await pool.query(`
+            ALTER TABLE ivanti_todo_queue
+            ADD CONSTRAINT ivanti_todo_queue_workflow_type_check
+            CHECK (workflow_type IN ('FP', 'Archer', 'CARD', 'GRANITE', 'DECOM'))
+        `);
+        console.log('✓ Added updated workflow_type constraint (includes DECOM)');
+
+        console.log('Migration complete!');
+    } catch (err) {
+        console.error('Migration failed:', err.message);
+        process.exit(1);
+    } finally {
+        await pool.end();
+    }
+}
+
+migrate();

backend/migrations/add_finding_archive_tables.js

@@ -0,0 +1,75 @@
+// Migration: Add ivanti_finding_archives and ivanti_archive_transitions tables
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+const dbPath = path.join(__dirname, '..', 'cve_database.db');
+const db = new sqlite3.Database(dbPath);
+
+console.log('Starting finding archive tables migration...');
+
+db.serialize(() => {
+    // Archive records — one row per finding that has entered the archive lifecycle
+    db.run(`
+        CREATE TABLE IF NOT EXISTS ivanti_finding_archives (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            finding_id TEXT NOT NULL UNIQUE,
+            finding_title TEXT NOT NULL DEFAULT '',
+            host_name TEXT NOT NULL DEFAULT '',
+            ip_address TEXT NOT NULL DEFAULT '',
+            current_state TEXT NOT NULL CHECK(current_state IN ('ARCHIVED', 'RETURNED', 'CLOSED')),
+            last_severity REAL NOT NULL DEFAULT 0,
+            first_archived_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            last_transition_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        )
+    `, (err) => {
+        if (err) console.error('Error creating ivanti_finding_archives table:', err);
+        else console.log('✓ ivanti_finding_archives table created');
+    });
+
+    // Transition history — one row per state change on an archive record
+    db.run(`
+        CREATE TABLE IF NOT EXISTS ivanti_archive_transitions (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            archive_id INTEGER NOT NULL,
+            from_state TEXT NOT NULL,
+            to_state TEXT NOT NULL,
+            severity_at_transition REAL NOT NULL DEFAULT 0,
+            reason TEXT NOT NULL DEFAULT '',
+            transitioned_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (archive_id) REFERENCES ivanti_finding_archives(id)
+        )
+    `, (err) => {
+        if (err) console.error('Error creating ivanti_archive_transitions table:', err);
+        else console.log('✓ ivanti_archive_transitions table created');
+    });
+
+    // Indexes for query performance
+    db.run(`
+        CREATE INDEX IF NOT EXISTS idx_archive_finding_id
+        ON ivanti_finding_archives(finding_id)
+    `, (err) => {
+        if (err) console.error('Error creating idx_archive_finding_id:', err);
+        else console.log('✓ idx_archive_finding_id index created');
+    });
+
+    db.run(`
+        CREATE INDEX IF NOT EXISTS idx_archive_current_state
+        ON ivanti_finding_archives(current_state)
+    `, (err) => {
+        if (err) console.error('Error creating idx_archive_current_state:', err);
+        else console.log('✓ idx_archive_current_state index created');
+    });
+
+    db.run(`
+        CREATE INDEX IF NOT EXISTS idx_transition_archive_id
+        ON ivanti_archive_transitions(archive_id)
+    `, (err) => {
+        if (err) console.error('Error creating idx_transition_archive_id:', err);
+        else console.log('✓ idx_transition_archive_id index created');
+    });
+});
+
+db.close(() => {
+    console.log('Migration complete!');
+});

backend/migrations/add_fp_submission_editing.js

@@ -0,0 +1,94 @@
+// Migration: Add FP submission editing support (lifecycle status, batch UUID, history table)
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+const dbPath = path.join(__dirname, '..', 'cve_database.db');
+const db = new sqlite3.Database(dbPath);
+
+console.log('Starting FP submission editing migration...');
+
+db.serialize(() => {
+    // Add lifecycle_status column to ivanti_fp_submissions
+    // Wrapped in try/catch style via callback — SQLite throws if column already exists
+    db.run(
+        `ALTER TABLE ivanti_fp_submissions ADD COLUMN lifecycle_status TEXT NOT NULL DEFAULT 'submitted' CHECK(lifecycle_status IN ('submitted', 'approved', 'rejected', 'rework', 'resubmitted'))`,
+        (err) => {
+            if (err) {
+                if (err.message.includes('duplicate column')) {
+                    console.log('✓ lifecycle_status column already exists');
+                } else {
+                    console.error('Error adding lifecycle_status column:', err.message);
+                }
+            } else {
+                console.log('✓ lifecycle_status column added');
+            }
+        }
+    );
+
+    // Add ivanti_workflow_batch_uuid column
+    db.run(
+        `ALTER TABLE ivanti_fp_submissions ADD COLUMN ivanti_workflow_batch_uuid TEXT`,
+        (err) => {
+            if (err) {
+                if (err.message.includes('duplicate column')) {
+                    console.log('✓ ivanti_workflow_batch_uuid column already exists');
+                } else {
+                    console.error('Error adding ivanti_workflow_batch_uuid column:', err.message);
+                }
+            } else {
+                console.log('✓ ivanti_workflow_batch_uuid column added');
+            }
+        }
+    );
+
+    // Add updated_at column (SQLite requires constant defaults for ALTER TABLE, so default to NULL)
+    db.run(
+        `ALTER TABLE ivanti_fp_submissions ADD COLUMN updated_at DATETIME DEFAULT NULL`,
+        (err) => {
+            if (err) {
+                if (err.message.includes('duplicate column')) {
+                    console.log('✓ updated_at column already exists');
+                } else {
+                    console.error('Error adding updated_at column:', err.message);
+                }
+            } else {
+                console.log('✓ updated_at column added');
+            }
+        }
+    );
+
+    // Create submission history table
+    db.run(`
+        CREATE TABLE IF NOT EXISTS ivanti_fp_submission_history (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            submission_id INTEGER NOT NULL,
+            user_id INTEGER NOT NULL,
+            username TEXT NOT NULL,
+            change_type TEXT NOT NULL CHECK(change_type IN (
+                'created', 'fields_updated', 'findings_added',
+                'attachments_added', 'status_changed'
+            )),
+            change_details_json TEXT,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (submission_id) REFERENCES ivanti_fp_submissions(id) ON DELETE CASCADE
+        )
+    `, (err) => {
+        if (err) console.error('Error creating history table:', err.message);
+        else console.log('✓ ivanti_fp_submission_history table created');
+    });
+
+    // Create index on submission_id for history lookups
+    db.run(
+        `CREATE INDEX IF NOT EXISTS idx_fp_history_submission ON ivanti_fp_submission_history(submission_id)`,
+        (err) => {
+            if (err) console.error('Error creating history index:', err.message);
+            else console.log('✓ idx_fp_history_submission index created');
+        }
+    );
+
+    console.log('✓ Migration statements queued');
+});
+
+db.close(() => {
+    console.log('Migration complete!');
+});

backend/migrations/add_fp_submissions_table.js

@@ -0,0 +1,57 @@
+// Migration: Add ivanti_fp_submissions table
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+const dbPath = path.join(__dirname, '..', 'cve_database.db');
+const db = new sqlite3.Database(dbPath);
+
+console.log('Starting ivanti_fp_submissions migration...');
+
+db.serialize(() => {
+    db.run(`
+        CREATE TABLE IF NOT EXISTS ivanti_fp_submissions (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            user_id INTEGER NOT NULL,
+            username TEXT NOT NULL,
+            ivanti_workflow_batch_id INTEGER,
+            ivanti_generated_id TEXT,
+            workflow_name TEXT NOT NULL,
+            reason TEXT NOT NULL,
+            description TEXT,
+            expiration_date TEXT NOT NULL,
+            scope_override TEXT NOT NULL DEFAULT 'Authorized',
+            finding_ids_json TEXT NOT NULL,
+            queue_item_ids_json TEXT NOT NULL,
+            attachment_count INTEGER DEFAULT 0,
+            attachment_results_json TEXT,
+            status TEXT NOT NULL DEFAULT 'success' CHECK(status IN ('success', 'partial', 'failed')),
+            error_message TEXT,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        )
+    `, (err) => {
+        if (err) console.error('Error creating table:', err);
+        else console.log('✓ ivanti_fp_submissions table created');
+    });
+
+    db.run(
+        'CREATE INDEX IF NOT EXISTS idx_fp_submissions_user ON ivanti_fp_submissions(user_id)',
+        (err) => {
+            if (err) console.error('Error creating index:', err);
+            else console.log('✓ user_id index created');
+        }
+    );
+
+    db.run(
+        'CREATE INDEX IF NOT EXISTS idx_fp_submissions_ivanti_id ON ivanti_fp_submissions(ivanti_generated_id)',
+        (err) => {
+            if (err) console.error('Error creating index:', err);
+            else console.log('✓ ivanti_generated_id index created');
+        }
+    );
+
+    console.log('✓ Migration statements queued');
+});
+
+db.close(() => {
+    console.log('Migration complete!');
+});

backend/migrations/add_granite_workflow_type.js

@@ -0,0 +1,80 @@
+// Migration: Add GRANITE to workflow_type CHECK constraint on ivanti_todo_queue
+// SQLite cannot ALTER a CHECK constraint, so this recreates the table.
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+const dbPath = path.join(__dirname, '..', 'cve_database.db');
+const db = new sqlite3.Database(dbPath);
+
+console.log('Starting add_granite_workflow_type migration...');
+
+db.serialize(() => {
+    db.run('PRAGMA foreign_keys = OFF', (err) => {
+        if (err) console.error('PRAGMA error:', err);
+    });
+
+    db.run('BEGIN TRANSACTION', (err) => {
+        if (err) { console.error('BEGIN error:', err); return; }
+    });
+
+    db.run(`
+        CREATE TABLE ivanti_todo_queue_new (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            user_id INTEGER NOT NULL,
+            finding_id TEXT NOT NULL,
+            finding_title TEXT,
+            cves_json TEXT,
+            ip_address TEXT,
+            hostname TEXT,
+            vendor TEXT NOT NULL,
+            workflow_type TEXT NOT NULL CHECK(workflow_type IN ('FP', 'Archer', 'CARD', 'GRANITE')),
+            status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending', 'complete')),
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
+        )
+    `, (err) => {
+        if (err) console.error('Error creating new table:', err);
+        else console.log('✓ ivanti_todo_queue_new created');
+    });
+
+    db.run(
+        'INSERT INTO ivanti_todo_queue_new SELECT id, user_id, finding_id, finding_title, cves_json, ip_address, hostname, vendor, workflow_type, status, created_at, updated_at FROM ivanti_todo_queue',
+        (err) => {
+            if (err) console.error('Error copying data:', err);
+            else console.log('✓ Data copied');
+        }
+    );
+
+    db.run('DROP TABLE ivanti_todo_queue', (err) => {
+        if (err) console.error('Error dropping old table:', err);
+        else console.log('✓ Old table dropped');
+    });
+
+    db.run(
+        'ALTER TABLE ivanti_todo_queue_new RENAME TO ivanti_todo_queue',
+        (err) => {
+            if (err) console.error('Error renaming table:', err);
+            else console.log('✓ Table renamed');
+        }
+    );
+
+    db.run(
+        'CREATE INDEX IF NOT EXISTS idx_todo_queue_user ON ivanti_todo_queue(user_id, status)',
+        (err) => {
+            if (err) console.error('Error creating index:', err);
+            else console.log('✓ Index recreated');
+        }
+    );
+
+    db.run('COMMIT', (err) => {
+        if (err) console.error('COMMIT error:', err);
+        else console.log('✓ Transaction committed');
+    });
+
+    db.run('PRAGMA foreign_keys = ON', () => {}); // FIXME: Callback does not handle the error parameter (should be `(err) => { if (err) ... }`)
+});
+
+db.close(() => {
+    console.log('Migration complete!');
+});

backend/migrations/add_jira_sync_columns.js

@@ -0,0 +1,63 @@
+// Migration: Add Jira API sync columns to jira_tickets table
+// Adds jira_id, jira_status, and last_synced_at columns to support
+// live synchronization with Jira Data Center REST API.
+// Idempotent — safe to run multiple times.
+
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+const dbPath = path.join(__dirname, '..', 'cve_database.db');
+const db = new sqlite3.Database(dbPath);
+
+console.log('Starting Jira sync columns migration...');
+
+const newColumns = [
+    { name: 'jira_id', sql: 'ALTER TABLE jira_tickets ADD COLUMN jira_id TEXT' },
+    { name: 'jira_status', sql: 'ALTER TABLE jira_tickets ADD COLUMN jira_status TEXT' },
+    { name: 'last_synced_at', sql: 'ALTER TABLE jira_tickets ADD COLUMN last_synced_at DATETIME' }
+];
+
+db.all('PRAGMA table_info(jira_tickets)', (err, columns) => {
+    if (err) {
+        console.error('Could not inspect jira_tickets:', err.message);
+        console.log('Run migrate_jira_tickets.js first to create the table.');
+        db.close();
+        return;
+    }
+
+    const existingNames = new Set(columns.map(c => c.name));
+    let pending = 0;
+
+    db.serialize(() => {
+        newColumns.forEach(({ name, sql }) => {
+            if (existingNames.has(name)) {
+                console.log(`✓ jira_tickets.${name} already exists — skipping`);
+            } else {
+                pending++;
+                db.run(sql, (runErr) => {
+                    if (runErr) {
+                        console.error(`✗ Failed to add ${name}:`, runErr.message);
+                    } else {
+                        console.log(`✓ Added jira_tickets.${name}`);
+                    }
+                    pending--;
+                    if (pending === 0) finish();
+                });
+            }
+        });
+
+        // Create index on jira_id for lookups
+        db.run('CREATE INDEX IF NOT EXISTS idx_jira_tickets_jira_id ON jira_tickets(jira_id)', (idxErr) => {
+            if (idxErr) console.error('Index error:', idxErr.message);
+            else console.log('✓ jira_id index created');
+        });
+
+        if (pending === 0) finish();
+    });
+});
+
+function finish() {
+    db.close(() => {
+        console.log('Migration complete!');
+    });
+}

backend/migrations/add_return_classification.js

@@ -0,0 +1,57 @@
+// Migration: Add return_classification_json column to ivanti_sync_anomaly_log
+//
+// Stores the classification breakdown for returned findings (e.g., how many
+// returned due to BU reassignment back to team, severity re-escalation, etc.)
+//
+// Safe to re-run — uses ALTER TABLE with IF NOT EXISTS pattern.
+//
+// Usage: node backend/migrations/add_return_classification.js
+
+const path    = require('path');
+const sqlite3 = require('sqlite3').verbose();
+const dbPath  = path.join(__dirname, '..', 'cve_database.db');
+const db      = new sqlite3.Database(dbPath);
+
+console.log('Starting return classification migration...');
+
+function run(sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.run(sql, params, function (err) {
+            if (err) reject(err);
+            else resolve(this);
+        });
+    });
+}
+
+function all(sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.all(sql, params, (err, rows) => {
+            if (err) reject(err);
+            else resolve(rows || []);
+        });
+    });
+}
+
+async function migrate() {
+    // Check if column already exists
+    const columns = await all(`PRAGMA table_info(ivanti_sync_anomaly_log)`);
+    const hasColumn = columns.some(c => c.name === 'return_classification_json');
+
+    if (!hasColumn) {
+        await run(`ALTER TABLE ivanti_sync_anomaly_log ADD COLUMN return_classification_json TEXT NOT NULL DEFAULT '{}'`);
+        console.log('✓ Added return_classification_json column to ivanti_sync_anomaly_log');
+    } else {
+        console.log('✓ return_classification_json column already exists — skipping');
+    }
+}
+
+migrate()
+    .then(() => {
+        console.log('Migration complete.');
+        db.close();
+    })
+    .catch((err) => {
+        console.error('Migration failed:', err);
+        db.close();
+        process.exit(1);
+    });

backend/migrations/add_sync_anomaly_tables.js

@@ -0,0 +1,90 @@
+// Migration: Add sync anomaly detection and BU drift monitoring tables
+//
+// Creates two new tables:
+//   - ivanti_sync_anomaly_log — stores one row per sync cycle with the
+//     anomaly summary breakdown (count deltas, classification, significance).
+//   - ivanti_finding_bu_history — records BU change events detected on
+//     individual findings across syncs.
+//
+// Safe to re-run — uses CREATE TABLE IF NOT EXISTS and CREATE INDEX IF NOT EXISTS.
+//
+// Usage: node backend/migrations/add_sync_anomaly_tables.js
+
+const path    = require('path');
+const sqlite3 = require('sqlite3').verbose();
+const dbPath  = path.join(__dirname, '..', 'cve_database.db');
+const db      = new sqlite3.Database(dbPath);
+
+console.log('Starting sync anomaly tables migration...');
+
+function run(sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.run(sql, params, function (err) {
+            if (err) reject(err);
+            else resolve(this);
+        });
+    });
+}
+
+function all(sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.all(sql, params, (err, rows) => {
+            if (err) reject(err);
+            else resolve(rows || []);
+        });
+    });
+}
+
+async function migrate() {
+    // 1. Create ivanti_sync_anomaly_log table
+    await run(`
+        CREATE TABLE IF NOT EXISTS ivanti_sync_anomaly_log (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            sync_timestamp DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            open_count_delta INTEGER NOT NULL DEFAULT 0,
+            closed_count_delta INTEGER NOT NULL DEFAULT 0,
+            newly_archived_count INTEGER NOT NULL DEFAULT 0,
+            returned_count INTEGER NOT NULL DEFAULT 0,
+            classification_json TEXT NOT NULL DEFAULT '{}',
+            is_significant INTEGER NOT NULL DEFAULT 0,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        )
+    `);
+    console.log('✓ ivanti_sync_anomaly_log table ready');
+
+    // 2. Create ivanti_finding_bu_history table
+    await run(`
+        CREATE TABLE IF NOT EXISTS ivanti_finding_bu_history (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            finding_id TEXT NOT NULL,
+            finding_title TEXT NOT NULL DEFAULT '',
+            host_name TEXT NOT NULL DEFAULT '',
+            previous_bu TEXT NOT NULL,
+            new_bu TEXT NOT NULL,
+            detected_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        )
+    `);
+    console.log('✓ ivanti_finding_bu_history table ready');
+
+    // 3. Create indexes
+    await run('CREATE INDEX IF NOT EXISTS idx_anomaly_sync_timestamp ON ivanti_sync_anomaly_log(sync_timestamp)');
+    console.log('✓ idx_anomaly_sync_timestamp index ready');
+
+    await run('CREATE INDEX IF NOT EXISTS idx_bu_history_finding_id ON ivanti_finding_bu_history(finding_id)');
+    console.log('✓ idx_bu_history_finding_id index ready');
+
+    await run('CREATE INDEX IF NOT EXISTS idx_bu_history_detected_at ON ivanti_finding_bu_history(detected_at)');
+    console.log('✓ idx_bu_history_detected_at index ready');
+}
+
+migrate()
+    .then(() => {
+        console.log('Migration complete.');
+        db.close();
+    })
+    .catch((err) => {
+        console.error('Migration failed:', err);
+        db.close();
+        process.exit(1);
+    });

backend/migrations/add_todo_queue_hostname.js

@@ -0,0 +1,25 @@
+// Migration: Add hostname column to ivanti_todo_queue
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+const dbPath = path.join(__dirname, '..', 'cve_database.db');
+const db = new sqlite3.Database(dbPath);
+
+console.log('Starting add_todo_queue_hostname migration...');
+
+db.run(
+    'ALTER TABLE ivanti_todo_queue ADD COLUMN hostname TEXT',
+    (err) => {
+        if (err) {
+            // Column may already exist if migration was run before
+            if (err.message.includes('duplicate column name')) {
+                console.log('✓ hostname column already exists, skipping');
+            } else {
+                console.error('Error adding column:', err);
+            }
+        } else {
+            console.log('✓ hostname column added');
+        }
+        db.close(() => console.log('Migration complete!'));
+    }
+);

backend/migrations/add_user_bu_teams.js

@@ -0,0 +1,68 @@
+// Migration: Add bu_teams column to users table
+// Stores comma-separated BU team identifiers per user (e.g. 'STEAM,ACCESS-ENG')
+// Existing users get empty string (admin must assign teams post-migration)
+// Idempotent — safe to run multiple times
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+const DB_FILE = path.join(__dirname, '..', 'cve_database.db');
+
+/**
+ * Run the migration against the given database instance.
+ * Exported for testing with in-memory databases.
+ * @param {sqlite3.Database} db
+ * @returns {Promise<void>}
+ */
+function runMigration(db) {
+    return new Promise((resolve, reject) => {
+        db.serialize(() => {
+            // Check if bu_teams column already exists
+            db.all("PRAGMA table_info(users)", (err, columns) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+
+                const hasBuTeams = columns.some(col => col.name === 'bu_teams');
+
+                if (hasBuTeams) {
+                    console.log('✓ bu_teams column already exists — skipping migration');
+                    resolve();
+                    return;
+                }
+
+                console.log('Adding bu_teams column to users table...');
+
+                db.run(
+                    `ALTER TABLE users ADD COLUMN bu_teams TEXT NOT NULL DEFAULT ''`,
+                    (err) => {
+                        if (err) {
+                            reject(err);
+                            return;
+                        }
+                        console.log('✓ Added bu_teams column (default: empty string)');
+                        console.log('  Note: Admin must assign teams to existing users via user management UI');
+                        resolve();
+                    }
+                );
+            });
+        });
+    });
+}
+
+// Run directly if executed as a script
+if (require.main === module) {
+    const db = new sqlite3.Database(DB_FILE);
+    runMigration(db)
+        .then(() => {
+            console.log('Migration complete.');
+            db.close();
+        })
+        .catch((err) => {
+            console.error('Migration failed:', err.message);
+            db.close();
+            process.exit(1);
+        });
+}
+
+module.exports = { runMigration };

backend/migrations/add_user_groups.js

@@ -0,0 +1,146 @@
+// Migration: Add user_group column to users table and map legacy roles
+// Mapping: admin→Admin, editor→Standard_User, viewer→Read_Only
+// NULL/unrecognized roles default to Read_Only
+// Idempotent — safe to run multiple times
+const sqlite3 = require('sqlite3').verbose();
+const path = require('path');
+
+/**
+ * Run the migration against the given database instance.
+ * Exported for testing with in-memory databases.
+ * @param {sqlite3.Database} db
+ * @returns {Promise<void>}
+ */
+function runMigration(db) {
+    return new Promise((resolve, reject) => {
+        db.serialize(() => {
+            // Check if user_group column already exists
+            db.all("PRAGMA table_info(users)", (err, columns) => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+
+                const hasUserGroup = columns.some(col => col.name === 'user_group');
+
+                if (hasUserGroup) {
+                    console.log('✓ user_group column already exists — skipping migration');
+                    resolve();
+                    return;
+                }
+
+                console.log('Adding user_group column to users table...');
+
+                // SQLite doesn't support ADD COLUMN with CHECK inline in all versions,
+                // so we add the column first, map values, then recreate with constraint.
+                // However, SQLite also doesn't support ALTER TABLE ADD CONSTRAINT.
+                // Strategy: add column, map values, create index.
+                // The CHECK constraint is enforced via table rebuild.
+
+                db.run(
+                    `ALTER TABLE users ADD COLUMN user_group VARCHAR(20) NOT NULL DEFAULT 'Read_Only'`,
+                    (err) => {
+                        if (err) {
+                            reject(err);
+                            return;
+                        }
+                        console.log('✓ Added user_group column');
+
+                        // Map existing roles to groups
+                        db.run(
+                            `UPDATE users SET user_group = 'Admin' WHERE role = 'admin'`,
+                            function(err) {
+                                if (err) { reject(err); return; }
+                                console.log(`  ✓ Mapped ${this.changes} admin(s) → Admin`);
+
+                                db.run(
+                                    `UPDATE users SET user_group = 'Standard_User' WHERE role = 'editor'`,
+                                    function(err) {
+                                        if (err) { reject(err); return; }
+                                        console.log(`  ✓ Mapped ${this.changes} editor(s) → Standard_User`);
+
+                                        db.run(
+                                            `UPDATE users SET user_group = 'Read_Only' WHERE role = 'viewer'`,
+                                            function(err) {
+                                                if (err) { reject(err); return; }
+                                                console.log(`  ✓ Mapped ${this.changes} viewer(s) → Read_Only`);
+
+                                                // Map NULL or unrecognized roles to Read_Only
+                                                db.run(
+                                                    `UPDATE users SET user_group = 'Read_Only' WHERE user_group = 'Read_Only' AND role NOT IN ('admin', 'editor', 'viewer')`,
+                                                    function(err) {
+                                                        if (err) { reject(err); return; }
+                                                        console.log(`  ✓ Mapped ${this.changes} unrecognized role(s) → Read_Only`);
+
+                                                        // Create index on user_group
+                                                        db.run(
+                                                            `CREATE INDEX IF NOT EXISTS idx_users_user_group ON users(user_group)`,
+                                                            (err) => {
+                                                                if (err) { reject(err); return; }
+                                                                console.log('✓ Created idx_users_user_group index');
+
+                                                                // Add CHECK constraint via trigger (SQLite can't ALTER TABLE ADD CONSTRAINT)
+                                                                db.run(
+                                                                    `CREATE TRIGGER IF NOT EXISTS check_user_group_insert
+                                                                     BEFORE INSERT ON users
+                                                                     FOR EACH ROW
+                                                                     WHEN NEW.user_group NOT IN ('Admin', 'Standard_User', 'Leadership', 'Read_Only')
+                                                                     BEGIN
+                                                                         SELECT RAISE(ABORT, 'Invalid user_group value. Must be Admin, Standard_User, Leadership, or Read_Only');
+                                                                     END`,
+                                                                    (err) => {
+                                                                        if (err) { reject(err); return; }
+                                                                        db.run(
+                                                                            `CREATE TRIGGER IF NOT EXISTS check_user_group_update
+                                                                             BEFORE UPDATE OF user_group ON users
+                                                                             FOR EACH ROW
+                                                                             WHEN NEW.user_group NOT IN ('Admin', 'Standard_User', 'Leadership', 'Read_Only')
+                                                                             BEGIN
+                                                                                 SELECT RAISE(ABORT, 'Invalid user_group value. Must be Admin, Standard_User, Leadership, or Read_Only');
+                                                                             END`,
+                                                                            (err) => {
+                                                                                if (err) { reject(err); return; }
+                                                                                console.log('✓ Created user_group validation triggers');
+                                                                                console.log('Migration complete!');
+                                                                                resolve();
+                                                                            }
+                                                                        );
+                                                                    }
+                                                                );
+                                                            }
+                                                        );
+                                                    }
+                                                );
+                                            }
+                                        );
+                                    }
+                                );
+                            }
+                        );
+                    }
+                );
+            });
+        });
+    });
+}
+
+// Run directly if executed as a script
+if (require.main === module) {
+    const dbPath = path.join(__dirname, '..', 'cve_database.db');
+    const db = new sqlite3.Database(dbPath);
+    console.log('Starting add_user_groups migration...');
+
+    runMigration(db)
+        .then(() => {
+            db.close(() => {
+                console.log('Database connection closed.');
+            });
+        })
+        .catch((err) => {
+            console.error('Migration failed:', err);
+            db.close();
+            process.exit(1);
+        });
+}
+
+module.exports = { runMigration };

backend/migrations/backfill_anomaly_log.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+// backfill_anomaly_log.js — One-time backfill of ivanti_sync_anomaly_log
+//
+// Synthesizes anomaly log entries from existing ivanti_archive_transitions
+// and ivanti_counts_history data so the archive activity sparkline on the
+// Findings Trend chart has historical data to display.
+//
+// Safe to run multiple times — checks for existing rows before inserting.
+//
+// Usage: node backend/migrations/backfill_anomaly_log.js
+
+const path    = require('path');
+const sqlite3 = require('sqlite3').verbose();
+
+const DB_PATH = path.join(__dirname, '..', 'cve_database.db');
+
+function dbAll(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.all(sql, params, (err, rows) => {
+            if (err) reject(err);
+            else resolve(rows || []);
+        });
+    });
+}
+
+function dbGet(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.get(sql, params, (err, row) => {
+            if (err) reject(err);
+            else resolve(row);
+        });
+    });
+}
+
+function dbRun(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.run(sql, params, function (err) {
+            if (err) reject(err);
+            else resolve(this);
+        });
+    });
+}
+
+async function main() {
+    const db = new sqlite3.Database(DB_PATH);
+
+    // Check if anomaly log already has data
+    const existing = await dbGet(db, 'SELECT COUNT(*) as cnt FROM ivanti_sync_anomaly_log');
+    if (existing.cnt > 0) {
+        console.log(`ivanti_sync_anomaly_log already has ${existing.cnt} rows — skipping backfill.`);
+        console.log('To force re-run, delete existing rows first:');
+        console.log('  sqlite3 backend/cve_database.db "DELETE FROM ivanti_sync_anomaly_log;"');
+        db.close();
+        return;
+    }
+
+    // Get archive transitions grouped by date
+    const transitions = await dbAll(db,
+        `SELECT DATE(transitioned_at) as date,
+                to_state,
+                reason,
+                COUNT(*) as cnt
+         FROM ivanti_archive_transitions
+         GROUP BY date, to_state, reason
+         ORDER BY date`
+    );
+
+    // Get counts history (last snapshot per day) for delta computation
+    const countsRows = await dbAll(db,
+        `SELECT date, open_count, closed_count FROM (
+             SELECT DATE(recorded_at) AS date,
+                    open_count, closed_count,
+                    ROW_NUMBER() OVER (
+                        PARTITION BY DATE(recorded_at)
+                        ORDER BY recorded_at DESC
+                    ) AS rn
+             FROM ivanti_counts_history
+         ) WHERE rn = 1
+         ORDER BY date ASC`
+    );
+
+    // Build a map of date -> { open_count, closed_count }
+    const countsMap = {};
+    for (const row of countsRows) {
+        countsMap[row.date] = { open: row.open_count, closed: row.closed_count };
+    }
+
+    // Build per-date anomaly summaries from transitions
+    const dateMap = {};
+    for (const t of transitions) {
+        if (!dateMap[t.date]) {
+            dateMap[t.date] = { archived: 0, returned: 0, classification: {} };
+        }
+        const entry = dateMap[t.date];
+
+        if (t.to_state === 'ARCHIVED') {
+            entry.archived += t.cnt;
+            // All pre-feature transitions have reason 'severity_score_drift'
+            // but from the investigation we know the 04/24 batch was mostly
+            // BU reassignment. We can't retroactively classify without the
+            // Ivanti API, so we label them as 'unclassified' (pre-feature).
+            entry.classification.unclassified = (entry.classification.unclassified || 0) + t.cnt;
+        } else if (t.to_state === 'RETURNED') {
+            entry.returned += t.cnt;
+        }
+        // CLOSED transitions are not archive events — they're findings
+        // confirmed in the closed set, so we don't count them as archived.
+    }
+
+    // Compute deltas and insert rows
+    const dates = Object.keys(dateMap).sort();
+    let inserted = 0;
+
+    for (const date of dates) {
+        const entry = dateMap[date];
+        const counts = countsMap[date];
+
+        // Find the previous day's counts for delta computation
+        const dateIdx = countsRows.findIndex(r => r.date === date);
+        let openDelta = 0;
+        let closedDelta = 0;
+
+        if (counts && dateIdx > 0) {
+            const prev = countsRows[dateIdx - 1];
+            openDelta = counts.open - prev.open_count;
+            closedDelta = counts.closed - prev.closed_count;
+        }
+
+        const isSignificant = entry.archived > 5 ? 1 : 0;
+        const classificationJson = JSON.stringify(entry.classification);
+
+        await dbRun(db,
+            `INSERT INTO ivanti_sync_anomaly_log
+             (sync_timestamp, open_count_delta, closed_count_delta,
+              newly_archived_count, returned_count, classification_json, is_significant)
+             VALUES (?, ?, ?, ?, ?, ?, ?)`,
+            [
+                `${date}T23:59:00`,
+                openDelta,
+                closedDelta,
+                entry.archived,
+                entry.returned,
+                classificationJson,
+                isSignificant,
+            ]
+        );
+        inserted++;
+
+        const sigLabel = isSignificant ? ' [SIGNIFICANT]' : '';
+        console.log(`  ${date}: ${entry.archived} archived, ${entry.returned} returned, delta open=${openDelta} closed=${closedDelta}${sigLabel}`);
+    }
+
+    console.log(`\nBackfill complete: ${inserted} anomaly log entries created.`);
+    db.close();
+}
+
+main().catch(err => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});

backend/migrations/backfill_return_classification.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+// backfill_return_classification.js
+//
+// Retroactively populates return_classification_json for existing anomaly log
+// rows that have returned_count > 0 but an empty return classification.
+//
+// For each such row, looks at archive transitions that went ARCHIVED → RETURNED
+// on that date, then finds the *prior* archive reason (the most recent
+// transition to ARCHIVED for that same archive record) to determine why the
+// finding originally left — which tells us why it came back.
+//
+// Safe to run multiple times — only updates rows with empty classification.
+//
+// Usage: node backend/migrations/backfill_return_classification.js
+
+const path    = require('path');
+const sqlite3 = require('sqlite3').verbose();
+
+const DB_PATH = path.join(__dirname, '..', 'cve_database.db');
+
+function dbAll(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.all(sql, params, (err, rows) => {
+            if (err) reject(err);
+            else resolve(rows || []);
+        });
+    });
+}
+
+function dbGet(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.get(sql, params, (err, row) => {
+            if (err) reject(err);
+            else resolve(row);
+        });
+    });
+}
+
+function dbRun(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.run(sql, params, function (err) {
+            if (err) reject(err);
+            else resolve(this);
+        });
+    });
+}
+
+async function main() {
+    const db = new sqlite3.Database(DB_PATH);
+
+    // Find anomaly log rows that have returned findings but no return classification
+    const rows = await dbAll(db,
+        `SELECT id, sync_timestamp, returned_count, return_classification_json
+         FROM ivanti_sync_anomaly_log
+         WHERE returned_count > 0
+         ORDER BY sync_timestamp ASC`
+    );
+
+    if (rows.length === 0) {
+        console.log('No anomaly log rows with returned findings found — nothing to backfill.');
+        db.close();
+        return;
+    }
+
+    const force = process.argv.includes('--force');
+    let updated = 0;
+    let skipped = 0;
+
+    for (const row of rows) {
+        // Skip if already has a non-empty classification (unless --force)
+        if (!force) {
+            let existing = {};
+            try { existing = JSON.parse(row.return_classification_json || '{}'); } catch (_) {}
+            const hasData = Object.values(existing).some(v => v > 0);
+            if (hasData) {
+                skipped++;
+                continue;
+            }
+        }
+
+        // Find the date of this anomaly row
+        const date = row.sync_timestamp.split('T')[0].split(' ')[0];
+
+        // Find all ARCHIVED → RETURNED transitions on this date
+        const returnTransitions = await dbAll(db,
+            `SELECT archive_id
+             FROM ivanti_archive_transitions
+             WHERE to_state = 'RETURNED'
+               AND DATE(transitioned_at) = ?`,
+            [date]
+        );
+
+        if (returnTransitions.length === 0) {
+            // No transitions found for this date — try a wider window (±1 day)
+            // since sync_timestamp and transitioned_at might not align exactly
+            const wider = await dbAll(db,
+                `SELECT archive_id
+                 FROM ivanti_archive_transitions
+                 WHERE to_state = 'RETURNED'
+                   AND DATE(transitioned_at) BETWEEN DATE(?, '-1 day') AND DATE(?, '+1 day')`,
+                [date, date]
+            );
+            if (wider.length === 0) {
+                console.log(`  ${date}: ${row.returned_count} returned but no matching transitions found — skipping`);
+                continue;
+            }
+            returnTransitions.push(...wider);
+        }
+
+        // For each returned finding, look up the prior archive reason
+        const classification = { bu_reassignment: 0, severity_drift: 0, closed_on_platform: 0, decommissioned: 0 };
+        const seen = new Set();
+
+        for (const rt of returnTransitions) {
+            if (seen.has(rt.archive_id)) continue;
+            seen.add(rt.archive_id);
+
+            // Find the most recent ARCHIVED transition *before* this return
+            // (the reason it was archived before it came back)
+            const archiveTransition = await dbGet(db,
+                `SELECT reason FROM ivanti_archive_transitions
+                 WHERE archive_id = ? AND to_state = 'ARCHIVED'
+                   AND transitioned_at <= (
+                       SELECT transitioned_at FROM ivanti_archive_transitions
+                       WHERE archive_id = ? AND to_state = 'RETURNED'
+                         AND DATE(transitioned_at) BETWEEN DATE(?, '-1 day') AND DATE(?, '+1 day')
+                       ORDER BY transitioned_at DESC LIMIT 1
+                   )
+                 ORDER BY transitioned_at DESC LIMIT 1`,
+                [rt.archive_id, rt.archive_id, date, date]
+            );
+
+            if (archiveTransition && archiveTransition.reason) {
+                const reasonKey = archiveTransition.reason.split(':')[0];
+                if (reasonKey in classification) {
+                    classification[reasonKey]++;
+                }
+            }
+        }
+
+        const classificationJson = JSON.stringify(classification);
+        await dbRun(db,
+            `UPDATE ivanti_sync_anomaly_log
+             SET return_classification_json = ?
+             WHERE id = ?`,
+            [classificationJson, row.id]
+        );
+
+        const parts = Object.entries(classification)
+            .filter(([, v]) => v > 0)
+            .map(([k, v]) => `${v} ${k}`);
+        const breakdown = parts.length > 0 ? parts.join(', ') : 'unclassified';
+
+        console.log(`  ${date}: ${row.returned_count} returned — ${breakdown}`);
+        updated++;
+    }
+
+    console.log(`\nBackfill complete: ${updated} rows updated, ${skipped} already had data.`);
+    db.close();
+}
+
+main().catch(err => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});

backend/migrations/reclassify_bu_roundtrips.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+// reclassify_bu_roundtrips.js
+//
+// Reclassifies archive transitions that were part of a BU reassignment
+// round-trip. These are findings that were archived (disappeared from sync)
+// and then returned within a short window — indicating they were temporarily
+// reassigned to a different BU and then reassigned back.
+//
+// The original drift checker couldn't classify these correctly because by the
+// time it queried Ivanti, the findings had already been reassigned back to
+// the expected BUs.
+//
+// After running this, re-run backfill_return_classification.js to update
+// the anomaly log with the corrected reasons.
+//
+// Usage: node backend/migrations/reclassify_bu_roundtrips.js
+
+const path    = require('path');
+const sqlite3 = require('sqlite3').verbose();
+
+const DB_PATH = path.join(__dirname, '..', 'cve_database.db');
+
+// Findings that were archived and returned within this many days are
+// considered BU reassignment round-trips
+const ROUNDTRIP_WINDOW_DAYS = 14;
+
+function dbAll(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.all(sql, params, (err, rows) => {
+            if (err) reject(err);
+            else resolve(rows || []);
+        });
+    });
+}
+
+function dbRun(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.run(sql, params, function (err) {
+            if (err) reject(err);
+            else resolve(this);
+        });
+    });
+}
+
+async function main() {
+    const db = new sqlite3.Database(DB_PATH);
+
+    // Find archive transitions where the finding was archived and then returned
+    // within the roundtrip window, and the archive reason is still the default
+    // severity_score_drift placeholder
+    const roundtrips = await dbAll(db, `
+        SELECT
+            t_arch.id AS archive_transition_id,
+            t_arch.archive_id,
+            a.finding_id,
+            a.finding_title,
+            t_arch.reason AS current_reason,
+            DATE(t_arch.transitioned_at) AS archived_date,
+            DATE(t_ret.transitioned_at) AS returned_date,
+            JULIANDAY(t_ret.transitioned_at) - JULIANDAY(t_arch.transitioned_at) AS days_between
+        FROM ivanti_archive_transitions t_arch
+        JOIN ivanti_finding_archives a ON a.id = t_arch.archive_id
+        JOIN ivanti_archive_transitions t_ret
+            ON t_ret.archive_id = t_arch.archive_id
+            AND t_ret.to_state = 'RETURNED'
+            AND t_ret.transitioned_at > t_arch.transitioned_at
+        WHERE t_arch.to_state = 'ARCHIVED'
+          AND t_arch.reason = 'severity_score_drift'
+          AND (JULIANDAY(t_ret.transitioned_at) - JULIANDAY(t_arch.transitioned_at)) BETWEEN 0 AND ?
+        ORDER BY t_arch.transitioned_at DESC
+    `, [ROUNDTRIP_WINDOW_DAYS]);
+
+    if (roundtrips.length === 0) {
+        console.log('No BU reassignment round-trips found to reclassify.');
+        db.close();
+        return;
+    }
+
+    console.log(`Found ${roundtrips.length} archive transitions to reclassify as bu_reassignment:\n`);
+
+    let updated = 0;
+    for (const rt of roundtrips) {
+        console.log(`  Finding ${rt.finding_id}: archived ${rt.archived_date}, returned ${rt.returned_date} (${Math.round(rt.days_between)}d) — ${rt.current_reason} → bu_reassignment`);
+
+        await dbRun(db,
+            `UPDATE ivanti_archive_transitions SET reason = 'bu_reassignment' WHERE id = ?`,
+            [rt.archive_transition_id]
+        );
+        updated++;
+    }
+
+    console.log(`\nReclassified ${updated} transitions.`);
+    console.log('\nNow run the return classification backfill to update anomaly log rows:');
+    console.log('  node backend/migrations/backfill_return_classification.js');
+
+    db.close();
+}
+
+main().catch(err => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});

backend/migrations/run-all.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+// Run all Postgres-compatible migrations in order.
+// Each migration is idempotent (safe to re-run).
+// Used by CI/CD pipeline during deploy to ensure schema is up to date.
+//
+// Usage: cd backend && node migrations/run-all.js
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const MIGRATIONS_DIR = __dirname;
+
+// Only run migrations that use the Postgres pool (not legacy SQLite ones).
+// Add new migrations to this list as they're created.
+const POSTGRES_MIGRATIONS = [
+    'add_decom_workflow_type.js',
+];
+
+async function runAll() {
+    console.log(`[Migrations] Running ${POSTGRES_MIGRATIONS.length} Postgres migration(s)...`);
+    let succeeded = 0;
+    let failed = 0;
+
+    for (const file of POSTGRES_MIGRATIONS) {
+        const fullPath = path.join(MIGRATIONS_DIR, file);
+        if (!fs.existsSync(fullPath)) {
+            console.error(`  [FAIL] ${file}: file not found`);
+            failed++;
+            continue;
+        }
+
+        try {
+            console.log(`  [run]  ${file}`);
+            execSync(`node ${fullPath}`, {
+                cwd: path.join(MIGRATIONS_DIR, '..'),
+                stdio: 'inherit',
+                timeout: 30000,
+            });
+            succeeded++;
+        } catch (err) {
+            console.error(`  [FAIL] ${file}: exit code ${err.status}`);
+            failed++;
+        }
+    }
+
+    console.log(`[Migrations] Done: ${succeeded} applied, ${failed} failed`);
+    if (failed > 0) process.exit(1);
+}
+
+runAll();

backend/routes/archerTickets.js

@@ -1,6 +1,7 @@
 // routes/archerTickets.js
 const express = require('express');
-const { requireAuth, requireRole } = require('../middleware/auth');
+const pool = require('../db');
+const { requireAuth, requireGroup } = require('../middleware/auth');
 const logAudit = require('../helpers/auditLog');
 
 // Validation helpers
@@ -13,42 +14,43 @@ function isValidVendor(vendor) {
   return typeof vendor === 'string' && vendor.trim().length > 0 && vendor.length <= 200;
 }
 
-function createArcherTicketsRouter(db) {
+function createArcherTicketsRouter() {
   const router = express.Router();
 
   // Get all Archer tickets (with optional filters)
-  router.get('/', requireAuth(db), (req, res) => {
+  router.get('/', requireAuth(), async (req, res) => {
     const { cve_id, vendor, status } = req.query;
 
     let query = 'SELECT * FROM archer_tickets WHERE 1=1';
     const params = [];
+    let paramIndex = 1;
 
     if (cve_id) {
-      query += ' AND cve_id = ?';
+      query += ` AND cve_id = $${paramIndex++}`;
       params.push(cve_id);
     }
     if (vendor) {
-      query += ' AND vendor = ?';
+      query += ` AND vendor = $${paramIndex++}`;
       params.push(vendor);
     }
     if (status) {
-      query += ' AND status = ?';
+      query += ` AND status = $${paramIndex++}`;
       params.push(status);
     }
 
     query += ' ORDER BY created_at DESC';
 
-    db.all(query, params, (err, rows) => {
-      if (err) {
-        console.error('Error fetching Archer tickets:', err);
-        return res.status(500).json({ error: 'Internal server error.' });
-      }
+    try {
+      const { rows } = await pool.query(query, params);
       res.json(rows);
-    });
+    } catch (err) {
+      console.error('Error fetching Archer tickets:', err);
+      res.status(500).json({ error: 'Internal server error.' });
+    }
   });
 
   // Create Archer ticket
-  router.post('/', requireAuth(db), requireRole('editor', 'admin'), (req, res) => {
+  router.post('/', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
     const { exc_number, archer_url, status, cve_id, vendor } = req.body;
 
     // Validation
@@ -73,38 +75,38 @@ function createArcherTicketsRouter(db) {
 
     const validatedStatus = status || 'Draft';
 
-    db.run(
-      `INSERT INTO archer_tickets (exc_number, archer_url, status, cve_id, vendor)
-       VALUES (?, ?, ?, ?, ?)`,
-      [exc_number.trim(), archer_url || null, validatedStatus, cve_id, vendor],
-      function(err) {
-        if (err) {
-          console.error('Error creating Archer ticket:', err);
-          if (err.message.includes('UNIQUE constraint failed')) {
-            return res.status(409).json({ error: 'An Archer ticket with this EXC number already exists.' });
-          }
-          return res.status(500).json({ error: 'Internal server error.' });
-        }
+    try {
+      const { rows } = await pool.query(
+        `INSERT INTO archer_tickets (exc_number, archer_url, status, cve_id, vendor, created_by)
+         VALUES ($1, $2, $3, $4, $5, $6)
+         RETURNING id`,
+        [exc_number.trim(), archer_url || null, validatedStatus, cve_id, vendor, req.user.id]
+      );
 
-        logAudit(db, {
-          userId: req.user.id,
-          action: 'CREATE_ARCHER_TICKET',
-          targetType: 'archer_ticket',
-          targetId: this.lastID,
-          details: { exc_number, archer_url, status: validatedStatus, cve_id, vendor },
-          ipAddress: req.ip
-        });
+      logAudit({
+        userId: req.user.id,
+        action: 'CREATE_ARCHER_TICKET',
+        entityType: 'archer_ticket',
+        entityId: String(rows[0].id),
+        details: { exc_number, archer_url, status: validatedStatus, cve_id, vendor },
+        ipAddress: req.ip
+      });
 
-        res.status(201).json({
-          id: this.lastID,
-          message: 'Archer ticket created successfully'
-        });
+      res.status(201).json({
+        id: rows[0].id,
+        message: 'Archer ticket created successfully'
+      });
+    } catch (err) {
+      console.error('Error creating Archer ticket:', err);
+      if (err.code === '23505') {
+        return res.status(409).json({ error: 'An Archer ticket with this EXC number already exists.' });
       }
-    );
+      res.status(500).json({ error: 'Internal server error.' });
+    }
   });
 
   // Update Archer ticket
-  router.put('/:id', requireAuth(db), requireRole('editor', 'admin'), (req, res) => {
+  router.put('/:id', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
     const { id } = req.params;
     const { exc_number, archer_url, status } = req.body;
 
@@ -124,29 +126,27 @@ function createArcherTicketsRouter(db) {
       return res.status(400).json({ error: 'Invalid status. Must be Draft, Open, Under Review, or Accepted.' });
     }
 
-    // Get existing ticket
-    db.get('SELECT * FROM archer_tickets WHERE id = ?', [id], (err, existing) => {
-      if (err) {
-        console.error(err);
-        return res.status(500).json({ error: 'Internal server error.' });
-      }
+    try {
+      const { rows } = await pool.query('SELECT * FROM archer_tickets WHERE id = $1', [id]);
+      const existing = rows[0];
       if (!existing) {
         return res.status(404).json({ error: 'Archer ticket not found.' });
       }
 
       const updates = [];
       const params = [];
+      let paramIndex = 1;
 
       if (exc_number !== undefined) {
-        updates.push('exc_number = ?');
+        updates.push(`exc_number = $${paramIndex++}`);
         params.push(exc_number.trim());
       }
       if (archer_url !== undefined) {
-        updates.push('archer_url = ?');
+        updates.push(`archer_url = $${paramIndex++}`);
         params.push(archer_url || null);
       }
       if (status !== undefined) {
-        updates.push('status = ?');
+        updates.push(`status = $${paramIndex++}`);
         params.push(status);
       }
 
@@ -154,86 +154,113 @@ function createArcherTicketsRouter(db) {
         return res.status(400).json({ error: 'No fields to update.' });
       }
 
-      updates.push('updated_at = CURRENT_TIMESTAMP');
+      updates.push('updated_at = NOW()');
       params.push(id);
 
-      db.run(
-        `UPDATE archer_tickets SET ${updates.join(', ')} WHERE id = ?`,
-        params,
-        function(err) {
-          if (err) {
-            console.error(err);
-            if (err.message.includes('UNIQUE constraint failed')) {
-              return res.status(409).json({ error: 'An Archer ticket with this EXC number already exists.' });
-            }
-            return res.status(500).json({ error: 'Internal server error.' });
-          }
-
-          logAudit(db, {
-            userId: req.user.id,
-            action: 'UPDATE_ARCHER_TICKET',
-            targetType: 'archer_ticket',
-            targetId: id,
-            details: { before: existing, changes: req.body },
-            ipAddress: req.ip
-          });
-
-          res.json({ message: 'Archer ticket updated successfully', changes: this.changes });
-        }
+      const result = await pool.query(
+        `UPDATE archer_tickets SET ${updates.join(', ')} WHERE id = $${paramIndex}`,
+        params
       );
-    });
+
+      logAudit({
+        userId: req.user.id,
+        action: 'UPDATE_ARCHER_TICKET',
+        entityType: 'archer_ticket',
+        entityId: String(id),
+        details: { before: existing, changes: req.body },
+        ipAddress: req.ip
+      });
+
+      res.json({ message: 'Archer ticket updated successfully', changes: result.rowCount });
+    } catch (err) {
+      console.error(err);
+      if (err.code === '23505') {
+        return res.status(409).json({ error: 'An Archer ticket with this EXC number already exists.' });
+      }
+      res.status(500).json({ error: 'Internal server error.' });
+    }
   });
 
   // Delete Archer ticket
-  router.delete('/:id', requireAuth(db), requireRole('editor', 'admin'), (req, res) => {
+  router.delete('/:id', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
     const { id } = req.params;
 
-    db.get('SELECT * FROM archer_tickets WHERE id = ?', [id], (err, ticket) => {
-      if (err) {
-        console.error(err);
-        return res.status(500).json({ error: 'Internal server error.' });
-      }
+    try {
+      const { rows } = await pool.query('SELECT * FROM archer_tickets WHERE id = $1', [id]);
+      const ticket = rows[0];
       if (!ticket) {
         return res.status(404).json({ error: 'Archer ticket not found.' });
       }
 
-      db.run('DELETE FROM archer_tickets WHERE id = ?', [id], function(err) {
-        if (err) {
-          console.error(err);
-          return res.status(500).json({ error: 'Internal server error.' });
-        }
+      // Admin bypasses all delete restrictions
+      if (req.user.group === 'Admin') {
+        return performArcherDelete();
+      }
 
-        logAudit(db, {
+      // Standard_User: ownership check
+      if (ticket.created_by && ticket.created_by !== req.user.id) {
+        return res.status(403).json({ error: 'You can only delete resources you created' });
+      }
+
+      // Standard_User: compliance linkage check
+      const excNumber = ticket.exc_number;
+      try {
+        const { rows: compLinks } = await pool.query(
+          `SELECT ci.id, ci.extra_json
+           FROM compliance_items ci
+           JOIN compliance_uploads cu ON ci.upload_id = cu.id
+           WHERE ci.status = 'active' AND ci.extra_json ILIKE $1`,
+          [`%${excNumber}%`]
+        );
+
+        const isLinked = (compLinks || []).some(cl => {
+          const json = cl.extra_json || '';
+          return json.includes(excNumber);
+        });
+
+        if (isLinked) {
+          return res.status(403).json({ error: 'Cannot delete ticket linked to compliance report. Contact an admin.' });
+        }
+      } catch (compErr) {
+        if (!compErr.message.includes('does not exist')) throw compErr;
+      }
+
+      return performArcherDelete();
+
+      async function performArcherDelete() {
+        await pool.query('DELETE FROM archer_tickets WHERE id = $1', [id]);
+
+        logAudit({
           userId: req.user.id,
           action: 'DELETE_ARCHER_TICKET',
-          targetType: 'archer_ticket',
-          targetId: id,
+          entityType: 'archer_ticket',
+          entityId: String(id),
           details: { deleted: ticket },
           ipAddress: req.ip
         });
 
         res.json({ message: 'Archer ticket deleted successfully' });
-      });
-    });
+      }
+    } catch (err) {
+      console.error(err);
+      res.status(500).json({ error: 'Internal server error.' });
+    }
   });
 
   // GET /status-trend — ticket counts grouped by creation date + status
-  // Used for time-based Archer pipeline chart on the Compliance page.
-  router.get('/status-trend', requireAuth(db), (req, res) => {
-    db.all(
-      `SELECT DATE(created_at) AS date, status, COUNT(*) AS count
-       FROM archer_tickets
-       GROUP BY DATE(created_at), status
-       ORDER BY date ASC`,
-      [],
-      (err, rows) => {
-        if (err) {
-          console.error('Error fetching Archer status trend:', err);
-          return res.status(500).json({ error: 'Internal server error.' });
-        }
-        res.json({ statusTrend: rows });
-      }
-    );
+  router.get('/status-trend', requireAuth(), async (req, res) => {
+    try {
+      const { rows } = await pool.query(
+        `SELECT DATE(created_at) AS date, status, COUNT(*) AS count
+         FROM archer_tickets
+         GROUP BY DATE(created_at), status
+         ORDER BY date ASC`
+      );
+      res.json({ statusTrend: rows });
+    } catch (err) {
+      console.error('Error fetching Archer status trend:', err);
+      res.status(500).json({ error: 'Internal server error.' });
+    }
   });
 
   return router;

backend/routes/atlas.js

@@ -0,0 +1,638 @@
+// Atlas InfoSec Action Plans Routes
+// Proxies CRUD operations to the Atlas API and maintains a local cache
+// for fast badge rendering on the ReportingPage.
+
+const express = require('express');
+const pool = require('../db');
+const { requireAuth, requireGroup } = require('../middleware/auth');
+const logAudit = require('../helpers/auditLog');
+const { isConfigured, atlasGet, atlasPut, atlasPatch, atlasPost } = require('../helpers/atlasApi');
+
+const fs = require('fs');
+const path = require('path');
+
+const VALID_PLAN_TYPES = ['decommission', 'remediation', 'false_positive', 'risk_acceptance', 'scan_exclusion'];
+const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+
+// Diagnostic log helper
+function syncLog(msg) {
+    const line = `${new Date().toISOString()} ${msg}\n`;
+    try { fs.appendFileSync(path.join(__dirname, '..', 'atlas-sync-debug.log'), line); } catch (_) { /* ignore */ }
+    console.log(msg);
+}
+
+// ---------------------------------------------------------------------------
+// Pure aggregation function — exported for testability
+// ---------------------------------------------------------------------------
+function aggregateAtlasMetrics(rows) {
+    const result = {
+        totalHosts: rows.length,
+        hostsWithPlans: 0,
+        hostsWithoutPlans: 0,
+        plansByType: {},
+        plansByStatus: {},
+        totalPlans: 0
+    };
+
+    for (const row of rows) {
+        if (row.has_action_plan === true || row.has_action_plan === 1) {
+            result.hostsWithPlans++;
+        } else {
+            result.hostsWithoutPlans++;
+        }
+
+        let plans;
+        try {
+            plans = JSON.parse(row.plans_json);
+        } catch (e) {
+            continue;
+        }
+
+        if (!Array.isArray(plans)) continue;
+
+        for (const plan of plans) {
+            result.totalPlans++;
+            if (plan.plan_type) {
+                result.plansByType[plan.plan_type] = (result.plansByType[plan.plan_type] || 0) + 1;
+            }
+            if (plan.status) {
+                result.plansByStatus[plan.status] = (result.plansByStatus[plan.status] || 0) + 1;
+            }
+        }
+    }
+
+    return result;
+}
+
+// ---------------------------------------------------------------------------
+// Router factory
+// ---------------------------------------------------------------------------
+function createAtlasRouter() {
+    const router = express.Router();
+
+    /**
+     * GET /metrics
+     *
+     * Returns aggregated Atlas action plan metrics from the local cache.
+     *
+     * @returns {Object} 200 - { totalHosts, hostsWithPlans, hostsWithoutPlans, plansByType, plansByStatus, totalPlans }
+     * @returns {Object} 503 - { error } when Atlas API is not configured
+     * @returns {Object} 500 - { error } on database failure
+     */
+    router.get('/metrics', requireAuth(), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'Atlas API is not configured. Check ATLAS_API_URL, ATLAS_API_USER, and ATLAS_API_PASS environment variables.' });
+        }
+
+        try {
+            const { rows } = await pool.query(
+                `SELECT has_action_plan, plans_json FROM atlas_action_plans_cache`
+            );
+            const metrics = aggregateAtlasMetrics(rows);
+            res.json(metrics);
+        } catch (err) {
+            console.error('[Atlas] Error fetching metrics:', err.message);
+            res.status(500).json({ error: 'Failed to fetch Atlas metrics.' });
+        }
+    });
+
+    /**
+     * GET /status
+     *
+     * Returns the full atlas_action_plans_cache table contents for status display.
+     *
+     * @returns {Array} 200 - Array of { host_id, has_action_plan, plan_count, plans_json, synced_at }
+     * @returns {Object} 503 - { error } when Atlas API is not configured
+     * @returns {Object} 500 - { error } on database failure
+     */
+    router.get('/status', requireAuth(), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'Atlas API is not configured. Check ATLAS_API_URL, ATLAS_API_USER, and ATLAS_API_PASS environment variables.' });
+        }
+
+        try {
+            const { rows } = await pool.query(
+                `SELECT host_id, has_action_plan, plan_count, plans_json, synced_at FROM atlas_action_plans_cache`
+            );
+            res.json(rows);
+        } catch (err) {
+            console.error('[Atlas] Error fetching status:', err.message);
+            res.status(500).json({ error: 'Failed to fetch Atlas status.' });
+        }
+    });
+
+    /**
+     * POST /sync
+     *
+     * Syncs action plan data from Atlas for all hosts found in ivanti_findings.
+     * Fetches plans per host in batches of 5 and upserts into the local cache.
+     * Requires Admin or Standard_User group.
+     *
+     * @returns {Object} 200 - { synced, withPlans, failed }
+     * @returns {Object} 503 - { error } when Atlas API is not configured
+     * @returns {Object} 500 - { error } on unexpected failure
+     */
+    router.post('/sync', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'Atlas API is not configured. Check ATLAS_API_URL, ATLAS_API_USER, and ATLAS_API_PASS environment variables.' });
+        }
+
+        try {
+            // Read Ivanti findings and extract unique non-null hostIds
+            const { rows: findingsRows } = await pool.query(
+                `SELECT DISTINCT host_id FROM ivanti_findings WHERE host_id IS NOT NULL AND host_id > 0`
+            );
+            const hostIds = findingsRows.map(r => r.host_id);
+
+            if (hostIds.length === 0) {
+                return res.json({ synced: 0, withPlans: 0, failed: 0 });
+            }
+
+            let synced = 0;
+            let withPlans = 0;
+            let failed = 0;
+            const BATCH_SIZE = 5;
+
+            for (let i = 0; i < hostIds.length; i += BATCH_SIZE) {
+                const batch = hostIds.slice(i, i + BATCH_SIZE);
+                const results = await Promise.allSettled(
+                    batch.map(async (hostId) => {
+                        const result = await atlasGet('/hosts/' + hostId + '/action-plans');
+                        return { hostId, result };
+                    })
+                );
+
+                for (const settled of results) {
+                    if (settled.status === 'rejected') {
+                        failed++;
+                        console.warn('[Atlas Sync] Request failed for host:', settled.reason?.message || settled.reason);
+                        continue;
+                    }
+
+                    const { hostId, result } = settled.value;
+
+                    if (result.status >= 200 && result.status < 300) {
+                        let allPlans = [];
+                        let activePlans = [];
+                        try {
+                            const parsed = JSON.parse(result.body);
+                            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                                activePlans = Array.isArray(parsed.active) ? parsed.active : [];
+                                const inactive = Array.isArray(parsed.inactive) ? parsed.inactive : [];
+                                allPlans = [...activePlans, ...inactive];
+                            } else if (Array.isArray(parsed)) {
+                                allPlans = parsed;
+                                activePlans = parsed;
+                            }
+                        } catch (e) {
+                            allPlans = [];
+                            activePlans = [];
+                        }
+
+                        const planCount = activePlans.length;
+                        const hasActionPlan = planCount > 0;
+
+                        try {
+                            if (!hasActionPlan) {
+                                const { rows: existingRows } = await pool.query(
+                                    `SELECT has_action_plan, plans_json, synced_at FROM atlas_action_plans_cache WHERE host_id = $1`,
+                                    [hostId]
+                                );
+                                const existing = existingRows[0];
+                                if (existing && existing.has_action_plan === true) {
+                                    let existingPlans = [];
+                                    try { existingPlans = JSON.parse(existing.plans_json || '[]'); } catch (_) {}
+                                    const hasBulkStub = existingPlans.some(p => p.source === 'bulk-create');
+                                    if (hasBulkStub) {
+                                        const ageMs = Date.now() - new Date(existing.synced_at).getTime();
+                                        const TEN_MINUTES = 10 * 60 * 1000;
+                                        if (ageMs < TEN_MINUTES) {
+                                            synced++;
+                                            withPlans++;
+                                            continue;
+                                        }
+                                    }
+                                }
+                            }
+
+                            await pool.query(
+                                `INSERT INTO atlas_action_plans_cache (host_id, has_action_plan, plan_count, plans_json, synced_at)
+                                 VALUES ($1, $2, $3, $4, NOW())
+                                 ON CONFLICT(host_id) DO UPDATE SET
+                                     has_action_plan = EXCLUDED.has_action_plan,
+                                     plan_count = EXCLUDED.plan_count,
+                                     plans_json = EXCLUDED.plans_json,
+                                     synced_at = EXCLUDED.synced_at`,
+                                [hostId, hasActionPlan, planCount, JSON.stringify(allPlans)]
+                            );
+                        } catch (dbErr) {
+                            console.error('[Atlas Sync] DB upsert failed for host', hostId, ':', dbErr.message);
+                        }
+
+                        synced++;
+                        if (hasActionPlan) withPlans++;
+                    } else {
+                        failed++;
+                        console.warn(`[Atlas Sync] Non-2xx response for host ${hostId}: status ${result.status}`);
+                    }
+                }
+            }
+
+            logAudit({
+                userId: req.user.id,
+                username: req.user.username,
+                action: 'ATLAS_SYNC',
+                entityType: 'atlas_action_plans',
+                entityId: null,
+                details: { synced, withPlans, failed, totalHosts: hostIds.length },
+                ipAddress: req.ip
+            });
+
+            res.json({ synced, withPlans, failed });
+        } catch (err) {
+            console.error('[Atlas Sync] Unexpected error:', err.message);
+            res.status(500).json({ error: 'Atlas sync failed: ' + err.message });
+        }
+    });
+
+    /**
+     * GET /hosts/:hostId/action-plans
+     *
+     * Proxies a request to Atlas to retrieve action plans for a specific host.
+     *
+     * @param {number} req.params.hostId - Positive integer host identifier
+     * @returns {Object} 2xx - Action plans response from Atlas API
+     * @returns {Object} 400 - { error } when hostId is invalid
+     * @returns {Object} 502 - { error } when Atlas API is unreachable
+     * @returns {Object} 503 - { error } when Atlas API is not configured
+     */
+    router.get('/hosts/:hostId/action-plans', requireAuth(), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'Atlas API is not configured. Check ATLAS_API_URL, ATLAS_API_USER, and ATLAS_API_PASS environment variables.' });
+        }
+
+        const hostId = parseInt(req.params.hostId, 10);
+        if (!Number.isInteger(hostId) || hostId <= 0) {
+            return res.status(400).json({ error: 'hostId must be a positive integer' });
+        }
+
+        try {
+            const result = await atlasGet('/hosts/' + hostId + '/action-plans');
+            if (result.status >= 200 && result.status < 300) {
+                let body;
+                try { body = JSON.parse(result.body); } catch (e) { body = result.body; }
+                res.status(result.status).json(body);
+            } else {
+                let errorBody;
+                try { errorBody = JSON.parse(result.body); } catch (e) { errorBody = { error: result.body }; }
+                res.status(result.status).json(errorBody);
+            }
+        } catch (err) {
+            console.error('[Atlas] GET action-plans failed for host', hostId, ':', err.message);
+            res.status(502).json({ error: 'Failed to reach Atlas API: ' + err.message });
+        }
+    });
+
+    /**
+     * PUT /hosts/:hostId/action-plans
+     *
+     * Creates a new action plan for a host via the Atlas API.
+     * Requires Admin or Standard_User group.
+     *
+     * @param {number} req.params.hostId - Positive integer host identifier
+     * @param {Object} req.body
+     * @param {string} req.body.plan_type - One of: decommission, remediation, false_positive, risk_acceptance, scan_exclusion
+     * @param {string} req.body.commit_date - Date in YYYY-MM-DD format
+     * @returns {Object} 2xx - Created plan response from Atlas API
+     * @returns {Object} 400 - { error } when hostId, plan_type, or commit_date is invalid
+     * @returns {Object} 502 - { error } when Atlas API is unreachable
+     * @returns {Object} 503 - { error } when Atlas API is not configured
+     */
+    router.put('/hosts/:hostId/action-plans', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'Atlas API is not configured. Check ATLAS_API_URL, ATLAS_API_USER, and ATLAS_API_PASS environment variables.' });
+        }
+
+        const hostId = parseInt(req.params.hostId, 10);
+        if (!Number.isInteger(hostId) || hostId <= 0) {
+            return res.status(400).json({ error: 'hostId must be a positive integer' });
+        }
+
+        const { plan_type, commit_date } = req.body || {};
+        if (!plan_type || !VALID_PLAN_TYPES.includes(plan_type)) {
+            return res.status(400).json({ error: 'plan_type must be one of: ' + VALID_PLAN_TYPES.join(', ') });
+        }
+        if (!commit_date || !DATE_PATTERN.test(commit_date)) {
+            return res.status(400).json({ error: 'commit_date must be a valid YYYY-MM-DD date string' });
+        }
+
+        try {
+            const result = await atlasPut('/hosts/' + hostId + '/action-plans', req.body);
+
+            logAudit({
+                userId: req.user.id,
+                username: req.user.username,
+                action: 'ATLAS_CREATE_PLAN',
+                entityType: 'atlas_action_plan',
+                entityId: String(hostId),
+                details: { hostId, plan_type, commit_date },
+                ipAddress: req.ip
+            });
+
+            if (result.status >= 200 && result.status < 300) {
+                let body;
+                try { body = JSON.parse(result.body); } catch (e) { body = result.body; }
+                res.status(result.status).json(body);
+            } else {
+                let errorBody;
+                try { errorBody = JSON.parse(result.body); } catch (e) { errorBody = { error: result.body }; }
+                res.status(result.status).json(errorBody);
+            }
+        } catch (err) {
+            console.error('[Atlas] PUT action-plans failed for host', hostId, ':', err.message);
+            res.status(502).json({ error: 'Failed to reach Atlas API: ' + err.message });
+        }
+    });
+
+    /**
+     * PATCH /hosts/:hostId/action-plans
+     *
+     * Updates an existing action plan for a host via the Atlas API.
+     * Requires Admin or Standard_User group.
+     *
+     * @param {number} req.params.hostId - Positive integer host identifier
+     * @param {Object} req.body
+     * @param {string} req.body.action_plan_id - Non-empty string identifying the plan to update
+     * @param {Object} req.body.updates - Object containing fields to update
+     * @returns {Object} 2xx - Updated plan response from Atlas API
+     * @returns {Object} 400 - { error } when hostId, action_plan_id, or updates is invalid
+     * @returns {Object} 502 - { error } when Atlas API is unreachable
+     * @returns {Object} 503 - { error } when Atlas API is not configured
+     */
+    router.patch('/hosts/:hostId/action-plans', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'Atlas API is not configured. Check ATLAS_API_URL, ATLAS_API_USER, and ATLAS_API_PASS environment variables.' });
+        }
+
+        const hostId = parseInt(req.params.hostId, 10);
+        if (!Number.isInteger(hostId) || hostId <= 0) {
+            return res.status(400).json({ error: 'hostId must be a positive integer' });
+        }
+
+        const { action_plan_id, updates } = req.body || {};
+        if (!action_plan_id || typeof action_plan_id !== 'string' || action_plan_id.trim() === '') {
+            return res.status(400).json({ error: 'action_plan_id is required and must be a non-empty string' });
+        }
+        if (!updates || typeof updates !== 'object' || Array.isArray(updates)) {
+            return res.status(400).json({ error: 'updates is required and must be an object' });
+        }
+
+        try {
+            const result = await atlasPatch('/hosts/' + hostId + '/action-plans', req.body);
+
+            logAudit({
+                userId: req.user.id,
+                username: req.user.username,
+                action: 'ATLAS_UPDATE_PLAN',
+                entityType: 'atlas_action_plan',
+                entityId: String(hostId),
+                details: { hostId, action_plan_id },
+                ipAddress: req.ip
+            });
+
+            if (result.status >= 200 && result.status < 300) {
+                let body;
+                try { body = JSON.parse(result.body); } catch (e) { body = result.body; }
+                res.status(result.status).json(body);
+            } else {
+                let errorBody;
+                try { errorBody = JSON.parse(result.body); } catch (e) { errorBody = { error: result.body }; }
+                res.status(result.status).json(errorBody);
+            }
+        } catch (err) {
+            console.error('[Atlas] PATCH action-plans failed for host', hostId, ':', err.message);
+            res.status(502).json({ error: 'Failed to reach Atlas API: ' + err.message });
+        }
+    });
+
+    /**
+     * POST /hosts/bulk-action-plans
+     *
+     * Creates action plans for multiple hosts in a single request via the Atlas API.
+     * Optimistically updates the local cache with stub plans after a successful response.
+     * Requires Admin or Standard_User group.
+     *
+     * @param {Object} req.body
+     * @param {number[]} req.body.host_ids - Non-empty array of positive integer host identifiers
+     * @param {string} req.body.plan_type - One of: decommission, remediation, false_positive, risk_acceptance, scan_exclusion
+     * @param {string} req.body.commit_date - Date in YYYY-MM-DD format
+     * @returns {Object} 2xx - Bulk creation response from Atlas API
+     * @returns {Object} 400 - { error } when host_ids, plan_type, or commit_date is invalid
+     * @returns {Object} 502 - { error } when Atlas API is unreachable
+     * @returns {Object} 503 - { error } when Atlas API is not configured
+     */
+    router.post('/hosts/bulk-action-plans', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'Atlas API is not configured. Check ATLAS_API_URL, ATLAS_API_USER, and ATLAS_API_PASS environment variables.' });
+        }
+
+        const { host_ids, plan_type, commit_date } = req.body || {};
+        if (!Array.isArray(host_ids) || host_ids.length === 0) {
+            return res.status(400).json({ error: 'host_ids must be a non-empty array of positive integers' });
+        }
+        for (const id of host_ids) {
+            if (!Number.isInteger(id) || id <= 0) {
+                return res.status(400).json({ error: 'host_ids must be a non-empty array of positive integers' });
+            }
+        }
+        if (!plan_type || !VALID_PLAN_TYPES.includes(plan_type)) {
+            return res.status(400).json({ error: 'plan_type must be one of: ' + VALID_PLAN_TYPES.join(', ') });
+        }
+        if (!commit_date || !DATE_PATTERN.test(commit_date)) {
+            return res.status(400).json({ error: 'commit_date must be a valid YYYY-MM-DD date string' });
+        }
+
+        try {
+            const result = await atlasPost('/hosts/create-bulk-action-plans', req.body);
+
+            if (result.status >= 200 && result.status < 300) {
+                let body;
+                try { body = JSON.parse(result.body); } catch (e) { body = result.body; }
+
+                // Optimistically update local cache
+                for (const hid of host_ids) {
+                    try {
+                        const { rows: existingRows } = await pool.query(
+                            `SELECT plan_count, plans_json FROM atlas_action_plans_cache WHERE host_id = $1`,
+                            [hid]
+                        );
+                        const existing = existingRows[0];
+
+                        let existingPlans = [];
+                        if (existing && existing.plans_json) {
+                            try { existingPlans = JSON.parse(existing.plans_json); } catch (_) {}
+                        }
+
+                        const stubPlan = { plan_type, commit_date, source: 'bulk-create', created_at: new Date().toISOString() };
+                        const updatedPlans = [...existingPlans, stubPlan];
+                        const newCount = updatedPlans.length;
+
+                        await pool.query(
+                            `INSERT INTO atlas_action_plans_cache (host_id, has_action_plan, plan_count, plans_json, synced_at)
+                             VALUES ($1, true, $2, $3, NOW())
+                             ON CONFLICT(host_id) DO UPDATE SET
+                                 has_action_plan = true,
+                                 plan_count = EXCLUDED.plan_count,
+                                 plans_json = EXCLUDED.plans_json,
+                                 synced_at = EXCLUDED.synced_at`,
+                            [hid, newCount, JSON.stringify(updatedPlans)]
+                        );
+                    } catch (cacheErr) {
+                        console.error('[Atlas] Cache update failed for host', hid, ':', cacheErr.message);
+                    }
+                }
+
+                logAudit({
+                    userId: req.user.id,
+                    username: req.user.username,
+                    action: 'ATLAS_BULK_CREATE_PLANS',
+                    entityType: 'atlas_action_plan',
+                    entityId: null,
+                    details: { host_ids, plan_type, commit_date, count: host_ids.length },
+                    ipAddress: req.ip
+                });
+
+                res.status(result.status).json(body);
+            } else {
+                let errorBody;
+                try { errorBody = JSON.parse(result.body); } catch (e) { errorBody = { error: result.body }; }
+                res.status(result.status).json(errorBody);
+            }
+        } catch (err) {
+            console.error('[Atlas] POST bulk-action-plans failed:', err.message);
+            res.status(502).json({ error: 'Failed to reach Atlas API: ' + err.message });
+        }
+    });
+
+    /**
+     * POST /hosts/:hostId/refresh-cache
+     *
+     * Triggers Atlas to refresh its Ivanti data cache, then updates the local
+     * action plans cache for the specified host. Useful when action plan creation
+     * fails due to stale finding IDs.
+     * Requires Admin or Standard_User group.
+     *
+     * @param {number} req.params.hostId - Positive integer host identifier
+     * @returns {Object} 200 - { success, message } on successful cache refresh
+     * @returns {Object} 400 - { error } when hostId is invalid
+     * @returns {Object} 502 - { error } when Atlas API is unreachable
+     * @returns {Object} 503 - { error } when Atlas API is not configured
+     */
+    router.post('/hosts/:hostId/refresh-cache', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'Atlas API is not configured. Check ATLAS_API_URL, ATLAS_API_USER, and ATLAS_API_PASS environment variables.' });
+        }
+
+        const hostId = parseInt(req.params.hostId, 10);
+        if (!Number.isInteger(hostId) || hostId <= 0) {
+            return res.status(400).json({ error: 'hostId must be a positive integer' });
+        }
+
+        try {
+            const result = await atlasPost('/cache/refresh-ivanti', {}, { timeout: 30000 });
+
+            if (result.status >= 200 && result.status < 300) {
+                // Also refresh our local action plans cache for this host
+                const plansResult = await atlasGet('/hosts/' + hostId + '/action-plans');
+                if (plansResult.status >= 200 && plansResult.status < 300) {
+                    let allPlans = [];
+                    let activePlans = [];
+                    try {
+                        const parsed = JSON.parse(plansResult.body);
+                        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                            activePlans = Array.isArray(parsed.active) ? parsed.active : [];
+                            const inactive = Array.isArray(parsed.inactive) ? parsed.inactive : [];
+                            allPlans = [...activePlans, ...inactive];
+                        } else if (Array.isArray(parsed)) {
+                            allPlans = parsed;
+                            activePlans = parsed;
+                        }
+                    } catch (_) {}
+
+                    const planCount = activePlans.length;
+                    const hasActionPlan = planCount > 0;
+
+                    await pool.query(
+                        `INSERT INTO atlas_action_plans_cache (host_id, has_action_plan, plan_count, plans_json, synced_at)
+                         VALUES ($1, $2, $3, $4, NOW())
+                         ON CONFLICT(host_id) DO UPDATE SET
+                             has_action_plan = EXCLUDED.has_action_plan,
+                             plan_count = EXCLUDED.plan_count,
+                             plans_json = EXCLUDED.plans_json,
+                             synced_at = EXCLUDED.synced_at`,
+                        [hostId, hasActionPlan, planCount, JSON.stringify(allPlans)]
+                    );
+                }
+
+                res.json({ success: true, message: 'Atlas cache refreshed for host ' + hostId });
+            } else {
+                let errorBody;
+                try { errorBody = JSON.parse(result.body); } catch (e) { errorBody = { error: result.body }; }
+                res.status(result.status).json(errorBody);
+            }
+        } catch (err) {
+            console.error('[Atlas] POST refresh-cache failed for host', hostId, ':', err.message);
+            res.status(502).json({ error: 'Failed to reach Atlas API: ' + err.message });
+        }
+    });
+
+    /**
+     * POST /hosts/vulnerabilities
+     *
+     * Fetches Ivanti vulnerability data for the specified hosts from Atlas.
+     *
+     * @param {Object} req.body
+     * @param {number[]} req.body.host_ids - Non-empty array of positive integer host identifiers
+     * @returns {Object} 2xx - Vulnerability data response from Atlas API
+     * @returns {Object} 400 - { error } when host_ids is invalid
+     * @returns {Object} 502 - { error } when Atlas API is unreachable
+     * @returns {Object} 503 - { error } when Atlas API is not configured
+     */
+    router.post('/hosts/vulnerabilities', requireAuth(), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'Atlas API is not configured. Check ATLAS_API_URL, ATLAS_API_USER, and ATLAS_API_PASS environment variables.' });
+        }
+
+        const { host_ids } = req.body || {};
+        if (!Array.isArray(host_ids) || host_ids.length === 0) {
+            return res.status(400).json({ error: 'host_ids must be a non-empty array of positive integers' });
+        }
+        for (const id of host_ids) {
+            if (!Number.isInteger(id) || id <= 0) {
+                return res.status(400).json({ error: 'host_ids must be a non-empty array of positive integers' });
+            }
+        }
+
+        try {
+            const result = await atlasPost('/ivanti-vulnerabilities-by-host', { host_ids }, { timeout: 30000 });
+
+            if (result.status >= 200 && result.status < 300) {
+                let body;
+                try { body = JSON.parse(result.body); } catch (e) { body = result.body; }
+                res.status(result.status).json(body);
+            } else {
+                let errorBody;
+                try { errorBody = JSON.parse(result.body); } catch (e) { errorBody = { error: result.body }; }
+                res.status(result.status).json(errorBody);
+            }
+        } catch (err) {
+            console.error('[Atlas] POST hosts/vulnerabilities failed:', err.message);
+            res.status(502).json({ error: 'Failed to reach Atlas API: ' + err.message });
+        }
+    });
+
+    return router;
+}
+
+module.exports = createAtlasRouter;
+module.exports.aggregateAtlasMetrics = aggregateAtlasMetrics;

backend/routes/auditLog.js

@@ -1,11 +1,13 @@
 // Audit Log Routes (Admin only)
 const express = require('express');
+const pool = require('../db');
+const { requireAuth, requireGroup } = require('../middleware/auth');
 
-function createAuditLogRouter(db, requireAuth, requireRole) {
+function createAuditLogRouter() {
     const router = express.Router();
 
-    // All routes require admin role
-    router.use(requireAuth(db), requireRole('admin'));
+    // All routes require Admin group
+    router.use(requireAuth(), requireGroup('Admin'));
 
     // Get paginated audit logs with filters
     router.get('/', async (req, res) => {
@@ -24,25 +26,26 @@ function createAuditLogRouter(db, requireAuth, requireRole) {
 
         let where = [];
         let params = [];
+        let paramIndex = 1;
 
         if (user) {
-            where.push('username LIKE ?');
+            where.push(`username ILIKE $${paramIndex++}`);
             params.push(`%${user}%`);
         }
         if (action) {
-            where.push('action = ?');
+            where.push(`action = $${paramIndex++}`);
             params.push(action);
         }
         if (entityType) {
-            where.push('entity_type = ?');
+            where.push(`entity_type = $${paramIndex++}`);
             params.push(entityType);
         }
         if (startDate) {
-            where.push('created_at >= ?');
+            where.push(`created_at >= $${paramIndex++}`);
             params.push(startDate);
         }
         if (endDate) {
-            where.push('created_at <= ?');
+            where.push(`created_at <= $${paramIndex++}`);
             params.push(endDate + ' 23:59:59');
         }
 
@@ -50,36 +53,25 @@ function createAuditLogRouter(db, requireAuth, requireRole) {
 
         try {
             // Get total count
-            const countRow = await new Promise((resolve, reject) => {
-                db.get(
-                    `SELECT COUNT(*) as total FROM audit_logs ${whereClause}`,
-                    params,
-                    (err, row) => {
-                        if (err) reject(err);
-                        else resolve(row);
-                    }
-                );
-            });
+            const countResult = await pool.query(
+                `SELECT COUNT(*) as total FROM audit_logs ${whereClause}`,
+                params
+            );
+            const total = parseInt(countResult.rows[0].total);
 
             // Get paginated results
-            const rows = await new Promise((resolve, reject) => {
-                db.all(
-                    `SELECT * FROM audit_logs ${whereClause} ORDER BY created_at DESC LIMIT ? OFFSET ?`,
-                    [...params, pageSize, offset],
-                    (err, rows) => {
-                        if (err) reject(err);
-                        else resolve(rows);
-                    }
-                );
-            });
+            const dataResult = await pool.query(
+                `SELECT * FROM audit_logs ${whereClause} ORDER BY created_at DESC LIMIT $${paramIndex++} OFFSET $${paramIndex++}`,
+                [...params, pageSize, offset]
+            );
 
             res.json({
-                logs: rows,
+                logs: dataResult.rows,
                 pagination: {
                     page: parseInt(page),
                     limit: pageSize,
-                    total: countRow.total,
-                    totalPages: Math.ceil(countRow.total / pageSize)
+                    total: total,
+                    totalPages: Math.ceil(total / pageSize)
                 }
             });
         } catch (err) {
@@ -91,16 +83,9 @@ function createAuditLogRouter(db, requireAuth, requireRole) {
     // Get distinct action types for filter dropdown
     router.get('/actions', async (req, res) => {
         try {
-            const rows = await new Promise((resolve, reject) => {
-                db.all(
-                    'SELECT DISTINCT action FROM audit_logs ORDER BY action',
-                    (err, rows) => {
-                        if (err) reject(err);
-                        else resolve(rows);
-                    }
-                );
-            });
-
+            const { rows } = await pool.query(
+                'SELECT DISTINCT action FROM audit_logs ORDER BY action'
+            );
             res.json(rows.map(r => r.action));
         } catch (err) {
             console.error('Audit log actions error:', err);

backend/routes/auth.js

@@ -2,12 +2,36 @@
 const express = require('express');
 const bcrypt = require('bcryptjs');
 const crypto = require('crypto');
+const rateLimit = require('express-rate-limit');
+const pool = require('../db');
+const { requireAuth, requireGroup } = require('../middleware/auth');
 
-function createAuthRouter(db, logAudit) {
+const loginLimiter = rateLimit({
+    windowMs: 15 * 60 * 1000, // 15 minutes
+    max: 20, // 20 attempts per window
+    standardHeaders: true,
+    legacyHeaders: false,
+    message: { error: 'Too many login attempts. Please try again in 15 minutes.' }
+});
+
+function createAuthRouter(logAudit) {
     const router = express.Router();
 
-    // Login
-    router.post('/login', async (req, res) => {
+    /**
+     * POST /api/auth/login
+     *
+     * Authenticates a user with username and password, creates a session,
+     * and sets an httpOnly session cookie. Rate-limited to 20 attempts per 15 minutes.
+     *
+     * @body {string} username - The user's login username
+     * @body {string} password - The user's password
+     * @returns {object} 200 - { message: 'Login successful', user: { id, username, email, group } }
+     * @returns {object} 400 - { error: 'Username and password are required' }
+     * @returns {object} 401 - { error: 'Invalid username or password' } | { error: 'Account is disabled' }
+     * @returns {object} 429 - { error: 'Too many login attempts. Please try again in 15 minutes.' }
+     * @returns {object} 500 - { error: 'Login failed' }
+     */
+    router.post('/login', loginLimiter, async (req, res) => {
         const { username, password } = req.body;
 
         if (!username || !password) {
@@ -16,19 +40,14 @@ function createAuthRouter(db, logAudit) {
 
         try {
             // Find user
-            const user = await new Promise((resolve, reject) => {
-                db.get(
-                    'SELECT * FROM users WHERE username = ?',
-                    [username],
-                    (err, row) => {
-                        if (err) reject(err);
-                        else resolve(row);
-                    }
-                );
-            });
+            const { rows } = await pool.query(
+                'SELECT * FROM users WHERE username = $1',
+                [username]
+            );
+            const user = rows[0];
 
             if (!user) {
-                logAudit(db, {
+                logAudit({
                     userId: null,
                     username: username,
                     action: 'login_failed',
@@ -41,7 +60,7 @@ function createAuthRouter(db, logAudit) {
             }
 
             if (!user.is_active) {
-                logAudit(db, {
+                logAudit({
                     userId: user.id,
                     username: username,
                     action: 'login_failed',
@@ -56,7 +75,7 @@ function createAuthRouter(db, logAudit) {
             // Verify password
             const validPassword = await bcrypt.compare(password, user.password_hash);
             if (!validPassword) {
-                logAudit(db, {
+                logAudit({
                     userId: user.id,
                     username: username,
                     action: 'login_failed',
@@ -73,28 +92,16 @@ function createAuthRouter(db, logAudit) {
             const expiresAt = new Date(Date.now() + 24 * 60 * 60 * 1000); // 24 hours
 
             // Create session
-            await new Promise((resolve, reject) => {
-                db.run(
-                    'INSERT INTO sessions (session_id, user_id, expires_at) VALUES (?, ?, ?)',
-                    [sessionId, user.id, expiresAt.toISOString()],
-                    (err) => {
-                        if (err) reject(err);
-                        else resolve();
-                    }
-                );
-            });
+            await pool.query(
+                'INSERT INTO sessions (session_id, user_id, expires_at) VALUES ($1, $2, $3)',
+                [sessionId, user.id, expiresAt.toISOString()]
+            );
 
             // Update last login
-            await new Promise((resolve, reject) => {
-                db.run(
-                    'UPDATE users SET last_login = CURRENT_TIMESTAMP WHERE id = ?',
-                    [user.id],
-                    (err) => {
-                        if (err) reject(err);
-                        else resolve();
-                    }
-                );
-            });
+            await pool.query(
+                'UPDATE users SET last_login = NOW() WHERE id = $1',
+                [user.id]
+            );
 
             // Set cookie
             res.cookie('session_id', sessionId, {
@@ -104,13 +111,13 @@ function createAuthRouter(db, logAudit) {
                 maxAge: 24 * 60 * 60 * 1000 // 24 hours
             });
 
-            logAudit(db, {
+            logAudit({
                 userId: user.id,
                 username: user.username,
                 action: 'login',
                 entityType: 'auth',
                 entityId: null,
-                details: { role: user.role },
+                details: { group: user.user_group },
                 ipAddress: req.ip
             });
 
@@ -120,7 +127,8 @@ function createAuthRouter(db, logAudit) {
                     id: user.id,
                     username: user.username,
                     email: user.email,
-                    role: user.role
+                    group: user.user_group,
+                    teams: user.bu_teams ? user.bu_teams.split(',').filter(Boolean) : []
                 }
             });
         } catch (err) {
@@ -129,33 +137,44 @@ function createAuthRouter(db, logAudit) {
         }
     });
 
-    // Logout
+    /**
+     * POST /api/auth/logout
+     *
+     * Ends the current user session by deleting it from the database
+     * and clearing the session cookie.
+     *
+     * @returns {object} 200 - { message: 'Logged out successfully' }
+     */
     router.post('/logout', async (req, res) => {
         const sessionId = req.cookies?.session_id;
 
         if (sessionId) {
             // Look up user before deleting session
-            const session = await new Promise((resolve) => {
-                db.get(
+            let session = null;
+            try {
+                const { rows } = await pool.query(
                     `SELECT u.id as user_id, u.username FROM sessions s
                      JOIN users u ON s.user_id = u.id
-                     WHERE s.session_id = ?`,
-                    [sessionId],
-                    (err, row) => resolve(row || null)
+                     WHERE s.session_id = $1`,
+                    [sessionId]
                 );
-            });
+                session = rows[0] || null;
+            } catch (err) {
+                // Non-critical — proceed with logout
+            }
 
             // Delete session from database
-            await new Promise((resolve) => {
-                db.run(
-                    'DELETE FROM sessions WHERE session_id = ?',
-                    [sessionId],
-                    () => resolve()
+            try {
+                await pool.query(
+                    'DELETE FROM sessions WHERE session_id = $1',
+                    [sessionId]
                 );
-            });
+            } catch (err) {
+                // Non-critical — proceed with logout
+            }
 
             if (session) {
-                logAudit(db, {
+                logAudit({
                     userId: session.user_id,
                     username: session.username,
                     action: 'logout',
@@ -172,7 +191,16 @@ function createAuthRouter(db, logAudit) {
         res.json({ message: 'Logged out successfully' });
     });
 
-    // Get current user
+    /**
+     * GET /api/auth/me
+     *
+     * Returns the currently authenticated user based on the session cookie.
+     * Clears the cookie and returns 401 if the session is expired or the account is disabled.
+     *
+     * @returns {object} 200 - { user: { id, username, email, group } }
+     * @returns {object} 401 - { error: 'Not authenticated' } | { error: 'Session expired' } | { error: 'Account is disabled' }
+     * @returns {object} 500 - { error: 'Failed to get user' }
+     */
     router.get('/me', async (req, res) => {
         const sessionId = req.cookies?.session_id;
 
@@ -181,19 +209,15 @@ function createAuthRouter(db, logAudit) {
         }
 
         try {
-            const session = await new Promise((resolve, reject) => {
-                db.get(
-                    `SELECT s.*, u.id as user_id, u.username, u.email, u.role, u.is_active
-                     FROM sessions s
-                     JOIN users u ON s.user_id = u.id
-                     WHERE s.session_id = ? AND s.expires_at > datetime('now')`,
-                    [sessionId],
-                    (err, row) => {
-                        if (err) reject(err);
-                        else resolve(row);
-                    }
-                );
-            });
+            const { rows } = await pool.query(
+                `SELECT s.*, u.id as user_id, u.username, u.email, u.user_group, u.bu_teams, u.is_active
+                 FROM sessions s
+                 JOIN users u ON s.user_id = u.id
+                 WHERE s.session_id = $1 AND s.expires_at > NOW()`,
+                [sessionId]
+            );
+
+            const session = rows[0];
 
             if (!session) {
                 res.clearCookie('session_id');
@@ -210,7 +234,8 @@ function createAuthRouter(db, logAudit) {
                     id: session.user_id,
                     username: session.username,
                     email: session.email,
-                    role: session.role
+                    group: session.user_group,
+                    teams: session.bu_teams ? session.bu_teams.split(',').filter(Boolean) : []
                 }
             });
         } catch (err) {
@@ -219,23 +244,136 @@ function createAuthRouter(db, logAudit) {
         }
     });
 
-    // Clean up expired sessions (admin only)
-    router.post('/cleanup-sessions', async (req, res) => {
-        // Basic auth check - require a valid session to call this
-        const sessionId = req.cookies?.session_id;
-        if (!sessionId) {
-            return res.status(401).json({ error: 'Authentication required' });
-        }
+    /**
+     * GET /api/auth/profile
+     *
+     * Returns the full profile for the currently authenticated user.
+     * Queries the database for up-to-date account details including
+     * creation date and last login timestamp.
+     *
+     * @returns {object} 200 - { id, username, email, group, created_at, last_login }
+     * @returns {object} 401 - { error: 'Account is disabled' } (clears session cookie)
+     * @returns {object} 500 - { error: 'Failed to fetch profile' }
+     */
+    router.get('/profile', requireAuth(), async (req, res) => {
         try {
-            await new Promise((resolve, reject) => {
-                db.run(
-                    "DELETE FROM sessions WHERE expires_at < datetime('now')",
-                    (err) => {
-                        if (err) reject(err);
-                        else resolve();
-                    }
-                );
+            const { rows } = await pool.query(
+                'SELECT id, username, email, user_group, created_at, last_login, is_active FROM users WHERE id = $1',
+                [req.user.id]
+            );
+
+            const user = rows[0];
+
+            if (!user || !user.is_active) {
+                res.clearCookie('session_id');
+                return res.status(401).json({ error: 'Account is disabled' });
+            }
+
+            res.json({
+                id: user.id,
+                username: user.username,
+                email: user.email,
+                group: user.user_group,
+                created_at: user.created_at,
+                last_login: user.last_login
             });
+        } catch (err) {
+            console.error('Profile fetch error:', err);
+            res.status(500).json({ error: 'Failed to fetch profile' });
+        }
+    });
+
+    // Rate limiter for password change — 5 attempts per 15-minute window, keyed by session cookie
+    const passwordChangeLimiter = rateLimit({
+        windowMs: 15 * 60 * 1000, // 15 minutes
+        max: 5,
+        standardHeaders: true,
+        legacyHeaders: false,
+        keyGenerator: (req) => req.cookies?.session_id || req.ip,
+        message: { error: 'Too many password change attempts. Please try again later.' }
+    });
+
+    /**
+     * POST /api/auth/change-password
+     *
+     * Allows the authenticated user to change their own password.
+     * Rate-limited to 5 attempts per 15-minute window per session.
+     *
+     * @body {string} currentPassword - The user's current password
+     * @body {string} newPassword - The desired new password (min 8 characters)
+     * @returns {object} 200 - { message: 'Password changed successfully' }
+     * @returns {object} 400 - { error: 'Current password and new password are required' } | { error: 'New password must be at least 8 characters' }
+     * @returns {object} 401 - { error: 'Account is disabled' } | { error: 'Current password is incorrect' }
+     * @returns {object} 429 - { error: 'Too many password change attempts. Please try again later.' }
+     * @returns {object} 500 - { error: 'Failed to change password' }
+     */
+    router.post('/change-password', requireAuth(), passwordChangeLimiter, async (req, res) => {
+        const { currentPassword, newPassword } = req.body;
+
+        if (!currentPassword || !newPassword) {
+            return res.status(400).json({ error: 'Current password and new password are required' });
+        }
+
+        if (newPassword.length < 8) {
+            return res.status(400).json({ error: 'New password must be at least 8 characters' });
+        }
+
+        try {
+            // Fetch user's password hash and active status
+            const { rows } = await pool.query(
+                'SELECT password_hash, is_active FROM users WHERE id = $1',
+                [req.user.id]
+            );
+
+            const user = rows[0];
+
+            if (!user || !user.is_active) {
+                return res.status(401).json({ error: 'Account is disabled' });
+            }
+
+            // Verify current password
+            const validPassword = await bcrypt.compare(currentPassword, user.password_hash);
+            if (!validPassword) {
+                return res.status(401).json({ error: 'Current password is incorrect' });
+            }
+
+            // Hash new password and update
+            const newHash = await bcrypt.hash(newPassword, 10);
+            await pool.query(
+                'UPDATE users SET password_hash = $1 WHERE id = $2',
+                [newHash, req.user.id]
+            );
+
+            logAudit({
+                userId: req.user.id,
+                username: req.user.username,
+                action: 'password_change',
+                entityType: 'auth',
+                entityId: null,
+                details: null,
+                ipAddress: req.ip
+            });
+
+            res.json({ message: 'Password changed successfully' });
+        } catch (err) {
+            console.error('Password change error:', err);
+            res.status(500).json({ error: 'Failed to change password' });
+        }
+    });
+
+    /**
+     * POST /api/auth/cleanup-sessions
+     *
+     * Deletes all expired sessions from the database. Requires Admin group.
+     *
+     * @returns {object} 200 - { message: 'Expired sessions cleaned up' }
+     * @returns {object} 401 - { error: 'Authentication required' }
+     * @returns {object} 403 - { error: 'Insufficient permissions', required: ['Admin'], current: '...' }
+     * @returns {object} 500 - { error: 'Cleanup failed' }
+     */
+    router.post('/cleanup-sessions', requireAuth(), requireGroup('Admin'), async (req, res) => {
+        try {
+            await pool.query("DELETE FROM sessions WHERE expires_at < NOW()");
             res.json({ message: 'Expired sessions cleaned up' });
         } catch (err) {
             console.error('Session cleanup error:', err);

backend/routes/cardApi.js

@@ -0,0 +1,393 @@
+// CARD Asset Ownership API Routes
+// Proxies CARD operations (confirm, decline, redirect, search) and orchestrates
+// the two-step update_token flow for mutations.
+
+const express = require('express');
+const pool = require('../db');
+const { requireAuth, requireGroup } = require('../middleware/auth');
+const logAudit = require('../helpers/auditLog');
+const {
+    isConfigured,
+    missingVars,
+    getTeams,
+    getTeamAssets,
+    getOwner,
+    confirmAsset,
+    declineAsset,
+    redirectAsset,
+} = require('../helpers/cardApi');
+
+// ---------------------------------------------------------------------------
+// Error classification — maps CARD API / token errors to client responses
+// ---------------------------------------------------------------------------
+function handleCardError(err, res) {
+    const msg = err.message || String(err);
+    console.error('[card-api]', msg);
+
+    if (msg.includes('Token acquisition failed')) {
+        if (msg.includes('HTTP 401')) {
+            return res.status(401).json({ error: 'CARD authorization failed. Check service account credentials.' });
+        }
+        if (msg.includes('HTTP 403')) {
+            return res.status(403).json({ error: 'CARD access denied. The service account may not be onboarded with the CARD team.' });
+        }
+        if (msg.includes('HTTP 525')) {
+            return res.status(502).json({ error: 'CARD LDAP error. The service account may not be provisioned correctly.' });
+        }
+    }
+
+    if (msg.includes('401')) {
+        return res.status(401).json({ error: 'CARD token expired or invalid. The request has been retried once automatically.' });
+    }
+    if (msg.includes('403')) {
+        return res.status(403).json({ error: 'Insufficient CARD permissions for this operation.' });
+    }
+
+    return res.status(502).json({ error: 'CARD API request failed.', details: msg });
+}
+
+// ---------------------------------------------------------------------------
+// Router factory
+// ---------------------------------------------------------------------------
+function createCardApiRouter() {
+    const router = express.Router();
+
+    // GET /status
+    router.get('/status', requireAuth(), (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ configured: false, error: 'CARD API is not configured.', missingVars });
+        }
+        res.json({ configured: true });
+    });
+
+    // GET /teams
+    router.get('/teams', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'CARD API is not configured.', missingVars });
+        }
+
+        try {
+            const result = await getTeams();
+            if (result.ok) {
+                let body;
+                try { body = JSON.parse(result.body); } catch (_) { body = result.body; }
+                const teams = Array.isArray(body) ? body : (body && body.teams) || [];
+                return res.json(teams);
+            }
+            let errorBody;
+            try { errorBody = JSON.parse(result.body); } catch (_) { errorBody = { error: result.body }; }
+            return res.status(result.status).json(errorBody);
+        } catch (err) {
+            return handleCardError(err, res);
+        }
+    });
+
+    // GET /teams/:teamName/assets
+    router.get('/teams/:teamName/assets', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'CARD API is not configured.', missingVars });
+        }
+
+        const { teamName } = req.params;
+        const { disposition, page, page_size } = req.query;
+
+        if (!disposition) {
+            return res.status(400).json({ error: 'disposition query parameter is required.' });
+        }
+
+        try {
+            const result = await getTeamAssets(teamName, {
+                disposition,
+                page: page ? parseInt(page, 10) : undefined,
+                pageSize: page_size ? parseInt(page_size, 10) : 50,
+            });
+
+            if (result.ok) {
+                let body;
+                try { body = JSON.parse(result.body); } catch (_) { body = result.body; }
+
+                let resultCount = 0;
+                if (body && typeof body === 'object' && typeof body.total === 'number') {
+                    resultCount = body.total;
+                } else if (body && Array.isArray(body.assets)) {
+                    resultCount = body.assets.length;
+                }
+                logAudit({
+                    userId: req.user.id,
+                    username: req.user.username,
+                    action: 'card_search',
+                    entityType: 'card_asset',
+                    entityId: teamName,
+                    details: { disposition, resultCount },
+                    ipAddress: req.ip,
+                });
+
+                return res.json(body);
+            }
+
+            let errorBody;
+            try { errorBody = JSON.parse(result.body); } catch (_) { errorBody = { error: result.body }; }
+            return res.status(result.status).json(errorBody);
+        } catch (err) {
+            return handleCardError(err, res);
+        }
+    });
+
+    // GET /owner/:assetId
+    router.get('/owner/:assetId', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'CARD API is not configured.', missingVars });
+        }
+
+        const { assetId } = req.params;
+
+        try {
+            const result = await getOwner(assetId);
+            if (result.ok) {
+                let body;
+                try { body = JSON.parse(result.body); } catch (_) { body = result.body; }
+                return res.json(body);
+            }
+            let errorBody;
+            try { errorBody = JSON.parse(result.body); } catch (_) { errorBody = { error: result.body }; }
+            return res.status(result.status).json(errorBody);
+        } catch (err) {
+            return handleCardError(err, res);
+        }
+    });
+
+    // POST /queue/:queueItemId/confirm
+    router.post('/queue/:queueItemId/confirm', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'CARD API is not configured.', missingVars });
+        }
+
+        const { queueItemId } = req.params;
+        const { teamName, assetId, comment } = req.body;
+
+        if (!teamName || typeof teamName !== 'string' || !teamName.trim()) {
+            return res.status(400).json({ error: 'teamName is required.' });
+        }
+        if (!assetId || typeof assetId !== 'string' || !assetId.trim()) {
+            return res.status(400).json({ error: 'assetId is required.' });
+        }
+
+        try {
+            const { rows } = await pool.query(
+                'SELECT * FROM ivanti_todo_queue WHERE id = $1 AND user_id = $2 AND workflow_type = $3',
+                [queueItemId, req.user.id, 'CARD']
+            );
+            const item = rows[0];
+
+            if (!item) {
+                return res.status(404).json({ error: 'Queue item not found.' });
+            }
+            if (item.status !== 'pending') {
+                return res.status(400).json({ error: 'Only pending queue items can be executed.' });
+            }
+
+            const ownerResult = await getOwner(assetId);
+            if (!ownerResult.ok) {
+                const errMsg = `Failed to fetch owner record: HTTP ${ownerResult.status}`;
+                logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'confirm', assetId, error: errMsg, cardStatus: ownerResult.status }, ipAddress: req.ip });
+                let errorBody;
+                try { errorBody = JSON.parse(ownerResult.body); } catch (_) { errorBody = { error: ownerResult.body }; }
+                return res.status(ownerResult.status).json(errorBody);
+            }
+
+            let ownerData;
+            try { ownerData = JSON.parse(ownerResult.body); } catch (_) { ownerData = {}; }
+            const updateToken = ownerData.owner && ownerData.owner.update_token;
+
+            if (!updateToken) {
+                const errMsg = 'update_token not found in owner record.';
+                logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'confirm', assetId, error: errMsg, cardStatus: null }, ipAddress: req.ip });
+                return res.status(502).json({ error: 'CARD API request failed.', details: errMsg });
+            }
+
+            const confirmResult = await confirmAsset(assetId, teamName.trim(), updateToken, comment || '');
+
+            if (confirmResult.ok) {
+                await pool.query(
+                    "UPDATE ivanti_todo_queue SET status = 'complete', updated_at = NOW() WHERE id = $1",
+                    [queueItemId]
+                );
+
+                let cardResponse;
+                try { cardResponse = JSON.parse(confirmResult.body); } catch (_) { cardResponse = confirmResult.body; }
+
+                logAudit({ userId: req.user.id, username: req.user.username, action: 'card_confirm', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { assetId, teamName: teamName.trim(), comment: comment || '', cardStatus: confirmResult.status }, ipAddress: req.ip });
+
+                return res.json({ success: true, cardResponse });
+            }
+
+            const errMsg = `Confirm failed: HTTP ${confirmResult.status}`;
+            logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'confirm', assetId, error: errMsg, cardStatus: confirmResult.status }, ipAddress: req.ip });
+            let errorBody;
+            try { errorBody = JSON.parse(confirmResult.body); } catch (_) { errorBody = { error: confirmResult.body }; }
+            return res.status(confirmResult.status).json(errorBody);
+        } catch (err) {
+            logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'confirm', assetId, error: err.message, cardStatus: null }, ipAddress: req.ip });
+            return handleCardError(err, res);
+        }
+    });
+
+    // POST /queue/:queueItemId/decline
+    router.post('/queue/:queueItemId/decline', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'CARD API is not configured.', missingVars });
+        }
+
+        const { queueItemId } = req.params;
+        const { teamName, assetId, comment } = req.body;
+
+        if (!teamName || typeof teamName !== 'string' || !teamName.trim()) {
+            return res.status(400).json({ error: 'teamName is required.' });
+        }
+        if (!assetId || typeof assetId !== 'string' || !assetId.trim()) {
+            return res.status(400).json({ error: 'assetId is required.' });
+        }
+
+        try {
+            const { rows } = await pool.query(
+                'SELECT * FROM ivanti_todo_queue WHERE id = $1 AND user_id = $2 AND workflow_type = $3',
+                [queueItemId, req.user.id, 'CARD']
+            );
+            const item = rows[0];
+
+            if (!item) {
+                return res.status(404).json({ error: 'Queue item not found.' });
+            }
+            if (item.status !== 'pending') {
+                return res.status(400).json({ error: 'Only pending queue items can be executed.' });
+            }
+
+            const ownerResult = await getOwner(assetId);
+            if (!ownerResult.ok) {
+                const errMsg = `Failed to fetch owner record: HTTP ${ownerResult.status}`;
+                logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'decline', assetId, error: errMsg, cardStatus: ownerResult.status }, ipAddress: req.ip });
+                let errorBody;
+                try { errorBody = JSON.parse(ownerResult.body); } catch (_) { errorBody = { error: ownerResult.body }; }
+                return res.status(ownerResult.status).json(errorBody);
+            }
+
+            let ownerData;
+            try { ownerData = JSON.parse(ownerResult.body); } catch (_) { ownerData = {}; }
+            const updateToken = ownerData.owner && ownerData.owner.update_token;
+
+            if (!updateToken) {
+                const errMsg = 'update_token not found in owner record.';
+                logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'decline', assetId, error: errMsg, cardStatus: null }, ipAddress: req.ip });
+                return res.status(502).json({ error: 'CARD API request failed.', details: errMsg });
+            }
+
+            const declineResult = await declineAsset(assetId, teamName.trim(), updateToken, comment || '');
+
+            if (declineResult.ok) {
+                await pool.query(
+                    "UPDATE ivanti_todo_queue SET status = 'complete', updated_at = NOW() WHERE id = $1",
+                    [queueItemId]
+                );
+
+                let cardResponse;
+                try { cardResponse = JSON.parse(declineResult.body); } catch (_) { cardResponse = declineResult.body; }
+
+                logAudit({ userId: req.user.id, username: req.user.username, action: 'card_decline', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { assetId, teamName: teamName.trim(), comment: comment || '', cardStatus: declineResult.status }, ipAddress: req.ip });
+
+                return res.json({ success: true, cardResponse });
+            }
+
+            const errMsg = `Decline failed: HTTP ${declineResult.status}`;
+            logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'decline', assetId, error: errMsg, cardStatus: declineResult.status }, ipAddress: req.ip });
+            let errorBody;
+            try { errorBody = JSON.parse(declineResult.body); } catch (_) { errorBody = { error: declineResult.body }; }
+            return res.status(declineResult.status).json(errorBody);
+        } catch (err) {
+            logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'decline', assetId, error: err.message, cardStatus: null }, ipAddress: req.ip });
+            return handleCardError(err, res);
+        }
+    });
+
+    // POST /queue/:queueItemId/redirect
+    router.post('/queue/:queueItemId/redirect', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!isConfigured) {
+            return res.status(503).json({ error: 'CARD API is not configured.', missingVars });
+        }
+
+        const { queueItemId } = req.params;
+        const { fromTeam, toTeam, assetId } = req.body;
+
+        if (!fromTeam || typeof fromTeam !== 'string' || !fromTeam.trim()) {
+            return res.status(400).json({ error: 'fromTeam is required.' });
+        }
+        if (!toTeam || typeof toTeam !== 'string' || !toTeam.trim()) {
+            return res.status(400).json({ error: 'toTeam is required.' });
+        }
+        if (!assetId || typeof assetId !== 'string' || !assetId.trim()) {
+            return res.status(400).json({ error: 'assetId is required.' });
+        }
+
+        try {
+            const { rows } = await pool.query(
+                'SELECT * FROM ivanti_todo_queue WHERE id = $1 AND user_id = $2 AND workflow_type = $3',
+                [queueItemId, req.user.id, 'CARD']
+            );
+            const item = rows[0];
+
+            if (!item) {
+                return res.status(404).json({ error: 'Queue item not found.' });
+            }
+            if (item.status !== 'pending') {
+                return res.status(400).json({ error: 'Only pending queue items can be executed.' });
+            }
+
+            const ownerResult = await getOwner(assetId);
+            if (!ownerResult.ok) {
+                const errMsg = `Failed to fetch owner record: HTTP ${ownerResult.status}`;
+                logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'redirect', assetId, error: errMsg, cardStatus: ownerResult.status }, ipAddress: req.ip });
+                let errorBody;
+                try { errorBody = JSON.parse(ownerResult.body); } catch (_) { errorBody = { error: ownerResult.body }; }
+                return res.status(ownerResult.status).json(errorBody);
+            }
+
+            let ownerData;
+            try { ownerData = JSON.parse(ownerResult.body); } catch (_) { ownerData = {}; }
+            const updateToken = ownerData.owner && ownerData.owner.update_token;
+
+            if (!updateToken) {
+                const errMsg = 'update_token not found in owner record.';
+                logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'redirect', assetId, error: errMsg, cardStatus: null }, ipAddress: req.ip });
+                return res.status(502).json({ error: 'CARD API request failed.', details: errMsg });
+            }
+
+            const redirectResult = await redirectAsset(assetId, fromTeam.trim(), toTeam.trim(), updateToken);
+
+            if (redirectResult.ok) {
+                await pool.query(
+                    "UPDATE ivanti_todo_queue SET status = 'complete', updated_at = NOW() WHERE id = $1",
+                    [queueItemId]
+                );
+
+                let cardResponse;
+                try { cardResponse = JSON.parse(redirectResult.body); } catch (_) { cardResponse = redirectResult.body; }
+
+                logAudit({ userId: req.user.id, username: req.user.username, action: 'card_redirect', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { assetId, fromTeam: fromTeam.trim(), toTeam: toTeam.trim(), cardStatus: redirectResult.status }, ipAddress: req.ip });
+
+                return res.json({ success: true, cardResponse });
+            }
+
+            const errMsg = `Redirect failed: HTTP ${redirectResult.status}`;
+            logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'redirect', assetId, error: errMsg, cardStatus: redirectResult.status }, ipAddress: req.ip });
+            let errorBody;
+            try { errorBody = JSON.parse(redirectResult.body); } catch (_) { errorBody = { error: redirectResult.body }; }
+            return res.status(redirectResult.status).json(errorBody);
+        } catch (err) {
+            logAudit({ userId: req.user.id, username: req.user.username, action: 'card_action_failed', entityType: 'ivanti_todo_queue', entityId: String(queueItemId), details: { actionType: 'redirect', assetId, error: err.message, cardStatus: null }, ipAddress: req.ip });
+            return handleCardError(err, res);
+        }
+    });
+
+    return router;
+}
+
+module.exports = createCardApiRouter;

backend/routes/feedback.js

@@ -0,0 +1,111 @@
+// Feedback route — proxies bug reports and feature requests to GitLab Issues API
+// Keeps the GitLab PAT server-side so it's never exposed to the browser.
+
+const express = require('express');
+const https = require('https');
+const http = require('http');
+const { requireAuth } = require('../middleware/auth');
+
+function createFeedbackRouter() {
+    const router = express.Router();
+
+    const GITLAB_URL = process.env.GITLAB_URL || '';
+    const GITLAB_PROJECT_ID = process.env.GITLAB_PROJECT_ID || '';
+    const GITLAB_PAT = process.env.GITLAB_PAT || '';
+
+    router.post('/', requireAuth(), async (req, res) => {
+        if (!GITLAB_URL || !GITLAB_PROJECT_ID || !GITLAB_PAT) {
+            return res.status(503).json({ error: 'Feedback integration not configured' });
+        }
+
+        const { type, title, description, page } = req.body;
+
+        if (!type || !title || !description) {
+            return res.status(400).json({ error: 'type, title, and description are required' });
+        }
+
+        if (!['bug', 'feature'].includes(type)) {
+            return res.status(400).json({ error: 'type must be "bug" or "feature"' });
+        }
+
+        const labels = type === 'bug' ? 'bug' : 'enhancement';
+        const prefix = type === 'bug' ? '🐛 Bug' : '✨ Feature Request';
+        const username = req.user?.username || 'unknown';
+
+        const body = [
+            `**Submitted by:** ${username}`,
+            page ? `**Page:** ${page}` : null,
+            `**Type:** ${prefix}`,
+            '',
+            '---',
+            '',
+            description,
+        ].filter(Boolean).join('\n');
+
+        const postData = JSON.stringify({
+            title: `[${prefix}] ${title}`,
+            description: body,
+            labels,
+        });
+
+        const apiUrl = `${GITLAB_URL.replace(/\/$/, '')}/api/v4/projects/${encodeURIComponent(GITLAB_PROJECT_ID)}/issues`;
+
+        try {
+            const result = await new Promise((resolve, reject) => {
+                const parsed = new URL(apiUrl);
+                const transport = parsed.protocol === 'https:' ? https : http;
+
+                const reqOpts = {
+                    method: 'POST',
+                    hostname: parsed.hostname,
+                    port: parsed.port,
+                    path: parsed.pathname + parsed.search,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'PRIVATE-TOKEN': GITLAB_PAT,
+                        'Content-Length': Buffer.byteLength(postData),
+                    },
+                    rejectAuthorized: false,
+                };
+
+                const apiReq = transport.request(reqOpts, (apiRes) => {
+                    let data = '';
+                    apiRes.on('data', chunk => data += chunk);
+                    apiRes.on('end', () => {
+                        try {
+                            resolve({ status: apiRes.statusCode, body: JSON.parse(data) });
+                        } catch {
+                            resolve({ status: apiRes.statusCode, body: data });
+                        }
+                    });
+                });
+
+                apiReq.on('error', reject);
+                apiReq.write(postData);
+                apiReq.end();
+            });
+
+            if (result.status === 201) {
+                console.log(`[Feedback] Issue #${result.body.iid} created by ${username}: ${title}`);
+                res.json({
+                    success: true,
+                    issue: {
+                        id: result.body.iid,
+                        url: result.body.web_url,
+                        title: result.body.title,
+                    },
+                });
+            } else {
+                console.error(`[Feedback] GitLab API returned ${result.status}:`, result.body);
+                res.status(502).json({ error: 'GitLab API error', details: result.body });
+            }
+        } catch (err) {
+            console.error('[Feedback] Request failed:', err.message);
+            res.status(502).json({ error: 'Failed to connect to GitLab' });
+        }
+    });
+
+    return router;
+}
+
+module.exports = createFeedbackRouter;

backend/routes/ivantiArchive.js

@@ -0,0 +1,149 @@
+// Ivanti Archive Routes — list, stats, and transition history for archived findings
+const express = require('express');
+const pool = require('../db');
+const { requireAuth } = require('../middleware/auth');
+
+const VALID_STATES = ['ACTIVE', 'ARCHIVED', 'RETURNED', 'CLOSED'];
+
+/**
+ * Find the most severe active finding related to an archived finding.
+ */
+function findRelatedActive(archive, activeFindings) {
+    const archiveTitle = (archive.finding_title || '').toLowerCase();
+
+    const matches = activeFindings.filter(f => {
+        if (f.hostName !== archive.host_name) return false;
+        if (f.id === archive.finding_id) return false;
+
+        const activeTitle = (f.title || '').toLowerCase();
+        if (!archiveTitle.includes(activeTitle) && !activeTitle.includes(archiveTitle)) return false;
+
+        return true;
+    });
+
+    if (matches.length === 0) return null;
+
+    const best = matches.reduce((a, b) => (b.severity > a.severity ? b : a));
+    return { id: best.id, title: best.title, severity: best.severity };
+}
+
+function createIvantiArchiveRouter() {
+    const router = express.Router();
+
+    // All routes require authentication
+    router.use(requireAuth());
+
+    // GET / — List archive records with optional state filtering
+    router.get('/', async (req, res) => {
+        const { state } = req.query;
+
+        if (state && !VALID_STATES.includes(state)) {
+            return res.status(400).json({
+                error: 'Invalid state parameter. Valid values: ACTIVE, ARCHIVED, RETURNED, CLOSED'
+            });
+        }
+
+        try {
+            let query = 'SELECT * FROM ivanti_finding_archives';
+            const params = [];
+            let paramIndex = 1;
+
+            if (state) {
+                query += ` WHERE current_state = $${paramIndex++}`;
+                params.push(state);
+            }
+
+            query += ' ORDER BY last_transition_at DESC';
+
+            const { rows: archives } = await pool.query(query, params);
+
+            // Fetch active findings for related-finding enrichment
+            // In the new schema, active findings are in ivanti_findings table
+            let activeFindings = [];
+            try {
+                const { rows: findingsRows } = await pool.query(
+                    `SELECT id, title, host_name AS "hostName", severity FROM ivanti_findings WHERE state = 'open'`
+                );
+                activeFindings = findingsRows;
+            } catch (cacheErr) {
+                console.warn('Failed to load findings for related-active matching:', cacheErr);
+            }
+
+            // Enrich each archive record with related active finding info
+            const enrichedArchives = archives.map(archive => ({
+                ...archive,
+                related_active: findRelatedActive(archive, activeFindings)
+            }));
+
+            res.json({ archives: enrichedArchives, total: enrichedArchives.length });
+        } catch (err) {
+            console.error('Archive list error:', err);
+            res.status(500).json({ error: 'Failed to fetch archive records' });
+        }
+    });
+
+    // GET /stats — Summary counts by lifecycle state
+    router.get('/stats', async (req, res) => {
+        try {
+            const { rows } = await pool.query(
+                `SELECT current_state, COUNT(*) as count
+                 FROM ivanti_finding_archives
+                 GROUP BY current_state`
+            );
+
+            const stats = { ACTIVE: 0, ARCHIVED: 0, RETURNED: 0, CLOSED: 0 };
+
+            for (const row of rows) {
+                if (stats.hasOwnProperty(row.current_state)) {
+                    stats[row.current_state] = parseInt(row.count);
+                }
+            }
+
+            // ACTIVE = total live findings count
+            const countResult = await pool.query(
+                `SELECT COUNT(*) as total FROM ivanti_findings WHERE state = 'open'`
+            );
+            stats.ACTIVE = parseInt(countResult.rows[0].total) || 0;
+
+            const total = stats.ACTIVE + stats.ARCHIVED + stats.RETURNED + stats.CLOSED;
+
+            res.json({ ...stats, total });
+        } catch (err) {
+            console.error('Archive stats error:', err);
+            res.status(500).json({ error: 'Failed to fetch archive stats' });
+        }
+    });
+
+    // GET /:findingId/history — Transition history for a specific archived finding
+    router.get('/:findingId/history', async (req, res) => {
+        const { findingId } = req.params;
+
+        try {
+            const { rows: archiveRows } = await pool.query(
+                'SELECT id FROM ivanti_finding_archives WHERE finding_id = $1',
+                [findingId]
+            );
+            const archive = archiveRows[0];
+
+            if (!archive) {
+                return res.json({ finding_id: findingId, transitions: [] });
+            }
+
+            const { rows: transitions } = await pool.query(
+                `SELECT * FROM ivanti_archive_transitions
+                 WHERE archive_id = $1
+                 ORDER BY transitioned_at DESC`,
+                [archive.id]
+            );
+
+            res.json({ finding_id: findingId, transitions });
+        } catch (err) {
+            console.error('Archive history error:', err);
+            res.status(500).json({ error: 'Failed to fetch transition history' });
+        }
+    });
+
+    return router;
+}
+
+module.exports = createIvantiArchiveRouter;

backend/routes/ivantiFpWorkflow.js

@@ -0,0 +1,789 @@
+// routes/ivantiFpWorkflow.js
+const express = require('express');
+const multer = require('multer');
+const path = require('path');
+const fs = require('fs');
+const pool = require('../db');
+const { requireAuth, requireGroup } = require('../middleware/auth');
+const { ivantiFormPost, ivantiPost } = require('../helpers/ivantiApi');
+const logAudit = require('../helpers/auditLog');
+
+// ---------------------------------------------------------------------------
+// Pure helpers (exported for testing)
+// ---------------------------------------------------------------------------
+
+const ALLOWED_EXTENSIONS = new Set([
+    '.pdf', '.png', '.jpg', '.jpeg', '.gif',
+    '.doc', '.docx', '.xlsx', '.csv', '.txt', '.zip'
+]);
+
+function isAllowedFileExtension(filename) {
+    if (!filename || typeof filename !== 'string') return false;
+    const ext = path.extname(filename).toLowerCase();
+    return ALLOWED_EXTENSIONS.has(ext);
+}
+
+function validateFpWorkflowForm(body) {
+    const errors = {};
+    if (!body.name || typeof body.name !== 'string' || body.name.trim().length === 0) {
+        errors.name = 'Workflow name is required.';
+    } else if (body.name.trim().length > 255) {
+        errors.name = 'Workflow name must be 255 characters or fewer.';
+    }
+    if (!body.reason || typeof body.reason !== 'string' || body.reason.trim().length === 0) {
+        errors.reason = 'Reason is required.';
+    }
+    if (body.description !== undefined && body.description !== null && body.description !== '') {
+        if (typeof body.description !== 'string') errors.description = 'Description must be a string.';
+        else if (body.description.length > 2000) errors.description = 'Description must be 2000 characters or fewer.';
+    }
+    if (!body.expirationDate || typeof body.expirationDate !== 'string' || body.expirationDate.trim().length === 0) {
+        errors.expirationDate = 'Expiration date is required.';
+    } else {
+        const parsed = new Date(body.expirationDate);
+        if (isNaN(parsed.getTime())) {
+            errors.expirationDate = 'Expiration date must be a valid date.';
+        } else {
+            const today = new Date(); today.setHours(0, 0, 0, 0);
+            const expDay = new Date(parsed); expDay.setHours(0, 0, 0, 0);
+            if (expDay <= today) errors.expirationDate = 'Expiration date must be in the future.';
+            else { const maxDate = new Date(today); maxDate.setDate(maxDate.getDate() + 120); if (expDay > maxDate) errors.expirationDate = 'Expiration date cannot be more than 120 days from today.'; }
+        }
+    }
+    return errors;
+}
+
+function buildSubjectFilterRequest(findingIds) {
+    return JSON.stringify({ subject: 'hostFinding', filterRequest: { filters: [{ field: 'id', exclusive: false, operator: 'IN', value: findingIds.map(id => String(id)).join(',') }] } });
+}
+
+function buildIvantiFormFields(formData, findingIds) {
+    const scopeMap = { 'Authorized': 'AUTHORIZED', 'None': 'NONE', 'Automated': 'AUTOMATED' };
+    return [
+        { name: 'name', value: formData.name },
+        { name: 'reason', value: formData.reason },
+        { name: 'description', value: formData.description || '' },
+        { name: 'expirationDate', value: formData.expirationDate },
+        { name: 'overrideControl', value: scopeMap[formData.scopeOverride] || 'AUTHORIZED' },
+        { name: 'subjectFilterRequest', value: buildSubjectFilterRequest(findingIds) },
+        { name: 'isEmptyWorkflow', value: findingIds.length === 0 ? 'true' : 'false' }
+    ];
+}
+
+const LIFECYCLE_STATUSES = new Set(['submitted', 'approved', 'rejected', 'rework', 'resubmitted']);
+
+function validateLifecycleTransition(currentStatus, newStatus) {
+    if (currentStatus === 'approved') return { valid: false, error: 'This submission is finalized and cannot be edited.' };
+    if (!LIFECYCLE_STATUSES.has(newStatus)) return { valid: false, error: 'Invalid lifecycle status.' };
+    return { valid: true };
+}
+
+function mergeFindings(existingJson, newIds) {
+    const existing = JSON.parse(existingJson || '[]');
+    const merged = [...new Set([...existing, ...newIds])];
+    return JSON.stringify(merged);
+}
+
+function buildSubmissionHistoryEntry(changeType, details, userId, username) {
+    return { user_id: userId, username: username, change_type: changeType, change_details_json: JSON.stringify(details), created_at: new Date().toISOString() };
+}
+
+// ---------------------------------------------------------------------------
+// Resolve workflow batch UUID
+// ---------------------------------------------------------------------------
+async function resolveWorkflowBatchUuid(submission, apiKey, clientId, skipTls) {
+    if (submission.ivanti_workflow_batch_uuid) return submission.ivanti_workflow_batch_uuid;
+
+    const searchUrl = `/client/${encodeURIComponent(clientId)}/workflowBatch/search`;
+    const workflowName = submission.workflow_name || '';
+    const searchBody = { filters: workflowName ? [{ field: 'name', exclusive: false, operator: 'EXACT', value: workflowName }] : [], projection: 'internal', sort: [{ field: 'created', direction: 'DESC' }], page: 0, size: 10 };
+
+    let result;
+    try { result = await ivantiPost(searchUrl, searchBody, apiKey, skipTls); } catch (e) { return null; }
+    if (result.status !== 200) return null;
+
+    let uuid = null;
+    try {
+        const data = JSON.parse(result.body);
+        let batches = data._embedded?.workflowBatches || data._embedded?.workflowBatch || data.content || data.data || (Array.isArray(data) ? data : []);
+        const batchId = String(submission.ivanti_workflow_batch_id);
+        const batch = batches.find(b => String(b.id) === batchId) || batches[0];
+        if (batch) uuid = batch.uuid || batch.workflowBatchUuid || batch.batchUuid || batch.groupUuid || batch.group_uuid || batch.workflow_batch_uuid || batch.uid || null;
+    } catch (e) { return null; }
+
+    if (uuid && submission.id) {
+        pool.query(`UPDATE ivanti_fp_submissions SET ivanti_workflow_batch_uuid = $1 WHERE id = $2`, [uuid, submission.id]).catch(() => {});
+    }
+    return uuid;
+}
+
+// ---------------------------------------------------------------------------
+// Multer configuration
+// ---------------------------------------------------------------------------
+const uploadStorage = multer.memoryStorage();
+const fpUpload = multer({ storage: uploadStorage, limits: { fileSize: 10 * 1024 * 1024 }, fileFilter: (req, file, cb) => { if (isAllowedFileExtension(file.originalname)) cb(null, true); else cb(new Error(`File type not allowed: ${path.extname(file.originalname)}`)); } }).array('attachments', 10);
+
+// ---------------------------------------------------------------------------
+// Router factory
+// ---------------------------------------------------------------------------
+function createIvantiFpWorkflowRouter() {
+    const router = express.Router();
+
+    // GET /documents/search
+    router.get('/documents/search', requireAuth(), async (req, res) => {
+        const q = (req.query.q || '').trim();
+        try {
+            let rows;
+            if (q) {
+                const like = `%${q}%`;
+                const result = await pool.query(
+                    `SELECT id, cve_id, vendor, name, type, file_size, mime_type, uploaded_at FROM documents WHERE name ILIKE $1 OR cve_id ILIKE $2 OR vendor ILIKE $3 ORDER BY uploaded_at DESC LIMIT 50`,
+                    [like, like, like]
+                );
+                rows = result.rows;
+            } else {
+                const result = await pool.query(`SELECT id, cve_id, vendor, name, type, file_size, mime_type, uploaded_at FROM documents ORDER BY uploaded_at DESC LIMIT 50`);
+                rows = result.rows;
+            }
+            res.json(rows || []);
+        } catch (err) {
+            console.error('Error searching documents:', err);
+            res.status(500).json({ error: 'Database error.' });
+        }
+    });
+
+    // POST / — Create FP workflow
+    router.post('/', requireAuth(), requireGroup('Admin', 'Standard_User'), (req, res) => {
+        fpUpload(req, res, (multerErr) => {
+            if (multerErr) {
+                if (multerErr.code === 'LIMIT_FILE_SIZE') return res.status(400).json({ error: 'File exceeds the 10 MB size limit.' });
+                return res.status(400).json({ error: multerErr.message });
+            }
+
+            let findingIds, queueItemIds;
+            try { findingIds = JSON.parse(req.body.findingIds || '[]'); queueItemIds = JSON.parse(req.body.queueItemIds || '[]'); }
+            catch (e) { return res.status(400).json({ error: 'findingIds and queueItemIds must be valid JSON arrays.' }); }
+
+            if (!Array.isArray(findingIds) || findingIds.length === 0) return res.status(400).json({ error: 'At least one finding ID is required.' });
+            if (!Array.isArray(queueItemIds) || queueItemIds.length === 0) return res.status(400).json({ error: 'At least one queue item ID is required.' });
+
+            let libraryDocIds;
+            try { libraryDocIds = JSON.parse(req.body.libraryDocIds || '[]'); } catch (e) { return res.status(400).json({ error: 'libraryDocIds must be a valid JSON array.' }); }
+            if (!Array.isArray(libraryDocIds)) return res.status(400).json({ error: 'libraryDocIds must be a valid JSON array.' });
+            for (const id of libraryDocIds) { if (!Number.isInteger(id) || id <= 0) return res.status(400).json({ error: `Invalid library document ID: ${id}.` }); }
+
+            const validationErrors = validateFpWorkflowForm(req.body);
+            if (Object.keys(validationErrors).length > 0) return res.status(400).json({ success: false, errors: validationErrors });
+
+            const files = req.files || [];
+            for (const file of files) { if (!isAllowedFileExtension(file.originalname)) return res.status(400).json({ error: `File type not allowed: ${file.originalname}` }); }
+
+            (async () => {
+                // Verify queue items
+                const { rows: queueRows } = await pool.query(
+                    `SELECT id, workflow_type, status, user_id FROM ivanti_todo_queue WHERE id = ANY($1)`, [queueItemIds]
+                );
+                if (!queueRows || queueRows.length !== queueItemIds.length) return res.status(400).json({ error: 'One or more queue items not found.' });
+                for (const row of queueRows) {
+                    if (row.user_id !== req.user.id) return res.status(403).json({ error: 'You can only submit your own queue items.' });
+                    if (row.workflow_type !== 'FP') return res.status(400).json({ error: `Queue item ${row.id} is not an FP workflow type.` });
+                    if (row.status !== 'pending') return res.status(400).json({ error: `Queue item ${row.id} is not in pending status.` });
+                }
+
+                const apiKey = process.env.IVANTI_API_KEY;
+                const clientId = process.env.IVANTI_CLIENT_ID || '1550';
+                const skipTls = process.env.IVANTI_SKIP_TLS === 'true';
+                if (!apiKey) return res.status(500).json({ success: false, error: 'Ivanti API key is not configured.', step: 'create_workflow' });
+
+                const formFields = buildIvantiFormFields(req.body, findingIds);
+
+                // Look up library documents
+                let libraryDocs = [];
+                const libraryAttachmentResults = [];
+                if (libraryDocIds.length > 0) {
+                    const { rows: docRows } = await pool.query(`SELECT id, name, file_path, file_size, mime_type FROM documents WHERE id = ANY($1)`, [libraryDocIds]);
+                    libraryDocs = docRows;
+                    const foundIds = new Set(libraryDocs.map(d => d.id));
+                    const missingIds = libraryDocIds.filter(id => !foundIds.has(id));
+                    if (missingIds.length > 0) return res.status(400).json({ error: `Library document IDs not found: ${missingIds.join(', ')}` });
+                }
+
+                const libraryFormFiles = [];
+                for (const doc of libraryDocs) {
+                    try { const buffer = fs.readFileSync(doc.file_path); libraryFormFiles.push({ name: 'files', buffer, filename: doc.name }); libraryAttachmentResults.push({ filename: doc.name, success: true, source: 'library', documentId: doc.id }); }
+                    catch (readErr) { libraryAttachmentResults.push({ success: false, error: 'File not found on disk', source: 'library', documentId: doc.id, filename: doc.name }); }
+                }
+
+                const localFormFiles = files.map(f => ({ name: 'files', buffer: f.buffer, filename: f.originalname }));
+                const formFiles = [...localFormFiles, ...libraryFormFiles];
+                const createUrl = `/client/${encodeURIComponent(clientId)}/workflowBatch/falsePositive/request`;
+
+                let createResult;
+                try { createResult = await ivantiFormPost(createUrl, formFields, formFiles, apiKey, skipTls); }
+                catch (networkErr) {
+                    logAudit({ userId: req.user.id, username: req.user.username, action: 'ivanti_fp_workflow_failed', entityType: 'ivanti_workflow', details: { error: networkErr.message, findingIds }, ipAddress: req.ip });
+                    return res.status(502).json({ success: false, error: 'Failed to connect to Ivanti API.', step: 'create_workflow', details: networkErr.message });
+                }
+
+                if (createResult.status !== 200 && createResult.status !== 201 && createResult.status !== 202) {
+                    const errorMap = { 401: 'Ivanti API key is invalid or missing.', 419: 'API key lacks workflow creation permissions.', 429: 'Ivanti API rate limit reached.' };
+                    const errorMsg = errorMap[createResult.status] || `Workflow creation failed: ${createResult.status}`;
+                    logAudit({ userId: req.user.id, username: req.user.username, action: 'ivanti_fp_workflow_failed', entityType: 'ivanti_workflow', details: { error: errorMsg, status: createResult.status, findingIds }, ipAddress: req.ip });
+                    return res.status(createResult.status === 429 ? 429 : 502).json({ success: false, error: errorMsg, step: 'create_workflow' });
+                }
+
+                let workflowBatchId;
+                try { const createData = JSON.parse(createResult.body); workflowBatchId = createData.id; }
+                catch (parseErr) { return res.status(502).json({ success: false, error: 'Failed to parse Ivanti API response.', step: 'create_workflow' }); }
+
+                let workflowBatchUuid = null;
+                try { workflowBatchUuid = await resolveWorkflowBatchUuid({ id: null, ivanti_workflow_batch_id: workflowBatchId, ivanti_workflow_batch_uuid: null, workflow_name: req.body.name }, apiKey, clientId, skipTls); } catch (e) {}
+
+                const localAttachmentResults = files.map(f => ({ filename: f.originalname, success: true, source: 'local' }));
+                const allAttachmentResults = [...localAttachmentResults, ...libraryAttachmentResults];
+                const totalAttachmentCount = files.length + libraryDocIds.length;
+
+                try {
+                    await pool.query(
+                        `INSERT INTO ivanti_fp_submissions (user_id, username, ivanti_workflow_batch_id, ivanti_workflow_batch_uuid, ivanti_generated_id, workflow_name, reason, description, expiration_date, scope_override, finding_ids_json, queue_item_ids_json, attachment_count, attachment_results_json, status, error_message)
+                         VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16)`,
+                        [req.user.id, req.user.username, workflowBatchId, workflowBatchUuid, null, req.body.name, req.body.reason, req.body.description || null, req.body.expirationDate, req.body.scopeOverride || 'Authorized', JSON.stringify(findingIds), JSON.stringify(queueItemIds), totalAttachmentCount, JSON.stringify(allAttachmentResults), 'success', null]
+                    );
+                } catch (dbErr) { console.error('Failed to insert submission record:', dbErr); }
+
+                logAudit({ userId: req.user.id, username: req.user.username, action: 'ivanti_fp_workflow_created', entityType: 'ivanti_workflow', entityId: String(workflowBatchId), details: { workflowName: req.body.name, findingIds, attachmentCount: totalAttachmentCount, status: 'success' }, ipAddress: req.ip });
+
+                let queueItemsUpdated = 0;
+                try {
+                    const qResult = await pool.query(`UPDATE ivanti_todo_queue SET status='complete', updated_at=NOW() WHERE id = ANY($1) AND user_id=$2`, [queueItemIds, req.user.id]);
+                    queueItemsUpdated = qResult.rowCount;
+                } catch (queueErr) { console.error('Failed to update queue items:', queueErr); }
+
+                res.json({ success: true, workflowBatchId, queueItemsUpdated, status: 'success' });
+            })().catch((unexpectedErr) => { console.error('Unexpected error in FP workflow submission:', unexpectedErr); res.status(500).json({ success: false, error: 'Internal server error.' }); });
+        });
+    });
+
+    // GET /submissions
+    router.get('/submissions', requireAuth(), async (req, res) => {
+        try {
+            const { rows: submissions } = await pool.query(`SELECT * FROM ivanti_fp_submissions WHERE user_id = $1 ORDER BY created_at DESC`, [req.user.id]);
+
+            if (submissions.length > 0) {
+                const submissionIds = submissions.map(s => s.id);
+                const { rows: historyRows } = await pool.query(`SELECT * FROM ivanti_fp_submission_history WHERE submission_id = ANY($1) ORDER BY created_at ASC`, [submissionIds]);
+                const historyMap = {};
+                for (const row of historyRows) { if (!historyMap[row.submission_id]) historyMap[row.submission_id] = []; historyMap[row.submission_id].push(row); }
+                for (const sub of submissions) { sub.history = historyMap[sub.id] || []; }
+
+                const apiKey = process.env.IVANTI_API_KEY;
+                const clientId = process.env.IVANTI_CLIENT_ID || '1550';
+                const skipTls = process.env.IVANTI_SKIP_TLS === 'true';
+                if (apiKey) {
+                    try {
+                        for (const sub of submissions) {
+                            if (!sub.workflow_name) continue;
+                            const searchUrl = `/client/${encodeURIComponent(clientId)}/workflowBatch/search`;
+                            const searchBody = { filters: [{ field: 'name', exclusive: false, operator: 'EXACT', value: sub.workflow_name }], projection: 'internal', sort: [{ field: 'created', direction: 'DESC' }], page: 0, size: 1 };
+                            const result = await ivantiPost(searchUrl, searchBody, apiKey, skipTls);
+                            if (result.status === 200) {
+                                const data = JSON.parse(result.body);
+                                const batches = data._embedded?.workflowBatches || data._embedded?.workflowBatch || [];
+                                const batch = batches[0];
+                                if (batch) { sub.ivanti_rework_note = batch.reworkNote || null; sub.ivanti_approval_note = batch.approvalNote || null; sub.ivanti_current_state_notes = batch.currentStateUserNotes || null; sub.ivanti_previous_state_notes = batch.previousStateUserNotes || null; sub.ivanti_current_state = batch.currentState || null; }
+                            }
+                        }
+                    } catch (e) { console.error('Error enriching submissions with Ivanti notes:', e.message); }
+                }
+            }
+            res.json(submissions);
+        } catch (err) { console.error('Error fetching FP submissions:', err); res.status(500).json({ error: 'Internal server error.' }); }
+    });
+
+    // PUT /submissions/:id — Edit FP workflow fields
+    router.put('/submissions/:id', requireAuth(), requireGroup('Admin', 'Standard_User'), (req, res) => {
+        (async () => {
+            const submissionId = req.params.id;
+
+            // 1. Fetch submission and verify ownership
+            const { rows: subRows } = await pool.query(
+                `SELECT * FROM ivanti_fp_submissions WHERE id = $1`, [submissionId]
+            );
+            const submission = subRows[0];
+
+            if (!submission) {
+                return res.status(404).json({ error: 'Submission not found.' });
+            }
+            if (submission.user_id !== req.user.id) {
+                return res.status(403).json({ error: 'You can only edit your own submissions.' });
+            }
+
+            // 2. Lifecycle guard
+            if (submission.lifecycle_status === 'approved') {
+                return res.status(400).json({ error: 'This submission is finalized and cannot be edited.' });
+            }
+
+            // 3. Validate body
+            const validationErrors = validateFpWorkflowForm(req.body);
+            if (Object.keys(validationErrors).length > 0) {
+                return res.status(400).json({ success: false, errors: validationErrors });
+            }
+
+            // 4. Proxy to Ivanti
+            const apiKey = process.env.IVANTI_API_KEY;
+            const clientId = process.env.IVANTI_CLIENT_ID || '1550';
+            const skipTls = process.env.IVANTI_SKIP_TLS === 'true';
+
+            if (!apiKey) {
+                return res.status(500).json({ success: false, error: 'Ivanti API key is not configured.' });
+            }
+
+            const scopeMap = { 'Authorized': 'AUTHORIZED', 'None': 'NONE', 'Automated': 'AUTOMATED' };
+            const updateUrl = `/client/${encodeURIComponent(clientId)}/workflowBatch/falsePositive/update`;
+            const updateBody = {
+                id: submission.ivanti_workflow_batch_id,
+                name: req.body.name,
+                reason: req.body.reason,
+                description: req.body.description || '',
+                expirationDate: req.body.expirationDate,
+                overrideControl: scopeMap[req.body.scopeOverride] || 'AUTHORIZED'
+            };
+
+            let ivantiResult;
+            try {
+                ivantiResult = await ivantiPost(updateUrl, updateBody, apiKey, skipTls);
+            } catch (networkErr) {
+                logAudit({
+                    userId: req.user.id, username: req.user.username,
+                    action: 'ivanti_fp_submission_edit_failed', entityType: 'ivanti_workflow',
+                    details: { error: networkErr.message, submissionId },
+                    ipAddress: req.ip
+                });
+                return res.status(502).json({ success: false, error: 'Failed to connect to Ivanti API.', details: networkErr.message });
+            }
+
+            if (ivantiResult.status !== 200 && ivantiResult.status !== 201 && ivantiResult.status !== 202) {
+                const errorMap = {
+                    401: 'Ivanti API key is invalid or missing. Contact your administrator.',
+                    419: 'API key lacks permissions for this operation.',
+                    429: 'Ivanti API rate limit reached. Please try again in a few minutes.'
+                };
+                const errorMsg = ivantiResult.status >= 500
+                    ? 'Ivanti API is temporarily unavailable. Please try again later.'
+                    : (errorMap[ivantiResult.status] || `Operation failed: ${ivantiResult.status}`);
+                return res.status(ivantiResult.status === 429 ? 429 : 502).json({ success: false, error: errorMsg });
+            }
+
+            // 5. Determine new lifecycle_status
+            let newLifecycleStatus = submission.lifecycle_status;
+            if (submission.lifecycle_status === 'rejected' || submission.lifecycle_status === 'rework') {
+                newLifecycleStatus = 'resubmitted';
+            }
+
+            // 6. Update local record
+            try {
+                await pool.query(
+                    `UPDATE ivanti_fp_submissions
+                     SET workflow_name = $1, reason = $2, description = $3, expiration_date = $4, scope_override = $5, lifecycle_status = $6, updated_at = NOW()
+                     WHERE id = $7`,
+                    [req.body.name, req.body.reason, req.body.description || null, req.body.expirationDate, req.body.scopeOverride || 'Authorized', newLifecycleStatus, submissionId]
+                );
+            } catch (dbErr) {
+                console.error('Failed to update submission record:', dbErr);
+                return res.status(500).json({ success: false, error: 'Failed to update local record.' });
+            }
+
+            // 7. Insert history row
+            const historyEntry = buildSubmissionHistoryEntry('fields_updated', {
+                changed: {
+                    name: { from: submission.workflow_name, to: req.body.name },
+                    reason: { from: submission.reason, to: req.body.reason },
+                    description: { from: submission.description, to: req.body.description || '' },
+                    expirationDate: { from: submission.expiration_date, to: req.body.expirationDate },
+                    scopeOverride: { from: submission.scope_override, to: req.body.scopeOverride || 'Authorized' }
+                }
+            }, req.user.id, req.user.username);
+
+            try {
+                await pool.query(
+                    `INSERT INTO ivanti_fp_submission_history (submission_id, user_id, username, change_type, change_details_json, created_at)
+                     VALUES ($1, $2, $3, $4, $5, NOW())`,
+                    [submissionId, historyEntry.user_id, historyEntry.username, historyEntry.change_type, historyEntry.change_details_json]
+                );
+            } catch (histErr) {
+                console.error('Failed to insert history row:', histErr);
+            }
+
+            // 8. Audit log
+            logAudit({
+                userId: req.user.id, username: req.user.username,
+                action: 'ivanti_fp_submission_edited', entityType: 'ivanti_workflow',
+                entityId: String(submission.ivanti_workflow_batch_id),
+                details: { submissionId, workflowName: req.body.name },
+                ipAddress: req.ip
+            });
+
+            // 9. Return updated record
+            const { rows: updatedRows } = await pool.query(
+                `SELECT * FROM ivanti_fp_submissions WHERE id = $1`, [submissionId]
+            );
+
+            res.json({ success: true, submission: updatedRows[0] });
+        })().catch((unexpectedErr) => {
+            console.error('Unexpected error in PUT /submissions/:id:', unexpectedErr);
+            res.status(500).json({ success: false, error: 'Internal server error.' });
+        });
+    });
+
+    // POST /submissions/:id/findings — Map additional findings to existing workflow
+    router.post('/submissions/:id/findings', requireAuth(), requireGroup('Admin', 'Standard_User'), (req, res) => {
+        (async () => {
+            const submissionId = req.params.id;
+            const { findingIds, queueItemIds } = req.body;
+
+            if (!Array.isArray(findingIds) || findingIds.length === 0) {
+                return res.status(400).json({ error: 'At least one finding ID is required.' });
+            }
+            if (!Array.isArray(queueItemIds) || queueItemIds.length === 0) {
+                return res.status(400).json({ error: 'At least one queue item ID is required.' });
+            }
+
+            // 1. Fetch submission and verify ownership
+            const { rows: subRows } = await pool.query(
+                `SELECT * FROM ivanti_fp_submissions WHERE id = $1`, [submissionId]
+            );
+            const submission = subRows[0];
+
+            if (!submission) {
+                return res.status(404).json({ error: 'Submission not found.' });
+            }
+            if (submission.user_id !== req.user.id) {
+                return res.status(403).json({ error: 'You can only edit your own submissions.' });
+            }
+
+            // 2. Lifecycle guard
+            if (submission.lifecycle_status === 'approved') {
+                return res.status(400).json({ error: 'This submission is finalized and cannot be edited.' });
+            }
+
+            // 3. Verify queue items belong to user, are FP type, and pending
+            const { rows: queueRows } = await pool.query(
+                `SELECT id, workflow_type, status, user_id FROM ivanti_todo_queue WHERE id = ANY($1)`,
+                [queueItemIds]
+            );
+
+            if (queueRows.length !== queueItemIds.length) {
+                return res.status(400).json({ error: 'One or more queue items not found.' });
+            }
+            for (const row of queueRows) {
+                if (row.user_id !== req.user.id) {
+                    return res.status(403).json({ error: 'You can only submit your own queue items.' });
+                }
+                if (row.workflow_type !== 'FP') {
+                    return res.status(400).json({ error: `Queue item ${row.id} is not an FP workflow type.` });
+                }
+                if (row.status !== 'pending') {
+                    return res.status(400).json({ error: `Queue item ${row.id} is not in pending status.` });
+                }
+            }
+
+            // 4. Proxy to Ivanti map endpoint
+            const apiKey = process.env.IVANTI_API_KEY;
+            const clientId = process.env.IVANTI_CLIENT_ID || '1550';
+            const skipTls = process.env.IVANTI_SKIP_TLS === 'true';
+
+            if (!apiKey) {
+                return res.status(500).json({ success: false, error: 'Ivanti API key is not configured.' });
+            }
+
+            const mapUuid = await resolveWorkflowBatchUuid(submission, apiKey, clientId, skipTls);
+            if (!mapUuid) {
+                return res.status(400).json({ success: false, error: 'Could not resolve workflow batch UUID. The workflow may not exist in Ivanti.' });
+            }
+
+            const mapUrl = `/client/${encodeURIComponent(clientId)}/workflowBatch/falsePositive/${encodeURIComponent(mapUuid)}/map`;
+
+            const mappedIds = [];
+            const failedIds = [];
+            for (const fid of findingIds) {
+                const mapBody = {
+                    subject: 'hostFinding',
+                    filterRequest: {
+                        filters: [{ field: 'id', exclusive: false, operator: 'EXACT', value: String(fid) }]
+                    }
+                };
+                try {
+                    const result = await ivantiPost(mapUrl, mapBody, apiKey, skipTls);
+                    if (result.status === 200 || result.status === 201 || result.status === 202) {
+                        mappedIds.push(fid);
+                    } else {
+                        failedIds.push({ id: fid, status: result.status });
+                    }
+                } catch (err) {
+                    failedIds.push({ id: fid, error: err.message });
+                }
+            }
+
+            if (mappedIds.length === 0) {
+                return res.status(502).json({ success: false, error: 'Failed to map any findings to the workflow.' });
+            }
+
+            // 5. Merge only successfully mapped finding IDs
+            const mergedJson = mergeFindings(submission.finding_ids_json, mappedIds);
+
+            try {
+                await pool.query(
+                    `UPDATE ivanti_fp_submissions SET finding_ids_json = $1, updated_at = NOW() WHERE id = $2`,
+                    [mergedJson, submissionId]
+                );
+            } catch (dbErr) {
+                console.error('Failed to update finding_ids_json:', dbErr);
+            }
+
+            // 6. Mark only successfully mapped queue items as complete
+            let queueItemsUpdated = 0;
+            const mappedSet = new Set(mappedIds.map(String));
+            const successQueueIds = queueItemIds.filter((qid, idx) => {
+                const queueItem = queueRows.find(r => r.id === qid);
+                return queueItem && mappedSet.has(String(findingIds[idx]));
+            });
+            if (successQueueIds.length > 0) {
+                try {
+                    const qResult = await pool.query(
+                        `UPDATE ivanti_todo_queue SET status='complete', updated_at=NOW() WHERE id = ANY($1) AND user_id=$2`,
+                        [successQueueIds, req.user.id]
+                    );
+                    queueItemsUpdated = qResult.rowCount;
+                } catch (queueErr) {
+                    console.error('Failed to update queue items:', queueErr);
+                }
+            }
+
+            // 7. Insert history row
+            const historyEntry = buildSubmissionHistoryEntry('findings_added', {
+                addedFindingIds: mappedIds,
+                failedFindingIds: failedIds.map(f => f.id || f),
+                queueItemIds: successQueueIds
+            }, req.user.id, req.user.username);
+
+            try {
+                await pool.query(
+                    `INSERT INTO ivanti_fp_submission_history (submission_id, user_id, username, change_type, change_details_json, created_at)
+                     VALUES ($1, $2, $3, $4, $5, NOW())`,
+                    [submissionId, historyEntry.user_id, historyEntry.username, historyEntry.change_type, historyEntry.change_details_json]
+                );
+            } catch (histErr) {
+                console.error('Failed to insert history row:', histErr);
+            }
+
+            // 8. Audit log
+            logAudit({
+                userId: req.user.id, username: req.user.username,
+                action: 'ivanti_fp_findings_added', entityType: 'ivanti_workflow',
+                entityId: String(submission.ivanti_workflow_batch_id),
+                details: { submissionId, addedFindingIds: findingIds, queueItemsUpdated },
+                ipAddress: req.ip
+            });
+
+            res.json({ success: true, addedFindings: mappedIds, failedFindings: failedIds, queueItemsUpdated });
+        })().catch((unexpectedErr) => {
+            console.error('Unexpected error in POST /submissions/:id/findings:', unexpectedErr);
+            res.status(500).json({ success: false, error: 'Internal server error.' });
+        });
+    });
+
+    // POST /submissions/:id/attachments — Upload additional attachments
+    router.post('/submissions/:id/attachments', requireAuth(), requireGroup('Admin', 'Standard_User'), (req, res) => {
+        fpUpload(req, res, (multerErr) => {
+            if (multerErr) {
+                if (multerErr.code === 'LIMIT_FILE_SIZE') {
+                    return res.status(400).json({ error: 'File exceeds the 10 MB size limit.' });
+                }
+                return res.status(400).json({ error: multerErr.message });
+            }
+
+            const files = req.files || [];
+
+            let libraryDocIds;
+            try { libraryDocIds = JSON.parse(req.body.libraryDocIds || '[]'); }
+            catch (e) { return res.status(400).json({ error: 'libraryDocIds must be a valid JSON array.' }); }
+            if (!Array.isArray(libraryDocIds)) return res.status(400).json({ error: 'libraryDocIds must be a valid JSON array.' });
+            for (const id of libraryDocIds) { if (!Number.isInteger(id) || id <= 0) return res.status(400).json({ error: `Invalid library document ID: ${id}.` }); }
+
+            if (files.length === 0 && libraryDocIds.length === 0) {
+                return res.status(400).json({ error: 'At least one file or library document is required.' });
+            }
+
+            for (const file of files) {
+                if (!isAllowedFileExtension(file.originalname)) {
+                    return res.status(400).json({ error: `File type not allowed: ${file.originalname}` });
+                }
+            }
+
+            (async () => {
+                const submissionId = req.params.id;
+
+                const { rows: subRows } = await pool.query(
+                    `SELECT * FROM ivanti_fp_submissions WHERE id = $1`, [submissionId]
+                );
+                const submission = subRows[0];
+
+                if (!submission) return res.status(404).json({ error: 'Submission not found.' });
+                if (submission.user_id !== req.user.id) return res.status(403).json({ error: 'You can only edit your own submissions.' });
+                if (submission.lifecycle_status === 'approved') return res.status(400).json({ error: 'This submission is finalized and cannot be edited.' });
+
+                // Look up library documents
+                let libraryDocs = [];
+                if (libraryDocIds.length > 0) {
+                    const { rows: docRows } = await pool.query(
+                        `SELECT id, name, file_path, file_size, mime_type FROM documents WHERE id = ANY($1)`, [libraryDocIds]
+                    );
+                    libraryDocs = docRows;
+                    const foundIds = new Set(libraryDocs.map(d => d.id));
+                    const missingIds = libraryDocIds.filter(id => !foundIds.has(id));
+                    if (missingIds.length > 0) return res.status(400).json({ error: `Library document IDs not found: ${missingIds.join(', ')}` });
+                }
+
+                const apiKey = process.env.IVANTI_API_KEY;
+                const clientId = process.env.IVANTI_CLIENT_ID || '1550';
+                const skipTls = process.env.IVANTI_SKIP_TLS === 'true';
+
+                if (!apiKey) return res.status(500).json({ success: false, error: 'Ivanti API key is not configured.' });
+
+                const attachUuid = await resolveWorkflowBatchUuid(submission, apiKey, clientId, skipTls);
+                if (!attachUuid) return res.status(400).json({ success: false, error: 'Could not resolve workflow batch UUID.' });
+
+                const attachUrl = `/client/${encodeURIComponent(clientId)}/workflowBatch/falsePositive/${encodeURIComponent(attachUuid)}/attach`;
+                const attachmentResults = [];
+
+                // Upload local files
+                for (const f of files) {
+                    try {
+                        const formFiles = [{ name: 'file', buffer: f.buffer, filename: f.originalname, contentType: f.mimetype || 'application/octet-stream' }];
+                        const result = await ivantiFormPost(attachUrl, [], formFiles, apiKey, skipTls);
+                        const success = result.status === 200 || result.status === 201 || result.status === 202;
+                        attachmentResults.push({ filename: f.originalname, success, source: 'local', ...(success ? {} : { error: `Upload failed: ${result.status}` }) });
+                    } catch (uploadErr) {
+                        attachmentResults.push({ filename: f.originalname, success: false, source: 'local', error: uploadErr.message });
+                    }
+                }
+
+                // Upload library files
+                for (const doc of libraryDocs) {
+                    let buffer;
+                    try { buffer = fs.readFileSync(doc.file_path); }
+                    catch (readErr) { attachmentResults.push({ success: false, error: 'File not found on disk', source: 'library', documentId: doc.id, filename: doc.name }); continue; }
+                    try {
+                        const formFiles = [{ name: 'file', buffer, filename: doc.name, contentType: doc.mime_type || 'application/octet-stream' }];
+                        const result = await ivantiFormPost(attachUrl, [], formFiles, apiKey, skipTls);
+                        const success = result.status === 200 || result.status === 201 || result.status === 202;
+                        attachmentResults.push({ filename: doc.name, success, source: 'library', documentId: doc.id, ...(success ? {} : { error: `Upload failed: ${result.status}` }) });
+                    } catch (uploadErr) {
+                        attachmentResults.push({ filename: doc.name, success: false, source: 'library', documentId: doc.id, error: uploadErr.message });
+                    }
+                }
+
+                // Update attachment_count and attachment_results_json
+                const existingResults = JSON.parse(submission.attachment_results_json || '[]');
+                const allResults = [...existingResults, ...attachmentResults];
+                const successCount = attachmentResults.filter(r => r.success).length;
+                const newAttachmentCount = (submission.attachment_count || 0) + successCount;
+
+                try {
+                    await pool.query(
+                        `UPDATE ivanti_fp_submissions SET attachment_count = $1, attachment_results_json = $2, updated_at = NOW() WHERE id = $3`,
+                        [newAttachmentCount, JSON.stringify(allResults), submissionId]
+                    );
+                } catch (dbErr) { console.error('Failed to update attachment records:', dbErr); }
+
+                // Insert history row
+                const historyEntry = buildSubmissionHistoryEntry('attachments_added', { files: attachmentResults }, req.user.id, req.user.username);
+                try {
+                    await pool.query(
+                        `INSERT INTO ivanti_fp_submission_history (submission_id, user_id, username, change_type, change_details_json, created_at)
+                         VALUES ($1, $2, $3, $4, $5, NOW())`,
+                        [submissionId, historyEntry.user_id, historyEntry.username, historyEntry.change_type, historyEntry.change_details_json]
+                    );
+                } catch (histErr) { console.error('Failed to insert history row:', histErr); }
+
+                logAudit({
+                    userId: req.user.id, username: req.user.username,
+                    action: 'ivanti_fp_attachments_added', entityType: 'ivanti_workflow',
+                    entityId: String(submission.ivanti_workflow_batch_id),
+                    details: { submissionId, attachmentResults, libraryDocCount: libraryDocIds.length },
+                    ipAddress: req.ip
+                });
+
+                const allSucceeded = attachmentResults.every(r => r.success);
+                res.json({ success: true, attachmentResults, status: allSucceeded ? 'success' : 'partial' });
+            })().catch((unexpectedErr) => {
+                console.error('Unexpected error in POST /submissions/:id/attachments:', unexpectedErr);
+                res.status(500).json({ success: false, error: 'Internal server error.' });
+            });
+        });
+    });
+
+    // PATCH /submissions/:id/status — Update lifecycle status
+    router.patch('/submissions/:id/status', requireAuth(), requireGroup('Admin', 'Standard_User'), (req, res) => {
+        (async () => {
+            const submissionId = req.params.id;
+            const newStatus = req.body.lifecycle_status;
+
+            const { rows: subRows } = await pool.query(
+                `SELECT * FROM ivanti_fp_submissions WHERE id = $1`, [submissionId]
+            );
+            const submission = subRows[0];
+
+            if (!submission) return res.status(404).json({ error: 'Submission not found.' });
+            if (submission.user_id !== req.user.id) return res.status(403).json({ error: 'You can only edit your own submissions.' });
+
+            const transition = validateLifecycleTransition(submission.lifecycle_status, newStatus);
+            if (!transition.valid) return res.status(400).json({ error: transition.error });
+
+            const previousStatus = submission.lifecycle_status;
+
+            try {
+                await pool.query(
+                    `UPDATE ivanti_fp_submissions SET lifecycle_status = $1, updated_at = NOW() WHERE id = $2`,
+                    [newStatus, submissionId]
+                );
+            } catch (dbErr) {
+                console.error('Failed to update lifecycle status:', dbErr);
+                return res.status(500).json({ success: false, error: 'Failed to update status.' });
+            }
+
+            const historyEntry = buildSubmissionHistoryEntry('status_changed', { from: previousStatus, to: newStatus }, req.user.id, req.user.username);
+            try {
+                await pool.query(
+                    `INSERT INTO ivanti_fp_submission_history (submission_id, user_id, username, change_type, change_details_json, created_at)
+                     VALUES ($1, $2, $3, $4, $5, NOW())`,
+                    [submissionId, historyEntry.user_id, historyEntry.username, historyEntry.change_type, historyEntry.change_details_json]
+                );
+            } catch (histErr) { console.error('Failed to insert history row:', histErr); }
+
+            logAudit({
+                userId: req.user.id, username: req.user.username,
+                action: 'ivanti_fp_status_changed', entityType: 'ivanti_workflow',
+                entityId: String(submission.ivanti_workflow_batch_id),
+                details: { submissionId, from: previousStatus, to: newStatus },
+                ipAddress: req.ip
+            });
+
+            res.json({ success: true, previousStatus, newStatus });
+        })().catch((unexpectedErr) => {
+            console.error('Unexpected error in PATCH /submissions/:id/status:', unexpectedErr);
+            res.status(500).json({ success: false, error: 'Internal server error.' });
+        });
+    });
+
+    return router;
+}
+
+module.exports = createIvantiFpWorkflowRouter;
+module.exports.validateFpWorkflowForm = validateFpWorkflowForm;
+module.exports.buildIvantiFormFields = buildIvantiFormFields;
+module.exports.buildSubjectFilterRequest = buildSubjectFilterRequest;
+module.exports.isAllowedFileExtension = isAllowedFileExtension;
+module.exports.validateLifecycleTransition = validateLifecycleTransition;
+module.exports.mergeFindings = mergeFindings;
+module.exports.buildSubmissionHistoryEntry = buildSubmissionHistoryEntry;

backend/routes/ivantiTodoQueue.js

@@ -1,92 +1,252 @@
 // routes/ivantiTodoQueue.js
 const express = require('express');
+const pool = require('../db');
+const { requireAuth, requireGroup } = require('../middleware/auth');
+const logAudit = require('../helpers/auditLog');
 
-const VALID_WORKFLOW_TYPES = ['FP', 'Archer', 'CARD'];
+const VALID_WORKFLOW_TYPES = ['FP', 'Archer', 'CARD', 'GRANITE', 'DECOM'];
+const INVENTORY_TYPES     = ['CARD', 'GRANITE', 'DECOM'];
 const VALID_STATUSES       = ['pending', 'complete'];
 
 function isValidVendor(vendor) {
-    return typeof vendor === 'string' && vendor.trim().length > 0 && vendor.length <= 200;
+    if (typeof vendor !== 'string') return false;
+    const trimmed = vendor.trim();
+    return trimmed.length > 0 && trimmed.length <= 200;
 }
 
-function createIvantiTodoQueueRouter(db, requireAuth) {
+function createIvantiTodoQueueRouter() {
     const router = express.Router();
 
-    // GET /api/ivanti/todo-queue
-    // Fetch current user's queue items, ordered by vendor then created_at
-    router.get('/', requireAuth(db), (req, res) => {
-        db.all(
-            `SELECT * FROM ivanti_todo_queue
-             WHERE user_id = ?
-             ORDER BY vendor ASC, created_at ASC`,
-            [req.user.id],
-            (err, rows) => {
-                if (err) {
-                    console.error('Error fetching todo queue:', err);
-                    return res.status(500).json({ error: 'Internal server error.' });
-                }
-                // Parse cves_json back to array for each row
-                const parsed = rows.map((r) => ({
-                    ...r,
-                    cves: r.cves_json ? JSON.parse(r.cves_json) : [],
-                }));
-                res.json(parsed);
-            }
-        );
+    /**
+     * GET /api/ivanti/todo-queue
+     *
+     * Returns all todo queue items belonging to the authenticated user.
+     *
+     * @query None
+     * @returns {Array<Object>} Array of queue items with parsed `cves` array
+     *   - id {number}
+     *   - user_id {number}
+     *   - finding_id {string}
+     *   - finding_title {string|null}
+     *   - cves {Array<string>}
+     *   - ip_address {string|null}
+     *   - hostname {string|null}
+     *   - vendor {string}
+     *   - workflow_type {string} One of: FP, Archer, CARD, GRANITE, DECOM
+     *   - status {string} pending | complete
+     *   - created_at {string}
+     *   - updated_at {string}
+     */
+    router.get('/', requireAuth(), async (req, res) => {
+        try {
+            const { rows } = await pool.query(
+                `SELECT q.*
+                 FROM ivanti_todo_queue q
+                 WHERE q.user_id = $1
+                 ORDER BY q.vendor ASC, q.created_at ASC`,
+                [req.user.id]
+            );
+            const parsed = rows.map((r) => ({
+                ...r,
+                cves: r.cves_json ? JSON.parse(r.cves_json) : [],
+            }));
+            res.json(parsed);
+        } catch (err) {
+            console.error('Error fetching todo queue:', err);
+            res.status(500).json({ error: 'Internal server error.' });
+        }
     });
 
-    // POST /api/ivanti/todo-queue
-    // Add a finding to the queue
-    router.post('/', requireAuth(db), (req, res) => {
-        const { finding_id, finding_title, cves, ip_address, vendor, workflow_type } = req.body;
+    /**
+     * POST /api/ivanti/todo-queue/batch
+     *
+     * Adds multiple findings to the authenticated user's todo queue in a single transaction.
+     * Requires Admin or Standard_User group.
+     *
+     * @body {Object}
+     *   - findings {Array<Object>} 1–200 items, each with:
+     *       - finding_id {string} Required, non-empty
+     *       - finding_title {string} Optional, max 500 chars
+     *       - cves {Array<string>} Optional
+     *       - ip_address {string} Optional, max 64 chars
+     *       - hostname {string} Optional, max 255 chars
+     *   - workflow_type {string} Required. One of: FP, Archer, CARD, GRANITE, DECOM
+     *   - vendor {string} Required for FP, Archer, and DECOM workflows; max 200 chars
+     * @returns {Object} { items: Array<Object> } — inserted queue items with parsed `cves` array
+     * @error 400 Invalid input
+     * @error 500 Internal server error
+     */
+    router.post('/batch', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        const { findings, workflow_type, vendor } = req.body;
+
+        if (!Array.isArray(findings) || findings.length < 1 || findings.length > 200) {
+            return res.status(400).json({ error: 'findings array must contain 1-200 items.' });
+        }
+
+        for (let i = 0; i < findings.length; i++) {
+            const f = findings[i];
+            if (!f || typeof f.finding_id !== 'string' || f.finding_id.trim().length === 0) {
+                return res.status(400).json({ error: 'Each finding must have a non-empty finding_id string.' });
+            }
+        }
+
+        if (!VALID_WORKFLOW_TYPES.includes(workflow_type)) {
+            return res.status(400).json({ error: 'workflow_type must be FP, Archer, CARD, GRANITE, or DECOM.' });
+        }
+
+        if (!INVENTORY_TYPES.includes(workflow_type)) {
+            if (!isValidVendor(vendor)) {
+                return res.status(400).json({ error: 'vendor is required for FP and Archer workflows.' });
+            }
+        }
+
+        if (vendor !== undefined && vendor !== '' && typeof vendor === 'string' && vendor.trim().length > 200) {
+            return res.status(400).json({ error: 'vendor must be under 200 chars.' });
+        }
+
+        const vendorVal = INVENTORY_TYPES.includes(workflow_type) ? '' : vendor.trim();
+        const userId = req.user.id;
+
+        const client = await pool.connect();
+        try {
+            await client.query('BEGIN');
+
+            const insertedIds = [];
+            for (const f of findings) {
+                const findingId = f.finding_id.trim();
+                const title = f.finding_title && typeof f.finding_title === 'string'
+                    ? f.finding_title.slice(0, 500) : null;
+                const cvesJson = Array.isArray(f.cves) ? JSON.stringify(f.cves) : null;
+                const ipVal = f.ip_address && typeof f.ip_address === 'string'
+                    ? f.ip_address.trim().slice(0, 64) : null;
+                const hostVal = f.hostname && typeof f.hostname === 'string'
+                    ? f.hostname.trim().slice(0, 255) : null;
+
+                const { rows } = await client.query(
+                    `INSERT INTO ivanti_todo_queue
+                         (user_id, finding_id, finding_title, cves_json, ip_address, hostname, vendor, workflow_type)
+                     VALUES ($1, $2, $3, $4, $5, $6, $7, $8)
+                     RETURNING id`,
+                    [userId, findingId, title, cvesJson, ipVal, hostVal, vendorVal, workflow_type]
+                );
+                insertedIds.push(rows[0].id);
+            }
+
+            await client.query('COMMIT');
+
+            // Fetch all inserted rows
+            const { rows: fetchedRows } = await pool.query(
+                `SELECT * FROM ivanti_todo_queue WHERE id = ANY($1)`,
+                [insertedIds]
+            );
+
+            const items = fetchedRows.map((r) => ({
+                ...r,
+                cves: r.cves_json ? JSON.parse(r.cves_json) : [],
+            }));
+
+            logAudit({
+                userId: req.user.id,
+                username: req.user.username,
+                action: 'batch_add_to_queue',
+                entityType: 'ivanti_todo_queue',
+                entityId: null,
+                details: {
+                    count: insertedIds.length,
+                    workflow_type: workflow_type,
+                    finding_ids: findings.map((f) => f.finding_id.trim()),
+                },
+                ipAddress: req.ip,
+            });
+
+            return res.status(201).json({ items });
+        } catch (err) {
+            await client.query('ROLLBACK');
+            console.error('Batch insert error:', err);
+            return res.status(500).json({ error: 'Internal server error.' });
+        } finally {
+            client.release();
+        }
+    });
+
+    /**
+     * POST /api/ivanti/todo-queue
+     *
+     * Adds a single finding to the authenticated user's todo queue.
+     * Requires Admin or Standard_User group.
+     *
+     * @body {Object}
+     *   - finding_id {string} Required, non-empty
+     *   - finding_title {string} Optional, max 500 chars
+     *   - cves {Array<string>} Optional
+     *   - ip_address {string} Optional, max 64 chars
+     *   - hostname {string} Optional, max 255 chars
+     *   - vendor {string} Required for FP, Archer, and DECOM workflows; max 200 chars
+     *   - workflow_type {string} Required. One of: FP, Archer, CARD, GRANITE, DECOM
+     * @returns {Object} The created queue item with parsed `cves` array
+     * @error 400 Invalid input
+     * @error 500 Internal server error
+     */
+    router.post('/', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        const { finding_id, finding_title, cves, ip_address, hostname, vendor, workflow_type } = req.body;
 
         if (!finding_id || typeof finding_id !== 'string' || finding_id.trim().length === 0) {
             return res.status(400).json({ error: 'finding_id is required.' });
         }
         if (!VALID_WORKFLOW_TYPES.includes(workflow_type)) {
-            return res.status(400).json({ error: 'workflow_type must be FP, Archer, or CARD.' });
+            return res.status(400).json({ error: 'workflow_type must be FP, Archer, CARD, GRANITE, or DECOM.' });
         }
-        // Vendor is required for FP and Archer, optional for CARD
-        if (workflow_type !== 'CARD' && !isValidVendor(vendor)) {
+        if (!INVENTORY_TYPES.includes(workflow_type) && !isValidVendor(vendor)) {
             return res.status(400).json({ error: 'vendor is required for FP and Archer workflows.' });
         }
         if (vendor !== undefined && vendor !== '' && !isValidVendor(vendor)) {
             return res.status(400).json({ error: 'vendor must be under 200 chars.' });
         }
 
-        const vendorVal = workflow_type === 'CARD' ? '' : vendor.trim();
+        const vendorVal = INVENTORY_TYPES.includes(workflow_type) ? '' : vendor.trim();
         const cvesJson  = Array.isArray(cves) ? JSON.stringify(cves) : null;
         const ipVal     = ip_address && typeof ip_address === 'string' ? ip_address.trim().slice(0, 64) : null;
+        const hostVal   = hostname && typeof hostname === 'string' ? hostname.trim().slice(0, 255) : null;
         const title     = finding_title && typeof finding_title === 'string'
-            ? finding_title.slice(0, 500)
-            : null;
+            ? finding_title.slice(0, 500) : null;
 
-        db.run(
-            `INSERT INTO ivanti_todo_queue
-                 (user_id, finding_id, finding_title, cves_json, ip_address, vendor, workflow_type)
-             VALUES (?, ?, ?, ?, ?, ?, ?)`,
-            [req.user.id, finding_id.trim(), title, cvesJson, ipVal, vendorVal, workflow_type],
-            function (err) {
-                if (err) {
-                    console.error('Error adding to queue:', err);
-                    return res.status(500).json({ error: 'Internal server error.' });
-                }
-                db.get(
-                    'SELECT * FROM ivanti_todo_queue WHERE id = ?',
-                    [this.lastID],
-                    (err2, row) => {
-                        if (err2 || !row) {
-                            return res.status(201).json({ id: this.lastID, message: 'Added to queue.' });
-                        }
-                        res.status(201).json({ ...row, cves: row.cves_json ? JSON.parse(row.cves_json) : [] });
-                    }
-                );
-            }
-        );
+        try {
+            const { rows } = await pool.query(
+                `INSERT INTO ivanti_todo_queue
+                     (user_id, finding_id, finding_title, cves_json, ip_address, hostname, vendor, workflow_type)
+                 VALUES ($1, $2, $3, $4, $5, $6, $7, $8)
+                 RETURNING *`,
+                [req.user.id, finding_id.trim(), title, cvesJson, ipVal, hostVal, vendorVal, workflow_type]
+            );
+
+            const result = {
+                ...rows[0],
+                cves: rows[0].cves_json ? JSON.parse(rows[0].cves_json) : [],
+            };
+            res.status(201).json(result);
+        } catch (err) {
+            console.error('Error adding to queue:', err);
+            res.status(500).json({ error: 'Internal server error.' });
+        }
     });
 
-    // PUT /api/ivanti/todo-queue/:id
-    // Update vendor, workflow_type, or status — scoped to current user
-    router.put('/:id', requireAuth(db), (req, res) => {
+    /**
+     * PUT /api/ivanti/todo-queue/:id
+     *
+     * Updates an existing queue item owned by the authenticated user.
+     * Requires Admin or Standard_User group.
+     *
+     * @param {string} id — Queue item ID (URL parameter)
+     * @body {Object} At least one field required:
+     *   - vendor {string} Optional, non-empty, max 200 chars
+     *   - workflow_type {string} Optional. One of: FP, Archer, CARD, GRANITE, DECOM
+     *   - status {string} Optional. One of: pending, complete
+     * @returns {Object} The updated queue item with parsed `cves` array
+     * @error 400 Invalid input or no fields to update
+     * @error 404 Queue item not found
+     * @error 500 Internal server error
+     */
+    router.put('/:id', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
         const { id } = req.params;
         const { vendor, workflow_type, status } = req.body;
 
@@ -94,118 +254,199 @@ function createIvantiTodoQueueRouter(db, requireAuth) {
             return res.status(400).json({ error: 'vendor must be a non-empty string (max 200 chars).' });
         }
         if (workflow_type !== undefined && !VALID_WORKFLOW_TYPES.includes(workflow_type)) {
-            return res.status(400).json({ error: 'workflow_type must be FP or Archer.' });
+            return res.status(400).json({ error: 'workflow_type must be FP, Archer, CARD, GRANITE, or DECOM.' });
         }
         if (status !== undefined && !VALID_STATUSES.includes(status)) {
             return res.status(400).json({ error: 'status must be pending or complete.' });
         }
 
-        db.get(
-            'SELECT * FROM ivanti_todo_queue WHERE id = ? AND user_id = ?',
-            [id, req.user.id],
-            (err, existing) => {
-                if (err) {
-                    console.error(err);
-                    return res.status(500).json({ error: 'Internal server error.' });
-                }
-                if (!existing) {
-                    return res.status(404).json({ error: 'Queue item not found.' });
-                }
-
-                const updates = [];
-                const params  = [];
-
-                if (vendor !== undefined) {
-                    updates.push('vendor = ?');
-                    params.push(vendor.trim());
-                }
-                if (workflow_type !== undefined) {
-                    updates.push('workflow_type = ?');
-                    params.push(workflow_type);
-                }
-                if (status !== undefined) {
-                    updates.push('status = ?');
-                    params.push(status);
-                }
-
-                if (updates.length === 0) {
-                    return res.status(400).json({ error: 'No fields to update.' });
-                }
-
-                updates.push('updated_at = CURRENT_TIMESTAMP');
-                params.push(id, req.user.id);
-
-                db.run(
-                    `UPDATE ivanti_todo_queue SET ${updates.join(', ')} WHERE id = ? AND user_id = ?`,
-                    params,
-                    function (err2) {
-                        if (err2) {
-                            console.error(err2);
-                            return res.status(500).json({ error: 'Internal server error.' });
-                        }
-                        db.get(
-                            'SELECT * FROM ivanti_todo_queue WHERE id = ?',
-                            [id],
-                            (err3, row) => {
-                                if (err3 || !row) {
-                                    return res.json({ message: 'Queue item updated.' });
-                                }
-                                res.json({ ...row, cves: row.cves_json ? JSON.parse(row.cves_json) : [] });
-                            }
-                        );
-                    }
-                );
+        try {
+            const { rows: existingRows } = await pool.query(
+                'SELECT * FROM ivanti_todo_queue WHERE id = $1 AND user_id = $2',
+                [id, req.user.id]
+            );
+            if (!existingRows[0]) {
+                return res.status(404).json({ error: 'Queue item not found.' });
             }
-        );
+
+            const updates = [];
+            const params = [];
+            let paramIndex = 1;
+
+            if (vendor !== undefined) {
+                updates.push(`vendor = $${paramIndex++}`);
+                params.push(vendor.trim());
+            }
+            if (workflow_type !== undefined) {
+                updates.push(`workflow_type = $${paramIndex++}`);
+                params.push(workflow_type);
+            }
+            if (status !== undefined) {
+                updates.push(`status = $${paramIndex++}`);
+                params.push(status);
+            }
+
+            if (updates.length === 0) {
+                return res.status(400).json({ error: 'No fields to update.' });
+            }
+
+            updates.push('updated_at = NOW()');
+            params.push(id, req.user.id);
+
+            await pool.query(
+                `UPDATE ivanti_todo_queue SET ${updates.join(', ')} WHERE id = $${paramIndex++} AND user_id = $${paramIndex}`,
+                params
+            );
+
+            const { rows } = await pool.query(
+                'SELECT * FROM ivanti_todo_queue WHERE id = $1', [id]
+            );
+            const result = {
+                ...rows[0],
+                cves: rows[0].cves_json ? JSON.parse(rows[0].cves_json) : [],
+            };
+            res.json(result);
+        } catch (err) {
+            console.error(err);
+            res.status(500).json({ error: 'Internal server error.' });
+        }
     });
 
-    // DELETE /api/ivanti/todo-queue/completed
-    // Bulk-delete all completed items for the current user
-    // IMPORTANT: This route must be registered BEFORE DELETE /:id
-    router.delete('/completed', requireAuth(db), (req, res) => {
-        db.run(
-            "DELETE FROM ivanti_todo_queue WHERE user_id = ? AND status = 'complete'",
-            [req.user.id],
-            function (err) {
-                if (err) {
-                    console.error('Error clearing completed queue items:', err);
-                    return res.status(500).json({ error: 'Internal server error.' });
-                }
-                res.json({ message: 'Completed items cleared.', deleted: this.changes });
+    /**
+     * POST /api/ivanti/todo-queue/:id/redirect
+     *
+     * Redirects a completed queue item to a different workflow by creating a new
+     * pending queue item with the same finding data but a new workflow type/vendor.
+     * Requires Admin or Standard_User group.
+     *
+     * @param {string} id — Queue item ID of the completed item (URL parameter)
+     * @body {Object}
+     *   - workflow_type {string} Required. One of: FP, Archer, CARD, GRANITE, DECOM
+     *   - vendor {string} Required for FP, Archer, and DECOM workflows; max 200 chars
+     * @returns {Object} The newly created queue item with parsed `cves` array
+     * @error 400 Invalid input or item not in complete status
+     * @error 404 Queue item not found
+     * @error 500 Internal server error
+     */
+    router.post('/:id/redirect', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        const { id } = req.params;
+        const { workflow_type, vendor } = req.body;
+
+        if (!VALID_WORKFLOW_TYPES.includes(workflow_type)) {
+            return res.status(400).json({ error: 'workflow_type must be FP, Archer, CARD, GRANITE, or DECOM.' });
+        }
+        if (!INVENTORY_TYPES.includes(workflow_type)) {
+            if (!isValidVendor(vendor)) {
+                return res.status(400).json({ error: 'vendor is required for FP and Archer workflows.' });
             }
-        );
+        }
+        if (vendor !== undefined && vendor !== '' && typeof vendor === 'string' && vendor.trim().length > 200) {
+            return res.status(400).json({ error: 'vendor must be under 200 chars.' });
+        }
+
+        const vendorVal = INVENTORY_TYPES.includes(workflow_type) ? '' : vendor.trim();
+
+        try {
+            const { rows: origRows } = await pool.query(
+                'SELECT * FROM ivanti_todo_queue WHERE id = $1 AND user_id = $2',
+                [id, req.user.id]
+            );
+            const original = origRows[0];
+            if (!original) {
+                return res.status(404).json({ error: 'Queue item not found.' });
+            }
+            if (original.status !== 'complete') {
+                return res.status(400).json({ error: 'Only completed queue items can be redirected.' });
+            }
+
+            const { rows } = await pool.query(
+                `INSERT INTO ivanti_todo_queue
+                     (user_id, finding_id, finding_title, cves_json, ip_address, hostname, vendor, workflow_type)
+                 VALUES ($1, $2, $3, $4, $5, $6, $7, $8)
+                 RETURNING *`,
+                [req.user.id, original.finding_id, original.finding_title, original.cves_json, original.ip_address, original.hostname, vendorVal, workflow_type]
+            );
+
+            logAudit({
+                userId: req.user.id,
+                username: req.user.username,
+                action: 'queue_item_redirected',
+                entityType: 'ivanti_todo_queue',
+                entityId: String(original.id),
+                details: {
+                    original_workflow_type: original.workflow_type,
+                    target_workflow_type: workflow_type,
+                    new_item_id: rows[0].id,
+                    vendor: vendorVal,
+                },
+                ipAddress: req.ip,
+            });
+
+            const result = {
+                ...rows[0],
+                cves: rows[0].cves_json ? JSON.parse(rows[0].cves_json) : [],
+            };
+            return res.status(201).json(result);
+        } catch (err) {
+            console.error('Error redirecting queue item:', err);
+            res.status(500).json({ error: 'Internal server error.' });
+        }
     });
 
-    // DELETE /api/ivanti/todo-queue/:id
-    // Delete a single item — scoped to current user
-    router.delete('/:id', requireAuth(db), (req, res) => {
+    /**
+     * DELETE /api/ivanti/todo-queue/completed
+     *
+     * Deletes all completed queue items belonging to the authenticated user.
+     * Requires Admin or Standard_User group.
+     *
+     * @returns {Object} { message: string, deleted: number }
+     * @error 500 Internal server error
+     */
+    router.delete('/completed', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        try {
+            const result = await pool.query(
+                "DELETE FROM ivanti_todo_queue WHERE user_id = $1 AND status = 'complete'",
+                [req.user.id]
+            );
+            res.json({ message: 'Completed items cleared.', deleted: result.rowCount });
+        } catch (err) {
+            console.error('Error clearing completed queue items:', err);
+            res.status(500).json({ error: 'Internal server error.' });
+        }
+    });
+
+    /**
+     * DELETE /api/ivanti/todo-queue/:id
+     *
+     * Deletes a single queue item owned by the authenticated user.
+     * Requires Admin or Standard_User group.
+     *
+     * @param {string} id — Queue item ID (URL parameter)
+     * @returns {Object} { message: string }
+     * @error 404 Queue item not found
+     * @error 500 Internal server error
+     */
+    router.delete('/:id', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
         const { id } = req.params;
 
-        db.get(
-            'SELECT id FROM ivanti_todo_queue WHERE id = ? AND user_id = ?',
-            [id, req.user.id],
-            (err, row) => {
-                if (err) {
-                    console.error(err);
-                    return res.status(500).json({ error: 'Internal server error.' });
-                }
-                if (!row) {
-                    return res.status(404).json({ error: 'Queue item not found.' });
-                }
-
-                db.run(
-                    'DELETE FROM ivanti_todo_queue WHERE id = ? AND user_id = ?',
-                    [id, req.user.id],
-                    function (err2) {
-                        if (err2) {
-                            console.error(err2);
-                            return res.status(500).json({ error: 'Internal server error.' });
-                        }
-                        res.json({ message: 'Queue item deleted.' });
-                    }
-                );
+        try {
+            const { rows } = await pool.query(
+                'SELECT id FROM ivanti_todo_queue WHERE id = $1 AND user_id = $2',
+                [id, req.user.id]
+            );
+            if (!rows[0]) {
+                return res.status(404).json({ error: 'Queue item not found.' });
             }
-        );
+
+            await pool.query(
+                'DELETE FROM ivanti_todo_queue WHERE id = $1 AND user_id = $2',
+                [id, req.user.id]
+            );
+            res.json({ message: 'Queue item deleted.' });
+        } catch (err) {
+            console.error(err);
+            res.status(500).json({ error: 'Internal server error.' });
+        }
     });
 
     return router;

backend/routes/ivantiWorkflows.js

@@ -1,83 +1,17 @@
 // Ivanti / RiskSense Workflow Routes
-// Data is cached in SQLite and refreshed on a daily schedule or on-demand.
-// Auth: x-api-key header (confirmed via platform4.risksense.com/doc/swagger.json)
-// Error codes: 401 bad key, 419 insufficient privileges, 429 rate limited
+// Data is cached in PostgreSQL and refreshed on a daily schedule or on-demand.
 
 const express = require('express');
-const https = require('https');
+const pool = require('../db');
+const { requireAuth, requireGroup } = require('../middleware/auth');
+const { ivantiPost } = require('../helpers/ivantiApi');
 
-const IVANTI_URL_BASE = 'https://platform4.risksense.com/api/v1';
 const SYNC_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
 
 // ---------------------------------------------------------------------------
-// HTTP helper — uses Node's https module directly so we can toggle
-// rejectUnauthorized for Charter's SSL inspection proxy (IVANTI_SKIP_TLS=true)
+// Core sync — calls Ivanti API, stores result in PostgreSQL
 // ---------------------------------------------------------------------------
-function ivantiPost(urlPath, body, apiKey, skipTls) {
-    const bodyStr = JSON.stringify(body);
-    const fullUrl = new URL(IVANTI_URL_BASE + urlPath);
-
-    return new Promise((resolve, reject) => {
-        const options = {
-            hostname: fullUrl.hostname,
-            path: fullUrl.pathname + fullUrl.search,
-            method: 'POST',
-            headers: {
-                'accept': '*/*',
-                'content-type': 'application/json',
-                'x-api-key': apiKey,
-                'x-http-client-type': 'browser',
-                'content-length': Buffer.byteLength(bodyStr)
-            },
-            rejectUnauthorized: !skipTls,
-            timeout: 15000
-        };
-
-        const req = https.request(options, (res) => {
-            let data = '';
-            res.on('data', (chunk) => { data += chunk; });
-            res.on('end', () => resolve({ status: res.statusCode, body: data }));
-        });
-
-        req.on('timeout', () => req.destroy(new Error('Request timed out')));
-        req.on('error', reject);
-        req.write(bodyStr);
-        req.end();
-    });
-}
-
-// ---------------------------------------------------------------------------
-// Ensure the sync state table exists (idempotent — safe to call on every start)
-// ---------------------------------------------------------------------------
-function initTable(db) {
-    return new Promise((resolve, reject) => {
-        db.serialize(() => {
-            db.run(`
-                CREATE TABLE IF NOT EXISTS ivanti_sync_state (
-                    id INTEGER PRIMARY KEY CHECK (id = 1),
-                    total INTEGER DEFAULT 0,
-                    workflows_json TEXT DEFAULT '[]',
-                    synced_at DATETIME,
-                    sync_status TEXT DEFAULT 'never',
-                    error_message TEXT
-                )
-            `, (err) => { if (err) return reject(err); });
-
-            db.run(`
-                INSERT OR IGNORE INTO ivanti_sync_state (id, total, workflows_json, sync_status)
-                VALUES (1, 0, '[]', 'never')
-            `, (err) => {
-                if (err) reject(err);
-                else resolve();
-            });
-        });
-    });
-}
-
-// ---------------------------------------------------------------------------
-// Core sync — calls Ivanti API, stores result in SQLite
-// ---------------------------------------------------------------------------
-async function syncWorkflows(db) {
+async function syncWorkflows() {
     const apiKey = process.env.IVANTI_API_KEY;
     const clientId = process.env.IVANTI_CLIENT_ID || '1550';
     const firstName = process.env.IVANTI_FIRST_NAME || '';
@@ -87,12 +21,10 @@ async function syncWorkflows(db) {
     if (!apiKey) {
         const errMsg = 'IVANTI_API_KEY not set in .env — skipping sync';
         console.warn('[Ivanti]', errMsg);
-        await new Promise((resolve) => {
-            db.run(
-                `UPDATE ivanti_sync_state SET sync_status='error', error_message=?, synced_at=datetime('now') WHERE id=1`,
-                [errMsg], resolve
-            );
-        });
+        await pool.query(
+            `UPDATE ivanti_sync_state SET sync_status='error', error_message=$1, synced_at=NOW() WHERE id=1`,
+            [errMsg]
+        );
         return;
     }
 
@@ -144,7 +76,6 @@ async function syncWorkflows(db) {
 
         const data = JSON.parse(result.body);
 
-        // Spring Data REST format: { _embedded: { workflowBatches: [...] }, page: { totalElements, ... } }
         let total = 0;
         let workflows = [];
 
@@ -164,105 +95,99 @@ async function syncWorkflows(db) {
             total = data.length;
         }
 
-        await new Promise((resolve, reject) => {
-            db.run(
-                `UPDATE ivanti_sync_state
-                 SET total=?, workflows_json=?, synced_at=datetime('now'), sync_status='success', error_message=NULL
-                 WHERE id=1`,
-                [total, JSON.stringify(workflows)],
-                (err) => { if (err) reject(err); else resolve(); }
-            );
-        });
+        await pool.query(
+            `UPDATE ivanti_sync_state
+             SET total=$1, workflows_json=$2, synced_at=NOW(), sync_status='success', error_message=NULL
+             WHERE id=1`,
+            [total, JSON.stringify(workflows)]
+        );
 
         console.log(`[Ivanti] Sync complete — ${total} workflows`);
     } catch (err) {
         const msg = err.message || 'Unknown error';
         console.error('[Ivanti] Sync failed:', msg);
-        await new Promise((resolve) => {
-            db.run(
-                `UPDATE ivanti_sync_state SET sync_status='error', error_message=?, synced_at=datetime('now') WHERE id=1`,
-                [msg], resolve
-            );
-        });
+        await pool.query(
+            `UPDATE ivanti_sync_state SET sync_status='error', error_message=$1, synced_at=NOW() WHERE id=1`,
+            [msg]
+        );
     }
 }
 
 // ---------------------------------------------------------------------------
 // Scheduler — runs sync immediately if >24h stale, then every 24h
 // ---------------------------------------------------------------------------
-function scheduleSync(db) {
-    db.get('SELECT synced_at FROM ivanti_sync_state WHERE id = 1', (err, row) => {
-        if (err || !row || !row.synced_at) {
-            syncWorkflows(db);
+async function scheduleSync() {
+    try {
+        const { rows } = await pool.query('SELECT synced_at FROM ivanti_sync_state WHERE id = 1');
+        const row = rows[0];
+        if (!row || !row.synced_at) {
+            syncWorkflows();
         } else {
-            const lastSync = new Date(row.synced_at.replace(' ', 'T') + 'Z');
+            const lastSync = new Date(row.synced_at);
             const hoursSince = (Date.now() - lastSync.getTime()) / (1000 * 60 * 60);
             if (hoursSince >= 24) {
-                syncWorkflows(db);
+                syncWorkflows();
             } else {
                 const hoursUntil = (24 - hoursSince).toFixed(1);
                 console.log(`[Ivanti] Last sync ${hoursSince.toFixed(1)}h ago — next auto-sync in ${hoursUntil}h`);
             }
         }
-    });
+    } catch (err) {
+        console.error('[Ivanti] Schedule check failed:', err);
+        syncWorkflows();
+    }
 
-    setInterval(() => syncWorkflows(db), SYNC_INTERVAL_MS);
+    setInterval(() => syncWorkflows(), SYNC_INTERVAL_MS);
 }
 
 // ---------------------------------------------------------------------------
 // Helper — read current state from DB and return as JSON-ready object
 // ---------------------------------------------------------------------------
-function readState(db) {
-    return new Promise((resolve, reject) => {
-        db.get(
-            'SELECT total, workflows_json, synced_at, sync_status, error_message FROM ivanti_sync_state WHERE id = 1',
-            (err, row) => {
-                if (err) return reject(err);
-                if (!row) return resolve({ total: 0, workflows: [], synced_at: null, sync_status: 'never', error_message: null });
+async function readState() {
+    const { rows } = await pool.query(
+        'SELECT total, workflows_json, synced_at, sync_status, error_message FROM ivanti_sync_state WHERE id = 1'
+    );
+    const row = rows[0];
+    if (!row) return { total: 0, workflows: [], synced_at: null, sync_status: 'never', error_message: null };
 
-                let workflows = [];
-                try { workflows = JSON.parse(row.workflows_json || '[]'); } catch (_) { /* leave empty */ }
+    let workflows = [];
+    try { workflows = JSON.parse(row.workflows_json || '[]'); } catch (_) { /* leave empty */ }
 
-                resolve({
-                    total: row.total || 0,
-                    workflows,
-                    synced_at: row.synced_at,
-                    sync_status: row.sync_status,
-                    error_message: row.error_message
-                });
-            }
-        );
-    });
+    return {
+        total: row.total || 0,
+        workflows,
+        synced_at: row.synced_at,
+        sync_status: row.sync_status,
+        error_message: row.error_message
+    };
 }
 
 // ---------------------------------------------------------------------------
 // Router
 // ---------------------------------------------------------------------------
-function createIvantiWorkflowsRouter(db, requireAuth) {
+function createIvantiWorkflowsRouter() {
     const router = express.Router();
 
-    // Init table and kick off scheduler (fire-and-forget on startup)
-    initTable(db)
-        .then(() => scheduleSync(db))
-        .catch((err) => console.error('[Ivanti] Init failed:', err));
+    // Kick off scheduler (fire-and-forget on startup)
+    scheduleSync().catch((err) => console.error('[Ivanti] Init failed:', err));
 
     // All routes require authentication
-    router.use(requireAuth(db));
+    router.use(requireAuth());
 
     // GET / — return cached data (fast, no external call)
     router.get('/', async (req, res) => {
         try {
-            res.json(await readState(db));
+            res.json(await readState());
         } catch {
             res.status(500).json({ error: 'Database error reading sync state' });
         }
     });
 
     // POST /sync — trigger an immediate sync, await completion, return fresh state
-    router.post('/sync', async (req, res) => {
-        await syncWorkflows(db);
+    router.post('/sync', requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        await syncWorkflows();
         try {
-            res.json(await readState(db));
+            res.json(await readState());
         } catch {
             res.status(500).json({ error: 'Sync ran but could not read updated state' });
         }

backend/routes/jiraTickets.js

@@ -0,0 +1,581 @@
+// routes/jiraTickets.js
+// Jira ticket CRUD + Jira REST API integration endpoints.
+// Extracted from server.js inline endpoints and extended with live Jira
+// operations (lookup, sync, create-in-jira, connection test).
+//
+// Charter Jira REST API compliance:
+//   - All GETs include explicit field lists (no /rest/api/2/field)
+//   - Sync uses bulk JQL search, not one-issue-at-a-time GETs
+//   - No /rest/api/2/issue/bulk — updates are one at a time
+//   - Inter-request delays enforced in jiraApi.js (1s GET, 2s write)
+//   - Rate limits enforced client-side (1440/day, 60/min burst)
+
+const express = require('express');
+const pool = require('../db');
+const { requireAuth, requireGroup } = require('../middleware/auth');
+const logAudit = require('../helpers/auditLog');
+const jiraApi = require('../helpers/jiraApi');
+
+// Validation helpers
+const CVE_ID_PATTERN = /^CVE-\d{4}-\d{4,}$/;
+const VALID_TICKET_STATUSES = ['Open', 'In Progress', 'Closed'];
+
+function isValidCveId(cveId) {
+    return typeof cveId === 'string' && CVE_ID_PATTERN.test(cveId);
+}
+
+function isValidVendor(vendor) {
+    return typeof vendor === 'string' && vendor.trim().length > 0 && vendor.length <= 200;
+}
+
+function createJiraTicketsRouter() {
+    const router = express.Router();
+
+    // -----------------------------------------------------------------------
+    // Jira API integration endpoints
+    // -----------------------------------------------------------------------
+
+    router.get('/connection-test', requireAuth(), requireGroup('Admin'), async (req, res) => {
+        if (!jiraApi.isConfigured) {
+            return res.status(503).json({ error: 'Jira API is not configured. Set JIRA_BASE_URL and credentials in backend/.env.' });
+        }
+
+        try {
+            const result = await jiraApi.testConnection();
+            if (result.ok) {
+                logAudit({
+                    userId: req.user.id,
+                    username: req.user.username,
+                    action: 'jira_connection_test',
+                    entityType: 'jira_integration',
+                    entityId: null,
+                    details: { success: true, user: result.user.name },
+                    ipAddress: req.ip
+                });
+                return res.json({ connected: true, user: result.user });
+            }
+            return res.status(502).json({ connected: false, status: result.status, error: result.body || result.error });
+        } catch (err) {
+            return res.status(502).json({ connected: false, error: err.message });
+        }
+    });
+
+    router.get('/rate-limit', requireAuth(), requireGroup('Admin'), (req, res) => {
+        res.json(jiraApi.getRateLimitStatus());
+    });
+
+    router.get('/lookup/:issueKey', requireAuth(), async (req, res) => {
+        if (!jiraApi.isConfigured) {
+            return res.status(503).json({ error: 'Jira API is not configured.' });
+        }
+
+        const { issueKey } = req.params;
+        if (!issueKey || !/^[A-Z][A-Z0-9_]+-\d+$/.test(issueKey)) {
+            return res.status(400).json({ error: 'Invalid Jira issue key format. Expected PROJECT-123.' });
+        }
+
+        try {
+            const result = await jiraApi.getIssue(issueKey);
+            if (result.ok) {
+                const issue = result.data;
+                return res.json({
+                    key: issue.key,
+                    summary: issue.fields.summary,
+                    status: issue.fields.status ? issue.fields.status.name : null,
+                    assignee: issue.fields.assignee ? issue.fields.assignee.displayName : null,
+                    priority: issue.fields.priority ? issue.fields.priority.name : null,
+                    issuetype: issue.fields.issuetype ? issue.fields.issuetype.name : null,
+                    created: issue.fields.created,
+                    updated: issue.fields.updated,
+                    self: issue.self
+                });
+            }
+            if (result.rateLimited) {
+                return res.status(429).json({ error: 'Jira rate limit exceeded. Try again later.' });
+            }
+            return res.status(result.status === 404 ? 404 : 502).json({
+                error: result.status === 404 ? 'Issue not found in Jira.' : 'Jira API error.',
+                details: result.body
+            });
+        } catch (err) {
+            return res.status(502).json({ error: err.message });
+        }
+    });
+
+    router.post('/create-in-jira', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!jiraApi.isConfigured) {
+            return res.status(503).json({ error: 'Jira API is not configured.' });
+        }
+
+        const { cve_id, vendor, summary, description, project_key, issue_type } = req.body;
+
+        if (!cve_id || !isValidCveId(cve_id)) {
+            return res.status(400).json({ error: 'Valid CVE ID is required.' });
+        }
+        if (!vendor || !isValidVendor(vendor)) {
+            return res.status(400).json({ error: 'Valid vendor is required.' });
+        }
+        if (!summary || typeof summary !== 'string' || summary.trim().length === 0 || summary.length > 255) {
+            return res.status(400).json({ error: 'Summary is required (max 255 chars).' });
+        }
+
+        const projectKey = project_key || jiraApi.JIRA_PROJECT_KEY;
+        const issueType = issue_type || jiraApi.JIRA_ISSUE_TYPE;
+
+        if (!projectKey) {
+            return res.status(400).json({ error: 'Project key is required. Set JIRA_PROJECT_KEY in .env or provide project_key in request.' });
+        }
+
+        const fields = {
+            project: { key: projectKey },
+            summary: summary.trim(),
+            issuetype: { name: issueType }
+        };
+
+        if (description) {
+            fields.description = description;
+        }
+
+        try {
+            const result = await jiraApi.createIssue(fields);
+            if (!result.ok) {
+                if (result.rateLimited) {
+                    return res.status(429).json({ error: 'Jira rate limit exceeded. Try again later.' });
+                }
+                return res.status(502).json({ error: 'Failed to create Jira issue.', details: result.body });
+            }
+
+            const jiraIssue = result.data;
+            const ticketKey = jiraIssue.key;
+            const jiraUrl = jiraIssue.self
+                ? jiraIssue.self.replace(/\/rest\/api\/2\/issue\/.*/, `/browse/${ticketKey}`)
+                : null;
+
+            try {
+                const { rows } = await pool.query(
+                    `INSERT INTO jira_tickets (cve_id, vendor, ticket_key, url, summary, status, jira_id, jira_status, last_synced_at, created_by)
+                     VALUES ($1, $2, $3, $4, $5, $6, $7, $8, NOW(), $9)
+                     RETURNING id`,
+                    [cve_id, vendor, ticketKey, jiraUrl, summary.trim(), 'Open', jiraIssue.id, 'Open', req.user.id]
+                );
+
+                logAudit({
+                    userId: req.user.id,
+                    username: req.user.username,
+                    action: 'jira_ticket_create_via_api',
+                    entityType: 'jira_ticket',
+                    entityId: rows[0].id.toString(),
+                    details: { cve_id, vendor, ticket_key: ticketKey, jira_id: jiraIssue.id, project_key: projectKey },
+                    ipAddress: req.ip
+                });
+
+                res.status(201).json({
+                    id: rows[0].id,
+                    ticket_key: ticketKey,
+                    jira_url: jiraUrl,
+                    message: 'Jira issue created and linked successfully'
+                });
+            } catch (dbErr) {
+                console.error('Error saving local Jira ticket record:', dbErr);
+                return res.status(207).json({
+                    warning: 'Issue created in Jira but local record failed to save.',
+                    jira_key: ticketKey,
+                    jira_url: jiraUrl,
+                    error: dbErr.message
+                });
+            }
+        } catch (err) {
+            return res.status(502).json({ error: err.message });
+        }
+    });
+
+    router.post('/sync-all', requireAuth(), requireGroup('Admin'), async (req, res) => {
+        if (!jiraApi.isConfigured) {
+            return res.status(503).json({ error: 'Jira API is not configured.' });
+        }
+
+        try {
+            const { rows: tickets } = await pool.query(
+                "SELECT * FROM jira_tickets WHERE ticket_key IS NOT NULL AND ticket_key != ''"
+            );
+
+            if (tickets.length === 0) {
+                return res.json({ synced: 0, failed: 0, skipped: 0, unchanged: 0, errors: [] });
+            }
+
+            const results = { synced: 0, failed: 0, skipped: 0, unchanged: 0, errors: [] };
+
+            const BATCH_SIZE = 100;
+            const batches = [];
+            for (let i = 0; i < tickets.length; i += BATCH_SIZE) {
+                batches.push(tickets.slice(i, i + BATCH_SIZE));
+            }
+
+            for (const batch of batches) {
+                const rateStatus = jiraApi.getRateLimitStatus();
+                if (rateStatus.burst.remaining <= 5 || rateStatus.daily.remaining <= 10) {
+                    const remaining = tickets.length - results.synced - results.failed - results.unchanged;
+                    results.skipped += remaining;
+                    results.errors.push('Rate limit approaching — stopped sync early to preserve budget.');
+                    break;
+                }
+
+                const keys = batch.map(t => t.ticket_key);
+                try {
+                    const result = await jiraApi.searchIssuesByKeys(keys);
+                    if (!result.ok) {
+                        if (result.rateLimited) {
+                            results.skipped += batch.length;
+                            results.errors.push('Jira rate limit hit during sync.');
+                            break;
+                        }
+                        results.failed += batch.length;
+                        results.errors.push(`Batch search failed: HTTP ${result.status}`);
+                        continue;
+                    }
+
+                    const issueMap = {};
+                    for (const issue of (result.data.issues || [])) {
+                        issueMap[issue.key] = issue;
+                    }
+
+                    for (const ticket of batch) {
+                        const issue = issueMap[ticket.ticket_key];
+                        if (!issue) {
+                            results.unchanged++;
+                            continue;
+                        }
+
+                        const jiraStatus = issue.fields.status ? issue.fields.status.name : null;
+                        const jiraSummary = issue.fields.summary || ticket.summary;
+                        const localStatus = mapJiraStatusToLocal(jiraStatus);
+
+                        try {
+                            await pool.query(
+                                `UPDATE jira_tickets SET summary = $1, status = $2, jira_status = $3, last_synced_at = NOW(), updated_at = NOW() WHERE id = $4`,
+                                [jiraSummary, localStatus, jiraStatus, ticket.id]
+                            );
+                            results.synced++;
+                        } catch (dbErr) {
+                            results.failed++;
+                            results.errors.push(`${ticket.ticket_key}: DB update failed — ${dbErr.message}`);
+                        }
+                    }
+                } catch (searchErr) {
+                    results.failed += batch.length;
+                    results.errors.push(`Batch search error: ${searchErr.message}`);
+                }
+            }
+
+            logAudit({
+                userId: req.user.id,
+                username: req.user.username,
+                action: 'jira_sync_all',
+                entityType: 'jira_integration',
+                entityId: null,
+                details: results,
+                ipAddress: req.ip
+            });
+
+            res.json(results);
+        } catch (err) {
+            console.error(err);
+            return res.status(500).json({ error: 'Internal server error.' });
+        }
+    });
+
+    router.post('/:id/sync', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        if (!jiraApi.isConfigured) {
+            return res.status(503).json({ error: 'Jira API is not configured.' });
+        }
+
+        const { id } = req.params;
+
+        try {
+            const { rows } = await pool.query('SELECT * FROM jira_tickets WHERE id = $1', [id]);
+            const ticket = rows[0];
+
+            if (!ticket) {
+                return res.status(404).json({ error: 'JIRA ticket not found.' });
+            }
+            if (!ticket.ticket_key) {
+                return res.status(400).json({ error: 'Ticket has no Jira key to sync.' });
+            }
+
+            const result = await jiraApi.getIssue(ticket.ticket_key);
+            if (!result.ok) {
+                if (result.rateLimited) {
+                    return res.status(429).json({ error: 'Jira rate limit exceeded. Try again later.' });
+                }
+                return res.status(502).json({ error: 'Failed to fetch issue from Jira.', details: result.body });
+            }
+
+            const issue = result.data;
+            const jiraStatus = issue.fields.status ? issue.fields.status.name : null;
+            const jiraSummary = issue.fields.summary || ticket.summary;
+            const localStatus = mapJiraStatusToLocal(jiraStatus);
+
+            await pool.query(
+                `UPDATE jira_tickets SET summary = $1, status = $2, jira_status = $3, last_synced_at = NOW(), updated_at = NOW() WHERE id = $4`,
+                [jiraSummary, localStatus, jiraStatus, id]
+            );
+
+            logAudit({
+                userId: req.user.id,
+                username: req.user.username,
+                action: 'jira_ticket_sync',
+                entityType: 'jira_ticket',
+                entityId: id,
+                details: { ticket_key: ticket.ticket_key, jira_status: jiraStatus, local_status: localStatus },
+                ipAddress: req.ip
+            });
+
+            res.json({
+                message: 'Ticket synced with Jira',
+                ticket_key: ticket.ticket_key,
+                jira_status: jiraStatus,
+                local_status: localStatus,
+                summary: jiraSummary
+            });
+        } catch (err) {
+            console.error(err);
+            return res.status(500).json({ error: 'Internal server error.' });
+        }
+    });
+
+    // -----------------------------------------------------------------------
+    // Local CRUD endpoints
+    // -----------------------------------------------------------------------
+
+    router.get('/', requireAuth(), async (req, res) => {
+        const { cve_id, vendor, status } = req.query;
+
+        let query = 'SELECT * FROM jira_tickets WHERE 1=1';
+        const params = [];
+        let paramIndex = 1;
+
+        if (cve_id) {
+            query += ` AND cve_id = $${paramIndex++}`;
+            params.push(cve_id);
+        }
+        if (vendor) {
+            query += ` AND vendor = $${paramIndex++}`;
+            params.push(vendor);
+        }
+        if (status) {
+            query += ` AND status = $${paramIndex++}`;
+            params.push(status);
+        }
+
+        query += ' ORDER BY created_at DESC';
+
+        try {
+            const { rows } = await pool.query(query, params);
+            res.json(rows);
+        } catch (err) {
+            console.error('Error fetching JIRA tickets:', err);
+            res.status(500).json({ error: 'Internal server error.' });
+        }
+    });
+
+    router.post('/', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        const { cve_id, vendor, ticket_key, url, summary, status } = req.body;
+
+        if (!cve_id || !isValidCveId(cve_id)) {
+            return res.status(400).json({ error: 'Valid CVE ID is required.' });
+        }
+        if (!vendor || !isValidVendor(vendor)) {
+            return res.status(400).json({ error: 'Valid vendor is required.' });
+        }
+        if (!ticket_key || typeof ticket_key !== 'string' || ticket_key.trim().length === 0 || ticket_key.length > 50) {
+            return res.status(400).json({ error: 'Ticket key is required (max 50 chars).' });
+        }
+        if (url && (typeof url !== 'string' || url.length > 500)) {
+            return res.status(400).json({ error: 'URL must be under 500 characters.' });
+        }
+        if (summary && (typeof summary !== 'string' || summary.length > 500)) {
+            return res.status(400).json({ error: 'Summary must be under 500 characters.' });
+        }
+        if (status && !VALID_TICKET_STATUSES.includes(status)) {
+            return res.status(400).json({ error: `Status must be one of: ${VALID_TICKET_STATUSES.join(', ')}` });
+        }
+
+        const ticketStatus = status || 'Open';
+
+        try {
+            const { rows } = await pool.query(
+                `INSERT INTO jira_tickets (cve_id, vendor, ticket_key, url, summary, status, created_by)
+                 VALUES ($1, $2, $3, $4, $5, $6, $7)
+                 RETURNING id`,
+                [cve_id, vendor, ticket_key.trim(), url || null, summary || null, ticketStatus, req.user.id]
+            );
+
+            logAudit({
+                userId: req.user.id,
+                username: req.user.username,
+                action: 'jira_ticket_create',
+                entityType: 'jira_ticket',
+                entityId: rows[0].id.toString(),
+                details: { cve_id, vendor, ticket_key, status: ticketStatus },
+                ipAddress: req.ip
+            });
+
+            res.status(201).json({
+                id: rows[0].id,
+                message: 'JIRA ticket created successfully'
+            });
+        } catch (err) {
+            console.error('Error creating JIRA ticket:', err);
+            res.status(500).json({ error: 'Internal server error.' });
+        }
+    });
+
+    router.put('/:id', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        const { id } = req.params;
+        const { ticket_key, url, summary, status } = req.body;
+
+        if (ticket_key !== undefined && (typeof ticket_key !== 'string' || ticket_key.trim().length === 0 || ticket_key.length > 50)) {
+            return res.status(400).json({ error: 'Ticket key must be under 50 chars.' });
+        }
+        if (url !== undefined && url !== null && (typeof url !== 'string' || url.length > 500)) {
+            return res.status(400).json({ error: 'URL must be under 500 characters.' });
+        }
+        if (summary !== undefined && summary !== null && (typeof summary !== 'string' || summary.length > 500)) {
+            return res.status(400).json({ error: 'Summary must be under 500 characters.' });
+        }
+        if (status !== undefined && !VALID_TICKET_STATUSES.includes(status)) {
+            return res.status(400).json({ error: `Status must be one of: ${VALID_TICKET_STATUSES.join(', ')}` });
+        }
+
+        const fields = [];
+        const values = [];
+        let paramIndex = 1;
+
+        if (ticket_key !== undefined) { fields.push(`ticket_key = $${paramIndex++}`); values.push(ticket_key.trim()); }
+        if (url !== undefined) { fields.push(`url = $${paramIndex++}`); values.push(url); }
+        if (summary !== undefined) { fields.push(`summary = $${paramIndex++}`); values.push(summary); }
+        if (status !== undefined) { fields.push(`status = $${paramIndex++}`); values.push(status); }
+
+        if (fields.length === 0) {
+            return res.status(400).json({ error: 'No fields to update.' });
+        }
+
+        fields.push('updated_at = NOW()');
+        values.push(id);
+
+        try {
+            const { rows } = await pool.query('SELECT * FROM jira_tickets WHERE id = $1', [id]);
+            const existing = rows[0];
+            if (!existing) {
+                return res.status(404).json({ error: 'JIRA ticket not found.' });
+            }
+
+            const result = await pool.query(
+                `UPDATE jira_tickets SET ${fields.join(', ')} WHERE id = $${paramIndex}`,
+                values
+            );
+
+            logAudit({
+                userId: req.user.id,
+                username: req.user.username,
+                action: 'jira_ticket_update',
+                entityType: 'jira_ticket',
+                entityId: id,
+                details: { before: existing, changes: req.body },
+                ipAddress: req.ip
+            });
+
+            res.json({ message: 'JIRA ticket updated successfully', changes: result.rowCount });
+        } catch (err) {
+            console.error('Error updating JIRA ticket:', err);
+            res.status(500).json({ error: 'Internal server error.' });
+        }
+    });
+
+    router.delete('/:id', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
+        const { id } = req.params;
+
+        try {
+            const { rows } = await pool.query('SELECT * FROM jira_tickets WHERE id = $1', [id]);
+            const ticket = rows[0];
+
+            if (!ticket) {
+                return res.status(404).json({ error: 'JIRA ticket not found.' });
+            }
+
+            // Admin bypasses all delete restrictions
+            if (req.user.group === 'Admin') {
+                return performJiraDelete();
+            }
+
+            // Standard_User: ownership check
+            if (ticket.created_by && ticket.created_by !== req.user.id) {
+                return res.status(403).json({ error: 'You can only delete resources you created' });
+            }
+
+            // Standard_User: compliance linkage check
+            const ticketKey = ticket.ticket_key;
+            try {
+                const { rows: compLinks } = await pool.query(
+                    `SELECT ci.id, ci.extra_json
+                     FROM compliance_items ci
+                     JOIN compliance_uploads cu ON ci.upload_id = cu.id
+                     WHERE ci.status = 'active' AND ci.extra_json ILIKE $1`,
+                    [`%${ticketKey}%`]
+                );
+
+                const isLinked = (compLinks || []).some(cl => {
+                    const json = cl.extra_json || '';
+                    return json.includes(ticketKey);
+                });
+
+                if (isLinked) {
+                    return res.status(403).json({ error: 'Cannot delete ticket linked to compliance report. Contact an admin.' });
+                }
+            } catch (compErr) {
+                if (!compErr.message.includes('does not exist')) throw compErr;
+            }
+
+            return performJiraDelete();
+
+            async function performJiraDelete() {
+                await pool.query('DELETE FROM jira_tickets WHERE id = $1', [id]);
+
+                logAudit({
+                    userId: req.user.id,
+                    username: req.user.username,
+                    action: 'jira_ticket_delete',
+                    entityType: 'jira_ticket',
+                    entityId: id,
+                    details: { ticket_key: ticket.ticket_key, cve_id: ticket.cve_id, vendor: ticket.vendor },
+                    ipAddress: req.ip
+                });
+
+                res.json({ message: 'JIRA ticket deleted successfully' });
+            }
+        } catch (err) {
+            console.error('Error deleting JIRA ticket:', err);
+            res.status(500).json({ error: 'Internal server error.' });
+        }
+    });
+
+    return router;
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function mapJiraStatusToLocal(jiraStatus) {
+    if (!jiraStatus) return 'Open';
+    const lower = jiraStatus.toLowerCase();
+    if (['closed', 'done', 'resolved', 'complete', 'completed', 'cancelled', 'canceled', "won't do", 'declined'].some(s => lower.includes(s))) {
+        return 'Closed';
+    }
+    if (['in progress', 'in review', 'in development', 'in testing', 'review', 'testing', 'dev', 'active', 'implementing'].some(s => lower.includes(s))) {
+        return 'In Progress';
+    }
+    return 'Open';
+}
+
+module.exports = createJiraTicketsRouter;

backend/routes/knowledgeBase.js

@@ -1,10 +1,11 @@
 const express = require('express');
 const path = require('path');
 const fs = require('fs');
-const { requireAuth, requireRole } = require('../middleware/auth');
+const pool = require('../db');
+const { requireAuth, requireGroup } = require('../middleware/auth');
 const logAudit = require('../helpers/auditLog');
 
-function createKnowledgeBaseRouter(db, upload) {
+function createKnowledgeBaseRouter(upload) {
   const router = express.Router();
 
   // Helper to sanitize filename
@@ -39,8 +40,8 @@ function createKnowledgeBaseRouter(db, upload) {
     return ALLOWED_EXTENSIONS.has(ext);
   }
 
-  // POST /api/knowledge-base/upload - Upload new document
-  router.post('/upload', requireAuth(db), requireRole(db, 'editor', 'admin'), (req, res, next) => {
+  // POST /api/knowledge-base/upload
+  router.post('/upload', requireAuth(), requireGroup('Admin', 'Standard_User'), (req, res, next) => {
     upload.single('file')(req, res, (err) => {
       if (err) {
         console.error('[KB Upload] Multer error:', err);
@@ -58,7 +59,6 @@ function createKnowledgeBaseRouter(db, upload) {
     const uploadedFile = req.file;
     const { title, description, category } = req.body;
 
-    // Validate required fields
     if (!title || !title.trim()) {
       console.error('[KB Upload] Error: Title is missing');
       if (uploadedFile) fs.unlinkSync(uploadedFile.path);
@@ -69,7 +69,6 @@ function createKnowledgeBaseRouter(db, upload) {
       return res.status(400).json({ error: 'No file uploaded' });
     }
 
-    // Validate file type
     if (!isValidFileType(uploadedFile.originalname)) {
       fs.unlinkSync(uploadedFile.path);
       return res.status(400).json({ error: 'File type not allowed' });
@@ -80,148 +79,125 @@ function createKnowledgeBaseRouter(db, upload) {
     const slug = generateSlug(title);
     const kbDir = path.join(__dirname, '..', 'uploads', 'knowledge_base');
 
-    // Create directory if it doesn't exist
-    if (!fs.existsSync(kbDir)) {
-      fs.mkdirSync(kbDir, { recursive: true });
-    }
-
     const filename = `${timestamp}_${sanitizedName}`;
     const filePath = path.join(kbDir, filename);
 
     try {
-      // Move uploaded file to permanent location
-      fs.renameSync(uploadedFile.path, filePath);
-
       // Check if slug already exists
-      db.get('SELECT id FROM knowledge_base WHERE slug = ?', [slug], (err, row) => {
-        if (err) {
-          fs.unlinkSync(filePath);
-          console.error('Error checking slug:', err);
-          return res.status(500).json({ error: 'Database error' });
+      const { rows: existingRows } = await pool.query(
+        'SELECT id FROM knowledge_base WHERE slug = $1', [slug]
+      );
+
+      const finalSlug = existingRows.length > 0 ? `${slug}-${timestamp}` : slug;
+
+      // Insert new knowledge base entry
+      const { rows } = await pool.query(
+        `INSERT INTO knowledge_base (
+          title, slug, description, category, file_path, file_name,
+          file_type, file_size, created_by
+        ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9)
+        RETURNING id`,
+        [
+          title.trim(),
+          finalSlug,
+          description || null,
+          category || 'General',
+          filePath,
+          sanitizedName,
+          uploadedFile.mimetype,
+          uploadedFile.size,
+          req.user.id
+        ]
+      );
+
+      // DB insert succeeded — now move file to permanent location
+      try {
+        if (!fs.existsSync(kbDir)) {
+          fs.mkdirSync(kbDir, { recursive: true });
         }
+        fs.renameSync(uploadedFile.path, filePath);
+      } catch (moveErr) {
+        console.error('Error moving file to permanent location:', moveErr);
+      }
 
-        // If slug exists, append timestamp to make it unique
-        const finalSlug = row ? `${slug}-${timestamp}` : slug;
+      logAudit({
+        userId: req.user.id,
+        username: req.user.username,
+        action: 'CREATE_KB_ARTICLE',
+        entityType: 'knowledge_base',
+        entityId: String(rows[0].id),
+        details: { title: title.trim(), filename: sanitizedName },
+        ipAddress: req.ip
+      });
 
-        // Insert new knowledge base entry
-        const insertSql = `
-          INSERT INTO knowledge_base (
-            title, slug, description, category, file_path, file_name,
-            file_type, file_size, created_by
-          ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-        `;
-
-        db.run(
-          insertSql,
-          [
-            title.trim(),
-            finalSlug,
-            description || null,
-            category || 'General',
-            filePath,
-            sanitizedName,
-            uploadedFile.mimetype,
-            uploadedFile.size,
-            req.user.id
-          ],
-          function (err) {
-            if (err) {
-              fs.unlinkSync(filePath);
-              console.error('Error inserting knowledge base entry:', err);
-              return res.status(500).json({ error: 'Failed to save document metadata' });
-            }
-
-            // Log audit entry
-            logAudit(
-              db,
-              req.user.id,
-              req.user.username,
-              'CREATE_KB_ARTICLE',
-              'knowledge_base',
-              this.lastID,
-              JSON.stringify({ title: title.trim(), filename: sanitizedName }),
-              req.ip
-            );
-
-            res.json({
-              success: true,
-              id: this.lastID,
-              title: title.trim(),
-              slug: finalSlug,
-              category: category || 'General'
-            });
-          }
-        );
+      res.json({
+        success: true,
+        id: rows[0].id,
+        title: title.trim(),
+        slug: finalSlug,
+        category: category || 'General'
       });
     } catch (error) {
-      // Clean up file on error
-      if (fs.existsSync(filePath)) fs.unlinkSync(filePath);
+      if (uploadedFile && fs.existsSync(uploadedFile.path)) fs.unlinkSync(uploadedFile.path);
       console.error('Error uploading knowledge base document:', error);
       res.status(500).json({ error: error.message || 'Failed to upload document' });
     }
   });
 
-  // GET /api/knowledge-base - List all articles
-  router.get('/', requireAuth(db), (req, res) => {
-    const sql = `
-      SELECT
-        kb.id, kb.title, kb.slug, kb.description, kb.category,
-        kb.file_name, kb.file_type, kb.file_size, kb.created_at, kb.updated_at,
-        u.username as created_by_username
-      FROM knowledge_base kb
-      LEFT JOIN users u ON kb.created_by = u.id
-      ORDER BY kb.created_at DESC
-    `;
-
-    db.all(sql, [], (err, rows) => {
-      if (err) {
-        console.error('Error fetching knowledge base articles:', err);
-        return res.status(500).json({ error: 'Failed to fetch articles' });
-      }
-
+  // GET /api/knowledge-base
+  router.get('/', requireAuth(), async (req, res) => {
+    try {
+      const { rows } = await pool.query(`
+        SELECT
+          kb.id, kb.title, kb.slug, kb.description, kb.category,
+          kb.file_name, kb.file_type, kb.file_size, kb.created_at, kb.updated_at,
+          u.username as created_by_username
+        FROM knowledge_base kb
+        LEFT JOIN users u ON kb.created_by = u.id
+        ORDER BY kb.created_at DESC
+      `);
       res.json(rows);
-    });
+    } catch (err) {
+      console.error('Error fetching knowledge base articles:', err);
+      res.status(500).json({ error: 'Failed to fetch articles' });
+    }
   });
 
-  // GET /api/knowledge-base/:id - Get single article details
-  router.get('/:id', requireAuth(db), (req, res) => {
+  // GET /api/knowledge-base/:id
+  router.get('/:id', requireAuth(), async (req, res) => {
     const { id } = req.params;
 
-    const sql = `
-      SELECT
-        kb.id, kb.title, kb.slug, kb.description, kb.category,
-        kb.file_name, kb.file_type, kb.file_size, kb.created_at, kb.updated_at,
-        u.username as created_by_username
-      FROM knowledge_base kb
-      LEFT JOIN users u ON kb.created_by = u.id
-      WHERE kb.id = ?
-    `;
+    try {
+      const { rows } = await pool.query(`
+        SELECT
+          kb.id, kb.title, kb.slug, kb.description, kb.category,
+          kb.file_name, kb.file_type, kb.file_size, kb.created_at, kb.updated_at,
+          u.username as created_by_username
+        FROM knowledge_base kb
+        LEFT JOIN users u ON kb.created_by = u.id
+        WHERE kb.id = $1
+      `, [id]);
 
-    db.get(sql, [id], (err, row) => {
-      if (err) {
-        console.error('Error fetching article:', err);
-        return res.status(500).json({ error: 'Failed to fetch article' });
-      }
-
-      if (!row) {
+      if (!rows[0]) {
         return res.status(404).json({ error: 'Article not found' });
       }
 
-      res.json(row);
-    });
+      res.json(rows[0]);
+    } catch (err) {
+      console.error('Error fetching article:', err);
+      res.status(500).json({ error: 'Failed to fetch article' });
+    }
   });
 
-  // GET /api/knowledge-base/:id/content - Get document content for display
-  router.get('/:id/content', requireAuth(db), (req, res) => {
+  // GET /api/knowledge-base/:id/content
+  router.get('/:id/content', requireAuth(), async (req, res) => {
     const { id } = req.params;
 
-    const sql = 'SELECT file_path, file_name, file_type FROM knowledge_base WHERE id = ?';
-
-    db.get(sql, [id], (err, row) => {
-      if (err) {
-        console.error('Error fetching document:', err);
-        return res.status(500).json({ error: 'Failed to fetch document' });
-      }
+    try {
+      const { rows } = await pool.query(
+        'SELECT file_path, file_name, file_type FROM knowledge_base WHERE id = $1', [id]
+      );
+      const row = rows[0];
 
       if (!row) {
         return res.status(404).json({ error: 'Document not found' });
@@ -231,49 +207,45 @@ function createKnowledgeBaseRouter(db, upload) {
         return res.status(404).json({ error: 'File not found on disk' });
       }
 
-      // Log audit entry
-      logAudit(
-        db,
-        req.user.id,
-        req.user.username,
-        'VIEW_KB_ARTICLE',
-        'knowledge_base',
-        id,
-        JSON.stringify({ filename: row.file_name }),
-        req.ip
-      );
+      logAudit({
+        userId: req.user.id,
+        username: req.user.username,
+        action: 'VIEW_KB_ARTICLE',
+        entityType: 'knowledge_base',
+        entityId: String(id),
+        details: { filename: row.file_name },
+        ipAddress: req.ip
+      });
 
-      // Determine content type for inline display
       let contentType = row.file_type || 'application/octet-stream';
-
-      // For markdown files, send as plain text so frontend can parse it
       if (row.file_name.endsWith('.md')) {
         contentType = 'text/plain; charset=utf-8';
       } else if (row.file_name.endsWith('.txt')) {
         contentType = 'text/plain; charset=utf-8';
       }
 
+      const safeFileName = row.file_name.replace(/["\r\n\\]/g, '');
       res.setHeader('Content-Type', contentType);
-      // Use inline instead of attachment to allow browser to display
-      res.setHeader('Content-Disposition', `inline; filename="${row.file_name}"`);
-      // Allow iframe embedding from frontend origin
+      res.setHeader('Content-Disposition', `inline; filename="${safeFileName}"`);
       res.removeHeader('X-Frame-Options');
-      res.setHeader('Content-Security-Policy', "frame-ancestors 'self' http://71.85.90.9:3000 http://localhost:3000");
+      const corsOrigins = process.env.CORS_ORIGINS ? process.env.CORS_ORIGINS.split(',').join(' ') : 'http://localhost:3000';
+      res.setHeader('Content-Security-Policy', `frame-ancestors 'self' ${corsOrigins}`);
       res.sendFile(row.file_path);
-    });
+    } catch (err) {
+      console.error('Error fetching document:', err);
+      res.status(500).json({ error: 'Failed to fetch document' });
+    }
   });
 
-  // GET /api/knowledge-base/:id/download - Download document
-  router.get('/:id/download', requireAuth(db), (req, res) => {
+  // GET /api/knowledge-base/:id/download
+  router.get('/:id/download', requireAuth(), async (req, res) => {
     const { id } = req.params;
 
-    const sql = 'SELECT file_path, file_name, file_type FROM knowledge_base WHERE id = ?';
-
-    db.get(sql, [id], (err, row) => {
-      if (err) {
-        console.error('Error fetching document:', err);
-        return res.status(500).json({ error: 'Failed to fetch document' });
-      }
+    try {
+      const { rows } = await pool.query(
+        'SELECT file_path, file_name, file_type FROM knowledge_base WHERE id = $1', [id]
+      );
+      const row = rows[0];
 
       if (!row) {
         return res.status(404).json({ error: 'Document not found' });
@@ -283,67 +255,67 @@ function createKnowledgeBaseRouter(db, upload) {
         return res.status(404).json({ error: 'File not found on disk' });
       }
 
-      // Log audit entry
-      logAudit(
-        db,
-        req.user.id,
-        req.user.username,
-        'DOWNLOAD_KB_ARTICLE',
-        'knowledge_base',
-        id,
-        JSON.stringify({ filename: row.file_name }),
-        req.ip
-      );
+      logAudit({
+        userId: req.user.id,
+        username: req.user.username,
+        action: 'DOWNLOAD_KB_ARTICLE',
+        entityType: 'knowledge_base',
+        entityId: String(id),
+        details: { filename: row.file_name },
+        ipAddress: req.ip
+      });
 
+      const safeDownloadName = row.file_name.replace(/["\r\n\\]/g, '');
       res.setHeader('Content-Type', row.file_type || 'application/octet-stream');
-      res.setHeader('Content-Disposition', `attachment; filename="${row.file_name}"`);
+      res.setHeader('Content-Disposition', `attachment; filename="${safeDownloadName}"`);
       res.sendFile(row.file_path);
-    });
+    } catch (err) {
+      console.error('Error fetching document:', err);
+      res.status(500).json({ error: 'Failed to fetch document' });
+    }
   });
 
-  // DELETE /api/knowledge-base/:id - Delete article
-  router.delete('/:id', requireAuth(db), requireRole(db, 'editor', 'admin'), (req, res) => {
+  // DELETE /api/knowledge-base/:id
+  router.delete('/:id', requireAuth(), requireGroup('Admin', 'Standard_User'), async (req, res) => {
     const { id } = req.params;
 
-    const sql = 'SELECT file_path, title FROM knowledge_base WHERE id = ?';
-
-    db.get(sql, [id], (err, row) => {
-      if (err) {
-        console.error('Error fetching article for deletion:', err);
-        return res.status(500).json({ error: 'Failed to fetch article' });
-      }
+    try {
+      const { rows } = await pool.query(
+        'SELECT file_path, title, created_by FROM knowledge_base WHERE id = $1', [id]
+      );
+      const row = rows[0];
 
       if (!row) {
         return res.status(404).json({ error: 'Article not found' });
       }
 
-      // Delete database record
-      db.run('DELETE FROM knowledge_base WHERE id = ?', [id], (err) => {
-        if (err) {
-          console.error('Error deleting article:', err);
-          return res.status(500).json({ error: 'Failed to delete article' });
-        }
+      // Ownership check: Standard_User can only delete articles they created
+      if (req.user.group === 'Standard_User' && row.created_by !== req.user.id) {
+        return res.status(403).json({ error: 'You can only delete resources you created' });
+      }
 
-        // Delete file
-        if (fs.existsSync(row.file_path)) {
-          fs.unlinkSync(row.file_path);
-        }
+      await pool.query('DELETE FROM knowledge_base WHERE id = $1', [id]);
 
-        // Log audit entry
-        logAudit(
-          db,
-          req.user.id,
-          req.user.username,
-          'DELETE_KB_ARTICLE',
-          'knowledge_base',
-          id,
-          JSON.stringify({ title: row.title }),
-          req.ip
-        );
+      // Delete file
+      if (fs.existsSync(row.file_path)) {
+        fs.unlinkSync(row.file_path);
+      }
 
-        res.json({ success: true });
+      logAudit({
+        userId: req.user.id,
+        username: req.user.username,
+        action: 'DELETE_KB_ARTICLE',
+        entityType: 'knowledge_base',
+        entityId: String(id),
+        details: { title: row.title },
+        ipAddress: req.ip
       });
-    });
+
+      res.json({ success: true });
+    } catch (err) {
+      console.error('Error deleting article:', err);
+      res.status(500).json({ error: 'Failed to delete article' });
+    }
   });
 
   return router;

backend/routes/nvdLookup.js

@@ -1,13 +1,14 @@
 // NVD CVE Lookup Routes
 const express = require('express');
+const { requireAuth } = require('../middleware/auth');
 
 const CVE_ID_PATTERN = /^CVE-\d{4}-\d{4,}$/;
 
-function createNvdLookupRouter(db, requireAuth) {
+function createNvdLookupRouter() {
     const router = express.Router();
 
     // All routes require authentication
-    router.use(requireAuth(db));
+    router.use(requireAuth());
 
     // Lookup CVE details from NVD API 2.0
     router.get('/lookup/:cveId', async (req, res) => {

backend/routes/users.js

@@ -1,27 +1,28 @@
 // User Management Routes (Admin only)
 const express = require('express');
 const bcrypt = require('bcryptjs');
+const pool = require('../db');
+const { validateTeams } = require('../helpers/teams');
 
-function createUsersRouter(db, requireAuth, requireRole, logAudit) {
+function createUsersRouter(requireAuth, requireGroup, logAudit) {
     const router = express.Router();
 
-    // All routes require admin role
-    router.use(requireAuth(db), requireRole('admin'));
+    // All routes require Admin group
+    router.use(requireAuth(), requireGroup('Admin'));
 
     // Get all users
     router.get('/', async (req, res) => {
         try {
-            const users = await new Promise((resolve, reject) => {
-                db.all(
-                    `SELECT id, username, email, role, is_active, created_at, last_login
-                     FROM users ORDER BY created_at DESC`,
-                    (err, rows) => {
-                        if (err) reject(err);
-                        else resolve(rows);
-                    }
-                );
-            });
-            res.json(users);
+            const { rows: users } = await pool.query(
+                `SELECT id, username, email, user_group AS "group", bu_teams, is_active, created_at, last_login
+                 FROM users ORDER BY created_at DESC`
+            );
+            // Parse bu_teams into teams array for each user
+            const usersWithTeams = users.map(u => ({
+                ...u,
+                teams: u.bu_teams ? u.bu_teams.split(',').filter(Boolean) : []
+            }));
+            res.json(usersWithTeams);
         } catch (err) {
             console.error('Get users error:', err);
             res.status(500).json({ error: 'Failed to fetch users' });
@@ -31,23 +32,22 @@ function createUsersRouter(db, requireAuth, requireRole, logAudit) {
     // Get single user
     router.get('/:id', async (req, res) => {
         try {
-            const user = await new Promise((resolve, reject) => {
-                db.get(
-                    `SELECT id, username, email, role, is_active, created_at, last_login
-                     FROM users WHERE id = ?`,
-                    [req.params.id],
-                    (err, row) => {
-                        if (err) reject(err);
-                        else resolve(row);
-                    }
-                );
-            });
+            const { rows } = await pool.query(
+                `SELECT id, username, email, user_group AS "group", bu_teams, is_active, created_at, last_login
+                 FROM users WHERE id = $1`,
+                [req.params.id]
+            );
+
+            const user = rows[0];
 
             if (!user) {
                 return res.status(404).json({ error: 'User not found' });
             }
 
-            res.json(user);
+            res.json({
+                ...user,
+                teams: user.bu_teams ? user.bu_teams.split(',').filter(Boolean) : []
+            });
         } catch (err) {
             console.error('Get user error:', err);
             res.status(500).json({ error: 'Failed to fetch user' });
@@ -56,38 +56,47 @@ function createUsersRouter(db, requireAuth, requireRole, logAudit) {
 
     // Create new user
     router.post('/', async (req, res) => {
-        const { username, email, password, role } = req.body;
+        const { username, email, password, group, bu_teams } = req.body;
+        const VALID_GROUPS = ['Admin', 'Standard_User', 'Leadership', 'Read_Only'];
 
         if (!username || !email || !password) {
             return res.status(400).json({ error: 'Username, email, and password are required' });
         }
 
-        if (role && !['admin', 'editor', 'viewer'].includes(role)) {
-            return res.status(400).json({ error: 'Invalid role. Must be admin, editor, or viewer' });
+        const userGroup = group || 'Read_Only';
+
+        if (!VALID_GROUPS.includes(userGroup)) {
+            return res.status(400).json({ error: 'Invalid group. Must be one of: Admin, Standard_User, Leadership, Read_Only' });
+        }
+
+        // Validate bu_teams if provided
+        const teamsStr = bu_teams || '';
+        if (teamsStr) {
+            const teamsResult = validateTeams(teamsStr);
+            if (!teamsResult.valid) {
+                return res.status(400).json({ error: `Invalid team(s): ${teamsResult.invalid.join(', ')}. Must be one of: STEAM, ACCESS-ENG, ACCESS-OPS, INTELDEV` });
+            }
         }
 
         try {
             const passwordHash = await bcrypt.hash(password, 10);
 
-            const result = await new Promise((resolve, reject) => {
-                db.run(
-                    `INSERT INTO users (username, email, password_hash, role)
-                     VALUES (?, ?, ?, ?)`,
-                    [username, email, passwordHash, role || 'viewer'],
-                    function(err) {
-                        if (err) reject(err);
-                        else resolve({ id: this.lastID });
-                    }
-                );
-            });
+            const { rows } = await pool.query(
+                `INSERT INTO users (username, email, password_hash, user_group, bu_teams)
+                 VALUES ($1, $2, $3, $4, $5)
+                 RETURNING id`,
+                [username, email, passwordHash, userGroup, teamsStr]
+            );
 
-            logAudit(db, {
+            const result = rows[0];
+
+            logAudit({
                 userId: req.user.id,
                 username: req.user.username,
                 action: 'user_create',
                 entityType: 'user',
                 entityId: String(result.id),
-                details: { created_username: username, role: role || 'viewer' },
+                details: { created_username: username, group: userGroup, bu_teams: teamsStr },
                 ipAddress: req.ip
             });
 
@@ -97,12 +106,14 @@ function createUsersRouter(db, requireAuth, requireRole, logAudit) {
                     id: result.id,
                     username,
                     email,
-                    role: role || 'viewer'
+                    group: userGroup,
+                    bu_teams: teamsStr,
+                    teams: teamsStr ? teamsStr.split(',').filter(Boolean) : []
                 }
             });
         } catch (err) {
             console.error('Create user error:', err);
-            if (err.message.includes('UNIQUE constraint failed')) {
+            if (err.code === '23505') { // Postgres unique violation
                 return res.status(409).json({ error: 'Username or email already exists' });
             }
             res.status(500).json({ error: 'Failed to create user' });
@@ -111,46 +122,76 @@ function createUsersRouter(db, requireAuth, requireRole, logAudit) {
 
     // Update user
     router.patch('/:id', async (req, res) => {
-        const { username, email, password, role, is_active } = req.body;
+        const { username, email, password, group, is_active, bu_teams } = req.body;
+        const VALID_GROUPS = ['Admin', 'Standard_User', 'Leadership', 'Read_Only'];
         const userId = req.params.id;
 
-        // Prevent self-demotion from admin
-        if (userId == req.user.id && role && role !== 'admin') {
-            return res.status(400).json({ error: 'Cannot remove your own admin role' });
+        // Validate group if provided
+        if (group && !VALID_GROUPS.includes(group)) {
+            return res.status(400).json({ error: 'Invalid group. Must be one of: Admin, Standard_User, Leadership, Read_Only' });
+        }
+
+        // Prevent admin self-demotion
+        if (String(userId) === String(req.user.id) && group && group !== 'Admin') {
+            return res.status(400).json({ error: 'Cannot remove your own admin group' });
         }
 
         // Prevent self-deactivation
-        if (userId == req.user.id && is_active === false) {
+        if (String(userId) === String(req.user.id) && is_active === false) {
             return res.status(400).json({ error: 'Cannot deactivate your own account' });
         }
 
+        // Validate bu_teams if provided
+        if (typeof bu_teams === 'string') {
+            if (bu_teams !== '') {
+                const teamsResult = validateTeams(bu_teams);
+                if (!teamsResult.valid) {
+                    return res.status(400).json({ error: `Invalid team(s): ${teamsResult.invalid.join(', ')}. Must be one of: STEAM, ACCESS-ENG, ACCESS-OPS, INTELDEV` });
+                }
+            }
+        }
+
         try {
+            // Fetch current user record before update (needed for group change audit)
+            const { rows: currentRows } = await pool.query(
+                'SELECT user_group, bu_teams FROM users WHERE id = $1',
+                [userId]
+            );
+
+            const currentUser = currentRows[0];
+
+            if (!currentUser) {
+                return res.status(404).json({ error: 'User not found' });
+            }
+
             const updates = [];
             const values = [];
+            let paramIndex = 1;
 
             if (username) {
-                updates.push('username = ?');
+                updates.push(`username = $${paramIndex++}`);
                 values.push(username);
             }
             if (email) {
-                updates.push('email = ?');
+                updates.push(`email = $${paramIndex++}`);
                 values.push(email);
             }
             if (password) {
                 const passwordHash = await bcrypt.hash(password, 10);
-                updates.push('password_hash = ?');
+                updates.push(`password_hash = $${paramIndex++}`);
                 values.push(passwordHash);
             }
-            if (role) {
-                if (!['admin', 'editor', 'viewer'].includes(role)) {
-                    return res.status(400).json({ error: 'Invalid role' });
-                }
-                updates.push('role = ?');
-                values.push(role);
+            if (group) {
+                updates.push(`user_group = $${paramIndex++}`);
+                values.push(group);
             }
             if (typeof is_active === 'boolean') {
-                updates.push('is_active = ?');
-                values.push(is_active ? 1 : 0);
+                updates.push(`is_active = $${paramIndex++}`);
+                values.push(is_active);
+            }
+            if (typeof bu_teams === 'string') {
+                updates.push(`bu_teams = $${paramIndex++}`);
+                values.push(bu_teams);
             }
 
             if (updates.length === 0) {
@@ -159,25 +200,20 @@ function createUsersRouter(db, requireAuth, requireRole, logAudit) {
 
             values.push(userId);
 
-            await new Promise((resolve, reject) => {
-                db.run(
-                    `UPDATE users SET ${updates.join(', ')} WHERE id = ?`,
-                    values,
-                    function(err) {
-                        if (err) reject(err);
-                        else resolve({ changes: this.changes });
-                    }
-                );
-            });
+            await pool.query(
+                `UPDATE users SET ${updates.join(', ')} WHERE id = $${paramIndex}`,
+                values
+            );
 
             const updatedFields = {};
             if (username) updatedFields.username = username;
             if (email) updatedFields.email = email;
-            if (role) updatedFields.role = role;
+            if (group) updatedFields.group = group;
             if (typeof is_active === 'boolean') updatedFields.is_active = is_active;
             if (password) updatedFields.password_changed = true;
+            if (typeof bu_teams === 'string') updatedFields.bu_teams = bu_teams;
 
-            logAudit(db, {
+            logAudit({
                 userId: req.user.id,
                 username: req.user.username,
                 action: 'user_update',
@@ -187,17 +223,47 @@ function createUsersRouter(db, requireAuth, requireRole, logAudit) {
                 ipAddress: req.ip
             });
 
+            // Log specific audit entry for group changes
+            if (group && group !== currentUser.user_group) {
+                logAudit({
+                    userId: req.user.id,
+                    username: req.user.username,
+                    action: 'user_group_change',
+                    entityType: 'user',
+                    entityId: String(userId),
+                    details: {
+                        previous_group: currentUser.user_group,
+                        new_group: group
+                    },
+                    ipAddress: req.ip
+                });
+            }
+
+            // Log specific audit entry for bu_teams changes
+            if (typeof bu_teams === 'string' && bu_teams !== (currentUser.bu_teams || '')) {
+                logAudit({
+                    userId: req.user.id,
+                    username: req.user.username,
+                    action: 'user_teams_change',
+                    entityType: 'user',
+                    entityId: String(userId),
+                    details: {
+                        previous_teams: currentUser.bu_teams || '',
+                        new_teams: bu_teams
+                    },
+                    ipAddress: req.ip
+                });
+            }
+
             // If user was deactivated, delete their sessions
             if (is_active === false) {
-                await new Promise((resolve) => {
-                    db.run('DELETE FROM sessions WHERE user_id = ?', [userId], () => resolve());
-                });
+                await pool.query('DELETE FROM sessions WHERE user_id = $1', [userId]);
             }
 
             res.json({ message: 'User updated successfully' });
         } catch (err) {
             console.error('Update user error:', err);
-            if (err.message.includes('UNIQUE constraint failed')) {
+            if (err.code === '23505') { // Postgres unique violation
                 return res.status(409).json({ error: 'Username or email already exists' });
             }
             res.status(500).json({ error: 'Failed to update user' });
@@ -209,37 +275,29 @@ function createUsersRouter(db, requireAuth, requireRole, logAudit) {
         const userId = req.params.id;
 
         // Prevent self-deletion
-        if (userId == req.user.id) {
+        if (String(userId) === String(req.user.id)) {
             return res.status(400).json({ error: 'Cannot delete your own account' });
         }
 
         try {
             // Look up the user before deleting
-            const targetUser = await new Promise((resolve, reject) => {
-                db.get('SELECT username FROM users WHERE id = ?', [userId], (err, row) => {
-                    if (err) reject(err);
-                    else resolve(row);
-                });
-            });
+            const { rows: userRows } = await pool.query(
+                'SELECT username FROM users WHERE id = $1',
+                [userId]
+            );
+            const targetUser = userRows[0];
 
             // Delete sessions first (foreign key)
-            await new Promise((resolve) => {
-                db.run('DELETE FROM sessions WHERE user_id = ?', [userId], () => resolve());
-            });
+            await pool.query('DELETE FROM sessions WHERE user_id = $1', [userId]);
 
             // Delete user
-            const result = await new Promise((resolve, reject) => {
-                db.run('DELETE FROM users WHERE id = ?', [userId], function(err) {
-                    if (err) reject(err);
-                    else resolve({ changes: this.changes });
-                });
-            });
+            const result = await pool.query('DELETE FROM users WHERE id = $1', [userId]);
 
-            if (result.changes === 0) {
+            if (result.rowCount === 0) {
                 return res.status(404).json({ error: 'User not found' });
             }
 
-            logAudit(db, {
+            logAudit({
                 userId: req.user.id,
                 username: req.user.username,
                 action: 'user_delete',

backend/scripts/card-granite-lookup.js

@@ -0,0 +1,388 @@
+#!/usr/bin/env node
+// ==========================================================================
+// CARD → Granite Lookup Script (v2)
+// ==========================================================================
+// Queries CARD team assets endpoint (which returns full enriched records
+// including ncim_discovery with EQUIP_INST_ID) for the 109 reassigned IPs
+// from the findings-count investigation Appendix C.
+//
+// Generates:
+//   docs/card-lookup-results.csv       — full CARD data for review
+//   docs/granite-reassignment-upload.csv — Team_Device Loader format
+//
+// Usage:
+//   cd backend
+//   node scripts/card-granite-lookup.js
+// ==========================================================================
+
+require('dotenv').config({ path: require('path').join(__dirname, '..', '.env') });
+
+const cardApi = require('../helpers/cardApi');
+const fs      = require('fs');
+const path    = require('path');
+
+// ---------------------------------------------------------------------------
+// IP → hostname mapping from Appendix C
+// ---------------------------------------------------------------------------
+const REASSIGNED = {
+    // With approved FP workflows (58)
+    '98.120.0.78': 'syn-098-120-000-078', '98.120.32.185': 'syn-098-120-032-185',
+    '10.240.78.177': 'mon15-agg-sw', '10.240.78.176': 'mon16-agg-sw',
+    '10.240.78.133': 'mon15-sw14', '10.240.78.130': 'mon15-sw11',
+    '10.240.78.150': 'mon19-sw3', '10.240.78.107': 'mon16-sw2',
+    '10.240.78.110': 'mon16-sw5', '10.240.78.106': 'mon16-sw1',
+    '10.240.78.149': 'mon19-sw2', '10.240.78.154': 'mon19-sw7',
+    '10.240.78.111': 'mon16-sw6', '10.240.78.153': 'mon19-sw6',
+    '10.240.78.132': 'mon15-sw13', '10.240.78.115': 'mon16-sw10',
+    '10.240.78.109': 'mon16-sw4', '10.240.78.112': 'mon16-sw7',
+    '10.240.78.119': 'mon16-sw14', '10.240.78.114': 'mon16-sw9',
+    '10.240.78.118': 'mon16-sw13', '10.240.78.117': 'mon16-sw12',
+    '10.240.78.108': 'mon16-sw3', '10.240.78.155': 'mon19-sw8',
+    '10.240.78.157': 'mon19-sw10', '10.240.78.151': 'mon19-sw4',
+    '10.240.78.116': 'mon16-sw11', '10.240.78.152': 'mon19-sw5',
+    '10.240.78.161': 'mon19-sw14', '10.240.78.160': 'mon19-sw13',
+    '10.240.78.159': 'mon19-sw12', '10.240.78.158': 'mon19-sw11',
+    '10.240.78.123': 'mon15-sw4', '10.240.78.137': 'mon20-sw4',
+    '10.240.78.148': 'mon19-sw1', '10.240.78.125': 'mon15-sw6',
+    '10.240.78.156': 'mon19-sw9', '10.241.0.63': '',
+    '10.244.11.51': 'apc01se1shcc-n01-bmc', '172.27.72.1': '',
+    '96.37.185.145': '', '10.240.78.170': 'mon17-sw9',
+    '10.240.78.172': 'mon17-sw11', '10.240.78.169': 'mon17-sw8',
+    '10.240.78.166': 'mon17-sw5', '10.240.78.174': 'mon17-sw13',
+    '10.240.78.173': 'mon17-sw12', '10.240.78.167': 'mon17-sw6',
+    '10.240.78.175': 'mon17-sw14', '10.240.78.168': 'mon17-sw7',
+    '10.240.78.171': 'mon17-sw10', '66.61.128.10': 'syn-066-061-128-010',
+    '66.61.128.233': 'apa01se1shcc-bvi101-secondary',
+    '66.61.128.49': 'syn-066-061-128-049', '66.61.128.18': 'syn-066-061-128-018',
+    '10.244.4.26': '', '10.244.11.5': '', '10.244.11.6': '',
+    // With rejected FP workflows (8)
+    '10.244.4.55': 'apc15se1shcc-n03', '10.244.11.53': 'apc01se1shcc-n03-bmc',
+    '10.244.4.30': '', '10.244.11.63': 'apc04se1shcc-n01-cimc',
+    '24.28.208.125': '', '24.28.210.101': 'syn-024-028-210-101',
+    '10.244.11.27': '', '10.240.1.203': '',
+    // Without FP workflows (43)
+    '10.240.78.20': '', '172.16.1.229': '',
+    '10.244.11.96': '', '10.244.11.54': 'apc02se1shcc-n01-cimc',
+    '10.244.4.51': 'apc14se1shcc-n02', '10.244.11.86': '',
+    '10.244.11.55': 'apc02se1shcc-n02-cimc', '24.28.208.105': 'syn-024-028-208-105',
+    '10.244.4.50': 'apc14se1shcc-n01', '10.244.4.53': 'apc15se1shcc-n01',
+    '10.244.11.73': 'apc07se1shcc-n02-cimc', '10.244.11.64': 'apc04se1shcc-n02-cimc',
+    '10.244.4.54': 'apc15se1shcc-n02', '10.244.4.28': '',
+    '10.244.11.94': '', '10.241.0.43': 'c220-wzp27340ss5',
+    '10.244.11.56': 'apc02se1shcc-n03-cimc', '10.244.11.66': 'apc05se1shcc-n01-bmc',
+    '10.244.4.47': 'apc13se1shcc-n01', '10.244.4.49': 'apc13se1shcc-n03',
+    '10.244.4.52': 'apc14se1shcc-n03', '10.244.11.72': 'apc07se1shcc-n01-cimc',
+    '10.244.4.25': 'apc02ctsbcom7-n03-cimc', '10.244.4.29': '',
+    '10.244.11.74': 'apc07se1shcc-n03-cimc', '10.244.4.48': 'apc13se1shcc-n02',
+    '10.244.11.65': 'apc04se1shcc-n03-cimc', '10.244.4.24': 'apc02ctsbcom7-n02-cimc',
+    '10.244.11.87': '', '10.244.11.68': 'apc05se1shcc-n03-bmc',
+    '10.244.11.67': 'apc05se1shcc-n02-bmc', '10.244.4.23': 'apc02ctsbcom7-n01-cimc',
+    '10.244.11.57': '', '10.244.11.95': '',
+    '98.120.32.145': 'syn-098-120-032-145', '98.120.0.129': 'syn-098-120-000-129',
+    '68.114.184.84': 'rphy-runner-vecima',
+};
+
+const TARGET_IPS = new Set(Object.keys(REASSIGNED));
+
+// ---------------------------------------------------------------------------
+// Fetch all assets for both teams, then match against our IP list
+// ---------------------------------------------------------------------------
+async function fetchTeamAssets(teamName) {
+    const allAssets = [];
+    let page = 1;
+    const pageSize = 200;
+
+    while (true) {
+        // Fetch confirmed assets (these have the richest data)
+        const result = await cardApi.getTeamAssets(teamName, {
+            disposition: 'confirmed',
+            page,
+            pageSize,
+        });
+
+        if (!result.ok) {
+            console.error(`  Failed to fetch ${teamName} page ${page}: HTTP ${result.status}`);
+            break;
+        }
+
+        let data;
+        try { data = JSON.parse(result.body); } catch (_) { break; }
+
+        const assets = Array.isArray(data) ? data : (data.assets || data.results || []);
+        allAssets.push(...assets);
+
+        const total = data.total || assets.length;
+        console.log(`  ${teamName} page ${page}: ${assets.length} assets (total: ${total})`);
+
+        if (allAssets.length >= total || assets.length === 0) break;
+        page++;
+    }
+
+    return allAssets;
+}
+
+function extractIPFromAssetId(assetId) {
+    // Asset IDs are like "10.240.78.110-CTEC" — strip the suffix
+    if (!assetId) return null;
+    const parts = assetId.split('-');
+    // Rejoin all but the last part (the suffix like CTEC, NATL, etc.)
+    // But only if the last part looks like a suffix (not a number)
+    const last = parts[parts.length - 1];
+    if (/^\d+$/.test(last)) return assetId; // All numeric, probably just an IP
+    return parts.slice(0, -1).join('-');
+}
+
+function extractGraniteData(asset) {
+    const id = asset._id || '';
+    const ip = extractIPFromAssetId(id);
+    const flags = (asset.card_flags && asset.card_flags[0]) || {};
+    const ncim = asset.ncim_discovery || [];
+    const qualys = asset.qualys_hosts || [];
+    const ivanti = asset.ivanti_assets || [];
+    const granite = asset.netops_granite_allips || null;
+    const iseGranite = asset.ise_granite_equipment || null;
+
+    // Extract EQUIP_INST_ID from ncim_discovery (primary source)
+    let equipInstId = null;
+    let graniteTeam = null;
+    let entityId = null;
+    let sysLocation = null;
+    let ncimHostname = null;
+
+    if (ncim.length > 0) {
+        equipInstId = ncim[0].EQUIP_INST_ID || null;
+        graniteTeam = ncim[0].GRANITE_RESP_TEAM || ncim[0].RESPONSIBLE_TEAM || null;
+        entityId = ncim[0].ENTITYID || null;
+        sysLocation = ncim[0].SYSLOCATION || null;
+        ncimHostname = ncim[0].HOSTNAME || null;
+    }
+
+    // Fallback: check netops_granite_allips
+    if (!equipInstId && granite && Array.isArray(granite) && granite.length > 0) {
+        equipInstId = granite[0].EQUIP_INST_ID || null;
+    }
+
+    // Fallback: check ise_granite_equipment
+    if (!equipInstId && iseGranite && Array.isArray(iseGranite) && iseGranite.length > 0) {
+        equipInstId = iseGranite[0].EQUIP_INST_ID || null;
+    }
+
+    const hostname = ncimHostname
+        || (flags.CARD_HOSTNAME && flags.CARD_HOSTNAME[0])
+        || (qualys.length > 0 && qualys[0].HOSTNAME)
+        || (ivanti.length > 0 && ivanti[0].hostName)
+        || '';
+
+    const confirmedTeam = asset.owner && asset.owner.confirmed
+        ? asset.owner.confirmed.name : null;
+
+    return {
+        ip,
+        assetId: id,
+        hostname,
+        equipInstId,
+        graniteTeam,
+        entityId,
+        sysLocation,
+        confirmedTeam,
+        deviceId: flags.CARD_DEVICE_ID || null,
+        asn: flags.CARD_ASN || null,
+        vendorModel: (flags.CARD_VENDOR_MODEL || []).map(v => v.vendor_model || v).join(', '),
+        status: flags.status || null,
+    };
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    console.log('=== CARD → Granite Lookup (v2 — team assets endpoint) ===');
+    console.log(`Target IPs: ${TARGET_IPS.size}`);
+    console.log(`CARD_API_URL: ${process.env.CARD_API_URL}`);
+    console.log('');
+
+    if (!cardApi.isConfigured) {
+        console.error('CARD API is not configured.');
+        process.exit(1);
+    }
+
+    // Fetch assets from both teams
+    const teams = ['NTS-AEO-STEAM', 'NTS-AEO-ACCESS-ENG'];
+    const allAssets = [];
+
+    for (const team of teams) {
+        console.log(`Fetching ${team}...`);
+        const assets = await fetchTeamAssets(team);
+        allAssets.push(...assets);
+        console.log(`  Total: ${assets.length} assets\n`);
+    }
+
+    // Also fetch candidate/unconfirmed in case some were reassigned
+    for (const team of teams) {
+        for (const disp of ['candidate', 'unconfirmed']) {
+            console.log(`Fetching ${team} (${disp})...`);
+            try {
+                const result = await cardApi.getTeamAssets(team, { disposition: disp, pageSize: 200 });
+                if (result.ok) {
+                    const data = JSON.parse(result.body);
+                    const assets = Array.isArray(data) ? data : (data.assets || data.results || []);
+                    allAssets.push(...assets);
+                    console.log(`  ${assets.length} assets`);
+                }
+            } catch (_) { /* skip */ }
+        }
+    }
+
+    console.log(`\nTotal assets fetched: ${allAssets.length}`);
+
+    // Build IP → asset map
+    const ipMap = new Map();
+    for (const asset of allAssets) {
+        const id = asset._id || '';
+        const ip = extractIPFromAssetId(id);
+        if (ip && !ipMap.has(ip)) {
+            ipMap.set(ip, asset);
+        }
+    }
+
+    console.log(`Unique IPs in CARD: ${ipMap.size}`);
+
+    // Match against our target IPs
+    const matched = [];
+    const notFound = [];
+
+    for (const ip of TARGET_IPS) {
+        const asset = ipMap.get(ip);
+        if (asset) {
+            matched.push(extractGraniteData(asset));
+        } else {
+            notFound.push(ip);
+        }
+    }
+
+    // For IPs not found in team assets, fall back to individual owner lookup
+    if (notFound.length > 0) {
+        console.log(`\n${notFound.length} IPs not in team assets — trying individual owner lookups...`);
+        const SUFFIXES = ['CTEC', 'NATL', 'TWC', 'BHN', 'CHTR'];
+        const stillNotFound = [];
+
+        for (const ip of notFound) {
+            let found = false;
+            for (const suffix of SUFFIXES) {
+                try {
+                    const result = await cardApi.getOwner(`${ip}-${suffix}`);
+                    if (result.ok) {
+                        const data = JSON.parse(result.body);
+                        // Owner endpoint is slim — extract what we can
+                        const ncim = data.ncim_discovery || [];
+                        matched.push({
+                            ip,
+                            assetId: data._id || `${ip}-${suffix}`,
+                            hostname: REASSIGNED[ip] || '',
+                            equipInstId: ncim.length > 0 ? (ncim[0].EQUIP_INST_ID || null) : null,
+                            graniteTeam: ncim.length > 0 ? (ncim[0].GRANITE_RESP_TEAM || null) : null,
+                            entityId: ncim.length > 0 ? (ncim[0].ENTITYID || null) : null,
+                            sysLocation: ncim.length > 0 ? (ncim[0].SYSLOCATION || null) : null,
+                            confirmedTeam: data.owner && data.owner.confirmed ? data.owner.confirmed.name : null,
+                            deviceId: null,
+                            asn: null,
+                            vendorModel: '',
+                            status: null,
+                        });
+                        found = true;
+                        break;
+                    }
+                } catch (_) { /* continue */ }
+            }
+            if (!found) stillNotFound.push(ip);
+        }
+
+        if (stillNotFound.length > 0) {
+            console.log(`\n${stillNotFound.length} IPs not found anywhere in CARD:`);
+            stillNotFound.forEach(ip => console.log(`  ${ip} (${REASSIGNED[ip] || 'no hostname'})`));
+        }
+    }
+
+    // Sort by IP
+    matched.sort((a, b) => {
+        const aParts = a.ip.split('.').map(Number);
+        const bParts = b.ip.split('.').map(Number);
+        for (let i = 0; i < 4; i++) {
+            if (aParts[i] !== bParts[i]) return aParts[i] - bParts[i];
+        }
+        return 0;
+    });
+
+    // Summary
+    const withEquipId = matched.filter(r => r.equipInstId);
+    const withoutEquipId = matched.filter(r => !r.equipInstId);
+
+    console.log('\n=== Summary ===');
+    console.log(`Matched in CARD:        ${matched.length}`);
+    console.log(`With EQUIP_INST_ID:     ${withEquipId.length}`);
+    console.log(`Without EQUIP_INST_ID:  ${withoutEquipId.length}`);
+
+    // Print results
+    console.log('\n=== Results with EQUIP_INST_ID ===');
+    console.log('IP Address           | EQUIP_INST_ID | Hostname                       | Granite Team');
+    console.log('-'.repeat(100));
+    for (const r of withEquipId) {
+        console.log(`${r.ip.padEnd(20)} | ${String(r.equipInstId).padEnd(13)} | ${(r.hostname || '').padEnd(30)} | ${r.graniteTeam || '-'}`);
+    }
+
+    if (withoutEquipId.length > 0) {
+        console.log('\n=== Results WITHOUT EQUIP_INST_ID ===');
+        for (const r of withoutEquipId) {
+            console.log(`  ${r.ip.padEnd(20)} ${(r.hostname || REASSIGNED[r.ip] || '').padEnd(30)} confirmed: ${r.confirmedTeam || '-'}`);
+        }
+    }
+
+    // Write full CSV
+    const csvPath = path.join(__dirname, '..', '..', 'docs', 'card-lookup-results.csv');
+    const csvHeader = 'IP Address,CARD Asset ID,Hostname,EQUIP_INST_ID,Granite Team,Entity ID,SysLocation,Confirmed Team,Device ID,ASN,Vendor Model,Status';
+    const csvRows = matched.map(r =>
+        [r.ip, r.assetId, r.hostname, r.equipInstId, r.graniteTeam, r.entityId, r.sysLocation, r.confirmedTeam, r.deviceId, r.asn, r.vendorModel, r.status]
+            .map(v => v === null || v === undefined ? '' : `"${String(v).replace(/"/g, '""')}"`)
+            .join(',')
+    );
+    fs.writeFileSync(csvPath, csvHeader + '\n' + csvRows.join('\n') + '\n', 'utf8');
+    console.log(`\nFull CSV: ${csvPath}`);
+
+    // Write Granite Team_Device Loader CSV
+    const graniteHeaders = [
+        'DELETE', 'SET_CONFIRMED', 'EQUIPMENT CLASS', 'EQUIP_INST_ID', 'SITE_NAME',
+        'EQUIP_NAME', 'EQUIP_TEMPLATE', 'EQUIP_STATUS',
+        'UDA#RESPONSIBLE ORGANIZATION#RESPONSIBLE TEAM',
+        'UDA#IP_ADDRESSING#IPV4_ADDRESS',
+        'UDA#IP_ADDRESSING#MAC ADDRESS', 'UDA#IP_ADDRESSING#MGMT_IP_ASN', 'SERIALNUMBER',
+    ];
+
+    const graniteRows = withEquipId.map(r => [
+        '',                          // DELETE
+        '',                          // SET_CONFIRMED
+        'S',                         // EQUIPMENT CLASS (Shelf)
+        r.equipInstId,               // EQUIP_INST_ID
+        '',                          // SITE_NAME
+        r.hostname || REASSIGNED[r.ip] || '', // EQUIP_NAME
+        '',                          // EQUIP_TEMPLATE
+        '',                          // EQUIP_STATUS
+        'NTS-AEO-STEAM',            // RESPONSIBLE TEAM
+        r.ip,                        // IPV4_ADDRESS
+        '',                          // MAC ADDRESS
+        r.asn || '',                 // MGMT_IP_ASN
+        r.deviceId || '',            // SERIALNUMBER
+    ]);
+
+    const granitePath = path.join(__dirname, '..', '..', 'docs', 'granite-reassignment-upload.csv');
+    const graniteContent = [
+        graniteHeaders.join(','),
+        ...graniteRows.map(r => r.map(v => `"${String(v).replace(/"/g, '""')}"`).join(','))
+    ].join('\n');
+    fs.writeFileSync(granitePath, graniteContent + '\n', 'utf8');
+    console.log(`Granite upload CSV (${withEquipId.length} rows): ${granitePath}`);
+}
+
+main().catch(err => {
+    console.error('Unhandled error:', err);
+    process.exit(1);
+});

backend/scripts/compliance_config.json

@@ -0,0 +1,44 @@
+{
+  "metric_categories": {
+    "1.1.1": "Logging & Monitoring",
+    "1.1.3": "Logging & Monitoring",
+    "1.4.1": "Logging & Monitoring",
+    "2.3.4i": "Vulnerability Management",
+    "2.3.6i": "Vulnerability Management",
+    "2.3.8i": "Vulnerability Management",
+    "5.2.4": "Access & MFA",
+    "5.2.5": "Access & MFA",
+    "5.2.6": "Access & MFA",
+    "5.2.7": "Access & MFA",
+    "5.2.8": "Access & MFA",
+    "5.3.4": "Endpoint Protection",
+    "5.5.4i": "Vulnerability Management",
+    "5.5.5": "Decommissioned Assets",
+    "5.8.1": "Application Security",
+    "7.1.1": "Logging & Monitoring",
+    "7.1.4": "Logging & Monitoring",
+    "7.6.13": "Disaster Recovery",
+    "7.6.16": "Disaster Recovery",
+    "Missing_AppID": "Asset Data Quality",
+    "Missing_DF": "Asset Data Quality",
+    "Missing_OS": "Asset Data Quality",
+    "5.5.2": "Other"
+  },
+  "core_cols": [
+    "Preferred - Hostname",
+    "GRANITE - IPv4_Address",
+    "GRANITE - Type",
+    "Team",
+    "Compliant",
+    "Source_Network",
+    "Vertical",
+    "GRANITE - Equip_Inst_ID",
+    "GRANITE - RESPONSIBLE_TEAM"
+  ],
+  "skip_sheets": [
+    "Summary",
+    "CMDB_9box",
+    "Vulns",
+    "Aging Dashboard"
+  ]
+}

backend/scripts/dump_xlsx_schema.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+"""
+Dump the structural schema of a compliance xlsx file as JSON.
+Usage: python3 dump_xlsx_schema.py <path_to_xlsx>
+
+Output:
+{
+  "sheets": [
+    {
+      "name": "SheetName",
+      "columns": ["Col A", "Col B", ...],
+      "row_count": 150,
+      "metric_values": ["2.3.4i", "5.2.4", ...]   // only if a Metric column exists
+    },
+    ...
+  ]
+}
+
+Dependencies: openpyxl (already in requirements.txt)
+"""
+import sys
+import json
+from openpyxl import load_workbook
+
+
+def main():
+    if len(sys.argv) < 2:
+        print(json.dumps({'error': 'No file path provided'}))
+        sys.exit(1)
+
+    filepath = sys.argv[1]
+
+    try:
+        wb = load_workbook(filepath, read_only=True, data_only=True)
+    except Exception as e:
+        print(json.dumps({'error': f'Cannot open file: {str(e)}'}))
+        sys.exit(1)
+
+    sheets = []
+    for sheet_name in wb.sheetnames:
+        ws = wb[sheet_name]
+        rows = list(ws.iter_rows(max_row=1, values_only=True))
+        columns = [str(c).strip() for c in rows[0] if c is not None] if rows else []
+
+        # Count data rows (excluding header)
+        row_count = 0
+        for _ in ws.iter_rows(min_row=2, values_only=True):
+            row_count += 1
+
+        # Extract metric values if a Metric column exists in the Summary sheet
+        metric_values = []
+        if sheet_name == 'Summary':
+            # Summary has header at row 4 (0-indexed row 3), read from row 5 onward
+            header_rows = list(ws.iter_rows(min_row=4, max_row=4, values_only=True))
+            if header_rows:
+                summary_cols = [str(c).strip() if c else '' for c in header_rows[0]]
+                metric_idx = None
+                for i, col in enumerate(summary_cols):
+                    if col == 'Metric':
+                        metric_idx = i
+                        break
+                if metric_idx is not None:
+                    for row in ws.iter_rows(min_row=5, values_only=True):
+                        if row[metric_idx] is not None:
+                            val = str(row[metric_idx]).strip()
+                            if val and val != 'Metric':
+                                metric_values.append(val)
+
+        entry = {
+            'name': sheet_name,
+            'columns': columns,
+            'row_count': row_count,
+        }
+        if metric_values:
+            entry['metric_values'] = sorted(set(metric_values))
+
+        sheets.append(entry)
+
+    wb.close()
+    print(json.dumps({'sheets': sheets}, indent=2))
+
+
+if __name__ == '__main__':
+    main()

backend/scripts/extract_xlsx_schema.py

@@ -0,0 +1,91 @@
+#!/usr/bin/env python3
+"""
+Extract the structural schema of a compliance xlsx file as JSON.
+Usage: python3 extract_xlsx_schema.py <path_to_xlsx>
+
+Output:
+{
+  "sheets": [
+    {
+      "name": "Summary",
+      "columns": ["Metric", "Non-Compliant", "..."],
+      "metric_values": ["2.3.4i", "5.2.4", "..."]
+    },
+    {
+      "name": "2.3.4i",
+      "columns": ["Preferred - Hostname", "GRANITE - IPv4_Address", "..."]
+    }
+  ]
+}
+
+- Uses openpyxl in read-only mode.
+- Extracts sheet names, first-row column headers per sheet, and unique metric
+  values from the Summary sheet (header at row 4, data from row 5 onward).
+- On error, returns { "error": "..." } on stdout and exits with non-zero code.
+
+Dependencies: openpyxl (already in requirements.txt)
+"""
+import sys
+import json
+from openpyxl import load_workbook
+
+
+def main():
+    if len(sys.argv) < 2:
+        print(json.dumps({"error": "No file path provided"}))
+        sys.exit(1)
+
+    filepath = sys.argv[1]
+
+    try:
+        wb = load_workbook(filepath, read_only=True, data_only=True)
+    except Exception as e:
+        print(json.dumps({"error": f"Cannot open file: {str(e)}"}))
+        sys.exit(1)
+
+    if not wb.sheetnames:
+        print(json.dumps({"error": "Workbook contains no sheets"}))
+        wb.close()
+        sys.exit(1)
+
+    sheets = []
+    for sheet_name in wb.sheetnames:
+        ws = wb[sheet_name]
+
+        # Extract first-row column headers
+        rows = list(ws.iter_rows(max_row=1, values_only=True))
+        columns = [str(c).strip() for c in rows[0] if c is not None] if rows else []
+
+        entry = {
+            "name": sheet_name,
+            "columns": columns,
+        }
+
+        # Extract metric values from the Summary sheet
+        # Summary has header at row 4, data from row 5 onward
+        if sheet_name == "Summary":
+            metric_values = []
+            header_rows = list(ws.iter_rows(min_row=4, max_row=4, values_only=True))
+            if header_rows:
+                summary_cols = [str(c).strip() if c else "" for c in header_rows[0]]
+                metric_idx = None
+                for i, col in enumerate(summary_cols):
+                    if col == "Metric":
+                        metric_idx = i
+                        break
+                if metric_idx is not None:
+                    for row in ws.iter_rows(min_row=5, values_only=True):
+                        if row[metric_idx] is not None:
+                            val = str(row[metric_idx]).strip()
+                            if val and val != "Metric":
+                                metric_values.append(val)
+            entry["metric_values"] = sorted(set(metric_values))
+
+        sheets.append(entry)
+
+    wb.close()
+    print(json.dumps({"sheets": sheets}))
+
+
+if __name__ == "__main__":
+    main()

backend/scripts/migrate-to-postgres.js

@@ -0,0 +1,928 @@
+#!/usr/bin/env node
+/**
+ * migrate-to-postgres.js — Data Migration Script
+ *
+ * Copies all data from the SQLite database (cve_database.db) to PostgreSQL.
+ * The SQLite file is opened READ-ONLY and is never modified.
+ *
+ * Special handling:
+ *   - ivanti_findings_cache.findings_json → individual rows in ivanti_findings
+ *   - ivanti_finding_notes → merged into ivanti_findings.note column
+ *   - ivanti_finding_overrides → merged into ivanti_findings.override_host_name / override_dns
+ *   - ivanti_sync_state and ivanti_counts_cache → populated from ivanti_findings_cache metadata
+ *
+ * Type conversions:
+ *   - SQLite 0/1 integers → Postgres boolean
+ *   - SQLite DATETIME strings → Postgres TIMESTAMPTZ (passed as-is)
+ *   - SQLite NULL → Postgres NULL
+ *
+ * Uses ON CONFLICT DO NOTHING for idempotency (safe to re-run).
+ *
+ * Usage:
+ *   node backend/scripts/migrate-to-postgres.js
+ *
+ * Requires:
+ *   - DATABASE_URL env var (or .env file in backend/)
+ *   - SQLite database at backend/cve_database.db
+ */
+
+const path = require('path');
+require('dotenv').config({ path: path.join(__dirname, '..', '.env') });
+
+const fs = require('fs');
+const sqlite3 = require('sqlite3').verbose();
+const { Pool } = require('pg');
+
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+const SQLITE_PATH = path.join(__dirname, '..', 'cve_database.db');
+const SCHEMA_PATH = path.join(__dirname, '..', 'db-schema.sql');
+const DATABASE_URL = process.env.DATABASE_URL;
+
+if (!DATABASE_URL) {
+    console.error('ERROR: DATABASE_URL environment variable is not set.');
+    console.error('Expected format: postgresql://user:password@host:port/database');
+    process.exit(1);
+}
+
+if (!fs.existsSync(SQLITE_PATH)) {
+    console.error(`ERROR: SQLite database not found at ${SQLITE_PATH}`);
+    process.exit(1);
+}
+
+// ---------------------------------------------------------------------------
+// SQLite helpers
+// ---------------------------------------------------------------------------
+function sqliteAll(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.all(sql, params, (err, rows) => {
+            if (err) reject(err);
+            else resolve(rows || []);
+        });
+    });
+}
+
+function sqliteGet(db, sql, params = []) {
+    return new Promise((resolve, reject) => {
+        db.get(sql, params, (err, row) => {
+            if (err) reject(err);
+            else resolve(row);
+        });
+    });
+}
+
+// ---------------------------------------------------------------------------
+// Extract finding fields from raw JSON object (mirrors ivantiFindings.js)
+// ---------------------------------------------------------------------------
+function extractFinding(f) {
+    const rawDueDate = f.statusEmbedded?.dueDate || f.dueDate || '';
+    const dueDate = rawDueDate ? rawDueDate.split('T')[0] : null;
+
+    const buOwnership = f.assetCustomAttributes?.['1550_host_1']?.[0]
+        || f.buOwnership || f.bu_ownership || '';
+
+    const cves = Array.isArray(f.cves)
+        ? f.cves
+        : (f.vulnerabilities?.vulnInfoList || []).map(v => v.cve).filter(Boolean);
+
+    // Workflow extraction
+    let workflow = null;
+    if (f.workflow && typeof f.workflow === 'object') {
+        workflow = {
+            id: f.workflow.id || '',
+            state: f.workflow.state || '',
+            type: f.workflow.type || 'FP',
+        };
+    } else if (f.workflowDistribution) {
+        const wfDist = f.workflowDistribution || {};
+        const fpBuckets = [
+            ...(wfDist.actionableWorkflows || []),
+            ...(wfDist.requestedWorkflows || []),
+            ...(wfDist.reworkedWorkflows || []),
+            ...(wfDist.rejectedWorkflows || []),
+            ...(wfDist.expiredWorkflows || []),
+            ...(wfDist.approvedWorkflows || []),
+        ].filter(w => (w.generatedId || '').startsWith('FP#'));
+        const fpEntry = fpBuckets[0] || null;
+        if (fpEntry) {
+            workflow = {
+                id: fpEntry.generatedId || '',
+                state: fpEntry.state || '',
+                type: 'FP',
+            };
+        }
+    }
+
+    return {
+        id: String(f.id),
+        hostId: f.hostId || f.host?.hostId || null,
+        title: f.title || '',
+        severity: typeof f.severity === 'number' ? f.severity : parseFloat(f.severity) || 0,
+        vrrGroup: f.vrrGroup || f.severityGroup || f.vrr_group || '',
+        hostName: f.hostName || f.host?.hostName || f.host_name || '',
+        ipAddress: f.ipAddress || f.host?.ipAddress || f.ip_address || '',
+        dns: f.dns || f.host?.fqdn || '',
+        status: f.status || '',
+        slaStatus: f.slaStatus || f.sla_status || '',
+        dueDate: dueDate,
+        lastFoundOn: f.lastFoundOn || f.last_found_on || null,
+        buOwnership,
+        cves,
+        workflow,
+    };
+}
+
+// ---------------------------------------------------------------------------
+// Batch insert helper for Postgres
+// ---------------------------------------------------------------------------
+async function batchInsert(pool, tableName, columns, rows, conflictClause = 'DO NOTHING') {
+    if (rows.length === 0) return 0;
+
+    const BATCH_SIZE = 100;
+    let inserted = 0;
+
+    for (let i = 0; i < rows.length; i += BATCH_SIZE) {
+        const batch = rows.slice(i, i + BATCH_SIZE);
+        const values = [];
+        const placeholders = [];
+
+        batch.forEach((row, idx) => {
+            const offset = idx * columns.length;
+            const rowPlaceholders = columns.map((_, colIdx) => `$${offset + colIdx + 1}`);
+            placeholders.push(`(${rowPlaceholders.join(', ')})`);
+            values.push(...row);
+        });
+
+        const sql = `INSERT INTO ${tableName} (${columns.join(', ')})
+            VALUES ${placeholders.join(', ')}
+            ON CONFLICT ${conflictClause}`;
+
+        await pool.query(sql, values);
+        inserted += batch.length;
+    }
+
+    return inserted;
+}
+
+// ---------------------------------------------------------------------------
+// Table migration definitions
+// ---------------------------------------------------------------------------
+
+/**
+ * Each entry defines how to copy a SQLite table to Postgres.
+ * - sqliteTable: source table name
+ * - pgTable: destination table name (defaults to sqliteTable)
+ * - columns: array of { src, dest, transform } objects
+ * - conflict: ON CONFLICT clause (default: DO NOTHING)
+ * - selectSql: optional custom SELECT (defaults to SELECT * FROM sqliteTable)
+ */
+function getTableMigrations() {
+    return [
+        {
+            sqliteTable: 'users',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'username', dest: 'username' },
+                { src: 'email', dest: 'email' },
+                { src: 'password_hash', dest: 'password_hash' },
+                { src: 'role', dest: 'role' },
+                { src: 'is_active', dest: 'is_active', transform: v => v === 1 || v === true },
+                { src: 'created_at', dest: 'created_at' },
+                { src: 'last_login', dest: 'last_login' },
+                { src: 'user_group', dest: 'user_group', transform: v => v || 'Read_Only' },
+                { src: 'bu_teams', dest: 'bu_teams', transform: v => v || '' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'sessions',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'session_id', dest: 'session_id' },
+                { src: 'user_id', dest: 'user_id' },
+                { src: 'expires_at', dest: 'expires_at' },
+                { src: 'created_at', dest: 'created_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'cves',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'cve_id', dest: 'cve_id' },
+                { src: 'vendor', dest: 'vendor' },
+                { src: 'severity', dest: 'severity' },
+                { src: 'description', dest: 'description' },
+                { src: 'published_date', dest: 'published_date' },
+                { src: 'status', dest: 'status' },
+                { src: 'created_at', dest: 'created_at' },
+                { src: 'updated_at', dest: 'updated_at' },
+                { src: 'created_by', dest: 'created_by' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'documents',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'cve_id', dest: 'cve_id' },
+                { src: 'vendor', dest: 'vendor' },
+                { src: 'name', dest: 'name' },
+                { src: 'type', dest: 'type' },
+                { src: 'file_path', dest: 'file_path' },
+                { src: 'file_size', dest: 'file_size' },
+                { src: 'mime_type', dest: 'mime_type' },
+                { src: 'uploaded_at', dest: 'uploaded_at' },
+                { src: 'notes', dest: 'notes' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'required_documents',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'vendor', dest: 'vendor' },
+                { src: 'document_type', dest: 'document_type' },
+                { src: 'is_mandatory', dest: 'is_mandatory', transform: v => v === 1 || v === true },
+                { src: 'description', dest: 'description' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'jira_tickets',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'cve_id', dest: 'cve_id' },
+                { src: 'vendor', dest: 'vendor' },
+                { src: 'ticket_key', dest: 'ticket_key' },
+                { src: 'url', dest: 'url' },
+                { src: 'summary', dest: 'summary' },
+                { src: 'status', dest: 'status' },
+                { src: 'created_at', dest: 'created_at' },
+                { src: 'updated_at', dest: 'updated_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'archer_tickets',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'exc_number', dest: 'exc_number' },
+                { src: 'archer_url', dest: 'archer_url' },
+                { src: 'status', dest: 'status' },
+                { src: 'cve_id', dest: 'cve_id' },
+                { src: 'vendor', dest: 'vendor' },
+                { src: 'created_at', dest: 'created_at' },
+                { src: 'updated_at', dest: 'updated_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'knowledge_base',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'title', dest: 'title' },
+                { src: 'slug', dest: 'slug' },
+                { src: 'description', dest: 'description' },
+                { src: 'category', dest: 'category' },
+                { src: 'file_path', dest: 'file_path' },
+                { src: 'file_name', dest: 'file_name' },
+                { src: 'file_type', dest: 'file_type' },
+                { src: 'file_size', dest: 'file_size' },
+                { src: 'created_at', dest: 'created_at' },
+                { src: 'updated_at', dest: 'updated_at' },
+                { src: 'created_by', dest: 'created_by' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'audit_logs',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'user_id', dest: 'user_id' },
+                { src: 'username', dest: 'username' },
+                { src: 'action', dest: 'action' },
+                { src: 'entity_type', dest: 'entity_type' },
+                { src: 'entity_id', dest: 'entity_id' },
+                { src: 'details', dest: 'details' },
+                { src: 'ip_address', dest: 'ip_address' },
+                { src: 'created_at', dest: 'created_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'compliance_uploads',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'filename', dest: 'filename' },
+                { src: 'report_date', dest: 'report_date' },
+                { src: 'uploaded_by', dest: 'uploaded_by' },
+                { src: 'uploaded_at', dest: 'uploaded_at' },
+                { src: 'new_count', dest: 'new_count' },
+                { src: 'resolved_count', dest: 'resolved_count' },
+                { src: 'recurring_count', dest: 'recurring_count' },
+                { src: 'summary_json', dest: 'summary_json' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'compliance_items',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'upload_id', dest: 'upload_id' },
+                { src: 'hostname', dest: 'hostname' },
+                { src: 'ip_address', dest: 'ip_address' },
+                { src: 'device_type', dest: 'device_type' },
+                { src: 'team', dest: 'team' },
+                { src: 'metric_id', dest: 'metric_id' },
+                { src: 'metric_desc', dest: 'metric_desc' },
+                { src: 'category', dest: 'category' },
+                { src: 'extra_json', dest: 'extra_json' },
+                { src: 'status', dest: 'status' },
+                { src: 'first_seen_upload_id', dest: 'first_seen_upload_id' },
+                { src: 'resolved_upload_id', dest: 'resolved_upload_id' },
+                { src: 'seen_count', dest: 'seen_count' },
+                { src: 'created_at', dest: 'created_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'compliance_notes',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'hostname', dest: 'hostname' },
+                { src: 'metric_id', dest: 'metric_id' },
+                { src: 'note', dest: 'note' },
+                { src: 'group_id', dest: 'group_id' },
+                { src: 'created_by', dest: 'created_by' },
+                { src: 'created_at', dest: 'created_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'ivanti_counts_history',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'open_count', dest: 'open_count' },
+                { src: 'closed_count', dest: 'closed_count' },
+                { src: 'recorded_at', dest: 'recorded_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'ivanti_finding_archives',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'finding_id', dest: 'finding_id' },
+                { src: 'finding_title', dest: 'finding_title' },
+                { src: 'host_name', dest: 'host_name' },
+                { src: 'ip_address', dest: 'ip_address' },
+                { src: 'current_state', dest: 'current_state' },
+                { src: 'last_severity', dest: 'last_severity' },
+                { src: 'first_archived_at', dest: 'first_archived_at' },
+                { src: 'last_transition_at', dest: 'last_transition_at' },
+                { src: 'created_at', dest: 'created_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'ivanti_archive_transitions',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'archive_id', dest: 'archive_id' },
+                { src: 'from_state', dest: 'from_state' },
+                { src: 'to_state', dest: 'to_state' },
+                { src: 'severity_at_transition', dest: 'severity_at_transition' },
+                { src: 'reason', dest: 'reason' },
+                { src: 'transitioned_at', dest: 'transitioned_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'ivanti_sync_anomaly_log',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'sync_timestamp', dest: 'sync_timestamp' },
+                { src: 'open_count_delta', dest: 'open_count_delta' },
+                { src: 'closed_count_delta', dest: 'closed_count_delta' },
+                { src: 'newly_archived_count', dest: 'newly_archived_count' },
+                { src: 'returned_count', dest: 'returned_count' },
+                { src: 'classification_json', dest: 'classification_json' },
+                { src: 'return_classification_json', dest: 'return_classification_json' },
+                { src: 'is_significant', dest: 'is_significant', transform: v => v === 1 || v === true },
+                { src: 'created_at', dest: 'created_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'ivanti_finding_bu_history',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'finding_id', dest: 'finding_id' },
+                { src: 'finding_title', dest: 'finding_title' },
+                { src: 'host_name', dest: 'host_name' },
+                { src: 'previous_bu', dest: 'previous_bu' },
+                { src: 'new_bu', dest: 'new_bu' },
+                { src: 'detected_at', dest: 'detected_at' },
+                { src: 'created_at', dest: 'created_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'atlas_action_plans_cache',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'host_id', dest: 'host_id' },
+                { src: 'has_action_plan', dest: 'has_action_plan', transform: v => v === 1 || v === true },
+                { src: 'plan_count', dest: 'plan_count' },
+                { src: 'plans_json', dest: 'plans_json' },
+                { src: 'synced_at', dest: 'synced_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'ivanti_fp_submissions',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'user_id', dest: 'user_id' },
+                { src: 'username', dest: 'username' },
+                { src: 'ivanti_workflow_batch_id', dest: 'ivanti_workflow_batch_id' },
+                { src: 'ivanti_generated_id', dest: 'ivanti_generated_id' },
+                { src: 'ivanti_workflow_batch_uuid', dest: 'ivanti_workflow_batch_uuid' },
+                { src: 'workflow_name', dest: 'workflow_name' },
+                { src: 'reason', dest: 'reason' },
+                { src: 'description', dest: 'description' },
+                { src: 'expiration_date', dest: 'expiration_date' },
+                { src: 'scope_override', dest: 'scope_override' },
+                { src: 'finding_ids_json', dest: 'finding_ids_json' },
+                { src: 'queue_item_ids_json', dest: 'queue_item_ids_json' },
+                { src: 'attachment_count', dest: 'attachment_count' },
+                { src: 'attachment_results_json', dest: 'attachment_results_json' },
+                { src: 'status', dest: 'status' },
+                { src: 'lifecycle_status', dest: 'lifecycle_status' },
+                { src: 'error_message', dest: 'error_message' },
+                { src: 'created_at', dest: 'created_at' },
+                { src: 'updated_at', dest: 'updated_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'ivanti_fp_submission_history',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'submission_id', dest: 'submission_id' },
+                { src: 'user_id', dest: 'user_id' },
+                { src: 'username', dest: 'username' },
+                { src: 'change_type', dest: 'change_type' },
+                { src: 'change_details_json', dest: 'change_details_json' },
+                { src: 'created_at', dest: 'created_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+        {
+            sqliteTable: 'ivanti_todo_queue',
+            columns: [
+                { src: 'id', dest: 'id' },
+                { src: 'user_id', dest: 'user_id' },
+                { src: 'finding_id', dest: 'finding_id' },
+                { src: 'finding_title', dest: 'finding_title' },
+                { src: 'cves_json', dest: 'cves_json' },
+                { src: 'ip_address', dest: 'ip_address' },
+                { src: 'hostname', dest: 'hostname' },
+                { src: 'vendor', dest: 'vendor' },
+                { src: 'workflow_type', dest: 'workflow_type' },
+                { src: 'status', dest: 'status' },
+                { src: 'created_at', dest: 'created_at' },
+                { src: 'updated_at', dest: 'updated_at' },
+            ],
+            conflict: '(id) DO NOTHING',
+        },
+    ];
+}
+
+// ---------------------------------------------------------------------------
+// Main migration logic
+// ---------------------------------------------------------------------------
+async function migrate() {
+    console.log('╔════════════════════════════════════════════════════════╗');
+    console.log('║   CVE Dashboard — SQLite → PostgreSQL Migration       ║');
+    console.log('╚════════════════════════════════════════════════════════╝\n');
+
+    // Open SQLite in READ-ONLY mode
+    const sqliteDb = new sqlite3.Database(SQLITE_PATH, sqlite3.OPEN_READONLY, (err) => {
+        if (err) {
+            console.error('ERROR: Failed to open SQLite database:', err.message);
+            process.exit(1);
+        }
+    });
+    console.log(`✓ Opened SQLite database (read-only): ${SQLITE_PATH}`);
+
+    // Connect to Postgres
+    const pool = new Pool({
+        connectionString: DATABASE_URL,
+        max: 5,
+        idleTimeoutMillis: 30000,
+        connectionTimeoutMillis: 10000,
+    });
+
+    try {
+        await pool.query('SELECT NOW()');
+        console.log('✓ Connected to PostgreSQL');
+    } catch (err) {
+        console.error('ERROR: Failed to connect to PostgreSQL:', err.message);
+        sqliteDb.close();
+        process.exit(1);
+    }
+
+    // Step 1: Run schema DDL
+    console.log('\n── Step 1: Creating schema (idempotent) ──');
+    try {
+        const schemaSql = fs.readFileSync(SCHEMA_PATH, 'utf8');
+        await pool.query(schemaSql);
+        console.log('✓ Schema created/verified');
+    } catch (err) {
+        console.error('ERROR: Schema creation failed:', err.message);
+        await cleanup(sqliteDb, pool);
+        process.exit(1);
+    }
+
+    // Step 2: Copy simple tables
+    console.log('\n── Step 2: Copying tables ──');
+    const migrations = getTableMigrations();
+    const migrationResults = {};
+
+    for (const migration of migrations) {
+        const tableName = migration.pgTable || migration.sqliteTable;
+        try {
+            // Check if table exists in SQLite
+            const tableCheck = await sqliteGet(
+                sqliteDb,
+                `SELECT name FROM sqlite_master WHERE type='table' AND name=?`,
+                [migration.sqliteTable]
+            );
+
+            if (!tableCheck) {
+                console.log(`  ⚠ ${migration.sqliteTable} — table not found in SQLite, skipping`);
+                migrationResults[tableName] = { source: 0, dest: 0, skipped: true };
+                continue;
+            }
+
+            // Read all rows from SQLite
+            const selectSql = migration.selectSql || `SELECT * FROM ${migration.sqliteTable}`;
+            const sourceRows = await sqliteAll(sqliteDb, selectSql);
+
+            if (sourceRows.length === 0) {
+                console.log(`  ○ ${tableName} — 0 rows (empty table)`);
+                migrationResults[tableName] = { source: 0, dest: 0 };
+                continue;
+            }
+
+            // Transform rows
+            const destColumns = migration.columns.map(c => c.dest);
+            const transformedRows = sourceRows.map(row => {
+                return migration.columns.map(col => {
+                    let value = row[col.src];
+                    if (value === undefined) value = null;
+                    if (col.transform) {
+                        value = col.transform(value);
+                    }
+                    return value;
+                });
+            });
+
+            // Insert into Postgres
+            const inserted = await batchInsert(
+                pool,
+                tableName,
+                destColumns,
+                transformedRows,
+                migration.conflict
+            );
+
+            console.log(`  ✓ ${tableName} — ${inserted} rows copied`);
+            migrationResults[tableName] = { source: sourceRows.length, dest: inserted };
+        } catch (err) {
+            console.error(`  ✗ ${tableName} — ERROR: ${err.message}`);
+            migrationResults[tableName] = { source: 0, dest: 0, error: err.message };
+        }
+    }
+
+    // Reset sequences for SERIAL columns after bulk insert with explicit IDs
+    console.log('\n── Step 2b: Resetting sequences ──');
+    const serialTables = [
+        'users', 'sessions', 'cves', 'documents', 'required_documents',
+        'jira_tickets', 'archer_tickets', 'knowledge_base', 'audit_logs',
+        'compliance_uploads', 'compliance_items', 'compliance_notes',
+        'ivanti_counts_history', 'ivanti_finding_archives',
+        'ivanti_archive_transitions', 'ivanti_sync_anomaly_log',
+        'ivanti_finding_bu_history', 'atlas_action_plans_cache',
+        'ivanti_fp_submissions', 'ivanti_fp_submission_history',
+        'ivanti_todo_queue',
+    ];
+
+    for (const table of serialTables) {
+        try {
+            await pool.query(`
+                SELECT setval(pg_get_serial_sequence('${table}', 'id'),
+                    COALESCE((SELECT MAX(id) FROM ${table}), 0) + 1, false)
+            `);
+        } catch (err) {
+            // Non-fatal — sequence may not exist for some tables
+            console.log(`  ⚠ Could not reset sequence for ${table}: ${err.message}`);
+        }
+    }
+    console.log('✓ Sequences reset');
+
+    // Step 3: Migrate findings from JSON blob
+    console.log('\n── Step 3: Migrating findings from JSON blob ──');
+    try {
+        const cacheRow = await sqliteGet(sqliteDb, 'SELECT * FROM ivanti_findings_cache WHERE id = 1');
+
+        if (!cacheRow || !cacheRow.findings_json) {
+            console.log('  ⚠ No findings_json data found in ivanti_findings_cache');
+        } else {
+            let findings;
+            try {
+                findings = JSON.parse(cacheRow.findings_json);
+            } catch (parseErr) {
+                console.error('  ✗ Failed to parse findings_json:', parseErr.message);
+                findings = [];
+            }
+
+            if (Array.isArray(findings) && findings.length > 0) {
+                console.log(`  Parsing ${findings.length} findings from JSON blob...`);
+
+                // Extract and insert findings
+                const BATCH_SIZE = 100;
+                let insertedCount = 0;
+
+                for (let i = 0; i < findings.length; i += BATCH_SIZE) {
+                    const batch = findings.slice(i, i + BATCH_SIZE);
+                    const values = [];
+                    const placeholders = [];
+
+                    batch.forEach((rawFinding, idx) => {
+                        const f = extractFinding(rawFinding);
+                        const offset = idx * 18;
+                        values.push(
+                            f.id,
+                            f.hostId,
+                            f.title,
+                            f.severity,
+                            f.vrrGroup,
+                            f.hostName,
+                            f.ipAddress,
+                            f.dns,
+                            f.status,
+                            f.slaStatus,
+                            f.dueDate,
+                            f.lastFoundOn,
+                            f.buOwnership,
+                            f.cves,
+                            f.workflow ? f.workflow.id : null,
+                            f.workflow ? f.workflow.state : null,
+                            f.workflow ? f.workflow.type : null,
+                            'open'  // state = open for all findings from cache
+                        );
+                        placeholders.push(
+                            `($${offset+1}, $${offset+2}, $${offset+3}, $${offset+4}, $${offset+5}, ` +
+                            `$${offset+6}, $${offset+7}, $${offset+8}, $${offset+9}, $${offset+10}, ` +
+                            `$${offset+11}, $${offset+12}, $${offset+13}, $${offset+14}, $${offset+15}, ` +
+                            `$${offset+16}, $${offset+17}, $${offset+18})`
+                        );
+                    });
+
+                    await pool.query(`
+                        INSERT INTO ivanti_findings (
+                            id, host_id, title, severity, vrr_group,
+                            host_name, ip_address, dns, status, sla_status,
+                            due_date, last_found_on, bu_ownership, cves,
+                            workflow_id, workflow_state, workflow_type, state
+                        )
+                        VALUES ${placeholders.join(', ')}
+                        ON CONFLICT (id) DO NOTHING
+                    `, values);
+
+                    insertedCount += batch.length;
+                }
+
+                console.log(`  ✓ ivanti_findings — ${insertedCount} findings inserted (state='open')`);
+                migrationResults['ivanti_findings'] = { source: findings.length, dest: insertedCount };
+            } else {
+                console.log('  ○ findings_json is empty or not an array');
+                migrationResults['ivanti_findings'] = { source: 0, dest: 0 };
+            }
+        }
+    } catch (err) {
+        console.error(`  ✗ Findings migration ERROR: ${err.message}`);
+        migrationResults['ivanti_findings'] = { source: 0, dest: 0, error: err.message };
+    }
+
+    // Step 4: Merge notes into ivanti_findings.note
+    console.log('\n── Step 4: Merging finding notes ──');
+    try {
+        const notes = await sqliteAll(sqliteDb, 'SELECT finding_id, note FROM ivanti_finding_notes');
+
+        if (notes.length === 0) {
+            console.log('  ○ No finding notes to merge');
+        } else {
+            let mergedCount = 0;
+            for (const { finding_id, note } of notes) {
+                if (!finding_id || !note) continue;
+                const result = await pool.query(
+                    `UPDATE ivanti_findings SET note = $1 WHERE id = $2`,
+                    [note, finding_id]
+                );
+                if (result.rowCount > 0) mergedCount++;
+            }
+            console.log(`  ✓ Merged ${mergedCount}/${notes.length} notes into ivanti_findings.note`);
+        }
+    } catch (err) {
+        console.error(`  ✗ Notes merge ERROR: ${err.message}`);
+    }
+
+    // Step 5: Merge overrides into ivanti_findings.override_host_name / override_dns
+    console.log('\n── Step 5: Merging finding overrides ──');
+    try {
+        const overrides = await sqliteAll(
+            sqliteDb,
+            'SELECT finding_id, field, value FROM ivanti_finding_overrides'
+        );
+
+        if (overrides.length === 0) {
+            console.log('  ○ No finding overrides to merge');
+        } else {
+            let mergedCount = 0;
+            for (const { finding_id, field, value } of overrides) {
+                if (!finding_id || !field) continue;
+
+                let pgColumn;
+                if (field === 'host_name' || field === 'hostName' || field === 'override_host_name') {
+                    pgColumn = 'override_host_name';
+                } else if (field === 'dns' || field === 'override_dns') {
+                    pgColumn = 'override_dns';
+                } else {
+                    // Unknown field — skip
+                    continue;
+                }
+
+                const result = await pool.query(
+                    `UPDATE ivanti_findings SET ${pgColumn} = $1 WHERE id = $2`,
+                    [value, finding_id]
+                );
+                if (result.rowCount > 0) mergedCount++;
+            }
+            console.log(`  ✓ Merged ${mergedCount}/${overrides.length} overrides into ivanti_findings`);
+        }
+    } catch (err) {
+        console.error(`  ✗ Overrides merge ERROR: ${err.message}`);
+    }
+
+    // Step 6: Populate ivanti_sync_state from ivanti_findings_cache metadata
+    console.log('\n── Step 6: Populating sync state and counts cache ──');
+    try {
+        const cacheRow = await sqliteGet(sqliteDb, 'SELECT * FROM ivanti_findings_cache WHERE id = 1');
+
+        if (cacheRow) {
+            await pool.query(`
+                UPDATE ivanti_sync_state SET
+                    total = $1,
+                    synced_at = $2,
+                    sync_status = $3,
+                    error_message = $4
+                WHERE id = 1
+            `, [
+                cacheRow.total || 0,
+                cacheRow.synced_at || null,
+                cacheRow.sync_status || 'never',
+                cacheRow.error_message || null,
+            ]);
+            console.log('  ✓ ivanti_sync_state updated from ivanti_findings_cache metadata');
+        }
+
+        // Populate ivanti_counts_cache
+        const countsRow = await sqliteGet(sqliteDb, 'SELECT * FROM ivanti_counts_cache WHERE id = 1');
+        if (countsRow) {
+            await pool.query(`
+                UPDATE ivanti_counts_cache SET
+                    open_count = $1,
+                    closed_count = $2,
+                    synced_at = $3,
+                    fp_workflow_counts_json = $4,
+                    fp_id_counts_json = $5
+                WHERE id = 1
+            `, [
+                countsRow.open_count || 0,
+                countsRow.closed_count || 0,
+                countsRow.synced_at || null,
+                countsRow.fp_workflow_counts_json || '{}',
+                countsRow.fp_id_counts_json || '{}',
+            ]);
+            console.log('  ✓ ivanti_counts_cache updated');
+        }
+    } catch (err) {
+        console.error(`  ✗ Sync state/counts migration ERROR: ${err.message}`);
+    }
+
+    // Step 7: Verification — compare row counts
+    console.log('\n── Step 7: Verification ──');
+    console.log('');
+    console.log('┌─────────────────────────────────┬──────────┬──────────┬────────┐');
+    console.log('│ Table                           │  SQLite  │ Postgres │ Status │');
+    console.log('├─────────────────────────────────┼──────────┼──────────┼────────┤');
+
+    let hasDiscrepancy = false;
+    const verificationTables = [
+        ...migrations.map(m => ({ sqlite: m.sqliteTable, pg: m.pgTable || m.sqliteTable })),
+        { sqlite: null, pg: 'ivanti_findings', special: true },
+    ];
+
+    for (const { sqlite: sqliteTable, pg: pgTable, special } of verificationTables) {
+        let sqliteCount = 0;
+        let pgCount = 0;
+
+        try {
+            if (special && pgTable === 'ivanti_findings') {
+                // For findings, source count is from the JSON blob
+                const cacheRow = await sqliteGet(sqliteDb, 'SELECT findings_json FROM ivanti_findings_cache WHERE id = 1');
+                if (cacheRow && cacheRow.findings_json) {
+                    try {
+                        const parsed = JSON.parse(cacheRow.findings_json);
+                        sqliteCount = Array.isArray(parsed) ? parsed.length : 0;
+                    } catch (e) {
+                        sqliteCount = 0;
+                    }
+                }
+            } else if (sqliteTable) {
+                const tableExists = await sqliteGet(
+                    sqliteDb,
+                    `SELECT name FROM sqlite_master WHERE type='table' AND name=?`,
+                    [sqliteTable]
+                );
+                if (tableExists) {
+                    const countRow = await sqliteGet(sqliteDb, `SELECT COUNT(*) as cnt FROM ${sqliteTable}`);
+                    sqliteCount = countRow ? countRow.cnt : 0;
+                }
+            }
+
+            const pgCountRow = await pool.query(`SELECT COUNT(*) as cnt FROM ${pgTable}`);
+            pgCount = parseInt(pgCountRow.rows[0].cnt, 10);
+        } catch (err) {
+            // Table might not exist in one or both
+        }
+
+        const status = pgCount >= sqliteCount ? '  OK  ' : ' WARN ';
+        if (pgCount < sqliteCount) hasDiscrepancy = true;
+
+        const tableDisplay = (pgTable || '').padEnd(31);
+        const srcDisplay = String(sqliteCount).padStart(6);
+        const destDisplay = String(pgCount).padStart(6);
+
+        console.log(`│ ${tableDisplay} │ ${srcDisplay}   │ ${destDisplay}   │ ${status} │`);
+    }
+
+    console.log('└─────────────────────────────────┴──────────┴──────────┴────────┘');
+
+    if (hasDiscrepancy) {
+        console.log('\n⚠ WARNING: Some tables have fewer rows in Postgres than SQLite.');
+        console.log('  This may be due to ON CONFLICT DO NOTHING skipping existing rows,');
+        console.log('  or foreign key constraints preventing insertion.');
+    }
+
+    // Cleanup
+    await cleanup(sqliteDb, pool);
+
+    console.log('\n════════════════════════════════════════════════════════');
+    if (hasDiscrepancy) {
+        console.log('Migration completed with warnings. Review discrepancies above.');
+    } else {
+        console.log('✓ Migration completed successfully!');
+    }
+    console.log('════════════════════════════════════════════════════════\n');
+
+    process.exit(hasDiscrepancy ? 0 : 0); // Exit 0 even with warnings (data is safe)
+}
+
+// ---------------------------------------------------------------------------
+// Cleanup helper
+// ---------------------------------------------------------------------------
+function cleanup(sqliteDb, pool) {
+    return new Promise((resolve) => {
+        sqliteDb.close((err) => {
+            if (err) console.error('Warning: Error closing SQLite:', err.message);
+            pool.end()
+                .then(() => resolve())
+                .catch(() => resolve());
+        });
+    });
+}
+
+// ---------------------------------------------------------------------------
+// Entry point
+// ---------------------------------------------------------------------------
+migrate().catch((err) => {
+    console.error('\n✗ FATAL ERROR:', err.message);
+    console.error(err.stack);
+    process.exit(1);
+});

backend/scripts/parse_compliance_xlsx.py

@@ -12,39 +12,35 @@ Output:
 }
 """
 import sys
+import os
 import json
 import re
 import pandas as pd
 from pathlib import Path
 
-METRIC_CATEGORIES = {
-    '2.3.4i':  'Vulnerability Management',
-    '2.3.6i':  'Vulnerability Management',
-    '2.3.8i':  'Vulnerability Management',
-    '5.2.4':   'Access & MFA',
-    '5.2.5':   'Access & MFA',
-    '5.2.6':   'Access & MFA',
-    '5.3.4':   'Endpoint Protection',
-    '5.5.2':   'End-of-Life OS',
-    '5.5.4i':  'Vulnerability Management',
-    '5.5.5':   'Decommissioned Assets',
-    '5.8.1':   'Application Security',
-    '7.1.1':   'Logging & Monitoring',
-    '7.6.13':  'Disaster Recovery',
-    '7.6.16':  'Disaster Recovery',
-    'Missing_AppID': 'Asset Data Quality',
-    'Missing_DF':    'Asset Data Quality',
-    'Missing_OS':    'Asset Data Quality',
-}
 
-# Columns that go into the main item fields — everything else becomes extra_json
-CORE_COLS = {
-    'Preferred - Hostname', 'GRANITE - IPv4_Address', 'GRANITE - Type',
-    'Team', 'Compliant', 'Source_Network', 'Vertical',
-    'GRANITE - Equip_Inst_ID', 'GRANITE - RESPONSIBLE_TEAM',
-}
+def load_config():
+    """Load parser configuration from compliance_config.json."""
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    config_path = os.path.join(script_dir, 'compliance_config.json')
 
-SKIP_SHEETS = {'Summary', 'CMDB_9box'}
+    try:
+        with open(config_path, 'r') as f:
+            config = json.load(f)
+    except FileNotFoundError:
+        print(f"Error: Configuration file not found: {config_path}", file=sys.stderr)
+        sys.exit(1)
+    except json.JSONDecodeError as e:
+        print(f"Error: Invalid JSON in configuration file {config_path}: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    return config
+
+
+_config = load_config()
+METRIC_CATEGORIES = _config['metric_categories']
+CORE_COLS = set(_config['core_cols'])
+SKIP_SHEETS = set(_config['skip_sheets'])
 
 
 def safe_str(val):

backend/setup-postgres.js

@@ -0,0 +1,49 @@
+// Setup Script for CVE Dashboard — PostgreSQL
+// Runs the db-schema.sql DDL against the Postgres instance configured in DATABASE_URL.
+// Idempotent — safe to run multiple times.
+//
+// Usage: node backend/setup-postgres.js
+//
+// Requires DATABASE_URL in .env or environment.
+
+require('dotenv').config({ path: require('path').join(__dirname, '.env') });
+
+const fs = require('fs');
+const path = require('path');
+const pool = require('./db');
+
+const SCHEMA_FILE = path.join(__dirname, 'db-schema.sql');
+
+async function main() {
+    console.log('🚀 CVE Dashboard — PostgreSQL Schema Setup\n');
+    console.log('════════════════════════════════════════\n');
+
+    try {
+        // Verify connection
+        const { rows } = await pool.query('SELECT version()');
+        console.log(`✓ Connected to: ${rows[0].version.split(',')[0]}`);
+        console.log(`  Database URL: ${process.env.DATABASE_URL.replace(/:[^:@]+@/, ':***@')}\n`);
+
+        // Read and execute schema
+        const schema = fs.readFileSync(SCHEMA_FILE, 'utf8');
+        await pool.query(schema);
+        console.log('✓ Schema created/verified (all tables and indexes)\n');
+
+        // Verify table count
+        const { rows: tables } = await pool.query(
+            "SELECT COUNT(*) as count FROM information_schema.tables WHERE table_schema = 'public'"
+        );
+        console.log(`✓ ${tables[0].count} tables in database\n`);
+
+        console.log('╔════════════════════════════════════════════════════════╗');
+        console.log('║       POSTGRESQL SCHEMA SETUP COMPLETE                 ║');
+        console.log('╚════════════════════════════════════════════════════════╝\n');
+    } catch (err) {
+        console.error('❌ Setup failed:', err.message);
+        process.exit(1);
+    } finally {
+        await pool.end();
+    }
+}
+
+main();

backend/setup.js

@@ -1,333 +1,642 @@
-// Setup Script for CVE Database
-// This creates a fresh database with multi-vendor support built-in
+// Setup Script for CVE Dashboard v1.0.0
+// Creates a fresh database with the complete schema including all tables,
+// indexes, triggers, and views needed for a new deployment.
+//
+// Usage: node backend/setup.js
+//
+// This consolidates the original schema plus all migration scripts into a
+// single idempotent setup. Migration scripts in backend/migrations/ are
+// retained for reference but are NOT needed on fresh deployments.
 
 const sqlite3 = require('sqlite3').verbose();
 const bcrypt = require('bcryptjs');
+const crypto = require('crypto');
 const fs = require('fs');
 const path = require('path');
 
-const DB_FILE = './cve_database.db';
-const UPLOADS_DIR = './uploads';
+const DB_FILE = path.join(__dirname, 'cve_database.db');
+const UPLOADS_DIR = path.join(__dirname, 'uploads');
 
-// Initialize database with schema
-function initializeDatabase() {
+// ---------------------------------------------------------------------------
+// Database helpers
+// ---------------------------------------------------------------------------
+function dbRun(db, sql, params = []) {
     return new Promise((resolve, reject) => {
-        const db = new sqlite3.Database(DB_FILE, (err) => {
+        db.run(sql, params, function (err) {
             if (err) reject(err);
-        });
-
-        const schema = `
-            CREATE TABLE IF NOT EXISTS cves (
-                id INTEGER PRIMARY KEY AUTOINCREMENT,
-                cve_id VARCHAR(20) NOT NULL,
-                vendor VARCHAR(100) NOT NULL,
-                severity VARCHAR(20) NOT NULL,
-                description TEXT,
-                published_date DATE,
-                status VARCHAR(50) DEFAULT 'Open',
-                created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-                updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-                UNIQUE(cve_id, vendor)
-            );
-
-            CREATE TABLE IF NOT EXISTS documents (
-                id INTEGER PRIMARY KEY AUTOINCREMENT,
-                cve_id VARCHAR(20) NOT NULL,
-                vendor VARCHAR(100) NOT NULL,
-                name VARCHAR(255) NOT NULL,
-                type VARCHAR(50) NOT NULL,
-                file_path VARCHAR(500) NOT NULL,
-                file_size VARCHAR(20),
-                mime_type VARCHAR(100),
-                uploaded_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-                notes TEXT,
-                FOREIGN KEY (cve_id) REFERENCES cves(cve_id) ON DELETE CASCADE
-            );
-
-            CREATE TABLE IF NOT EXISTS required_documents (
-                id INTEGER PRIMARY KEY AUTOINCREMENT,
-                vendor VARCHAR(100) NOT NULL,
-                document_type VARCHAR(50) NOT NULL,
-                is_mandatory BOOLEAN DEFAULT 1,
-                description TEXT
-            );
-
-            CREATE INDEX IF NOT EXISTS idx_cve_id ON cves(cve_id);
-            CREATE INDEX IF NOT EXISTS idx_vendor ON cves(vendor);
-            CREATE INDEX IF NOT EXISTS idx_severity ON cves(severity);
-            CREATE INDEX IF NOT EXISTS idx_status ON cves(status);
-            CREATE INDEX IF NOT EXISTS idx_doc_cve_id ON documents(cve_id);
-            CREATE INDEX IF NOT EXISTS idx_doc_vendor ON documents(vendor);
-            CREATE INDEX IF NOT EXISTS idx_doc_type ON documents(type);
-
-            -- Users table for authentication
-            CREATE TABLE IF NOT EXISTS users (
-                id INTEGER PRIMARY KEY AUTOINCREMENT,
-                username VARCHAR(50) UNIQUE NOT NULL,
-                email VARCHAR(255) UNIQUE NOT NULL,
-                password_hash VARCHAR(255) NOT NULL,
-                role VARCHAR(20) NOT NULL DEFAULT 'viewer',
-                is_active BOOLEAN DEFAULT 1,
-                created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-                last_login TIMESTAMP,
-                CHECK (role IN ('admin', 'editor', 'viewer'))
-            );
-
-            -- Sessions table for session management
-            CREATE TABLE IF NOT EXISTS sessions (
-                id INTEGER PRIMARY KEY AUTOINCREMENT,
-                session_id VARCHAR(255) UNIQUE NOT NULL,
-                user_id INTEGER NOT NULL,
-                expires_at TIMESTAMP NOT NULL,
-                created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-                FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
-            );
-
-            CREATE INDEX IF NOT EXISTS idx_sessions_session_id ON sessions(session_id);
-            CREATE INDEX IF NOT EXISTS idx_sessions_user_id ON sessions(user_id);
-            CREATE INDEX IF NOT EXISTS idx_sessions_expires ON sessions(expires_at);
-            CREATE INDEX IF NOT EXISTS idx_users_username ON users(username);
-
-            -- Audit log table for tracking user actions
-            CREATE TABLE IF NOT EXISTS audit_logs (
-                id INTEGER PRIMARY KEY AUTOINCREMENT,
-                user_id INTEGER,
-                username VARCHAR(50) NOT NULL,
-                action VARCHAR(50) NOT NULL,
-                entity_type VARCHAR(50) NOT NULL,
-                entity_id VARCHAR(100),
-                details TEXT,
-                ip_address VARCHAR(45),
-                created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-            );
-
-            CREATE INDEX IF NOT EXISTS idx_audit_user_id ON audit_logs(user_id);
-            CREATE INDEX IF NOT EXISTS idx_audit_action ON audit_logs(action);
-            CREATE INDEX IF NOT EXISTS idx_audit_entity_type ON audit_logs(entity_type);
-            CREATE INDEX IF NOT EXISTS idx_audit_created_at ON audit_logs(created_at);
-
-            INSERT OR IGNORE INTO required_documents (vendor, document_type, is_mandatory, description) VALUES
-            ('Microsoft', 'advisory', 1, 'Official Microsoft Security Advisory'),
-            ('Microsoft', 'screenshot', 0, 'Proof of patch application'),
-            ('Cisco', 'advisory', 1, 'Cisco Security Advisory'),
-            ('Oracle', 'advisory', 1, 'Oracle Security Alert'),
-            ('VMware', 'advisory', 1, 'VMware Security Advisory'),
-            ('Adobe', 'advisory', 1, 'Adobe Security Bulletin');
-
-            CREATE VIEW IF NOT EXISTS cve_document_status AS
-            SELECT 
-                c.id as record_id,
-                c.cve_id,
-                c.vendor,
-                c.severity,
-                c.status,
-                COUNT(DISTINCT d.id) as total_documents,
-                COUNT(DISTINCT CASE WHEN d.type = 'advisory' THEN d.id END) as advisory_count,
-                COUNT(DISTINCT CASE WHEN d.type = 'email' THEN d.id END) as email_count,
-                COUNT(DISTINCT CASE WHEN d.type = 'screenshot' THEN d.id END) as screenshot_count,
-                CASE 
-                    WHEN COUNT(DISTINCT CASE WHEN d.type = 'advisory' THEN d.id END) > 0 
-                    THEN 'Complete'
-                    ELSE 'Missing Required Docs'
-                END as compliance_status
-            FROM cves c
-            LEFT JOIN documents d ON c.cve_id = d.cve_id AND c.vendor = d.vendor
-            GROUP BY c.id, c.cve_id, c.vendor, c.severity, c.status;
-        `;
-
-        db.exec(schema, (err) => {
-            if (err) {
-                reject(err);
-            } else {
-                console.log('✓ Database initialized successfully');
-                resolve(db);
-            }
+            else resolve(this);
         });
     });
 }
 
-// Create uploads directory structure
-function createUploadsDirectory() {
-    if (!fs.existsSync(UPLOADS_DIR)) {
-        fs.mkdirSync(UPLOADS_DIR, { recursive: true });
-        console.log('✓ Created uploads directory');
-    } else {
-        console.log('✓ Uploads directory already exists');
-    }
-}
-
-// Create default admin user
-async function createDefaultAdmin(db) {
+function dbGet(db, sql, params = []) {
     return new Promise((resolve, reject) => {
-        // Check if admin already exists
-        db.get('SELECT id FROM users WHERE username = ?', ['admin'], async (err, row) => {
-            if (err) {
-                reject(err);
-                return;
-            }
-
-            if (row) {
-                console.log('✓ Default admin user already exists');
-                resolve();
-                return;
-            }
-
-            // Create admin user with password 'admin123'
-            const passwordHash = await bcrypt.hash('admin123', 10);
-
-            db.run(
-                `INSERT INTO users (username, email, password_hash, role, is_active)
-                 VALUES (?, ?, ?, ?, ?)`,
-                ['admin', 'admin@localhost', passwordHash, 'admin', 1],
-                (err) => {
-                    if (err) {
-                        reject(err);
-                    } else {
-                        console.log('✓ Created default admin user (admin/admin123)');
-                        resolve();
-                    }
-                }
-            );
+        db.get(sql, params, (err, row) => {
+            if (err) reject(err);
+            else resolve(row);
         });
     });
 }
 
-// Add sample CVE data (optional - for testing)
-async function addSampleData(db) {
-    console.log('\n📝 Adding sample CVE data for testing...');
-    
-    const sampleCVEs = [
-        {
-            cve_id: 'CVE-2024-SAMPLE-1',
-            vendor: 'Microsoft',
-            severity: 'Critical',
-            description: 'Sample remote code execution vulnerability',
-            published_date: '2024-01-15'
-        },
-        {
-            cve_id: 'CVE-2024-SAMPLE-1',
-            vendor: 'Cisco',
-            severity: 'High',
-            description: 'Sample remote code execution vulnerability',
-            published_date: '2024-01-15'
-        }
+function dbExec(db, sql) {
+    return new Promise((resolve, reject) => {
+        db.exec(sql, (err) => {
+            if (err) reject(err);
+            else resolve();
+        });
+    });
+}
+
+// ---------------------------------------------------------------------------
+// Schema — complete v1.0.0 database structure
+// ---------------------------------------------------------------------------
+async function initializeDatabase(db) {
+    await dbExec(db, `
+
+        -- =================================================================
+        -- Core CVE tracking tables
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS cves (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            cve_id VARCHAR(20) NOT NULL,
+            vendor VARCHAR(100) NOT NULL,
+            severity VARCHAR(20) NOT NULL,
+            description TEXT,
+            published_date DATE,
+            status VARCHAR(50) DEFAULT 'Open',
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            UNIQUE(cve_id, vendor)
+        );
+
+        CREATE TABLE IF NOT EXISTS documents (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            cve_id VARCHAR(20) NOT NULL,
+            vendor VARCHAR(100) NOT NULL,
+            name VARCHAR(255) NOT NULL,
+            type VARCHAR(50) NOT NULL,
+            file_path VARCHAR(500) NOT NULL,
+            file_size VARCHAR(20),
+            mime_type VARCHAR(100),
+            uploaded_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            notes TEXT,
+            FOREIGN KEY (cve_id) REFERENCES cves(cve_id) ON DELETE CASCADE
+        );
+
+        CREATE TABLE IF NOT EXISTS required_documents (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            vendor VARCHAR(100) NOT NULL,
+            document_type VARCHAR(50) NOT NULL,
+            is_mandatory BOOLEAN DEFAULT 1,
+            description TEXT
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_cve_id ON cves(cve_id);
+        CREATE INDEX IF NOT EXISTS idx_vendor ON cves(vendor);
+        CREATE INDEX IF NOT EXISTS idx_severity ON cves(severity);
+        CREATE INDEX IF NOT EXISTS idx_status ON cves(status);
+        CREATE INDEX IF NOT EXISTS idx_doc_cve_id ON documents(cve_id);
+        CREATE INDEX IF NOT EXISTS idx_doc_vendor ON documents(vendor);
+        CREATE INDEX IF NOT EXISTS idx_doc_type ON documents(type);
+
+        -- =================================================================
+        -- Authentication and session management
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS users (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            username VARCHAR(50) UNIQUE NOT NULL,
+            email VARCHAR(255) UNIQUE NOT NULL,
+            password_hash VARCHAR(255) NOT NULL,
+            role VARCHAR(20) NOT NULL DEFAULT 'viewer',
+            is_active BOOLEAN DEFAULT 1,
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            last_login TIMESTAMP,
+            user_group VARCHAR(20) NOT NULL DEFAULT 'Read_Only',
+            bu_teams TEXT NOT NULL DEFAULT '',
+            CHECK (role IN ('admin', 'editor', 'viewer'))
+        );
+
+        CREATE TABLE IF NOT EXISTS sessions (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            session_id VARCHAR(255) UNIQUE NOT NULL,
+            user_id INTEGER NOT NULL,
+            expires_at TIMESTAMP NOT NULL,
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_sessions_session_id ON sessions(session_id);
+        CREATE INDEX IF NOT EXISTS idx_sessions_user_id ON sessions(user_id);
+        CREATE INDEX IF NOT EXISTS idx_sessions_expires ON sessions(expires_at);
+        CREATE INDEX IF NOT EXISTS idx_users_username ON users(username);
+        CREATE INDEX IF NOT EXISTS idx_users_user_group ON users(user_group);
+
+        -- =================================================================
+        -- Audit logging
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS audit_logs (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            user_id INTEGER,
+            username VARCHAR(50) NOT NULL,
+            action VARCHAR(50) NOT NULL,
+            entity_type VARCHAR(50) NOT NULL,
+            entity_id VARCHAR(100),
+            details TEXT,
+            ip_address VARCHAR(45),
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_audit_user_id ON audit_logs(user_id);
+        CREATE INDEX IF NOT EXISTS idx_audit_action ON audit_logs(action);
+        CREATE INDEX IF NOT EXISTS idx_audit_entity_type ON audit_logs(entity_type);
+        CREATE INDEX IF NOT EXISTS idx_audit_created_at ON audit_logs(created_at);
+
+        -- =================================================================
+        -- Jira integration
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS jira_tickets (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            cve_id TEXT NOT NULL,
+            vendor TEXT NOT NULL,
+            ticket_key TEXT NOT NULL,
+            url TEXT,
+            summary TEXT,
+            status TEXT DEFAULT 'Open' CHECK(status IN ('Open', 'In Progress', 'Closed')),
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (cve_id, vendor) REFERENCES cves(cve_id, vendor) ON DELETE CASCADE
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_jira_tickets_cve ON jira_tickets(cve_id, vendor);
+        CREATE INDEX IF NOT EXISTS idx_jira_tickets_status ON jira_tickets(status);
+
+        -- =================================================================
+        -- Archer integration
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS archer_tickets (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            exc_number TEXT NOT NULL UNIQUE,
+            archer_url TEXT,
+            status TEXT DEFAULT 'Draft' CHECK(status IN ('Draft', 'Open', 'Under Review', 'Accepted')),
+            cve_id TEXT NOT NULL,
+            vendor TEXT NOT NULL,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (cve_id, vendor) REFERENCES cves(cve_id, vendor) ON DELETE CASCADE
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_archer_tickets_cve ON archer_tickets(cve_id, vendor);
+        CREATE INDEX IF NOT EXISTS idx_archer_tickets_status ON archer_tickets(status);
+        CREATE INDEX IF NOT EXISTS idx_archer_tickets_exc ON archer_tickets(exc_number);
+
+        -- =================================================================
+        -- Knowledge base
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS knowledge_base (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            title VARCHAR(255) NOT NULL,
+            slug VARCHAR(255) UNIQUE NOT NULL,
+            description TEXT,
+            category VARCHAR(100),
+            file_path VARCHAR(500),
+            file_name VARCHAR(255),
+            file_type VARCHAR(50),
+            file_size INTEGER,
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            created_by INTEGER,
+            FOREIGN KEY (created_by) REFERENCES users(id)
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_knowledge_base_slug ON knowledge_base(slug);
+        CREATE INDEX IF NOT EXISTS idx_knowledge_base_category ON knowledge_base(category);
+        CREATE INDEX IF NOT EXISTS idx_knowledge_base_created_at ON knowledge_base(created_at DESC);
+
+        -- =================================================================
+        -- Ivanti findings sync and cache
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS ivanti_sync_state (
+            id INTEGER PRIMARY KEY CHECK (id = 1),
+            total INTEGER DEFAULT 0,
+            workflows_json TEXT DEFAULT '[]',
+            synced_at DATETIME,
+            sync_status TEXT DEFAULT 'never',
+            error_message TEXT
+        );
+
+        CREATE TABLE IF NOT EXISTS ivanti_findings_cache (
+            id INTEGER PRIMARY KEY CHECK (id = 1),
+            total INTEGER DEFAULT 0,
+            findings_json TEXT DEFAULT '[]',
+            synced_at DATETIME,
+            sync_status TEXT DEFAULT 'never',
+            error_message TEXT
+        );
+
+        CREATE TABLE IF NOT EXISTS ivanti_finding_notes (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            finding_id TEXT NOT NULL UNIQUE,
+            note TEXT NOT NULL DEFAULT '',
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_finding_notes_finding_id ON ivanti_finding_notes(finding_id);
+
+        CREATE TABLE IF NOT EXISTS ivanti_counts_cache (
+            id INTEGER PRIMARY KEY CHECK (id = 1),
+            open_count INTEGER DEFAULT 0,
+            closed_count INTEGER DEFAULT 0,
+            synced_at DATETIME,
+            fp_workflow_counts_json TEXT DEFAULT '{}',
+            fp_id_counts_json TEXT DEFAULT '{}'
+        );
+
+        CREATE TABLE IF NOT EXISTS ivanti_finding_overrides (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            finding_id TEXT NOT NULL,
+            field TEXT NOT NULL,
+            value TEXT NOT NULL DEFAULT '',
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            UNIQUE(finding_id, field)
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_finding_overrides_finding_id ON ivanti_finding_overrides(finding_id);
+
+        CREATE TABLE IF NOT EXISTS ivanti_counts_history (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            open_count INTEGER NOT NULL,
+            closed_count INTEGER NOT NULL,
+            recorded_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        );
+
+        -- =================================================================
+        -- Ivanti FP (False Positive) submissions
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS ivanti_fp_submissions (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            user_id INTEGER NOT NULL,
+            username TEXT NOT NULL,
+            ivanti_workflow_batch_id INTEGER,
+            ivanti_generated_id TEXT,
+            ivanti_workflow_batch_uuid TEXT,
+            workflow_name TEXT NOT NULL,
+            reason TEXT NOT NULL,
+            description TEXT,
+            expiration_date TEXT NOT NULL,
+            scope_override TEXT NOT NULL DEFAULT 'Authorized',
+            finding_ids_json TEXT NOT NULL,
+            queue_item_ids_json TEXT NOT NULL,
+            attachment_count INTEGER DEFAULT 0,
+            attachment_results_json TEXT,
+            status TEXT NOT NULL DEFAULT 'success' CHECK(status IN ('success', 'partial', 'failed')),
+            lifecycle_status TEXT NOT NULL DEFAULT 'submitted' CHECK(lifecycle_status IN ('submitted', 'approved', 'rejected', 'rework', 'resubmitted')),
+            error_message TEXT,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            updated_at DATETIME DEFAULT NULL
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_fp_submissions_user ON ivanti_fp_submissions(user_id);
+        CREATE INDEX IF NOT EXISTS idx_fp_submissions_ivanti_id ON ivanti_fp_submissions(ivanti_generated_id);
+
+        CREATE TABLE IF NOT EXISTS ivanti_fp_submission_history (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            submission_id INTEGER NOT NULL,
+            user_id INTEGER NOT NULL,
+            username TEXT NOT NULL,
+            change_type TEXT NOT NULL CHECK(change_type IN (
+                'created', 'fields_updated', 'findings_added',
+                'attachments_added', 'status_changed'
+            )),
+            change_details_json TEXT,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (submission_id) REFERENCES ivanti_fp_submissions(id) ON DELETE CASCADE
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_fp_history_submission ON ivanti_fp_submission_history(submission_id);
+
+        -- =================================================================
+        -- Ivanti todo queue (FP, Archer, CARD, GRANITE workflows)
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS ivanti_todo_queue (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            user_id INTEGER NOT NULL,
+            finding_id TEXT NOT NULL,
+            finding_title TEXT,
+            cves_json TEXT,
+            ip_address TEXT,
+            hostname TEXT,
+            vendor TEXT NOT NULL,
+            workflow_type TEXT NOT NULL CHECK(workflow_type IN ('FP', 'Archer', 'CARD', 'GRANITE')),
+            status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending', 'complete')),
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_todo_queue_user ON ivanti_todo_queue(user_id, status);
+
+        -- =================================================================
+        -- Ivanti archive detection and anomaly tracking
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS ivanti_finding_archives (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            finding_id TEXT NOT NULL UNIQUE,
+            finding_title TEXT NOT NULL DEFAULT '',
+            host_name TEXT NOT NULL DEFAULT '',
+            ip_address TEXT NOT NULL DEFAULT '',
+            current_state TEXT NOT NULL CHECK(current_state IN ('ARCHIVED','RETURNED','CLOSED','CLOSED_GONE')),
+            last_severity REAL NOT NULL DEFAULT 0,
+            first_archived_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            last_transition_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_archive_finding_id ON ivanti_finding_archives(finding_id);
+        CREATE INDEX IF NOT EXISTS idx_archive_current_state ON ivanti_finding_archives(current_state);
+
+        CREATE TABLE IF NOT EXISTS ivanti_archive_transitions (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            archive_id INTEGER NOT NULL,
+            from_state TEXT NOT NULL,
+            to_state TEXT NOT NULL,
+            severity_at_transition REAL NOT NULL DEFAULT 0,
+            reason TEXT NOT NULL DEFAULT '',
+            transitioned_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (archive_id) REFERENCES ivanti_finding_archives(id)
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_transition_archive_id ON ivanti_archive_transitions(archive_id);
+
+        CREATE TABLE IF NOT EXISTS ivanti_sync_anomaly_log (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            sync_timestamp DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            open_count_delta INTEGER NOT NULL DEFAULT 0,
+            closed_count_delta INTEGER NOT NULL DEFAULT 0,
+            newly_archived_count INTEGER NOT NULL DEFAULT 0,
+            returned_count INTEGER NOT NULL DEFAULT 0,
+            classification_json TEXT NOT NULL DEFAULT '{}',
+            return_classification_json TEXT NOT NULL DEFAULT '{}',
+            is_significant INTEGER NOT NULL DEFAULT 0,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_anomaly_sync_timestamp ON ivanti_sync_anomaly_log(sync_timestamp);
+
+        CREATE TABLE IF NOT EXISTS ivanti_finding_bu_history (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            finding_id TEXT NOT NULL,
+            finding_title TEXT NOT NULL DEFAULT '',
+            host_name TEXT NOT NULL DEFAULT '',
+            previous_bu TEXT NOT NULL,
+            new_bu TEXT NOT NULL,
+            detected_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_bu_history_finding_id ON ivanti_finding_bu_history(finding_id);
+        CREATE INDEX IF NOT EXISTS idx_bu_history_detected_at ON ivanti_finding_bu_history(detected_at);
+
+        -- =================================================================
+        -- Atlas action plans cache
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS atlas_action_plans_cache (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            host_id INTEGER NOT NULL UNIQUE,
+            has_action_plan INTEGER NOT NULL DEFAULT 0,
+            plan_count INTEGER NOT NULL DEFAULT 0,
+            plans_json TEXT NOT NULL DEFAULT '[]',
+            synced_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_atlas_cache_host_id ON atlas_action_plans_cache(host_id);
+
+        -- =================================================================
+        -- Compliance (NTS AEO) tracking
+        -- =================================================================
+
+        CREATE TABLE IF NOT EXISTS compliance_uploads (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            filename TEXT NOT NULL,
+            report_date TEXT,
+            uploaded_by INTEGER,
+            uploaded_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            new_count INTEGER DEFAULT 0,
+            resolved_count INTEGER DEFAULT 0,
+            recurring_count INTEGER DEFAULT 0,
+            summary_json TEXT,
+            FOREIGN KEY (uploaded_by) REFERENCES users(id) ON DELETE SET NULL
+        );
+
+        CREATE TABLE IF NOT EXISTS compliance_items (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            upload_id INTEGER NOT NULL,
+            hostname TEXT NOT NULL,
+            ip_address TEXT,
+            device_type TEXT,
+            team TEXT,
+            metric_id TEXT NOT NULL,
+            metric_desc TEXT,
+            category TEXT,
+            extra_json TEXT,
+            status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active', 'resolved')),
+            first_seen_upload_id INTEGER,
+            resolved_upload_id INTEGER,
+            seen_count INTEGER DEFAULT 1,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (upload_id) REFERENCES compliance_uploads(id) ON DELETE CASCADE,
+            FOREIGN KEY (first_seen_upload_id) REFERENCES compliance_uploads(id) ON DELETE SET NULL,
+            FOREIGN KEY (resolved_upload_id) REFERENCES compliance_uploads(id) ON DELETE SET NULL
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_compliance_items_upload ON compliance_items(upload_id);
+        CREATE INDEX IF NOT EXISTS idx_compliance_items_identity ON compliance_items(hostname, metric_id);
+        CREATE INDEX IF NOT EXISTS idx_compliance_items_team_status ON compliance_items(team, status);
+
+        CREATE TABLE IF NOT EXISTS compliance_notes (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            hostname TEXT NOT NULL,
+            metric_id TEXT NOT NULL,
+            note TEXT NOT NULL,
+            group_id TEXT,
+            created_by INTEGER,
+            created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+            FOREIGN KEY (created_by) REFERENCES users(id) ON DELETE SET NULL
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_compliance_notes_identity ON compliance_notes(hostname, metric_id);
+        CREATE INDEX IF NOT EXISTS idx_compliance_notes_group ON compliance_notes(group_id);
+
+        -- =================================================================
+        -- Document compliance view
+        -- =================================================================
+
+        CREATE VIEW IF NOT EXISTS cve_document_status AS
+        SELECT
+            c.id as record_id,
+            c.cve_id,
+            c.vendor,
+            c.severity,
+            c.status,
+            COUNT(DISTINCT d.id) as total_documents,
+            COUNT(DISTINCT CASE WHEN d.type = 'advisory' THEN d.id END) as advisory_count,
+            COUNT(DISTINCT CASE WHEN d.type = 'email' THEN d.id END) as email_count,
+            COUNT(DISTINCT CASE WHEN d.type = 'screenshot' THEN d.id END) as screenshot_count,
+            CASE
+                WHEN COUNT(DISTINCT CASE WHEN d.type = 'advisory' THEN d.id END) > 0
+                THEN 'Complete'
+                ELSE 'Missing Required Docs'
+            END as compliance_status
+        FROM cves c
+        LEFT JOIN documents d ON c.cve_id = d.cve_id AND c.vendor = d.vendor
+        GROUP BY c.id, c.cve_id, c.vendor, c.severity, c.status;
+
+        -- =================================================================
+        -- Seed data
+        -- =================================================================
+
+        INSERT OR IGNORE INTO required_documents (vendor, document_type, is_mandatory, description) VALUES
+        ('Microsoft', 'advisory', 1, 'Official Microsoft Security Advisory'),
+        ('Microsoft', 'screenshot', 0, 'Proof of patch application'),
+        ('Cisco', 'advisory', 1, 'Cisco Security Advisory'),
+        ('Oracle', 'advisory', 1, 'Oracle Security Alert'),
+        ('VMware', 'advisory', 1, 'VMware Security Advisory'),
+        ('Adobe', 'advisory', 1, 'Adobe Security Bulletin');
+    `);
+
+    console.log('✓ Database schema initialized');
+
+    // User group validation triggers (cannot be in db.exec multi-statement)
+    await dbRun(db, `
+        CREATE TRIGGER IF NOT EXISTS check_user_group_insert
+        BEFORE INSERT ON users
+        FOR EACH ROW
+        WHEN NEW.user_group NOT IN ('Admin', 'Standard_User', 'Leadership', 'Read_Only')
+        BEGIN
+            SELECT RAISE(ABORT, 'Invalid user_group value. Must be Admin, Standard_User, Leadership, or Read_Only');
+        END
+    `);
+
+    await dbRun(db, `
+        CREATE TRIGGER IF NOT EXISTS check_user_group_update
+        BEFORE UPDATE OF user_group ON users
+        FOR EACH ROW
+        WHEN NEW.user_group NOT IN ('Admin', 'Standard_User', 'Leadership', 'Read_Only')
+        BEGIN
+            SELECT RAISE(ABORT, 'Invalid user_group value. Must be Admin, Standard_User, Leadership, or Read_Only');
+        END
+    `);
+
+    console.log('✓ Triggers created');
+}
+
+// ---------------------------------------------------------------------------
+// Directory setup
+// ---------------------------------------------------------------------------
+function createDirectories() {
+    const dirs = [
+        UPLOADS_DIR,
+        path.join(UPLOADS_DIR, 'temp'),
+        path.join(UPLOADS_DIR, 'knowledge_base'),
     ];
-
-    for (const cve of sampleCVEs) {
-        await new Promise((resolve, reject) => {
-            db.run(
-                `INSERT OR IGNORE INTO cves (cve_id, vendor, severity, description, published_date) 
-                 VALUES (?, ?, ?, ?, ?)`,
-                [cve.cve_id, cve.vendor, cve.severity, cve.description, cve.published_date],
-                (err) => {
-                    if (err) reject(err);
-                    else {
-                        console.log(`   ✓ Added sample: ${cve.cve_id} / ${cve.vendor}`);
-                        resolve();
-                    }
-                }
-            );
-        });
+    for (const dir of dirs) {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+            console.log(`✓ Created directory: ${path.relative(__dirname, dir)}`);
+        }
     }
-    
-    console.log('ℹ️  Sample data added - demonstrates multi-vendor support');
 }
 
-// Verify database structure
-async function verifySetup(db) {
-    return new Promise((resolve) => {
-        db.get('SELECT sql FROM sqlite_master WHERE type="table" AND name="cves"', (err, row) => {
-            if (err) {
-                console.error('Warning: Could not verify setup:', err);
-            } else {
-                console.log('\n📋 CVEs table structure:');
-                console.log(row.sql);
-                
-                // Check if UNIQUE constraint is correct
-                if (row.sql.includes('UNIQUE(cve_id, vendor)')) {
-                    console.log('\n✅ Multi-vendor support: ENABLED');
-                } else {
-                    console.log('\n⚠️  Warning: Multi-vendor constraint may not be set correctly');
-                }
-            }
-            resolve();
-        });
-    });
+// ---------------------------------------------------------------------------
+// Default admin user
+// ---------------------------------------------------------------------------
+async function createDefaultAdmin(db) {
+    const existing = await dbGet(db, 'SELECT id FROM users WHERE username = ?', ['admin']);
+    if (existing) {
+        console.log('✓ Default admin user already exists');
+        return;
+    }
+
+    const generatedPassword = crypto.randomBytes(12).toString('base64url');
+    const passwordHash = await bcrypt.hash(generatedPassword, 10);
+
+    await dbRun(db,
+        `INSERT INTO users (username, email, password_hash, role, user_group, is_active)
+         VALUES (?, ?, ?, ?, ?, ?)`,
+        ['admin', 'admin@localhost', passwordHash, 'admin', 'Admin', 1]
+    );
+
+    console.log('✓ Created default admin user');
+    console.log(`\n  ╔══════════════════════════════════════════╗`);
+    console.log(`  ║  Admin credentials (save these now!)     ║`);
+    console.log(`  ║  Username: admin                         ║`);
+    console.log(`  ║  Password: ${generatedPassword.padEnd(29)}║`);
+    console.log(`  ╚══════════════════════════════════════════╝\n`);
 }
 
-// Display setup summary
+// ---------------------------------------------------------------------------
+// Setup summary
+// ---------------------------------------------------------------------------
 function displaySummary() {
     console.log('\n╔════════════════════════════════════════════════════════╗');
-    console.log('║          CVE DATABASE SETUP COMPLETE!                  ║');
+    console.log('║          CVE DASHBOARD v1.0.0 — SETUP COMPLETE        ║');
     console.log('╚════════════════════════════════════════════════════════╝');
-    console.log('\n📊 What was created:');
-    console.log('   ✓ SQLite database (cve_database.db)');
-    console.log('   ✓ Tables: cves, documents, required_documents, users, sessions, audit_logs');
-    console.log('   ✓ Multi-vendor support with UNIQUE(cve_id, vendor)');
-    console.log('   ✓ Vendor column in documents table');
-    console.log('   ✓ User authentication with session-based auth');
-    console.log('   ✓ Indexes for fast queries');
-    console.log('   ✓ Document compliance view');
-    console.log('   ✓ Uploads directory for file storage');
-    console.log('   ✓ Default admin user (admin/admin123)');
-    console.log('\n📁 File structure will be:');
-    console.log('   uploads/');
-    console.log('     └── CVE-XXXX-XXXX/');
-    console.log('         ├── Vendor1/');
-    console.log('         │   ├── advisory.pdf');
-    console.log('         │   └── screenshot.png');
-    console.log('         └── Vendor2/');
-    console.log('             └── advisory.pdf');
+    console.log('\n📊 Tables created:');
+    console.log('   Core:       cves, documents, required_documents');
+    console.log('   Auth:       users, sessions');
+    console.log('   Audit:      audit_logs');
+    console.log('   Jira:       jira_tickets');
+    console.log('   Archer:     archer_tickets');
+    console.log('   KB:         knowledge_base');
+    console.log('   Ivanti:     ivanti_sync_state, ivanti_findings_cache,');
+    console.log('               ivanti_finding_notes, ivanti_counts_cache,');
+    console.log('               ivanti_finding_overrides, ivanti_counts_history,');
+    console.log('               ivanti_fp_submissions, ivanti_fp_submission_history,');
+    console.log('               ivanti_todo_queue');
+    console.log('   Archives:   ivanti_finding_archives, ivanti_archive_transitions,');
+    console.log('               ivanti_sync_anomaly_log, ivanti_finding_bu_history');
+    console.log('   Atlas:      atlas_action_plans_cache');
+    console.log('   Compliance: compliance_uploads, compliance_items, compliance_notes');
     console.log('\n🚀 Next steps:');
-    console.log('   1. Start the backend API:');
-    console.log('      → cd backend && node server.js');
-    console.log('   2. Start the frontend:');
-    console.log('      → cd frontend && npm start');
-    console.log('   3. Open http://localhost:3000');
-    console.log('   4. Start adding CVEs with multiple vendors!');
-    console.log('\n💡 Key Features:');
-    console.log('   • Add same CVE-ID with different vendors');
-    console.log('   • Each vendor has separate document storage');
-    console.log('   • Quick Check shows all vendors for a CVE');
-    console.log('   • Document compliance tracking per vendor');
-    console.log('   • Required docs: Advisory (mandatory for most vendors)\n');
+    console.log('   1. Copy .env.example to .env and configure API keys');
+    console.log('   2. Start the backend:  node backend/server.js');
+    console.log('   3. Build the frontend: cd frontend && npm run build');
+    console.log('   4. Open the dashboard and log in with the admin credentials above\n');
 }
 
-// Main execution
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
 async function main() {
-    console.log('🚀 CVE Database Setup (Multi-Vendor Support)\n');
+    console.log('🚀 CVE Dashboard v1.0.0 — Database Setup\n');
     console.log('════════════════════════════════════════\n');
-    
-    try {
-        // Create uploads directory
-        createUploadsDirectory();
-        
-        // Initialize database
-        const db = await initializeDatabase();
 
-        // Create default admin user
+    try {
+        createDirectories();
+
+        const db = new sqlite3.Database(DB_FILE);
+        await initializeDatabase(db);
         await createDefaultAdmin(db);
 
-        // Add sample data
-        await addSampleData(db);
-        
-        // Verify setup
-        await verifySetup(db);
-        
-        // Close database connection
         db.close((err) => {
             if (err) console.error('Error closing database:', err);
-            else console.log('\n✓ Database connection closed');
-            
-            // Display summary
+            else console.log('✓ Database connection closed');
             displaySummary();
         });
-        
     } catch (error) {
         console.error('❌ Setup Error:', error);
         process.exit(1);
     }
 }
 
-// Run the setup
 main();

deploy/cve-backend-production.service

@@ -0,0 +1,16 @@
+[Unit]
+Description=CVE Dashboard Backend (Express API)
+After=network.target
+
+[Service]
+Type=simple
+WorkingDirectory=/home/cve-dashboard/backend
+ExecStart=/usr/bin/node server.js
+Restart=on-failure
+RestartSec=5
+EnvironmentFile=/home/cve-dashboard/backend/.env
+StandardOutput=append:/home/cve-dashboard/backend/backend.log
+StandardError=append:/home/cve-dashboard/backend/backend.log
+
+[Install]
+WantedBy=multi-user.target

deploy/cve-backend-staging.service

@@ -0,0 +1,17 @@
+[Unit]
+Description=CVE Dashboard Backend - Staging (Express API on port 3100)
+After=network.target
+
+[Service]
+Type=simple
+WorkingDirectory=/home/cve-dashboard-staging/backend
+ExecStart=/usr/bin/node server.js
+Restart=on-failure
+RestartSec=5
+EnvironmentFile=/home/cve-dashboard-staging/backend/.env
+Environment=PORT=3100
+StandardOutput=append:/home/cve-dashboard-staging/backend/backend-staging.log
+StandardError=append:/home/cve-dashboard-staging/backend/backend-staging.log
+
+[Install]
+WantedBy=multi-user.target

deploy/setup-staging.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+# =============================================================================
+# One-time setup for the staging environment
+# Run this once on dashboard-dev to prepare the staging deployment target.
+# =============================================================================
+
+set -e
+
+STAGING_DIR="/home/cve-dashboard-staging"
+SERVICE_FILE="deploy/cve-backend-staging.service"
+
+echo "Setting up staging environment..."
+
+# Create staging directory if it doesn't exist
+if [ ! -d "$STAGING_DIR" ]; then
+    echo "Creating $STAGING_DIR..."
+    mkdir -p "$STAGING_DIR"
+fi
+
+# Copy the staging systemd service
+echo "Installing staging systemd service..."
+sudo cp "$SERVICE_FILE" /etc/systemd/system/cve-backend-staging.service
+sudo systemctl daemon-reload
+sudo systemctl enable cve-backend-staging
+
+# Create staging .env from production template (adjust port)
+if [ ! -f "$STAGING_DIR/backend/.env" ]; then
+    echo "Creating staging .env..."
+    mkdir -p "$STAGING_DIR/backend"
+    if [ -f "/home/cve-dashboard/backend/.env" ]; then
+        cp /home/cve-dashboard/backend/.env "$STAGING_DIR/backend/.env"
+        # Override port for staging
+        sed -i 's/^PORT=.*/PORT=3100/' "$STAGING_DIR/backend/.env"
+        # If PORT line doesn't exist, add it
+        grep -q "^PORT=" "$STAGING_DIR/backend/.env" || echo "PORT=3100" >> "$STAGING_DIR/backend/.env"
+    else
+        echo "PORT=3100" > "$STAGING_DIR/backend/.env"
+        echo "WARNING: No production .env found. You'll need to configure $STAGING_DIR/backend/.env manually."
+    fi
+fi
+
+echo ""
+echo "Staging setup complete."
+echo "  Directory: $STAGING_DIR"
+echo "  Service:   cve-backend-staging"
+echo "  Port:      3100"
+echo ""
+echo "Next steps:"
+echo "  1. Verify $STAGING_DIR/backend/.env has correct DATABASE_URL (use a separate staging DB if possible)"
+echo "  2. Run a pipeline on main/master to trigger the first staging deploy"

docker-compose.yml

@@ -0,0 +1,26 @@
+# Docker Compose for CVE Dashboard PostgreSQL
+# Run: docker compose up -d
+# Stop: docker compose down
+# View logs: docker compose logs -f postgres
+
+services:
+  postgres:
+    image: postgres:16-alpine
+    container_name: steam-postgres
+    restart: unless-stopped
+    environment:
+      POSTGRES_DB: cve_dashboard
+      POSTGRES_USER: steam
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-sV4xmC9xAUCFop0ypxMVS056QgPqGrX}
+    ports:
+      - "5433:5432"
+    volumes:
+      - steam-pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U steam -d cve_dashboard"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  steam-pgdata:

docs/api/ivanti-api-reference.md

@@ -0,0 +1,194 @@
+# Ivanti / RiskSense API Reference
+
+Base URL: `https://platform4.risksense.com/api/v1`
+Swagger: `https://platform4.risksense.com/doc/swagger.json`
+
+Auth: `x-api-key` header. Error codes: 401 bad key, 419 insufficient privileges, 429 rate limited.
+
+## Endpoints Used
+
+### Search Workflow Batches
+
+```
+POST /client/{clientId}/workflowBatch/search
+Content-Type: application/json
+```
+
+Standard JSON body with filters, projection, sort, page, size. Used by `ivantiWorkflows.js` for the daily sync.
+
+### Create False Positive Workflow
+
+```
+POST /client/{clientId}/workflowBatch/falsePositive/request
+Content-Type: multipart/form-data
+```
+
+This endpoint does NOT accept JSON. It requires `multipart/form-data` with the following fields:
+
+| Field | Type | Required | Notes |
+|-------|------|----------|-------|
+| `name` | string | yes | Workflow batch name (max 255) |
+| `reason` | string | yes | Reason for the FP determination |
+| `description` | string | yes | Description (can be empty string but field must be present) |
+| `expirationDate` | string | yes | ISO-8601 date, e.g. `2026-06-01` |
+| `overrideControl` | string | yes | `AUTHORIZED`, `NONE`, or `AUTOMATED`. Use `AUTHORIZED` for standard FP workflows. `NONE` with `isEmptyWorkflow=true` is rejected (400). |
+| `isEmptyWorkflow` | boolean | yes | `true` if no findings attached, `false` otherwise |
+| `subjectFilterRequest` | string | yes | Stringified JSON (see format below) |
+| `files` | file | no | Attachments sent inline in the same request |
+
+#### subjectFilterRequest format
+
+This is the critical field. It must be a stringified JSON object with this exact structure:
+
+```json
+{
+  "subject": "hostFinding",
+  "filterRequest": {
+    "filters": [
+      {
+        "field": "id",
+        "exclusive": false,
+        "operator": "IN",
+        "value": "2283734550,2283734551"
+      }
+    ]
+  }
+}
+```
+
+Key details:
+- `subject` must be `"hostFinding"` — without this, the API returns 500
+- `filters` is nested inside `filterRequest`, NOT at the top level — `{"filters":[]}` at the top level returns 500
+- `value` for multiple IDs is comma-separated as a single string, not an array
+- `operator` values: `EXACT`, `IN`, `LIKE`, `WILDCARD`, `RANGE`, `CIDR`
+- For empty workflows, use `{"subject":"hostFinding","filterRequest":{"filters":[]}}` with `isEmptyWorkflow=true`
+
+#### Response (200/202)
+
+```json
+{
+  "id": 33418832,
+  "created": "2026-04-08T18:16:08"
+}
+```
+
+Returns HTTP 200 or 202 (Accepted — async job creation). Response contains a numeric `id` (the workflow batch job ID) and `created` timestamp. No `generatedId` or `uuid` in this response.
+
+### Map Findings to Existing Workflow (tested 2026-04-13)
+
+```
+POST /client/{clientId}/workflowBatch/falsePositive/{workflowBatchUuid}/map
+Content-Type: application/json
+```
+
+Maps additional host findings to an existing FP workflow batch. Used by the FP submission editing feature to add findings after initial creation.
+
+**Critical: one finding per call.** The map endpoint only reliably maps one finding per request. Sending multiple finding IDs via the `IN` operator or comma-separated values results in only the first finding being mapped. The multipart/form-data format (used by the create endpoint) returns 500 on this endpoint.
+
+#### Request body
+
+```json
+{
+  "subject": "hostFinding",
+  "filterRequest": {
+    "filters": [
+      {
+        "field": "id",
+        "exclusive": false,
+        "operator": "EXACT",
+        "value": "2283734550"
+      }
+    ]
+  }
+}
+```
+
+Key details:
+- Must be `application/json` (NOT multipart/form-data — returns 500)
+- Use `EXACT` operator with a single finding ID per call
+- `IN` operator with comma-separated IDs only maps the first finding
+- Loop through findings and make one API call per finding
+- The `workflowBatchUuid` in the URL is the UUID from the search endpoint (not the numeric batch ID from create)
+
+#### Response (200)
+
+Returns the updated workflow batch object on success.
+
+#### UUID resolution
+
+The `workflowBatchUuid` required in the URL is NOT returned by the create endpoint. To obtain it:
+
+1. Search via `POST /client/{clientId}/workflowBatch/search` with `{ field: 'name', operator: 'EXACT', value: '<workflow_name>' }`
+2. Use `projection: 'internal'` to get full batch objects
+3. The UUID is in the `uuid` field of the returned batch object
+4. Cache the UUID locally after first resolution (stored in `ivanti_fp_submissions.ivanti_workflow_batch_uuid`)
+
+#### Implementation in dashboard
+
+The `resolveWorkflowBatchUuid()` helper in `backend/routes/ivantiFpWorkflow.js` handles UUID resolution:
+- Returns cached UUID if available in the local submission record
+- Otherwise searches Ivanti by workflow name, extracts `batch.uuid`, and caches it for future use
+
+The findings map loop in the `POST /submissions/:id/findings` endpoint:
+- Iterates through each finding ID individually
+- Makes one JSON POST per finding with `EXACT` operator
+- Tracks which findings succeeded vs failed
+- Only marks queue items as complete for successfully mapped findings
+- Returns both `addedFindings` and `failedFindings` arrays in the response
+
+### Other Workflow Endpoints (from Swagger)
+
+These are available but not all are currently used by the dashboard:
+
+| Endpoint | Purpose | Status |
+|----------|---------|--------|
+| `/workflowBatch/acceptance/request` | Risk acceptance workflow | Not used |
+| `/workflowBatch/remediation/request` | Remediation workflow | Not used |
+| `/workflowBatch/severityChange/request` | Severity change workflow | Not used |
+| `/workflowBatch/{workflowType}/approve` | Approve a workflow (needs `workflowBatchUuid`) | Not used |
+| `/workflowBatch/{workflowType}/reject` | Reject a workflow | Not used |
+| `/workflowBatch/{workflowType}/rework` | Send back for rework | Not used |
+| `/workflowBatch/{workflowType}/update` | Update a workflow | Not used |
+| `/workflowBatch/{workflowType}/{workflowBatchUuid}/map` | Map findings to workflow | Used (FP editing) |
+| `/workflowBatch/{workflowType}/{workflowBatchUuid}/unmap` | Unmap findings | Not used |
+| `/workflowBatch/{workflowType}/{workflowBatchUuid}/attach` | Attach file to existing workflow | **Broken — see note** |
+| `/workflowBatch/{workflowType}/{workflowBatchUuid}/detach` | Detach file | Not used |
+| `/workflowBatch/model` | Get model/schema | Not used |
+| `/workflowBatch/filter` | Get available filter fields | Not used |
+| `/workflowBatch/suggest` | Get suggested values for a filter field | Not used |
+
+### Known Limitations
+
+#### Attach endpoint does not work (tested 2026-04-13)
+
+The `/workflowBatch/{workflowType}/{workflowBatchUuid}/attach` endpoint is listed in the Swagger spec but returns HTTP 400 (Bad Request) for all tested request formats:
+
+- `multipart/form-data` with field name `file` (singular) — 400
+- `multipart/form-data` with field name `files` (plural) — 400
+- Tested with `Content-Type: application/octet-stream` and `image/png` — both 400
+- Tested with both `ivantiMultipartPost` and `ivantiFormPost` helpers — both 400
+
+The Ivanti response is a generic Spring Boot error with no detail message:
+```json
+{"timestamp":"...","status":400,"error":"Bad Request","path":"/api/v1/client/1550/workflowBatch/falsePositive/{uuid}/attach"}
+```
+
+**Workaround:** File attachments can only be uploaded during the initial workflow creation (sent inline with the `/workflowBatch/falsePositive/request` endpoint). To add attachments to an existing workflow, users must upload them directly in the Ivanti platform UI.
+
+#### Search by numeric batch ID does not work
+
+The `/workflowBatch/search` endpoint does not support filtering by the numeric `id` returned from the create endpoint. Searching with `{ field: 'id', operator: 'EXACT', value: '33432541' }` returns 0 results. Searching by `name` field works and returns the workflow batch object including the `uuid` field needed for map/attach operations.
+
+#### UUID not returned by create endpoint
+
+The `/workflowBatch/falsePositive/request` create endpoint returns only `{ id: <number>, created: <timestamp> }`. The `uuid` needed for map/attach/approve/reject operations must be obtained separately via the search endpoint.
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `IVANTI_API_KEY` | — | Required. API key for authentication |
+| `IVANTI_CLIENT_ID` | `1550` | Client ID in the Ivanti platform |
+| `IVANTI_SKIP_TLS` | `false` | Set `true` to skip TLS verification |
+| `IVANTI_FIRST_NAME` | — | Used for workflow search filter (sync) |
+| `IVANTI_LAST_NAME` | — | Used for workflow search filter (sync) |

docs/api/jira-api-use-cases.md

@@ -0,0 +1,171 @@
+# Jira REST API Use Cases — STEAM Security Dashboard
+
+## Overview
+
+The STEAM Security Dashboard is a self-hosted vulnerability management tool used by the NTS-AEO-STEAM and NTS-AEO-ACCESS-ENG teams. It integrates with Jira Data Center to create, track, and sync vulnerability remediation tickets linked to CVE records.
+
+All API calls are made from a single Node.js backend process. The integration uses Basic Auth with a service account and enforces Charter's posted rate limits client-side.
+
+---
+
+## Charter Compliance Summary
+
+| Requirement | Implementation |
+|---|---|
+| Authentication | Basic Auth with service account (`JIRA_API_USER` + `JIRA_API_TOKEN`) |
+| Rate limit — daily | Client-side enforced: 1 440 requests/day max |
+| Rate limit — burst | Client-side enforced: 60 requests/minute max |
+| Inter-request delay — GETs | 1 second minimum between GET requests |
+| Inter-request delay — writes | 2 seconds minimum between PUT/POST/DELETE requests |
+| Explicit field lists | Every GET includes `?fields=` parameter; `/rest/api/2/field` is blocked |
+| No bulk updates | Issues are updated one at a time; `/rest/api/2/issue/bulk` is blocked |
+| Bulk reads via JQL | Multi-ticket sync uses a single `GET /rest/api/2/search` with predefined key-based JQL query parameters, not per-issue GETs; no arbitrary JQL passthrough |
+| Single-issue fetch via JQL | `GET /rest/api/2/search?jql=key="KEY" AND project=<KEY>&fields=...&maxResults=1` |
+| JQL scoping | All recurring JQL queries use predefined scoped patterns with `updated >= -72h` clause and `project = <KEY>` scoping; no arbitrary JQL passthrough |
+| `maxResults` cap | Search queries capped at 1 000 results per page |
+
+---
+
+## Use Cases
+
+### 1. Connection Test
+
+| | |
+|---|---|
+| **Endpoint** | `GET /rest/api/2/myself` |
+| **Trigger** | Admin clicks "Test Connection" on the Jira settings panel |
+| **Frequency** | Manual, infrequent (a few times per day at most) |
+| **Purpose** | Verify service account credentials and connectivity |
+| **Fields requested** | Default (myself endpoint returns user profile) |
+
+### 2. Create Issue
+
+| | |
+|---|---|
+| **Endpoint** | `POST /rest/api/2/issue` |
+| **Trigger** | User clicks "Create in Jira" from a CVE detail panel |
+| **Frequency** | Manual, estimated 5–20 per day |
+| **Purpose** | Create a vulnerability remediation ticket linked to a CVE/vendor pair |
+| **Fields sent** | `project.key`, `summary`, `issuetype.name`, `description` |
+| **Notes** | A local record is also created in the dashboard database linking the Jira key to the CVE |
+
+### 3. Get Single Issue
+
+| | |
+|---|---|
+| **Endpoint** | `GET /rest/api/2/search?jql=key="ISSUE-KEY" AND project=<KEY>&fields=summary,status,assignee,created,updated,priority,issuetype,project,resolution&maxResults=1` |
+| **Trigger** | User clicks "Sync" on a single Jira ticket row |
+| **Frequency** | Manual, estimated 10–30 per day |
+| **Purpose** | Refresh a single ticket's status and summary from Jira via JQL search |
+| **Notes** | Uses JQL-based lookup instead of single-issue GET per Charter compliance. Fields are always specified explicitly. |
+
+### 4. Update Issue
+
+| | |
+|---|---|
+| **Endpoint** | `PUT /rest/api/2/issue/{issueKey}` |
+| **Trigger** | Future feature — local edits synced back to Jira |
+| **Frequency** | Manual, estimated 5–10 per day when enabled |
+| **Purpose** | Update issue summary or other fields from the dashboard |
+| **Notes** | Issues are updated one at a time; bulk PUT is not used |
+
+### 5. Add Comment
+
+| | |
+|---|---|
+| **Endpoint** | `POST /rest/api/2/issue/{issueKey}/comment` |
+| **Trigger** | Dashboard adds audit trail comments to linked tickets |
+| **Frequency** | Automated on certain actions, estimated 5–15 per day |
+| **Purpose** | Maintain an audit trail on the Jira ticket for compliance visibility |
+
+### 6. Get Transitions
+
+| | |
+|---|---|
+| **Endpoint** | `GET /rest/api/2/issue/{issueKey}/transitions` |
+| **Trigger** | Dashboard checks available workflow transitions before moving a ticket |
+| **Frequency** | Manual, paired with transition calls, estimated 5–10 per day |
+| **Purpose** | Discover valid status transitions for the issue's current workflow state |
+
+### 7. Transition Issue
+
+| | |
+|---|---|
+| **Endpoint** | `POST /rest/api/2/issue/{issueKey}/transitions` |
+| **Trigger** | User moves a ticket to a new status from the dashboard |
+| **Frequency** | Manual, estimated 5–10 per day |
+| **Purpose** | Move ticket through workflow states (e.g., Open to In Progress to Closed) |
+
+### 8. Scoped Bulk Sync via JQL
+
+| | |
+|---|---|
+| **Endpoint** | `GET /rest/api/2/search?jql=...&fields=...&maxResults=...&startAt=...` |
+| **Trigger** | Admin clicks "Sync All" on the Jira tickets panel |
+| **Frequency** | Manual, estimated 1–3 times per day |
+| **Purpose** | Bulk-refresh all tracked tickets in a single request instead of per-issue GETs |
+| **JQL pattern** | `key in ("KEY-1", "KEY-2", ...) AND updated >= -72h AND project = <KEY>` |
+| **Fields requested** | `summary, status, assignee, created, updated, priority, issuetype, project, resolution` |
+| **Batch size** | 100 keys per JQL query; multiple batches if needed |
+| **Notes** | Uses GET with URL-encoded query parameters per Charter compliance. JQL is predefined and scoped — constructed from known tracked issue keys, a fixed 72-hour window, and the configured project key. No arbitrary JQL is accepted from the frontend. Stops early if rate limit budget is running low (burst remaining <= 5 or daily remaining <= 10) |
+
+### 9. Issue Lookup
+
+| | |
+|---|---|
+| **Endpoint** | `GET /rest/api/2/search?jql=key="ISSUE-KEY" AND project=<KEY>&fields=...&maxResults=1` |
+| **Trigger** | User looks up a Jira issue by key from the dashboard search |
+| **Frequency** | Manual, estimated 5–15 per day |
+| **Purpose** | Quick lookup of any Jira issue to view its current state via JQL search |
+
+---
+
+## Estimated Daily API Usage
+
+| Operation | Estimated calls/day | Method | Delay enforced |
+|---|---|---|---|
+| Connection test | 2–5 | GET | 1s |
+| Create issue | 5–20 | POST | 2s |
+| Get single issue | 10–30 | GET | 1s |
+| Update issue | 5–10 | PUT | 2s |
+| Add comment | 5–15 | POST | 2s |
+| Get transitions | 5–10 | GET | 1s |
+| Transition issue | 5–10 | POST | 2s |
+| Scoped bulk sync | 1–5 | GET | 1s |
+| Issue lookup | 5–15 | GET | 1s |
+| **Total estimated** | **43–120** | | |
+
+Well within the 1 440/day limit. Burst usage stays under 60/minute due to enforced inter-request delays.
+
+---
+
+## Blocked Endpoints
+
+The integration explicitly blocks these endpoints to comply with Charter policy:
+
+- `/rest/api/2/field` — field metadata is never queried; fields are specified in code
+- `/rest/api/2/issue/bulk` — bulk updates are not used; issues are updated individually
+- `POST /rest/api/2/search` — arbitrary JQL search via POST is not used; all searches use `GET /rest/api/2/search` with URL-encoded query parameters and predefined scoped JQL patterns
+
+---
+
+## Error Handling
+
+- **429 responses**: Surfaced to the user as "Rate limit exceeded. Try again later." No automatic retry.
+- **5xx responses**: Surfaced as "Jira API error" with the response body for debugging.
+- **Network failures**: Caught and surfaced with the error message.
+- **Timeout**: 15 second timeout per request; surfaced as a timeout error.
+
+---
+
+## UAT Test Evidence
+
+The UAT test script (`backend/scripts/jira-uat-test.js`) exercises all use cases listed above and produces a log file at `backend/scripts/jira-uat-test.log`. This log can be attached to or referenced in the ATLSUP approval ticket.
+
+To run:
+
+```bash
+cd backend
+node scripts/jira-uat-test.js
+```
+

docs/guides/kb-compliance-guide.md

@@ -0,0 +1,94 @@
+# AEO Compliance Tracking Guide
+
+## Overview
+
+The Compliance page tracks AEO security posture metrics for the STEAM and ACCESS-ENG teams. It processes weekly xlsx compliance reports, shows per-metric health cards, and tracks non-compliant devices down to the individual hostname level.
+
+## Teams Tracked
+
+Only two teams are monitored:
+- **STEAM** (NTS-AEO-STEAM)
+- **ACCESS-ENG** (NTS-AEO-ACCESS-ENG)
+
+## Uploading a Compliance Report
+
+### Prerequisites
+- You must have editor or admin access
+- The report must be an `.xlsx` file (the standard NTS_AEO compliance export)
+
+### Upload Process
+
+1. Navigate to the **Compliance** page
+2. Click the **Upload Report** button
+3. Drag and drop the xlsx file or click to browse
+4. The system parses the spreadsheet using a Python backend script and shows a **preview**:
+   - **New items**: Devices/metrics appearing for the first time
+   - **Recurring items**: Devices/metrics that were already non-compliant
+   - **Resolved items**: Previously non-compliant items no longer in the report
+5. Review the diff summary
+6. Click **Commit** to save the data
+
+The upload is a two-step process (preview then commit) so you can verify the data before it's written to the database.
+
+## Health Cards
+
+After uploading, the page displays metric health cards for each team. Each card shows:
+
+- **Metric ID** — the compliance metric identifier
+- **Category** — the metric category (Vulnerability Management, Access & MFA, Logging & Monitoring, etc.)
+- **Compliance %** — current compliance percentage
+- **Target** — the required target percentage
+- **Status** — color-coded:
+  - Green: Meets/Exceeds Target
+  - Amber: Within 15% of Target
+  - Red: Below 15% of Target
+
+Click a health card to filter the device list to that specific metric.
+
+## Metric Categories
+
+| Category | Color |
+|----------|-------|
+| Vulnerability Management | Red |
+| Access & MFA | Amber |
+| Logging & Monitoring | Purple |
+| End-of-Life OS | Orange |
+| Decommissioned Assets | Slate |
+| Asset Data Quality | Slate |
+| Application Security | Blue |
+| Disaster Recovery | Teal |
+| Endpoint Protection | Orange |
+
+## Device-Level Tracking
+
+Below the health cards, the device list shows non-compliant devices grouped by hostname. Each device entry shows:
+
+- Hostname and IP address
+- Device type and team assignment
+- Failing metrics with first-seen and last-seen dates
+- Seen count (how many consecutive reports the device has been non-compliant)
+
+### Device Detail Panel
+
+Click a device to open the detail panel showing:
+- All metrics the device is failing
+- Upload history (when the device first appeared, when it was last seen)
+- Per-metric notes with timestamps
+
+### Adding Notes
+
+You can add notes to one or more metrics on a device at once:
+1. Open the device detail panel
+2. Select the metrics the note applies to using the chip selector — click individual metric chips to toggle them, or use **Select All** / **Deselect All** for bulk selection
+3. Type your note and click send
+4. Notes are timestamped and attributed to the logged-in user
+
+When a note is submitted for multiple metrics, it appears as a single grouped entry in the notes history with all associated metric chips displayed together. Notes are useful for tracking remediation progress, vendor ticket numbers, or explaining why a device is non-compliant.
+
+## Data Flow
+
+1. Weekly xlsx report is uploaded through the dashboard
+2. Python parser extracts team metrics and non-compliant devices
+3. Diff is computed against existing data (new/recurring/resolved)
+4. On commit: new items are inserted, recurring items have their seen_count incremented, resolved items are marked with resolved_on date
+5. Health cards and device lists update automatically

docs/guides/kb-cve-tracking-guide.md

@@ -0,0 +1,104 @@
+# CVE Tracking & NVD Sync Spec
+
+## Overview
+
+The Home page (CVE Management) is where you track individual CVEs across vendors, store supporting documentation, and link Archer risk acceptance tickets. It serves as the reference library for all vulnerability research and evidence.
+
+## Adding a CVE
+
+1. Click "Add CVE" on the Home page
+2. Enter the **CVE ID** (format: CVE-YYYY-NNNNN, e.g., CVE-2024-6387)
+3. Click the NVD lookup button to auto-populate fields from the National Vulnerability Database:
+   - Description
+   - Severity (Critical, High, Medium, Low)
+   - Published date
+4. Select or type the **Vendor/Platform** (e.g., Cisco, Juniper, ADTRAN)
+5. Review and adjust any fields as needed
+6. Click Save
+
+### NVD Auto-Population
+
+The NVD lookup queries the NIST NVD 2.0 API and extracts:
+- English description
+- CVSS severity using a cascade: v3.1 → v3.0 → v2.0
+- Published date
+
+If the NVD API is rate-limited (429 response), wait a few seconds and try again. Having an NVD API key configured in the backend `.env` file increases the rate limit.
+
+## CVE Details
+
+Each CVE entry tracks:
+
+| Field | Description |
+|-------|-------------|
+| CVE ID | The CVE identifier (e.g., CVE-2024-6387) |
+| Vendor | The affected vendor/platform |
+| Severity | Critical, High, Medium, or Low |
+| Description | Vulnerability description (from NVD or manual entry) |
+| Published Date | When the CVE was published |
+| Status | Open, In Progress, Addressed, or Resolved |
+
+## Document Storage
+
+Each CVE/vendor pair can have supporting documents attached. These serve as evidence for FP workflows, Archer tickets, and audit purposes.
+
+### Uploading Documents
+1. Open a CVE entry
+2. Click "Upload Document"
+3. Select the file (max 10 MB)
+4. Documents are stored in `uploads/cves/{cveId}/{vendor}/` on the server
+
+### Document Types
+- **Advisory** — vendor security advisories
+- **Email** — vendor communications or support ticket responses
+- **Screenshot** — device screenshots showing version info
+- **Patch** — patch notes or release documentation
+- **Other** — any other supporting evidence
+
+### Why Store Documents Here?
+Documents uploaded to CVE entries can be reused across multiple FP workflows. When an FP expires and needs renewal, the evidence is already in the dashboard rather than having to track it down again.
+
+## Archer Ticket Tracking
+
+Archer risk acceptance tickets (EXC-XXXXX) are linked to CVE/vendor pairs.
+
+### Adding an Archer Ticket
+1. Open a CVE entry
+2. Click "Add Archer Ticket"
+3. Enter the EXC number (e.g., EXC-12345)
+4. Optionally add the Archer URL and status
+
+### EXC Badge Integration
+Once an EXC number is entered:
+- An EXC badge appears on the CVE card on the Home page
+- Clicking the badge navigates to the Reporting page pre-filtered to findings with that EXC number in their notes
+- The Action Coverage chart on the Reporting page classifies findings with EXC numbers as "Archer Exception"
+
+## Vendor Tracking
+
+CVEs can be tracked across multiple vendors. Each CVE/vendor combination is a separate entry, allowing you to:
+- Track different remediation statuses per vendor
+- Store vendor-specific documentation
+- Link different Archer tickets per vendor
+
+## Editing CVEs
+
+1. Click the edit icon on a CVE card
+2. Modify any fields
+3. Use the NVD lookup button to refresh data from NVD if needed
+4. Click Save
+
+## Quick Check
+
+The Quick Check feature on the Home page lets you look up a CVE ID without adding it to the database:
+1. Type a CVE ID in the Quick Check field
+2. Press Enter — the NVD data is fetched and displayed
+3. If you want to track it, click "Add CVE" to create an entry
+
+## Tips
+
+- Always upload screenshots and vendor advisories to the CVE entry before submitting an FP workflow — reviewers may ask for this evidence
+- Use the status field to track progress: Open → In Progress → Addressed → Resolved
+- Link Archer EXC numbers as soon as the ticket is created — this updates the Action Coverage chart immediately
+- The search bar on the Home page searches across CVE ID, vendor, and description
+- Filter by vendor or severity using the dropdowns to focus on specific areas

docs/guides/kb-fp-submission-editing-guide.md

@@ -0,0 +1,110 @@
+# FP Workflow Queue & Submission Editing Guide
+
+## Overview
+
+The STEAM Security Dashboard allows you to create, track, and edit False Positive (FP) workflow submissions directly from the Reporting Page. This guide covers the full workflow from adding findings to the queue through editing and resubmitting FP workflows.
+
+## Adding Findings to the Queue
+
+1. On the Reporting Page, select findings by clicking the checkboxes in the findings table
+2. Use Shift+Click to select a range of findings
+3. In the selection toolbar that appears, choose the workflow type (FP, Archer, or CARD)
+4. Enter the vendor name (not required for CARD)
+5. Click "Add to Queue"
+
+The findings will appear in the Ivanti Queue panel (click the "Queue" button in the top-right).
+
+## Creating an FP Workflow
+
+1. Open the Queue panel
+2. Select the pending FP items you want to submit using the checkboxes
+3. Click "Create FP Workflow" at the bottom of the panel
+4. Fill in the required fields:
+   - **Workflow Name**: Use the format `FP — CVE-XXXX-XXXX — Vendor` (e.g., `FP — CVE-2024-6387 — Cisco_STEAM`)
+   - **Reason / Justification**: Explain why these findings are false positives
+   - **Description** (optional): Additional context
+   - **Expiration Date**: Must be a future date
+   - **Scope Override**: Leave as "Authorized" for standard FP workflows
+5. Attach supporting files (screenshots, evidence) — up to 10 files, 10 MB each
+6. Click Submit
+
+The workflow is created in the Ivanti platform and the queue items are marked as complete.
+
+## Viewing Submissions
+
+Your FP submissions appear in the "Submissions" section at the bottom of the Queue panel. Each submission shows:
+- Workflow name
+- Ivanti batch ID
+- Lifecycle status badge (color-coded)
+- Finding count
+- Submission date
+
+Click any submission to open the Edit Modal.
+
+## Lifecycle Status
+
+Submissions go through these states:
+
+| Status | Color | Meaning |
+|--------|-------|---------|
+| Submitted | Sky Blue | Awaiting review |
+| Rework | Amber | Reviewer sent it back — action needed |
+| Rejected | Red | Reviewer denied the FP request |
+| Resubmitted | Sky Blue | Edited and sent back for review |
+| Approved | Green | FP accepted — no further action |
+
+The status badge automatically syncs with the Ivanti platform state when findings data is refreshed.
+
+## Editing an Existing Submission
+
+Open a submission from the Queue panel to access the Edit Modal with four tabs:
+
+### Details Tab
+- Edit the workflow name, reason, description, expiration date, and scope override
+- Click "Save Details" to push changes to the Ivanti platform
+- If the submission was in Rework or Rejected status, saving automatically changes it to Resubmitted
+
+### Findings Tab
+- View the current list of finding IDs mapped to this workflow
+- Add more findings from your pending FP queue items
+- Select the items to add and click "Add Findings"
+- Each finding is mapped individually to the Ivanti workflow
+
+### Attachments Tab
+- View files that were uploaded with the original submission
+- **Note**: Adding attachments to an existing workflow is not supported via the Ivanti API. To add more files, upload them directly in the Ivanti platform.
+
+### History Tab
+- View a chronological log of all changes made to the submission
+- Shows finding additions with the actual finding IDs
+- Displays Ivanti reviewer notes (rework feedback, approval notes) pulled directly from the Ivanti platform
+
+## Handling Rework Requests
+
+When a submission comes back for rework:
+
+1. Open the submission from the Queue panel — the status badge will show "Rework" (amber)
+2. Go to the **History** tab to read the reviewer's notes explaining what needs to change
+3. Common rework reasons:
+   - Need more screenshots showing remediation
+   - Need to verify specific software versions
+   - Missing evidence for some findings
+4. Go to the **Findings** tab to add any additional findings if needed
+5. Upload additional screenshots directly in the Ivanti platform (Attachments tab has a link)
+6. Go to the **Details** tab to update the reason/description if needed
+7. Click "Save Details" — the status automatically changes to Resubmitted
+
+## Changing Status Manually
+
+Use the status dropdown in the Edit Modal to manually change the lifecycle status. This is useful when:
+- You receive notification outside the dashboard that a submission was rejected
+- You want to mark a submission as approved after confirming in Ivanti
+
+**Note**: Approved submissions are locked and cannot be edited.
+
+## Tips
+
+- Always include enough screenshots per audit guidance (e.g., 10 screenshots for 20-50 findings)
+- Use the naming convention `FP — CVE-XXXX-XXXX — Vendor_Team` for easy identification
+- Check the FP Workflow Status donut chart on the Reporting Page for an overview of all your FP ticket states
+- The workflow column in the findings table shows the current Ivanti state for each finding

docs/guides/kb-ivanti-queue-guide.md

@@ -0,0 +1,89 @@
+# Ivanti Queue & Batch Operations Guide
+
+## Overview
+
+The Ivanti Queue is a personal staging area for batch-processing vulnerability findings. You select findings from the Reporting Page table, assign them a workflow type and vendor, and stage them in the queue. From there you can create FP workflows, track Archer exceptions, or manage CARD dispositions.
+
+## Workflow Types
+
+| Type | Color | Purpose | Vendor Required? |
+|------|-------|---------|-----------------|
+| FP | Amber | False Positive — finding is not actually a vulnerability | Yes |
+| Archer | Blue | Risk Acceptance — vulnerability exists but can't be patched | Yes |
+| CARD | Green | Asset disposition — device not owned by your BU | No |
+
+## Adding Findings to the Queue
+
+### Single Finding
+1. In the findings table, click the checkbox area on a row (not the checkbox itself — click the cell)
+2. A popover appears with:
+   - The finding ID
+   - Vendor/Platform input field (required for FP and Archer)
+   - Workflow type toggle (FP / Archer / CARD)
+3. Enter the vendor name and select the workflow type
+4. Click "Add to Queue"
+
+### Batch Add (Multiple Findings)
+1. Select multiple findings using checkboxes (Shift+Click for range selection)
+2. The selection toolbar appears at the top of the table
+3. Choose the workflow type (FP / Archer / CARD)
+4. Enter the vendor name (not needed for CARD)
+5. Click "Add to Queue" — all selected findings are added at once (up to 200 per batch)
+
+## The Queue Panel
+
+Click the **Queue** button (top right of the Reporting Page) to open the slide-out panel. The badge shows the count of pending items.
+
+### Layout
+- Items are grouped by vendor (alphabetically)
+- CARD items appear in their own green section at the top
+- Each item shows: finding ID, CVEs, hostname, IP address, and workflow type badge
+
+### Item Actions
+
+| Action | How |
+|--------|-----|
+| Mark complete | Click the green checkbox |
+| Mark pending | Uncheck the green checkbox |
+| Select for deletion | Click the red checkbox (left side) |
+| Delete selected | Click "Delete (N)" button in footer |
+| Clear all completed | Click "Clear Completed" button in footer |
+| Redirect workflow | Click the redirect arrow (↗) on completed items |
+
+### Redirect Feature
+
+When a finding is completed under one workflow type but needs to be processed under another:
+1. Complete the item first
+2. Click the redirect arrow (↗) icon
+3. Choose the new workflow type
+4. A new pending item is created with the same finding data but the new workflow type
+
+Example: You submitted an FP but it was rejected. You now need to open an Archer ticket instead. Complete the FP item, then redirect it to Archer.
+
+## Creating FP Workflows from the Queue
+
+1. Open the Queue panel
+2. Select pending FP items using the checkboxes
+3. Click "Create FP Workflow" in the footer (only enabled when FP items are selected)
+4. Fill in the workflow details (name, reason, description, expiration date)
+5. Attach supporting files (screenshots, evidence)
+6. Submit — the workflow is created in Ivanti and queue items are marked complete
+
+See the [FP Submission Editing Guide](kb-fp-submission-editing-guide.md) for details on editing submitted workflows.
+
+## FP Submissions Section
+
+Below the queue items, a "Submissions" section shows your previously submitted FP workflows with:
+- Workflow name and Ivanti batch ID
+- Lifecycle status badge (Submitted, Rework, Rejected, Resubmitted, Approved)
+- Finding count and submission date
+
+Click any submission to open the Edit Modal for viewing details, adding findings, or reading reviewer notes.
+
+## Tips
+
+- Group related findings by vendor before adding to the queue — this makes it easier to create batch FP workflows
+- Use CARD for findings on devices that belong to another team — no vendor entry needed
+- The queue is per-user — other team members can't see or modify your queue items
+- Completed items stay in the queue until you clear them, so you have a record of what was processed
+- Use the redirect feature when a workflow type needs to change after initial processing

docs/guides/kb-reporting-page-guide.md

@@ -0,0 +1,92 @@
+# Reporting Page Guide
+
+## Overview
+
+The Reporting Page is the primary operational page in the STEAM Security Dashboard. It provides a live view of all open Ivanti host findings with filtering, sorting, inline editing, metric charts, and export capabilities.
+
+## Getting Started
+
+1. Navigate to the Reporting page from the sidebar
+2. Click **Sync** (top right) to pull the latest findings from Ivanti
+3. The sync timestamp updates when complete — findings, charts, and counts all refresh together
+
+## Metric Charts
+
+Four donut charts appear at the top of the page:
+
+### Open vs Closed
+Shows the total count of open and closed findings across all synced data.
+
+### Action Coverage
+Breaks down open findings into three categories:
+- **FP Request** (blue) — findings with an FP workflow ticket in Ivanti
+- **Archer Exception** (amber) — findings with an EXC-XXXXX number in their notes
+- **Pending** (red) — findings with no action taken yet
+
+Click a chart segment to filter the table to that category. Click again or use "clear filter" to remove.
+
+### FP Finding Status
+Shows the distribution of findings across FP workflow states (Requested, Reworked, Actionable, Approved, Rejected, Expired).
+
+### FP Workflow Status
+Shows the count of unique FP ticket IDs per state — one FP ticket can cover many findings.
+
+## Findings Table
+
+### Columns
+The table has 13 columns. All are visible by default:
+
+| Column | Description |
+|--------|-------------|
+| Finding ID | Ivanti host finding identifier |
+| Severity | VRR score with severity group (Critical, High, Medium) |
+| Title | Vulnerability title |
+| CVEs | Associated CVE identifiers (hover for tooltip details) |
+| Host | Hostname (inline editable) |
+| IP Address | Device IP |
+| DNS | DNS name (inline editable) |
+| Due Date | SLA deadline — red if overdue, amber if within 30 days |
+| SLA | SLA status (Overdue, At Risk, Within SLA) |
+| BU | Business unit ownership (STEAM or ACCESS-ENG) |
+| Workflow | FP workflow badge showing ticket ID and state |
+| Last Found | Date the finding was last detected by scanner |
+| Notes | Free-text notes field (inline editable) |
+
+### Column Management
+Click the **Columns** button (gear icon) to:
+- Show/hide columns by clicking the eye icon
+- Drag columns to reorder them
+- Your column configuration is saved in your browser
+
+### Sorting
+Click any sortable column header to sort. Click again to reverse direction. The active sort column is highlighted in blue.
+
+### Filtering
+Click the filter icon on any filterable column header to open a dropdown with all unique values. Check/uncheck values to filter. Use "Select All" or "Clear" for bulk operations. A search box lets you find specific values quickly.
+
+Active filters show as amber badges above the table. Click "Clear Filters" to remove all column filters at once.
+
+### Inline Editing
+
+Three columns support inline editing:
+
+- **Host**: Click the hostname to edit. An amber dot appears when an override is active. Click the revert button (↻) to restore the original Ivanti value. Overrides survive re-syncs.
+- **DNS**: Same behavior as Host.
+- **Notes**: Click to type. Saves automatically on blur. Use notes to record EXC numbers (e.g., `EXC-12345`) — the Action Coverage chart will classify these as "Archer Exception".
+
+## Selecting Findings
+
+Check the checkbox on any row to select it. Use Shift+Click for range selection. The "select all" checkbox in the header selects all visible (non-queued) findings.
+
+When findings are selected, a toolbar appears with:
+- Workflow type toggle (FP / Archer / CARD)
+- Vendor input field (not needed for CARD)
+- "Add to Queue" button to stage findings for batch processing
+
+## Export
+
+Click the **Export** dropdown to download the current filtered/sorted view as:
+- **CSV** — comma-separated values with UTF-8 BOM
+- **Excel (.xlsx)** — formatted spreadsheet with auto-fit column widths
+
+Only visible columns are included in the export.

docs/guides/kb-user-management-guide.md

@@ -0,0 +1,106 @@
+# User Management & Roles Guide
+
+## Overview
+
+The STEAM Security Dashboard uses role-based access control with four user groups. Only administrators can manage users. All user operations are logged in the audit trail.
+
+## User Groups
+
+| Group | Access Level | Description |
+|-------|-------------|-------------|
+| Admin | Full access | All operations including user management, delete, audit log |
+| Standard_User | Operational access | Create, edit, limited delete (own resources only), exports |
+| Leadership | Read-only + exports | View all data, download CSV/XLSX exports |
+| Read_Only | View only | Read-only access to all pages, no modifications |
+
+## Permission Matrix
+
+| Action | Admin | Standard_User | Leadership | Read_Only |
+|--------|-------|---------------|------------|-----------|
+| View findings/CVEs | Yes | Yes | Yes | Yes |
+| Sync Ivanti data | Yes | Yes | No | No |
+| Edit hostname/DNS overrides | Yes | Yes | No | No |
+| Edit notes | Yes | Yes | No | No |
+| Add to queue | Yes | Yes | No | No |
+| Create FP workflows | Yes | Yes | No | No |
+| Edit FP submissions | Yes | Yes | No | No |
+| Upload compliance reports | Yes | Yes | No | No |
+| Add CVEs | Yes | Yes | No | No |
+| Upload documents | Yes | Yes | No | No |
+| Export CSV/XLSX | Yes | Yes | Yes | No |
+| Delete CVEs/documents | Yes | Own only | No | No |
+| Manage users | Yes | No | No | No |
+| View audit log | Yes | No | No | No |
+
+## Managing Users (Admin Only)
+
+### Accessing User Management
+1. Click the user icon in the top navigation bar
+2. Select "User Management" from the menu
+3. The user list shows all accounts with their group, status, and last login
+
+### Creating a New User
+1. Click "Add User"
+2. Fill in the required fields:
+   - **Username** — must be unique
+   - **Email** — user's email address
+   - **Password** — initial password (user should change on first login)
+   - **Group** — select from Admin, Standard_User, Leadership, or Read_Only
+3. Click Save
+
+New users default to Read_Only if no group is specified.
+
+### Editing a User
+1. Click the edit icon on the user row
+2. Modify username, email, or group
+3. Optionally set a new password (leave blank to keep current)
+4. Click Save
+
+### Changing User Groups
+When changing a user's group, a confirmation dialog appears. Extra warnings are shown when:
+- Removing Admin privileges from a user
+- Upgrading a user to Admin
+
+Group changes are logged separately in the audit trail with the previous and new group recorded.
+
+### Deactivating Users
+Users can be deactivated rather than deleted. Deactivated users cannot log in but their data and audit history are preserved.
+
+## Authentication
+
+- Sessions use httpOnly cookies with 24-hour expiry
+- Passwords are hashed with bcryptjs
+- All API endpoints (except login) require a valid session
+- Failed login attempts are not rate-limited at the application level
+
+## Audit Log
+
+The audit log records all significant actions in the dashboard. Only admins can view it.
+
+### What's Logged
+- User creation, updates, group changes, deletion
+- CVE creation, updates, deletion
+- Document uploads and deletions
+- Ivanti sync operations
+- FP workflow submissions and edits
+- Queue operations
+- Compliance uploads
+- Login/logout events
+
+### Audit Entry Fields
+Each entry includes:
+- Timestamp
+- User who performed the action
+- Action type (e.g., user_create, ivanti_fp_workflow_created)
+- Entity type and ID
+- Details (JSON with specifics of what changed)
+- IP address
+
+## Default Admin Account
+
+On first setup (`node setup.js`), a default admin account is created:
+- Username: `admin`
+- Password: set during setup
+- Group: `Admin`
+
+Change the default password immediately after first login.

docs/guides/postgres-migration-plan.md

@@ -0,0 +1,289 @@
+# Postgres Migration Plan
+
+## Overview
+
+Migrate the STEAM Security Dashboard from SQLite (`cve_database.db`) to PostgreSQL. This eliminates the JSON blob performance bottleneck, enables per-BU closed finding counts, and supports the multi-tenancy feature properly.
+
+## Current State
+
+- **Database**: SQLite 3, single file `backend/cve_database.db` (13MB)
+- **Performance bottleneck**: `ivanti_findings_cache.findings_json` — a 2.6MB TEXT column holding all findings as serialized JSON, parsed on every API request
+- **Limitation**: No per-BU closed finding data (only a global count)
+- **Concurrency**: SQLite single-writer lock blocks reads during sync writes
+
+## Target State
+
+- **Database**: PostgreSQL 16 (Docker container on port 5433)
+- **Findings storage**: Individual rows in `ivanti_findings` table with indexed columns
+- **Closed findings**: Stored as rows with `state = 'closed'` and `bu_ownership` column
+- **Per-BU counts**: Simple `SELECT COUNT(*) WHERE state = ? AND bu_ownership LIKE ?`
+- **Concurrency**: Connection pool (10 connections), reads never blocked by writes
+
+## Infrastructure
+
+### Port Allocation
+
+| Port | Service | Status |
+|------|---------|--------|
+| 3000 | Frontend (production) | In use |
+| 3001 | Backend (production) | In use |
+| 3002 | Other project (Python) | In use — do not touch |
+| 3003 | Test backend (temporary, during migration dev) | Available |
+| 5000 | Other project (Python) | In use — do not touch |
+| 5432 | Other project (Postgres) | In use — do not touch |
+| 5433 | CVE Dashboard Postgres (Docker) | Available — ours |
+
+### Docker Setup
+
+```bash
+docker run -d --name steam-postgres \
+  --restart unless-stopped \
+  -e POSTGRES_DB=cve_dashboard \
+  -e POSTGRES_USER=steam \
+  -e POSTGRES_PASSWORD=<generated-password> \
+  -p 5433:5432 \
+  -v steam-pgdata:/var/lib/postgresql/data \
+  postgres:16-alpine
+```
+
+### Connection String
+
+```
+postgresql://steam:<password>@localhost:5433/cve_dashboard
+```
+
+Added to `backend/.env` as `DATABASE_URL`.
+
+## Migration Strategy
+
+### Approach: Blue-Green on Same Box
+
+1. Production stays on SQLite (port 3001) throughout development
+2. New Postgres backend tested on port 3003
+3. Cutover: stop old backend, start new backend on port 3001
+4. Rollback: stop new backend, start old SQLite backend
+
+### Branch Strategy
+
+All work happens on `feature/multi-tenancy` branch (same branch as the multi-BU work). The Postgres migration is the infrastructure that makes multi-BU tenancy performant.
+
+## Schema Design
+
+### Key Changes from SQLite
+
+| SQLite | PostgreSQL |
+|--------|-----------|
+| `findings_json` TEXT blob (2.6MB) | `ivanti_findings` table — one row per finding |
+| Single `ivanti_counts_cache` row | Derived from `ivanti_findings` via queries |
+| `TEXT` for everything | Proper types: `INTEGER`, `NUMERIC`, `TIMESTAMPTZ`, `TEXT[]` |
+| No concurrent writes | Connection pool, MVCC |
+| File-based | Docker volume `steam-pgdata` |
+
+### New `ivanti_findings` Table
+
+```sql
+CREATE TABLE ivanti_findings (
+    id TEXT PRIMARY KEY,              -- Ivanti finding ID
+    host_id INTEGER,
+    title TEXT NOT NULL DEFAULT '',
+    severity NUMERIC(4,2) NOT NULL DEFAULT 0,
+    vrr_group TEXT NOT NULL DEFAULT '',
+    host_name TEXT NOT NULL DEFAULT '',
+    ip_address TEXT NOT NULL DEFAULT '',
+    dns TEXT NOT NULL DEFAULT '',
+    status TEXT NOT NULL DEFAULT '',
+    sla_status TEXT NOT NULL DEFAULT '',
+    due_date DATE,
+    last_found_on DATE,
+    bu_ownership TEXT NOT NULL DEFAULT '',
+    cves TEXT[] DEFAULT '{}',
+    workflow_id TEXT,
+    workflow_state TEXT,
+    workflow_type TEXT,
+    state TEXT NOT NULL DEFAULT 'open' CHECK (state IN ('open', 'closed')),
+    note TEXT NOT NULL DEFAULT '',
+    override_host_name TEXT,
+    override_dns TEXT,
+    synced_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX idx_findings_state ON ivanti_findings(state);
+CREATE INDEX idx_findings_bu ON ivanti_findings(bu_ownership);
+CREATE INDEX idx_findings_severity ON ivanti_findings(severity);
+CREATE INDEX idx_findings_state_bu ON ivanti_findings(state, bu_ownership);
+```
+
+### Per-BU Counts (No Separate Table Needed)
+
+```sql
+-- Open count for STEAM
+SELECT COUNT(*) FROM ivanti_findings WHERE state = 'open' AND bu_ownership ILIKE '%STEAM%';
+
+-- Closed count for STEAM
+SELECT COUNT(*) FROM ivanti_findings WHERE state = 'closed' AND bu_ownership ILIKE '%STEAM%';
+
+-- All BU counts in one query
+SELECT
+    bu_ownership,
+    state,
+    COUNT(*) as count
+FROM ivanti_findings
+GROUP BY bu_ownership, state;
+```
+
+## Data Migration Script
+
+A one-time script (`backend/scripts/migrate-to-postgres.js`) that:
+
+1. Opens the SQLite database (read-only)
+2. Connects to Postgres
+3. Creates all tables (idempotent — `IF NOT EXISTS`)
+4. Copies data table by table:
+   - `users` → `users` (direct copy + `bu_teams`)
+   - `sessions` → `sessions`
+   - `cves` → `cves`
+   - `documents` → `documents`
+   - `jira_tickets` → `jira_tickets`
+   - `archer_tickets` → `archer_tickets`
+   - `knowledge_base` → `knowledge_base`
+   - `audit_logs` → `audit_logs`
+   - `compliance_uploads` → `compliance_uploads`
+   - `compliance_items` → `compliance_items`
+   - `compliance_notes` → `compliance_notes`
+   - `ivanti_findings_cache.findings_json` → individual rows in `ivanti_findings` (state='open')
+   - `ivanti_finding_notes` → merged into `ivanti_findings.note`
+   - `ivanti_finding_overrides` → merged into `ivanti_findings.override_*`
+   - `ivanti_counts_history` → `ivanti_counts_history`
+   - `ivanti_finding_archives` → `ivanti_finding_archives`
+   - `ivanti_archive_transitions` → `ivanti_archive_transitions`
+   - `ivanti_sync_anomaly_log` → `ivanti_sync_anomaly_log`
+   - `ivanti_finding_bu_history` → `ivanti_finding_bu_history`
+   - `atlas_action_plans_cache` → `atlas_action_plans_cache`
+   - `ivanti_fp_submissions` → `ivanti_fp_submissions`
+   - `ivanti_fp_submission_history` → `ivanti_fp_submission_history`
+   - `ivanti_todo_queue` → `ivanti_todo_queue`
+5. Verifies row counts match
+6. Prints summary
+
+## Code Changes
+
+### Backend
+
+1. **New dependency**: `pg` (node-postgres) replaces `sqlite3`
+2. **Connection pool**: `backend/db.js` — creates and exports a `Pool` instance
+3. **Query pattern change**:
+   ```js
+   // Before (SQLite callback):
+   db.get('SELECT * FROM users WHERE id = ?', [id], (err, row) => { ... });
+
+   // After (Postgres async):
+   const { rows } = await pool.query('SELECT * FROM users WHERE id = $1', [id]);
+   const row = rows[0];
+   ```
+4. **Placeholder syntax**: `?` → `$1, $2, $3...`
+5. **Findings sync**: Write individual rows via `INSERT ... ON CONFLICT (id) DO UPDATE`
+6. **Closed findings sync**: Same pattern — upsert with `state = 'closed'`
+7. **Counts**: Derived queries instead of a cache table
+
+### Frontend
+
+No changes needed — the API contract stays the same. The frontend already does client-side filtering.
+
+## Cutover Procedure
+
+```bash
+# 1. Final sync on production (SQLite) to get latest data
+curl -X POST http://localhost:3001/api/ivanti/findings/sync
+
+# 2. Run migration script (copies SQLite → Postgres)
+node backend/scripts/migrate-to-postgres.js
+
+# 3. Stop production backend
+systemctl stop cve-backend  # or kill the process
+
+# 4. Update .env to use Postgres
+# DATABASE_URL=postgresql://steam:<pass>@localhost:5433/cve_dashboard
+# DB_TYPE=postgres
+
+# 5. Start new backend on same port
+systemctl start cve-backend  # now uses Postgres
+
+# 6. Verify
+curl http://localhost:3001/api/auth/me  # should work
+```
+
+### Rollback (if needed)
+
+```bash
+# 1. Stop new backend
+systemctl stop cve-backend
+
+# 2. Revert .env
+# DB_TYPE=sqlite  (or remove DATABASE_URL)
+
+# 3. Start old backend
+systemctl start cve-backend
+```
+
+## Timeline Estimate
+
+| Phase | Effort | Description |
+|-------|--------|-------------|
+| Docker setup | 5 min | One command |
+| Schema creation | 1 hour | SQL DDL for all tables |
+| DB abstraction layer | 2-3 hours | `backend/db.js` pool + query helpers |
+| Route migration | 4-6 hours | Update all routes from sqlite3 callbacks to pg async |
+| Findings redesign | 2-3 hours | New sync logic writing individual rows |
+| Closed findings | 1-2 hours | Store closed findings, per-BU count queries |
+| Data migration script | 1-2 hours | SQLite → Postgres copy |
+| Testing | 2-3 hours | Verify all endpoints, sync, UI |
+| Cutover | 30 min | Stop/start + verify |
+| **Total** | **~15-20 hours** | |
+
+## Risks and Mitigations
+
+| Risk | Mitigation |
+|------|-----------|
+| Docker container crashes | `--restart unless-stopped` flag |
+| Data loss during cutover | SQLite file preserved as backup forever |
+| Postgres disk fills up | Docker volume on main disk; monitor with `df` |
+| Connection pool exhaustion | Pool max = 10, with queue; log warnings at 8 |
+| Migration script bugs | Run against dev DB first; verify row counts |
+
+## Post-Migration Benefits
+
+- **Instant BU filtering**: `WHERE bu_ownership ILIKE '%STEAM%'` on indexed column
+- **Per-BU closed counts**: No more "N/A" — real numbers per team
+- **No JSON parsing**: Findings are rows, not a blob
+- **Concurrent access**: Multiple users can read while sync writes
+- **Future-proof**: Easy to add full-text search, materialized views, partitioning
+
+## Docker Container Setup
+
+Run this once to create the Postgres container:
+
+```bash
+docker run -d --name steam-postgres \
+  --restart unless-stopped \
+  -e POSTGRES_DB=cve_dashboard \
+  -e POSTGRES_USER=steam \
+  -e POSTGRES_PASSWORD=sV4xmC9xAUCFop0ypxMVS056QgPqGrX \
+  -p 5433:5432 \
+  -v steam-pgdata:/var/lib/postgresql/data \
+  postgres:16-alpine
+```
+
+Verify it's running:
+```bash
+docker ps | grep steam-postgres
+psql -h localhost -p 5433 -U steam -d cve_dashboard -c "SELECT 1;"
+```
+
+Management commands:
+```bash
+docker stop steam-postgres     # Stop
+docker start steam-postgres    # Start
+docker logs steam-postgres     # View logs
+docker exec -it steam-postgres psql -U steam -d cve_dashboard  # Shell access
+```