@ibiz-template/runtime 0.1.11 → 0.1.12-dev.0

package/out/controller/control/chart/generator/base-series-generator.js

@@ -0,0 +1,433 @@
+import { RuntimeModelError, toNumberOrNil } from '@ibiz-template/core';
+import dayjs from 'dayjs';
+import minMax from 'dayjs/plugin/minMax';
+import isSameOrBefore from 'dayjs/plugin/isSameOrBefore';
+import quarterOfYear from 'dayjs/plugin/quarterOfYear';
+import weekOfYear from 'dayjs/plugin/weekOfYear';
+import isoWeek from 'dayjs/plugin/isoWeek';
+import { clone, isNil, mergeDeepRight } from 'ramda';
+import { parseUserParams, } from './chart-options-generator';
+dayjs.extend(minMax);
+dayjs.extend(isSameOrBefore);
+dayjs.extend(quarterOfYear);
+dayjs.extend(weekOfYear);
+dayjs.extend(isoWeek);
+export const DEFAULT_GROUP = '$default_group';
+export class BaseSeriesGenerator {
+    /**
+     * Creates an instance of BaseSeriesGenerator.
+     * @author lxm
+     * @date 2023-06-09 02:46:54
+     * @param {T} model 序列模型
+     * @param {ChartOptionsGenerator} chartGenerator 图表生成器
+     */
+    constructor(model, chartGenerator) {
+        var _a;
+        this.model = model;
+        this.chartGenerator = chartGenerator;
+        /**
+         * 静态的序列options
+         * @author lxm
+         * @date 2023-06-09 03:08:47
+         * @type {SeriesOption}
+         */
+        this.staticOptions = {};
+        /**
+         * 是否根据代码表自动补全分类
+         * @author lxm
+         * @date 2023-06-09 09:28:04
+         * @type {boolean}
+         */
+        this.autoCompleteCategory = true;
+        this.model = model;
+        this.chartGenerator = chartGenerator;
+        const { chartSeriesEncode, caption, id, userParam } = model;
+        if (!model.catalogField) {
+            throw new RuntimeModelError(model, '缺少分类属性配置');
+        }
+        if (!model.valueField) {
+            throw new RuntimeModelError(model, '缺少值属性配置');
+        }
+        this.catalogField = model.catalogField.toLowerCase();
+        this.valueField = model.valueField.toLowerCase();
+        this.groupField = (_a = model.seriesField) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+        const { chartXAxisId, chartYAxisId } = (chartSeriesEncode ||
+            {});
+        this.xAxisIndex = toNumberOrNil(chartXAxisId);
+        this.yAxisIndex = toNumberOrNil(chartYAxisId);
+        this.seriesName = caption || id;
+        this.staticOptions = this.calcStaticOptions();
+        if (userParam) {
+            this.seriesUserParam = parseUserParams(userParam);
+        }
+    }
+    /**
+     * 计算静态序列的options
+     * @author lxm
+     * @date 2023-06-09 03:09:34
+     */
+    calcStaticOptions() {
+        const options = {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            type: this.model.seriesType,
+            name: this.seriesName,
+            emphasis: {
+                label: {
+                    fontSize: 20,
+                    show: true,
+                },
+            },
+            label: {
+                position: 'top',
+                show: true,
+            },
+        };
+        return options;
+    }
+    /**
+     * 有代码就转换，值为空直接返回空
+     *
+     * @author lxm
+     * @date 2023-06-09 08:42:50
+     * @author lxm
+     * @date 2023-06-09 08:46:00
+     * @param {(string | undefined)} codeListKey 代码表值
+     * @param {(string | undefined)} val 数据值
+     * @param {boolean} isExclude 是否排除非代码表的值，true时，匹配不到代码表返回undefined，反之返回原值
+     * @return {*}  {(string | undefined)}
+     */
+    translateVal(codeListKey, val, isExclude = false) {
+        if (isNil(val)) {
+            return undefined;
+        }
+        if (isNil(codeListKey)) {
+            return val;
+        }
+        const codeListItems = this.chartGenerator.codeListMap.get(codeListKey);
+        if (codeListItems === null || codeListItems === void 0 ? void 0 : codeListItems.length) {
+            const find = codeListItems.find(x => x.value === val);
+            if (find) {
+                return find.text;
+            }
+        }
+        return isExclude ? undefined : val;
+    }
+    /**
+     * 计算分组数据
+     * @author lxm
+     * @date 2023-06-09 03:42:53
+     * @param {IData[]} data
+     * @return {*}  {GroupData}
+     */
+    calcGroupData(data) {
+        // 清空分组数据
+        this.groupData = {};
+        const groupData = this.groupData;
+        // 分组属性代码表和分类属性代码表
+        const { seriesCodeListId, catalogCodeListId } = this.model;
+        data.forEach(item => {
+            // 计算分组名称标识
+            let group = DEFAULT_GROUP;
+            if (this.groupField) {
+                const groupVal = this.translateVal(seriesCodeListId, item[this.groupField]);
+                // 存在分组属性，但是分组属性没值的数据排除在外
+                if (isNil(groupVal)) {
+                    return;
+                }
+                group = groupVal;
+            }
+            // 分组对应的分类数据不存在时新建一个
+            if (!groupData[group]) {
+                groupData[group] = new Map();
+                // 有代码表的时候补全代码表项个数的数据条数
+                if (catalogCodeListId && this.autoCompleteCategory) {
+                    const codeListItems = this.chartGenerator.codeListMap.get(catalogCodeListId);
+                    codeListItems.forEach(x => {
+                        groupData[group].set(x.text, { value: 0 });
+                    });
+                }
+            }
+            // 分类属性值计算和转换
+            const catalog = this.translateVal(catalogCodeListId, item[this.catalogField], true);
+            // 分类属性没值的数据排除
+            if (!catalog) {
+                return;
+            }
+            // 该分类属性对应的单条数据不存在时新建一个
+            if (!groupData[group].get(catalog)) {
+                groupData[group].set(catalog, { value: 0 });
+            }
+            // 相同分类属性的值属性数据累加
+            groupData[group].get(catalog).value += item[this.valueField];
+            groupData[group].get(catalog).deData = item;
+        });
+        return groupData;
+    }
+    /**
+     * 根据分组数据算出多个序列的options
+     * 大多数图表分组都是一个分组数据生成一条series
+     * @author lxm
+     * @date 2023-06-09 03:34:24
+     * @param {GroupData} groupData
+     * @return {*}  {SeriesOption[]}
+     */
+    calcGroupSeries(groupData) {
+        return Object.keys(groupData).map(group => {
+            // 处理每个序列的数据
+            const catalogData = groupData[group];
+            const data = this.calcSeriesData(catalogData);
+            // 合并静态的seriesOptions
+            let options = Object.assign(Object.assign({}, this.staticOptions), { data });
+            // 非默认分组的时候name是分组属性的值
+            if (group !== DEFAULT_GROUP) {
+                options.name = group;
+            }
+            // 合并自定义参数
+            if (this.seriesUserParam) {
+                options = mergeDeepRight(options, this.seriesUserParam);
+            }
+            return options;
+        });
+    }
+    /**
+     * 生成每条序列的data,由于不同图表类型格式不同所以为any
+     * 默认提供的是二维数组，按[X轴，y轴]格式
+     * @author lxm
+     * @date 2023-06-09 03:38:07
+     * @param {CatalogData} catalogData
+     * @return {*}  {*}
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    calcSeriesData(catalogData) {
+        const temData = [];
+        catalogData.forEach((catalog, key) => {
+            var _a;
+            temData.push([key, catalog.value, (_a = catalog.deData) === null || _a === void 0 ? void 0 : _a.srfkey]);
+        });
+        return temData;
+    }
+    /**
+     * 根据数据计算出序列的options
+     * @author lxm
+     * @date 2023-06-09 03:44:31
+     * @param {IData[]} data
+     * @return {*}  {(SeriesOption[] | SeriesOption)}
+     */
+    calcByData(data) {
+        const tempData = this.dataPreprocess(data);
+        const groupData = this.calcGroupData(tempData);
+        this.addTimeData(groupData);
+        return this.calcGroupSeries(groupData);
+    }
+    /**
+     * 通过事件的params获取主键
+     * @author lxm
+     * @date 2023-06-09 10:56:25
+     * @param {ECElementEvent} params
+     * @return {*}  {string}
+     */
+    getSrfkeyByParams(params) {
+        return params.value[2];
+    }
+    /**
+     * 数据预处理
+     * @return {*}
+     * @author: zhujiamin
+     * @Date: 2023-08-16 09:58:39
+     */
+    dataPreprocess(data) {
+        const tempData = [];
+        data.forEach(singleData => {
+            tempData.push(clone(singleData));
+        });
+        // 根据分组模式格式化时间
+        const { groupMode } = this.model;
+        if (groupMode) {
+            tempData.forEach((singleData) => {
+                let format = '';
+                if (groupMode === 'DAY' ||
+                    groupMode === 'YEAR' ||
+                    groupMode === 'MONTH') {
+                    if (groupMode === 'DAY') {
+                        format = 'YYYY-MM-DD';
+                    }
+                    else if (groupMode === 'YEAR') {
+                        format = 'YYYY';
+                    }
+                    else if (groupMode === 'MONTH') {
+                        format = 'YYYY-MM';
+                    }
+                    if (singleData[this.catalogField]) {
+                        const formattedDate = dayjs(singleData[this.catalogField]).format(format);
+                        singleData[this.catalogField] = formattedDate;
+                    }
+                }
+                else if (groupMode === 'QUARTER') {
+                    if (singleData[this.catalogField]) {
+                        const formattedDate = `${dayjs(singleData[this.catalogField]).format('YYYY')}-${dayjs(singleData[this.catalogField]).quarter()}`;
+                        singleData[this.catalogField] = formattedDate;
+                    }
+                }
+                else if (groupMode === 'YEARWEEK') {
+                    if (singleData[this.catalogField]) {
+                        const formattedDate = `${dayjs(singleData[this.catalogField]).format('YYYY')}-${dayjs(singleData[this.catalogField]).week()}`;
+                        singleData[this.catalogField] = formattedDate;
+                    }
+                }
+            });
+        }
+        return tempData;
+    }
+    /**
+     * 补全分组数据后排序
+     * @param {GroupData} data
+     * @return {*}
+     * @author: zhujiamin
+     * @Date: 2023-08-17 16:25:44
+     */
+    sortTimeData(data) {
+        const { groupMode } = this.model;
+        Object.keys(data).forEach(key => {
+            const dateMap = data[key];
+            let sortedKeys = [];
+            if (groupMode === 'DAY' ||
+                groupMode === 'YEAR' ||
+                groupMode === 'MONTH') {
+                sortedKeys = Array.from(dateMap.keys()).sort((a, b) => dayjs(a).diff(dayjs(b)));
+            }
+            else if (groupMode === 'QUARTER' || groupMode === 'YEARWEEK') {
+                sortedKeys = Array.from(dateMap.keys()).sort((a, b) => {
+                    const [yearA, quarterA] = a.split('-');
+                    const [yearB, quarterB] = b.split('-');
+                    if (yearA !== yearB) {
+                        return parseInt(yearA, 10) - parseInt(yearB, 10);
+                    }
+                    return parseInt(quarterA, 10) - parseInt(quarterB, 10);
+                });
+            }
+            const sortedMap = new Map();
+            sortedKeys.forEach(sortKey => {
+                sortedMap.set(sortKey, dateMap.get(sortKey));
+            });
+            data[key] = sortedMap;
+        });
+    }
+    /**
+     * 根据分组模式补全分组数据并排序
+     * @param {IData} data
+     * @return {*}
+     * @author: zhujiamin
+     * @Date: 2023-08-16 13:57:53
+     */
+    addTimeData(data) {
+        const { groupMode } = this.model;
+        if (!groupMode || groupMode === 'CODELIST') {
+            return;
+        }
+        const dates = [];
+        // 遍历数据，生成日期数组
+        Object.keys(data).forEach(key => {
+            data[key].forEach((_val, date) => {
+                dates.push(dayjs(date));
+            });
+        });
+        // 使用 dayjs 的 max() 和 min() 方法找出最大和最小日期
+        const maxDate = dayjs.max(dates);
+        const minDate = dayjs.min(dates);
+        if (groupMode === 'DAY') {
+            // 补充缺失的日期项
+            let currentDate = minDate;
+            const endDate = maxDate;
+            while (currentDate === null || currentDate === void 0 ? void 0 : currentDate.isSameOrBefore(endDate, 'day')) {
+                const formattedDate = currentDate.format('YYYY-MM-DD');
+                Object.keys(data).forEach(key => {
+                    if (!data[key].get(formattedDate)) {
+                        data[key].set(formattedDate, { value: 0 });
+                    }
+                });
+                currentDate = currentDate.add(1, 'day');
+            }
+        }
+        else if (groupMode === 'YEAR') {
+            // 补充缺失的年份项
+            let currentYear = minDate.year();
+            const endYear = maxDate.year();
+            while (currentYear <= endYear) {
+                const yearString = currentYear.toString();
+                Object.keys(data).forEach(key => {
+                    if (!data[key].get(yearString)) {
+                        data[key].set(yearString, { value: 0 });
+                    }
+                });
+                currentYear += 1;
+            }
+        }
+        else if (groupMode === 'MONTH') {
+            // 补充缺失的年月项
+            let currentYearMonth = minDate.clone().startOf('month');
+            const endYearMonth = maxDate.clone().startOf('month');
+            while (currentYearMonth.isSameOrBefore(endYearMonth)) {
+                const yearMonthString = currentYearMonth.format('YYYY-MM');
+                Object.keys(data).forEach(key => {
+                    if (!data[key].get(yearMonthString)) {
+                        data[key].set(yearMonthString, { value: 0 });
+                    }
+                });
+                currentYearMonth = currentYearMonth.add(1, 'month');
+            }
+        }
+        else if (groupMode === 'QUARTER') {
+            // 找出最大和最小年季度
+            const yearQuarters = [];
+            Object.keys(data).forEach(key => {
+                data[key].forEach((_val, yearQuarter) => {
+                    yearQuarters.push(yearQuarter);
+                });
+            });
+            const minYearQuarter = yearQuarters.reduce((min, current) => (current < min ? current : min), yearQuarters[0]);
+            const maxYearQuarter = yearQuarters.reduce((max, current) => (current > max ? current : max), yearQuarters[0]);
+            // 解析最小和最大年季度
+            const [minYear] = minYearQuarter.split('-');
+            const [maxYear] = maxYearQuarter.split('-');
+            // 填充中间季度的数据项
+            for (let year = parseInt(minYear, 10); year <= parseInt(maxYear, 10); year++) {
+                for (let quarter = 1; quarter <= 4; quarter++) {
+                    const yearQuarter = `${year}-${quarter}`;
+                    Object.keys(data).forEach(key => {
+                        if (!data[key].get(yearQuarter)) {
+                            data[key].set(yearQuarter, { value: 0 });
+                        }
+                    });
+                }
+            }
+        }
+        else if (groupMode === 'YEARWEEK') {
+            // 找出最大和最小年周
+            const yearWeeks = [];
+            Object.keys(data).forEach(key => {
+                data[key].forEach((_val, yearWeek) => {
+                    yearWeeks.push(yearWeek);
+                });
+            });
+            const minYearWeek = yearWeeks.reduce((min, current) => (current < min ? current : min), yearWeeks[0]);
+            const maxYearWeek = yearWeeks.reduce((max, current) => (current > max ? current : max), yearWeeks[0]);
+            // 解析最小和最大年周
+            const [minYear] = minYearWeek.split('-');
+            const [maxYear] = maxYearWeek.split('-');
+            // 填充中间年周的数据项
+            for (let year = parseInt(minYear, 10); year <= parseInt(maxYear, 10); year++) {
+                const numWeeks = dayjs(`${year}-12-31`).isoWeek();
+                for (let week = 1; week <= numWeeks; week++) {
+                    const yearWeek = `${year}-${week}`;
+                    Object.keys(data).forEach(key => {
+                        if (!data[key].get(yearWeek)) {
+                            data[key].set(yearWeek, { value: 0 });
+                        }
+                    });
+                }
+            }
+        }
+        // 根据时间大小排序
+        this.sortTimeData(data);
+    }
+}

