@posx/core 5.5.395 → 5.5.396

package/dev/escpos/receipt.json

@@ -0,0 +1 @@
+{"uid": "pjb_I8RJcR0Hm6iMsYSzmIDRd", "updated_at": "2026-02-10T05:41:54.209Z", "created_at": "2026-02-10T05:41:54.356Z", "created_at_timestamp": 1770702114356, "deleted_at": null, "name_translations": {}, "printer_name": "Receipt Printer", "driver_printer_name": "Receipt Printer", "printer_ip": "0.0.0.0", "printer_uid": "prt_eJ5yITaByzBnAXSz1IvhF", "printer_type": "receipt_printer", "protocol": "ESC/POS", "connection_type": "WINDOWS_DRIVER", "data": {"codepage": "cp936", "items": [{"type": "newline", "repeat": 1}, {"type": "text", "align": "center", "style": "bold", "item": {"size": "custom", "width": 1, "height": 1, "text": " Happy Thai Food - Victory 8"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "center", "style": "bold", "item": {"text": "8 Jalan Legundi #01-10 Victory 8"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "center", "style": "bold", "item": {"text": "Tel: 67146682"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"text": "Dine-In"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"text": "# 01260210000001472"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"size": "custom", "width": 1, "height": 1, "text": "Table:15"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"size": "custom", "width": 1, "height": 1, "text": "ORDER NO.: 472"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"text": "Served By:admin"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"text": "Date:2026-Feb-10 13:41:54"}}, {"type": "newline", "repeat": 1}, {"type": "line"}, {"type": "table", "style": "bold", "table": {"items": [{"text": "ITEM", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "QTY", "column_width": 15}, {"text": "AMT", "column_width": 25}]}}, {"type": "line"}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "M3. Garlic Fried Pork  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$13.90", "column_width": 25}]}}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "TE5. Chicken Omelette  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$7.90", "column_width": 25}]}}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "ND2. Phad see Ew (Kway Teow) Seafood  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$9.90", "column_width": 25}]}}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "A4. Thai Prawn Cake (4 Pieces)  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$13.90", "column_width": 25}]}}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "DR11. Thai Milk Tea  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$4.50", "column_width": 25}]}}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "DR7. Lemongrass Drink  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$3.90", "column_width": 25}]}}, {"type": "table", "align": "left", "table": {"items": [{"text": "-  Cold  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "{{}}", "column_width": 15}, {"text": "", "column_width": 25}]}}, {"type": "newline", "repeat": 1}, {"type": "line"}, {"codepage": "cp437", "type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "SUBTOTAL", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$54.00", "column_width": 25}]}}, {"codepage": "cp437", "type": "table", "style": "bold", "table": {"items": [{"text": "10% SERVICE CHARGE", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$5.40", "column_width": 25}]}}, {"codepage": "cp437", "type": "table", "style": "bold", "size": "custom", "width": 1, "height": 1, "table": {"items": [{"text": "TOTAL", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$59.40", "column_width": 25}]}}, {"type": "line"}, {"codepage": "cp437", "type": "table", "style": "bold", "table": {"items": [{"text": "PAYMENT BY:Fiuu", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$59.40", "column_width": 25}]}}, {"type": "line"}, {"codepage": "cp437", "type": "table", "style": "bold", "table": {"items": [{"text": "PAYMENT TYPE", "column_width": 50}, {"text": "MASTERCARD", "column_width": 50}]}}, {"codepage": "cp437", "type": "table", "style": "bold", "table": {"items": [{"text": "REF", "column_width": 50}, {"text": "3487260943", "column_width": 50}]}}, {"codepage": "cp437", "type": "table", "style": "bold", "table": {"items": [{"text": "CARD NUM", "column_width": 50}, {"text": "**** **** **** 1040", "column_width": 50}]}}, {"type": "table", "style": "bold", "table": {"items": [{"text": "CUSTOMER TEL", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "\u002B65****4846", "column_width": 25}]}}, {"type": "table", "style": "bold", "table": {"items": [{"text": "Cash Back", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$1.78", "column_width": 25}]}}, {"type": "table", "style": "bold", "table": {"items": [{"text": "Credit Balance", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$1.78", "column_width": 25}]}}, {"type": "table", "style": "bold", "table": {"items": [{"text": "Point Balance", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "pt", "column_width": 25}]}}, {"type": "line"}, {"type": "text", "align": "center", "style": "bold", "item": {"text": "8 Jalan Legundi #01-10 Victory 8"}}, {"type": "newline", "repeat": 5}, {"type": "newline", "repeat": 1}, {"type": "newline", "repeat": 1}, {"type": "newline", "repeat": 1}, {"type": "cut"}]}, "status": "printed", "retries": 0, "commands": "", "save_only": false, "print_times": 1, "printed": 1, "device_uid_to_print": "", "designated_table_section_uids": [], "job_id": 0, "print_sequence": 0, "meta": {}, "id_in_server": 1044494, "_timestamp": 1770702115370025}

