@posx/core 5.5.393 → 5.5.395

package/CLAUDE.md

@@ -1,24 +1,24 @@
-# Claude AI Development Guidelines
-
-## Rules you have to follow strictly
-
-- You are top-notch programmer who always write simplest code to achieve the ideal result
-- you are one liner engineers and we believe "The Great Tao is Simple", so try to keep changes small and focused
-- keep the changes as minimal as possible
-- if or else has one line of code, then { } are not needed and it should be wrote into same line
-- DO NOT write uncessary comment do not make newlines within a function and try to make the code compact
-- All crucial code should have proper explanation in English
-- Keep the simplifications as small and focused within the function or scope.
-- Do not overhaul the whole file or codebase which is irrelevant to the current task.
-
-## Best Practices for AI-Assisted Development
-
-1. **在开始编码前先充分讨论和规划架构，确保理解用户的真实需求和使用场景，避免过度设计。**
-
-2. **不要急于提交代码，应该等待用户明确指示后再进行 commit 和 push 操作。**
-
-3. **优先选择简洁的实现方式（如函数导出而非类），并删除冗余的中间层方法以保持代码清晰。**
-
----
-
+# Claude AI Development Guidelines
+
+## Rules you have to follow strictly
+
+- You are top-notch programmer who always write simplest code to achieve the ideal result
+- you are one liner engineers and we believe "The Great Tao is Simple", so try to keep changes small and focused
+- keep the changes as minimal as possible
+- if or else has one line of code, then { } are not needed and it should be wrote into same line
+- DO NOT write uncessary comment do not make newlines within a function and try to make the code compact
+- All crucial code should have proper explanation in English
+- Keep the simplifications as small and focused within the function or scope.
+- Do not overhaul the whole file or codebase which is irrelevant to the current task.
+
+## Best Practices for AI-Assisted Development
+
+1. **在开始编码前先充分讨论和规划架构，确保理解用户的真实需求和使用场景，避免过度设计。**
+
+2. **不要急于提交代码，应该等待用户明确指示后再进行 commit 和 push 操作。**
+
+3. **优先选择简洁的实现方式（如函数导出而非类），并删除冗余的中间层方法以保持代码清晰。**
+
+---
+
 *This file contains guidelines learned from AI-human collaboration to improve development efficiency and code quality.*

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2019 Francisco Hodge
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2019 Francisco Hodge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,85 +1,85 @@
-# 第一阶段
-- 1. 创建，更新，删除都是通过 -> Http API
-- 2. 读取是通过本地数据库 -> 本地， （例外：订单从云端读取）
-
-# 第二阶段 （单机版）
-1. 创建，更新，删除，读取都通过本地数据库，然后进行数据和云端同步(Web Worker)
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- <div align="center">
- <img align="center" width="230" src="https://i.imgur.com/iHgtvmg.png" />
-  <h2>Typescript Library Boilerplate Basic</h2>
-  <blockquote>Minimal Library Starter Kit for your Typescript projects</blockquote>
- 
- <a href="https://www.npmjs.com/package/@hodgef/ts-library-boilerplate-basic"><img src="https://badgen.net/npm/v/@hodgef/ts-library-boilerplate-basic?color=blue" alt="npm version"></a> <a href="https://github.com/hodgef/ts-library-boilerplate"><img src="https://img.shields.io/github/last-commit/hodgef/ts-library-boilerplate" alt="latest commit"></a> <a href="https://github.com/hodgef/ts-library-boilerplate-basic/actions"><img alt="Build Status" src="https://github.com/hodgef/ts-library-boilerplate-basic/workflows/Build/badge.svg?color=green" /></a> <a href="https://github.com/hodgef/ts-library-boilerplate-basic/actions"> <img alt="Publish Status" src="https://github.com/hodgef/ts-library-boilerplate-basic/workflows/Publish/badge.svg?color=green" /></a>
-
-<strong>For a plain Javascript alternative, check out [js-library-boilerplate-basic](https://github.com/hodgef/js-library-boilerplate-basic).</strong>
-
-</div>
-
-## ⭐️ Features
-
-- Webpack 5
-- Babel 7
-- Hot reloading (`npm start`)
-- Automatic Types file generation (index.d.ts)
-- UMD exports, so your library works everywhere.
-- Jest unit testing
-- Customizable file headers for your build [(Example 1)](https://github.com/hodgef/ts-library-boilerplate-basic/blob/master/build/index.js) [(Example2)](https://github.com/hodgef/ts-library-boilerplate-basic/blob/master/build/css/index.css)
-- Daily [dependabot](https://dependabot.com) dependency updates
-
-## 📦 Getting Started
-
-```
-git clone https://github.com/hodgef/ts-library-boilerplate-basic.git myLibrary
-npm install
-```
-
-## 💎 Customization
-
-> Before shipping, make sure to:
-
-1. Edit `LICENSE` file
-2. Edit `package.json` information (These will be used to generate the headers for your built files)
-3. Edit `library: "MyLibrary"` with your library's export name in `./webpack.config.js`
-
-## 🚀 Deployment
-
-1. `npm publish`
-2. Your users can include your library as usual
-
-### npm
-
-```
-import MyLibrary from 'my-library';
-const libraryInstance = new MyLibrary();
-...
-```
-
-### self-host/cdn
-
-```
-<script src="build/index.js"></script>
-
-const MyLibrary = window.MyLibrary.default;
-const libraryInstance = new MyLibrary();
-...
-```
-
-## ✅ Libraries built with this boilerplate
-
-> Made a library using this starter kit? Share it here by [submitting a pull request](https://github.com/hodgef/ts-library-boilerplate-basic/pulls)!
-
-- [simple-keyboard](https://github.com/hodgef/simple-keyboard) - Javascript Virtual Keyboard
-- [react-simple-keyboard](https://github.com/hodgef/react-simple-keyboard) - React Virtual Keyboard
-- [simple-keyboard-layouts](https://github.com/hodgef/simple-keyboard-layouts) - Keyboard layouts for simple-keyboard
-- [atlas-monaco](https://github.com/datdao/atlas-monaco) - AtlasHCL for monaco editor
+# 第一阶段
+- 1. 创建，更新，删除都是通过 -> Http API
+- 2. 读取是通过本地数据库 -> 本地， （例外：订单从云端读取）
+
+# 第二阶段 （单机版）
+1. 创建，更新，删除，读取都通过本地数据库，然后进行数据和云端同步(Web Worker)
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ <div align="center">
+ <img align="center" width="230" src="https://i.imgur.com/iHgtvmg.png" />
+  <h2>Typescript Library Boilerplate Basic</h2>
+  <blockquote>Minimal Library Starter Kit for your Typescript projects</blockquote>
+ 
+ <a href="https://www.npmjs.com/package/@hodgef/ts-library-boilerplate-basic"><img src="https://badgen.net/npm/v/@hodgef/ts-library-boilerplate-basic?color=blue" alt="npm version"></a> <a href="https://github.com/hodgef/ts-library-boilerplate"><img src="https://img.shields.io/github/last-commit/hodgef/ts-library-boilerplate" alt="latest commit"></a> <a href="https://github.com/hodgef/ts-library-boilerplate-basic/actions"><img alt="Build Status" src="https://github.com/hodgef/ts-library-boilerplate-basic/workflows/Build/badge.svg?color=green" /></a> <a href="https://github.com/hodgef/ts-library-boilerplate-basic/actions"> <img alt="Publish Status" src="https://github.com/hodgef/ts-library-boilerplate-basic/workflows/Publish/badge.svg?color=green" /></a>
+
+<strong>For a plain Javascript alternative, check out [js-library-boilerplate-basic](https://github.com/hodgef/js-library-boilerplate-basic).</strong>
+
+</div>
+
+## ⭐️ Features
+
+- Webpack 5
+- Babel 7
+- Hot reloading (`npm start`)
+- Automatic Types file generation (index.d.ts)
+- UMD exports, so your library works everywhere.
+- Jest unit testing
+- Customizable file headers for your build [(Example 1)](https://github.com/hodgef/ts-library-boilerplate-basic/blob/master/build/index.js) [(Example2)](https://github.com/hodgef/ts-library-boilerplate-basic/blob/master/build/css/index.css)
+- Daily [dependabot](https://dependabot.com) dependency updates
+
+## 📦 Getting Started
+
+```
+git clone https://github.com/hodgef/ts-library-boilerplate-basic.git myLibrary
+npm install
+```
+
+## 💎 Customization
+
+> Before shipping, make sure to:
+
+1. Edit `LICENSE` file
+2. Edit `package.json` information (These will be used to generate the headers for your built files)
+3. Edit `library: "MyLibrary"` with your library's export name in `./webpack.config.js`
+
+## 🚀 Deployment
+
+1. `npm publish`
+2. Your users can include your library as usual
+
+### npm
+
+```
+import MyLibrary from 'my-library';
+const libraryInstance = new MyLibrary();
+...
+```
+
+### self-host/cdn
+
+```
+<script src="build/index.js"></script>
+
+const MyLibrary = window.MyLibrary.default;
+const libraryInstance = new MyLibrary();
+...
+```
+
+## ✅ Libraries built with this boilerplate
+
+> Made a library using this starter kit? Share it here by [submitting a pull request](https://github.com/hodgef/ts-library-boilerplate-basic/pulls)!
+
+- [simple-keyboard](https://github.com/hodgef/simple-keyboard) - Javascript Virtual Keyboard
+- [react-simple-keyboard](https://github.com/hodgef/react-simple-keyboard) - React Virtual Keyboard
+- [simple-keyboard-layouts](https://github.com/hodgef/simple-keyboard-layouts) - Keyboard layouts for simple-keyboard
+- [atlas-monaco](https://github.com/datdao/atlas-monaco) - AtlasHCL for monaco editor

package/build/index.d.ts

@@ -4174,6 +4174,10 @@ interface IPrintJob extends IAppCoreModel {
   /** Print sequence order (lower number prints first) */
   print_sequence?: number;
   meta: Record<string, unknown>;
+  /** USB device ID (runtime dynamic) */
+  usb_device_id?: number;
+  /** USB serial number for persistent device identification */
+  usb_serial_number?: string;
 }
 declare class PrintJob extends AppBaseModel implements IPrintJob {
   printer_name: string;
@@ -4231,6 +4235,8 @@ interface IPrinter extends IAppBaseModel {
   retries: number;
   /** Print sequence order (lower number prints first) */
   print_sequence?: number;
+  /** USB serial number for persistent device identification */
+  usb_serial_number?: string;
 }
 declare class Printer extends AppBaseModel implements IPrinter {
   device_uid: string;

package/jest.config.cjs

@@ -1,36 +1,36 @@
-// jest.config.js
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'jsdom',
-  setupFilesAfterEnv: ['<rootDir>/jest.setup.cjs'],
-  transform: {
-    '^.+\\.ts$': ['ts-jest', {
-      tsconfig: {
-        module: 'commonjs',
-        esModuleInterop: true,
-      }
-    }],
-    '^.+\\.(mjs|js)$': ['ts-jest', {
-      tsconfig: {
-        allowJs: true,
-        module: 'commonjs',
-        esModuleInterop: true,
-      }
-    }]
-  },
-  transformIgnorePatterns: [
-    'node_modules/(?!(.pnpm|nanoid|@litepos|dexie|lodash-es)/)', // Transform ESM packages
-  ],
-  testMatch: [
-    '<rootDir>/src/test/**/*.test.ts'
-  ],
-  moduleNameMapper: {
-    '\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$': '<rootDir>/scripts/testMock.cjs',
-    '\\.(css|less)$': '<rootDir>/scripts/testMock.cjs',
-    '^nanoid$': '<rootDir>/src/test/__mocks__/nanoid.js',
-    '^dexie$': '<rootDir>/src/test/__mocks__/dexie.js',
-    '^@awesome-cordova-plugins/network-interface$': '<rootDir>/src/test/__mocks__/@awesome-cordova-plugins/network-interface.js',
-    '^canvas$': '<rootDir>/scripts/testMock.cjs'
-  },
-  moduleFileExtensions: ['web.js', 'js', 'web.ts', 'ts', 'web.tsx', 'tsx', 'json', 'web.jsx', 'jsx', 'node'],
-};
+// jest.config.js
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'jsdom',
+  setupFilesAfterEnv: ['<rootDir>/jest.setup.cjs'],
+  transform: {
+    '^.+\\.ts$': ['ts-jest', {
+      tsconfig: {
+        module: 'commonjs',
+        esModuleInterop: true,
+      }
+    }],
+    '^.+\\.(mjs|js)$': ['ts-jest', {
+      tsconfig: {
+        allowJs: true,
+        module: 'commonjs',
+        esModuleInterop: true,
+      }
+    }]
+  },
+  transformIgnorePatterns: [
+    'node_modules/(?!(.pnpm|nanoid|@litepos|dexie|lodash-es)/)', // Transform ESM packages
+  ],
+  testMatch: [
+    '<rootDir>/src/test/**/*.test.ts'
+  ],
+  moduleNameMapper: {
+    '\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$': '<rootDir>/scripts/testMock.cjs',
+    '\\.(css|less)$': '<rootDir>/scripts/testMock.cjs',
+    '^nanoid$': '<rootDir>/src/test/__mocks__/nanoid.js',
+    '^dexie$': '<rootDir>/src/test/__mocks__/dexie.js',
+    '^@awesome-cordova-plugins/network-interface$': '<rootDir>/src/test/__mocks__/@awesome-cordova-plugins/network-interface.js',
+    '^canvas$': '<rootDir>/scripts/testMock.cjs'
+  },
+  moduleFileExtensions: ['web.js', 'js', 'web.ts', 'ts', 'web.tsx', 'tsx', 'json', 'web.jsx', 'jsx', 'node'],
+};

package/jest.setup.cjs

@@ -1,80 +1,80 @@
-// Jest setup file to polyfill File and Blob APIs
-// This ensures consistent behavior across different Node.js versions and test environments
-
-// Polyfill Blob.text() if not available
-if (typeof Blob !== 'undefined' && !Blob.prototype.text) {
-  Blob.prototype.text = async function() {
-    const reader = new FileReader();
-    return new Promise((resolve, reject) => {
-      reader.onload = () => resolve(reader.result);
-      reader.onerror = reject;
-      reader.readAsText(this);
-    });
-  };
-}
-
-// Polyfill FileReader if not available
-if (typeof FileReader === 'undefined') {
-  global.FileReader = class FileReader {
-    result = null;
-    error = null;
-    onload = null;
-    onerror = null;
-
-    readAsText(blob) {
-      try {
-        // For our polyfilled Blob
-        if (blob.parts) {
-          this.result = blob.parts.join('');
-        } else if (typeof blob === 'string') {
-          this.result = blob;
-        } else {
-          this.result = String(blob);
-        }
-
-        if (this.onload) {
-          setTimeout(() => this.onload({ target: this }), 0);
-        }
-      } catch (err) {
-        this.error = err;
-        if (this.onerror) {
-          setTimeout(() => this.onerror({ target: this }), 0);
-        }
-      }
-    }
-  };
-}
-
-// Polyfill Blob if not available (for Node.js < 18)
-if (typeof Blob === 'undefined') {
-  global.Blob = class Blob {
-    constructor(parts = [], options = {}) {
-      this.parts = parts;
-      this.type = options.type || '';
-      this.size = parts.reduce((acc, part) => {
-        return acc + (typeof part === 'string' ? part.length : part.length || 0);
-      }, 0);
-    }
-
-    async text() {
-      return this.parts.join('');
-    }
-
-    async arrayBuffer() {
-      const text = await this.text();
-      const buffer = Buffer.from(text);
-      return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
-    }
-  };
-}
-
-// Polyfill File if not available (for Node.js < 18)
-if (typeof File === 'undefined') {
-  global.File = class File extends global.Blob {
-    constructor(bits, name, options = {}) {
-      super(bits, options);
-      this.name = name;
-      this.lastModified = options.lastModified || Date.now();
-    }
-  };
-}
+// Jest setup file to polyfill File and Blob APIs
+// This ensures consistent behavior across different Node.js versions and test environments
+
+// Polyfill Blob.text() if not available
+if (typeof Blob !== 'undefined' && !Blob.prototype.text) {
+  Blob.prototype.text = async function() {
+    const reader = new FileReader();
+    return new Promise((resolve, reject) => {
+      reader.onload = () => resolve(reader.result);
+      reader.onerror = reject;
+      reader.readAsText(this);
+    });
+  };
+}
+
+// Polyfill FileReader if not available
+if (typeof FileReader === 'undefined') {
+  global.FileReader = class FileReader {
+    result = null;
+    error = null;
+    onload = null;
+    onerror = null;
+
+    readAsText(blob) {
+      try {
+        // For our polyfilled Blob
+        if (blob.parts) {
+          this.result = blob.parts.join('');
+        } else if (typeof blob === 'string') {
+          this.result = blob;
+        } else {
+          this.result = String(blob);
+        }
+
+        if (this.onload) {
+          setTimeout(() => this.onload({ target: this }), 0);
+        }
+      } catch (err) {
+        this.error = err;
+        if (this.onerror) {
+          setTimeout(() => this.onerror({ target: this }), 0);
+        }
+      }
+    }
+  };
+}
+
+// Polyfill Blob if not available (for Node.js < 18)
+if (typeof Blob === 'undefined') {
+  global.Blob = class Blob {
+    constructor(parts = [], options = {}) {
+      this.parts = parts;
+      this.type = options.type || '';
+      this.size = parts.reduce((acc, part) => {
+        return acc + (typeof part === 'string' ? part.length : part.length || 0);
+      }, 0);
+    }
+
+    async text() {
+      return this.parts.join('');
+    }
+
+    async arrayBuffer() {
+      const text = await this.text();
+      const buffer = Buffer.from(text);
+      return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+    }
+  };
+}
+
+// Polyfill File if not available (for Node.js < 18)
+if (typeof File === 'undefined') {
+  global.File = class File extends global.Blob {
+    constructor(bits, name, options = {}) {
+      super(bits, options);
+      this.name = name;
+      this.lastModified = options.lastModified || Date.now();
+    }
+  };
+}

package/memo/technical-docs/01_ARCHITECTURE.md

@@ -0,0 +1,147 @@
+# 01 - 整体架构
+
+> AI 上下文索引：服务工厂、依赖注入、Dexie数据库、Axios HTTP、服务层次、事件驱动
+
+## 架构概述
+
+本项目是 **核心服务库**，非前端应用。采用服务导向架构，通过工厂模式进行依赖注入。
+
+## 入口点
+
+**主入口:** `src/index.ts`
+- Barrel 导出所有公共 API
+- 导出服务工厂、领域模型、工具函数
+
+**服务工厂:** `src/service.factory.ts`
+- 初始化 Dexie 数据库 (28 张表)
+- 创建 Axios HTTP 客户端
+- 按需实例化领域服务
+- 管理数据库连接状态
+
+## 服务层次结构
+
+```
+IAppCoreService<T>     # 读操作接口
+    │
+    ├── IAppLocalService<T>   # 本地 CRUD (无远程)
+    │
+    └── IAppRemoteService<T>  # 远程 API CRUD
+            │
+            ├── addOne()     → PUT
+            ├── updateOne()  → PATCH
+            ├── updateMany() → PATCH
+            └── deleteOne()  → DELETE (软删除)
+```
+
+## 数据库架构
+
+**技术:** Dexie v3.2.4 (IndexedDB 包装器)
+**版本:** v28
+**表数量:** 28 张
+
+### 核心表
+
+| 表名 | 索引 | 用途 |
+|------|------|------|
+| items | uid, name, barcode, codename, sequence | 商品 |
+| sections | uid, sequence | 区域 |
+| section_items | uid, sequence | 桌位 |
+| categories | uid, sequence | 分类 |
+| invoices | uid, type, status, table_uid | 发票 |
+| employees | uid, role_uid | 员工 |
+| payment_methods | uid, is_cash | 支付方式 |
+| printers | uid | 打印机 |
+| print_jobs | uid, status, printer_type, device_uid_to_print | 打印任务 |
+| configs | uid | 配置 |
+| shifts | uid, status | 班次 |
+| tills | uid, employee_uid | 收银机 |
+
+### 基础索引模式
+
+```typescript
+const baseSchema = 'uid, updated_at, created_at, deleted_at, _timestamp, id_in_server, created_at_timestamp';
+```
+
+## 事件驱动模式
+
+### SignalR 集成
+
+**Hub 消息类型:** `src/types/hub.message.type.ts`
+
+```typescript
+enum HubMessageType {
+    PaynowEvent = 'paynow_event',
+    SmoochPaymentEvent = 'smooch_payment_event',
+    SyncInvoice = 'sync_invoice',
+}
+```
+
+### Dexie Live Query
+
+```typescript
+public liveQuery<T>(expr: () => T): Observable<T> {
+    return liveQuery(expr);
+}
+```
+- 提供响应式数据更新
+- 通过 RxJS Observable 集成
+
+## Electron Socket 桥接
+
+**位置:** `src/libs/electron.socket.ts`
+
+**状态机:**
+- CLOSED (0) → OPENING (1) → OPENED (2) → CLOSING (3)
+
+**用途:**
+- Electron IPC 通信
+- 硬件控制 (打印机、钱箱)
+
+## 插件系统
+
+### Handlebars 插件注册
+
+**位置:** `src/helpers/helpers.register.ts`
+
+用于动态模板渲染：
+- `string.helpers.ts` - 字符串处理
+- `comparison.helpers.ts` - 比较逻辑
+
+## 关键文件
+
+| 文件路径 | 大小 | 核心职责 |
+|----------|------|---------|
+| `src/service.factory.ts` | 6KB | 服务实例化、数据库初始化 |
+| `src/services/abstract.service.ts` | 8KB | 基础 CRUD 接口 |
+| `src/services/app.service.ts` | 82KB | 领域服务集合 |
+| `src/services/invoice.service.ts` | 107KB | 发票生命周期、计算引擎 |
+| `src/libs/electron.socket.ts` | 3KB | Electron IPC 桥接 |
+| `src/libs/escpos.printer.ts` | 18KB | ESC/POS 打印命令 |
+
+## 架构模式
+
+1. **服务工厂模式** - 延迟初始化服务
+2. **仓储模式** - AppRemoteService 提供数据访问抽象
+3. **适配器模式** - Dexie + Axios 双重持久化
+4. **观察者模式** - Dexie liveQuery + RxJS
+5. **模板方法模式** - 抽象服务基类
+6. **策略模式** - 多种计算流程 (CalcFlow)
+7. **事件驱动** - SignalR 实时同步
+
+## 运行模式
+
+```typescript
+enum ServiceMode {
+  LOCAL = 'local',    // 仅客户端模式
+  CLOUD = 'cloud'     // 远程 API 同步模式
+}
+```
+
+**LOCAL:** 仅使用 IndexedDB，无远程调用
+**CLOUD:** 与远程 API 同步，维护本地缓存
+
+## 相关文档
+
+- [PROJECT_OVERVIEW.md](./PROJECT_OVERVIEW.md) - 项目总览
+- [05_DATA_LAYER.md](./05_DATA_LAYER.md) - 数据层详解
+- [06_CROSS_PLATFORM.md](./06_CROSS_PLATFORM.md) - 跨平台能力