docs(welfare): 15天不活跃清零金币/现金 设计文档(spec) (#144)

修改INACTIVITY_RESET_ENABLED语义，为false时清空金币操作只记录审计日志，不执行操作。

---------

Co-authored-by: guke <guke@autohome.com.cn>
Reviewed-on: #144

app/core/config.py

@@ -178,8 +178,10 @@ class Settings(BaseSettings):
     # 进程内自动兑换 worker 的检查间隔(秒):每隔这么久醒一次,跨过北京 0 点就跑一轮。
     # 默认 600s=10min,即 0 点后最多 10 分钟内兑完(客户端文案已注明「可能存在延迟」)。
     AUTO_EXCHANGE_CHECK_INTERVAL_SEC: int = 600
-    # === 15 天不活跃清零(app.core.inactivity_reset_worker)===
-    INACTIVITY_RESET_ENABLED: bool = False           # 总闸,默认关;灰度验证后再开
+    # === 15 天不活跃清零(app.core.inactivity_reset_worker,worker 常驻)===
+    # ENABLED 只决定是否**真清**:false(默认)= 只记审计名单、不动钱(dry-run,灰度看名单);
+    # true = 真清金币 + 折算现金(邀请金不清)。看准名单后再置 true。
+    INACTIVITY_RESET_ENABLED: bool = False
     INACTIVITY_RESET_DAYS: int = 15                  # 不活跃阈值(天),第 (N+1) 日 0 点清
     INACTIVITY_WARN_DAYS_BEFORE: str = "7,2"         # 清零前几天各推一次;""=不推。逗号分隔
     INACTIVITY_RESET_RUN_HOUR: int = 3               # 北京时间每日执行点(0-23)

app/core/inactivity_reset_worker.py

@@ -6,7 +6,8 @@
 健壮性:
 - **逐用户幂等**:清完余额=0 次日不再匹配;预警按 streak 去重。启动补跑 / 多次唤醒 / 重启都安全。
 - **同机多进程互斥**:文件锁保证多 worker 只有一个实际跑。
-- **开关**:settings.INACTIVITY_RESET_ENABLED=false 时不启动(默认关,灰度验证后再开)。
+- **常驻 + dry-run 默认**:worker 一直跑;INACTIVITY_RESET_ENABLED=false(默认)只记审计名单、
+  不动钱(dry-run 灰度看名单),=true 才真清。
 
 ⚠️ 这是不可逆批量资金操作(清空金币 + 折算现金,**邀请现金不清**)。口径见
 app.repositories.inactivity / app.repositories.activity。
@@ -87,6 +88,7 @@ def _run_once_entry() -> dict:
             reset_days=settings.INACTIVITY_RESET_DAYS,
             warn_stages=settings.inactivity_warn_stages,
             today=_cn_today(),
+            dry_run=not settings.INACTIVITY_RESET_ENABLED,  # ENABLED=false → 只记审计名单、不清
         )
 
 
@@ -102,9 +104,10 @@ async def _run_loop() -> None:
 
 async def _run_locked_loop(interval: int) -> None:
     logger.info(
-        "inactivity reset worker started interval=%ss run_hour=%s",
+        "inactivity reset worker started interval=%ss run_hour=%s mode=%s",
         interval,
         settings.INACTIVITY_RESET_RUN_HOUR,
+        "clear" if settings.INACTIVITY_RESET_ENABLED else "dry-run(audit-only)",
     )
     # 本进程上次跑过的北京日;None=尚未跑过本进程(当天到点即补)。
     last_run: date | None = None
@@ -129,9 +132,8 @@ async def _run_locked_loop(interval: int) -> None:
 
 
 def start_inactivity_reset_worker() -> asyncio.Task | None:
-    if not settings.INACTIVITY_RESET_ENABLED:
-        logger.info("inactivity reset disabled (INACTIVITY_RESET_ENABLED=false)")
-        return None
+    # worker 常驻(不再有"完全关"档);INACTIVITY_RESET_ENABLED 只决定是否**真清**:
+    # false(默认)= 只记审计名单(dry-run,不动钱),true = 真清金币+现金。
     return asyncio.create_task(_run_loop(), name="inactivity-reset")