feat(compare): 加电商比价透传路由

POST /api/v1/ecom/intent/recognize 和 /api/v1/ecom/step 透传到 pricebot-backend
的 /api/ecom/intent/recognize 和 /api/ecom/step。前端电商 mode 已经开放,
无这两条路由会 404;现在和外卖那两条对称。模块 docstring 改成「外卖+电商两套」。

alembic/versions/ef96beb47b1e_convert_savings_record_dishes_from_json_.py

@@ -1,36 +0,0 @@
-"""convert savings_record.dishes from json to jsonb
-
-PG only. SQLite 上 JSON/JSONB 都是 TEXT, 此迁移是 no-op。
-
-Revision ID: ef96beb47b1e
-Revises: c8d9e0f1a2b3
-Create Date: 2026-05-29 10:57:21.471774
-"""
-from typing import Sequence, Union
-
-from alembic import op
-from sqlalchemy.dialects.postgresql import JSONB
-
-
-revision: str = 'ef96beb47b1e'
-down_revision: Union[str, Sequence[str], None] = 'c8d9e0f1a2b3'
-branch_labels: Union[str, Sequence[str], None] = None
-depends_on: Union[str, Sequence[str], None] = None
-
-
-def upgrade() -> None:
-    if op.get_bind().dialect.name != "postgresql":
-        return
-    op.execute(
-        "ALTER TABLE savings_record "
-        "ALTER COLUMN dishes TYPE JSONB USING dishes::JSONB"
-    )
-
-
-def downgrade() -> None:
-    if op.get_bind().dialect.name != "postgresql":
-        return
-    op.execute(
-        "ALTER TABLE savings_record "
-        "ALTER COLUMN dishes TYPE JSON USING dishes::JSON"
-    )

alembic/versions/f01db5d77dac_merge_pg_jsonb_and_feedback_heads.py

@@ -1,26 +0,0 @@
-"""merge pg_jsonb and feedback heads
-
-Revision ID: f01db5d77dac
-Revises: ef96beb47b1e, d1e2f3a4b5c6
-Create Date: 2026-05-29 16:09:58.498935
-
-"""
-from typing import Sequence, Union
-
-from alembic import op
-import sqlalchemy as sa
-
-
-# revision identifiers, used by Alembic.
-revision: str = 'f01db5d77dac'
-down_revision: Union[str, Sequence[str], None] = ('ef96beb47b1e', 'd1e2f3a4b5c6')
-branch_labels: Union[str, Sequence[str], None] = None
-depends_on: Union[str, Sequence[str], None] = None
-
-
-def upgrade() -> None:
-    pass
-
-
-def downgrade() -> None:
-    pass

app/api/v1/ad.py

@@ -84,14 +84,12 @@ def pangle_callback(request: Request, db: DbSession) -> PangleCallbackOut:
 
 @router.get("/reward-status", response_model=AdRewardStatusOut, summary="今日看广告发奖进度")
 def reward_status(user: CurrentUser, db: DbSession) -> AdRewardStatusOut:
-    used, limit, coin_per, round_count, cooldown_until = crud_ad.today_status(db, user.id)
+    used, limit, coin_per = crud_ad.today_status(db, user.id)
     return AdRewardStatusOut(
         used_today=used,
         daily_limit=limit,
         remaining=max(0, limit - used),
         coin_per_ad=coin_per,
-        round_count=round_count,
-        cooldown_until=cooldown_until,
     )
 
 
@@ -120,7 +118,7 @@ def test_grant(user: CurrentUser, db: DbSession) -> TestGrantOut:
     except crud_ad.UnknownUserError as e:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="user not found") from e
 
-    used, limit, coin_per, round_count, cooldown_until = crud_ad.today_status(db, user.id)
+    used, limit, coin_per = crud_ad.today_status(db, user.id)
     logger.info("ad TEST grant user_id=%d status=%s coin=%d", user.id, rec.status, rec.coin)
     return TestGrantOut(
         granted=(rec.status == "granted"),
@@ -130,6 +128,4 @@ def test_grant(user: CurrentUser, db: DbSession) -> TestGrantOut:
         daily_limit=limit,
         remaining=max(0, limit - used),
         coin_per_ad=coin_per,
-        round_count=round_count,
-        cooldown_until=cooldown_until,
     )

app/api/v1/compare.py

@@ -1,17 +1,20 @@
-"""外卖比价业务透传端点。
+"""比价业务透传端点(外卖 + 电商两套)。
 
-把客户端的 POST /api/v1/intent/recognize 和 /api/v1/price/step 请求原样转发给
-pricebot-backend 的 /api/intent/recognize 和 /api/price/step。MVP 阶段**不鉴权**
-(同 coupon/step,见 docs/待办与技术债.md P1:device_id 透传区分设备,待补 JWT +
-device_id↔user_id 绑定后才能做用户级画像)。
+把客户端的 POST /api/v1/{intent/recognize, price/step, ecom/intent/recognize, ecom/step}
+请求原样转发给 pricebot-backend 的对应路径。MVP 阶段**不鉴权**(同 coupon/step,
+见 docs/待办与技术债.md P1:device_id 透传区分设备,待补 JWT + device_id↔user_id
+绑定后才能做用户级画像)。
 
+外卖(food):
 - Phase 1 /intent/recognize:从源平台(淘宝闪购/美团/京东外卖)购物车页识别店名+菜品+
   价格,一次性。
 - Phase 2 /price/step:多轮循环,在目标平台复现订单读到手价,直到 done。
 
+电商(ecom):
+- Phase 1 /ecom/intent/recognize:从源平台(淘宝/抖音/拼多多)SKU+详情页识别商品,一次性。
+- Phase 2 /ecom/step:多轮循环,在目标平台搜索商品并采价,直到 done。
+
 真正的目标驱动比价逻辑在 pricebot-backend(GoalEngine,另一个 repo),本接口只是透传壳。
-电商(ecom)那两个端点 food MVP 暂不需要,以后放开 scene 时再加 /ecom/intent/recognize
-和 /ecom/step 两行即可。
 
 pricebot 协议文档:
   pricebot-backend/docs/main/02_api_protocol.md
@@ -86,3 +89,13 @@ async def intent_recognize(request: Request) -> dict[str, Any]:
 @router.post("/price/step", summary="外卖比价 Phase 2 步进 (透传到 pricebot)")
 async def price_step(request: Request) -> dict[str, Any]:
     return await _passthrough(request, "/api/price/step")