package/dev/escpos-cli-usage.md

@@ -0,0 +1,103 @@
+# ESC/POS CLI Tool Usage Manual
+
+Generate ESC/POS byte files from print job JSON definitions.
+
+## Files
+
+- `scripts/generate-escpos-bytes.mjs` - ESC/POS byte generator with built-in encoder
+- `scripts/example-print-job.json` - Example print job for testing
+
+## Usage
+
+```bash
+npm run escpos -- <input.json> <output.bin>
+```
+
+## Example
+
+```bash
+npm run escpos -- ./scripts/example-print-job.json ./receipt.bin
+```
+
+## Supported Features
+
+| Feature | Description |
+|---------|-------------|
+| Text | With size, bold, italic, underline, alignment |
+| Tables | With column widths and text wrapping |
+| Lines | Separators |
+| QR codes | Model, size, error level configurable |
+| Barcodes | EAN13, UPC-A, UPC-E, EAN8, Code39, ITF, Codabar |
+| Newlines | With repeat count |
+| Cut | Full or partial |
+| Beeper | Audible alert |
+| Cash drawer | Open cash drawer command |
+| VISCII codepage | Vietnamese support |
+| Multiple codepages | cp437, cp850, cp936, etc. |
+
+## Not Supported
+
+- **Image printing** - Requires browser APIs, not available in CLI mode
+
+## Print Job JSON Format
+
+```json
+{
+  "codepage": "cp936",
+  "items": [
+    {
+      "type": "text",
+      "align": "center",
+      "style": "bold",
+      "item": {
+        "text": "RECEIPT",
+        "size": "normal",
+        "line_width": 48
+      }
+    },
+    {
+      "type": "table",
+      "table": {
+        "size": "normal",
+        "line_width": 48,
+        "items": [
+          { "text": "Item", "column_width": 50 },
+          { "text": "Qty", "column_width": 20 },
+          { "text": "Price", "column_width": 30 }
+        ]
+      }
+    },
+    {
+      "type": "qrcode",
+      "align": "center",
+      "qrcode": {
+        "data": "https://example.com",
+        "model": 2,
+        "size": 6,
+        "errorlevel": "m"
+      }
+    },
+    {
+      "type": "cut"
+    }
+  ]
+}
+```
+
+## Available Types
+
+| Type | Properties |
+|------|------------|
+| `text` | `item.text`, `item.size`, `item.line_width`, `item.width`, `item.height` |
+| `table` | `table.items[]`, `table.size`, `table.line_width` |
+| `line` | `item.text` (character to repeat) |
+| `newline` | `repeat` (number of lines) |
+| `qrcode` | `qrcode.data`, `qrcode.model`, `qrcode.size`, `qrcode.errorlevel` |
+| `barcode` | `barcode.data`, `barcode.symbology`, `barcode.height` |
+| `cut` | `item.text` ("full" or "partial") |
+| `beeper` | - |
+| `open_cash_drawer` | - |
+
+## Available Codepages
+
+`cp437`, `cp850`, `cp860`, `cp863`, `cp865`, `cp857`, `cp737`, `cp866`, `cp862`, `cp864`, `cp874`, `cp936`, `cp949`, `cp950`, `shiftjis`, `windows1252`, `69` (VISCII)

package/dev/harbor-harness-deployment.md

