bmc-common-resource 1.1.131 → 1.1.133

package/dist/modules/solution/mappings/room-group-mapping.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 房间与分组的映射关系
+ */
+/**
+ * 房间与分组的映射关系配置
+ * key: 房间ID
+ * value: 该房间可用的分组ID数组
+ */
+export declare const ROOM_GROUP_MAPPING: Record<string, string[]>;
+/**
+ * 获取指定房间可用的分组ID列表
+ * @param roomId 房间ID
+ * @returns 分组ID数组
+ */
+export declare function getGroupsByRoomId(roomId: string): string[];
+/**
+ * 获取指定房间可用的分组对象列表
+ * @param roomId 房间ID
+ * @returns 分组对象数组
+ */
+export declare function getGroupObjectsByRoomId(roomId: string): {
+    groupId: string;
+    groupName: string;
+}[];
+/**
+ * 检查指定分组是否可用于指定房间
+ * @param roomId 房间ID
+ * @param groupId 分组ID
+ * @returns 是否可用
+ */
+export declare function isGroupAvailableForRoom(roomId: string, groupId: string): boolean;

package/dist/modules/solution/models/QuotationItem.d.ts

@@ -0,0 +1,266 @@
+import { SkuAttributes } from "../types";
+/**
+ * 报价产品项类定义
+ * 用于统一前端报价单产品项的数据结构
+ */
+export default class QuotationItem {
+    /**
+     * 报价产品唯一标识，供数据查询定位等操作
+     */
+    uuid: string;
+    /**
+     * 产品在价格体系中的唯一标识（关联产品主数据, skuId）
+     */
+    productId: string;
+    /**
+     * 产品标准零售价(单价)
+     * @remarks 当为组合产品时未组合产品总价
+     */
+    unitPrice: number;
+    /**
+     * 产品供货价(单价)
+     */
+    supplyPrice: number;
+    /**
+     * 产品价格版本标识
+     */
+    productPriceId: string;
+    /**
+     * 产品单元名称（SPU名称）
+     * @example "悬浮式电视柜-XWSTDSG34804752600"
+     */
+    spuName: string;
+    /**
+     * 拆分单元后的名称
+     */
+    unitLabel: string;
+    /**
+     * 标准化产品单元id
+     */
+    spuId: string;
+    /**
+     * 品牌id
+     */
+    brandId: string;
+    /**
+         * 品牌名称
+         */
+    brandName: string;
+    /**
+     * 品类项id
+     */
+    classifyId: string;
+    /**
+     * 品类名称
+     */
+    classifyName: string;
+    /**
+     * 品类code
+     */
+    classifyCode: string;
+    /**
+     * 型号单名称
+     */
+    model: string;
+    /**
+     * 供货模式
+     */
+    supplyMode: string;
+    /**
+     * 轮廓尺寸
+     */
+    outlineDemension: string;
+    /**
+     * 产品分裂标签code
+     * @example "DOOR_BOARD"
+     */
+    categoryCode: string;
+    /**
+     * 产品分裂标签名称
+     */
+    categoryName: string;
+    /**
+     * 父级产品分类标签code
+     */
+    parentCategoryCode: string;
+    /**
+     * 父级产品分类标签
+     */
+    parentCategoryName: string;
+    /**
+     * 款式id
+     */
+    styleId: string;
+    /**
+     * 款式名称（前端展示用）
+     * @example "现代简约"
+     */
+    styleName: string;
+    /**
+     * 所属房间/空间名称（展示用）
+     * @example "主卧"
+     */
+    roomName: string;
+    /**
+     * 房间统一编码（业务系统标准编码）
+     * @remarks 用于空间分组逻辑，建议使用英文标识
+     * @example "master_bedroom"
+     */
+    roomCode: string;
+    /**
+     * 空间方案版本
+     * @remarks 用于空间下的多套风格报价， 默认按照方案A B C 形式排序
+     * @example "方案A"
+     */
+    schemeName: string;
+    /**
+     * 所属分组名称
+     * @example "定制柜"
+     */
+    groupName: string;
+    /**
+     * 分组统一编码
+     * @example "wall_construction"
+     */
+    groupCode: string;
+    /**
+     * 实际测量宽度（单位：毫米）
+     */
+    width: number | null;
+    /**
+     * 实际测量高度（单位：毫米）
+     */
+    height: number | null;
+    /**
+     * 实际测量深度（单位：毫米）
+     */
+    depth: number | null;
+    /**
+     * 产品原始宽度（出厂标准尺寸）
+     * @remarks 用于非标系数计算
+     */
+    originWidth: number | null;
+    /**
+     * 产品原始高度（单位：毫米）
+     */
+    originHeight: number | null;
+    /**
+     * 产品原始深度（单位：毫米）
+     */
+    originDepth: number | null;
+    /**
+     * 产品sku属性集合
+     */
+    skuAttributes: SkuAttributes[];
+    /**
+     * 开启方向（基于安装位置的方向描述）
+     * @example "左开"、"双向推拉"
+     */
+    moveDirection: string;
+    /**
+     * 安装位置描述（相对空间的位置信息）
+     * @example "靠南墙居中安装"
+     */
+    location: string;
+    /**
+     * 计量单位
+     * @example "件"、"米"、"平方米"
+     */
+    measureUnit: string;
+    /**
+     * 计量, 由云函数根据计量单位规则计算而来
+     * @example 1.2
+     */
+    measure: number;
+    /**
+     * 自定义参与计量计量的尺寸类型
+     */
+    measureCalcParams: string[];
+    /**
+     * 是否为专属套包产品
+     */
+    isExclusivePackage: boolean;
+    /**
+     * 计价标记
+     */
+    priceFlag: string;
+    /**
+     * 标准金额 （由规则关联计算得出）
+     */
+    standardPrice: number;
+    /**
+     * 实际金额（由规则关联计算得出）
+     */
+    actualPrice: number;
+    /**
+     * 含税费金额（由规则关联计算得出）
+     */
+    taxFeePrice: number;
+    /**
+     * 数量
+     * @min 0
+     */
+    count: number;
+    /**
+     * 备注
+     * @example "需与吊顶留缝5mm"
+     */
+    remark: string;
+    /**
+     * 非标系数（用于尺寸适配价格计算）
+     * @default 1
+     * @example 1.2 表示加价20%
+     */
+    productCoefficient: number;
+    /**
+     * 分项折扣率（基于标准价的折扣）
+     * @default 100
+     * @min 0
+     * @max 100
+     * @example 85 表示85折
+     */
+    itemDiscount: number;
+    /**
+     * 税率
+     * @default 0
+     * @min 0
+     * @max 100
+     */
+    taxRate: number;
+    /**
+     * 税金
+     */
+    taxAmount: number;
+    /**
+     * 管理费率
+     * @default 0
+     * @min 0
+     * @max 100
+     */
+    managementFeeRate: number;
+    /**
+     * 管理费
+     */
+    managementFee: number;
+    /**
+     * 产品预览图集合（最多6张）
+     * @remarks 按序存储，首张作为主图
+     * @example ["https://cdn.example.com/img1.jpg"]
+     */
+    picture: string[];
+    /**
+     * 子项集合（用于产品柜分拆 、墙板拆分）
+     * @remarks 形成递归数据
+     */
+    children: QuotationItem[];
+    /**
+     * 组合产品子项，仅提供原始产品信息，若清单编辑相关规格无需更新此字段
+     * @remarks 例如柜类产品由门板和箱体组成，将保存组合项QuotationItem格式数据
+     */
+    components: QuotationItem[];
+    /**
+     * 构造方法
+     * @param config 初始化配置（支持部分字段赋值）
+     */
+    constructor(config?: Partial<QuotationItem>);
+}

