feat(account): S3 生命周期状态收口 —— 6 状态状态机、唯一推导入口、停用/归档闭环

`status` 列从「空壳」变成可信状态:S1 建了列、S2 让账号独立,本提交让状态真正
反映账号处境,并把「哪些账号要人处理」变成可筛选的事实。

## 状态机(7 → 6 个状态)

`imported` / `active` / `invalid` / `manual` / `disabled` / `archived`

**砍掉 `relogin`**:它完全等价于 `invalid + relogin_next_at is not None`,
独立成状态就多出一个必须与 `relogin_next_at` 同步的字段 —— 正是要消灭的「双份真相」。

## 唯一推导入口(防「双份真相」)

新增 `services/account_lifecycle.py`:
- `derive_status(account)` —— **纯函数**,按 cookie / ck_check_status / relogin_*
  推导状态;人工态(disabled/archived)优先级最高,不被覆盖;
- `sync_status(db, account)` —— 推导 + 变了才写,**幂等**(没变则不写库、不发事件,
  否则巡检每轮都往时间线刷一条);
- `set_manual_state(db, account, state)` —— 停用/归档/`auto`(恢复自动推导);
- `on_login_success(db, account)` —— **「登录成功对账号意味着什么」只定义一次**:
  作废本轮重登退避痕迹 + 重算状态。于是**「待人工」的账号被人工登录救回来时状态
  会自动恢复**,而不是卡在 manual。
- `MANUAL_KINDS` 从 `jobs/ck_relogin.py` 挪到这里(service 不该反向依赖 job)。

**9 处底层判据写入点全部接线**:登录成功、CK 清除(单个/批量)、ck_health 巡检、
人工 CK 检测、工作台执行前检测、重登复检、重登结算(成功/失败退避)。

## 消费端:补上一个真缺口 + 删掉两处临时派生

- ⚠️ **缺口**:`ck_health` / `ck_relogin` / `count_pending_relogin` 此前只按底层判据
  选行,**没排除 disabled/archived** —— S2 提交里已标注,状态一上线就会变成
  「停用的账号照样被自动重登」。现已全部排除。
- `automation.manual_queue` 原本用 4 个条件自己拼「需要人工」,现在一句
  `status == 'manual'`。同一判据从「3 处各写一遍」收敛成「1 处推导」。

## 接口与前端

- `PUT /api/accounts/{id}/lifecycle`(disabled/archived/auto + 原因,写审计)
- `PUT /api/accounts/{id}/automation`(**接上死开关**:`auto_managed` 此前没有任何
  接口/前端能改,永远是默认 True)
- 新增权限点 `account:manage`(运营默认拥有)
- 列表支持 `?status=` 筛选;**归档默认不出现**(要看需显式筛选)
- `AccountOut` / 概览接口补 status / status_label / status_reason / auto_managed
- 前端:账号列表加「状态」列与状态筛选;详情页状态卡 + 停用/归档/恢复/自动化开关

## 两个自查出来的问题(都已修)

1. **幂等键反而丢事件**:状态事件一开始用 `status:{id}:{target}:{秒级时间戳}` 作
   `source_ref`,结果同一账号在同一秒内两次切到同一状态就撞唯一键,`emit` 静默吞掉
   —— **状态改了、时间线却少一条**,正是本模块要消灭的「悄悄不一致」。
   改为不传 `source_ref`:`sync_status` 本身已幂等,不存在重复写入路径。已加用例。
2. **迁移与运行时规则分叉**:迁移 0042 的状态回填 CASE 原本会写出已被砍掉的
   `relogin`,且判据与 `derive_status` 不一致(次数用尽的会回填成 invalid 而非 manual)。
   已改成逐字对应,并加一条用例**真跑那段 SQL 与纯函数逐条比对**(已验证:
   临时改回旧 CASE 该用例立刻红)。

## 验证

