# 机器人管理 — 未来规划（Roadmap）

> **module**: robot-manager
> **doc_type**: Roadmap
> **status**: Living document（随每季度规划迭代）
> **owner**: FFOA Team
> **last_verified**: 2026-04-18

---

## 定位

这份文档是**方向性规划**，不是承诺。具体实施优先级、时间节点视业务价值和资源而定。每完成一项移入"已交付"，持续追加新想法。

三个象限：
- **AI 增强**：让系统"更智能"
- **效率优化**：让现有流程"更快 / 更省力"
- **生态集成**：打通外部系统

---

## 🤖 Phase 1 — AI 增强

### 1.1 智能状态推进建议

**问题**：当前状态变更需要业务方手动操作。物流更新、合同签订、收款到账等信号其实可以自动推状态。

**方案**：
- 接入物流 API（菜鸟 / 顺丰），检测到签收自动从 IN_TRANSIT → IN_STOCK
- 接入支付网关，检测到客户付款自动建议 RESERVED → SOLD
- AI 模型基于 metadata 字段变化推断状态机位置，给业务方**建议**（而非自动执行）

**价值**：减少人工操作，让状态永远是最新的。

---

### 1.2 维修知识库

**问题**：每次维修都是从零开始判断故障原因。历史 ServiceRecord 数据沉睡着大量知识。

**方案**：
- 用 LLM 索引所有 ServiceRecord（description、resolution、customerFeedback）
- 维修工程师输入"XXX 故障现象" → 返回历史相似案例 + 常见解决方案
- 逐步积累成故障诊断知识库，新员工上手门槛降低

**价值**：维修效率 +30%，知识沉淀。

---

### 1.3 客户流失预警

**问题**：客户第二次、第三次下单需要运营主动维护。当前系统不提示。

**方案**：
- 基于 DELIVERED 设备的使用时长 + 保修期 + 报修记录，AI 预测客户流失概率
- 提前 3 个月给销售推送预警："客户 X 的 5 台设备下月到保，流失概率 42%"
- 销售可一键生成续保/升级提案

**价值**：销售团队主动触达，续约率提升。

---

### 1.4 Excel 导入的 AI 纠错

**问题**：业务方的 Excel 模板可能列名不一致（"采购价" vs "Purchase Price" vs "采购金额"）、数据格式错乱。

**方案**：
- 导入时用 AI 理解列名语义自动映射（fuzzy match + 语义模型）
- 错误行不直接拒绝，给出智能建议（"此列像是 price，但数据格式是日期，请检查"）
- 支持自然语言查询："给我看上个月发货给特斯拉的所有设备"→ 自动生成 SQL / API 调用

**价值**：降低数据导入门槛，业务方不需要记住模板列名。

---

## ⚡ Phase 2 — 效率优化

### 2.1 移动端适配

**问题**：仓库工人、维修工程师经常在现场，没有电脑。

**方案**：
- 响应式布局 / PWA 支持，手机直接扫 FFSN 条码查看状态
- 扫码快速变更状态（在现场直接推 IN_STOCK / DELIVERED）
- 图片 / 视频上传（维修过程记录）

### 2.2 批量操作增强

**问题**：当前批量状态变更只能批量选择机器 + 单一目标状态。真实场景更复杂（100 台机器每台状态不同）。

**方案**：
- 批量编辑 metadata 字段（比如批量设置 currency = CNY）
- 批量分配客户（选一批 IN_STOCK 机器 → 分配给同一客户）
- 批量 FFSN 打印条码标签

### 2.3 自定义报表 + 看板

**问题**：当前报表只有 3 类（库存 / 销售 / 财务），业务方要自定义筛选分析维度。

**方案**：
- 可视化报表构建器（拖拽字段 + 聚合维度）
- 保存常用报表为"我的看板"
- 按角色默认显示对应 KPI（Sales 看销售周期，Finance 看回款账龄）

### 2.4 审计日志全链路可查