package/dist/modules/solution/models/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 模型类统一导出文件
+ */
+export { default as QuotationItem } from './QuotationItem';

package/dist/modules/solution/productCategories.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 产品分类接口定义
+ */
+export interface ProductCategory {
+    name: string;
+    code: string;
+    children?: Record<string, ProductCategory>;
+    parentKey?: string;
+}
+declare const PRODUCT_CATEGORIES: Record<string, ProductCategory>;
+/**
+ * 根据产品分类键获取产品分类信息
+ * @param categoryKey 产品分类键
+ * @returns 产品分类信息
+ */
+export declare function getProductCategoryByKey(categoryKey: string): ProductCategory | null;
+/**
+ * 获取所有产品分类
+ * @returns 包含产品分类代码和名称的对象数组
+ */
+export declare function getAllProductCategories(): Array<{
+    code: string;
+    name: string;
+}>;
+export { PRODUCT_CATEGORIES };
+export default PRODUCT_CATEGORIES;

package/dist/modules/solution/roomTypes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 房间类型定义
+ * 定义系统中所有可用的房间类型
+ */
+import { RoomType } from './types/index';
+export declare const ROOM_TYPES: Record<string, RoomType>;
+/**
+ * 获取排序后的房间类型数组
+ * @returns 按order排序的房间类型数组
+ */
+export declare function getSortedRoomTypes(): RoomType[];
+/**
+ * 根据房间类型键获取房间信息
+ * @param roomTypeKey 房间类型键
+ * @returns 房间类型信息
+ */
+export declare function getRoomTypeByKey(roomTypeKey: string): RoomType | null;
+export default ROOM_TYPES;

