65 lines
3.7 KiB
Markdown
65 lines
3.7 KiB
Markdown
# 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 写入必须遵循维护规范中的授权、预检、拦截、哈希和回查门禁。
|