@@ -0,0 +1,78 @@
+# Harbor + Harness 部署总结
+
+## 服务端口
+
+| 服务        | 端口 | 说明           |
+|-------------|------|----------------|
+| Harbor      | 8081 | 容器镜像仓库   |
+| Harness     | 8082 | Git 代码托管   |
+| Harness SSH | 3022 | Git SSH        |
+| PostgreSQL  | 5433 | 数据库         |
+| Redis       | 6380 | 缓存           |
+
+## 外部访问
+
+| 服务    | 外部地址                | 内部地址     |
+|---------|-------------------------|--------------|
+| Harbor  | https://harbor.wyo.sg   | LAN_IP:8081  |
+| Harness | https://harness.wyo.sg  | LAN_IP:8082  |
+
+## Harbor 登录
+
+- URL: https://harbor.wyo.sg
+- 用户名: `admin`
+- 密码: `Harbor@2024!`
+
+## Harness 登录
+
+- URL: https://harness.wyo.sg
+- 用户名: `admin@harness.local`
+- 密码: `Harness@2024!`
+
+## PostgreSQL
+
+Host: `127.0.0.1:5433`
+
+| 数据库   | 用户名   | 密码           |
+|----------|----------|----------------|
+| postgres | postgres | Postgres@2024! |
+| harbor   | harbor   | Harbor@2024!   |
+| harness  | harness  | Harness@2024!  |
+
+## Redis
+
+- Host: `127.0.0.1:6380`
+- 密码: (无)
+- Harbor DB Index: 1, 2, 5, 6, 7
+
+## 文件位置
+
+```
+/opt/infra/docker-compose.yml      # PostgreSQL + Redis
+/opt/infra/config/postgresql.conf  # PostgreSQL 配置
+/opt/infra/config/redis.conf       # Redis 配置
+/opt/harbor/harbor.yml             # Harbor 配置
+/opt/harness/docker-compose.yml    # Harness 配置
+```
+
+## 管理命令
+
+```bash
+# 基础设施
+cd /opt/infra && docker compose up -d
+cd /opt/infra && docker compose down
+
+# Harbor
+cd /opt/harbor && docker compose up -d
+cd /opt/harbor && docker compose down
+
+# Harness
+cd /opt/harness && docker compose up -d
+cd /opt/harness && docker compose down
+```
+
+## Docker 登录 Harbor
+
+```bash
+docker login harbor.wyo.sg
+```

package/dev/nginx-harbor-harness.conf

@@ -0,0 +1,84 @@
+# Harbor - 容器镜像仓库
+server {
+    listen 80;
+    server_name harbor.wyo.sg;
+    return 301 https://$server_name$request_uri;
+}
+
+server {
+    listen 443 ssl http2;
+    server_name harbor.wyo.sg;
+
+    ssl_certificate /etc/nginx/ssl/wyo.sg/fullchain.pem;
+    ssl_certificate_key /etc/nginx/ssl/wyo.sg/privkey.pem;
+
+    # SSL 配置
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
+    ssl_prefer_server_ciphers off;
+    ssl_session_cache shared:SSL:10m;
+    ssl_session_timeout 1d;
+
+    # 重要：Docker 镜像上传无大小限制
+    client_max_body_size 0;
+    chunked_transfer_encoding on;
+
+    # 禁用缓冲，支持大文件流式传输
+    proxy_buffering off;
+    proxy_request_buffering off;
+
+    location / {
+        proxy_pass http://LAN_IP:8081;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # 超时设置（镜像推送可能耗时较长）
+        proxy_connect_timeout 900;
+        proxy_send_timeout 900;
+        proxy_read_timeout 900;
+    }
+}
+
+# Harness - Git 代码托管
+server {
+    listen 80;
+    server_name harness.wyo.sg;
+    return 301 https://$server_name$request_uri;
+}
+
+server {
+    listen 443 ssl http2;
+    server_name harness.wyo.sg;
+
+    ssl_certificate /etc/nginx/ssl/wyo.sg/fullchain.pem;
+    ssl_certificate_key /etc/nginx/ssl/wyo.sg/privkey.pem;
+
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
+    ssl_prefer_server_ciphers off;
+    ssl_session_cache shared:SSL:10m;
+    ssl_session_timeout 1d;
+
+    # Git 仓库可能较大
+    client_max_body_size 0;
+
+    location / {
+        proxy_pass http://LAN_IP:8082;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # WebSocket 支持（实时日志、通知等）
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+
+        # 超时设置
+        proxy_connect_timeout 300;
+        proxy_send_timeout 300;
+        proxy_read_timeout 300;
+    }
+}

