weaver-e10-builder 1.1.8 → 1.2.2

package/dist/services/report/forms.js

@@ -0,0 +1,237 @@
+/**
+ * 应用内定源（规则 B）。
+ *
+ * **只在当前应用里找表**：一上来拉全系统分组树/全库分页去找一张表，是纯粹的浪费；
+ * 用户给了应用上下文就在应用内解决。
+ *
+ * 硬规则：只有「准确表名 + 唯一精确命中」才允许自动绑定。
+ * 模糊命中、同名多条、未命中 —— 一律停下让用户指定，**禁止按关键词猜表、禁止建空壳试探**。
+ */
+import { EDC } from './http.js';
+/** 兼容三种列表信封：裸数组 / `data` 数组 / `data.list` / `data.records`。 */
+function rowsOf(j) {
+    if (Array.isArray(j))
+        return j;
+    if (Array.isArray(j?.data))
+        return j.data;
+    return j?.data?.list || j?.data?.records || [];
+}
+/** 列出应用内全部表单（一次请求，应用内检索已足够）。 */
+export async function listFormsInApp(http, appId) {
+    const j = await http.get(`${EDC.ebuilder.formList}/${appId}`, { apid: appId });
+    return rowsOf(j).map((r) => ({
+        id: String(r.id),
+        name: r.name || '',
+        tableName: r.tableName || r.table_name || '',
+    }));
+}
+/** 关键词打分：完全相等 100 / 包含 40 / 被包含 20。 */
+export function scoreForm(form, keywords) {
+    const name = String(form.name || '');
+    const lower = name.toLowerCase();
+    let score = 0;
+    const hits = [];
+    for (const raw of keywords) {
+        const kw = String(raw || '').trim();
+        if (!kw)
+            continue;
+        if (name === kw) {
+            score += 100;
+            hits.push(kw);
+        }
+        else if (name.includes(kw) || lower.includes(kw.toLowerCase())) {
+            score += 40;
+            hits.push(kw);
+        }
+        else if (kw.includes(name) && name.length >= 2) {
+            score += 20;
+            hits.push(kw);
+        }
+    }
+    return { ...form, score, hits };
+}
+/** 未指定准确表名：应用内检索候选，强制二次确认。 */
+export async function suggestFormsInApp(http, appId, keywords, opts = {}) {
+    const topN = opts.topN ?? 8;
+    const forms = await listFormsInApp(http, appId);
+    const kws = (Array.isArray(keywords) ? keywords : String(keywords || '').split(/[,，\s]+/)).filter(Boolean);
+    let ranked;
+    if (!kws.length) {
+        ranked = forms.map((f) => ({ ...f, score: 0, hits: [] }));
+    }
+    else {
+        ranked = forms
+            .map((f) => scoreForm(f, kws))
+            .filter((f) => f.score > 0)
+            .sort((a, b) => b.score - a.score || a.name.localeCompare(b.name, 'zh'));
+        if (!ranked.length)
+            ranked = forms.map((f) => ({ ...f, score: 0, hits: [] })).slice(0, topN);
+    }
+    return {
+        id: '',
+        name: '',
+        match: kws.length ? 'suggest' : 'list',
+        needConfirm: true,
+        autoBind: false,
+        appFormCount: forms.length,
+        keywords: kws,
+        message: '未指定准确表名或仅模糊匹配：已在当前应用检索。请展示候选并让用户确认后再绑定，禁止静默绑定。',
+        candidates: ranked.slice(0, topN).map((f) => ({ id: f.id, name: f.name, score: f.score })),
+    };
+}
+/**
+ * 精确查找表单。
+ *
+ * 返回 `match` 取值：`exact`(唯一精确，可自动绑定) / `exact-ambiguous`(同名多条) /
+ * `fuzzy`(含 1 条) / `fuzzy-multi` / `none`。后四者 `needConfirm: true`。
+ */
+export async function findFormInApp(http, appId, formName) {
+    if (!appId)
+        throw new Error('appId 必填 —— 不允许脱离应用上下文去扫全系统');
+    const forms = await listFormsInApp(http, appId);
+    if (!formName || !String(formName).trim())
+        return suggestFormsInApp(http, appId, []);
+    const exactHits = forms.filter((r) => r.name === formName);
+    if (exactHits.length === 1) {
+        return {
+            id: String(exactHits[0].id),
+            name: exactHits[0].name,
+            match: 'exact',
+            needConfirm: false,
+            autoBind: true,
+            appFormCount: forms.length,
+            message: '准确表名唯一命中，可绑定。',
+        };
+    }
+    if (exactHits.length > 1) {
+        return {
+            id: '',
+            name: '',
+            match: 'exact-ambiguous',
+            needConfirm: true,
+            autoBind: false,
+            appFormCount: forms.length,
+            message: '同名多条，必须让用户确认用哪一张。',
+            candidates: exactHits.map((r) => ({ id: r.id, name: r.name, score: 100 })),
+        };
+    }
+    const fuzzy = forms.filter((r) => String(r.name || '').includes(formName) || formName.includes(String(r.name || '')));
+    if (fuzzy.length === 1) {
+        return {
+            id: String(fuzzy[0].id),
+            name: fuzzy[0].name,
+            match: 'fuzzy',
+            needConfirm: true,
+            autoBind: false,
+            appFormCount: forms.length,
+            message: '模糊命中 1 条：须让用户确认后再绑定。',
+            candidates: [{ id: fuzzy[0].id, name: fuzzy[0].name, score: 40 }],
+        };
+    }
+    if (fuzzy.length > 1) {
+        return {
+            id: '',
+            name: '',
+            match: 'fuzzy-multi',
+            needConfirm: true,
+            autoBind: false,
+            appFormCount: forms.length,
+            message: '模糊命中多条：展示候选，等用户确认。',
+            candidates: fuzzy.slice(0, 10).map((r) => ({ id: r.id, name: r.name, score: 40 })),
+        };
+    }
+    return {
+        id: '',
+        name: '',
+        match: 'none',
+        needConfirm: true,
+        autoBind: false,
+        appFormCount: forms.length,
+        message: '应用内未命中。请让用户给出准确表名或 sourceId。',
+        candidates: [],
+    };
+}
+/**
+ * 建表前的定源门禁（规则 B）。
+ *
+ * 触发「必须让用户指定表」的两种情况：
+ *   1. 需求**没指明具体表**；
+ *   2. 应用内检索**不是完全精准匹配**（模糊 / 多条 / 未命中）。
+ * 两种情况都**不建表**，把候选交出去。
+ */
+export async function resolveFormWithPrompt(http, appId, formName, opts = {}) {
+    const ask = (reason, message, candidates, confirmPrompt) => ({
+        ok: false,
+        needConfirm: true,
+        candidates: candidates || [],
+        exitCode: 3,
+        reason,
+        message,
+        confirmPrompt,
+    });
+    const raw = String(formName == null ? '' : formName).trim();
+    const confirmedId = opts.confirmedSourceId || opts.sourceId;
+    if (!raw && !confirmedId) {
+        const sug = await suggestFormsInApp(http, appId, opts.keywords || '');
+        return ask('form_unspecified', '需求未指明具体表：请从候选中指定表单后再搭建（不按关键词猜表、不先建空壳试探）。', sug.candidates, '请用户从 candidates 中指定一张表（提供表名或 sourceId）。');
+    }
+    // 已确认的 sourceId 直接用，不再检索
+    if (confirmedId && /^\d{15,}$/.test(String(confirmedId))) {
+        return {
+            ok: true,
+            needConfirm: false,
+            candidates: [],
+            form: { id: String(confirmedId), name: raw || String(confirmedId), match: 'confirmed' },
+            exitCode: 0,
+            reason: 'confirmed',
+            message: '使用已确认的 sourceId',
+        };
+    }
+    // formName 本身就是 id
+    if (/^\d{15,}$/.test(raw)) {
+        return {
+            ok: true,
+            needConfirm: false,
+            candidates: [],
+            form: { id: raw, name: raw, match: 'id' },
+            exitCode: 0,
+            reason: 'id',
+            message: 'form 为 sourceId',
+        };
+    }
+    if (opts.suggestOnly) {
+        const sug = await suggestFormsInApp(http, appId, opts.keywords || raw);
+        return ask('form_unspecified', '需求未指明具体表：请从候选中指定表单后再搭建。', sug.candidates, '请用户从 candidates 中指定一张表。');
+    }
+    const r = await findFormInApp(http, appId, raw);
+    // 用户已确认模糊表名 → 放行
+    if (opts.formConfirmed && r.id) {
+        return {
+            ok: true,
+            needConfirm: false,
+            candidates: [],
+            form: { id: String(r.id), name: r.name || raw, match: r.match },
+            exitCode: 0,
+            reason: r.match || 'confirmed',
+            message: '用户已确认表单，继续搭建',
+        };
+    }
+    if (r.needConfirm && !r.autoBind) {
+        const notFound = !r.match || r.match === 'none';
+        return ask(notFound ? 'form_not_found' : 'form_fuzzy_match', notFound
+            ? `应用内未找到与「${raw}」匹配的表：请让用户从候选或全量表单中指定。`
+            : `「${raw}」不是完全精准匹配（match=${r.match}）：请用户确认要哪一张表。`, r.candidates || [], r.candidates && r.candidates.length
+            ? '请用户从 candidates 中指定一张表（提供表名或 sourceId），再带 --form-confirmed 复跑。'
+            : '请用户提供准确表名或 sourceId。');
+    }
+    return {
+        ok: true,
+        needConfirm: false,
+        candidates: [],
+        form: { id: String(r.id), name: r.name || raw, match: r.match },
+        exitCode: 0,
+        reason: r.match || 'exact',
+        message: r.message || '表单已精确命中/已确认',
+    };
+}
+//# sourceMappingURL=forms.js.map

