@freedom_sky/feige-lib 5.20.0 → 5.22.0

package/AGENTS.md

@@ -0,0 +1,75 @@
+# AGENTS.md — feige-lib
+
+Shared business library consumed by every repo in the order-multi workspace
+(server, app, admin-server, admin-fe, client, etc.). Anything here is, by
+definition, **shared** — changes ripple across the whole system.
+
+## Local-dev distribution
+
+This package is published to npm. During cross-repo development you can iterate
+without bumping the version by rebuilding (`npx tsc`) and copying `dist/` into
+each consumer's `node_modules/@freedom_sky/feige-lib/dist/`. Only bump the
+version (`package.json` + `CHANGE.md`) and `npm publish` when you're ready to
+release — and only with explicit user approval.
+
+---
+
+## `CONST.UPPER_LIMIT` — naming and authoring rules
+
+`Const.UPPER_LIMIT` (see `src/const/const.ts`) holds every validation upper
+bound used by DTOs / schemas / UI in the workspace. The prefix on each key
+encodes **which domain owns the concept** — and any feature in any repo may
+reuse that constant when they're referencing the same concept.
+
+| Prefix | Meaning | Examples |
+|---|---|---|
+| `<DOMAIN>_` (e.g. `DISH_`, `MEMBER_`, `STORE_`, `TABLE_`, `TAKEOUT_`, `SPECIFICATION_`, `RESERVATION_`) | The constant belongs to that domain. Any feature that references the same concept reuses this key as-is. | `DISH_NAME_MAX_LENGTH`, `DISH_COUNT_MAX`, `MEMBER_NOTE_MAX_LENGTH`, `RESERVATION_NOTE_MAX_LENGTH` |
+| `COMMON_` | Generic limit with no single domain owner — applies across many features. | `COMMON_HEADCOUNT_MAX`, `COMMON_CONTACT_NAME_MAX_LENGTH`, `COMMON_CONTACT_PHONE_MAX_LENGTH` |
+
+**Decision flow for a new entry:**
+
+1. **Does an existing domain already own this concept?** Scan
+   `UPPER_LIMIT` for a `<DOMAIN>_` prefix that matches semantically. If yes,
+   reuse the existing key — even if your current feature is something else.
+   Example: reservation needs a max "dish count" → use `DISH_COUNT_MAX`, **not**
+   `RESERVATION_DISH_COUNT_MAX` and **not** `COMMON_DISH_COUNT_MAX`. The
+   concept is owned by the dish domain; reservation is just referencing dish.
+2. **No existing domain prefix, but the concept spans multiple unrelated
+   features?** Use `COMMON_`. Example: `COMMON_HEADCOUNT_MAX` —
+   dine-in / takeout / reservation can all hold a headcount; no single domain
+   owns it.
+3. **No existing prefix and only one feature will ever care?** Use that
+   feature's prefix. Example: `RESERVATION_NOTE_MAX_LENGTH` — the reservation
+   note is reservation-specific.
+
+**Forbidden combinations:**
+
+- `COMMON_<DOMAIN>_*` (e.g. `COMMON_DISH_*`) — self-contradicting; the
+  presence of `DISH_` already says "this lives in the dish domain". Drop
+  the `COMMON_`.
+- `<FEATURE>_<OTHER_DOMAIN>_*` (e.g. `RESERVATION_DISH_*`) — don't graft
+  your feature's prefix onto a concept that already has a domain. Reuse the
+  domain key directly.
+
+**Authoring rules:**
+
+1. **Look for an existing hardcoded value before inventing one.** A lot of
+   limits in this codebase started life as magic numbers in DTOs (`@Max(1000)`,
+   `@Length(1, 50)`, …). When extracting, **copy the existing value**, don't
+   pick a new one. That way a future "unify all usages" pass is a no-op for
+   behavior. Document where the value came from in the PR description /
+   commit, e.g.:
+
+   > `DISH_COUNT_MAX = 1000` — copied from
+   > `order-multi-server/src/orders/dto/create-order/create-order-base.dto.ts:83`
+   > `@Max(1000)`.
+
+2. **If no precedent exists, ask the user** for the value — do not guess.
+3. **Do not retro-edit old code** in the same change. Add the constant and
+   point new code at it. Sweeping the old hardcodes is a separate, dedicated
+   task to keep diffs reviewable.
+4. **Names use SCREAMING_SNAKE_CASE.** Suffix conventions:
+   - String fields → `..._MAX_LENGTH`
+   - Numeric counts/amounts → `..._MAX` (or no suffix when the name is already
+     unambiguous, matching the existing entries like `DISH_PRICE`,
+     `WAITER_NUM`).

