ARES - authorized red-team engagement automation with dashboard, campaign scope, module orchestration, OPSEC controls, encrypted vault, and reporting.
Python active-directorycloud-securitydefensive-validationfastapigood-first-issuemitre-attackopsecreactred-teamreportingsecurity
ux: add single-command dashboard dev launcher
Mafifrizicae5bf1da705
diff --git a/README.md b/README.mdindex 2866337..00bfa1f 100644--- a/README.md+++ b/README.md@@ -79,10 +79,23 @@ ARES focuses on the operational layer:### Operator Dashboard-The React dashboard is served at:+ARES has two dashboard serving modes:-```text-http://localhost:8080/dashboard+- Local development: run the launcher from the repository root and open the+ Vite dashboard at `http://127.0.0.1:5173/dashboard/`.+- Production/static serving: after the frontend assets are built, FastAPI+ serves the compiled dashboard at `/dashboard`.++Recommended local development command:++```bash+ares dashboard dev+```++Windows virtualenv example:++```powershell+.\.venv\Scripts\ares.exe dashboard dev```Dashboard preview:@@ -389,6 +402,12 @@ Recommended local dashboard startup from the repository root:ares dashboard dev```+Windows virtualenv example:++```powershell+.\.venv\Scripts\ares.exe dashboard dev+```+The launcher starts both services in one terminal:- Backend API: `http://127.0.0.1:8080`@@ -415,13 +434,14 @@ Manual fallback for troubleshooting:Terminal 1:```powershell+Set-Location C:\path\to\ARES.\.venv\Scripts\python.exe -m uvicorn ares.api.server:app --host 127.0.0.1 --port 8080 --reload```Terminal 2:```powershell-cd frontend+Set-Location C:\path\to\ARES\frontend"C:\Program Files\nodejs\npm.cmd" run dev -- --host 127.0.0.1 --port 5173```@@ -638,7 +658,8 @@ PDF report visual QA passed through browser fallback and Poppler render checksRuntime features confirmed locally:-- Dashboard loads at `/dashboard`.+- Production/static dashboard loads from FastAPI at `/dashboard` after frontend+ assets are built; local Vite dev mode uses `http://127.0.0.1:5173/dashboard/`.- Health endpoint returns connected DB.- Login, password change, API key lifecycle, and campaign cleanup work.- Report generation and authenticated download work.diff --git a/docs/dashboard-guide.md b/docs/dashboard-guide.mdindex 8912f94..2b3bcc3 100644--- a/docs/dashboard-guide.md+++ b/docs/dashboard-guide.md@@ -3,10 +3,10 @@The dashboard is the operator UI for ARES. It turns the API, module catalog,campaign state, reports, graph data, and security controls into one workflow.-Production URL:+Production/static route after frontend assets are built:```text-http://localhost:8080/dashboard+/dashboard```## Local Developer Startup@@ -34,13 +34,14 @@ Manual fallback for troubleshooting:Terminal 1:```powershell+Set-Location C:\path\to\ARES.\.venv\Scripts\python.exe -m uvicorn ares.api.server:app --host 127.0.0.1 --port 8080 --reload```Terminal 2:```powershell-cd frontend+Set-Location C:\path\to\ARES\frontend"C:\Program Files\nodejs\npm.cmd" run dev -- --host 127.0.0.1 --port 5173```diff --git a/docs/modules.md b/docs/modules.mdindex 98a69d0..44cca29 100644--- a/docs/modules.md+++ b/docs/modules.md@@ -25,7 +25,10 @@ layer; the backend remains the enforcement boundary.### Dashboard Flow-1. Open `http://localhost:8080/dashboard`.+1. For local development, run `ares dashboard dev` from the repository root+ and open `http://127.0.0.1:5173/dashboard/`. In production/static mode,+ FastAPI serves the built dashboard at `/dashboard` after frontend assets are+ built.2. Log in as an authorized operator.3. Go to `Campaigns`.4. Create or select a campaign.