feat(account): S6 账号页重构 —— 列表关键列 + 详情页生命周期状态卡

S6 的展示层部分(数据模型部分见上一个提交)。目标:客服打开账号页要能一眼回答
「这账号能不能用、要不要我处理、账上还有多少」。

## 账号列表:加关键列 + 三个筛选

新增四列,**全部直接来自 `accounts` 行**(不 JOIN、不聚合 —— 列表是全站最热接口):

| 列 | 内容 |
| --- | --- |
| **CK** | 有无 CK / 正常 / 已失效 / 检测异常 + 最近检测时间 |
| **绑定** | 精/电/店 三个作用域各一个小标签(✓ / … / ✗ / ?) |
| **积分 / 鱼翅** | 两行小字 |

新增筛选:**CK 健康**、**角色绑定**(三个作用域任一命中即算)。
`AccountOut` 相应补齐 `has_cookie` / `ck_check_status` / `ck_checked_at` /
`points` / `gold_balance` / 三组绑定状态与标签。

## 账号详情页:生命周期主页

顶部新增**生命周期状态卡**,把之前散落的信息聚成一眼可读的几格:

- **生命周期状态**:状态标签 + 不参与自动化标记 + 变更时间与原因
- **CK**:有无 / 健康 / 最近检测时间
- **角色绑定**:精/电/店三格
- **账上还有多少**:积分 / 鱼翅 / 兑换余额
- **归属与标注**:分配客服(下拉)+ 标签(就地编辑)—— 之前详情页只能看不能改

业务台账补上**登录成功次数**与**最近登录**(`stats` 里本来就有,只是没展示)。
时间线已有分类筛选,生命周期操作入口(停用/归档/恢复/自动化)S3 已加。

## ⚠️ 顺带修掉一个静默 bug

`bind_payload()` 的字段名按**作用域名**拼成了 `elite_bind_status` / `peace_bind_status`,
而 schema 声明的是 `role_bind_status` / `xpd_bind_status`。Pydantic 默认
`extra='ignore'`,于是多出来的键**被静默丢弃**、声明过的字段保持默认值 ——
**接口永远返回 unknown 而不报任何错**(这正是它躲过前面几轮测试的原因)。

修法:前缀改为由**列名**推导(`SCOPE_PAYLOAD_PREFIX`),并在模块导入时自检
「载荷前缀 == 列名前缀」。另加两条用例:`bind_payload` 的键必须都被
`DouyuTaskAccountOut` / `AccountOut` 声明(这是能抓到这类错的那种用例)。

顺带发现我自己之前那条 payload 用例**把错误的前缀当成了预期**,一并修正。

## 自己踩的坑

详情页加客服列表时又把 `useEffect` 写在了早期 `return` 之后 ——
和本次会话前面修 `LoginTasksPage` 的是同一个错。eslint(`react-hooks/rules-of-hooks`)
当场抓住,已上移。**`tsc` 与 `vite build` 都不会报这个**。

另外:列表关键列那处编辑我曾以为已生效(脚本打印了成功),实际没落到文件里 ——
后面是靠「读回文件确认」和用例失败才发现。已改为每次都读回核对。

## 验证

- `TZ=Asia/Shanghai`:**497 passed / 6 skipped**(S6 前半 490 → +7)
- `TZ=UTC`(相关文件)通过;ruff 全绿;前端 build 通过、lint **0 errors**
- **真实开发库端到端**:列表与工作台接口都返回了真实值
  (`has_cookie=True` / `ck_check_status=valid` / `role_bind_label=未知`),
  修 bug 前这两处返回的是被丢弃后的默认值

