Add Admin control for fundamentals cutover

app/routers/admin.py

@@ -13,6 +13,7 @@ from app.schemas.admin import (
     AlertConfigUpdate,
     CreateUserRequest,
     DataCleanupRequest,
+    FundamentalsCutoverConfigUpdate,
     JobTriggerRequest,
     JobToggle,
     RecommendationConfigUpdate,
@@ -137,6 +138,27 @@ async def list_settings(
     )
 
 
+@router.get("/admin/settings/fundamentals-cutover", response_model=APIEnvelope)
+async def get_fundamentals_cutover_settings(
+    _admin: User = Depends(require_admin),
+    db: AsyncSession = Depends(get_db),
+):
+    config = await admin_service.get_fundamentals_cutover_config(db)
+    return APIEnvelope(status="success", data=config)
+
+
+@router.put("/admin/settings/fundamentals-cutover", response_model=APIEnvelope)
+async def update_fundamentals_cutover_settings(
+    body: FundamentalsCutoverConfigUpdate,
+    _admin: User = Depends(require_admin),
+    db: AsyncSession = Depends(get_db),
+):
+    config = await admin_service.update_fundamentals_cutover_config(
+        db, body.enabled
+    )
+    return APIEnvelope(status="success", data=config)
+
+
 @router.get("/admin/settings/recommendations", response_model=APIEnvelope)
 async def get_recommendation_settings(
     _admin: User = Depends(require_admin),

app/scheduler.py

@@ -826,6 +826,22 @@ async def collect_fundamentals() -> None:
                 _log_event(logging.INFO, "job_skipped", job=job_name, reason="disabled")
                 _runtime_finish(job_name, "skipped", processed=0, total=0, message="Disabled")
                 return
+            if await fundamental_data_refresh_service.is_enabled(db):
+                message = "SEC + Dolt fundamentals cutover is active"
+                _log_event(
+                    logging.INFO,
+                    "job_skipped",
+                    job=job_name,
+                    reason="sec_dolt_cutover_active",
+                )
+                _runtime_finish(
+                    job_name,
+                    "skipped",
+                    processed=0,
+                    total=0,
+                    message=message,
+                )
+                return
 
             symbols = await _get_fundamental_priority_tickers(db)
             if not symbols:

app/schemas/admin.py

@@ -73,6 +73,11 @@ class ActivationConfigUpdate(BaseModel):
     exclude_neutral: bool | None = None
 
 
+class FundamentalsCutoverConfigUpdate(BaseModel):
+    """Switch the legacy fundamentals cache from quota APIs to SEC/Dolt."""
+    enabled: bool
+
+
 class ScheduleConfigUpdate(BaseModel):
     """Cron schedule for the pipelines + fundamentals. Crons are 5-field
     (min hour dom month dow); timezone is an IANA name (e.g. America/New_York)."""

app/services/admin_service.py

@@ -17,7 +17,7 @@ from app.models.settings import SystemSetting
 from app.models.ticker import Ticker
 from app.models.trade_setup import TradeSetup
 from app.models.user import User
-from app.services import settings_store
+from app.services import fundamental_data_refresh_service, settings_store
 
 logger = logging.getLogger(__name__)
 
@@ -159,6 +159,28 @@ async def update_setting(db: AsyncSession, key: str, value: str) -> SystemSettin
     return setting
 
 
+# ---------------------------------------------------------------------------
+# Fundamentals source cutover
+# ---------------------------------------------------------------------------
+
+async def get_fundamentals_cutover_config(db: AsyncSession) -> dict[str, bool]:
+    """Return the explicit A5 cache-cutover switch (default off)."""
+    return {"enabled": await fundamental_data_refresh_service.is_enabled(db)}
+
+
+async def update_fundamentals_cutover_config(
+    db: AsyncSession, enabled: bool
+) -> dict[str, bool]:
+    """Activate or pause SEC/Dolt writes to the legacy fundamentals cache."""
+    await settings_store.upsert_setting(
+        db,
+        fundamental_data_refresh_service.ACTIVATION_KEY,
+        "true" if enabled else "false",
+    )
+    await db.commit()
+    return await get_fundamentals_cutover_config(db)
+
+
 # ---------------------------------------------------------------------------
 # Activation thresholds
 # ---------------------------------------------------------------------------