# 绿纤ERP管理系统

## 项目简介

绿纤ERP管理系统是一个基于现代化技术栈开发的企业资源规划系统，专为绿纤行业量身定制。系统采用前后端分离架构，提供完整的生产、销售、库存、财务等业务管理功能。

## 技术栈

### 后端技术
- **.NET Core 3.1/5.0** - 跨平台Web框架
- **SqlSugar** - 轻量级ORM框架
- **MySQL** - 关系型数据库
- **JWT** - 身份认证
- **Serilog** - 结构化日志
- **Swagger** - API文档

### 前端技术
- **Vue 2.6** - 渐进式JavaScript框架
- **Element UI** - 企业级UI组件库
- **Vuex** - 状态管理
- **Vue Router** - 路由管理
- **Axios** - HTTP客户端
- **SCSS** - CSS预处理器

## 项目结构

```
lvqianmeiye_ERP/
├── netcore/                    # 后端.NET Core项目
│   └── src/
│       ├── Application/        # 应用层
│       ├── Infrastructure/     # 基础设施层
│       └── Modularity/         # 业务模块层
│           ├── System/         # 系统管理模块
│           ├── Extend/         # 🎯 核心业务模块（绿纤ERP业务逻辑）
│           │   ├── NCC.Extend/           # 业务服务层
│           │   ├── NCC.Extend.Entitys/   # 实体模型层
│           │   └── NCC.Extend.Interfaces/ # 接口定义层
│           ├── OAuth/          # 身份认证模块
│           ├── Message/        # 消息中心模块
│           ├── Order/          # 订单管理模块
│           ├── VisualDev/      # 可视化开发模块
│           └── Tenant/         # 多租户支持模块
├── antis-ncc-admin/           # 前端Vue项目
│   ├── src/
│   │   ├── api/               # API接口
│   │   ├── components/        # 公共组件
│   │   ├── views/             # 页面视图
│   │   │   ├── lqBmzb/        # 部门管理页面
│   │   │   ├── lqCpxx/        # 产品信息页面
│   │   │   ├── lqHygl/        # 会员管理页面
│   │   │   └── ...            # 其他业务页面
│   │   ├── router/            # 路由配置
│   │   └── store/             # 状态管理
│   ├── package.json           # 前端依赖配置
│   └── vue.config.js          # Vue构建配置
└── html/                      # 静态资源
```

## 🎯 核心业务模块说明

**Extend模块**是系统的核心业务模块，包含绿纤ERP的所有业务逻辑。该模块采用三层架构设计：

### NCC.Extend（业务服务层）
包含所有业务服务的具体实现，按功能分类：

#### 📋 基础管理类
- `LqBmzbService` - 部门管理服务
- `LqCpxxService` - 产品信息管理服务
- `LqKhxxService` - 客户信息管理服务
- `LqRyzlService` - 人员资料管理服务

#### 🏭 生产管理类
- `LqJsfaService` - 工艺方案管理服务
- `LqSbtjbService` - 设备统计管理服务
- `LqYcsdJsjService` - 技术数据管理服务
- `LqYcsdJjlftjsService` - 技术方案管理服务
- `LqYcsdMdlbjhsxxService` - 模具管理服务

#### 💰 销售管理类
- `LqXhHyhkService` - 销售回款管理服务
- `LqXhmxbService` - 销售明细管理服务
- `LqTkXscService` - 提成管理服务
- `LqTkjlbService` - 提成记录管理服务

#### 📦 库存管理类
- `LqKqhzbService` - 库存汇总管理服务
- `LqLssjService` - 历史数据管理服务
- `LqYjmxbService` - 原料明细管理服务

#### 📊 财务管理类
- `LqSkzhService` - 收款账户管理服务
- `LqHzfService` - 汇总费用管理服务
- `LqJdqdService` - 季度清单管理服务

#### 🔧 系统工具类
- `EmailService` - 邮件服务
- `DocumentService` - 文档管理服务
- `BigDataService` - 大数据分析服务
- `WorkLogService` - 工作日志服务

