Order Tracker

---

name: order-tracker description: "Track and manage sales orders with status updates, notifications, and dashboard reporting. Supports order creation, status transitions (pending/confirmed/shipped/delivered), email/Discord notifications, and order history visualization. Use when you need to monitor order fulfillment, send shipping updates to customers, or generate order analytics."

---

Order Tracker Skill

Description

本地订单跟踪系统，提供手动订单状态管理、客户邮件通知和命令行看板功能。适用于 Farreach Electronic 外贸订单生命周期管理（从生产到交付），无需对接工厂 ERP 或物流 API。

When to Use

查询某个订单的当前状态

更新订单状态（生产中 → 待发货 → 已发货 → 已完成）

向客户发送订单状态变更邮件通知

查看所有在途订单的看板汇总

检测逾期或紧急（≤7 天）订单

Prerequisites

Node.js v16+

已配置 imap-smtp-email skill 的 SMTP .env 文件（用于发送通知邮件）

依赖安装：npm install（在 skill 目录下执行）

Skills Directory

skills/order-tracker/

How to Invoke

All scripts are run from the scripts/ subdirectory.

1. View Order Dashboard

cd skills/order-tracker/scripts
查看所有订单（按状态分组）
node order-dashboard.js
按状态过滤
node order-dashboard.js --status in_production
node order-dashboard.js --status shipped
查看单个订单详情
node order-dashboard.js --order-id ORD-20260324-001
输出格式（table / compact / json）
node order-dashboard.js --format json

2. Update Order Status

cd skills/order-tracker/scripts
预览（dry-run，不写入）
node update-order-status.js --order-id ORD-20260324-001 --status ready_to_ship --dry-run
更新状态
node update-order-status.js \
  --order-id ORD-20260324-001 \
  --status shipped \
  --notes "DHL Express, 单号: 1234567890, ETA: 4月25日"
更新状态 + 标记需要发通知
node update-order-status.js \
  --order-id ORD-20260324-001 \
  --status in_production \
  --notes "工厂已排期" \
  --trigger-notification

3. Send Customer Notification Email

cd skills/order-tracker/scripts
预览邮件（不发送）
node send-order-notification.js --order-id ORD-20260324-001 --dry-run
发送通知（使用订单当前状态的邮件模板）
node send-order-notification.js --order-id ORD-20260324-001
指定状态模板发送
node send-order-notification.js --order-id ORD-20260324-001 --status shipped

Order Status Model

6 状态机：

pending_production → in_production → ready_to_ship → shipped → completed
                                                              ↘ cancelled（任意阶段可取消）

| 状态 | 中文 | 说明 | |------|------|------| | pending_production | 待生产 | 订单确认，等待生产 | | in_production | 生产中 | 工厂生产中 | | ready_to_ship | 待发货 | 生产完成，等待发货 | | shipped | 已发货 | 货物已发出 | | completed | 已完成 | 客户确认收货 | | cancelled | 已取消 | 订单取消 |

Email Templates

通知脚本支持 5 种双语（EN/ZH）邮件模板：

in_production — 生产进度通知

ready_to_ship — 准备发货通知

shipped — 发货确认（含物流单号）

completed — 订单完成确认

cancelled — 取消通知

Typical Workflow Example

BASE=skills/order-tracker/scripts
ORDER=ORD-20260324-001
开始生产 + 通知客户
node $BASE/update-order-status.js --order-id $ORDER --status in_production --notes "工厂已排期"
node $BASE/send-order-notification.js --order-id $ORDER
发货 + 通知客户
node $BASE/update-order-status.js --order-id $ORDER --status shipped --notes "DHL 单号: 1234567890"
node $BASE/send-order-notification.js --order-id $ORDER
查看看板
node $BASE/order-dashboard.js

Data Files

| 文件 | 路径 | 说明 | |------|------|------| | 订单数据 | data/orders.json | 所有订单（手动维护） | | 订单 Schema | config/order-schema.json | JSON Schema 验证定义 | | 状态变更日志 | logs/status-changes.log | 每次状态更新记录 | | 通知日志 | logs/notifications.log | 邮件发送记录 |

Constraints

不对接工厂 ERP/MES 系统

不抓取物流 API

状态手动更新

数据存储本地 JSON 文件

Source

Task: task-005（Phase 3）

Implemented by: IRON (bailian/qwen3.5-plus)

Reviewed by: WILSON (aiberm/claude-sonnet-4-6)

Completed: 2026-03-24

Node.js v16+

已配置 imap-smtp-email skill 的 SMTP .env 文件（用于发送通知邮件）

依赖安装：npm install（在 skill 目录下执行）

不对接工厂 ERP/MES 系统

不抓取物流 API

状态手动更新

数据存储本地 JSON 文件