package/dist/services/report/forms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.js","sourceRoot":"","sources":["../../../src/services/report/forms.ts"],"names":[],"mappings":"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"}

package/dist/services/report/guard.d.ts

@@ -0,0 +1,73 @@
+import type { ReportHttp } from './http.js';
+import type { ValidationResult } from './validate.js';
+/** workbook 里**禁止**出现的键 —— 存在即 `saveReportDevInfo` 500。 */
+export declare const FORBIDDEN_WORKBOOK_KEYS: string[];
+/**
+ * 雪花 ID 断言。
+ *
+ * `Number()` 会把 19 位 id 截断，写回去就指向不存在的记录 → 设计区空白。
+ * 这是本项目最隐蔽的一类故障，所以这里对「是 number」和「等于截断值」两种形态都报错。
+ */
+export declare function assertSnowflakeId(value: unknown, label: string, expectReportId?: string): ValidationResult;
+/** 默认快照名：`{报表名}-{date}-{time}`（占位符交给平台运行时替换）。 */
+export declare function defaultSnapshotName(reportName: unknown): string;
+export interface SnapshotConfig {
+    enableSnapshot: boolean;
+    cron: string;
+    snapshotName: string;
+    params: string;
+    sheetId: string;
+    id?: string;
+    jobId?: string;
+}
+/** 构造 `workbook.snapshot` 配置，保留已有 id/jobId（就地更新而不是新建任务）。 */
+export declare function buildSnapshotConfig(reportId: string, reportName: string | undefined, existing: any, opts?: {
+    cron?: string;
+    snapshotName?: string;
+}): SnapshotConfig;
+/** 校验快照补丁（`sheetId` 必须是 String 且等于 reportId）。 */
+export declare function validateSnapshotPatch(snapshot: any, reportId: string, reportName?: string): ValidationResult & {
+    normalized: SnapshotConfig | null;
+};
+/** `showLocation` 只允许 1（居左）/ 2（居中）；0 会被前端当缺失，导致设计区空白。 */
+export declare function validateShowLocation(loc: unknown): ValidationResult & {
+    normalized: number;
+};
+/** 滑动分页开了却没给内容字段 → 设计器异常。 */
+export declare function validateScrollPage(split: any): ValidationResult;
+/** 网格线：只写 `sheetProps`/`pageSetting` 的 `gridLine`（0|1），workbook 里写就 500。 */
+export declare function validateSheetPropGridLine(path: string, value: unknown): ValidationResult & {
+    normalized: number;
+};
+/** workbook 里出现 gridline 族键 → 报错。 */
+export declare function validateWorkbookGridline(workbook: any): ValidationResult;
+export interface CellLimitReport {
+    reportId: string;
+    appId: string;
+    cellLimit: number;
+    designedColumns: number;
+    fieldCells: number;
+    expandedColumns: number;
+    expandedColumnsSource: string;
+    rows: number | null;
+    rowsSource: string;
+    estimatedCells: number | null;
+    ratioToLimit: number | null;
+    safeRowsForTheseCols: number | null;
+    verdict: 'unknown' | 'over_limit' | 'safe';
+    advice: string[];
+}
+/**
+ * 渲染规模预检：只做算术，不渲染。
+ *
+ * 平台全量渲染超过 5 万格必然 code:555，而且会白烧几十秒。
+ * 但**搭报表本身不需要渲染** —— 落库成功、字段绑定正确就算交付完成。
+ */
+export declare function checkCellLimit(http: ReportHttp, reportId: string, appId: string, opts?: {
+    rows?: number;
+    cols?: number;
+    dateValues?: number;
+    blockWidth?: number;
+    fields?: any[];
+}): Promise<CellLimitReport>;
+//# sourceMappingURL=guard.d.ts.map

