Files
quality_analyse/web/src/analysisMembersModel.ts
T
lyun ff7bbe3e46 同步:完善质量分析工作台并更新主题字体
同步已上线的智能分析执行协议、来源查询、图表报告与管理页面配套代码。
补齐数据库迁移、运行依赖和回归测试,保留原有指标计算口径。
统一午夜黑及其他主题的控件细节、中文和业务数字字体。
排除本地业务数据、凭据、预览、发布与验收产物。

验证:生产构建通过,320项前端回归通过;本轮仅同步Git,不再次部署。
2026-10-30 22:40:58 +08:00

104 lines
4.7 KiB
TypeScript

import { analysisPeriodLabel, parseAnalysisPeriod } from './analysisPeriodModel.ts';
import { sanitizeAnalysisDisplayText } from './analysisDisplayText.ts';
export type AnalysisMemberStage = 'black' | 'bright';
export type AnalysisMemberList = {
schemaVersion: 1;
releaseId: string;
period: { year: number; month?: number; quarter?: number; monthStart?: number; monthEnd?: number };
fields: { key: string; label: string }[];
rows: { values: Record<string, string | null>; stages: AnalysisMemberStage[] }[];
totalCount: number;
rowsReturned: number;
queryComplete: boolean;
};
export type MemberListReadState<T> = { data: T | null; error: string };
const isRecord = (value: unknown): value is Record<string, unknown> =>
Boolean(value) && typeof value === 'object' && !Array.isArray(value);
function count(value: unknown): value is number {
return Number.isSafeInteger(value) && Number(value) >= 0;
}
/** Reject malformed snapshot data before it reaches the table. Values stay plain strings. */
export function parseAnalysisMemberList(value: unknown): AnalysisMemberList | null {
if (!isRecord(value) || value.schemaVersion !== 1 || typeof value.releaseId !== 'string' || !value.releaseId.trim()) return null;
if (!isRecord(value.period)) return null;
const period = parseAnalysisPeriod(value.period, 1900, 2100);
if (!period?.year) return null;
if (!Array.isArray(value.fields) || value.fields.length < 1 || value.fields.length > 5 || !Array.isArray(value.rows) || value.rows.length > 4000 ||
!count(value.totalCount) || !count(value.rowsReturned) || value.rowsReturned > 4000 || value.rowsReturned > value.totalCount ||
value.rows.length !== value.rowsReturned || typeof value.queryComplete !== 'boolean' ||
value.queryComplete && value.rowsReturned !== value.totalCount) return null;
const fields: AnalysisMemberList['fields'] = [];
const fieldKeys = new Set<string>();
for (const field of value.fields) {
if (!isRecord(field) || typeof field.key !== 'string' || !field.key.trim() || typeof field.label !== 'string' || !field.label.trim() || fieldKeys.has(field.key)) return null;
fieldKeys.add(field.key);
fields.push({ key: field.key, label: field.label });
}
const rows: AnalysisMemberList['rows'] = [];
for (const row of value.rows) {
if (!isRecord(row) || !isRecord(row.values) || !Array.isArray(row.stages) || !row.stages.length || new Set(row.stages).size !== row.stages.length) return null;
const valueKeys = Object.keys(row.values);
if (valueKeys.length !== fieldKeys.size || valueKeys.some(key => !fieldKeys.has(key))) return null;
const values = Object.create(null) as Record<string, string | null>;
for (const [key, cell] of Object.entries(row.values)) {
if (cell !== null && typeof cell !== 'string') return null;
values[key] = cell;
}
if (!row.stages.every(stage => stage === 'black' || stage === 'bright')) return null;
rows.push({ values, stages: [...new Set(row.stages)] as AnalysisMemberStage[] });
}
return {
schemaVersion: 1,
releaseId: value.releaseId,
period: period as AnalysisMemberList['period'],
fields,
rows,
totalCount: value.totalCount,
rowsReturned: value.rowsReturned,
queryComplete: value.queryComplete,
};
}
export function analysisMemberListPeriod(period: AnalysisMemberList['period']): string {
return analysisPeriodLabel(period, 1900, 2100);
}
export function analysisMemberListFullyRead(list: AnalysisMemberList): boolean {
return list.queryComplete && list.rowsReturned >= list.totalCount;
}
export function analysisMemberListPage(list: AnalysisMemberList, page: number, pageSize: number) {
const size = Math.max(1, Math.trunc(pageSize));
const pageCount = Math.max(1, Math.ceil(list.rowsReturned / size));
const currentPage = Math.min(Math.max(1, Math.trunc(page)), pageCount);
const offset = (currentPage - 1) * size;
return { page: currentPage, pageSize: size, offset, pageCount, rows: list.rows.slice(offset, offset + size) };
}
/** A failed current snapshot authorization always returns an empty data slot. */
export async function authorizedMemberListRead<T>(
data: T,
authorize: () => Promise<unknown>,
onUnauthorized: (error: unknown) => boolean,
): Promise<MemberListReadState<T>> {
try {
await authorize();
return { data, error: '' };
} catch (error) {
const handled = onUnauthorized(error);
const detail = error instanceof Error
? sanitizeAnalysisDisplayText(error.message).replace(/\b[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}\b/gi, '[隐藏标识]').slice(0, 300)
: '';
return { data: null, error: handled ? '访问权限已更新,成员清单已清空。' : detail || '当前快照复核失败,成员清单已清空。' };
}
}