# LTJT Agent + ERP 业务操作项目

本项目的当前目标是：由云端 Agent Prompt 路由用户指令，由统一 Skill 拆解为业务系统可解析的标准 `operation`，再由生产控制平面、业务页面和 Chrome ERP 适配器完成确定性校验与后续操作。

当前架构加固已经加入 [control-plane](control-plane/README.md)：PostgreSQL 持久化任务与审计，管理员通过服务端会话登录，浏览器插件只负责已登录 ERP 会话内的确定性执行。

## 当前入口

1. 先读 [开发维护规范](开发维护规范.md)。
2. Agent 路由提示词：[agent设计规范/agent-prompt.md](agent设计规范/agent-prompt.md)。
3. 统一业务 Skill：[agent设计规范/skills/ltjt-business-operation/SKILL.md](agent设计规范/skills/ltjt-business-operation/SKILL.md)。
4. 标准输出契约：[schemas/standard_system_operation.schema.json](schemas/standard_system_operation.schema.json)。
5. ERP 表单映射：[mappings/orders_add.mapping.json](mappings/orders_add.mapping.json)。
6. 业务系统联调：[mock-business-system/README.md](mock-business-system/README.md)。
7. 生产控制平面：[control-plane/README.md](control-plane/README.md)。

本地外部 Agent 解析联调使用：

```bash
npm run start:mock
```

该命令自动读取 `mock-business-system/.env`，监听 `http://127.0.0.1:8765/`；生产环境请自行替换该环境文件或使用生产部署配置，根目录 `npm start` 仍用于生产控制平面。

本地控制平面使用根目录 `.env`。`npm run dev`、`npm start`、数据库迁移、管理员初始化和数据清理命令都会自动加载它；生产部署继续使用 `.env.production` 和 Docker Compose 的 `env_file`。

## 当前权威顺序

`开发维护规范.md` → Agent Prompt/Skill references → 标准 Schema → ERP mapping/control scripts → Chrome extension → mock business-system transport。

`archive/` 中的交接包、旧 `erp-task-v1` 和旧架构说明只作参考；`reports/` 仅用于临时生成报告，不得反向覆盖当前契约。

## 目录职责

| 目录 | 状态 | 用途 |
|---|---|---|
| `agent设计规范/` | active-source | 云端 Agent 路由提示词、统一 Skill、业务 references |
| `schemas/`、`mappings/` | active-contract | 标准 operation 和 LTJT 表单映射 |
| `tools/` | active-source | 确定性校验、lookup、预检和回查工具 |
| `chrome-extension/` | active-source | 已登录 ERP 页面内的浏览器适配器 |
| `mock-business-system/` | active-source | 本地业务系统和外部 Agent 解析联调 |
| `samples/` | fixture | 脱敏或测试输入样例 |
| `dist/` | release-artifact | 可交付 ZIP、`.skill` 等生成包 |
| `archive/` | historical-reference | 已退役交接代码和历史资料 |
| `reports/` | generated-output | 运行时生成的临时验证报告，不是业务规则来源 |

## 关键边界

- Agent/Skill 只负责范围判断、业务事实拆解和标准结构化输出。
- ERP 控制脚本负责产品模板副作用、精确 lookup、表单映射、预检和回查。
- Agent 不调用 ERP、不操作浏览器，也不声称业务已完成。
- `mock-business-system` 的页面继续作为现有操作台，但任务读写已迁移到控制平面；浏览器本地状态只能作为界面缓存，不能作为生产权威数据源。

## 本地验证

```bash
npm test
node --check mock-business-system/server.mjs
node --check mock-business-system/external-agent-client.mjs
node --check chrome-extension/ltjt-order-assistant/operation-plans.js
node --check chrome-extension/ltjt-order-assistant/execution-guard.js
```

真实 ERP 写入必须遵循维护规范中的授权、预检、拦截、哈希和回查门禁。