@etsoo/smarterp-crm 1.0.0 → 1.0.2

package/lib/mjs/CrmApp.js

@@ -1,17 +1,46 @@
-import { IdentityType } from "@etsoo/appscript";
+import { IdentityTypeFlags } from "@etsoo/appscript";
 import { PersonApi } from "./PersonApi";
 import { useRequiredContext } from "@etsoo/react";
-import { ReactAppContext } from "@etsoo/materialui";
-import { PersonTitle } from "./dto/person/PersonTitle";
-import { MaritalStatus } from "./dto/person/MaritalStatus";
-import { PersonDegree } from "./dto/person/PersonDegree";
-import { PersonEducation } from "./dto/person/PersonEducation";
+import { ReactAppContext, ServiceApp } from "@etsoo/materialui";
 import { PersonProfileApi } from "./PersonProfileApi";
+import { Person } from "./utils/Person";
+import { PersonProfile } from "./utils/PersonProfile";
+import { SystemApi } from "./SystemApi";
+import { System } from "./utils/System";
+import { Permissions } from "./dto/system/Permissions";
+import { AssetApi } from "./AssetApi";
+import { CustomerApi } from "./CustomerApi";
+import { DeptApi } from "./DeptApi";
+import { GroupApi } from "./GroupApi";
+import { OrderApi } from "./OrderApi";
+import { POApi } from "./POApi";
+import { ProductApi } from "./ProductApi";
+import { SupplierApi } from "./SupplierApi";
+import { UserApi } from "./UserApi";
+import { PersonCategoryApi } from "./PersonCategoryApi";
+import { TagApi } from "./TagApi";
+import { DataTypes } from "@etsoo/shared";
+import { Product } from "./utils/Product";
+import { ProductCategoryApi } from "./ProductCategoryApi";
+import { PromotionApi } from "./PromotionApi";
+import { PersonAddressApi } from "./PersonAddressApi";
+import { PersonContactApi } from "./PersonContactApi";
+import { PersonInfoApi } from "./PersonInfoApi";
+import { PersonAddress } from "./utils/PersonAddress";
+import { PersonProductApi } from "./PersonProductApi";
+import { Order } from "./utils/Order";
+import { OrderDeliveryApi } from "./OrderDeliveryApi";
+import { OrderPaymentApi } from "./OrderPaymentApi";
+import { OrderLineApi } from "./OrderLineApi";
+import { POLineApi } from "./POLineApi";
+import { StockSiteApi } from "./StockSiteApi";
+import { StockApi } from "./StockApi";
+import { Stock } from "./utils/Stock";
 /**
  * Get CRM app context hook
  * @returns CRM app
  */