**问题**：目前状态变更日志 + 维修记录是分散的，想看"这台机器的所有变更"要翻多个地方。

**方案**：
- 统一的"时间线"视图（timeline），按时间顺序展示所有事件
- 每个事件可点击跳到具体操作人 / 详情
- 导出机器的完整履历（Excel / PDF）

### 2.5 字段定义版本管理

**问题**：FieldDef 改了之后，历史 metadata 的语义可能变化（如 `paymentStatus` 枚举从 4 个改成 5 个）。当前没有版本追踪。

**方案**：
- FieldDef 改动有 change log（谁改了、改了啥）
- 旧 options 被删除时，自动扫描是否有 metadata 数据还在引用
- 可以"软删除"字段而不影响历史数据

---

## 🔌 Phase 3 — 生态集成

### 3.1 ERP 对账

**问题**：Finance 手动把成本/销售额同步到 ERP 系统。

**方案**：
- 与 SAP / 金蝶 / 用友的对账接口打通
- 每日自动同步销售额、成本到 ERP
- 发现差异自动告警

### 3.2 仓储系统（WMS）联动

**问题**：Location 手工维护，和仓库实际库存可能不一致。

**方案**：
- WMS 实时同步库位信息
- FFSN + 库位绑定，扫码确认
- 盘点差异自动报警

### 3.3 物流系统实时追踪

**问题**：运输中的状态要靠业务方手动问物流公司。

**方案**：
- 对接顺丰 / DHL / 菜鸟等物流 API
- 自动拉取 trackingId 对应的物流节点
- 物流异常（滞留 / 丢件）主动推送

### 3.4 CRM / 客户反馈

**问题**：客户满意度、复购意向数据散落在 Sales 的个人记录里。

**方案**：
- 对接 Salesforce / HubSpot / 钉钉 CRM
- 机器人交付后自动发调查问卷
- 客户反馈（customerFeedback 字段）自动关联到 CRM Contact

---

## 🌍 Phase 4 — 国际化 / 多租户（长期）

### 4.1 多币种拆分

**问题**：当前"每台机器一个主货币"。跨境业务（人民币采购 → 美元销售）无法精确表达。

**方案**：
- 拆成 `purchaseCurrency`（供应链采购用）+ `salesCurrency`（销售客户用）
- 报表自动按货币分组聚合
- 加入汇率表，可选择"按当天汇率折算后的综合报表"

### 4.2 多语言（不限中英）

**问题**：当前 i18n 只支持 zh/en。未来可能进日韩、东南亚市场。

**方案**：
- FieldDef 的 label 改成多语言 map（zh/en/ja/ko/es/...）
- 业务方可自助增删语言包
- 用户 Profile 选语言

### 4.3 多租户隔离

**问题**：当前架构是单租户（或通过 organizationId 弱隔离）。未来 SaaS 化需要严格租户隔离。

**方案**：
- 每个租户独立 schema 或 RLS（Row Level Security）
- 字典、字段定义租户级配置（A 租户加货币 CAD，不影响 B 租户）
- 租户管理员 UI

---

## 已交付（Delivered）

（随着功能落地，从 Phase 移到这里）

- ✅ 动态字段架构（FieldDef 驱动 metadata）
- ✅ 字段级权限（5 个角色 × 6 个 section）
- ✅ 状态机 10 个状态 + Guard + 副作用
- ✅ 7 种货币 + 会计格式（Intl.NumberFormat）
- ✅ Excel 导入导出
- ✅ 智元换货（系统字典自助扩展）
- ✅ 业务错误码国际化（`RobotError` + 前端 i18n）
- ✅ 统一字典到 FieldDef（v5 重构）

---

## 收到建议？

这份文档**欢迎 PR 添加想法**。格式：
```
## 想法名
**问题**: 一句话描述痛点
**方案**: 2-3 句话描述解法
**价值**: 量化收益（成本 / 效率 / 客户体验）
```

不追求马上落地，先写下来。优先级随业务阶段判断。