← Projects

C++ · Application

FactoryForge

Design warehouse routes and solve logistics puzzles with automated transport vehicles.

In development

The GitHub link follows after repository publication. The source ZIP contains the verified local snapshot. The Linux app was tested. Native Windows verification and public binary downloads are still pending.

Architecture and data flow

Data flow
  1. Qt editor and game view
  2. Document and SimulationService
  3. Qt-independent C++ core
  4. JSON repository and atomic project files

Fixed ticks separate game rules from rendering. Time-based cell and edge reservations prevent collisions. The bounded planner reports blocked vehicles and does not guarantee globally optimal fleet routing.

Code and evidence

Ten core tests, five application tests, Qt file/interface tests and five real puzzle-file runs passed. AddressSanitizer and UndefinedBehaviorSanitizer passed the four original test suites. All nine teaching examples compiled and ran. The documented 50-vehicle scenario delivered all 150 orders. Native Windows verification is still pending.

Licence: Apache-2.0 · Qt LGPL-3.0 · Source checked on 13.10.2026

Engineering work sample

Task and evidenced project revision

FactoryForge is a C++20/Qt logistics game with a map editor and deterministic transport simulation. The linked source revision documents the actual app. Tutorials 16 through 24 add independent teaching programs in the same technology area. The Order Lab capstone is an order manager, not a new version of the game.

Architecture decision

The game separates pathfinding and simulation rules from the Qt editor. Order Lab demonstrates this dependency direction for another task: widgets call an application service using a replaceable repository interface. An in-memory implementation enables isolated tests. The SQLite implementation is additionally tested with real files and transactions.

Failures with observable outcomes

An import first creates a preview. Only explicit confirmation replaces saved orders. Invalid files and SQL failures during the second insertion preserve existing data. If changes were saved after the preview, the app requires a fresh preview. Network examples check cancellation, deadlines and outdated replies.

Reproducible work sample

Tutorial 24 provides a complete ZIP containing a CMake project, German and English guides, an exercise solution and a verification entry point. The widget test creates an order, reopens the database and edits it. Additional workflows cover file import, a real local HTTP import and database rollback. The same flow can be demonstrated in the English-labelled interface and explained through the code during an interview.

Context and limits

Evidence covers the published teaching code on Linux with Qt 6.8.3. SQLite and network import belong to Order Lab and are not claimed FactoryForge app features. Its file format is separate from the game project format. Concurrent writing processes, power-loss durability and native Windows interaction have not been accepted. Source and tests enable technical review but do not replace personally explaining the decisions.

Open the capstone with source code and tests

Learn through tutorials