package/dev/px-cli.md

@@ -0,0 +1,99 @@
+# px-cli
+
+Bun CLI project to interact with server using x-api-key method
+
+## Setup
+
+```bash
+cd px
+bun install
+cp .env.example .env   # fill in PX_BASE_URL, PX_API_KEY, PX_MERCHANT_UID
+```
+
+## Structure
+
+```
+px/
+├── package.json          # bun project, depends on @posx/core
+├── tsconfig.json
+├── .env.example
+├── index.ts              # entry point & router (cac)
+├── http.ts               # HTTP client with x-api-key auth
+├── .changes.json         # staged CUD changes (auto-generated)
+└── commands/
+    ├── category.ts       # Category CRUD (types: ICategory)
+    └── product.ts        # Product CRUD (types: IItem)
+```
+
+## Dependencies
+
+- `@posx/core` — import types only (no service layer — no Dexie/IndexedDB in Bun):
+  - `IServiceOptions` — config typing in `http.ts`
+  - `ICategory` — category request/response typing
+  - `IItem` — product request/response typing
+- `@litepos/autoquery` — `QueryBuilder` for `list` action (autoquery via `sapi` endpoint)
+- `cac` — lightweight CLI framework (arg parsing, help text, subcommands)
+
+## Usage
+
+### Read (immediate)
+
+```bash
+# List via autoquery (sapi)
+px category list
+px category list --nameContains Drinks --take 10
+px product list
+px product list --nameContains Latte --take 10
+
+# Get by ID
+px category get --id 123
+px product get --id 456
+```
+
+### CUD — two-step workflow (stage → commit)
+
+CUD operations stage changes locally before applying to server.
+
+**Step 1: Stage changes** — fetches latest data, displays diff, saves to `.changes.json`
+
+```bash
+# Add (shows new record fields)
+px category add --name "Drinks" --type product --color "#ff0000" --icon "🍹"
+
+# Update (fetches current record, shows old → new diff)
+# Pattern: GET → merge changes → PATCH
+px category update --id 123 --name "Beverages"
+px product update --id 456 --price 6.00
+
+# Delete (fetches current record, shows record to be removed)
+px category delete --id 123
+px product delete --id 456
+```
+
+**Step 2: Review & apply**
+
+```bash
+px status          # show all staged changes
+px commit          # apply all staged changes to server
+px reset           # discard all staged changes
+```
+
+## API
+
+- **Base**: `https://lite-dev.posx.ai`
+- **Auth**: `x-api-key` header
+
+| Method   | Route                                               | Action           |
+|----------|-----------------------------------------------------|------------------|
+| `GET`    | `sapi/v5/merchants/{merchant_uid}/{module}`         | list (autoquery) |
+| `GET`    | `api/v5/merchants/{merchant_uid}/{module}/{id}`     | get              |
+| `PUT`    | `api/v5/merchants/{merchant_uid}/{module}/{method}` | add              |
+| `PATCH`  | `api/v5/merchants/{merchant_uid}/{module}/{id}`     | update           |
+| `DELETE` | `api/v5/merchants/{merchant_uid}/{module}/{id}`     | delete           |
+
+## Ref
+
+```bash
+curl -H "x-api-key: p8Hwl4A7ewynszODOOc05SJcqSP6YZDo2pevtZ" \
+  "https://lite-dev.posx.ai/api/v5/merchants/by-whatsapp-jid/6590992059@s.whatsapp.net"
+```

package/dev/test-logs/2026-02.md

@@ -0,0 +1,5 @@
+# 2026-02 测试日志
+
+| # | 分支 | 时间 | 变更 | 测试 | 🌐 | 问题 | 状态 |
+|---|------|------|------|------|:--:|------|------|
+| 1 | bugfix/rounding-half-up-51 | 02-03 10:45 | roundingStep 实现 round half up | 19/20 passed | ✗ | `service-charge-and-tax-exempt.test.ts` 期望值需更新 5877→5876.9 | 🔧 需修复 |