package/dist/services/report/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/services/report/guard.ts"],"names":[],"mappings":"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"}

package/dist/services/report/guard.js

@@ -0,0 +1,262 @@
+/**
+ * 设计区「空白/异常」防线。
+ *
+ * 这几项的共同点：写进去时**不报错**，但用户打开设计器看到的是一片空白或布局错乱，
+ * 而且很难反推是哪一步写坏的。所以全部前置拦截。
+ */
+import { RENDER_CELL_LIMIT, RENDER_PAGE_ROW_CAP } from './constants.js';
+import { listDatasets, previewDataset } from './dataset.js';
+function result() {
+    return { ok: true, errors: [], warnings: [], infos: [] };
+}
+function err(r, message) {
+    r.errors.push({ level: 'error', message });
+    r.ok = false;
+}
+function warn(r, message) {
+    r.warnings.push({ level: 'warning', message });
+}
+/** workbook 里**禁止**出现的键 —— 存在即 `saveReportDevInfo` 500。 */
+export const FORBIDDEN_WORKBOOK_KEYS = ['gridline', 'gridLine', '__gridline'];
+const MAX_SAFE = Number.MAX_SAFE_INTEGER;
+/**
+ * 雪花 ID 断言。
+ *
+ * `Number()` 会把 19 位 id 截断，写回去就指向不存在的记录 → 设计区空白。
+ * 这是本项目最隐蔽的一类故障，所以这里对「是 number」和「等于截断值」两种形态都报错。
+ */
+export function assertSnowflakeId(value, label, expectReportId) {
+    const r = result();
+    if (value == null || value === '') {
+        err(r, `${label} 为空`);
+        return r;
+    }
+    if (typeof value === 'number') {
+        err(r, `${label} 是 number（${value}）：雪花 ID 禁止 Number()，会截断导致设计区空白。必须 String(...)`);
+        return r;
+    }
+    const s = String(value);
+    if (!/^\d{15,}$/.test(s))
+        warn(r, `${label}=${s} 不像雪花 ID`);
+    if (expectReportId) {
+        if (s !== expectReportId) {
+            if (s === String(Number(expectReportId))) {
+                err(r, `${label}=${s} 等于 reportId 被 Number() 截断后的值，与真实 reportId=${expectReportId} 不符 → 会导致设计区空白`);
+            }
+            else {
+                err(r, `${label}=${s} 与 reportId=${expectReportId} 不一致`);
+            }
+        }
+    }
+    if (Number(s) > MAX_SAFE && String(Number(s)) !== s) {
+        warn(r, `${label} 超过安全整数范围：写入时必须保持字符串，不要 Number()`);
+    }
+    return r;
+}
+/** 默认快照名：`{报表名}-{date}-{time}`（占位符交给平台运行时替换）。 */
+export function defaultSnapshotName(reportName) {
+    const name = String(reportName || '报表').replace(/[\r\n]/g, '').trim() || '报表';
+    return `${name}-{date}-{time}`;
+}
+/** 构造 `workbook.snapshot` 配置，保留已有 id/jobId（就地更新而不是新建任务）。 */
+export function buildSnapshotConfig(reportId, reportName, existing, opts = {}) {
+    const cfg = {
+        enableSnapshot: true,
+        cron: opts.cron || '0 0 0 * * ?',
+        snapshotName: String(opts.snapshotName || '').trim() || defaultSnapshotName(reportName),
+        params: existing?.params || JSON.stringify({ searchCondition: {} }),
+        sheetId: String(reportId),
+    };
+    if (existing?.enableSnapshot && existing?.deleteType === 0) {
+        if (existing.id != null)
+            cfg.id = String(existing.id);
+        if (existing.jobId != null)
+            cfg.jobId = String(existing.jobId);
+    }
+    return cfg;
+}
+/** 校验快照补丁（`sheetId` 必须是 String 且等于 reportId）。 */
+export function validateSnapshotPatch(snapshot, reportId, reportName) {
+    const r = result();
+    if (!snapshot?.enableSnapshot)
+        return { ...r, normalized: null };
+    const sheet = assertSnowflakeId(snapshot.sheetId, 'snapshot.sheetId', reportId);
+    Object.assign(r, { errors: [...r.errors, ...sheet.errors], warnings: [...r.warnings, ...sheet.warnings] });
+    if (!sheet.ok)
+        r.ok = false;
+    if (snapshot.id != null) {
+        const idChk = assertSnowflakeId(snapshot.id, 'snapshot.id');
+        Object.assign(r, { errors: [...r.errors, ...idChk.errors], warnings: [...r.warnings, ...idChk.warnings] });
+        if (!idChk.ok)
+            r.ok = false;
+    }
+    if (snapshot.jobId != null) {
+        const jChk = assertSnowflakeId(snapshot.jobId, 'snapshot.jobId');
+        Object.assign(r, { errors: [...r.errors, ...jChk.errors], warnings: [...r.warnings, ...jChk.warnings] });
+        if (!jChk.ok)
+            r.ok = false;
+    }
+    if (!String(snapshot.snapshotName || '').trim()) {
+        warn(r, `未指定 snapshotName，已规范为默认：${defaultSnapshotName(reportName)}`);
+    }
+    return {
+        ...r,
+        normalized: {
+            ...snapshot,
+            enableSnapshot: true,
+            snapshotName: String(snapshot.snapshotName || '').trim() || defaultSnapshotName(reportName),
+            sheetId: String(reportId || snapshot.sheetId),
+            cron: snapshot.cron || '',
+        },
+    };
+}
+/** `showLocation` 只允许 1（居左）/ 2（居中）；0 会被前端当缺失，导致设计区空白。 */
+export function validateShowLocation(loc) {
+    const r = result();
+    if (loc == null || loc === '')
+        return { ...r, normalized: 2 };
+    const n = Number(loc);
+    if (n === 0) {
+        err(r, 'showLocation=0 禁止（会导致设计区空白/布局异常）；须为 1（居左）或 2（居中）');
+        return { ...r, normalized: 2 };
+    }
+    if (n !== 1 && n !== 2) {
+        err(r, `showLocation=${loc} 非法；仅允许 1 或 2`);
+        return { ...r, normalized: 2 };
+    }
+    return { ...r, normalized: n };
+}
+/** 滑动分页开了却没给内容字段 → 设计器异常。 */
+export function validateScrollPage(split) {
+    const r = result();
+    if (String(split?.scrollPage) !== '1')
+        return r;
+    const f = split?.scrollContentField;
+    const empty = f == null || f === '' || (Array.isArray(f) && !f.length);
+    if (empty) {
+        err(r, 'scrollPage=1 但 scrollContentField 为空：落库后设计器会异常。请补内容字段或设 scrollPage=0');
+    }
+    return r;
+}
+/** 网格线：只写 `sheetProps`/`pageSetting` 的 `gridLine`（0|1），workbook 里写就 500。 */
+export function validateSheetPropGridLine(path, value) {
+    const r = result();
+    if (value == null || value === '')
+        return { ...r, normalized: 0 };
+    if (typeof value === 'object') {
+        err(r, `${path} 禁止对象/数组。仅允许 0 或 1`);
+        return { ...r, normalized: 0 };
+    }
+    if (typeof value === 'boolean') {
+        warn(r, `${path} 为布尔值，已规范为 ${value ? 1 : 0}；请写 0|1`);
+        return { ...r, normalized: value ? 1 : 0 };
+    }
+    const s = String(value);
+    if (/^[01]$/.test(s)) {
+        if (s !== String(value))
+            warn(r, `${path} 为字符串 "${s}"，已规范为 ${Number(s)}`);
+        return { ...r, normalized: Number(s) };
+    }
+    err(r, `${path}=${value} 非法：仅允许 0 或 1`);
+    return { ...r, normalized: 0 };
+}
+/** workbook 里出现 gridline 族键 → 报错。 */
+export function validateWorkbookGridline(workbook) {
+    const r = result();
+    for (const [sheetName, sheet] of Object.entries(workbook?.sheets || {})) {
+        for (const k of FORBIDDEN_WORKBOOK_KEYS) {
+            if (sheet && Object.prototype.hasOwnProperty.call(sheet, k)) {
+                err(r, `workbook.sheets.${sheetName}.${k} 禁止出现：` +
+                    'saveReportDevInfo 会因此 500「报表内部错误」。网格线只写在 sheetProps / pageSetting 上。');
+            }
+        }
+    }
+    return r;
+}
+/**
+ * 渲染规模预检：只做算术，不渲染。
+ *
+ * 平台全量渲染超过 5 万格必然 code:555，而且会白烧几十秒。
+ * 但**搭报表本身不需要渲染** —— 落库成功、字段绑定正确就算交付完成。
+ */
+export async function checkCellLimit(http, reportId, appId, opts = {}) {
+    const fields = opts.fields || [];
+    const maxY = fields.reduce((m, f) => Math.max(m, Number(f.y) || 0), 0);
+    const designedColumns = maxY + 1;
+    const fieldCells = fields.filter((f) => f.cellType === 'Field').length;
+    const blockWidth = opts.blockWidth ?? 3;
+    let expandedColumns = designedColumns;
+    let expandedColumnsSource = '设计期列数';
+    if (opts.dateValues != null) {
+        expandedColumns = Math.max(0, designedColumns - blockWidth) + opts.dateValues * blockWidth;
+        expandedColumnsSource = `按日期展开 ${opts.dateValues} 个值 × ${blockWidth} 列`;
+    }
+    else if (opts.cols != null) {
+        expandedColumns = opts.cols;
+        expandedColumnsSource = '显式 --cols';
+    }
+    let rows = opts.rows ?? null;
+    let rowsSource = opts.rows != null ? '显式 --rows' : '';
+    if (rows == null) {
+        try {
+            const dsList = await listDatasets(http, reportId, appId);
+            const first = dsList.find((d) => d.id);
+            if (first) {
+                const p = await previewDataset(http, first.id);
+                for (const k of ['total', 'totalCount', 'records', 'totalNum', 'count']) {
+                    const n = Number(p?.[k]);
+                    // 空表 / 取不到总数都按"未知"处理 —— 用 0 会算出「安全 0 格」这种没意义的结论
+                    if (Number.isFinite(n) && n > 0) {
+                        rows = n;
+                        rowsSource = `数据集 ${first.id} 预览 total`;
+                        break;
+                    }
+                }
+            }
+        }
+        catch {
+            /* 取不到就不判定 */
+        }
+    }
+    const advice = [];
+    let verdict = 'unknown';
+    let estimatedCells = null;
+    let ratioToLimit = null;
+    let safeRowsForTheseCols = null;
+    if (rows != null && expandedColumns > 0) {
+        estimatedCells = rows * expandedColumns;
+        ratioToLimit = Number((estimatedCells / RENDER_CELL_LIMIT).toFixed(2));
+        safeRowsForTheseCols = Math.floor(RENDER_CELL_LIMIT / expandedColumns);
+        if (estimatedCells > RENDER_CELL_LIMIT) {
+            verdict = 'over_limit';
+            advice.push(`超限：预计 ${estimatedCells} 格 = 上限的 ${ratioToLimit} 倍 → 全量渲染必然 code:555，预览会一直转。`);
+            advice.push(`本列数下安全行数上限 = ${safeRowsForTheseCols} 行；分页 pageRowCount ≤ ${Math.min(RENDER_PAGE_ROW_CAP, safeRowsForTheseCols)}。`);
+            advice.push('收敛办法：给报表加查询条件（年月 / 部门 / 人员）并设默认值，让用户打开时自动过滤。');
+            advice.push('注意：搭报表本身不要求渲染全量 —— 落库成功即算完成，验收用 report verify 系列。');
+        }
+        else {
+            verdict = 'safe';
+            advice.push(`安全：预计 ${estimatedCells} 格（上限的 ${ratioToLimit} 倍）。`);
+        }
+    }
+    else {
+        advice.push('无法判定：缺行数或列数。用 --rows / --cols 指定后重跑。');
+    }
+    return {
+        reportId,
+        appId,
+        cellLimit: RENDER_CELL_LIMIT,
+        designedColumns,
+        fieldCells,
+        expandedColumns,
+        expandedColumnsSource,
+        rows,
+        rowsSource,
+        estimatedCells,
+        ratioToLimit,
+        safeRowsForTheseCols,
+        verdict,
+        advice,
+    };
+}
+//# sourceMappingURL=guard.js.map

package/dist/services/report/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../../src/services/report/guard.ts"],"names":[],"mappings":"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"}