package/out/controller/control/chart/generator/chart-options-generator.d.ts

@@ -0,0 +1,84 @@
+import type { EChartsOption, XAXisComponentOption, YAXisComponentOption, ECElementEvent } from 'echarts';
+import { IChartXAxis, IChartYAxis, IDEChart, IDEChartLegend, IDEChartTitle } from '@ibiz/model-core';
+import { BaseSeriesGenerator } from './base-series-generator';
+import { RadarCoordSystem } from './radar-coord-system';
+import { CodeListItem } from '../../../../interface';
+/**
+ * 解析userParams
+ * @author lxm
+ * @date 2023-06-09 09:03:07
+ * @export
+ * @param {Record<string, string>} userParams
+ * @return {*}
+ */
+export declare function parseUserParams(userParams: Record<string, string>): IData;
+export declare class ChartOptionsGenerator {
+    private model;
+    /**
+     * 根据模型配置算出来的静态echarts配置
+     * @author lxm
+     * @date 2023-06-07 09:50:44
+     * @type {EChartsOption}
+     */
+    staticOptions: EChartsOption;
+    /**
+     * 最终计算产物
+     * @author lxm
+     * @date 2023-06-08 09:23:40
+     * @type {EChartsOption}
+     */
+    options: EChartsOption;
+    /**
+     * 图表整体的自定义Options
+     * @author lxm
+     * @date 2023-06-09 08:59:40
+     * @type {EChartsOption}
+     */
+    chartUserParam?: EChartsOption;
+    /**
+     * 序列生成器集合
+     * @author lxm
+     * @date 2023-06-09 05:47:41
+     * @type {BaseSeriesGenerator[]}
+     */
+    seriesGenerators: BaseSeriesGenerator[];
+    /**
+     * 雷达坐标系映射
+     * key是分类属性，值是雷达坐标的序号
+     * @author lxm
+     * @date 2023-06-08 03:51:03
+     */
+    radarMap: Map<string, RadarCoordSystem>;
+    /**
+     * 缓存已经加载的代码表数据
+     * @author lxm
+     * @date 2023-06-09 07:47:35
+     */
+    codeListMap: Map<string, Readonly<CodeListItem[]>>;
+    constructor(model: IDEChart);
+    protected initSeriesGenerators(): void;
+    protected calcTitleOption(chartTitle: IDEChartTitle): EChartsOption['title'];
+    protected calcLegendOption(chartLegend: IDEChartLegend): EChartsOption['legend'];
+    protected calcXYAxisOption(chartAxises: IChartYAxis[] | IChartXAxis[]): XAXisComponentOption[] | YAXisComponentOption[];
+    /**
+     * 加载代码表，
+     * - 如果已经加载过会清空缓存重新加载
+     * - 相同的代码表之后加载一次
+     * @author lxm
+     * @date 2023-06-09 08:05:28
+     * @param {IContext} context
+     * @param {IParams} params
+     * @return {*}  {Promise<void>}
+     */
+    loadCodeList(context: IContext, params: IParams): Promise<void>;
+    /**
+     * 根据数据计算出最终的options
+     * @author lxm
+     * @date 2023-06-09 08:10:52
+     * @param {IData[]} data
+     * @return {*}  {EChartsOption}
+     */
+    calcOptionsByData(data: IData[]): EChartsOption;
+    getSrfkeyByParams(params: ECElementEvent): string;
+}
+//# sourceMappingURL=chart-options-generator.d.ts.map

