# jiafaERP

**Repository Path**: rymaker/jiafa-erp

## Basic Information

- **Project Name**: jiafaERP
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-27
- **Last Updated**: 2026-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 瞬连仓储ERP

一款基于 Nuxt 3 + TypeORM + MySQL 的进销存管理系统，支持角色权限控制、多级菜单分配和完整的业务模块管理。

## 技术栈

| 层级 | 技术 |
|------|------|
| 前端框架 | Nuxt 3 (Vue 3 + Vite) |
| UI 组件库 | Element Plus |
| 状态管理 | Pinia |
| 后端引擎 | Nitro (Nuxt Server) |
| ORM | TypeORM |
| 数据库 | MySQL 8 |
| 缓存 | Redis (可选) |
| 文件存储 | FTP |
| 图片处理 | sharp |
| 条码生成 | jsbarcode |

## 功能模块

- **工作台** — 系统概览与快捷入口
- **进销存**
  - 商品资料（SKU 管理、图片上传、条码生成）
  - 品名维护
  - 供应商资料
- **系统管理**
  - 用户管理（增删改查、重置密码、分配角色）
  - 角色管理（增删改查、启用/禁用、分配权限）
  - 权限树支持二级/三级菜单

## 权限设计

- 基于角色的访问控制（RBAC）
- 菜单权限：后端返回菜单树，前端动态渲染
- 按钮权限：`v-if="hasPermission('xxx')"` 控制
- 接口权限：后端 JWT 鉴权 + 权限校验
- 管理员保护：系统至少保留一个启用状态的管理员用户

## 快速开始

### 1. 安装依赖

```bash
yarn install
```

### 2. 配置环境变量

复制 `.env` 并根据实际情况修改：

```env
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=your_password
DB_DATABASE=shunlian
DB_SYNCHRONIZE=true

JWT_SECRET=your_jwt_secret
JWT_EXPIRES_IN_SECONDS=604800

API_BASE_URL=/api
```

### 3. 初始化数据库

```bash
# 同步表结构
yarn db:sync

# 初始化权限字典、管理员角色和默认账号
yarn db:seed
```

> `yarn db:seed` 会创建默认管理员账号：`admin / 123456`

### 4. 启动开发服务

```bash
yarn dev --host 0.0.0.0
```

访问 http://localhost:3000

### 5. 生产构建

```bash
yarn build
yarn preview
```

## 项目结构

```
├── app/                    # 前端应用
│   ├── components/         # 组件
│   │   ├── ImageUploader.vue   # 图片上传组件
│   │   ├── BarcodeDialog.vue   # 条码生成弹窗
│   │   └── layout/             # 布局组件
│   ├── composables/        # 组合式函数
│   │   ├── useHttp.ts          # HTTP 请求
│   │   ├── useToast.ts         # Toast 通知
│   │   ├── useUpload.ts        # 文件上传
│   │   └── usePermission.ts    # 权限检查
│   ├── layouts/            # 布局
│   ├── pages/              # 页面
│   ├── plugins/            # 插件
│   ├── stores/             # Pinia Store
│   └── types/              # 类型定义
├── server/                 # 后端服务
│   ├── api/                # API 路由
│   │   ├── images/index.get.ts   # 图片代理/压缩接口
│   │   ├── upload.post.ts        # 文件上传接口
│   │   └── ...
│   ├── config/             # 配置
│   ├── database/           # 数据库与种子脚本
│   ├── middleware/         # 中间件
│   ├── modules/            # 业务模块
│   └── utils/              # 工具函数
│       └── ftp-client.ts       # FTP 客户端
├── doc/
│   └── design.md           # 设计文档
└── nuxt.config.ts
```

## 默认账号

| 账号 | 密码 | 说明 |
|------|------|------|
| admin | 123456 | 系统管理员，拥有全部权限 |

## 常用命令

```bash
yarn dev --host 0.0.0.0   # 开发模式（局域网可访问）
yarn build                  # 生产构建
yarn preview                # 预览生产构建
yarn db:sync                # 同步数据库结构
yarn db:seed                # 初始化种子数据
```

## 许可证

MIT