未做:`bind_status` 旧列待 S8 drop;保留策略里「状态派生类查询」已可下探到 7 天档(待确认)。
This commit is contained in:
yml2213
2026-10-04 16:45:39 +08:00
parent a64380fbcc
commit 885a780bd3
10 changed files with 496 additions and 12 deletions
+41 -5
View File
@@ -113,17 +113,51 @@ class TestEnum(_Base):
acc = self.account()
binding.set_bind_status(acc, binding.SCOPE_ELITE, binding.BIND_BOUND)
payload = binding.bind_payload(acc)
assert payload["elite_bind_status"] == "bound"
assert payload["elite_bind_label"] == "已绑定"
assert payload["role_bind_status"] == "bound"
assert payload["role_bind_label"] == "已绑定"
assert payload["esports_bind_status"] == "unknown"
assert payload["peace_bind_label"] == "未知"
assert payload["xpd_bind_label"] == "未知"
assert set(payload) == {
f"{scope}_{suffix}"
f"{binding.SCOPE_PAYLOAD_PREFIX[scope]}_{suffix}"
for scope in binding.ALL_SCOPES
for suffix in ("bind_status", "bind_label")
}
class TestPayloadMatchesSchemas:
"""`bind_payload()` 的字段名必须与 API schema 声明的名字**逐字一致**。
这是被真实 bug 逼出来的:第一版按作用域名拼成了 `elite_bind_status` /
`peace_bind_status`,而 schema 声明的是 `role_bind_status` / `xpd_bind_status`。
Pydantic 拿到不认识的键会**静默用默认值**(或者在有 `**kwargs` 展开时直接报错),
表现是「接口永远返回 unknown」却没有任何报错。
"""
def test_keys_are_declared_by_schemas(self):
from web.backend.schemas import DouyuTaskAccountOut
payload = binding.bind_payload(Account())
declared = set(DouyuTaskAccountOut.model_fields)
missing = set(payload) - declared
assert not missing, f"bind_payload 产出了 schema 不认识的字段:{missing}"
def test_key_prefix_matches_column_name(self):
for scope, column in binding.SCOPE_COLUMNS.items():
prefix = binding.SCOPE_PAYLOAD_PREFIX[scope]
assert column == f"{prefix}_bind_status", (
f"{scope}: 列名 {column} 与载荷前缀 {prefix} 不一致"
)
def test_list_schema_declares_every_payload_field(self):
"""列表接口(AccountOut)也必须有这些字段,否则关键列会是空的。"""
from web.backend.schemas import AccountOut
payload = binding.bind_payload(Account())
declared = set(AccountOut.model_fields)
missing = set(payload) - declared
assert not missing, f"AccountOut 缺少绑定字段:{missing}"
class TestLegacyMapping:
"""只映射明确陈述绑定关系的取值,其余 unknown。"""
@@ -292,12 +326,14 @@ class TestNoFreeTextWriters:
root = Path(__file__).resolve().parents[1]
backend = root / "web" / "backend"
# ⚠️ 两个模式都**要求前面有个点**(属性赋值)。不带点会把关键字参数
# (`bind_status=bind_status,`)也算进来 —— 那是传参,不是写列。
patterns = (
re.compile(
r"\.(role_bind_status|esports_bind_status|xpd_bind_status)\s*=(?!=)"
),
# 旧的垃圾场列:任何人都不能再写
re.compile(r"\bbind_status\s*=(?!=)"),
re.compile(r"\.bind_status\s*=(?!=)"),
)
offenders: list[str] = []
for path in backend.rglob("*.py"):
+96
View File
@@ -711,3 +711,99 @@ class TestStatusWriteFunnel:
"请改用 sync_status() / set_manual_state()。违规点:\n"
+ "\n".join(offenders)
)
class TestListViewKeyColumns(_Base):
"""账号列表的「关键列」:客服要一眼看出「能不能用、要不要我处理」。
这些字段全部直接来自 `accounts` 行 —— 不能为了列表去 JOIN 或聚合
(列表是全站最热的接口之一)。
"""
def _items(self, **kwargs):
from web.backend.routers.accounts import list_accounts
return list_accounts(
assigned_only=False,
tag="",
has_cookie=False,
search="",
page=1,
page_size=50,
include_sensitive=False,
status=kwargs.get("status", ""),
ck_status=kwargs.get("ck_status", ""),
bind_status=kwargs.get("bind_status", ""),
db=self.session,
current=self.user,
)["items"]
def _item(self, username: str, **kwargs):
"""按用户名取自己那条 —— 库里会累积前面用例建的账号,不能假设顺序。"""
for item in self._items(**kwargs):
if item.username == username:
return item
raise AssertionError(f"列表里没有 {username}")
def test_item_carries_key_columns(self):
from web.backend.services.account_binding import (
BIND_BOUND,
SCOPE_ELITE,
set_bind_status,
)
account = self.make_account("key", cookie="ck", ck_check_status="valid")
account.points = 1234
account.gold_balance = 56
set_bind_status(account, SCOPE_ELITE, BIND_BOUND)
self.session.commit()
item = self._item("key")
assert item.has_cookie is True
assert item.ck_check_status == "valid"
assert item.points == 1234
assert item.gold_balance == 56
assert item.role_bind_status == BIND_BOUND
assert item.role_bind_label == "已绑定"
# 另外两个作用域没绑,但字段必须在(前端要显示「?」而不是崩)
assert item.esports_bind_status == "unknown"
assert item.xpd_bind_label == "未知"
def test_no_cookie_is_reported(self):
self.make_account("nocookie", cookie="")
assert self._item("nocookie").has_cookie is False
def test_filter_by_ck_status(self):
self.make_account("bad", cookie="ck", ck_check_status="invalid")
self.make_account("good", cookie="ck", ck_check_status="valid")
names = [i.username for i in self._items(ck_status="invalid")]
assert "bad" in names
assert "good" not in names
def test_filter_by_bind_status_matches_any_scope(self):
from web.backend.services.account_binding import (
BIND_BOUND,
BIND_UNBOUND,
SCOPE_ELITE,
SCOPE_PEACE,
set_bind_status,
)
elite_bound = self.make_account("elite-bound")
set_bind_status(elite_bound, SCOPE_ELITE, BIND_BOUND)
peace_unbound = self.make_account("peace-unbound")
set_bind_status(peace_unbound, SCOPE_PEACE, BIND_UNBOUND)
self.make_account("all-unknown")
self.session.commit()
bound = {i.username for i in self._items(bind_status=BIND_BOUND)}
assert "elite-bound" in bound
assert "peace-unbound" not in bound
unbound = {i.username for i in self._items(bind_status=BIND_UNBOUND)}
assert "peace-unbound" in unbound
assert "elite-bound" not in unbound
# unknown 会把没绑过的也算进来(默认值就是 unknown)
unknown = {i.username for i in self._items(bind_status="unknown")}
assert "all-unknown" in unknown