Production‑ready admin dashboard for the Escape platform.
Escape Dashboard is a modern, full‑featured administration interface built for production deployment. It provides researchers and analysts with a real‑time control centre to monitor, manage, and interact with the Escape data processing ecosystem.
- Real‑time monitoring – Live updates via Redis pub/sub, no page reloads required.
- Human‑in‑the‑loop (HITL) workflow – Review, accept, or reject AI‑generated proposals at every stage of the analysis.
- Multi‑project management – Create, switch, and archive research projects with full state persistence.
- Cascading recalculation – Change a category or merge concepts, and the system recalculates only the dependent components – no full rebuild needed.
- Full audit trail – Every theoretical decision is traceable back to the source quotation via foreign‑key chains.
- Responsive & accessible – Built with React and modern UI principles for a smooth experience on any device.
This dashboard is designed to run in production environments with:
- Containerised deployment – Docker Compose and Kubernetes‑ready configurations.
- Environment‑based configuration – All sensitive settings (API keys, database credentials) managed via environment variables.
- Structured logging & monitoring – Integrated with backend logging for easy debugging and performance tracking.
- Horizontal scaling – Stateless frontend can be scaled independently of the backend workers.
- Zero‑downtime updates – Rolling updates supported via the container orchestration layer.
| Layer | Technology |
|---|---|
| Frontend | React (TypeScript) |
| State Management | React Context + Hooks |
| Real‑time | Redis pub/sub |
| Backend API | FastAPI (Python) |
| Database | PostgreSQL |
| Task Queue | Celery + Redis |
| Containerisation | Docker + Docker Compose |
| Orchestration | (Optional) Kubernetes |
# Clone the repository
git clone https://github.com/diegopaucarv/escape_dashboard.git
cd escape_dashboard
# Install dependencies
npm install
# Set up environment variables (copy .env.example to .env)
cp .env.example .env
# Run in development mode
npm run dev
# Build for production
npm run build
# Start production server
npm start
Docker Deployment
bash
# Build and run with Docker Compose
docker-compose up -descape_dashboard/
├── app/ # Next.js/React application root
├── components/ # Reusable UI components
├── contexts/ # React Context providers (auth, projects, etc.)
├── data/ # Static data and configuration
├── docs/ # Documentation assets
└── public/ # Static assets
The dashboard communicates with the Escape backend (FastAPI) via REST APIs and receives real‑time updates through Redis pub/sub. It is designed to work seamlessly with the gt and reii processing pipelines.