-export function useRequiredCrmContext() {
+export function useRequiredCrmApp() {
     // Get the app context
     const app = useRequiredContext(ReactAppContext);
     // Check the app type
@@ -22,6 +51,18 @@ export function useRequiredCrmContext() {
         return app;
     }
 }
+/**
+ * CRM service app base abstract class
+ * CRM 服务应用程序基类抽象类
+ */
+export class CrmAppBase extends ServiceApp {
+    /**
+     * Core name
+     */
+    get coreName() {
+        return "platform";
+    }
+}
 /**
  * CRM application
  * CRM应用程序
@@ -29,137 +70,375 @@ export function useRequiredCrmContext() {
 export class CrmApp {
     app;
     api;
+    _assetApi;
+    /**
+     * Asset API
+     * 资产接口
+     */
+    get assetApi() {
+        return (this._assetApi ??= new AssetApi(this.app));
+    }
+    _customerApi;
+    /**
+     * Customer API
+     * 客户接口
+     */
+    get customerApi() {
+        return (this._customerApi ??= new CustomerApi(this.app));
+    }
+    _deptApi;
+    /**
+     * Department API
+     * 部门接口
+     */
+    get deptApi() {
+        return (this._deptApi ??= new DeptApi(this.app));
+    }
+    _groupApi;
+    /**
+     * Permission group API
+     * 权限组接口
+     */
+    get groupApi() {
+        return (this._groupApi ??= new GroupApi(this.app));
+    }
+    _order;
+    /**
+     * Order
+     * 订单
+     */
+    get order() {
+        return (this._order ??= new Order(this));
+    }
+    _orderApi;
+    /**
+     * Order API
+     * 订单接口
+     */
+    get orderApi() {
+        return (this._orderApi ??= new OrderApi(this.app));
+    }
+    _orderLineApi;
+    /**
+     * Order line API
+     * 订单行接口
+     */
+    get orderLineApi() {
+        return (this._orderLineApi ??= new OrderLineApi(this.app));
+    }
+    _orderDeliveryApi;
+    /**
+     * Order delivery API
+     * 订单交付接口
+     */
+    get orderDeliveryApi() {
+        return (this._orderDeliveryApi ??= new OrderDeliveryApi(this.app));
+    }
+    _orderPaymentApi;
+    /**
+     * Order payment API
+     * 订单支付接口
+     */
+    get orderPaymentApi() {
+        return (this._orderPaymentApi ??= new OrderPaymentApi(this.app));
+    }
+    _person;
+    /**
+     * Person
+     * 人员
+     */
+    get person() {
+        return (this._person ??= new Person(this));
+    }
+    _personAddress;
+    /**
+     * Person address
+     * 人员地址
+     */
+    get personAddress() {
+        return (this._personAddress ??= new PersonAddress(this));
+    }
     _personApi;
     /**
      * Person API
      * 人员接口
      */
     get personApi() {
-        return (this._personApi ??= new PersonApi(this.app, this.api));
+        return (this._personApi ??= new PersonApi(this.app));
+    }
+    _personAddressApi;
+    /**
+     * Person address API
+     * 人员地址接口
+     */
+    get personAddressApi() {
+        return (this._personAddressApi ??= new PersonAddressApi(this.app));
+    }
+    _personContactApi;
+    /**
+     * Person contact API
+     * 人员联系人接口
+     */
+    get personContactApi() {
+        return (this._personContactApi ??= new PersonContactApi(this.app));
+    }
+    _personCategoryApi;
+    /**
+     * Person category API
+     * 人员分类接口
+     */
+    get personCategoryApi() {
+        return (this._personCategoryApi ??= new PersonCategoryApi(this.app, this.api));
+    }
+    _personInfoApi;
+    /**
+     * Person info API
+     * 人员信息接口
+     */
+    get personInfoApi() {
+        return (this._personInfoApi ??= new PersonInfoApi(this.app));
+    }
+    _personProductApi;
+    /**
+     * Person product API
+     * 人员自定义产品接口
+     */
+    get personProductApi() {
+        return (this._personProductApi ??= new PersonProductApi(this.app));
     }
-    _personProfileApi;
+    _profile;
+    /**
+     * Person profile
+     * 人员档案
+     */
+    get profile() {
+        return (this._profile ??= new PersonProfile(this));
+    }
+    _profileApi;
     /**
      * Person profile API
      * 人员档案接口
      */
-    get personProfileApi() {
-        return (this._personProfileApi ??= new PersonProfileApi(this.app, this.api));
+    get profileApi() {
+        return (this._profileApi ??= new PersonProfileApi(this.app));
     }
+    _poApi;
     /**
-     * Constructor
-     * 构造函数
-     * @param app Base application
-     * @param api API
+     * Purchase order API
+     * 采购接口
      */
-    constructor(app, api) {
-        this.app = app;
-        this.api = api;
+    get poApi() {
+        return (this._poApi ??= new POApi(this.app));
     }
+    _poLineApi;
     /**
-     * Get person gender
-     * 获取人员性别
-     * @param gender Gender value
-     * @returns Label
+     * Purchase order line API
+     * 采购行接口
      */
-    getPersonGender(gender) {
-        if (gender === "M")
-            return this.app.get("personMale") ?? "Male";
-        else if (gender === "F")
-            return this.app.get("personFemale") ?? "Female";
-        else
-            return undefined;
+    get poLineApi() {
+        return (this._poLineApi ??= new POLineApi(this.app));
     }
+    _product;
     /**
-     * Get identity type
-     * 获取身份类型
-     * @param data Identity type data
+     * Product
+     * 产品
      */
-    getIdentityType(data) {
-        if (data == null)
-            return "";
-        if (data.isOrg) {
-            return this.app.get("org");
-        }
-        const type = data.identityType;
-        return this.app
-            .getEnumList(IdentityType, "id", (id, _key) => {
-            if ((id & type) > 0)
-                return id;
-        })
-            .map((d) => d.label)
-            .join(", ");
+    get product() {
+        return (this._product ??= new Product(this));
+    }
+    _productApi;
+    /**
+     * Product API
+     * 产品接口
+     */
+    get productApi() {
+        return (this._productApi ??= new ProductApi(this.app));
     }
+    _productCategoryApi;
     /**
-     * Get marital status
-     * 获取婚姻状况
-     * @param status
+     * Product category API
+     * 产品分类接口
      */
-    getMaritalStatus(status) {
-        if (status == null)
-            return undefined;
-        const key = MaritalStatus[status];
-        return this.app.get("marital" + key) ?? key;
+    get productCategoryApi() {
+        return (this._productCategoryApi ??= new ProductCategoryApi(this.app, this.api));
     }
+    _promotionApi;
     /**
-     * Get marital statuses
-     * 获取婚姻状况列表
-     * @param status
+     * Promotion API
+     * 促销接口
      */
-    getMaritalStatuses() {
-        return this.app.getEnumList(MaritalStatus, "marital");
+    get promotionApi() {
+        return (this._promotionApi ??= new PromotionApi(this.app));
     }
+    _stock;
     /**
-     * Get person degree
-     * 获取人员学历
-     * @param degree
+     * Stock
+     * 库存
      */
-    getPersonDegree(degree) {
-        if (degree == null)
-            return undefined;
-        const key = PersonDegree[degree];
-        return this.app.get("degree" + key) ?? key;
+    get stock() {
+        return (this._stock ??= new Stock(this));
     }
+    _stockApi;
     /**
-     * Get person degree list
-     * 获取人员学历列表
+     * Stock API
+     * 库存接口
      */
-    getPersonDegrees() {
-        return this.app.getEnumList(PersonDegree, "degree");
+    get stockApi() {
+        return (this._stockApi ??= new StockApi(this.app));
     }
+    _stockSiteApi;
     /**
-     * Get person education
-     * 获取人员学历
-     * @param education
+     * Stock site API
+     * 库存点接口
      */
-    getPersonEducation(education) {
-        if (education == null)
-            return undefined;
-        const key = PersonEducation[education];
-        return this.app.get("education" + key) ?? key;
+    get stockSiteApi() {
+        return (this._stockSiteApi ??= new StockSiteApi(this.app));
     }
+    _supplierApi;
     /**
-     * Get person education list
-     * 获取人员学历列表
+     * Supplier API
+     * 供应商接口
      */
-    getPersonEducations() {
-        return this.app.getEnumList(PersonEducation, "education");
+    get supplierApi() {
+        return (this._supplierApi ??= new SupplierApi(this.app));
     }
+    _system;
     /**
-     * Get person title
-     * 获取人员头衔
-     * @param title
+     * System
+     * 系统
      */
-    getPersonTitle(title) {
-        if (title == null)
-            return undefined;
-        const key = PersonTitle[title];
-        return this.app.get("personTitle" + key) ?? key;
+    get system() {
+        return (this._system ??= new System(this));
+    }
+    _systemApi;
+    /**
+     * System API
+     * 系统接口
+     */
+    get systemApi() {
+        return (this._systemApi ??= new SystemApi(this.app));
+    }
+    _tagApi;
+    /**
+     * Tag API
+     * 标签接口
+     */
+    get tagApi() {
+        return (this._tagApi ??= new TagApi(this.app));
+    }
+    _userApi;
+    /**
+     * User API
+     * 用户接口
+     */
+    get userApi() {
+        return (this._userApi ??= new UserApi(this.app));
+    }
+    /**
+     * Constructor
+     * 构造函数
+     * @param app Base application
+     * @param api API
+     */
+    constructor(app, api) {
+        this.app = app;
+        this.api = api;
+    }
+    getIdentityType(permissions) {
+        let type = IdentityTypeFlags.None;
+        if (permissions[0]) {
+            type |= IdentityTypeFlags.User;
+        }
+        if (permissions[1]) {
+            type |= IdentityTypeFlags.Customer;
+        }
+        if (permissions[2]) {
+            type |= IdentityTypeFlags.Supplier;
+        }
+        if (permissions[3]) {
+            type |= IdentityTypeFlags.Org;
+        }
+        if (permissions[4]) {
+            type |= IdentityTypeFlags.Dept;
+        }
+        return type;
+    }
+    /**
+     * Get person identity type
+     * 获取人员身份类型
+     * @returns Identity type flags
+     */
+    getPersonIdentityType() {
+        const permissions = [
+            Permissions.User.Query,
+            Permissions.Customer.Query,
+            Permissions.Supplier.Query,
+            Permissions.Org.Query,
+            Permissions.Dept.Query
+        ].map((p) => this.owns(p));
+        return this.getIdentityType(permissions);
+    }
+    /**
+     * Get profile identity type
+     * 获取档案身份类型
+     * @returns Identity type flags
+     */
+    getProfileIdentityType() {
+        const permissions = [
+            Permissions.User.QueryProfile,
+            Permissions.Customer.QueryProfile,
+            Permissions.Supplier.QueryProfile,
+            Permissions.Org.QueryProfile,
+            Permissions.Dept.QueryProfile
+        ].map((p) => this.owns(p));
+        return this.getIdentityType(permissions);
+    }
+    /**
+     * Has review permission for the identity
+     * 是否有查看权限
+     * @param identity Identity
+     * @returns Result
+     */
+    hasView(identity) {
+        return this.ownsIdentity(identity, "View");
+    }
+    /**
+     * Owns the permission item
+     * 是否有权限项
+     * @param item Permission item ID
+     * @returns Result
+     */
+    owns(item) {
+        // Check the 'all' permission first
+        const m = item.toStep(1000);
+        if (this.app.userData?.permissionItems.includes(m)) {
+            return true;
+        }
+        if (m === item) {
+            // Directly return to avoid additional checking
+            return false;
+        }
+        return this.app.userData?.permissionItems.includes(item) ?? false;
     }
     /**
-     * Get person titles
-     * 获取人员头衔
+     * Check if the identity owns the permission item
+     * 检查身份是否拥有权限项
+     * @param identity Identity type flags
+     * @param name Permission name
+     * @returns Result
      */
-    getPersonTitles() {
-        return this.app.getEnumList(PersonTitle, "personTitle");
+    ownsIdentity(identity, name) {
+        const identityMap = [
+            { flag: IdentityTypeFlags.User, perm: Permissions.User },
+            { flag: IdentityTypeFlags.Customer, perm: Permissions.Customer },
+            { flag: IdentityTypeFlags.Supplier, perm: Permissions.Supplier },
+            { flag: IdentityTypeFlags.Org, perm: Permissions.Org },
+            { flag: IdentityTypeFlags.Dept, perm: Permissions.Dept }
+        ];
+        return identityMap.some(({ flag, perm }) => identity & flag &&
+            (() => {
+                const item = DataTypes.getEnumByKey(perm, name);
+                return item && this.owns(item);
+            })());
     }
 }

package/lib/mjs/CrmUser.d.ts

@@ -0,0 +1,23 @@
+import { IServiceUser } from "@etsoo/materialui";
+import { SystemSettings } from "./dto/system/SystemSettings";
+/**
+ * CRM user interface
+ * CRM 用户接口
+ */
+export interface CrmUser extends IServiceUser {
+    /**
+     * System settings
+     * 系统设置
+     */
+    system?: SystemSettings;
+    /**
+     * Current user permission items
+     * 当前用户权限项
+     */
+    permissionItems: number[];
+    /**
+     * Current user person ID
+     * 当前用户人员编号
+     */
+    userPersonId: number;
+}

package/lib/mjs/CustomerApi.d.ts

@@ -0,0 +1,79 @@
+import { AppActionData, EntityApi, IApi, IApiPayload, IApp, IdResultPayload } from "@etsoo/appscript";
+import { CustomerListRQ } from "./rq/customer/CustomerListRQ";
+import { CustomerListData } from "./dto/customer/CustomerListData";
+import { CustomerQueryRQ } from "./rq/customer/CustomerQueryRQ";
+import { CustomerQueryData } from "./dto/customer/CustomerQueryData";
+import { CustomerUpdateRQ } from "./rq/customer/CustomerUpdateRQ";
+import { CustomerUpdateReadData } from "./dto/customer/CustomerUpdateReadData";
+import { CustomerCreateRQ } from "./rq/customer/CustomerCreateRQ";
+import { CustomerReadForSaleData } from "./dto/customer/CustomerReadForSaleData";
+import { CustomerReadForSaleRQ } from "./rq/customer/CustomerReadForSaleRQ";
+import { DocumentActionRQ } from "./rq/DocumentActionRQ";
+/**
+ * Customer API
+ */
+export declare class CustomerApi extends EntityApi {
+    /**
+     * Constructor
+     * @param app Application
+     * @param api API
+     */
+    constructor(app: IApp, api?: IApi);
+    /**
+     * Create
+     * @param rq Request data
+     * @param payload Payload
+     * @returns Result
+     */
+    create(rq: CustomerCreateRQ, payload?: IdResultPayload): Promise<import("@etsoo/shared").IdActionResult | undefined>;
+    /**
+     * Document action data
+     * 文档操作数据
+     * @param rq Request data
+     * @param payload Payload
+     * @returns Result
+     */
+    documentAction(rq: DocumentActionRQ, payload?: IApiPayload<AppActionData>): Promise<AppActionData | undefined>;
+    /**
+     * List
+     * @param rq Request data
+     * @param payload Payload
+     * @returns Result
+     */
+    list(rq: CustomerListRQ, payload?: IApiPayload<CustomerListData[]>): Promise<CustomerListData[] | undefined>;
+    /**
+     * Query
+     * @param rq Request data
+     * @param payload Payload
+     * @returns Result
+     */
+    query(rq: CustomerQueryRQ, payload?: IApiPayload<CustomerQueryData[]>): Promise<CustomerQueryData[] | undefined>;
+    /**
+     * Get customer info for sale
+     * @param rq Request data
+     * @param payload Payload
+     * @returns Result
+     */
+    readForSale(rq: CustomerReadForSaleRQ, payload?: IApiPayload<CustomerReadForSaleData>): Promise<CustomerReadForSaleData | undefined>;
+    /**
+     * Report action data
+     * 报告操作数据
+     * @param payload Payload
+     * @returns Result
+     */
+    reportAction(payload?: IApiPayload<AppActionData>): Promise<AppActionData | undefined>;
+    /**
+     * Update
+     * @param rq Request data
+     * @param payload Payload
+     * @returns Result
+     */
+    update(rq: CustomerUpdateRQ, payload?: IdResultPayload): Promise<import("@etsoo/shared").IdActionResult | undefined>;
+    /**
+     * Update read
+     * @param id Id
+     * @param payload Payload
+     * @returns Result
+     */
+    updateRead(id: number, payload?: IApiPayload<CustomerUpdateReadData>): Promise<CustomerUpdateReadData | undefined>;
+}