ionic-vhframeworks 4.1.5 → 4.1.8

package/lib/ionic-vhframeworks.service.d.ts

@@ -29,6 +29,16 @@ export declare class VhAlgorithm {
     private papa;
     private dom;
     constructor(platform: Platform, file: File, socialSharing: SocialSharing, papa: Papa, dom: DomSanitizer);
+    /**
+     * Hàm này kiểm tra ngày trên bill có phải là ngày hiện tại của thiết bị không
+     * @Example :
+     * if(this.vhAlgorithm.isToday(date)){
+     *       //Your code
+     * }
+     * @param date : ngày trên bill
+     * @returns true: nếu ngày trên bill trùng với ngày của thiết bị; false: nếu ngày trên bill khác với ngày của thiết bị
+     */
+    isToday(date: any): boolean;
     /**
      * Hàm này so sanh sâu 2 object bằng nhau
      * @param object1
@@ -42,6 +52,11 @@ export declare class VhAlgorithm {
      * @returns
      */
     isObject(object: any): boolean;
+    /**
+     * Hàm này tạo chuỗi số, ký tự ngẫy nhiên có chiều dài là length
+     * @param length
+     * @returns
+     */
     ObjectId(length?: number): string;
     /**
       * @example:
@@ -85,7 +100,17 @@ export declare class VhAlgorithm {
      */
     exportCSV(headerRow: any, csvData: any, filename: any): void;
     waitingStack(): Promise<unknown>;
+    /**
+     * Hàm trả về mảng có đối tượng trong array_list thỏa điều kiện tìm kiếm
+     * @param value : giá trị cần search
+     * @param array_list : mảng các đối tượng
+     * @param array_field : mảng các trường của đối tượng sẽ đc search
+     * @returns Array
+     */
     searchList(value: any, array_list: any, array_field: any): any[];
+    /**
+     * Ham đổi chuỗi alias có dấu thành không dấu
+     */
     changeAlias(alias: any): any;
     /**
      * @example
@@ -139,13 +164,14 @@ export declare class VhAlgorithm {
     sortNumberbyASC(array: any, field: any): any;
     sortNumberbyDESC(array: any, field: any): any;
     /**
-   * Số ngày trong tháng của một thời gian
+   * Hàm trả về số ngày trong tháng của một thời gian
    * @param year
    * @param month
    */
     getNumberOfDaysInMonth(year: number, month: number): 31 | 29 | 28 | 30;
     Compare(field: any, condition: any, value: any): boolean;
     /**
+     * Hàm đổi chuỗi sang object
     * @example: data = "{"field":1, "field2": "val"}";
     *  => data = {
     *               field1: 1,
@@ -156,6 +182,7 @@ export declare class VhAlgorithm {
     */
     convert_STRING2OBJECT(string: any): any;
     /**
+     * Hàm đổi object sang chuỗi
     * @example:
     *  data = {
     *            field1: 1,
@@ -407,7 +434,7 @@ export declare class VhAuth {
     private initializeDB;
     /**
      * @example:
-     * this.vhAuth.initializeProject('vhsales','firebase-mongo','research','research', 394637, 'all');
+     * this.vhAuth.initializeProject('vhsales','firebase-mongo','research','research', 324852, 'all');
      * @param projectname
      * @param dbstorage
      * @param dbserverversion
@@ -419,7 +446,7 @@ export declare class VhAuth {
     initializeProject(projectname: string, dbstorage: string, dbserverversion: string, camserverversion: string, fwcode: number, database: string): any;
     /**
      * @example:
-     * this.vhAuth.initializeWebAppProject('vhsales', 394637, 'all');
+     * this.vhAuth.initializeWebAppProject('vhsales', 356842, 'all');
      * @param projectname
      * @param fwcode
      * @param database : tất cả database 'all' hoặc một database nào đó '4wk3JMSwSjh4kOLWOMbLbWt0Rdk2'
@@ -502,6 +529,8 @@ export declare class VhAuth {
      */
     refreshLocalMyPermission(): Promise<unknown>;
     /**
+     * Hàm này chỉ trả về kết quả chính xác khi mà các permission_name có giá trị trả về là kiểu boolean
+     * Hàm checkMyPermission tương đương hàm checkLocalMyPermissionName, sau này sẽ bỏ hàm checkMyPermission
      * @example:
       if(this.VhQuerySales.checkMyPermission('login_enable_login')){
         this.login();
@@ -530,6 +559,17 @@ export declare class VhAuth {
      * @return number/string/object
      */
     getLocalMyPermissionName(permission_name: any): any;
+    /**
+     * @example:
+      this.VhQuerySales.updatePermission('2rVieBQTubQ2hjUnpwU4w7qSlD83',{login_enable_login: false, default_display_page: 'admin_display_page'})
+          .then((result)=>{
+            console.log(result);
+          })
+     * @format value = {login_enable_login:true} or value = {login_reset_password:true}
+     * @param value
+     * @return Promise Boolean => true or false
+     */
+    updateMyPermission(value: object): Promise<unknown>;
     /**
     * @example:
      this.VhQuerySales.updatePermission('2rVieBQTubQ2hjUnpwU4w7qSlD83',{login_enable_login: false})
@@ -540,7 +580,7 @@ export declare class VhAuth {
     * @param value
     * @return Promise Boolean => true or false
     */
-    updatePermission(id_employee: any, value: any): Promise<unknown>;
+    updatePermission(id_employee: string, value: object): Promise<unknown>;
     /**
      * Hàm này lấy về phân quyền của nhân viên
      * Lưu ý không dùng hàm này cho Boss, vì Boss không bị giới hạn phân quyền
@@ -3425,6 +3465,21 @@ export declare class VhQueryCafe {
     * @return — Array -> array = [{},{},...]
     */
     getBills(query: object, projection?: object, sort?: object, limit?: number): Promise<unknown>;
+    /**
+    * @example:
+    * let time = new Date();
+    * time.setDate(time.getDate()-7);
+    * this.vhQueryCafe.getBills_byFields({date:{$gte:time}, {bill_type:{$eq:5}}, {},{date:1},0)
+          .then((bills)=>{
+            console.log('getBills', bills);
+          })
+    * @param query
+    * @param projection — đang tìm hiểu, tạm thời để giá trị là {}
+    * @param sort — null hoặc {}:không sắp xếp; {date:1}: sắp xếp theo ASC; {date:-1}: sắp xếp theo DESC
+    * @param limit — null hoặc 0: không giới hạn record get về; 2: get về 2 record
+    * @return — Array -> array = [{},{},...]
+    */
+    getBills_byFields(query: object, projection?: object, sort?: object, limit?: number): Promise<unknown>;
     /**
      * @example:
      * this.vhQueryCafe.createBill({name:'Cuối tuần vui vẻ', type:2, active:true, date_start:new Date(), date_end: new Date()})
@@ -7784,6 +7839,28 @@ export declare class VhQuerySales {
     private callbacksyncopeningbill;
     private sync_code;
     constructor(vhmongo_firebase: Vhmongo_firebase, vhQuery: VhQuery, vhAuth: VhAuth, vhAlgorithm: VhAlgorithm, iap2: InAppPurchase2, platform: Platform);
+    /**
+     * Hàm này lấy về các trường trong phạm vi quản lý bán hàng trong cài đặt
+      * @example:
+      * let sales_management_scope = this.vhQuerySales.getSales_Management_Scope();
+      * @return Object = {product_scope, employee_scope, customer_scope, supplier_scope, sales_program_scope}
+      *  => 1 áp dụng cho toàn chi nhánh, 2 áp dụng riêng cho từng chi nhánh
+      */
+    getSales_Management_Scope(): any;
+    /**
+     * Hàm này cấp nhật lại các trường trong phạm vi quản lý bán hàng trong cài đặt
+     * @example:
+     * this.vhQuerySales.updateSales_Management_Scope({product_scope:1, employee_scope:1, customer_scope:1, supplier_scope:1, sales_program_scope:2})
+            .then(()=>{
+              console.log('updateSales_Management_Scope');
+            }, error=>{
+              reject(error);
+            })
+     * @param value = {product_scope, employee_scope, customer_scope, supplier_scope, sales_program_scope}
+     * 1 áp dụng cho toàn chi nhánh, 2 áp dụng riêng cho từng chi nhánh
+     * @return Promise => udefined/error
+     */
+    updateSales_Management_Scope(value: any): Promise<unknown>;
     /**
       * @description: hàm này lấy về những hạn chế của gói main_package (khách trả phí mua gói sử dụng các chức năng CHÍNH, mỗi gói sẽ có nhưng hạn chế khác nhau về user_number, show_report_duration)
       * @example
@@ -9163,6 +9240,39 @@ export declare class VhQuerySales {
      * @return Promise => array(object) = [{},{},..]
      */
     getCustomers(): Promise<unknown>;
+    /**
+     * Hàm này dùng để xóa hoặc đặt lại điểm mới cho khách hàng
+     * @example:
+     * this.vhQuerySales.updateCustomer_byEarnedPoints('5fb6780ca2148e09806c5b01', 1000)
+            .then((bool)=>{
+              console.log('updateCustomer_byEarnedPoints', bool);
+            })
+     * @param _id
+     * @param points
+     * @return Promise => bool = true or false
+     */
+    updateCustomer_byPoints(_id: string, points: number): Promise<unknown>;
+    /**
+     * Hàm này thêm điểm mới kiếm được vào quỹ điểm khách hàng đang có
+     * points = points(tích được trên bill) - point (sử dụng thanh toán trên bill)
+     * @example:
+     * this.vhQuerySales.updateCustomer_byEarnedPoints('5fb6780ca2148e09806c5b01', 200)
+            .then((bool)=>{
+              console.log('updateCustomer_byEarnedPoints', bool);
+            })
+     * @param _id
+     * @param points
+     * @return Promise => bool = true or false
+     */
+    updateCustomer_byEarnedPoints(_id: string, points: number): Promise<unknown>;
+    /**
+     * Hàm này trả về điểm của khách hàng theo phạm vị chương trình bán hàng là toàn chi nhánh hay là từng chi nhánh
+     * @example:
+     * let customer = this.vhQuerySales.getlocalCustomer_byPoints('5fb6780ca2148e09806c5b01');
+     * @param id_customer
+     * @return Object => obj = {} or null
+     */
+    getlocalCustomerPoints(id_customer: any): any;
     private publishObservableEventSuppliers;
     private observableLocalSuppliers;
     /**
@@ -10884,6 +10994,21 @@ export declare class VhQuerySales {
      * @return — Array -> array = [{},{},...]
      */
     getBills(query: object, projection?: object, sort?: object, limit?: number): Promise<unknown>;
+    /**
+      * @example:
+      * let time = new Date();
+      * time.setDate(time.getDate()-7);
+      * this.vhQuerySales.getBills_byFields({date:{$gte:time}, {bill_type:{$eq:5}}, {},{date:1},0)
+            .then((bills)=>{
+              console.log('getBills', bills);
+            })
+      * @param query
+      * @param projection — đang tìm hiểu, tạm thời để giá trị là {}
+      * @param sort — null hoặc {}:không sắp xếp; {date:1}: sắp xếp theo ASC; {date:-1}: sắp xếp theo DESC
+      * @param limit — null hoặc 0: không giới hạn record get về; 2: get về 2 record
+      * @return — Array -> array = [{},{},...]
+      */
+    getBills_byFields(query: object, projection?: object, sort?: object, limit?: number): Promise<unknown>;
     /**
      * @example:
      * this.vhQuerySales.createBill({name:'Cuối tuần vui vẻ', type:2, active:true, date_start:new Date(), date_end: new Date()})
@@ -11429,7 +11554,7 @@ export declare class VhQuerySales {
     getLocalAppSettingNameStations(): any[];
     /**
      * @example:
-      let appsetting = this.vhQuerySales.getLocalAppSettingNameStation('info_header_footer_bill');
+      let appsetting = this.vhQuerySales.getLocalAppSettingNameStation('info_header_footer_bill'); //printer_config_selling_page
       console.log(appsetting);
      * @param appsetting_name
      * @return object => {title:'title',name:'name', quantity: 10}
@@ -11481,17 +11606,17 @@ export declare class VhQuerySales {
     private publishObservableEventAppSettingNameBranchs;
     private observableLocalAppSettingNameBranchs;
     /**
-    * Các hàm AppSettingNameBranchs thêm, xóa, sửa thông tin (dạng object) riêng giữa các chi nhánh, như: thông tin cửa hang
-    * @example:
-    * this.observableAppSettingName = this.vhQuerySales.getObservableLocalAppSettingNameBranchs().subscribe(() => {
-         let store_info = this.vhQuerySales.getLocalAppSettingNameBranch('store_info');
-         console.log(store_info);
-     })
-     ngOnDestroy(){
-       this.observableAppSettingName.unsubscribe();
-     }
-    * @returns Observerble (Array) => Array(object) => array = [{},{},...]
-    */
+     * Các hàm AppSettingNameBranchs thêm, xóa, sửa thông tin (dạng object) riêng giữa các chi nhánh, như: thông tin cửa hang
+     * @example:
+     * this.observableAppSettingName = this.vhQuerySales.getObservableLocalAppSettingNameBranchs().subscribe(() => {
+          let store_info = this.vhQuerySales.getLocalAppSettingNameBranch('store_info');
+          console.log(store_info);
+      })
+      ngOnDestroy(){
+        this.observableAppSettingName.unsubscribe();
+      }
+     * @returns Observerble (Array) => Array(object) => array = [{},{},...]
+     */
     getObservableLocalAppSettingNameBranchs(): Observable<unknown>;
     /**
     *@example:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ionic-vhframeworks",
-  "version": "4.1.5",
+  "version": "4.1.8",
   "peerDependencies": {},
   "dependencies": {
     "tslib": "^2.0.0"