package/dist/modules/solution/types/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 公共类型定义
+ */
+export interface RoomType {
+    name: string;
+    order: number;
+    icon?: string;
+}
+export interface GroupType {
+    name: string;
+    order: number;
+    includeClassify?: string[];
+    mainCategory: string[];
+    productCategories?: string[];
+    classifyType?: string;
+}
+export interface ProductCategory {
+    name: string;
+    order: number;
+    products?: string[];
+}
+export interface ClassifyType {
+    name: string;
+    icon?: string;
+    order: number;
+    roomTypes?: string[];
+}
+export interface RoomGroupMapping {
+    room: RoomType;
+    groups: GroupType[];
+}
+export interface ClassifyRoomGroupMapping {
+    name: string;
+    icon?: string;
+    order: number;
+    matchUnit?: string[];
+    roomGroups: RoomGroupMapping[];
+}
+export interface ClassifyRoomGroupMapType {
+    [key: string]: ClassifyRoomGroupMapping;
+}
+export interface ProductCategoryData {
+    categoryName: string;
+    categoryCode: string;
+}
+export interface GroupData {
+    groupName: string;
+    groupCode: string;
+    productCategories: ProductCategoryData[];
+    classifyType?: string;
+}
+export interface RoomData {
+    roomName: string;
+    roomCode: string;
+    groups: GroupData[];
+}

package/dist/modules/solution/types.d.ts

@@ -0,0 +1,10 @@
+export interface SkuAttributes {
+    attributeId: string;
+    attributeName: string;
+    attributeCode: string;
+    attributeValue: string;
+    attributeValueId: string;
+    categoryCode: string;
+    categoryName: string;
+    color: any;
+}

package/dist/utils/common.util.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 生成UUID v4
+ * 使用随机数生成算法，确保生成的UUID唯一
+ * @returns {string} 返回格式为'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'的UUID
+ */
+export declare function generateUUID(): string;
+/**
+ * 生成随机指定位数字符串
+ * @param length 随机字符串长度
+ * @returns
+ */
+export declare function generateRandomId(length?: number): string;
+/**
+ * 格式化数字为千分位显示。
+ *
+ * 此函数将传入的值格式化为带有千分位分隔符的字符串。如果传入值无效（例如 null、空字符串、非数字字符串），则返回默认值 `"0"`。
+ * 保持原有的小数位数，不会因为数值转换而丢失末尾的零。
+ *
+ * @param {number|string|null|undefined} value - 需要格式化的值，可以是数字、数字字符串、null 或 undefined。如果为无效值，则返回默认值 "0"。
+ * @returns {string} 格式化后的千分位数字字符串。如果输入无效，返回 `"0"`。
+ *
+ * @example
+ * formatNumberWithCommas(1234567.89);      // 返回 "1,234,567.89"
+ * formatNumberWithCommas('123.10');        // 返回 "123.10"
+ * formatNumberWithCommas('123.100');       // 返回 "123.100"
+ * formatNumberWithCommas(null);            // 返回 "0"
+ * formatNumberWithCommas('');              // 返回 "0"
+ * formatNumberWithCommas('1234567.89');    // 返回 "1,234,567.89"
+ * formatNumberWithCommas('abc');           // 返回 "0"
+ */
+export declare function formatNumberWithCommas(value: number | string | null | undefined): string;
+/**
+ * 从选项列表中查找匹配特定值的选项
+ *
+ * 此函数接受一个值和一个选项列表，返回列表中与该值匹配的选项对象。
+ * 支持标准格式的选项列表：[{name: string, value: any}, ...]
+ *
+ * @param {any} value - 要查找的值
+ * @param {Array<{name: string, value: any}>} options - 选项列表，每个选项必须包含name和value属性
+ * @param {boolean | string} [strictOrField=false] - 是否使用严格相等(===)进行比较，默认为false；或者指定要匹配的字段名
+ * @param {string} [valueField='value'] - 要匹配的字段名，默认为'value'
+ * @returns {{name: string, value: any} | undefined} 找到的选项对象，如果未找到则返回undefined
+ *
+ * @example
+ * // 基本用法
+ * const options = [
+ *   { name: '选项1', value: 'value1' },
+ *   { name: '选项2', value: 'value2' }
+ * ];
+ * findOptionByValue('value1', options); // 返回 { name: '选项1', value: 'value1' }
+ *
+ * // 使用严格匹配
+ * findOptionByValue(1, options, true); // 使用严格匹配(===)
+ *
+ * // 匹配自定义字段
+ * const users = [
+ *   { name: '张三', id: 1001, role: 'admin' },
+ *   { name: '李四', id: 1002, role: 'user' }
+ * ];
+ * findOptionByValue('admin', users, 'role'); // 返回 { name: '张三', id: 1001, role: 'admin' }
+ *
+ * // 同时指定严格匹配和自定义字段
+ * findOptionByValue(1001, users, true, 'id'); // 返回 { name: '张三', id: 1001, role: 'admin' }
+ */
+export declare function findOptionByValue<T = any>(value: any, options: Array<Record<string, any>>, valueField?: string, strictOrField?: boolean | string): Record<string, any> | undefined;
+/**
+ * 获取文件扩展名
+ * @param filename 文件名
+ * @returns 文件扩展名
+ */
+export declare function getFileExtension(filename: string): string;
+/**
+ * 格式化中国大陆手机号为 138 1234 5678 形式
+ * @param {string} phone 原始手机号
+ * @returns {string|null} 格式化后的手机号，不合法则返回 null
+ */
+export declare function formatChineseMobile(phone: string): string | null;
+/**
+ * 小数处理函数（四舍五入、格式统一）
+ * @param {string|number} value - 要处理的值
+ * @param {number} decimals - 保留的小数位数，默认0（取整）
+ * @returns {number} 处理后的数字
+ */
+export declare function formatDecimal(value: any, decimals?: number): number;

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 工具函数的统一导出
+ */
+export * from './solution.util';
+export * from './common.util';

