Skip to content

Open-source personal finance manager. Self-hosted, privacy-first.

feat: auto-generate recurring transactions via Celery Beat

Tássio Noronha8440733831d3
diff --git a/backend/app/tasks/recurring_tasks.py b/backend/app/tasks/recurring_tasks.py
new file mode 100644
index 00000000..a69dac0a
--- /dev/null
+++ b/backend/app/tasks/recurring_tasks.py
@@ -0,0 +1,50 @@
+import asyncio
+import logging
+import uuid
+
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine, async_sessionmaker
+
+from app.worker import celery_app
+from app.core.config import get_settings
+from app.models.user import User
+from app.services import recurring_transaction_service
+
+logger = logging.getLogger(__name__)
+
+
+def _make_session_maker():
+ """Create a fresh engine+session for the Celery worker event loop."""
+ settings = get_settings()
+ engine = create_async_engine(settings.database_url)
+ return async_sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)
+
+
+async def _generate_all() -> int:
+ """Generate pending recurring transactions for all users."""
+ session_maker = _make_session_maker()
+ total = 0
+
+ async with session_maker() as session:
+ result = await session.execute(select(User.id))
+ user_ids = [row[0] for row in result.all()]
+
+ for user_id in user_ids:
+ try:
+ async with session_maker() as session:
+ count = await recurring_transaction_service.generate_pending(session, user_id)
+ if count:
+ logger.info("Generated %d recurring transactions for user %s", count, user_id)
+ total += count
+ except Exception:
+ logger.exception("Failed to generate recurring transactions for user %s", user_id)
+
+ return total
+
+
+@celery_app.task(name="app.tasks.recurring_tasks.generate_all_recurring")
+def generate_all_recurring() -> dict:
+ """Celery task: generate pending recurring transactions for all users."""
+ total = asyncio.run(_generate_all())
+ logger.info("Recurring generation complete: %d transactions created", total)
+ return {"generated": total}
diff --git a/backend/app/worker.py b/backend/app/worker.py
index 4a577006..c527783b 100644
--- a/backend/app/worker.py
+++ b/backend/app/worker.py
@@ -23,6 +23,10 @@ celery_app.conf.beat_schedule = {
"task": "app.tasks.sync_tasks.sync_all_connections",
"schedule": 60 * 60, # every hour; task itself skips connections synced < 4h ago
},
+ "generate-recurring-daily": {
+ "task": "app.tasks.recurring_tasks.generate_all_recurring",
+ "schedule": 60 * 60, # every hour; generate_pending is idempotent (advances next_occurrence)
+ },
}
-celery_app.conf.include = ["app.tasks.sync_tasks"]
+celery_app.conf.include = ["app.tasks.sync_tasks", "app.tasks.recurring_tasks"]