Add Next.js web dashboard foundation

README.md

@@ -1,6 +1,6 @@
 # DetLab
 
-DetLab is an advanced detection engineering platform for validating, translating, scoring, packaging, distributing, verifying, and serving behavioral detections across multiple security backends.
+DetLab is an advanced detection engineering platform for validating, translating, scoring, packaging, distributing, verifying, serving, and visualizing behavioral detections across multiple security backends.
 
 ## Platform Capabilities
 
@@ -15,73 +15,80 @@ DetLab is an advanced detection engineering platform for validating, translating
 - Pack trust verification
 - Docker deployment support
 - FastAPI service layer
+- Next.js dashboard foundation
 - GHCR publishing workflows
 - Governance reporting
 - CI/CD integration
 
-## FastAPI Service Layer
+## Web Dashboard
 
-DetLab now supports API-backed execution using FastAPI.
+DetLab now supports a Next.js-based dashboard foundation.
 
-## Install API Dependencies
+## Dashboard Stack
 
-```bash
-pip install -r requirements-api.txt
-```
+| Layer | Technology |
+|---|---|
+| Frontend | Next.js |
+| API | FastAPI |
+| Runtime | Docker Compose |
+| Deployment | Container-native |
 
-## Start API Server
+## Frontend Setup
 
 ```bash
-uvicorn detlab.api:app --host 0.0.0.0 --port 8000
+cd web
+npm install
+npm run dev
 ```
 
-## Example Endpoints
-
-### Health Check
+Frontend URL:
 
 ```text
-GET /health
+http://localhost:3000
 ```
 
-### Validate Detections
+## API Server
 
-```text
-GET /validate
+```bash
+uvicorn detlab.api:app --host 0.0.0.0 --port 8000
 ```
 
-### Generate Analytics
+API URL:
 
 ```text
-GET /analytics
+http://localhost:8000
 ```
 
-### Generate Detection Scores
+## Docker Compose Stack
 
-```text
-GET /score
+```bash
+docker compose up --build
 ```
 
-## Docker Deployment
-
-### Build Local Image
+Supports:
+- frontend dashboard
+- FastAPI backend
+- containerized local development
+- platform orchestration
 
-```bash
-docker build -t detlab .
-```
+## Dashboard Features
 
-### Run Validation
+Current dashboard foundation includes:
 
-```bash
-docker run --rm \
-  -v "$PWD:/workspace" \
-  detlab validate detections
-```
+- API health monitoring
+- platform capability overview
+- frontend/API integration foundation
+- governance dashboard groundwork
 
-## GitHub Container Registry
+## Planned Dashboard Features
 
-```text
-ghcr.io/egrexsec/detlab:latest
-```
+- ATT&CK heatmaps
+- detection score visualizations
+- maturity distributions
+- pack browsing
+- trust verification status
+- governance analytics
+- behavioral detection timelines
 
 ## Detection Pack Trust Verification
 
@@ -146,6 +153,7 @@ sequence:
 - Pack integrity verification
 - Reproducible container execution
 - API-backed workflows
+- Frontend platform foundations
 
 ## Long-Term Vision
 
@@ -158,6 +166,7 @@ DetLab is evolving toward:
 - portable detection engineering platforms
 - container-native detection engineering
 - API-driven detection operations
+- full detection engineering platform ecosystems
 
 ## License
 

docker-compose.yml

@@ -0,0 +1,15 @@
+version: '3.9'
+
+services:
+  api:
+    build: .
+    command: uvicorn detlab.api:app --host 0.0.0.0 --port 8000
+    ports:
+      - '8000:8000'
+
+  web:
+    build: ./web
+    ports:
+      - '3000:3000'
+    depends_on:
+      - api

web/app/page.tsx

@@ -0,0 +1,39 @@
+async function getHealth() {
+  try {
+    const response = await fetch('http://localhost:8000/health', {
+      cache: 'no-store'
+    })
+
+    return response.json()
+  } catch {
+    return { status: 'offline' }
+  }
+}
+
+export default async function HomePage() {
+  const health = await getHealth()
+
+  return (
+    <main style={{ padding: '2rem', fontFamily: 'Arial' }}>
+      <h1>DetLab Dashboard</h1>
+
+      <div style={{ marginTop: '2rem' }}>
+        <h2>Platform Status</h2>
+        <p>API Status: {health.status}</p>
+      </div>
+
+      <div style={{ marginTop: '2rem' }}>
+        <h2>Capabilities</h2>
+
+        <ul>
+          <li>ATT&CK Analytics</li>
+          <li>Detection Scoring</li>
+          <li>Behavioral Sequences</li>
+          <li>Pack Registry</li>
+          <li>Trust Verification</li>
+          <li>Governance Reporting</li>
+        </ul>
+      </div>
+    </main>
+  )
+}

web/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "detlab-web",
+  "private": true,
+  "version": "0.1.0",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "next": "14.2.5",
+    "react": "18.3.1",
+    "react-dom": "18.3.1"
+  }
+}