- `TZ=Asia/Shanghai`:**404 passed / 6 skipped**(S2 后 373 → 新增 31 条)
- 迁移链 3 passed;ruff check/format 全绿;前端 `tsc -b && vite build` 通过
- 真实开发库核对:落库状态分布 active 4 / imported 8,**与 derive_status 逐账号比对无漂移**
- 新增用例覆盖:derive 真值表(每状态入口 + 人工态优先)、sync 幂等、
  人工态切换、**全生命周期走查**(导入→登录→失效→重登→转人工→人工救回→清 CK→停用)、
  自动化排除 disabled/archived、列表状态筛选、接口

未做(后续阶段):S4 事件发射点补齐、S5 业务事实直发事件、S6 账号页重构。
This commit is contained in:
yml2213
2026-10-04 14:48:22 +08:00
parent 94eace50c1
commit 1a8710834a
19 changed files with 1389 additions and 76 deletions
+7 -1
View File
@@ -17,7 +17,7 @@ import type {
export const accountApi = {
list: (params?: { assigned_only?: boolean; tag?: string; has_cookie?: boolean; include_sensitive?: boolean }) =>
api.get<AccountItem[], AccountItem[]>('/accounts', { params }),
listPaged: (params: PageParams & { assigned_only?: boolean; tag?: string; has_cookie?: boolean; include_sensitive?: boolean }) =>
listPaged: (params: PageParams & { assigned_only?: boolean; tag?: string; has_cookie?: boolean; include_sensitive?: boolean; status?: string }) =>
api.get<PaginatedResponse<AccountItem>, PaginatedResponse<AccountItem>>('/accounts', { params }),
summary: () => api.get<BasicSummary, BasicSummary>('/accounts/summary'),
import: (text: string, tag?: string) =>
@@ -40,6 +40,12 @@ export const accountApi = {
api.delete<MessageDeletedResponse, MessageDeletedResponse>('/accounts/batch/delete', { params: { account_ids: account_ids.join(',') } }),
batchDeleteSelection: (data: AccountBulkSelection) =>
api.post<MessageDeletedResponse, MessageDeletedResponse>('/accounts/batch-delete', data),
// 生命周期:disabled / archived / auto(恢复自动推导)
setLifecycle: (id: number, status: string, reason = '') =>
api.put<MessageResponse, MessageResponse>(`/accounts/${id}/lifecycle`, { status, reason }),
// 自动化开关:false = 账号可用但自动化不碰它
setAutomation: (id: number, auto_managed: boolean) =>
api.put<MessageResponse, MessageResponse>(`/accounts/${id}/automation`, { auto_managed }),
// 详情页:状态卡 + 统计
overview: (id: number) => api.get<AccountOverview, AccountOverview>(`/accounts/${id}/overview`),
// 时间线(倒序分页),event_type 为空表示全部
+19 -1
View File
@@ -129,6 +129,12 @@ export interface AccountOverview {
assigned_to: number | null;
/** 导入时间 */
created_at: string | null;
/** 生命周期状态(2026-10-04 S3) */
status: AccountStatus | '';
status_label: string;
status_reason: string;
status_changed_at: string | null;
auto_managed: boolean;
points: number | null;
gold_balance: number | null;
exchange_balance: number | null;
@@ -141,7 +147,6 @@ export interface AccountOverview {
esports_bind_status: string;
esports_game_name: string;
esports_can_change_time: number | null;
auto_managed: boolean;
stats: AccountOverviewStats;
/** 开通时间来自事件表(上线后才开始记录,更早的不显示) */
opened_at: { elite: string | null; esports: string | null };
@@ -204,6 +209,14 @@ export interface UserInfo {
// ==================== Account ====================
export type AccountStatus =
| 'imported'
| 'active'
| 'invalid'
| 'manual'
| 'disabled'
| 'archived';
export interface AccountItem {
id: number;
username: string;
@@ -215,6 +228,11 @@ export interface AccountItem {
assigned_username: string | null;
remark: string;
created_at: string | null;
// 生命周期状态(2026-10-04 S3)
status: AccountStatus | '';
status_label: string;
status_reason: string;
auto_managed: boolean;
}
export interface AssignmentsSummary {
+79 -2
View File
@@ -1,7 +1,7 @@
import { useCallback, useEffect, useState } from 'react';
import { useNavigate, useParams } from 'react-router-dom';
import {
Button, Card, Descriptions, Empty, Select, Space, Spin, Statistic, Table, Tag, Tooltip, Typography,
Button, Card, Descriptions, Empty, Popconfirm, Select, Space, Spin, Statistic, Table, Tag, Tooltip, Typography,
} from 'antd';
import type { TableProps } from 'antd';
import {
@@ -34,6 +34,16 @@ const EVENT_STYLE: Record<string, { label: string; color: string }> = {
tag_changed: { label: '标签', color: 'default' },
};
/** 生命周期状态 → 展示色(与账号列表页保持一致,取值域见后端 account_lifecycle)。 */
const STATUS_TONES: Record<string, string> = {
imported: 'default',
active: 'green',
invalid: 'red',
manual: 'orange',
disabled: 'default',
archived: 'default',
};
function eventTag(type: string) {
const style = EVENT_STYLE[type] ?? { label: type, color: 'default' };
return <Tag color={style.color}>{style.label}</Tag>;
@@ -144,16 +154,74 @@ export default function AccountDetailPage() {
}
const stats = overview?.stats;
const status = overview?.status || '';
/** 人工切换生命周期状态:disabled / archived / auto(恢复自动推导)。 */
const handleLifecycle = async (next: 'disabled' | 'archived' | 'auto') => {
if (!accountId) return;
try {
await accountApi.setLifecycle(accountId, next);
message.success('状态已更新');
void loadOverview();
void loadEvents();
} catch (e: unknown) {
message.error(getErrorMessage(e));
}
};
const handleAutomation = async (autoManaged: boolean) => {
if (!accountId) return;
try {
await accountApi.setAutomation(accountId, autoManaged);
message.success(autoManaged ? '已恢复自动化' : '已设为不参与自动化');
void loadOverview();
} catch (e: unknown) {
message.error(getErrorMessage(e));
}
};
return (
<div style={{ padding: 4 }}>
<Space style={{ marginBottom: 12 }}>
<Space style={{ marginBottom: 12 }} wrap>
<Button icon={<ArrowLeftOutlined />} onClick={() => navigate('/accounts')}>
返回账号列表
</Button>
<Button icon={<ReloadOutlined />} onClick={() => { void loadOverview(); void loadEvents(); }}>
刷新
</Button>
{status === 'disabled' || status === 'archived' ? (
<Popconfirm
title="恢复这个账号?将按当前 CK 情况重新判定状态"
onConfirm={() => void handleLifecycle('auto')}
>
<Button>恢复</Button>
</Popconfirm>
) : (
<>
<Popconfirm
title="停用这个账号?停用后不再参与任何自动化"
onConfirm={() => void handleLifecycle('disabled')}
>
<Button danger>停用</Button>
</Popconfirm>
<Popconfirm
title="归档这个账号?默认列表将不再显示它"
onConfirm={() => void handleLifecycle('archived')}
>
<Button>归档</Button>
</Popconfirm>
</>
)}
{overview?.auto_managed === false ? (
<Button onClick={() => void handleAutomation(true)}>恢复自动化</Button>
) : (
<Popconfirm
title="设为不参与自动化?账号仍可用,只是巡检/重登不再碰它"
onConfirm={() => void handleAutomation(false)}
>
<Button>不参与自动化</Button>
</Popconfirm>
)}
</Space>
<Spin spinning={loading}>
@@ -161,6 +229,9 @@ export default function AccountDetailPage() {
title={
<Space>
<Title level={5} style={{ margin: 0 }}>{overview?.username || '—'}</Title>
<Tag color={STATUS_TONES[status] ?? 'default'}>
{overview?.status_label || '—'}
</Tag>
{overview?.tag && <Tag color="blue">{overview.tag}</Tag>}
{overview?.auto_managed === false && <Tag color="orange">不参与自动化</Tag>}
</Space>
@@ -177,6 +248,12 @@ export default function AccountDetailPage() {
</Descriptions.Item>
<Descriptions.Item label="绑定状态">{overview?.bind_status || '-'}</Descriptions.Item>
<Descriptions.Item label="备注">{overview?.remark || '-'}</Descriptions.Item>
<Descriptions.Item label="状态变更">
{formatTime(overview?.status_changed_at)}
{overview?.status_reason ? (
<Text type="secondary">({overview.status_reason})</Text>
) : null}
</Descriptions.Item>
</Descriptions>
<div style={{ display: 'flex', gap: 32, marginTop: 16, flexWrap: 'wrap' }}>
+54 -2
View File
@@ -19,6 +19,30 @@ const TAG_COLORS = [
'blue', 'green', 'cyan', 'geekblue', 'purple', 'orange', 'magenta', 'volcano',
];
/**
* 生命周期状态 → 展示色。
* 取值域见后端 `services/account_lifecycle.py`(6 个状态,不含 relogin ——
* 「退避中」是 invalid 的调度细节,不单独成状态)。
*/
const STATUS_TONES: Record<string, string> = {
imported: 'default',
active: 'green',
invalid: 'red',
manual: 'orange',
disabled: 'default',
archived: 'default',
};
/** 状态筛选项:与后端 ALL_STATES 保持一致。 */
const STATUS_OPTIONS = [
{ value: 'active', label: '正常' },
{ value: 'invalid', label: 'CK 失效' },
{ value: 'manual', label: '待人工' },
{ value: 'imported', label: '未登录' },
{ value: 'disabled', label: '已停用' },
{ value: 'archived', label: '已归档' },
];
export default function AccountsPage() {
const navigate = useNavigate();
// App.useApp() 的 modal 实例继承主题,静态 Modal.confirm 在暗色模式下是白底
@@ -32,6 +56,7 @@ export default function AccountsPage() {
const [importTag, setImportTag] = useState('');
const [importing, setImporting] = useState(false);
const [tagFilter, setTagFilter] = useState<string>('');
const [statusFilter, setStatusFilter] = useState<string>('');
const [searchText, setSearchText] = useState('');
const [selectedRowKeys, setSelectedRowKeys] = useState<React.Key[]>([]);
const [selectedAllMatching, setSelectedAllMatching] = useState(false);
@@ -57,8 +82,9 @@ export default function AccountsPage() {
const loadAccounts = useCallback(async () => {
setLoading(true);
try {
const params: { tag?: string } = {};
const params: { tag?: string; status?: string } = {};
if (tagFilter) params.tag = tagFilter;
if (statusFilter) params.status = statusFilter;
const data = await accountApi.listPaged({
...params,
page: currentPage,
@@ -73,7 +99,7 @@ export default function AccountsPage() {
} finally {
setLoading(false);
}
}, [canViewFull, currentPage, pageSize, searchText, sensitiveVisible, tagFilter]);
}, [canViewFull, currentPage, pageSize, searchText, sensitiveVisible, tagFilter, statusFilter]);
const loadSummary = useCallback(async () => {
try {
@@ -263,6 +289,20 @@ export default function AccountsPage() {
</Button>
),
},
{
title: '状态',
dataIndex: 'status',
width: 110,
render: (status: string, record: AccountItem) => {
const tone = STATUS_TONES[status] ?? 'default';
return (
<Space size={4}>
<Tag color={tone}>{record.status_label || status || '-'}</Tag>
{record.auto_managed === false && <Tag color="orange">不自动</Tag>}
</Space>
);
},
},
{
title: '标签',
dataIndex: 'tag',
@@ -358,6 +398,18 @@ export default function AccountsPage() {
options={tags.map((t) => ({ value: t, label: t }))}
prefix={<FilterOutlined />}
/>
<Select
allowClear
size="small"
placeholder="按状态筛选"
style={{ width: 130 }}
value={statusFilter || undefined}
onChange={(val) => {
setStatusFilter(val || '');
setCurrentPage(1);
}}
options={STATUS_OPTIONS}
/>
<Input.Search
allowClear
size="small"