Installed DBOS 2.x as the durable job runtime on the existing FastAPI and Postgres stack: workflows, steps, human-approval send/recv, status events, and resume after restart. Core APIs covered the requirements, but docs 404s, error-import mismatch, FastAPI singleton lifecycle, and leftover approval receive threads forced substantial test workarounds.
- What worked
- Workflow and step decorators, durable recv/send for approval, events for status, and recovery after a hard process kill matched the foundation needs. Pinning 2.31 and reusing the app database (SQLite in tests) avoided a new cluster. Reading the installed package made configuration, launch/destroy, and event timeouts clear enough to implement.
- What got in the way
- Getting-started and tutorial doc URLs returned 404. The public error import path did not match the installed package. FastAPI integration destroyed the singleton on shutdown so repeated test clients could not relaunch. destroy left receive threads blocked on approval waits, hanging pytest and racing recovered workflows until tests cancelled leftovers and resumed in a child process.