package/CHANGE.md

@@ -1,3 +1,13 @@
+# 5.22.0
+- add Reservation and ReservationDish interfaces for cross-repo reservation feature (ReservationDish.type uses DishType enum; Reservation.status uses ReservationStatusEnum; Reservation.addTime accepts Date | string for BSON/wire compatibility)
+# 5.21.0
+- add ReservationStatusEnum (WAITING / CANCELLED / COMPLETED) for cross-repo reservation feature
+- add UPPER_LIMIT constants: COMMON_HEADCOUNT_MAX, COMMON_CONTACT_NAME_MAX_LENGTH, COMMON_CONTACT_PHONE_MAX_LENGTH, DISH_COUNT_MAX, DISH_NOTE_MAX_LENGTH, RESERVATION_NOTE_MAX_LENGTH
+- add AGENTS.md documenting UPPER_LIMIT naming rules (COMMON_ vs domain prefix)
+# 5.20.0
+- add ADDRESS_DETAIL_MAX_LENGTH constant
+# 5.19.0
+- add Store.location field for map-location feature
 # 4.45.0
 - add store auditedNames
 # 4.44.0

package/dist/const/const.d.ts

@@ -145,6 +145,12 @@ declare class Const {
         MEMBER_NOTE_MAX_LENGTH: number;
         MEMBER_TRANSACTION_NOTE_MAX_LENGTH: number;
         ADDRESS_DETAIL_MAX_LENGTH: number;
+        COMMON_HEADCOUNT_MAX: number;
+        COMMON_CONTACT_NAME_MAX_LENGTH: number;
+        COMMON_CONTACT_PHONE_MAX_LENGTH: number;
+        DISH_COUNT_MAX: number;
+        DISH_NOTE_MAX_LENGTH: number;
+        RESERVATION_NOTE_MAX_LENGTH: number;
     };
     BUSINESS: {
         BASE: {

package/dist/const/const.js

@@ -149,6 +149,12 @@ var Const = /** @class */ (function () {
             MEMBER_NOTE_MAX_LENGTH: 200,
             MEMBER_TRANSACTION_NOTE_MAX_LENGTH: 200,
             ADDRESS_DETAIL_MAX_LENGTH: 100,
+            COMMON_HEADCOUNT_MAX: 100,
+            COMMON_CONTACT_NAME_MAX_LENGTH: 50,
+            COMMON_CONTACT_PHONE_MAX_LENGTH: 30,
+            DISH_COUNT_MAX: 1000,
+            DISH_NOTE_MAX_LENGTH: 100,
+            RESERVATION_NOTE_MAX_LENGTH: 1000,
         };
         this.BUSINESS = {
             BASE: {

package/dist/enum/reservation.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum ReservationStatusEnum {
+    WAITING = "WAITING",
+    CANCELLED = "CANCELLED",
+    COMPLETED = "COMPLETED"
+}

package/dist/enum/reservation.enum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var ReservationStatusEnum;
+(function (ReservationStatusEnum) {
+    ReservationStatusEnum["WAITING"] = "WAITING";
+    ReservationStatusEnum["CANCELLED"] = "CANCELLED";
+    ReservationStatusEnum["COMPLETED"] = "COMPLETED";
+})(ReservationStatusEnum = exports.ReservationStatusEnum || (exports.ReservationStatusEnum = {}));

package/dist/index.d.ts

@@ -24,6 +24,7 @@ export * from './enum/receptionist.enum';
 export * from './enum/from.enum';
 export * from './enum/role.enum';
 export * from './enum/continent.enum';
+export * from './enum/reservation.enum';
 export * from './announcement/enum/announcement.enum';
 export * from './interfaces/member/member.interface';
 export * from './interfaces/member/member-transaction.interface';
@@ -36,6 +37,7 @@ export * from './interfaces/store/specification.interface';
 export * from './interfaces/store/menu-export.interface';
 export { MenuImportModeEnum } from './enum/menu-io.enum';
 export * from './interfaces/order';
+export * from './interfaces/reservation/reservation.interface';
 export { PayCompanyEnum } from './enum/pay-company.enum';
 import * as moment from 'moment';
 import Big from 'big.js';

package/dist/index.js

@@ -28,6 +28,7 @@ __export(require("./enum/receptionist.enum"));
 __export(require("./enum/from.enum"));
 __export(require("./enum/role.enum"));
 __export(require("./enum/continent.enum"));
+__export(require("./enum/reservation.enum"));
 __export(require("./announcement/enum/announcement.enum"));
 var menu_io_enum_1 = require("./enum/menu-io.enum");
 exports.MenuImportModeEnum = menu_io_enum_1.MenuImportModeEnum;

package/dist/interfaces/reservation/reservation.interface.d.ts

@@ -0,0 +1,46 @@
+import { ReservationStatusEnum } from '../../enum/reservation.enum';
+import { DishType } from '../../enum/dish.enum';
+export interface ReservationDish {
+    readonly dishId: string;
+    readonly count: number;
+    /** Used to flag weight-priced dishes. */
+    readonly type: DishType;
+    /** For dishes priced by weight. Only meaningful when type === DishType.Weigh. */
+    readonly weight?: number;
+    readonly specifications?: Array<{
+        readonly _id: string;
+        readonly selectedItems: string[];
+    }>;
+    readonly note?: string;
+}
+export interface Reservation {
+    readonly _id: string;
+    readonly storeId: string;
+    /** ISO local string "YYYY-MM-DDTHH:mm" — no seconds, no timezone. */
+    readonly reservationTime: string;
+    readonly headcount: number;
+    readonly contactName: string;
+    readonly contactPhone?: string;
+    readonly contactEmail?: string;
+    readonly tableNum?: string;
+    readonly reservationNote?: string;
+    readonly dishes: ReservationDish[];
+    readonly status: ReservationStatusEnum;
+    /**
+     * `Date` inside the server process (mongoose returns a Date instance);
+     * ISO `string` once the document has crossed JSON.stringify (HTTP wire,
+     * app side). Same dual-shape convention as `BaseOrder.date`. Normalize
+     * with `new Date(addTime)` if you need to do math — that constructor
+     * accepts either form.
+     */
+    readonly addTime: Date | string;
+    readonly operatorId?: string;
+    /**
+     * Set when this reservation has been bound to a real order via
+     * POST /orders. Optional: a reservation can also be marked COMPLETED
+     * without a backing order (e.g. manual no-show close-out).
+     */
+    readonly boundOrderId?: string;
+    /** Mongoose default version key — present on every document. */
+    readonly __v?: number;
+}

package/dist/interfaces/reservation/reservation.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freedom_sky/feige-lib",
-  "version": "5.20.0",
+  "version": "5.22.0",
   "description": "",
   "main": "dist/index.js",
   "scripts": {

package/src/const/const.ts

@@ -148,6 +148,12 @@ class Const {
         MEMBER_NOTE_MAX_LENGTH: 200,
         MEMBER_TRANSACTION_NOTE_MAX_LENGTH: 200,
         ADDRESS_DETAIL_MAX_LENGTH: 100,
+        COMMON_HEADCOUNT_MAX: 100,
+        COMMON_CONTACT_NAME_MAX_LENGTH: 50,
+        COMMON_CONTACT_PHONE_MAX_LENGTH: 30,
+        DISH_COUNT_MAX: 1000,
+        DISH_NOTE_MAX_LENGTH: 100,
+        RESERVATION_NOTE_MAX_LENGTH: 1000,
     };
     BUSINESS = {
         BASE: {

package/src/enum/reservation.enum.ts

@@ -0,0 +1,5 @@
+export enum ReservationStatusEnum {
+    WAITING = 'WAITING',
+    CANCELLED = 'CANCELLED',
+    COMPLETED = 'COMPLETED',
+}

package/src/index.ts

@@ -25,6 +25,7 @@ export * from './enum/receptionist.enum';
 export * from './enum/from.enum';
 export * from './enum/role.enum';
 export * from './enum/continent.enum';
+export * from './enum/reservation.enum';
 export * from './announcement/enum/announcement.enum';
 export * from './interfaces/member/member.interface';
 export * from './interfaces/member/member-transaction.interface';
@@ -37,6 +38,7 @@ export * from './interfaces/store/specification.interface';
 export * from './interfaces/store/menu-export.interface';
 export { MenuImportModeEnum } from './enum/menu-io.enum';
 export * from './interfaces/order';
+export * from './interfaces/reservation/reservation.interface';
 export { PayCompanyEnum } from './enum/pay-company.enum';
 import * as moment from 'moment';
 import Big from 'big.js';

package/src/interfaces/reservation/reservation.interface.ts

@@ -0,0 +1,48 @@
+import { ReservationStatusEnum } from '../../enum/reservation.enum';
+import { DishType } from '../../enum/dish.enum';
+
+export interface ReservationDish {
+    readonly dishId: string;
+    readonly count: number;
+    /** Used to flag weight-priced dishes. */
+    readonly type: DishType;
+    /** For dishes priced by weight. Only meaningful when type === DishType.Weigh. */
+    readonly weight?: number;
+    readonly specifications?: Array<{
+        readonly _id: string;
+        readonly selectedItems: string[];
+    }>;
+    readonly note?: string;
+}
+
+export interface Reservation {
+    readonly _id: string;
+    readonly storeId: string;
+    /** ISO local string "YYYY-MM-DDTHH:mm" — no seconds, no timezone. */
+    readonly reservationTime: string;
+    readonly headcount: number;
+    readonly contactName: string;
+    readonly contactPhone?: string;
+    readonly contactEmail?: string;
+    readonly tableNum?: string;
+    readonly reservationNote?: string;
+    readonly dishes: ReservationDish[];
+    readonly status: ReservationStatusEnum;
+    /**
+     * `Date` inside the server process (mongoose returns a Date instance);
+     * ISO `string` once the document has crossed JSON.stringify (HTTP wire,
+     * app side). Same dual-shape convention as `BaseOrder.date`. Normalize
+     * with `new Date(addTime)` if you need to do math — that constructor
+     * accepts either form.
+     */
+    readonly addTime: Date | string;
+    readonly operatorId?: string;
+    /**
+     * Set when this reservation has been bound to a real order via
+     * POST /orders. Optional: a reservation can also be marked COMPLETED
+     * without a backing order (e.g. manual no-show close-out).
+     */
+    readonly boundOrderId?: string;
+    /** Mongoose default version key — present on every document. */
+    readonly __v?: number;
+}

package/src/interfaces/store/store.interface.ts

@@ -1,316 +1,316 @@
-import { Dish } from './dish.interface';
-import { Classification } from './classification.interface';
-import { Specification } from './specification.interface';
-import { Subscription } from './subscription.interface';
-import { MemberSavingRule } from './member.interface';
-import { TaxTypeEnum } from '../../enum/tax.enum';
-import {
-    PrinterDeviceTypeEnum,
-    PrinterWidthEnum,
-    TagPrinterDeviceTypeEnum,
-    EncodeTypeEnum,
-    MultiLangDirectionEnum,
-} from '../../enum/printer.enum';
-import { TimeMenuLoopMode } from '../../enum/time-menu.enum';
-import { WeekEnum } from '../../enum/common.enum';
-import { AnnouncementTargetEnum, AnnouncementTypeEnum } from '../../index';
-
-export interface LangList {
-    [key: string]: string;
-}
-export interface BuffetDishItem {
-    readonly dishId: string;
-    upperLimit: {
-        enable: boolean;
-        adult: number;
-        child: number;
-    };
-}
-
-export interface BuffetCombosItems {
-    readonly _id: string;
-    names: object;
-    price: {
-        adult: number;
-        child: number;
-    };
-    dishes: BuffetDishItem[];
-    orderingByTurns: {
-        enable: boolean;
-        interval: number;
-        maxOrdersPerRoundPerPerson: number;
-        maxRounds: number;
-    };
-}
-
-export interface AllergenItem {
-    readonly _id: string;
-    names: object;
-    img: string;
-    dishIds: string[];
-}
-
-export interface AnnouncementItem {
-    readonly _id: string;
-    enable: boolean;
-    titles: LangList;
-    type: AnnouncementTypeEnum;
-    targets: AnnouncementTargetEnum[];
-    textContents: LangList;
-    imageContents: LangList;
-}
-
-export interface Store {
-    readonly _id: string;
-    name: string;
-    readonly names?: object;
-    readonly auditedNames?: Record<string, string>; //审核后的店铺名, 暂时用于发短信
-    readonly needAuditNames: boolean; //如果店铺的名字有变化, 这里就要设置为需要重新审核
-    readonly img: string;
-    readonly phone?: string;
-    /**
-     * Geographic location for the store. Optional — old stores may not have it.
-     * Set via the manager's map-location picker flow on the App; consumed by
-     * delivery distance / static-map thumbnails / future routing features.
-     * Mirrors the server-side Mongoose subdoc shape in
-     * order-multi-server/src/stores/schemas/store.schema.ts.
-     */
-    readonly location?: {
-        lat: number;
-        lng: number;
-        formattedAddress?: string;
-        placeId?: string;
-    };
-    description: string;
-    readonly descriptions?: object;
-    readonly type: string;
-    readonly currency: string;
-    readonly defaultLang: string;
-    readonly timeZoneNum: number;
-    readonly autoClean: boolean;
-    readonly forceClean: boolean;
-    readonly userId: string;
-    readonly close: boolean;
-    readonly multiLanguage: boolean;
-    readonly dishes: Dish[];
-    readonly classifications: Classification[];
-    readonly specifications: Specification[];
-    readonly subscription: Subscription;
-    readonly date: string | Date;
-    readonly setting: {
-        autoConfirm: boolean;
-        clientPay: boolean;
-        waiterCheckout: boolean;
-        cashBox: boolean;
-        openCashBoxWhenPay: boolean;
-        closeTime: number;
-        enableTaxes: boolean;
-        enableBuffet: boolean;
-        enableAllergens: boolean;
-        checkoutFirst: boolean;
-        defalutNoTax: boolean;
-        taxType?: TaxTypeEnum;
-        orderReminderInterval: number;
-        disableAppendInterval: number;
-        canDeleteOrder: boolean;
-        tableOrderAutoCheckout: boolean;
-        tableOrderAutoCleanTime: number;
-        serialOrderAutoCleanTime: number;
-        disableSerialOrder: boolean;
-        mustPayVersion: boolean;
-        freeVersion: boolean;
-        proclamationPopUp: boolean;
-    };
-    readonly takeoutSetting: {
-        startingPrice: number;
-        deliveryFee: number;
-        payType: string[];
-        startTime: number;
-        endTime: number;
-        open: boolean;
-        autoConfirm: boolean;
-        selfPickUp: boolean;
-        selfPickUpUseDeliveryMenu?: boolean; //自取使用外卖价格, false表示使用堂食价格
-        enableDelivery: boolean;
-        autoCheckout?: boolean;
-        autoCleanTime?: number;
-        reserveSwitch: boolean;
-        reserveTimeLow: number;
-        reserveTimeHigh: number;
-        nonPaymentSmsVerification: boolean;
-        smsVerificationAreaCode: string[];
-    };
-    readonly buffetSetting: {
-        enable: boolean;
-        showDishesOutOfBuffetInClient: boolean;
-        allowDishNumberExceedSetLimitInClient: boolean;
-        childStandard: string;
-        buffetCombos: BuffetCombosItems[];
-    };
-    readonly allergenSetting: {
-        enable: boolean;
-        allergens: AllergenItem[];
-    };
-    readonly announcementSetting: {
-        announcements: AnnouncementItem[];
-    };
-    readonly memberSetting: {
-        savingRules: MemberSavingRule[];
-        security: {
-            paymentVerification: boolean;
-            paymentVerificationLimit: number;
-        };
-    };
-    readonly smsNum: number;
-    readonly resource: {
-        aiToken: number;
-    };
-    readonly smsNotificationSetting: {
-        becomeMember: boolean;
-        memberSave: boolean;
-        memberPayout: boolean;
-        takeoutConfirm: boolean;
-        takeoutCancel: boolean;
-        takeoutComplete: boolean;
-    };
-    readonly taxes: {
-        name: string;
-        rate: number;
-        dishIds: string[];
-    }[];
-    readonly priceHaveTaxBindOrderTaxes: {
-        name: string;
-        rate: number;
-    }[];
-    readonly receptionPrinters: ReceptionPrinter[];
-    readonly chefPrinters: ChefPrinter[];
-    readonly labelPrinters: LabelPrinter[];
-    readonly timeMenu: {
-        enable: boolean;
-        hideDisabledProductions: boolean;
-        loopMode: TimeMenuLoopMode;
-        dayLoop: DayLoopItem[];
-        weekLoop: {
-            Mon: {
-                sameAs: WeekEnum;
-                dayLoop: DayLoopItem[];
-            };
-            Tue: {
-                sameAs: WeekEnum;
-                dayLoop: DayLoopItem[];
-            };
-            Wed: {
-                sameAs: WeekEnum;
-                dayLoop: DayLoopItem[];
-            };
-            Thu: {
-                sameAs: WeekEnum;
-                dayLoop: DayLoopItem[];
-            };
-            Fri: {
-                sameAs: WeekEnum;
-                dayLoop: DayLoopItem[];
-            };
-            Sat: {
-                sameAs: WeekEnum;
-                dayLoop: DayLoopItem[];
-            };
-            Sun: {
-                sameAs: WeekEnum;
-                dayLoop: DayLoopItem[];
-            };
-        };
-    };
-    readonly customPayment: {
-        name: string;
-        enabled: boolean;
-    }[];
-    readonly areas: Area[];
-    readonly cashDenominations: number[];
-}
-
-export interface ReceptionPrinter {
-    _id: string;
-    name: string;
-    type: PrinterDeviceTypeEnum;
-    address: string;
-    bluetoothName: string;
-    printerWidth: PrinterWidthEnum;
-    printerNum: number;
-    disabled: boolean;
-    mergeDishes: boolean;
-    bigFont: boolean;
-    isPrepayOrderPrinteWithTotalPrice: boolean;
-    isAutoPrinteAfterConfirm: boolean;
-    isAutoPrinteAfterCheckout: boolean;
-    preferLang?: string;
-    printChineseAndEnglishAsImg?: boolean;
-    largeLineHeight?: boolean;
-    lineBetweenDishes?: boolean;
-    specificationInNewLine?: boolean;
-    customInformationAtStart?: string;
-    customInformationAtEnd?: string;
-    showWaiterName?: boolean;
-    showSalesmanName?: boolean;
-    showUnitPrice?: boolean;
-    encodeType?: EncodeTypeEnum;
-    extendedPrintingLangs?: string[];
-    multiLangDirection?: MultiLangDirectionEnum;
-}
-
-export interface ChefPrinter {
-    name: string;
-    type: PrinterDeviceTypeEnum;
-    address: string;
-    bluetoothName: string;
-    printerWidth: PrinterWidthEnum;
-    printerNum: number;
-    disabled: boolean;
-    bigFont: boolean;
-    dishIds: string[];
-    mergeDishes: boolean;
-    isSeparateDishes: boolean;
-    isSeparateDishesWithTotal: boolean;
-    preferLang?: string;
-    printChineseAndEnglishAsImg?: boolean;
-    largeLineHeight?: boolean;
-    lineBetweenDishes?: boolean;
-    specificationInNewLine?: boolean;
-    countFront?: boolean;
-    showWaiterName?: boolean;
-    showSalesmanName?: boolean;
-    addTableNumBeforeDishName?: boolean;
-    encodeType?: EncodeTypeEnum;
-    extendedPrintingLangs?: string[];
-    multiLangDirection?: MultiLangDirectionEnum;
-}
-
-export interface LabelPrinter {
-    name: string;
-    type: TagPrinterDeviceTypeEnum;
-    address: string;
-    printerNum: number;
-    disabled: boolean;
-    dishIds: string[];
-    preferLang?: string;
-    rotate?: boolean;
-}
-
-interface DayLoopItem {
-    startMinute: number;
-    endMinute: number;
-    removeMode: boolean;
-    dishId: string[];
-}
-
-export interface Area {
-    readonly _id?: string;
-    readonly name: string;
-    readonly tables: Table[];
-}
-
-export interface Table {
-    readonly _id?: string;
-    readonly name: string;
-    readonly seatNum: number;
-}
+import { Dish } from './dish.interface';
+import { Classification } from './classification.interface';
+import { Specification } from './specification.interface';
+import { Subscription } from './subscription.interface';
+import { MemberSavingRule } from './member.interface';
+import { TaxTypeEnum } from '../../enum/tax.enum';
+import {
+    PrinterDeviceTypeEnum,
+    PrinterWidthEnum,
+    TagPrinterDeviceTypeEnum,
+    EncodeTypeEnum,
+    MultiLangDirectionEnum,
+} from '../../enum/printer.enum';
+import { TimeMenuLoopMode } from '../../enum/time-menu.enum';
+import { WeekEnum } from '../../enum/common.enum';
+import { AnnouncementTargetEnum, AnnouncementTypeEnum } from '../../index';
+
+export interface LangList {
+    [key: string]: string;
+}
+export interface BuffetDishItem {
+    readonly dishId: string;
+    upperLimit: {
+        enable: boolean;
+        adult: number;
+        child: number;
+    };
+}
+
+export interface BuffetCombosItems {
+    readonly _id: string;
+    names: object;
+    price: {
+        adult: number;
+        child: number;
+    };
+    dishes: BuffetDishItem[];
+    orderingByTurns: {
+        enable: boolean;
+        interval: number;
+        maxOrdersPerRoundPerPerson: number;
+        maxRounds: number;
+    };
+}
+
+export interface AllergenItem {
+    readonly _id: string;
+    names: object;
+    img: string;
+    dishIds: string[];
+}
+
+export interface AnnouncementItem {
+    readonly _id: string;
+    enable: boolean;
+    titles: LangList;
+    type: AnnouncementTypeEnum;
+    targets: AnnouncementTargetEnum[];
+    textContents: LangList;
+    imageContents: LangList;
+}
+
+export interface Store {
+    readonly _id: string;
+    name: string;
+    readonly names?: object;
+    readonly auditedNames?: Record<string, string>; //审核后的店铺名, 暂时用于发短信
+    readonly needAuditNames: boolean; //如果店铺的名字有变化, 这里就要设置为需要重新审核
+    readonly img: string;
+    readonly phone?: string;
+    /**
+     * Geographic location for the store. Optional — old stores may not have it.
+     * Set via the manager's map-location picker flow on the App; consumed by
+     * delivery distance / static-map thumbnails / future routing features.
+     * Mirrors the server-side Mongoose subdoc shape in
+     * order-multi-server/src/stores/schemas/store.schema.ts.
+     */
+    readonly location?: {
+        lat: number;
+        lng: number;
+        formattedAddress?: string;
+        placeId?: string;
+    };
+    description: string;
+    readonly descriptions?: object;
+    readonly type: string;
+    readonly currency: string;
+    readonly defaultLang: string;
+    readonly timeZoneNum: number;
+    readonly autoClean: boolean;
+    readonly forceClean: boolean;
+    readonly userId: string;
+    readonly close: boolean;
+    readonly multiLanguage: boolean;
+    readonly dishes: Dish[];
+    readonly classifications: Classification[];
+    readonly specifications: Specification[];
+    readonly subscription: Subscription;
+    readonly date: string | Date;
+    readonly setting: {
+        autoConfirm: boolean;
+        clientPay: boolean;
+        waiterCheckout: boolean;
+        cashBox: boolean;
+        openCashBoxWhenPay: boolean;
+        closeTime: number;
+        enableTaxes: boolean;
+        enableBuffet: boolean;
+        enableAllergens: boolean;
+        checkoutFirst: boolean;
+        defalutNoTax: boolean;
+        taxType?: TaxTypeEnum;
+        orderReminderInterval: number;
+        disableAppendInterval: number;
+        canDeleteOrder: boolean;
+        tableOrderAutoCheckout: boolean;
+        tableOrderAutoCleanTime: number;
+        serialOrderAutoCleanTime: number;
+        disableSerialOrder: boolean;
+        mustPayVersion: boolean;
+        freeVersion: boolean;
+        proclamationPopUp: boolean;
+    };
+    readonly takeoutSetting: {
+        startingPrice: number;
+        deliveryFee: number;
+        payType: string[];
+        startTime: number;
+        endTime: number;
+        open: boolean;
+        autoConfirm: boolean;
+        selfPickUp: boolean;
+        selfPickUpUseDeliveryMenu?: boolean; //自取使用外卖价格, false表示使用堂食价格
+        enableDelivery: boolean;
+        autoCheckout?: boolean;
+        autoCleanTime?: number;
+        reserveSwitch: boolean;
+        reserveTimeLow: number;
+        reserveTimeHigh: number;
+        nonPaymentSmsVerification: boolean;
+        smsVerificationAreaCode: string[];
+    };
+    readonly buffetSetting: {
+        enable: boolean;
+        showDishesOutOfBuffetInClient: boolean;
+        allowDishNumberExceedSetLimitInClient: boolean;
+        childStandard: string;
+        buffetCombos: BuffetCombosItems[];
+    };
+    readonly allergenSetting: {
+        enable: boolean;
+        allergens: AllergenItem[];
+    };
+    readonly announcementSetting: {
+        announcements: AnnouncementItem[];
+    };
+    readonly memberSetting: {
+        savingRules: MemberSavingRule[];
+        security: {
+            paymentVerification: boolean;
+            paymentVerificationLimit: number;
+        };
+    };
+    readonly smsNum: number;
+    readonly resource: {
+        aiToken: number;
+    };
+    readonly smsNotificationSetting: {
+        becomeMember: boolean;
+        memberSave: boolean;
+        memberPayout: boolean;
+        takeoutConfirm: boolean;
+        takeoutCancel: boolean;
+        takeoutComplete: boolean;
+    };
+    readonly taxes: {
+        name: string;
+        rate: number;
+        dishIds: string[];
+    }[];
+    readonly priceHaveTaxBindOrderTaxes: {
+        name: string;
+        rate: number;
+    }[];
+    readonly receptionPrinters: ReceptionPrinter[];
+    readonly chefPrinters: ChefPrinter[];
+    readonly labelPrinters: LabelPrinter[];
+    readonly timeMenu: {
+        enable: boolean;
+        hideDisabledProductions: boolean;
+        loopMode: TimeMenuLoopMode;
+        dayLoop: DayLoopItem[];
+        weekLoop: {
+            Mon: {
+                sameAs: WeekEnum;
+                dayLoop: DayLoopItem[];
+            };
+            Tue: {
+                sameAs: WeekEnum;
+                dayLoop: DayLoopItem[];
+            };
+            Wed: {
+                sameAs: WeekEnum;
+                dayLoop: DayLoopItem[];
+            };
+            Thu: {
+                sameAs: WeekEnum;
+                dayLoop: DayLoopItem[];
+            };
+            Fri: {
+                sameAs: WeekEnum;
+                dayLoop: DayLoopItem[];
+            };
+            Sat: {
+                sameAs: WeekEnum;
+                dayLoop: DayLoopItem[];
+            };
+            Sun: {
+                sameAs: WeekEnum;
+                dayLoop: DayLoopItem[];
+            };
+        };
+    };
+    readonly customPayment: {
+        name: string;
+        enabled: boolean;
+    }[];
+    readonly areas: Area[];
+    readonly cashDenominations: number[];
+}
+
+export interface ReceptionPrinter {
+    _id: string;
+    name: string;
+    type: PrinterDeviceTypeEnum;
+    address: string;
+    bluetoothName: string;
+    printerWidth: PrinterWidthEnum;
+    printerNum: number;
+    disabled: boolean;
+    mergeDishes: boolean;
+    bigFont: boolean;
+    isPrepayOrderPrinteWithTotalPrice: boolean;
+    isAutoPrinteAfterConfirm: boolean;
+    isAutoPrinteAfterCheckout: boolean;
+    preferLang?: string;
+    printChineseAndEnglishAsImg?: boolean;
+    largeLineHeight?: boolean;
+    lineBetweenDishes?: boolean;
+    specificationInNewLine?: boolean;
+    customInformationAtStart?: string;
+    customInformationAtEnd?: string;
+    showWaiterName?: boolean;
+    showSalesmanName?: boolean;
+    showUnitPrice?: boolean;
+    encodeType?: EncodeTypeEnum;
+    extendedPrintingLangs?: string[];
+    multiLangDirection?: MultiLangDirectionEnum;
+}
+
+export interface ChefPrinter {
+    name: string;
+    type: PrinterDeviceTypeEnum;
+    address: string;
+    bluetoothName: string;
+    printerWidth: PrinterWidthEnum;
+    printerNum: number;
+    disabled: boolean;
+    bigFont: boolean;
+    dishIds: string[];
+    mergeDishes: boolean;
+    isSeparateDishes: boolean;
+    isSeparateDishesWithTotal: boolean;
+    preferLang?: string;
+    printChineseAndEnglishAsImg?: boolean;
+    largeLineHeight?: boolean;
+    lineBetweenDishes?: boolean;
+    specificationInNewLine?: boolean;
+    countFront?: boolean;
+    showWaiterName?: boolean;
+    showSalesmanName?: boolean;
+    addTableNumBeforeDishName?: boolean;
+    encodeType?: EncodeTypeEnum;
+    extendedPrintingLangs?: string[];
+    multiLangDirection?: MultiLangDirectionEnum;
+}
+
+export interface LabelPrinter {
+    name: string;
+    type: TagPrinterDeviceTypeEnum;
+    address: string;
+    printerNum: number;
+    disabled: boolean;
+    dishIds: string[];
+    preferLang?: string;
+    rotate?: boolean;
+}
+
+interface DayLoopItem {
+    startMinute: number;
+    endMinute: number;
+    removeMode: boolean;
+    dishId: string[];
+}
+
+export interface Area {
+    readonly _id?: string;
+    readonly name: string;
+    readonly tables: Table[];
+}
+
+export interface Table {
+    readonly _id?: string;
+    readonly name: string;
+    readonly seatNum: number;
+}