一套面向制造与供应链场景的 AI Native ERP，主打元数据驱动、事件驱动和多端协同。
本项目不是做一个“页面很多的管理后台”，而是做一个可持续演进的业务引擎：
- 元数据驱动 UI（减少重复开发）
- 通用 CRUD + 生命周期 Hook（业务扩展不破坏内核）
- 事件驱动跨模块联动（库存、财务、流程解耦）
- AI 命令栏 + Chat2Dash/Chat2SQL（从“点按钮”升级到“说意图”）
| 对比项 | Enterprise ERP | Odoo | ERPNext |
|---|---|---|---|
| 技术栈 | TypeScript 全栈（NestJS + Next.js） | Python + JS | Python + JS |
| 核心范式 | 元数据驱动 + 通用 CRUD + 事件驱动 | 模块化 + ORM | 模块化 + DocType |
| AI 原生能力 | 内置 Command Bar / Chat2Dash / Chat2SQL | 需要额外插件 | 需要额外插件 |
| 多端规划 | Web + Mobile(Expo) + Desktop(Tauri) | Web 为主 | Web 为主 |
| 自定义成本 | 中低（Schema + Metadata） | 中 | 中 |
请把真实截图放到
docs/image/screenshots/，并替换以下占位链接。
- 仪表盘总览：
docs/image/screenshots/dashboard.png - 销售订单工作台：
docs/image/screenshots/sales-order.png - 库存台账：
docs/image/screenshots/inventory-ledger.png - AI 命令栏：
docs/image/screenshots/ai-command.png
npm installdocker compose up -dcd apps/api
npx prisma generate
npx prisma migrate dev --name init
cd ../..cd apps/api
npm run start:devcd apps/web
npm run dev访问地址：
- Web: http://localhost:3000
- API: http://localhost:8000/api
- Swagger: http://localhost:8000/api/docs
flowchart LR
U[User] --> W[Web Next.js]
U --> M[Mobile Expo]
U --> D[Desktop Tauri]
W --> A[API NestJS]
M --> A
D --> A
A --> C[Core Engines]
C --> CRUD[Generic CRUD]
C --> META[Metadata]
C --> WF[Workflow]
C --> AUDIT[Audit Timeline]
C --> AI[AI Command Service]
A --> P[(PostgreSQL)]
A --> R[(Redis)]
A --> O[(Object Storage MinIO)]
A --> E[Event Bus]
E --> INV[Inventory]
E --> FIN[Finance]
E --> PROD[Production]
- Auth / Users
- Departments / Company / Multi-tenant Context
- Orders / Partners / Product & Material
- Inventory（Warehouse / Location / Quant / Transactions）
- Production（BOM / WorkOrder / WorkReport）
- Finance（Invoice / Payment / Journal / Entry / DLQ）
- Files（对象存储与下载链接）
- Dashboard（运营看板）
- Core（CRUD / Metadata / Workflow / Audit / AI）
- AI Command Bar：自然语言触发业务动作（支持 dry-run 草稿确认）
- Chat2Dash：自然语言转图表洞察
- Chat2SQL：自然语言转查询语句（只读场景）
- OCR Draft（规划中）：附件识别并生成草稿单据
- P0: 税务引擎（税码、税率、含税/未税）
- P0: 采购全链路（询价、采购单、收货、应付）
- P1: 库存单据头（Stock Picking/Wave）
- P1: 多币种与汇率重估
- P2: CRM 线索与商机漏斗
- P2: HR/Payroll
欢迎贡献代码、文档和测试：
- Fork 本仓库
- 新建分支（
agent/backend/*、agent/frontend/*、agent/db/*） - 提交遵循 Conventional Commits
- 提交 PR 并通过 CI
详细规范见 CONTRIBUTING.md。
- docs/architecture/STANDARDS.md
- docs/plans/PROJECT_PLAN_AND_STATUS.md
- docs/plans/PROJECT_PLAN.md
- docs/plans/EXECUTION_PLAN.md
- docs/plans/CORE_MODULES_DEV_PLAN.md
- docs/AI_INSTRUCTIONS.md
MIT