LTJT Agent + ERP 业务操作项目
本项目的当前目标是：由云端 Agent Prompt 路由用户指令，由统一 Skill 拆解为业务系统可解析的标准 operation，再由生产控制平面、业务页面和 Chrome ERP 适配器完成确定性校验与后续操作。
当前架构加固已经加入 control-plane：PostgreSQL 持久化任务与审计，管理员通过服务端会话登录，浏览器插件只负责已登录 ERP 会话内的确定性执行。
当前入口
- 先读 开发维护规范。
- Agent 路由提示词：agent设计规范/agent-prompt.md。
- 统一业务 Skill：agent设计规范/skills/ltjt-business-operation/SKILL.md。
- 标准输出契约：schemas/standard_system_operation.schema.json。
- ERP 表单映射：mappings/orders_add.mapping.json。
- 业务系统联调：mock-business-system/README.md。
- 生产控制平面：control-plane/README.md。
本地外部 Agent 解析联调使用：
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的页面继续作为现有操作台，但任务读写已迁移到控制平面；浏览器本地状态只能作为界面缓存，不能作为生产权威数据源。
本地验证
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 写入必须遵循维护规范中的授权、预检、拦截、哈希和回查门禁。