Table of Contents

Migrations from TinyDB to MongoDB Atlas

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Migrations from TinyDB to MongoDB Atlas

Steps to include in migration:

Migration script should be created to migrate TinyDB json files to mongo
The mongo uri string is in environment variable MONGO_URI
Refactor from TinyDB should use a minimal set of changes
try to reuse function names
handle unit test with mongomock when possible
for integration tests run a local docker container
for end to end playwright tests, use a dedicated isolated test db (chore_db_e2e) - the connection string resides in .env.test. wipe test db between tests
keep in mind multi-worker gunicorn. do not initialize MongoClient globally at the module root level. Initialize MongoClient lazily within Flask's app factory or use Gunicorn’s post_fork hook
Make sure your migration script or application startup routine explicitly creates unique and secondary indexes on fields that are queried often
configure mongo to fail fast when developing:

client = MongoClient(
    os.getenv("MONGO_URI"),
    serverSelectionTimeoutMS=5000,  # 5-second timeout instead of 30s
    connectTimeoutMS=5000,          # 5-second connection handshake limit
    maxPoolSize=20                   # Prevents hitting Atlas free-tier limits
)