An open, full-stack educational simulation platform for teaching and exploring system thinking — built with FastAPI, PostgreSQL and React. Otvorená full-stack vzdelávacia simulačná platforma pre výučbu a skúmanie systémového myslenia — postavená na FastAPI, PostgreSQL a Reacte.
FlowSpace is a teaching tool that turns abstract system dynamics concepts into interactive visual simulations. Students work with generic system structures (archetypes), run simulations, progress through lessons and tasks, and see feedback loops in action. FlowSpace je učebný nástroj, ktorý pretvára abstraktné koncepty systémovej dynamiky do interaktívnych vizuálnych simulácií. Študenti pracujú so všeobecnými systémovými štruktúrami (archetypy), spúšťajú simulácie, postupujú cez lekcie a úlohy, a vidia spätnoväzbové slučky v akcii.
The project is born as a Bachelor thesis at Comenius University in Bratislava, and designed to be forkable, self-hostable and easy to extend. Projekt vznikol ako bakalárska práca na Univerzite Komenského v Bratislave a je navrhnutý tak, aby sa dal forkovať, self-hostovať a ľahko rozširovať.
Drag-and-drop canvas (React Flow) to wire stocks, flows and feedback loops without writing code. Drag-and-drop plátno (React Flow) na prepájanie zásob, tokov a spätných väzieb bez kódu.
Deterministic backend simulations with replayable runs, charts and history stored per user. Deterministické simulácie na backende s prehrávateľnými behmi, grafmi a históriou uloženou pre každého používateľa.
Structured learning path with guided tasks, automatic progress tracking and seeded content out of the box. Štrukturovaná cesta učenia s vedenými úlohami, automatickým sledovaním pokroku a prednastaveným obsahom.
JWT email/password login plus optional Google and GitHub providers — buttons auto-appear when keys are set. JWT prihlásenie emailom/heslom plus voliteľné Google a GitHub OAuth — tlačidlá sa zjavia automaticky podľa nastavených kľúčov.
One command brings up the API, database and frontend — consistent across macOS, Linux and Windows. Jeden príkaz spustí API, databázu a frontend — konzistentne na macOS, Linuxe aj Windows.
Clean three-layer architecture, documented env vars and Alembic migrations — fork it, remix it, use it in your own course. Čistá trojvrstvová architektúra, dokumentované env premenné a Alembic migrácie — forkni, remixuj, použi vo vlastnom kurze.
| LayerVrstva | TechnologiesTechnológie |
|---|---|
| FrontendFrontend | React 18, TypeScript, Vite 5, React Flow |
| BackendBackend | Python 3.13, FastAPI, SQLAlchemy 2, Alembic |
| DatabaseDatabáza | PostgreSQL 17 |
| RuntimeRuntime | Docker Engine 24+, Docker Compose v2 |
If you are setting up the project for the first time, follow the pages below in order. Ak projekt spúšťaš prvýkrát, prejdi si stránky nižšie v poradí.