+
+
+@router.post("/ecom/intent/recognize", summary="电商比价 Phase 1 意图识别 (透传到 pricebot)")
+async def ecom_intent_recognize(request: Request) -> dict[str, Any]:
+    return await _passthrough(request, "/api/ecom/intent/recognize")
+
+
+@router.post("/ecom/step", summary="电商比价 Phase 2 步进 (透传到 pricebot)")
+async def ecom_step(request: Request) -> dict[str, Any]:
+    return await _passthrough(request, "/api/ecom/step")

app/api/v1/meituan.py

@@ -9,7 +9,6 @@ from concurrent.futures import ThreadPoolExecutor, as_completed
 
 from fastapi import APIRouter, HTTPException
 
-from app.core.config import settings
 from app.integrations.meituan import MeituanCpsError, get_referral_link, query_coupon
 from app.schemas.meituan import (
     CouponCard,
@@ -28,8 +27,6 @@ router = APIRouter(prefix="/api/v1/meituan", tags=["meituan-cps"])
 
 @router.post("/coupons", response_model=CouponListResponse, summary="券列表(为您推荐)")
 def list_coupons(req: CouponListRequest) -> CouponListResponse:
-    if not settings.mt_cps_configured:
-        return CouponListResponse(items=[], has_next=False, search_id=None)
     logger.info("[coupons] lon=%.6f lat=%.6f topic=%s", req.longitude, req.latitude, req.list_topic_id)
     try:
         raw = query_coupon(
@@ -81,8 +78,6 @@ def _interleave(waimai: list[dict], daodian: list[dict]) -> list[CouponCard]:
 
 @router.post("/feed", response_model=FeedResponse, summary="混合feed(外卖+到店交叉, 无限流)")
 def feed(req: FeedRequest) -> FeedResponse:
-    if not settings.mt_cps_configured:
-        return FeedResponse(items=[], has_next=False, page=req.page)
     page_idx = req.page - 1
     lon, lat = req.longitude, req.latitude
     logger.info("[feed] page=%s lon=%.6f lat=%.6f", req.page, lon, lat)
@@ -113,8 +108,6 @@ def feed(req: FeedRequest) -> FeedResponse:
 
 @router.post("/referral-link", response_model=ReferralLinkResponse, summary="换取推广链接(点抢时调)")
 def referral_link(req: ReferralLinkRequest) -> ReferralLinkResponse:
-    if not settings.mt_cps_configured:
-        return ReferralLinkResponse(link="", link_map={})
     try:
         raw = get_referral_link(
             product_view_sign=req.product_view_sign,

app/core/config.py

@@ -53,18 +53,11 @@ class Settings(BaseSettings):
     SMS_SEND_INTERVAL_SEC: int = 60
 
     # ===== 美团联盟 CPS =====
-    # 未配置时所有 /api/v1/meituan/* 接口 200 返空(优雅降级),不影响登录/领券等其他业务。
     MT_CPS_APP_KEY: str = ""
     MT_CPS_APP_SECRET: str = ""
     MT_CPS_HOST: str = "https://media.meituan.com"
     MT_CPS_TIMEOUT_SEC: int = 15
     MT_CPS_DEFAULT_SID: str = "sgbjia"
-
-    @property
-    def mt_cps_configured(self) -> bool:
-        """美团 CPS 凭证齐全(缺则接口返空,而非 502)。"""
-        return bool(self.MT_CPS_APP_KEY and self.MT_CPS_APP_SECRET)
-
     # ===== 微信支付(商家转账到零钱 / 提现)=====
     # 真实凭证放 .env(已 gitignore),证书 .pem 放 secrets/。WECHAT_APP_ID 同时用于
     # 微信登录(code 换 openid)与转账,必须与 App 端开放平台 appid 一致。

app/core/rewards.py

@@ -59,22 +59,16 @@ TASK_REWARDS: dict[str, int] = {
 
 
 # ===== 看激励视频发金币(穿山甲 S2S 服务端回调发奖)=====
-# 看完一个激励视频发的金币(100 金币 ≈¥0.01,汇率 10000 金币=1 元)。
-# 作用:① 回调缺/坏 reward_amount 时的回退值;② 客户端进度接口展示的"单次预告金币";
-#       ③ test-grant 本地联调的发奖额。
+# 看完一个激励视频发的金币(≈¥0.01,汇率 10000 金币=1 元)。
+# 作用:① 回调缺/坏 reward_amount 时的回退值;② 客户端进度接口展示的"单次预告金币"。
 # 真实发放以穿山甲回调带回的 reward_amount 为准(见 resolve_ad_reward_coin),后台应把
-# 代码位"奖励数量"配成与本值一致(=100),保证"广告内展示 / 进度预告 / 实际到账"三者一致。
+# 代码位"奖励数量"配成与本值一致(如 100),保证"广告内展示 / 进度预告 / 实际到账"三者一致。
 AD_REWARD_COIN: int = 100
 # 单次发奖金币上限:夹紧穿山甲回调里异常的 reward_amount(如后台多打一个 0),防刷爆余额。
 MAX_AD_REWARD_COIN: int = 1000
 # 每用户每日发奖次数上限,防刷 + 控成本。
-# ⚠️ 测试阶段值=20:正式上线前按产品策略 + 广告 eCPM 实测收益重新核定,改这里即可。
-DAILY_AD_REWARD_LIMIT: int = 20
-# 一轮看 N 次激励视频,看完一轮强制 10 分钟冷却(reward-status 派生 cooldown_until 给客户端,
-# 客户端任务行 CTA 在冷却期间显示"MM:SS"且不可点)。冷却是 UX 约束,后端发奖只看 daily_limit,
-# 冷却期间穿山甲回调仍照常发奖,不另设拒发分支。
-VIDEO_ROUND_REQUIRED_COUNT: int = 3
-VIDEO_ROUND_COOLDOWN_SECONDS: int = 600
+# ⚠️ 占位值:正式上线前按产品策略 + 广告 eCPM 实测收益重新核定,改这里即可。
+DAILY_AD_REWARD_LIMIT: int = 10
 
 
 def resolve_ad_reward_coin(reward_amount: str | int | None) -> int:

app/db/session.py

@@ -27,25 +27,19 @@ def _ensure_sqlite_dir(url: str) -> None:
 
 _ensure_sqlite_dir(settings.DATABASE_URL)
 
-_is_sqlite = settings.DATABASE_URL.startswith("sqlite")
-
 # SQLite 跨线程访问要 check_same_thread=False;PG/MySQL 不需要这个参数
 _connect_args: dict = {}
-if _is_sqlite:
+if settings.DATABASE_URL.startswith("sqlite"):
     _connect_args["check_same_thread"] = False
 
-_engine_kwargs: dict = {
-    "connect_args": _connect_args,
+engine = create_engine(
+    settings.DATABASE_URL,
+    connect_args=_connect_args,
     # echo 在 dev 下打 SQL,生产关掉
-    "echo": settings.APP_DEBUG and not settings.is_prod,
-    "future": True,
-    "pool_pre_ping": True,
-}
-# SQLite 用单文件不需要池;PG/MySQL 必须显式池化 + recycle 防 idle 断连
-if not _is_sqlite:
-    _engine_kwargs.update(pool_size=10, max_overflow=20, pool_recycle=3600)
-
-engine = create_engine(settings.DATABASE_URL, **_engine_kwargs)
+    echo=settings.APP_DEBUG and not settings.is_prod,
+    future=True,
+    pool_pre_ping=True,
+)
 
 SessionLocal = sessionmaker(bind=engine, autocommit=False, autoflush=False, expire_on_commit=False)
 

app/models/savings.py

@@ -8,8 +8,7 @@ from __future__ import annotations
 
 from datetime import datetime
 
-from sqlalchemy import DateTime, ForeignKey, Integer, String, func
-from sqlalchemy.dialects.postgresql import JSONB
+from sqlalchemy import JSON, DateTime, ForeignKey, Integer, String, func
 from sqlalchemy.orm import Mapped, mapped_column
 
 from app.db.base import Base
@@ -29,8 +28,8 @@ class SavingsRecord(Base):
     title: Mapped[str | None] = mapped_column(String(128), nullable=True)
     # 店铺名(订单明细卡标题,如「窑鸡王（王府井店）」)
     shop_name: Mapped[str | None] = mapped_column(String(128), nullable=True)
-    # 菜品名列表(JSONB),PG 上可建 GIN 索引,前 2 道直接展示,其余收进「还有 N 道菜」展开。
-    dishes: Mapped[list[str]] = mapped_column(JSONB, nullable=False, default=list)
+    # 菜品名列表(JSON),前 2 道直接展示,其余收进「还有 N 道菜」展开。SQLite 存为 TEXT。
+    dishes: Mapped[list[str]] = mapped_column(JSON, nullable=False, default=list)
     # 来源:demo(演示) / compare(真实比价上报)
     source: Mapped[str] = mapped_column(String(16), nullable=False, default="compare")
 

app/repositories/ad_reward.py

@@ -10,19 +10,11 @@
 """
 from __future__ import annotations
 
-from datetime import datetime, timedelta, timezone
-
 from sqlalchemy import func, select
 from sqlalchemy.exc import IntegrityError
 from sqlalchemy.orm import Session
 
-from app.core.rewards import (
-    AD_REWARD_COIN,
-    DAILY_AD_REWARD_LIMIT,
-    VIDEO_ROUND_COOLDOWN_SECONDS,
-    VIDEO_ROUND_REQUIRED_COUNT,
-    cn_today,
-)
+from app.core.rewards import AD_REWARD_COIN, DAILY_AD_REWARD_LIMIT, cn_today
 from app.repositories import wallet as crud_wallet
 from app.models.ad_reward import AdRewardRecord
 from app.models.user import User
@@ -110,49 +102,7 @@ def _commit_record(db: Session, rec: AdRewardRecord, trans_id: str) -> AdRewardR
     return rec
 
 
-def _last_completed_round_end_at(
-    db: Session, user_id: int, reward_date: str, round_count: int
-) -> datetime | None:
-    """当日 granted 记录中**最近一个已完成轮**末尾那次的 created_at。
-
-    思路:把当日 granted 按时间倒序排,跳过当前未完成轮的 round_count 条,下一条
-    即"上一轮最后一次"。round_count==0 且 used>=N 时跳 0 条直接取最近一条。
-    used<N(还没完成第一轮)调用方应直接判 None,不进这里。
-    """
-    return db.execute(
-        select(AdRewardRecord.created_at)
-        .where(
-            AdRewardRecord.user_id == user_id,
-            AdRewardRecord.reward_date == reward_date,
-            AdRewardRecord.status == "granted",
-        )
-        .order_by(AdRewardRecord.created_at.desc())
-        .offset(round_count)
-        .limit(1)
-    ).scalar_one_or_none()
-
-
-def today_status(
-    db: Session, user_id: int
-) -> tuple[int, int, int, int, datetime | None]:
-    """客户端查"今日看广告发奖"进度。
-
-    返回 (今日已发次数, 每日上限, 单次金币, 本轮已看次数, 本轮冷却结束时间(UTC))。
-    - round_count = used % VIDEO_ROUND_REQUIRED_COUNT,展示用(0..N-1)
-    - cooldown_until 计算:取最近一个已完成轮末尾的 created_at + 10 min;若仍 > now 则返回,
-      否则返回 None。冷却 = UX 约束(客户端 CTA 倒计时不可点),后端发奖逻辑不受影响。
-    """
-    today = cn_today().isoformat()
-    used = _granted_today(db, user_id, today)
-    round_count = used % VIDEO_ROUND_REQUIRED_COUNT
-    cooldown_until: datetime | None = None
-    if used >= VIDEO_ROUND_REQUIRED_COUNT:
-        last_end = _last_completed_round_end_at(db, user_id, today, round_count)
-        if last_end is not None:
-            # SQLAlchemy 在 SQLite 上拿到的 created_at 可能是 naive,统一按 UTC 解读再比较
-            if last_end.tzinfo is None:
-                last_end = last_end.replace(tzinfo=timezone.utc)
-            cd_end = last_end + timedelta(seconds=VIDEO_ROUND_COOLDOWN_SECONDS)
-            if cd_end > datetime.now(timezone.utc):
-                cooldown_until = cd_end
-    return used, DAILY_AD_REWARD_LIMIT, AD_REWARD_COIN, round_count, cooldown_until
+def today_status(db: Session, user_id: int) -> tuple[int, int, int]:
+    """客户端查"今日看广告发奖"进度:返回 (今日已发次数, 每日上限, 单次金币)。"""
+    used = _granted_today(db, user_id, cn_today().isoformat())
+    return used, DAILY_AD_REWARD_LIMIT, AD_REWARD_COIN

app/schemas/ad.py

@@ -4,8 +4,6 @@
 """
 from __future__ import annotations
 
-from datetime import datetime
-
 from pydantic import BaseModel, Field
 
 
@@ -29,14 +27,6 @@ class AdRewardStatusOut(BaseModel):
     daily_limit: int = Field(..., description="每日发奖次数上限")
     remaining: int = Field(..., description="今日剩余可领次数")
     coin_per_ad: int = Field(..., description="看完一个激励视频发的金币")
-    round_count: int = Field(
-        ..., description="本轮(3 次一组)已看次数,0..N-1。客户端可由它判断'刚刚看完一轮'"
-    )
-    cooldown_until: datetime | None = Field(
-        None,
-        description="本轮看完后 10 分钟冷却结束时间(UTC ISO),null 表示不在冷却。"
-        "冷却是 UX 约束,后端发奖不受影响,客户端 CTA 据此显示 MM:SS 倒计时且不可点",
-    )
 
 
 class TestGrantOut(BaseModel):
@@ -49,7 +39,3 @@ class TestGrantOut(BaseModel):
     daily_limit: int = Field(..., description="每日发奖次数上限")
     remaining: int = Field(..., description="今日剩余可领次数")
     coin_per_ad: int = Field(..., description="看完一个激励视频发的金币")
-    round_count: int = Field(..., description="本轮已看次数,详见 AdRewardStatusOut")
-    cooldown_until: datetime | None = Field(
-        None, description="本轮冷却结束时间(UTC),详见 AdRewardStatusOut"
-    )

docs/api/ad-reward-status.md

@@ -14,15 +14,6 @@
 | `daily_limit` | int | 每日发奖次数上限 |
 | `remaining` | int | 今日剩余可领次数 |
 | `coin_per_ad` | int | 看完一个激励视频发的金币 |
-| `round_count` | int | 本轮(3 次一组)已看次数,0..N-1。客户端可据「拿到 round_count==0 && cooldown_until!=null」判定刚刚看完一轮 |
-| `cooldown_until` | datetime\|null | 本轮 10 分钟冷却结束时间(UTC ISO);null 表示不在冷却 |
 
 ## 说明
-福利页「看视频赚金币」用:
-- 展示「今日还能看 N 次」「看一次得 M 金币」(`remaining`/`coin_per_ad`)
-- 任务行 CTA 4 态推导:`adLoading` → Loading;`remaining==0` → Capped("明天再来");`cooldown_until` 在未来 → CoolingDown(显示 MM:SS 倒计时,不可点);否则 Normal("去赚取")
-- 弹窗 limit note:`used_today >= daily_limit` 显示「今日视频已到限额，明天再来」;`round_count==0 && cooldown_until!=null` 显示「本轮视频已看完，10分钟后再来」
-
-冷却派生算法:取当日 `status='granted'` 记录里**最近一个已完成轮**(每 N=3 条算一轮)末尾那次的 `created_at`,加 10 分钟。若仍 > now → 返回;否则返回 null。**冷却是 UX 约束**,后端发奖(`/api/v1/ad/pangle-callback`)只看 daily_limit,冷却期间穿山甲回调照常发奖。
-
-真正发奖走 [ad-pangle-callback](./ad-pangle-callback.md)(穿山甲 S2S)。
+福利页「看视频赚金币」用:展示「今日还能看 N 次」「看一次得 M 金币」。真正发奖走 [ad-pangle-callback](./ad-pangle-callback.md)（穿山甲 S2S）。

docs/postgres-migration.md

@@ -1,279 +0,0 @@
-# SQLite → PostgreSQL 迁移指南
-
-> 上线前把数据库从 SQLite 切到 PostgreSQL。本服务自始就为这一步预留了路径(`db/session.py` 的 dialect 特判 / `alembic/env.py` 的 batch mode 开关 / SQLAlchemy 2.0 + Alembic),代码改动很小。
->
-> **背景假设**:当前生产**无真实用户数据**(MVP 阶段),所以整个迁移本质是"切引擎",不涉及数据搬迁。如果将来已有真实数据,本文档不适用,需补充 `pgloader` 演练 + 钱表金额逐行核对 + 停服窗口 + 回滚预案。
->
-> 最后更新:2026-05-29
-
----
-
-## 0. 为什么切
-
-SQLite 三个硬伤决定它不能上线:
-
-- **并发写锁库**:整个文件一把锁,多请求并发写会排队,极易超时。当前 uvicorn `--workers 1` 勉强能跑,扩 worker 立刻撞墙。
-- **类型宽松**:整数列能塞字符串、`CHECK` 约束当装饰品。钱表(`wallet` / `withdraw_order` / `cash_transaction`)用 SQLite 等于裸奔。
-- **无 JSONB / 无并发索引 / 无分区**:PG 的核心能力一个都享受不到。`savings.dishes` 现在用 SQLite 的 `JSON`(实际存 TEXT),无索引、无操作符,纯展示用。
-
-PG 默认上 16 版(工具链最齐),驱动用 **psycopg3**(SQLAlchemy 2.0 时代默认,不要再装 psycopg2)。
-
----
-
-## 1. 本地起 PG + 跑通空库(半天)
-
-### 1.1 装 PG
-
-macOS:
-```bash
-brew install postgresql@16
-brew services start postgresql@16
-```
-
-Linux(Ubuntu/Debian):
-```bash
-sudo apt install postgresql-16
-sudo systemctl enable --now postgresql
-```
-
-### 1.2 建库 + 用户 + 授权
-
-```bash
-psql postgres <<'EOF'
-CREATE USER shaguabijia_app WITH PASSWORD 'change-me-strong-random';
-CREATE DATABASE shaguabijia OWNER shaguabijia_app ENCODING 'UTF8';
-GRANT ALL PRIVILEGES ON DATABASE shaguabijia TO shaguabijia_app;
-EOF
-```
-
-密码用 `python -c "import secrets; print(secrets.token_urlsafe(32))"` 生成,**不要复用 JWT_SECRET_KEY**。
-
-### 1.3 装驱动
-
-```bash
-pip install "psycopg[binary]>=3.1"
-```
-
-`psycopg[binary]` 是预编译版,免装 libpq 头文件。生产同款,无需源码编译版。
-
-### 1.4 改 `.env`
-
-```ini
-DATABASE_URL=postgresql+psycopg://shaguabijia_app:<password>@localhost:5432/shaguabijia
-```
-
-> ⚠️ URL scheme 必须是 `postgresql+psycopg://`(显式声明 psycopg3),不能写成 `postgresql://`——SQLAlchemy 默认会去找 psycopg2,装的不一致就报 ModuleNotFoundError。
-
-### 1.5 建表
-
-```bash
-alembic upgrade head
-```
-
-### 1.6 验证
-
-```bash
-psql -U shaguabijia_app -d shaguabijia -c "\dt"
-```
-
-应该列出全部 9 张表 + `alembic_version`:
-```
-user, coin_account, coin_transaction, cash_transaction,
-withdraw_order, signin_record, task_claim_record,
-savings_record, ad_reward_record, alembic_version
-```
-
-再手动 INSERT 一行 user,确认 `created_at` 默认值正常落:
-```sql
-INSERT INTO "user" (phone, register_channel, status) VALUES ('13800138000', 'sms', 'active');
-SELECT id, phone, created_at, last_login_at FROM "user";
-```
-
-`created_at` 应该是当前时间戳带时区,不是 NULL。`user` 表名是 PG 关键字,**必须用双引号**包裹。
-
----
-
-## 2. 测试套件全绿(1 小时)
-
-### 2.1 测试连 PG
-
-测试默认连 SQLite。临时让 `tests/conftest.py` 把 `DATABASE_URL` 也指到本地 PG(可以建个 `shaguabijia_test` 库专门跑测试,免得污染 dev 库)。
-
-```bash
-createdb -O shaguabijia_app shaguabijia_test
-DATABASE_URL=postgresql+psycopg://shaguabijia_app:xxx@localhost:5432/shaguabijia_test pytest
-```
-
-### 2.2 处理失败用例
-
-**所有红色测试都不能放过**——SQLite 类型/约束都很宽松,PG 严格起来暴露的就是真 bug。常见问题:
-
-- **字符串和整数比较**:SQLite 允许 `WHERE phone = 13800138000`(自动转字符串),PG 直接报错。改成 `:phone` 参数 + 类型严格
-- **timezone 处理**:SQLite 存 naive datetime,PG 的 `TIMESTAMPTZ` 必须带时区。检查所有 `datetime.utcnow()`,改成 `datetime.now(timezone.utc)`
-- **隐式 commit**:SQLite 某些情况下隐式 commit,PG 严格事务边界。如果某用例报 `current transaction is aborted`,说明业务代码缺 commit/rollback
-
-### 2.3 验证
-
-`pytest` 全绿,**且本地起 `./run.sh` 后用 Apifox 调通登录 / 美团 feed / 领券透传三个真接口**。
-
----
-
-## 3. 代码扫雷(1 天)
-
-### 3.1 必改清单
-
-| 文件 / 位置 | 改动 | 原因 |
-|---|---|---|
-| `app/models/savings.py` | `from sqlalchemy import JSON` → `from sqlalchemy.dialects.postgresql import JSONB`;`mapped_column(JSON, ...)` → `mapped_column(JSONB, ...)` | JSONB 在 PG 上有 GIN 索引和操作符支持,是 PG 核心优势之一。SQLite 上 `JSON` 实际是 TEXT,切到 PG 后用 `JSON` 类型存的是 `json` 不是 `jsonb`,查询/索引能力差一大截 |
-| `app/db/session.py` 的 `create_engine` 调用 | 增加连接池参数:`pool_size=10, max_overflow=20, pool_recycle=3600` | SQLite 单文件不需要池,PG 必须显式池化。`pool_recycle=3600` 防 PG 主动断开的 idle 连接 |
-| `alembic/versions/` 下旧迁移里的 `sa.text('(CURRENT_TIMESTAMP)')` | **不要改** | PG 能接受这个语法。改了反而搞乱迁移历史 + 让 alembic 觉得 schema drift。新写的迁移统一用 `sa.func.now()` |
-
-### 3.2 保留的 dialect 特判
-
-下面这些**保留原样**,它们的 SQLite 分支在 PG 下自动绕过、不影响新部署,但本地开发想用 SQLite 临时跑还能用:
-
-- `app/db/session.py` 里的 `_ensure_sqlite_dir` 和 `check_same_thread` 特判
-- `alembic/env.py` 里的 `render_as_batch` 特判
-
-### 3.3 顺便清掉
-
-`app/main.py` 启动日志里如果打 `DATABASE_URL`,确认密码不会进日志(只打 scheme + host,不打完整 URL)。
-
-### 3.4 验证
-
-本地 PG 起 `./run.sh`,跑一遍下面的烟测脚本:
-
-```bash
-# 登录
-curl -X POST http://localhost:8770/api/v1/auth/sms/send  -d '{"phone":"13800138000"}'
-curl -X POST http://localhost:8770/api/v1/auth/sms/login -d '{"phone":"13800138000","code":"123456"}'
-# 拿到 access_token 后调 me
-curl -H "Authorization: Bearer <token>" http://localhost:8770/api/v1/auth/me
-# 美团 feed
-curl -X POST http://localhost:8770/api/v1/meituan/feed -d '{"longitude":116.4,"latitude":39.9,"page":0}'
-```
-
-三条都 200 即通过。`psql` 看 `user` 表多了一条 `13800138000`。
-
----
-
-## 4. 生产切换(半小时,无需停服窗口)
-
-**前提**:生产无真实数据。如已有数据,本节不适用。
-
-### 4.1 装 PG
-
-```bash
-ssh server
-sudo apt install postgresql-16
-sudo systemctl enable --now postgresql
-```
-
-### 4.2 建库
-
-```bash
-sudo -u postgres psql <<'EOF'
-CREATE USER shaguabijia_app WITH PASSWORD '<strong-random-password>';
-CREATE DATABASE shaguabijia OWNER shaguabijia_app ENCODING 'UTF8';
-GRANT ALL PRIVILEGES ON DATABASE shaguabijia TO shaguabijia_app;
-EOF
-```
-
-生产密码**单独生成**,不要复用本地的。
-
-### 4.3 装驱动到生产 venv
-
-```bash
-cd /opt/shaguabijia-app-server
-.venv/bin/pip install "psycopg[binary]>=3.1"
-```
-
-### 4.4 改生产 `.env`
-
-```ini
-DATABASE_URL=postgresql+psycopg://shaguabijia_app:<password>@localhost:5432/shaguabijia
-```
-
-### 4.5 建表 + 重启
-
-```bash
-.venv/bin/alembic upgrade head
-sudo systemctl restart shaguabijia-app-server
-sudo journalctl -u shaguabijia-app-server -f
-```
-
-启动日志里看到 `Application startup complete` + 没有 5xx 即通过。
-
-### 4.6 验证
-
-- 用真账号(手机号)走一遍极光登录或短信登录
-- 调 `GET /api/v1/auth/me`,确认返回当前用户
-- 调 `POST /api/v1/meituan/feed`,确认券列表正常
-- `psql -U shaguabijia_app -d shaguabijia -c 'SELECT id, phone, created_at FROM "user"'` 看到刚登录的用户
-
-### 4.7 老 SQLite 文件归档
-
-```bash
-cd /opt/shaguabijia-app-server
-mv data/app.db data/app.db.legacy-$(date +%Y%m%d)
-```
-
-不要删——万一要回查测试期残留数据(开发期可能塞了一些手工记录),保留几个月。
-
----
-
-## 5. 兜底:切换失败如何回滚
-
-万一改完起不来:
-
-```bash
-# 1. .env 改回 SQLite
-sed -i 's|^DATABASE_URL=postgresql.*|DATABASE_URL=sqlite:///./data/app.db|' /opt/shaguabijia-app-server/.env
-
-# 2. 把归档的 sqlite 文件还原(如果已经改名)
-mv data/app.db.legacy-* data/app.db
-
-# 3. 重启
-sudo systemctl restart shaguabijia-app-server
-```
-
-由于 SQLite 文件没动过,无数据丢失,损失只是切换过程中的几分钟 5xx。
-
----
-
-## 6. 顺便建议:同时装上 Redis
-
-PG 上线后,Redis 是下一个明确要补的基础设施(已在 [待办与技术债.md](./待办与技术债.md) 里列了用途)。**建议本次维护窗口顺手把 Redis 也装上**,不开始用、只装服务,免得下次还要单独申请部署:
-
-```bash
-sudo apt install redis-server
-sudo systemctl enable --now redis-server
-# 改 /etc/redis/redis.conf:bind 127.0.0.1(只本机访问)+ requirepass <strong-password>
-sudo systemctl restart redis-server
-```
-
-下面三个用途等接的时候再写代码,**本次只装服务、不接代码**:
-
-| 用途 | 当前临时方案 | 何时必须接 Redis |
-|---|---|---|
-| 短信验证码冷却 | 进程内存 dict(`integrations/sms.py`) | `SMS_MOCK=false` 上线时 / 扩 worker 时 |
-| pricebot trace_id session | 进程内存 dict(在 pricebot-backend) | pricebot 扩 worker 时 |
-| JWT 黑名单(logout 真失效) | 当前 logout 占位无失效 | P1 鉴权改造时 |
-
----
-
-## 7. 后续优化(不阻塞上线,一周内补)
-
-- **每天凌晨 `pg_dump` 备份**:用 systemd timer 或 cron,保留 7 天。备份文件 `pg_dump -Fc shaguabijia > /backup/shaguabijia-$(date +%Y%m%d).dump`
-- **金钱表加 CHECK 约束**:新迁移给 `coin_account.balance`、`withdraw_order.amount_yuan_x100` 加 `CHECK (... >= 0)`。PG 严格执行,SQLite 形同虚设
-- **timezone 统一**:生产 PG 配 `timezone='Asia/Shanghai'` 或维持 `UTC`,**团队定一个**写进本文档,业务代码统一处理。当前模型混用 `func.now()`(server-side)和 `_utcnow()`(`models/user.py` 的 `last_login_at`,Python-side),后者依赖应用层时区,迁完 PG 后建议统一改 `func.now()`
-- **慢查询观察**:`shared_preload_libraries = 'pg_stat_statements'` 打开扩展,每周看一次 Top 10 慢查询,提前优化
-
----
-
-## 8. 不要做的事
-
-- ❌ 不要搞主从复制 / 读写分离——量级远没到,先用单实例
-- ❌ 不要装 PgBouncer / 连接池中间件——SQLAlchemy 自带池够用
-- ❌ 不要 squash 旧迁移文件——9 个增量保持原样,让 alembic 一次跑过空库
-- ❌ 不要在生产 PG 上裸跑测试套件——用单独的 `shaguabijia_test` 库

docs/数据库迁移.md

@@ -15,37 +15,20 @@ alembic upgrade head
 ---
 
 ## 1. 首次初始化（clone 后）
-
-### 1.1 用 PostgreSQL（推荐，与生产一致）
-前置:本机已装 PostgreSQL 16 + 知道 postgres 超级用户密码。
-
 ```bash
-# (1) 装依赖(在你的虚拟环境里, 含 psycopg)
+# (1) 装依赖(在你的虚拟环境里)
 pip install -e .
 
-# (2) 一键建用户 + 建库 + 写 .env + 跑迁移
-python scripts/init_postgres.py
-# 按提示输入 PG 超级用户密码即可。脚本会:
-#   - 自动建业务用户 shaguabijia_app + 业务库 shaguabijia
-#   - 自动生成业务用户强密码,写入 .env 的 DATABASE_URL
-#   - 跑完 alembic upgrade head
+# (2) 配 .env(从模板复制,至少填 JWT_SECRET_KEY)
+cp .env.example .env
 
-# (3) 启动
-./run.sh
-```
-
-可用环境变量提前指定(免交互):
-```bash
-PG_SUPER_PASS=xxx APP_DB_PASS=yyy python scripts/init_postgres.py
-```
-脚本幂等,重复跑会重置业务用户密码、跳过已存在的库。
-
-### 1.2 用 SQLite(本地开发临时用,不接生产链路时)
-```bash
-pip install -e .
-cp .env.example .env       # 不动 DATABASE_URL, 默认 sqlite:///./data/app.db
+# (3) SQLite 默认库需要 data/ 目录存在
 mkdir -p data
+
+# (4) 跑迁移建表 —— 关键
 alembic upgrade head
+
+# (5) 启动(run.sh 会自动重跑 3+4,所以平时直接 ./run.sh 也行)
 ./run.sh
 ```
 > 也可以直接 `bash scripts/migrate.sh` 只做迁移、不启服务（部署/CI 用）。

pyproject.toml

@@ -17,9 +17,6 @@ dependencies = [
     "sqlalchemy>=2.0.35",
     "alembic>=1.13.3",
 
-    # PostgreSQL 驱动 (psycopg3, SQLAlchemy 2.0 时代默认, 不要再装 psycopg2)
-    "psycopg[binary]>=3.1",
-
     # JWT 签名 / 校验
     "pyjwt[crypto]>=2.9.0",
 

scripts/init_postgres.py

@@ -1,189 +0,0 @@
-"""Bootstrap PostgreSQL: 建用户 + 建库 + 授权 + 写 .env + 跑迁移。
-
-新机器初始化用。前置:已装 PostgreSQL 16 + 知道 postgres 超级用户密码。
-
-用法:
-    python scripts/init_postgres.py
-
-环境变量(可选,不填会交互式问):
-    PG_HOST          PG 主机, 默认 localhost
-    PG_PORT          PG 端口, 默认 5432
-    PG_SUPER_USER    超级用户, 默认 postgres
-    PG_SUPER_PASS    超级用户密码 (不填会 getpass 交互输入)
-    APP_DB_NAME      业务库名, 默认 shaguabijia
-    APP_DB_USER      业务用户名, 默认 shaguabijia_app
-    APP_DB_PASS      业务用户密码 (不填会自动生成强密码)
-
-幂等:已存在的用户/库不会重复建,已配的 .env 会被覆盖前提示。
-"""
-from __future__ import annotations
-
-import getpass
-import os
-import secrets
-import subprocess
-import sys
-from pathlib import Path
-
-try:
-    import psycopg
-    from psycopg import sql
-except ImportError:
-    print("❌ 缺 psycopg。先跑: pip install -e .")
-    sys.exit(1)
-
-
-ROOT = Path(__file__).resolve().parent.parent
-ENV_FILE = ROOT / ".env"
-ENV_EXAMPLE = ROOT / ".env.example"
-
-
-def env_or_input(key: str, prompt: str, default: str = "", secret: bool = False) -> str:
-    val = os.environ.get(key, "").strip()
-    if val:
-        return val
-    if secret:
-        return getpass.getpass(f"{prompt}: ").strip()
-    suffix = f" [{default}]" if default else ""
-    raw = input(f"{prompt}{suffix}: ").strip()
-    return raw or default
-
-
-def ensure_role(conn: psycopg.Connection, user: str, password: str) -> None:
-    # 注意: CREATE/ALTER USER 不支持参数化密码, 必须用 sql.Literal 内联
-    with conn.cursor() as cur:
-        cur.execute("SELECT 1 FROM pg_roles WHERE rolname=%s", (user,))
-        if cur.fetchone():
-            print(f"  · 用户 {user} 已存在, 重置密码")
-            cur.execute(
-                sql.SQL("ALTER USER {} WITH PASSWORD {}").format(
-                    sql.Identifier(user), sql.Literal(password)
-                )
-            )
-        else:
-            print(f"  · 创建用户 {user}")
-            cur.execute(
-                sql.SQL("CREATE USER {} WITH PASSWORD {}").format(
-                    sql.Identifier(user), sql.Literal(password)
-                )
-            )
-
-
-def ensure_database(conn: psycopg.Connection, db: str, owner: str) -> None:
-    with conn.cursor() as cur:
-        cur.execute("SELECT 1 FROM pg_database WHERE datname=%s", (db,))
-        if cur.fetchone():
-            print(f"  · 数据库 {db} 已存在")
-            return
-        print(f"  · 创建数据库 {db} (owner={owner}, encoding=UTF8)")
-        cur.execute(
-            sql.SQL("CREATE DATABASE {} OWNER {} ENCODING 'UTF8'").format(
-                sql.Identifier(db), sql.Identifier(owner)
-            )
-        )
-
-
-def grant_all(conn: psycopg.Connection, db: str, user: str) -> None:
-    with conn.cursor() as cur:
-        cur.execute(
-            sql.SQL("GRANT ALL PRIVILEGES ON DATABASE {} TO {}").format(
-                sql.Identifier(db), sql.Identifier(user)
-            )
-        )
-
-
-def write_env(database_url: str) -> None:
-    if not ENV_FILE.exists():
-        if ENV_EXAMPLE.exists():
-            ENV_FILE.write_text(ENV_EXAMPLE.read_text(encoding="utf-8"), encoding="utf-8")
-            print(f"  · 从 .env.example 复制出 .env")
-        else:
-            ENV_FILE.write_text("", encoding="utf-8")
-
-    lines = ENV_FILE.read_text(encoding="utf-8").splitlines()
-    new_lines = []
-    replaced = False
-    for line in lines:
-        if line.startswith("DATABASE_URL="):
-            old_url = line.split("=", 1)[1]
-            if old_url.strip() and old_url.strip() != database_url:
-                ans = input(f"\n.env 里已有 DATABASE_URL=\n  {old_url}\n覆盖吗? [y/N]: ").strip().lower()
-                if ans != "y":
-                    print("  · 保留原 DATABASE_URL")
-                    new_lines.append(line)
-                    replaced = True
-                    continue
-            new_lines.append(f"DATABASE_URL={database_url}")
-            replaced = True
-        else:
-            new_lines.append(line)
-    if not replaced:
-        new_lines.append(f"DATABASE_URL={database_url}")
-
-    ENV_FILE.write_text("\n".join(new_lines) + "\n", encoding="utf-8")
-    print(f"  · 写入 .env -> DATABASE_URL")
-
-
-def run_alembic_upgrade() -> bool:
-    print("\n[3/3] 跑 alembic upgrade head")
-    try:
-        subprocess.run(
-            [sys.executable, "-m", "alembic", "upgrade", "head"],
-            cwd=ROOT,
-            check=True,
-        )
-        return True
-    except subprocess.CalledProcessError as e:
-        print(f"❌ alembic 失败: {e}")
-        return False
-
-
-def main() -> int:
-    print("=" * 60)
-    print("PostgreSQL 初始化脚本 — shaguabijia-app-server")
-    print("=" * 60)
-
-    host = env_or_input("PG_HOST", "PG host", "localhost")
-    port = env_or_input("PG_PORT", "PG port", "5432")
-    super_user = env_or_input("PG_SUPER_USER", "PG superuser", "postgres")
-    super_pass = env_or_input("PG_SUPER_PASS", "PG superuser password", secret=True)
-    db_name = env_or_input("APP_DB_NAME", "App database name", "shaguabijia")
-    db_user = env_or_input("APP_DB_USER", "App database user", "shaguabijia_app")
-    db_pass = os.environ.get("APP_DB_PASS", "").strip()
-    if not db_pass:
-        db_pass = secrets.token_urlsafe(32)
-        print(f"  · 自动生成业务用户密码: {db_pass}")
-
-    print(f"\n[1/3] 连接 PG (host={host}:{port}, user={super_user})")
-    try:
-        conn = psycopg.connect(
-            host=host, port=int(port), user=super_user, password=super_pass,
-            dbname="postgres", autocommit=True,
-        )
-    except psycopg.OperationalError as e:
-        print(f"❌ 连不上 PG: {e}")
-        print("   检查 1) PG 服务是否在跑 2) 超级用户密码是否正确 3) 端口防火墙是否放行")
-        return 1
-
-    print("\n[2/3] 建用户 + 建库 + 授权")
-    with conn:
-        ensure_role(conn, db_user, db_pass)
-        ensure_database(conn, db_name, db_user)
-        grant_all(conn, db_name, db_user)
-
-    database_url = f"postgresql+psycopg://{db_user}:{db_pass}@{host}:{port}/{db_name}"
-    write_env(database_url)
-
-    if not run_alembic_upgrade():
-        return 1
-
-    print("\n" + "=" * 60)
-    print("✅ 全部完成")
-    print(f"   DATABASE_URL = {database_url}")
-    print("   下一步: 启动服务 -> ./run.sh 或 uvicorn app.main:app --reload --port 8770")
-    print("=" * 60)
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

tests/test_ad_reward.py

@@ -9,15 +9,8 @@ from sqlalchemy import select
 
 from app.core.config import settings
 from app.integrations import pangle
-from app.core.rewards import (
-    AD_REWARD_COIN,
-    DAILY_AD_REWARD_LIMIT,
-    MAX_AD_REWARD_COIN,
-    VIDEO_ROUND_COOLDOWN_SECONDS,
-    VIDEO_ROUND_REQUIRED_COUNT,
-)
+from app.core.rewards import AD_REWARD_COIN, DAILY_AD_REWARD_LIMIT, MAX_AD_REWARD_COIN
 from app.db.session import SessionLocal
-from app.models.ad_reward import AdRewardRecord
 from app.models.user import User
 
 
@@ -155,81 +148,6 @@ def test_reward_status_requires_auth(client) -> None:
     assert r.status_code == 401
 
 
-def test_reward_status_initial_round_state(client) -> None:
-    """新用户没看广告 → round_count=0, cooldown_until=None。"""
-    phone = "13800003101"
-    token = _login(client, phone)
-    st = client.get("/api/v1/ad/reward-status", headers=_auth(token)).json()
-    assert st["used_today"] == 0
-    assert st["round_count"] == 0
-    assert st["cooldown_until"] is None
-
-
-def test_reward_status_mid_round(client) -> None:
-    """看 1 次(未到一轮)→ round_count=1, cooldown_until 仍 None。"""
-    phone = "13800003102"
-    token = _login(client, phone)
-    uid = _user_id(phone)
-    _callback(client, _signed(uid, "trans_mid_1"))
-    st = client.get("/api/v1/ad/reward-status", headers=_auth(token)).json()
-    assert st["used_today"] == 1
-    assert st["round_count"] == 1
-    assert st["cooldown_until"] is None
-
-
-def test_reward_status_round_complete_enters_cooldown(client) -> None:
-    """刚看完一轮 N 次 → round_count=0(下一轮起点) + cooldown_until 是未来 ~10 分钟。"""
-    from datetime import datetime, timezone
-
-    phone = "13800003103"
-    token = _login(client, phone)
-    uid = _user_id(phone)
-    for i in range(VIDEO_ROUND_REQUIRED_COUNT):
-        _callback(client, _signed(uid, f"trans_rc_{i}"))
-
-    st = client.get("/api/v1/ad/reward-status", headers=_auth(token)).json()
-    assert st["used_today"] == VIDEO_ROUND_REQUIRED_COUNT
-    assert st["round_count"] == 0
-    assert st["cooldown_until"] is not None
-    cd = datetime.fromisoformat(st["cooldown_until"].replace("Z", "+00:00"))
-    if cd.tzinfo is None:
-        cd = cd.replace(tzinfo=timezone.utc)
-    now = datetime.now(timezone.utc)
-    delta = (cd - now).total_seconds()
-    # 配置 600s,允许 ±30s 容差(本机 / CI 慢 IO)
-    assert 0 < delta <= VIDEO_ROUND_COOLDOWN_SECONDS + 30
-
-
-def test_reward_status_cooldown_expired(client) -> None:
-    """看完一轮后冷却已过(手动改 created_at 到 11 分钟前)→ cooldown_until 回到 None。"""
-    from datetime import datetime, timedelta, timezone
-    from sqlalchemy import select, update
-
-    phone = "13800003104"
-    token = _login(client, phone)
-    uid = _user_id(phone)
-    for i in range(VIDEO_ROUND_REQUIRED_COUNT):
-        _callback(client, _signed(uid, f"trans_exp_{i}"))
-
-    # 把当日所有 granted 记录的 created_at 推到 11 分钟前(覆盖冷却末尾那条)
-    db = SessionLocal()
-    try:
-        eleven_min_ago = datetime.now(timezone.utc) - timedelta(seconds=VIDEO_ROUND_COOLDOWN_SECONDS + 60)
-        db.execute(
-            update(AdRewardRecord)
-            .where(AdRewardRecord.user_id == uid)
-            .values(created_at=eleven_min_ago)
-        )
-        db.commit()
-    finally:
-        db.close()
-
-    st = client.get("/api/v1/ad/reward-status", headers=_auth(token)).json()
-    assert st["used_today"] == VIDEO_ROUND_REQUIRED_COUNT
-    assert st["round_count"] == 0
-    assert st["cooldown_until"] is None
-
-
 def test_callback_disabled_returns_503(client, monkeypatch) -> None:
     """未配置回调(开关关)时 → 503。"""
     monkeypatch.setattr(settings, "PANGLE_CALLBACK_ENABLED", False)