marco
4b98d405d7
- app_config 加 get/set_app_version(独立 key,复用表不进 CONFIG_DEFS) - GET /api/v1/platform/app-version 公开读 + POST /internal/app-version 内部写(X-Internal-Secret) - tests/test_app_version.py 5 端到端测试 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
94 lines
3.4 KiB
Python
94 lines
3.4 KiB
Python
"""运营配置读写。
|
|
|
|
get_value:业务读配置,DB 没有则 fallback 到 CONFIG_DEFS 默认(= 原 rewards 常量,空表行为不变)。
|
|
不缓存:配置读频率低(每次福利操作读一次,key 主键查极快),admin 改了立即生效、跨进程一致。
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from typing import Any
|
|
|
|
from sqlalchemy import select
|
|
from sqlalchemy.orm import Session
|
|
|
|
from app.core.config_schema import CONFIG_DEFS
|
|
from app.models.app_config import AppConfig
|
|
|
|
|
|
def get_value(db: Session, key: str) -> Any:
|
|
"""读配置值。DB 有用 DB,没有 fallback 到 CONFIG_DEFS 默认。未知 key 抛 KeyError。"""
|
|
row = db.get(AppConfig, key)
|
|
if row is not None:
|
|
return row.value
|
|
return CONFIG_DEFS[key]["default"]
|
|
|
|
|
|
def set_value(
|
|
db: Session, key: str, value: Any, *, admin_id: int, commit: bool = True
|
|
) -> AppConfig:
|
|
"""写配置(admin 用)。未知 key 抛 KeyError。commit=False 让调用方与审计同事务。"""
|
|
if key not in CONFIG_DEFS:
|
|
raise KeyError(f"unknown config key: {key}")
|
|
row = db.get(AppConfig, key)
|
|
if row is None:
|
|
row = AppConfig(key=key, value=value, updated_by_admin_id=admin_id)
|
|
db.add(row)
|
|
else:
|
|
row.value = value
|
|
row.updated_by_admin_id = admin_id
|
|
if commit:
|
|
db.commit()
|
|
db.refresh(row)
|
|
else:
|
|
db.flush()
|
|
return row
|
|
|
|
|
|
def list_all(db: Session) -> list[dict]:
|
|
"""所有可配项:default + 当前值(DB 有则用 DB) + 元信息。给 admin 配置页渲染。"""
|
|
overrides = {r.key: r for r in db.execute(select(AppConfig)).scalars().all()}
|
|
out: list[dict] = []
|
|
for key, defn in CONFIG_DEFS.items():
|
|
row = overrides.get(key)
|
|
out.append(
|
|
{
|
|
"key": key,
|
|
"label": defn["label"],
|
|
"group": defn["group"],
|
|
"type": defn["type"],
|
|
"help": defn.get("help"),
|
|
"default": defn["default"],
|
|
"value": row.value if row is not None else defn["default"],
|
|
"overridden": row is not None,
|
|
"updated_at": row.updated_at.isoformat() if row is not None else None,
|
|
}
|
|
)
|
|
return out
|
|
|
|
|
|
# ── 最新 App 版本(OTA 检查更新)──────────────────────────────────────────────
|
|
# 版本信息不是"运营可配置项",不进 CONFIG_DEFS:它由发布流程(发车)/应急整组写入、客户端读取做
|
|
# OTA,语义是"发布系统状态"而非"运营调参"。故走下面专用读写,直接操作 AppConfig 表(复用表不复用 repo)。
|
|
APP_VERSION_KEY = "latest_app_version"
|
|
|
|
|
|
def get_app_version(db: Session) -> dict | None:
|
|
"""读最新 App 版本信息(OTA)。无记录返回 None(客户端视为无更新)。"""
|
|
row = db.get(AppConfig, APP_VERSION_KEY)
|
|
return row.value if row is not None else None
|
|
|
|
|
|
def set_app_version(db: Session, data: dict, *, commit: bool = True) -> AppConfig:
|
|
"""整组原子覆盖最新版本信息(发布流程/应急写,非 admin,故 updated_by_admin_id 留空)。"""
|
|
row = db.get(AppConfig, APP_VERSION_KEY)
|
|
if row is None:
|
|
row = AppConfig(key=APP_VERSION_KEY, value=data, updated_by_admin_id=None)
|
|
db.add(row)
|
|
else:
|
|
row.value = data
|
|
if commit:
|
|
db.commit()
|
|
db.refresh(row)
|
|
else:
|
|
db.flush()
|
|
return row
|