feat: recurring payout scheduler

Turns a contract into money moving. One permanent task ticks every five
minutes and settles whatever each active contract owes; the actual transfer
is a plain internal LNbits invoice on the employee's wallet, paid from the
source wallet.

services.py is split into a pure half and an effectful half on purpose.
Paydays are the part of payroll that is easy to get subtly wrong and
expensive to get wrong in production, so the schedule math has no DB, no
wallets and no clock of its own, and is covered by tests.

Decisions worth reviewing:

- The n-th payday is a function of start_date and n alone. Advancing a
  stored date would drift on every late tick and would pin a month-end
  contract to the 28th forever; anchoring means 31 Jan pays 28 Feb and then
  31 Mar. Tested both ways round.
- A failed period does not advance the contract's position, and a backlog
  halts at the first failure so paydays cannot settle out of order.
- The sat amount is derived exactly once, by create_invoice, and the value
  it returns is what gets recorded — never recomputed from amount x rate.
- Back-dated start dates skip rather than back-pay by default; a mistyped
  start date is far more likely than a genuine back-pay request. Explicit
  `backfill` opts in, and a single tick is capped at 12 periods either way.
- Per-contract asyncio lock, with the row re-read under it. Not needed by
  the scheduler alone, but off-cycle payout paths land mid-tick and
  double-paying is the worst thing this extension could do.

Known gap, addressed by the payout-ledger commit that follows: a failure is
retried indefinitely, once per tick, with nothing but a log line to show
for it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018jy52j9GRZ6XKa1Zt21LLj

__init__.py

@@ -1,7 +1,9 @@
+import asyncio
+
 from fastapi import APIRouter
+from loguru import logger
 
 from .crud import db
-from .views import payroll_generic_router
 from .views_api import payroll_api_router
 
 payroll_static_files = [
@@ -12,12 +14,33 @@ payroll_static_files = [
 ]
 
 payroll_ext: APIRouter = APIRouter(prefix="/payroll", tags=["payroll"])
-payroll_ext.include_router(payroll_generic_router)
 payroll_ext.include_router(payroll_api_router)
 
+scheduled_tasks: list[asyncio.Task] = []
+
+
+def payroll_stop():
+    for task in scheduled_tasks:
+        try:
+            task.cancel()
+        except Exception as ex:
+            logger.warning(ex)
+
+
+def payroll_start():
+    from lnbits.tasks import create_permanent_unique_task
+
+    from .tasks import scheduler_loop
+
+    scheduled_tasks.append(
+        create_permanent_unique_task("ext_payroll_scheduler", scheduler_loop)
+    )
+
 
 __all__ = [
     "db",
     "payroll_ext",
+    "payroll_start",
     "payroll_static_files",
+    "payroll_stop",
 ]