### NCC.Extend.Entitys（实体模型层）
- **Entity/** - 数据库实体模型（66个实体）
- **Dto/** - 数据传输对象（304个DTO）
- **Mapper/** - 对象映射配置（50个映射器）
- **Model/** - 业务模型类

### NCC.Extend.Interfaces（接口定义层）
- 定义所有业务服务的接口契约
- 支持依赖注入和单元测试
- 提供清晰的业务边界

## 环境要求

### 开发环境
- **Node.js**: 16.20.2 (必须使用此版本)
- **.NET Core SDK**: 3.1 或 5.0
- **MySQL**: 5.7 或 8.0
- **Visual Studio 2019/2022** 或 **VS Code**

### 浏览器支持
- Chrome 70+
- Firefox 65+
- Safari 12+
- Edge 79+

## 快速开始

### 1. 克隆项目
```bash
git clone [项目地址]
cd lvqianmeiye_ERP
```

### 2. 后端启动

#### 方式一：Visual Studio
1. 打开 `netcore/smart.agriculture.platform.NET.sln`
2. 设置 `NCC.API` 为启动项目
3. 按 F5 运行

#### 方式二：命令行
```bash
cd netcore/src/Application/NCC.API
dotnet restore
dotnet run
```

### 3. 前端启动

```bash
cd antis-ncc-admin

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

### 4. 访问系统
- 前端地址：http://localhost:3000
- 后端API：http://localhost:5000
- API文档：http://localhost:5000/antis.doc

## 默认账号

- **管理员账号**：admin
- **默认密码**：123456

## 主要功能模块

> 💡 **说明**：所有业务功能的核心代码都位于 `netcore/src/Modularity/Extend/` 模块中

### 📋 基础管理模块
- **部门管理** (`LqBmzbService`) - 组织架构管理，部门分类维护
- **产品信息** (`LqCpxxService`) - 产品档案管理，产品分类维护
- **客户信息** (`LqKhxxService`) - 客户档案管理，客户关系维护
- **人员资料** (`LqRyzlService`) - 员工信息管理，人员档案维护

### 🏭 生产管理模块
- **工艺方案** (`LqJsfaService`) - 生产工艺配置，工艺流程管理
- **设备统计** (`LqSbtjbService`) - 设备使用情况统计，设备维护管理
- **技术数据** (`LqYcsdJsjService`) - 技术参数管理，工艺数据维护
- **技术方案** (`LqYcsdJjlftjsService`) - 技术方案管理，工艺优化
- **模具管理** (`LqYcsdMdlbjhsxxService`) - 模具档案管理，模具维护

### 💰 销售管理模块
- **销售回款** (`LqXhHyhkService`) - 销售回款管理，资金回笼跟踪
- **销售明细** (`LqXhmxbService`) - 销售明细管理，销售数据分析
- **提成管理** (`LqTkXscService`) - 销售提成计算，提成规则维护
- **提成记录** (`LqTkjlbService`) - 提成记录管理，提成发放跟踪

### 📦 库存管理模块
- **库存汇总** (`LqKqhzbService`) - 库存数据分析，库存统计报表
- **历史数据** (`LqLssjService`) - 历史数据管理，数据归档
- **原料明细** (`LqYjmxbService`) - 原料库存管理，原料使用跟踪

### 📊 财务管理模块
- **收款账户** (`LqSkzhService`) - 收款账户管理，资金账户维护
- **汇总费用** (`LqHzfService`) - 费用汇总管理，成本分析
- **季度清单** (`LqJdqdService`) - 季度财务清单，财务报告

### 🔧 系统工具模块
- **邮件服务** (`EmailService`) - 邮件发送，通知提醒
- **文档管理** (`DocumentService`) - 文档存储，文件管理
- **大数据分析** (`BigDataService`) - 数据分析，报表生成
- **工作日志** (`WorkLogService`) - 工作日志记录，操作跟踪

### ⚙️ 系统管理模块（位于System模块）
- **用户管理** - 系统用户维护，用户权限管理
- **角色权限** - 权限分配管理，角色权限配置
- **系统配置** - 系统参数设置，基础配置维护
- **日志管理** - 操作日志查看，系统日志分析

## 开发指南

### 🎯 核心业务开发（Extend模块）

#### 添加新的业务服务
1. **创建实体模型** (`NCC.Extend.Entitys/Entity/`)
   ```csharp
   [SugarTable("lq_新表名")]
   [Tenant(ClaimConst.TENANT_ID)]
   public class Lq新实体Entity
   {
       [SugarColumn(ColumnName = "F_Id", IsPrimaryKey = true)]
       public string Id { get; set; }
       // 其他字段...
   }
   ```

2. **创建DTO对象** (`NCC.Extend.Entitys/Dto/`)
   - `Lq新实体ListQueryInput` - 列表查询输入
   - `Lq新实体CrInput` - 创建输入
   - `Lq新实体UpInput` - 更新输入
   - `Lq新实体InfoOutput` - 详情输出
   - `Lq新实体ListOutput` - 列表输出

3. **创建接口定义** (`NCC.Extend.Interfaces/`)
   ```csharp
   public interface ILq新实体Service : ITransient
   {
       Task<dynamic> GetInfo(string id);
       Task<dynamic> GetList(Lq新实体ListQueryInput input);
       Task Create(Lq新实体CrInput input);
       Task Update(string id, Lq新实体UpInput input);
       Task Delete(string id);
   }
   ```

4. **实现业务服务** (`NCC.Extend/`)
   ```csharp
   [ApiDescriptionSettings(Tag = "Extend", Name = "Lq新实体", Order = 200)]
   [Route("api/Extend/[controller]")]
   public class Lq新实体Service : ILq新实体Service, IDynamicApiController, ITransient
   {
       // 服务实现...
   }
   ```

#### 前端页面开发
1. **创建页面组件** (`antis-ncc-admin/src/views/lq新模块/`)
   - `index.vue` - 列表页面
   - `Form.vue` - 表单页面
   - `ExportBox.vue` - 导出组件

2. **添加API接口** (`antis-ncc-admin/src/api/extend/`)
   ```javascript
   export function getLq新实体List(data) {
     return request({
       url: '/api/Extend/Lq新实体',
       method: 'GET',
       data
     })
   }
   ```

### 前端开发
```bash
# 开发模式
npm run dev

# 构建生产版本
npm run build

# 代码检查
npm run lint
```

### 后端开发
```bash
# 还原包
dotnet restore

# 编译项目
dotnet build

# 运行项目
dotnet run

# 发布项目
dotnet publish -c Release
```

## 配置说明

### 数据库配置
修改 `netcore/src/Application/NCC.API/appsettings.json` 中的连接字符串：

```json
{
  "ConnectionStrings": {
    "DefaultConnection": "Database=lqerp;Data Source=localhost;Port=3306;User Id=root;Password=yourpassword;Charset=utf8;"
  }
}
```

### 前端代理配置
修改 `antis-ncc-admin/vue.config.js` 中的代理地址：

```javascript
proxy: {
  '/dev': {
    target: 'http://localhost:5000', // 后端API地址
    changeOrigin: true,
    pathRewrite: {
      '^/dev': ''
    }
  }
}
```

## 部署说明

### 后端部署
1. 发布项目：`dotnet publish -c Release`
2. 配置数据库连接字符串
3. 部署到IIS或Linux服务器

### 前端部署
1. 构建项目：`npm run build`
2. 将 `dist` 目录部署到Web服务器
3. 配置Nginx或IIS反向代理

## 常见问题

### Q: 前端启动失败
A: 确保使用Node.js 16.20.2版本，其他版本可能不兼容

### Q: 后端连接数据库失败
A: 检查数据库连接字符串和MySQL服务状态

### Q: 权限验证失败
A: 检查JWT配置和Token有效期设置

### Q: 页面显示异常
A: 检查浏览器控制台错误信息和网络请求状态

## 技术支持

如有技术问题，请联系开发团队或查看项目文档。

## 版本信息

- **当前版本**：v1.0.0
- **最后更新**：2024年
- **维护状态**：活跃开发中

---

**注意**：本项目仅供学习和内部使用，请勿用于商业用途。