package/out/controller/control/chart/generator/chart-options-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-options-generator.d.ts","sourceRoot":"","sources":["../../../../../src/controller/control/chart/generator/chart-options-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACf,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,cAAc,EACd,aAAa,EACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAM9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAmBzE;AAED,qBAAa,qBAAqB;IAoDpB,OAAO,CAAC,KAAK;IAnDzB;;;;;OAKG;IACH,aAAa,EAAE,aAAa,CAI1B;IAEF;;;;;OAKG;IACH,OAAO,EAAE,aAAa,CAAM;IAE5B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,aAAa,CAAC;IAE/B;;;;;OAKG;IACH,gBAAgB,EAAE,mBAAmB,EAAE,CAAM;IAE7C;;;;;OAKG;IACH,QAAQ,gCAAuC;IAE/C;;;;OAIG;IACH,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAa;gBAE3C,KAAK,EAAE,QAAQ;IAqCnC,SAAS,CAAC,oBAAoB,IAAI,IAAI;IAgCtC,SAAS,CAAC,eAAe,CAAC,UAAU,EAAE,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC;IAmB5E,SAAS,CAAC,gBAAgB,CACxB,WAAW,EAAE,cAAc,GAC1B,aAAa,CAAC,QAAQ,CAAC;IAe1B,SAAS,CAAC,gBAAgB,CACxB,WAAW,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,GACzC,oBAAoB,EAAE,GAAG,oBAAoB,EAAE;IAwClD;;;;;;;;;OASG;IACG,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBrE;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,aAAa;IAkD/C,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM;CA8DlD"}