# ForgeFlow ERP

宁波嘉恒智能科技有限公司五金行业 ERP 初始骨架，采用前后端分离架构：

- 前端：Vue 3 + Vite
- 后端：FastAPI
- 数据库：MySQL 8

当前版本已经包含：

- 五金行业 ERP 的业务设计文档
- 覆盖销售、MRP、采购、仓储、生产报工、设备、财务、退货的 MySQL DDL
- FastAPI 模块化接口骨架与示例数据
- 工业风 Vue 管理端首页与流程中心页面

## 目录结构

```text
backend/
  app/
  sql/
docs/
frontend/
```

## 启动方式

### 后端

```bash
cd /Users/souplearn/Gitlab/py/ForgeFlow-ERP/backend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload
```

### 前端

```bash
cd /Users/souplearn/Gitlab/py/ForgeFlow-ERP/frontend
npm install
npm run dev
```

## 重要文件

- 业务设计文档：`/Users/souplearn/Gitlab/py/ForgeFlow-ERP/docs/system-design.md`
- 数据库 DDL：`/Users/souplearn/Gitlab/py/ForgeFlow-ERP/backend/sql/jiaheng_erp_schema.sql`
- 后端入口：`/Users/souplearn/Gitlab/py/ForgeFlow-ERP/backend/app/main.py`
- 前端入口：`/Users/souplearn/Gitlab/py/ForgeFlow-ERP/frontend/src/main.js`

## 下一步建议

1. 你执行 DDL 建库建表。
2. 下一轮把 MySQL 连接信息给我。
3. 我继续把 SQLAlchemy 模型、真实 CRUD、登录鉴权、单据流转和报工小程序接入补齐。