@etsoo/smarterp-crm 1.0.0 → 1.0.2

package/src/CrmApp.ts

@@ -1,20 +1,48 @@
-import { IApi, IApp, IdentityType } from "@etsoo/appscript";
+import { IApi, IdentityTypeFlags } from "@etsoo/appscript";
 import { PersonApi } from "./PersonApi";
 import { useRequiredContext } from "@etsoo/react";
-import { IServiceApp, ReactAppContext } from "@etsoo/materialui";
-import { IdentityTypeData } from "./dto/person/ContactItem";
-import { PersonTitle } from "./dto/person/PersonTitle";
-import { ListType } from "@etsoo/shared";
-import { MaritalStatus } from "./dto/person/MaritalStatus";
-import { PersonDegree } from "./dto/person/PersonDegree";
-import { PersonEducation } from "./dto/person/PersonEducation";
+import { IServiceApp, 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 { CrmUser } from "./CrmUser";
+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(): ICrmApp {
+export function useRequiredCrmApp(): ICrmApp {
   // Get the app context
   const app = useRequiredContext(ReactAppContext) as ICrmServiceApp;
 
@@ -32,6 +60,19 @@ export function useRequiredCrmContext(): ICrmApp {
  */
 export type ICrmServiceApp = IServiceApp & (ICrmApp | { crm: ICrmApp });
 
+/**
+ * CRM service app base abstract class
+ * CRM 服务应用程序基类抽象类
+ */
+export abstract class CrmAppBase extends ServiceApp<CrmUser> {
+  /**
+   * Core name
+   */
+  override get coreName(): string {
+    return "platform";
+  }
+}
+
 /**
  * CRM application interface
  * CRM应用程序接口
@@ -41,7 +82,67 @@ export interface ICrmApp {
    * Application
    * 应用程序
    */
-  get app(): IApp;
+  get app(): CrmAppBase;
+
+  /**
+   * Asset API
+   * 资产接口
+   */
+  readonly assetApi: AssetApi;
+
+  /**
+   * Customer API
+   * 客户接口
+   */
+  readonly customerApi: CustomerApi;
+
+  /**
+   * Department API
+   * 部门接口
+   */
+  readonly deptApi: DeptApi;
+
+  /**
+   * Permission group API
+   * 权限组接口
+   */
+  readonly groupApi: GroupApi;
+
+  /**
+   * Order
+   * 订单
+   */
+  readonly order: Order;
+
+  /**
+   * Order API
+   * 订单接口
+   */
+  readonly orderApi: OrderApi;
+
+  /**
+   * Order line API
+   * 订单行接口
+   */
+  readonly orderLineApi: OrderLineApi;
+
+  /**
+   * Order delivery API
+   * 订单交付接口
+   */
+  readonly orderDeliveryApi: OrderDeliveryApi;
+
+  /**
+   * Order payment API
+   * 订单支付接口
+   */
+  readonly orderPaymentApi: OrderPaymentApi;
+
+  /**
+   * Person
+   * 人员
+   */
+  readonly person: Person;
 
   /**
    * Person API
@@ -49,79 +150,172 @@ export interface ICrmApp {
    */
   readonly personApi: PersonApi;
 
+  /**
+   * Person address
+   * 人员地址
+   */
+  readonly personAddress: PersonAddress;
+
+  /**
+   * Person address API
+   * 人员地址接口
+   */
+  readonly personAddressApi: PersonAddressApi;
+
+  /**
+   * Person contact API
+   * 人员联系人接口
+   */
+  readonly personContactApi: PersonContactApi;
+
+  /**
+   * Person category API
+   * 人员分类接口
+   */
+  readonly personCategoryApi: PersonCategoryApi;
+
+  /**
+   * Person info API
+   * 人员信息接口
+   */
+  readonly personInfoApi: PersonInfoApi;
+
+  /**
+   * Person product API
+   * 人员自定义产品接口
+   */
+  readonly personProductApi: PersonProductApi;
+
+  /**
+   * Person profile
+   * 人员档案
+   */
+  readonly profile: PersonProfile;
+
   /**
    * Person profile API
    * 人员档案接口
    */
-  readonly personProfileApi: PersonProfileApi;
+  readonly profileApi: PersonProfileApi;
+
+  /**
+   * Purchase order API
+   * 采购接口
+   */
+  readonly poApi: POApi;
+
+  /**
+   * Purchase order line API
+   * 采购行接口
+   */
+  readonly poLineApi: POLineApi;
+
+  /**
+   * Product
+   * 产品
+   */
+  readonly product: Product;
+
+  /**
+   * Product category API
+   * 产品分类接口
+   */
+  readonly productCategoryApi: ProductCategoryApi;
+
+  /**
+   * Product API
+   * 产品接口
+   */
+  readonly productApi: ProductApi;
+
+  /**
+   * Promotion API
+   * 促销接口
+   */
+  readonly promotionApi: PromotionApi;
+
+  /**
+   * Stock
+   * 库存
+   */
+  readonly stock: Stock;
+
+  /**
+   * Stock API
+   * 库存接口
+   */
+  readonly stockApi: StockApi;
 
   /**
-   * Get marital status
-   * 获取婚姻状况
-   * @param status
+   * Stock site API
+   * 库存点接口
    */
-  getMaritalStatus(status?: MaritalStatus): string | undefined;
+  readonly stockSiteApi: StockSiteApi;
 
   /**
-   * Get marital statuses
-   * 获取婚姻状况列表
-   * @param status
+   * Supplier API
+   * 供应商接口
    */
-  getMaritalStatuses(): ListType[];
+  readonly supplierApi: SupplierApi;
 
   /**
-   * Get person degree
-   * 获取人员学历
-   * @param degree
+   * System
+   * 系统
    */
-  getPersonDegree(degree?: PersonDegree): string | undefined;
+  readonly system: System;
 
   /**
-   * Get person degree list
-   * 获取人员学历列表
+   * System API
+   * 系统接口
    */
-  getPersonDegrees(): ListType[];
+  readonly systemApi: SystemApi;
 
   /**
-   * Get person education
-   * 获取人员学历
-   * @param education
+   * Tag API
+   * 标签接口
    */
-  getPersonEducation(education?: PersonEducation): string | undefined;
+  readonly tagApi: TagApi;
 
   /**
-   * Get person education list
-   * 获取人员学历列表
+   * User API
+   * 用户接口
    */
-  getPersonEducations(): ListType[];
+  readonly userApi: UserApi;
 
   /**
-   * Get person gender
-   * 获取人员性别
-   * @param gender Gender value
-   * @returns Label
+   * Get person identity type
+   * 获取人员身份类型
+   * @returns Identity type flags
    */
-  getPersonGender(gender?: string): string | undefined;
+  getPersonIdentityType(): IdentityTypeFlags;
 
   /**
-   * Get identity type
-   * 获取身份类型
-   * @param data Identity type data
+   * Has review permission for the identity
+   * 是否有查看权限
+   * @param identity Identity
+   * @returns Result
    */
-  getIdentityType(data?: IdentityTypeData): string;
+  hasView(identity: IdentityTypeFlags): boolean;
 
   /**
-   * Get person title
-   * 获取人员头衔
-   * @param title
+   * Owns the permission item
+   * 是否有权限项
+   * @param item Permission item ID
+   * @returns Result
    */
-  getPersonTitle(title?: PersonTitle): string | undefined;
+  owns(item: number): boolean;
 
   /**
-   * Get person titles
-   * 获取人员头衔
+   * Check if the identity owns the permission item
+   * 检查身份是否拥有权限项
+   * @param identity Identity type flags
+   * @param name Permission name
+   * @returns Result
    */
-  getPersonTitles(): ListType[];
+  ownsIdentity(
+    identity: IdentityTypeFlags,
+    name: Permissions.IdentityName
+  ): boolean;
 }
 
 /**
@@ -129,142 +323,435 @@ export interface ICrmApp {
  * CRM应用程序
  */
 export class CrmApp implements ICrmApp {
+  private _assetApi?: AssetApi;
+  /**
+   * Asset API
+   * 资产接口
+   */
+  get assetApi() {
+    return (this._assetApi ??= new AssetApi(this.app));
+  }
+
+  private _customerApi?: CustomerApi;
+  /**
+   * Customer API
+   * 客户接口
+   */
+  get customerApi() {
+    return (this._customerApi ??= new CustomerApi(this.app));
+  }
+
+  private _deptApi?: DeptApi;
+  /**
+   * Department API
+   * 部门接口
+   */
+  get deptApi() {
+    return (this._deptApi ??= new DeptApi(this.app));
+  }
+
+  private _groupApi?: GroupApi;
+  /**
+   * Permission group API
+   * 权限组接口
+   */
+  get groupApi() {
+    return (this._groupApi ??= new GroupApi(this.app));
+  }
+
+  private _order?: Order;
+  /**
+   * Order
+   * 订单
+   */
+  get order(): Order {
+    return (this._order ??= new Order(this));
+  }
+
+  private _orderApi?: OrderApi;
+  /**
+   * Order API
+   * 订单接口
+   */
+  get orderApi() {
+    return (this._orderApi ??= new OrderApi(this.app));
+  }
+
+  private _orderLineApi?: OrderLineApi;
+  /**
+   * Order line API
+   * 订单行接口
+   */
+  get orderLineApi() {
+    return (this._orderLineApi ??= new OrderLineApi(this.app));
+  }
+
+  private _orderDeliveryApi?: OrderDeliveryApi;
+  /**
+   * Order delivery API
+   * 订单交付接口
+   */
+  get orderDeliveryApi() {
+    return (this._orderDeliveryApi ??= new OrderDeliveryApi(this.app));
+  }
+
+  private _orderPaymentApi?: OrderPaymentApi;
+  /**
+   * Order payment API
+   * 订单支付接口
+   */
+  get orderPaymentApi() {
+    return (this._orderPaymentApi ??= new OrderPaymentApi(this.app));
+  }
+
+  private _person?: Person;
+  /**
+   * Person
+   * 人员
+   */
+  get person(): Person {
+    return (this._person ??= new Person(this));
+  }
+
+  private _personAddress?: PersonAddress;
+  /**
+   * Person address
+   * 人员地址
+   */
+  get personAddress(): PersonAddress {
+    return (this._personAddress ??= new PersonAddress(this));
+  }
+
   private _personApi?: PersonApi;
   /**
    * Person API
    * 人员接口
    */
   get personApi() {
-    return (this._personApi ??= new PersonApi(this.app, this.api));
+    return (this._personApi ??= new PersonApi(this.app));
+  }
+
+  private _personAddressApi?: PersonAddressApi;
+  /**
+   * Person address API
+   * 人员地址接口
+   */
+  get personAddressApi() {
+    return (this._personAddressApi ??= new PersonAddressApi(this.app));
+  }
+
+  private _personContactApi?: PersonContactApi;
+  /**
+   * Person contact API
+   * 人员联系人接口
+   */
+  get personContactApi() {
+    return (this._personContactApi ??= new PersonContactApi(this.app));
+  }
+
+  private _personCategoryApi?: PersonCategoryApi;
+  /**
+   * Person category API
+   * 人员分类接口
+   */
+  get personCategoryApi() {
+    return (this._personCategoryApi ??= new PersonCategoryApi(
+      this.app,
+      this.api
+    ));
+  }
+
+  private _personInfoApi?: PersonInfoApi;
+  /**
+   * Person info API
+   * 人员信息接口
+   */
+  get personInfoApi() {
+    return (this._personInfoApi ??= new PersonInfoApi(this.app));
   }
 
-  private _personProfileApi?: PersonProfileApi;
+  private _personProductApi?: PersonProductApi;
+  /**
+   * Person product API
+   * 人员自定义产品接口
+   */
+  get personProductApi() {
+    return (this._personProductApi ??= new PersonProductApi(this.app));
+  }
+
+  private _profile?: PersonProfile;
+  /**
+   * Person profile
+   * 人员档案
+   */
+  get profile(): PersonProfile {
+    return (this._profile ??= new PersonProfile(this));
+  }
+
+  private _profileApi?: PersonProfileApi;
   /**
    * Person profile API
    * 人员档案接口
    */
-  get personProfileApi() {
-    return (this._personProfileApi ??= new PersonProfileApi(
+  get profileApi() {
+    return (this._profileApi ??= new PersonProfileApi(this.app));
+  }
+
+  private _poApi?: POApi;
+  /**
+   * Purchase order API
+   * 采购接口
+   */
+  get poApi() {
+    return (this._poApi ??= new POApi(this.app));
+  }
+
+  private _poLineApi?: POLineApi;
+  /**
+   * Purchase order line API
+   * 采购行接口
+   */
+  get poLineApi() {
+    return (this._poLineApi ??= new POLineApi(this.app));
+  }
+
+  private _product?: Product;
+
+  /**
+   * Product
+   * 产品
+   */
+  get product(): Product {
+    return (this._product ??= new Product(this));
+  }
+
+  private _productApi?: ProductApi;
+  /**
+   * Product API
+   * 产品接口
+   */
+  get productApi() {
+    return (this._productApi ??= new ProductApi(this.app));
+  }
+
+  private _productCategoryApi?: ProductCategoryApi;
+  /**
+   * Product category API
+   * 产品分类接口
+   */
+  get productCategoryApi() {
+    return (this._productCategoryApi ??= new ProductCategoryApi(
       this.app,
       this.api
     ));
   }
 
+  private _promotionApi?: PromotionApi;
   /**
-   * Constructor
-   * 构造函数
-   * @param app Base application
-   * @param api API
+   * Promotion API
+   * 促销接口
    */
-  constructor(public readonly app: IApp, public readonly api: IApi) {}
+  get promotionApi() {
+    return (this._promotionApi ??= new PromotionApi(this.app));
+  }
 
+  private _stock?: Stock;
   /**
-   * Get person gender
-   * 获取人员性别
-   * @param gender Gender value
-   * @returns Label
+   * Stock
+   * 库存
    */
-  getPersonGender(gender?: string) {
-    if (gender === "M") return this.app.get("personMale") ?? "Male";
-    else if (gender === "F") return this.app.get("personFemale") ?? "Female";
-    else return undefined;
+  get stock(): Stock {
+    return (this._stock ??= new Stock(this));
   }
 
+  private _stockApi?: StockApi;
   /**
-   * Get identity type
-   * 获取身份类型
-   * @param data Identity type data
+   * Stock API
+   * 库存接口
    */
-  getIdentityType(data?: IdentityTypeData) {
-    if (data == null) return "";
+  get stockApi() {
+    return (this._stockApi ??= new StockApi(this.app));
+  }
 
-    if (data.isOrg) {
-      return this.app.get("org")!;
-    }
+  private _stockSiteApi?: StockSiteApi;
+  /**
+   * Stock site API
+   * 库存点接口
+   */
+  get stockSiteApi() {
+    return (this._stockSiteApi ??= new StockSiteApi(this.app));
+  }
+
+  private _supplierApi?: SupplierApi;
+  /**
+   * Supplier API
+   * 供应商接口
+   */
+  get supplierApi() {
+    return (this._supplierApi ??= new SupplierApi(this.app));
+  }
+
+  private _system?: System;
+  /**
+   * System
+   * 系统
+   */
+  get system(): System {
+    return (this._system ??= new System(this));
+  }
 
-    const type = data.identityType;
-    return this.app
-      .getEnumList(IdentityType, "id", (id, _key) => {
-        if ((id & type) > 0) return id;
-      })
-      .map((d) => d.label)
-      .join(", ");
+  private _systemApi?: SystemApi;
+  /**
+   * System API
+   * 系统接口
+   */
+  get systemApi() {
+    return (this._systemApi ??= new SystemApi(this.app));
   }
 
+  private _tagApi?: TagApi;
   /**
-   * Get marital status
-   * 获取婚姻状况
-   * @param status
+   * Tag API
+   * 标签接口
    */
-  getMaritalStatus(status?: MaritalStatus) {
-    if (status == null) return undefined;
-    const key = MaritalStatus[status];
-    return this.app.get("marital" + key) ?? key;
+  get tagApi() {
+    return (this._tagApi ??= new TagApi(this.app));
   }
 
+  private _userApi?: UserApi;
   /**
-   * Get marital statuses
-   * 获取婚姻状况列表
-   * @param status
+   * User API
+   * 用户接口
    */
-  getMaritalStatuses() {
-    return this.app.getEnumList(MaritalStatus, "marital");
+  get userApi() {
+    return (this._userApi ??= new UserApi(this.app));
   }
 
   /**
-   * Get person degree
-   * 获取人员学历
-   * @param degree
+   * Constructor
+   * 构造函数
+   * @param app Base application
+   * @param api API
    */
-  getPersonDegree(degree?: PersonDegree) {
-    if (degree == null) return undefined;
-    const key = PersonDegree[degree];
-    return this.app.get("degree" + key) ?? key;
+  constructor(
+    public readonly app: CrmAppBase,
+    public readonly api: IApi
+  ) {}
+
+  private getIdentityType(permissions: boolean[]) {
+    let type: IdentityTypeFlags = 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 degree list
-   * 获取人员学历列表
+   * Get person identity type
+   * 获取人员身份类型
+   * @returns Identity type flags
    */
-  getPersonDegrees() {
-    return this.app.getEnumList(PersonDegree, "degree");
+  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 person education
-   * 获取人员学历
-   * @param education
+   * Get profile identity type
+   * 获取档案身份类型
+   * @returns Identity type flags
    */
-  getPersonEducation(education?: PersonEducation) {
-    if (education == null) return undefined;
-    const key = PersonEducation[education];
-    return this.app.get("education" + key) ?? key;
+  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);
   }
 
   /**
-   * Get person education list
-   * 获取人员学历列表
+   * Has review permission for the identity
+   * 是否有查看权限
+   * @param identity Identity
+   * @returns Result
    */
-  getPersonEducations() {
-    return this.app.getEnumList(PersonEducation, "education");
+  hasView(identity: IdentityTypeFlags) {
+    return this.ownsIdentity(identity, "View");
   }
 
   /**
-   * Get person title
-   * 获取人员头衔
-   * @param title
+   * Owns the permission item
+   * 是否有权限项
+   * @param item Permission item ID
+   * @returns Result
    */
-  getPersonTitle(title?: PersonTitle) {
-    if (title == null) return undefined;
-    const key = PersonTitle[title];
-    return this.app.get("personTitle" + key) ?? key;
+  owns(item: number) {
+    // 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: IdentityTypeFlags, name: Permissions.IdentityName) {
+    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);
+        })()
+    );
   }
 }