package/dist/utils/solution.util.d.ts

@@ -0,0 +1,50 @@
+import QuotationItem from "../modules/solution/models/QuotationItem";
+/**
+ * 计算报价产品项标准金额 （计量 * 数量 * 单价 * 非标系数）
+ * @param item 报价清单项
+ * @param decimalPlaces 小数保留位数（可选），如果传入则按四舍五入保留指定位数小数
+ * @returns 计算后的标准金额
+ */
+export declare const calcStandardPrice: (item: QuotationItem, decimalPlaces?: number) => number;
+/**
+ * 计算报价产品项实际金额
+ * 实际金额 = 标准金额 * 分项折扣（百分比形式，100表示100%）
+ * 标配或赠品价格标识的产品不计算金额（返回0）
+ * 特殊处理：墙板类(WALLBOARD)且有子项时，实际金额为所有子项实际金额之和
+ *
+ * @param item 报价清单项
+ * @param decimalPlaces 小数保留位数（可选），如果传入则按四舍五入保留指定位数小数
+ * @returns 计算后的实际金额
+ */
+export declare const calcActualPrice: (item: QuotationItem, decimalPlaces?: number) => number;
+/**
+ * 计算报价产品项单价
+ * 区分处理已拆分
+ * @param item 报价清单项
+ * @param decimalPlaces 小数保留位数（可选），如果传入则按四舍五入保留指定位数小数
+ * @returns 计算后的产品单价
+ */
+export declare const calcItemUnitPrice: (item: QuotationItem, decimalPlaces?: number) => number;
+/**
+ * 计算报价产品项指定税率税金
+ * @param item 报价产品项
+ * @param decimalPlaces 小数保留位数（可选），如果传入则按四舍五入保留指定位数小数
+ * @returns 计算后的税金
+ */
+export declare const calcTaxAmount: (item: QuotationItem, decimalPlaces?: number) => number;
+/**
+ * 计算报价产品项指定管理费率管理费金额
+ * @param item 报价产品项
+ * @param decimalPlaces 小数保留位数（可选），如果传入则按四舍五入保留指定位数小数
+ * @returns 计算后的管理费金额
+ */
+export declare const managementFeeAmount: (item: QuotationItem, decimalPlaces?: number) => number;
+/**
+ * 计算报价产品项含税费金额
+ * @param item 报价产品项
+ * @param enableTaxRate 是否启用税率计算
+ * @param enableManagementFeeRate 是否启用管理费率
+ * @param decimalPlaces 小数保留位数（可选），如果传入则按四舍五入保留指定位数小数
+ * @returns 计算后的含税费金额
+ */
+export declare const calcTaxFeePrice: (item: QuotationItem, enableTaxRate: boolean, enableManagementFeeRate: boolean, decimalPlaces?: number) => number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmc-common-resource",
-  "version": "1.1.131",
+  "version": "1.1.133",
   "description": "通用枚举、常量和资源的npm包",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",