How ismexar/flex-engine-smartems works
Flex Engine · SmartEMS is a React/Flask study tool for comparing renewable generation, batteries, grid supply and industrial-load flexibility. Users upload demand and resource data, configure process limits and study dates, choose technology scenarios, then run an optimization and inspect dispatch, KPIs, allocations and exports. The documented backend adapts uploaded files, queues work for an isolated worker, applies the preserved notebook engine and serves result views; the frontend guides configuration and requests those views. Some backend wiring and several frontend capabilities are documented but their implementation excerpts were not supplied.
Main entry points: pages Workflow screens · simulations.py Simulation endpoints · worker.py Simulation worker · result_service.py Result views and KPIs
Components 19
Study workflow
- Workflow screens
frontend/src/pages - Upload parsing
frontend/src/services/fileService.js - Workflow state
frontend/src/state/WorkflowContext.jsx - Scenario choices
frontend/src/data/scenarios.js - Simulation API client
frontend/src/services/simulationService.js
Simulation backend
- Simulation endpoints
backend/app/routes/simulations.py - Input adaptation
backend/app/services/input_service.py - Job coordination
backend/app/services/job_service.py - Simulation worker
backend/app/worker.py - Local study files
Model and results
- Optimization engine
backend/app/engine/notebook_engine.py - Result views and KPIs
backend/app/services/result_service.py - Notebook chart helpers
backend/app/engine/notebook_views.py - View cache
backend/app/services/view_cache.py
Results interface
- Results pages
frontend/src/pages/ResultsPage.jsx - Result view state
frontend/src/state/useResultData.js - Charts and tables
frontend/src/components/results/ResultPanels.jsx - KPI definitions
frontend/src/data/resultMetrics.js
Other components
- Study analyst
Connections 24
- Study analyst → Workflow screens: configures study
README.md - Workflow screens → Upload parsing: parses uploads
frontend/src/pages/InputDataPage.jsx - Workflow screens → Workflow state: updates state
frontend/src/state/WorkflowContext.jsx - Workflow screens → Scenario choices: selects scenarios
frontend/src/pages/ScenariosPage.jsx - Workflow screens → Simulation API client: starts run
frontend/src/pages/FlexibilityPage.jsx - Simulation API client → Simulation endpoints: sends requests
frontend/src/services/simulationService.js - Simulation endpoints → Input adaptation: adapts inputs
backend/app/routes/simulations.py - Simulation endpoints → Job coordination: coordinates jobs
- Job coordination → Simulation worker: dispatches work
backend/app/worker.py - Simulation worker → Input adaptation: prepares inputs
backend/app/worker.py - Simulation worker → Optimization engine: runs optimization
backend/app/worker.py - Simulation worker → Result views and KPIs: prepares results
backend/app/worker.py - Simulation worker → Local study files: stores artifacts
- Input adaptation → Optimization engine: validates config
backend/app/services/input_service.py - Result views and KPIs → Optimization engine: computes metrics
backend/app/services/result_service.py - Result views and KPIs → Notebook chart helpers: executes chart helpers
backend/app/services/result_service.py - Simulation endpoints → Result views and KPIs: serves result views
backend/app/routes/simulations.py - Simulation endpoints → View cache: uses view cache
backend/app/routes/simulations.py - View cache → Result views and KPIs: builds cached view
backend/app/services/view_cache.py - Results pages → Result view state: requests data
frontend/src/pages/ResultsPage.jsx - Result view state → Simulation API client: fetches view
frontend/src/state/useResultData.js - Result view state → Charts and tables: supplies results
frontend/src/pages/ResultsPage.jsx - Charts and tables → KPI definitions: renders KPIs
frontend/src/components/results/ResultPanels.jsx - Charts and tables → Study analyst: shows analysis
README.md