weaver-work-cli 0.1.6 → 0.1.7

package/dist/shortcuts/okr/operations/link.js

@@ -0,0 +1,305 @@
+import { isOkrErrorType, okrApiError } from '../errors.js';
+import { businessMessage, isDatajsonSuccess } from '../host.js';
+import { compact, ebMainTables, optionValue } from './shared.js';
+/** ebuilder「OKR 目标」应用标签（源资料固定值）。 */
+const OKR_APP_TAG = 'weaver-wr-goal-eb';
+/** ebuilder「OKR 目标详情」表单标签（源资料固定值）。 */
+export const OKR_EB_FORM_TAG = 'uf_wrgm_baseinfo';
+const VERSION_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+/**
+ * 源资料固定映射：租户 tqasclatif 的 okr 目标详情 eb 表单 id 无需动态获取。
+ * 该租户命中时跳过 getAppIds / getObjsByTag 两步解析。
+ */
+const EB_FORM_ID_FIXED = {
+    tqasclatif: '1027322801024458753',
+};
+export function okrVersionCacheKey(tenantKey) {
+    return `okr:version:${tenantKey}`;
+}
+export function okrEbFormCacheKey(tenantKey) {
+    return `okr:ebform:${tenantKey}`;
+}
+/**
+ * 源资料路由规则：`ver_name >= V2` → e10-ebuilder 链路，其它情况 → e10 标准版链路。
+ * 兼容 `V2` / `v2` / `V14` / `2` 等写法，只比较主版本号。
+ */
+export function isEbVersion(verName) {
+    if (typeof verName !== 'string')
+        return false;
+    const match = /^[vV]?(\d+)/.exec(verName.trim());
+    if (!match)
+        return false;
+    return Number(match[1]) >= 2;
+}
+/**
+ * 链路判定：优先读租户隔离、有效期 1 天的版本判定缓存；未命中或已过期才调用 okr_searchAppver 取
+ * `ver_name`，并把结果写回租户缓存。
+ *
+ * 只有真正拿到版本答案时才写缓存：接口不可用（标准版租户通常没有该 ebuilder 接口）时降级为标准版
+ * 链路并如实说明，不写缓存、不硬编码链路。
+ */
+export async function resolveLink(host, options = {}) {
+    const session = await host.getSession();
+    const key = okrVersionCacheKey(session.tenantKey);
+    if (!options.refresh) {
+        const cached = await host.getCache(key);
+        const value = cached && typeof cached === 'object' ? cached : null;
+        if (value && (value.link === 'standard' || value.link === 'eb')) {
+            return {
+                link: value.link,
+                verName: value.verName ?? null,
+                tenantKey: session.tenantKey,
+                cached: true,
+                degraded: false,
+                reason: null,
+                checkedAt: typeof value.checkedAt === 'string' ? value.checkedAt : new Date().toISOString(),
+            };
+        }
+    }
+    let verName = null;
+    let degraded = false;
+    let reason = null;
+    try {
+        const response = await host.request({
+            method: 'POST',
+            path: '/api/ebuilder/form/formdata/v2/getFormDataList/okr_searchAppver',
+            operation: 'okr.version.check',
+            body: {
+                datajson: {
+                    mainTable: {},
+                    pageInfo: { pageNo: '1', pageSize: '10' },
+                    header: { operator: session.userId },
+                },
+            },
+        });
+        const mainTable = ebMainTables(response)[0];
+        verName = optionValue(mainTable?.ver_name) ?? null;
+    }
+    catch (error) {
+        if (isOkrErrorType(error, 'api') || isOkrErrorType(error, 'network')) {
+            degraded = true;
+            reason = error.message;
+        }
+        else {
+            throw error;
+        }
+    }
+    const link = isEbVersion(verName) ? 'eb' : 'standard';
+    const info = {
+        link,
+        verName,
+        tenantKey: session.tenantKey,
+        cached: false,
+        degraded,
+        reason,
+        checkedAt: new Date().toISOString(),
+    };
+    if (!degraded)
+        await host.setCache(key, info, VERSION_CACHE_TTL_MS);
+    return info;
+}
+function firstId(value) {
+    if (Array.isArray(value) && value.length > 0) {
+        const first = value[0];
+        if (typeof first === 'string' || typeof first === 'number')
+            return String(first);
+        if (first && typeof first === 'object') {
+            const record = first;
+            const candidate = record.id ?? record.objId ?? record.idobjId ?? record.value;
+            if (candidate !== undefined && candidate !== null && candidate !== '')
+                return String(candidate);
+        }
+    }
+    if (typeof value === 'string' || typeof value === 'number')
+        return String(value);
+    return undefined;
+}
+/** getObjsByTag 返回的 data 数组中按 tag 命中的那条记录的 objId（源资料：eb 表单 id 指 id/objId）。 */
+export function pickObjIdByTag(value, formTag) {
+    const root = value && typeof value === 'object' && 'datajson' in value
+        ? value.datajson
+        : value;
+    const data = root?.data;
+    if (!Array.isArray(data))
+        return firstId(root);
+    const objects = data.filter((item) => item && typeof item === 'object');
+    if (objects.length > 0) {
+        const tagged = objects.filter((item) => item.tag !== undefined && item.tag !== null);
+        const matched = tagged.find((item) => String(item.tag) === formTag);
+        if (matched)
+            return firstId([matched]);
+        // 响应带 tag 但没有一个是目标表单：说明表单不存在，返回 undefined 而不是猜一个表单 id。
+        if (tagged.length > 0)
+            return undefined;
+        // 响应结构里没有 tag：接口只返回一条时回落到首个元素。
+        return firstId(objects);
+    }
+    return firstId(data);
+}
+/** 获取 eb 目标详情页所需的表单 id（源资料：eb 表单 id 指 id/objId，不是 formId）。 */
+export async function resolveEbFormId(host) {
+    const session = await host.getSession();
+    const templateOf = (formId) => `/sp/ebdfpage/card/0/${formId}/{goalId}`;
+    const fixed = EB_FORM_ID_FIXED[session.tenantKey];
+    if (fixed) {
+        return {
+            appTag: OKR_APP_TAG,
+            appId: null,
+            formTag: OKR_EB_FORM_TAG,
+            formId: fixed,
+            source: 'fixed',
+            detailUrlTemplate: templateOf(fixed),
+        };
+    }
+    // 源资料：取得当前租户的 okr 目标详情 eb 表单 id 后长期缓存，后续不再动态获取。
+    const key = okrEbFormCacheKey(session.tenantKey);
+    const cached = await host.getCache(key);
+    const cachedValue = cached && typeof cached === 'object' ? cached : null;
+    if (cachedValue && typeof cachedValue.formId === 'string' && cachedValue.formId) {
+        return {
+            appTag: OKR_APP_TAG,
+            appId: typeof cachedValue.appId === 'string' ? cachedValue.appId : null,
+            formTag: OKR_EB_FORM_TAG,
+            formId: cachedValue.formId,
+            source: 'cache',
+            detailUrlTemplate: templateOf(cachedValue.formId),
+        };
+    }
+    const appIdsResponse = await host.request({
+        method: 'GET',
+        path: '/api/bs/ebuilder/app/tags/getAppIds',
+        query: { tag: OKR_APP_TAG },
+        operation: 'okr.eb.form.resolve',
+    }).catch(() => undefined);
+    const appId = firstId(appIdsResponse?.data);
+    if (!appId) {
+        throw okrApiError('eb_app_not_found', `未检测到「OKR 目标」ebuilder 应用（appTag: ${OKR_APP_TAG}），无法生成目标详情页链接`);
+    }
+    const formResponse = await host.request({
+        method: 'GET',
+        path: '/api/ebuilder/form/obj/getObjsByTag',
+        query: { tag: OKR_EB_FORM_TAG, appId },
+        operation: 'okr.eb.form.resolve',
+    }).catch(() => undefined);
+    const formId = pickObjIdByTag(formResponse, OKR_EB_FORM_TAG);
+    if (!formId) {
+        throw okrApiError('eb_form_not_found', `未找到目标详情 ebuilder 表单（tag: ${OKR_EB_FORM_TAG}），无法生成目标详情页链接`);
+    }
+    const info = {
+        appTag: OKR_APP_TAG,
+        appId,
+        formTag: OKR_EB_FORM_TAG,
+        formId,
+        source: 'dynamic',
+        detailUrlTemplate: templateOf(formId),
+    };
+    await host.setCache(key, { appId, formId });
+    return info;
+}
+/** 标准版目标详情页地址（源资料固定格式）。 */
+export function buildStandardDetailPath(goalId) {
+    return `/sp/goal/openDetail?id=${goalId}`;
+}
+/**
+ * 把站内相对路径拼成可直接点击的绝对地址（列表表格、详情返回与写入回执统一使用绝对地址）。
+ * 已经是绝对地址时原样返回，链接缺失时返回 null 而不是伪造地址。
+ */
+export function okrAbsoluteUrl(baseUrl, path) {
+    if (!path)
+        return null;
+    if (/^https?:\/\//iu.test(path))
+        return path;
+    const origin = String(baseUrl ?? '').replace(/\/+$/u, '');
+    const suffix = path.startsWith('/') ? path : `/${path}`;
+    return `${origin}${suffix}`;
+}
+/**
+ * 创建详情页链接解析器。eb 链路需要先解析表单 id，属于附加信息：
+ * 解析失败时只记警告并返回 null，绝不让主查询/主写入失败或被重试（源资料强制「链接暂不可用」语义）。
+ */
+export async function createDetailUrlResolver(host, link) {
+    const warnings = [];
+    if (link === 'standard') {
+        return {
+            warnings,
+            async resolve(goalId) {
+                return goalId ? buildStandardDetailPath(goalId) : null;
+            },
+        };
+    }
+    let formId = null;
+    let resolved = false;
+    return {
+        warnings,
+        async resolve(goalId) {
+            if (!goalId)
+                return null;
+            if (!resolved) {
+                resolved = true;
+                try {
+                    formId = (await resolveEbFormId(host)).formId;
+                }
+                catch (error) {
+                    warnings.push(`目标详情页链接暂不可用：${error.message}`);
+                    formId = null;
+                }
+            }
+            return formId ? `/sp/ebdfpage/card/0/${formId}/${goalId}` : null;
+        },
+    };
+}
+/** 只读取目标详情的 ebuilder / 标准版原始响应，供写入前合并使用。 */
+export async function fetchGoalRaw(host, link, goalId) {
+    const session = await host.getSession();
+    if (link === 'standard') {
+        const response = await host.request({
+            method: 'GET',
+            path: `/api/workrelate/goal/getObjectDetail/${goalId}`,
+            operation: 'okr.get',
+        });
+        return response?.data?.obj ?? null;
+    }
+    const response = await host.request({
+        method: 'POST',
+        path: '/api/ebuilder/form/formdata/v2/getFormDataByPk/okr_queryGoal',
+        operation: 'okr.get',
+        body: {
+            datajson: {
+                mainTable: { id: goalId },
+                header: { operator: session.userId },
+            },
+        },
+    });
+    if (!isDatajsonSuccess(response)) {
+        throw okrApiError('business_error', businessMessage(response), { response: businessMessage(response) });
+    }
+    return ebMainTables(response)[0] ?? null;
+}
+/** 从目标详情中取出负责人人员 id（对齐目标新增时用于补全双方负责人）。 */
+export function goalPrincipalId(raw, link) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    if (link === 'standard') {
+        const value = raw.principalid;
+        return value === undefined || value === null || value === '' ? null : String(value);
+    }
+    return optionValue(raw.principalid) ?? null;
+}
+/** 标准版新建/编辑请求体构造（源资料 workrelate/goal/create|update 入参）。 */
+export function buildStandardSaveBody(input) {
+    return compact({
+        ...(input.goalId ? { id: input.goalId } : {}),
+        name: input.name,
+        scopeId: input.scopeId,
+        ...(input.scopeId === '2' && input.scopeDataId ? { scopeDataId: input.scopeDataId } : {}),
+        periodType: input.periodType,
+        periodRange: input.periodRange,
+        ...(input.periodType === '2' && input.periodQuarter ? { periodQuarter: input.periodQuarter } : {}),
+        principalid: input.principalid,
+        ...(input.partners ? { partners: input.partners } : {}),
+        ...(input.remark === undefined ? {} : { remark: input.remark }),
+        ...(input.keyresultList ? { keyresultList: input.keyresultList } : {}),
+        status: input.status,
+        parentId: input.parentId ?? '0',
+    });
+}