feat: 实现供应商管理模块

- 新增供应商管理功能 - 数据库表：asset_supplier（27个字段） - 基本信息：供应商编码、名称、类型、合作状态等 - 开票信息：税号、开票地址、账号、开户行等 - 完整的 CRUD 接口 - 后端代码 - Controller/Service/Mapper/VO/DO 完整实现 - 支持多条件分页查询 - 字段验证（手机号、邮箱格式） - 供应商编码唯一性约束 - API 接口 - POST /asset/supplier/create - 创建供应商 - PUT /asset/supplier/update - 更新供应商 - DELETE /asset/supplier/delete - 删除供应商 - GET /asset/supplier/get - 获取供应商详情 - GET /asset/supplier/page - 分页查询供应商 - 查询功能 - 供应商编码精确查询 - 合作状态多选筛选 - 供应商名称模糊查询 - 供应商类型多选筛选 - 区域多选筛选 - 城市精确查询 - 创建者筛选 - 菜单和权限 - 供应商管理菜单 - 5个按钮权限（查询、创建、更新、删除、导出） - 文档 - 供应商管理模块开发总结 - 数据库初始化脚本
2026-03-12 21:09:06 +08:00
parent 30e15b90ea
commit 43f2f054e9
13 changed files with 1009 additions and 0 deletions
--- a/yudao-module-asset/SUPPLIER_MANAGEMENT_SUMMARY.md
+++ b/yudao-module-asset/SUPPLIER_MANAGEMENT_SUMMARY.md
@@ -0,0 +1,353 @@
+# 供应商管理模块开发总结
+
+## 📋 需求来源
+
+根据 ONE-OS 前端原型 `/Users/kkfluous/Projects/ai-coding/ln-oneos/ONE-OS/web端/业务管理/供应商管理*.jsx` 进行后端设计开发。
+
+## 🎯 功能概述
+
+供应商管理模块用于管理企业的各类供应商信息，包括加氢站、充电站、维修站、保险公司、备件供应商等。
+
+### 核心功能
+- ✅ 供应商列表查询（支持多条件筛选）
+- ✅ 供应商新增
+- ✅ 供应商编辑
+- ✅ 供应商查看
+- ✅ 供应商删除
+- 🔲 供应商导入（待实现）
+- 🔲 供应商导出（待实现）
+
+## 📊 数据模型
+
+### 供应商信息表 (asset_supplier)
+
+#### 基本信息
+| 字段 | 类型 | 说明 | 必填 |
+|------|------|------|------|
+| id | BIGINT | 主键ID | ✓ |
+| supplier_code | VARCHAR(50) | 供应商编码 | ✓ |
+| coop_status | VARCHAR(20) | 合作状态 | ✓ |
+| supplier_name | VARCHAR(100) | 供应商名称 | ✓ |
+| type | VARCHAR(50) | 供应商类型 | ✓ |
+| province | VARCHAR(50) | 省份 | |
+| city | VARCHAR(50) | 城市 | |
+| address | VARCHAR(255) | 详细地址 | |
+| region | VARCHAR(20) | 区域 | |
+| contact | VARCHAR(50) | 联系人 | |
+| contact_mobile | VARCHAR(20) | 联系手机 | |
+| contact_phone | VARCHAR(50) | 联系电话 | |
+| email | VARCHAR(100) | 邮箱 | |
+| credit_code_or_id | VARCHAR(100) | 统一社会信用代码/身份证号 | |
+| remark | VARCHAR(500) | 备注 | |
+
+#### 开票信息
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| tax_id | VARCHAR(100) | 税号 |
+| invoice_address | VARCHAR(255) | 开票地址 |
+| invoice_phone | VARCHAR(50) | 开票电话 |
+| account | VARCHAR(100) | 账号 |
+| opening_bank | VARCHAR(200) | 开户行 |
+| mailing_address | VARCHAR(255) | 邮寄地址 |
+
+#### 审计字段
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| creator | VARCHAR(64) | 创建者 |
+| create_time | DATETIME | 创建时间 |
+| updater | VARCHAR(64) | 更新者 |
+| update_time | DATETIME | 更新时间 |
+| deleted | BIT(1) | 是否删除 |
+| tenant_id | BIGINT | 租户编号 |
+
+### 索引设计
+- PRIMARY KEY: `id`
+- UNIQUE KEY: `uk_supplier_code` (supplier_code, deleted)
+- INDEX: `idx_supplier_name` (supplier_name)
+- INDEX: `idx_coop_status` (coop_status)
+- INDEX: `idx_type` (type)
+- INDEX: `idx_region` (region)
+- INDEX: `idx_city` (city)
+- INDEX: `idx_create_time` (create_time)
+- INDEX: `idx_tenant_id` (tenant_id)
+
+## 🏗️ 代码结构
+
+### 后端文件清单
+
+```
+yudao-module-asset/yudao-module-asset-server/
+├── src/main/java/cn/iocoder/yudao/module/asset/
+│   ├── controller/admin/supplier/
+│   │   ├── SupplierController.java          # 控制器
+│   │   └── vo/
+│   │       ├── SupplierBaseVO.java          # 基础 VO
+│   │       ├── SupplierSaveReqVO.java       # 创建/更新 Request VO
+│   │       ├── SupplierRespVO.java          # 响应 VO
+│   │       └── SupplierPageReqVO.java       # 分页查询 Request VO
+│   ├── service/supplier/
+│   │   ├── SupplierService.java             # Service 接口
+│   │   └── SupplierServiceImpl.java         # Service 实现
+│   ├── convert/supplier/
+│   │   └── SupplierConvert.java             # 对象转换
+│   ├── dal/
+│   │   ├── dataobject/supplier/
+│   │   │   └── SupplierDO.java              # 数据对象
+│   │   └── mysql/supplier/
+│   │       └── SupplierMapper.java          # Mapper
+│   └── enums/
+│       └── ErrorCodeConstants.java          # 错误码（已更新）
+└── sql/mysql/
+    └── supplier.sql                          # 数据库脚本
+```
+
+## 🔌 API 接口
+
+### 基础路径
+```
+/asset/supplier
+```
+
+### 接口列表
+
+#### 1. 创建供应商
+```
+POST /asset/supplier/create
+权限: asset:supplier:create
+```
+
+**Request Body**
+```json
+{
+  "supplierCode": "GYS-2025-001",
+  "coopStatus": "已合作",
+  "supplierName": "嘉兴某某加氢站",
+  "type": "加氢站",
+  "province": "浙江省",
+  "city": "嘉兴市",
+  "address": "浙江省嘉兴市南湖区科技大道1号",
+  "region": "华东",
+  "contact": "张三",
+  "contactMobile": "13800138001",
+  "contactPhone": "0571-88888888",
+  "email": "zhangsan@example.com",
+  "creditCodeOrId": "91330400MA2XXXXX1",
+  "remark": "",
+  "taxId": "91330400MA2XXXXX1",
+  "invoiceAddress": "浙江省嘉兴市南湖区科技大道1号",
+  "invoicePhone": "0571-88888888",
+  "account": "6222021234567890123",
+  "openingBank": "中国工商银行嘉兴分行",
+  "mailingAddress": "浙江省嘉兴市南湖区科技大道1号"
+}
+```
+
+**Response**
+```json
+{
+  "code": 0,
+  "data": 1,
+  "msg": "操作成功"
+}
+```
+
+#### 2. 更新供应商
+```
+PUT /asset/supplier/update
+权限: asset:supplier:update
+```
+
+**Request Body**
+```json
+{
+  "id": 1,
+  "supplierCode": "GYS-2025-001",
+  "coopStatus": "已合作",
+  "supplierName": "嘉兴某某加氢站",
+  ...
+}
+```
+
+#### 3. 删除供应商
+```
+DELETE /asset/supplier/delete?id=1
+权限: asset:supplier:delete
+```
+
+#### 4. 获取供应商详情
+```
+GET /asset/supplier/get?id=1
+权限: asset:supplier:query
+```
+
+**Response**
+```json
+{
+  "code": 0,
+  "data": {
+    "id": 1,
+    "supplierCode": "GYS-2025-001",
+    "coopStatus": "已合作",
+    "supplierName": "嘉兴某某加氢站",
+    "type": "加氢站",
+    "province": "浙江省",
+    "city": "嘉兴市",
+    "address": "浙江省嘉兴市南湖区科技大道1号",
+    "region": "华东",
+    "contact": "张三",
+    "contactMobile": "13800138001",
+    "contactPhone": "0571-88888888",
+    "email": "zhangsan@example.com",
+    "creditCodeOrId": "91330400MA2XXXXX1",
+    "remark": "",
+    "taxId": "91330400MA2XXXXX1",
+    "invoiceAddress": "浙江省嘉兴市南湖区科技大道1号",
+    "invoicePhone": "0571-88888888",
+    "account": "6222021234567890123",
+    "openingBank": "中国工商银行嘉兴分行",
+    "mailingAddress": "浙江省嘉兴市南湖区科技大道1号",
+    "creator": "admin",
+    "createTime": "2025-01-10T09:30:00",
+    "updater": "admin",
+    "updateTime": "2025-01-10T09:30:00"
+  },
+  "msg": "操作成功"
+}
+```
+
+#### 5. 分页查询供应商
+```
+GET /asset/supplier/page
+权限: asset:supplier:query
+```
+
+**Query Parameters**
+- `pageNo`: 页码（默认 1）
+- `pageSize`: 每页数量（默认 10）
+- `supplierCode`: 供应商编码（精确匹配）
+- `coopStatus`: 合作状态列表（多选）
+- `supplierName`: 供应商名称（模糊查询）
+- `type`: 供应商类型列表（多选）
+- `region`: 区域列表（多选）
+- `city`: 城市（精确匹配）
+- `creator`: 创建者（精确匹配）
+
+**Response**
+```json
+{
+  "code": 0,
+  "data": {
+    "list": [...],
+    "total": 100
+  },
+  "msg": "操作成功"
+}
+```
+
+## 📚 字典数据
+
+### 合作状态 (coop_status)
+- 已合作
+- 终止合作
+- 洽谈中
+- 合约过期
+
+### 供应商类型 (type)
+- 备件供应商
+- 保险公司
+- 加氢站
+- 充电站
+- 维修站
+- 救援车队
+- 整车厂
+- 其他
+
+### 区域 (region)
+- 华北
+- 华东
+- 华南
+- 华中
+- 东北
+- 西南
+- 西北
+
+## ✅ 已完成工作
+
+### 1. 数据库设计
+- ✅ 创建 `asset_supplier` 表
+- ✅ 设计合理的索引
+- ✅ 添加菜单和权限配置
+
+### 2. 后端代码
+- ✅ DO (Data Object)
+- ✅ Mapper
+- ✅ VO (View Object)
+- ✅ Convert (对象转换)
+- ✅ Service 接口和实现
+- ✅ Controller
+- ✅ 错误码常量
+
+### 3. 编译验证
+- ✅ Maven 编译通过
+- ✅ 无语法错误
+
+### 4. 数据库初始化
+- ✅ 供应商表创建成功（27 个字段）
+- ✅ 菜单创建成功（ID: 5062）
+- ✅ 5 个按钮权限创建成功
+
+## 🔲 待完成工作
+
+### 1. 导入导出功能
+- 🔲 Excel 导入模板设计
+- 🔲 Excel 导入功能实现
+- 🔲 Excel 导出功能实现
+
+### 2. 数据字典配置
+- 🔲 在系统字典中配置合作状态
+- 🔲 在系统字典中配置供应商类型
+
+### 3. 前端开发
+- 🔲 供应商列表页面
+- 🔲 供应商新增页面
+- 🔲 供应商编辑页面
+- 🔲 供应商查看页面
+
+### 4. 测试
+- 🔲 单元测试
+- 🔲 集成测试
+- 🔲 API 接口测试
+
+## 🎯 使用说明
+
+### 启动服务
+1. 确保数据库已初始化
+2. 启动 `yudao-server` 应用
+3. 访问 Swagger 文档: `http://localhost:48080/doc.html`
+
+### API 测试
+使用 Postman 或 Swagger UI 测试接口：
+1. 先登录获取 token
+2. 在请求头中添加 `Authorization: Bearer {token}`
+3. 调用供应商管理接口
+
+## 📝 注意事项
+
+1. **供应商编码唯一性**: `supplier_code` 字段有唯一索引，不能重复
+2. **手机号格式验证**: 使用正则表达式验证手机号格式
+3. **邮箱格式验证**: 使用 `@Email` 注解验证邮箱格式
+4. **软删除**: 使用 `deleted` 字段实现软删除，不会物理删除数据
+5. **多租户**: 支持多租户隔离，通过 `tenant_id` 字段区分
+
+## 🔗 相关模块
+
+- 客户管理模块 (Customer)
+- 车辆管理模块 (Vehicle)
+- 停车场管理模块 (Parking)
+- 车型参数管理模块 (VehicleModel)
+
+---
+
+**开发日期**: 2026-03-12
+**开发人员**: AI Assistant
+**版本**: v1.0.0
--- a/yudao-module-asset/sql/mysql/supplier.sql
+++ b/yudao-module-asset/sql/mysql/supplier.sql
@@ -0,0 +1,66 @@
+-- 供应商信息表
+CREATE TABLE IF NOT EXISTS `asset_supplier` (
+    `id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '主键ID',
+    `supplier_code` VARCHAR(50) NOT NULL COMMENT '供应商编码',
+    `coop_status` VARCHAR(20) NOT NULL COMMENT '合作状态',
+    `supplier_name` VARCHAR(100) NOT NULL COMMENT '供应商名称',
+    `type` VARCHAR(50) NOT NULL COMMENT '供应商类型',
+    `province` VARCHAR(50) COMMENT '省份',
+    `city` VARCHAR(50) COMMENT '城市',
+    `address` VARCHAR(255) COMMENT '详细地址',
+    `region` VARCHAR(20) COMMENT '区域',
+    `contact` VARCHAR(50) COMMENT '联系人',
+    `contact_mobile` VARCHAR(20) COMMENT '联系手机',
+    `contact_phone` VARCHAR(50) COMMENT '联系电话',
+    `email` VARCHAR(100) COMMENT '邮箱',
+    `credit_code_or_id` VARCHAR(100) COMMENT '统一社会信用代码/身份证号',
+    `remark` VARCHAR(500) COMMENT '备注',
+
+    -- 开票信息
+    `tax_id` VARCHAR(100) COMMENT '税号',
+    `invoice_address` VARCHAR(255) COMMENT '开票地址',
+    `invoice_phone` VARCHAR(50) COMMENT '开票电话',
+    `account` VARCHAR(100) COMMENT '账号',
+    `opening_bank` VARCHAR(200) COMMENT '开户行',
+    `mailing_address` VARCHAR(255) COMMENT '邮寄地址',
+
+    -- 审计字段
+    `creator` VARCHAR(64) DEFAULT '' COMMENT '创建者',
+    `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    `updater` VARCHAR(64) DEFAULT '' COMMENT '更新者',
+    `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    `deleted` BIT(1) NOT NULL DEFAULT b'0' COMMENT '是否删除',
+    `tenant_id` BIGINT NOT NULL DEFAULT 0 COMMENT '租户编号',
+
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uk_supplier_code` (`supplier_code`, `deleted`),
+    INDEX `idx_supplier_name` (`supplier_name`),
+    INDEX `idx_coop_status` (`coop_status`),
+    INDEX `idx_type` (`type`),
+    INDEX `idx_region` (`region`),
+    INDEX `idx_city` (`city`),
+    INDEX `idx_create_time` (`create_time`),
+    INDEX `idx_tenant_id` (`tenant_id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='供应商信息表';
+
+-- 菜单 SQL
+INSERT INTO system_menu(
+    name, permission, type, sort, parent_id,
+    path, icon, component, status, component_name
+)
+VALUES (
+    '供应商管理', '', 2, 4, 5055,
+    'supplier', 'user', 'asset/supplier/index', 0, 'Supplier'
+);
+
+-- 获取刚插入的菜单ID
+SET @menuId = LAST_INSERT_ID();
+
+-- 供应商管理按钮权限
+INSERT INTO system_menu(name, permission, type, sort, parent_id, path, icon, component, status)
+VALUES
+    ('供应商查询', 'asset:supplier:query', 3, 1, @menuId, '', '', '', 0),
+    ('供应商创建', 'asset:supplier:create', 3, 2, @menuId, '', '', '', 0),
+    ('供应商更新', 'asset:supplier:update', 3, 3, @menuId, '', '', '', 0),
+    ('供应商删除', 'asset:supplier:delete', 3, 4, @menuId, '', '', '', 0),
+    ('供应商导出', 'asset:supplier:export', 3, 5, @menuId, '', '', '', 0);
--- a/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/controller/admin/supplier/SupplierController.java
+++ b/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/controller/admin/supplier/SupplierController.java
@@ -0,0 +1,78 @@
+package cn.iocoder.yudao.module.asset.controller.admin.supplier;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.asset.controller.admin.supplier.vo.SupplierPageReqVO;
+import cn.iocoder.yudao.module.asset.controller.admin.supplier.vo.SupplierRespVO;
+import cn.iocoder.yudao.module.asset.controller.admin.supplier.vo.SupplierSaveReqVO;
+import cn.iocoder.yudao.module.asset.convert.supplier.SupplierConvert;
+import cn.iocoder.yudao.module.asset.dal.dataobject.supplier.SupplierDO;
+import cn.iocoder.yudao.module.asset.service.supplier.SupplierService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+/**
+ * 供应商信息 Controller
+ *
+ * @author 芋道源码
+ */
+@Tag(name = "管理后台 - 供应商信息")
+@RestController
+@RequestMapping("/asset/supplier")
+@Validated
+public class SupplierController {
+
+    @Resource
+    private SupplierService supplierService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建供应商")
+    @PreAuthorize("@ss.hasPermission('asset:supplier:create')")
+    public CommonResult<Long> createSupplier(@Valid @RequestBody SupplierSaveReqVO createReqVO) {
+        return success(supplierService.createSupplier(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新供应商")
+    @PreAuthorize("@ss.hasPermission('asset:supplier:update')")
+    public CommonResult<Boolean> updateSupplier(@Valid @RequestBody SupplierSaveReqVO updateReqVO) {
+        supplierService.updateSupplier(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除供应商")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('asset:supplier:delete')")
+    public CommonResult<Boolean> deleteSupplier(@RequestParam("id") Long id) {
+        supplierService.deleteSupplier(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得供应商")
+    @Parameter(name = "id", description = "编号", required = true, example = "1")
+    @PreAuthorize("@ss.hasPermission('asset:supplier:query')")
+    public CommonResult<SupplierRespVO> getSupplier(@RequestParam("id") Long id) {
+        SupplierDO supplier = supplierService.getSupplier(id);
+        return success(SupplierConvert.INSTANCE.convert(supplier));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得供应商分页")
+    @PreAuthorize("@ss.hasPermission('asset:supplier:query')")
+    public CommonResult<PageResult<SupplierRespVO>> getSupplierPage(@Valid SupplierPageReqVO pageReqVO) {
+        PageResult<SupplierDO> pageResult = supplierService.getSupplierPage(pageReqVO);
+        return success(SupplierConvert.INSTANCE.convertPage(pageResult));
+    }
+
+}
--- a/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/controller/admin/supplier/vo/SupplierBaseVO.java
+++ b/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/controller/admin/supplier/vo/SupplierBaseVO.java
@@ -0,0 +1,84 @@
+package cn.iocoder.yudao.module.asset.controller.admin.supplier.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.Pattern;
+
+/**
+ * 供应商信息 Base VO
+ *
+ * @author 芋道源码
+ */
+@Data
+public class SupplierBaseVO {
+
+    @Schema(description = "供应商编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "GYS-2025-001")
+    @NotBlank(message = "供应商编码不能为空")
+    private String supplierCode;
+
+    @Schema(description = "合作状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "已合作")
+    @NotBlank(message = "合作状态不能为空")
+    private String coopStatus;
+
+    @Schema(description = "供应商名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "嘉兴某某加氢站")
+    @NotBlank(message = "供应商名称不能为空")
+    private String supplierName;
+
+    @Schema(description = "供应商类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "加氢站")
+    @NotBlank(message = "供应商类型不能为空")
+    private String type;
+
+    @Schema(description = "省份", example = "浙江省")
+    private String province;
+
+    @Schema(description = "城市", example = "嘉兴市")
+    private String city;
+
+    @Schema(description = "详细地址", example = "浙江省嘉兴市南湖区科技大道1号")
+    private String address;
+
+    @Schema(description = "区域", example = "华东")
+    private String region;
+
+    @Schema(description = "联系人", example = "张三")
+    private String contact;
+
+    @Schema(description = "联系手机", example = "13800138001")
+    @Pattern(regexp = "^1[3-9]\\d{9}$", message = "手机号格式不正确")
+    private String contactMobile;
+
+    @Schema(description = "联系电话", example = "0571-88888888")
+    private String contactPhone;
+
+    @Schema(description = "邮箱", example = "zhangsan@example.com")
+    @Email(message = "邮箱格式不正确")
+    private String email;
+
+    @Schema(description = "统一社会信用代码/身份证号", example = "91330400MA2XXXXX1")
+    private String creditCodeOrId;
+
+    @Schema(description = "备注", example = "")
+    private String remark;
+
+    @Schema(description = "税号", example = "91330400MA2XXXXX1")
+    private String taxId;
+
+    @Schema(description = "开票地址", example = "浙江省嘉兴市南湖区科技大道1号")
+    private String invoiceAddress;
+
+    @Schema(description = "开票电话", example = "0571-88888888")
+    private String invoicePhone;
+
+    @Schema(description = "账号", example = "6222021234567890123")
+    private String account;
+
+    @Schema(description = "开户行", example = "中国工商银行嘉兴分行")
+    private String openingBank;
+
+    @Schema(description = "邮寄地址", example = "浙江省嘉兴市南湖区科技大道1号")
+    private String mailingAddress;
+
+}
--- a/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/controller/admin/supplier/vo/SupplierPageReqVO.java
+++ b/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/controller/admin/supplier/vo/SupplierPageReqVO.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.asset.controller.admin.supplier.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.util.List;
+
+/**
+ * 供应商信息 - 分页查询 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - 供应商信息分页查询 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class SupplierPageReqVO extends PageParam {
+
+    @Schema(description = "供应商编码", example = "GYS-2025-001")
+    private String supplierCode;
+
+    @Schema(description = "合作状态列表", example = "[\"已合作\", \"洽谈中\"]")
+    private List<String> coopStatus;
+
+    @Schema(description = "供应商名称（模糊查询）", example = "加氢站")
+    private String supplierName;
+
+    @Schema(description = "供应商类型列表", example = "[\"加氢站\", \"充电站\"]")
+    private List<String> type;
+
+    @Schema(description = "区域列表", example = "[\"华东\", \"华南\"]")
+    private List<String> region;
+
+    @Schema(description = "城市", example = "嘉兴市")
+    private String city;
+
+    @Schema(description = "创建者", example = "admin")
+    private String creator;
+
+}
--- a/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/controller/admin/supplier/vo/SupplierRespVO.java
+++ b/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/controller/admin/supplier/vo/SupplierRespVO.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.asset.controller.admin.supplier.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * 供应商信息 - 响应 VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - 供应商信息 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class SupplierRespVO extends SupplierBaseVO {
+
+    @Schema(description = "主键ID", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long id;
+
+    @Schema(description = "创建者", example = "admin")
+    private String creator;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+    @Schema(description = "更新者", example = "admin")
+    private String updater;
+
+    @Schema(description = "更新时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime updateTime;
+
+}
--- a/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/controller/admin/supplier/vo/SupplierSaveReqVO.java
+++ b/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/controller/admin/supplier/vo/SupplierSaveReqVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.asset.controller.admin.supplier.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+/**
+ * 供应商信息 - 创建/更新 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - 供应商信息创建/更新 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class SupplierSaveReqVO extends SupplierBaseVO {
+
+    @Schema(description = "主键ID", example = "1")
+    private Long id;
+
+}
--- a/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/convert/supplier/SupplierConvert.java
+++ b/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/convert/supplier/SupplierConvert.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.asset.convert.supplier;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.asset.controller.admin.supplier.vo.SupplierRespVO;
+import cn.iocoder.yudao.module.asset.controller.admin.supplier.vo.SupplierSaveReqVO;
+import cn.iocoder.yudao.module.asset.dal.dataobject.supplier.SupplierDO;
+import org.mapstruct.Mapper;
+import org.mapstruct.factory.Mappers;
+
+/**
+ * 供应商信息 Convert
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface SupplierConvert {
+
+    SupplierConvert INSTANCE = Mappers.getMapper(SupplierConvert.class);
+
+    SupplierDO convert(SupplierSaveReqVO bean);
+
+    SupplierRespVO convert(SupplierDO bean);
+
+    PageResult<SupplierRespVO> convertPage(PageResult<SupplierDO> page);
+
+}
--- a/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/dal/dataobject/supplier/SupplierDO.java
+++ b/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/dal/dataobject/supplier/SupplierDO.java
@@ -0,0 +1,130 @@
+package cn.iocoder.yudao.module.asset.dal.dataobject.supplier;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.*;
+
+/**
+ * 供应商信息 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("asset_supplier")
+@KeySequence("asset_supplier_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class SupplierDO extends BaseDO {
+
+    /**
+     * 主键ID
+     */
+    @TableId
+    private Long id;
+
+    /**
+     * 供应商编码
+     */
+    private String supplierCode;
+
+    /**
+     * 合作状态
+     */
+    private String coopStatus;
+
+    /**
+     * 供应商名称
+     */
+    private String supplierName;
+
+    /**
+     * 供应商类型
+     */
+    private String type;
+
+    /**
+     * 省份
+     */
+    private String province;
+
+    /**
+     * 城市
+     */
+    private String city;
+
+    /**
+     * 详细地址
+     */
+    private String address;
+
+    /**
+     * 区域
+     */
+    private String region;
+
+    /**
+     * 联系人
+     */
+    private String contact;
+
+    /**
+     * 联系手机
+     */
+    private String contactMobile;
+
+    /**
+     * 联系电话
+     */
+    private String contactPhone;
+
+    /**
+     * 邮箱
+     */
+    private String email;
+
+    /**
+     * 统一社会信用代码/身份证号
+     */
+    private String creditCodeOrId;
+
+    /**
+     * 备注
+     */
+    private String remark;
+
+    /**
+     * 税号
+     */
+    private String taxId;
+
+    /**
+     * 开票地址
+     */
+    private String invoiceAddress;
+
+    /**
+     * 开票电话
+     */
+    private String invoicePhone;
+
+    /**
+     * 账号
+     */
+    private String account;
+
+    /**
+     * 开户行
+     */
+    private String openingBank;
+
+    /**
+     * 邮寄地址
+     */
+    private String mailingAddress;
+
+}
--- a/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/dal/mysql/supplier/SupplierMapper.java
+++ b/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/dal/mysql/supplier/SupplierMapper.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.asset.dal.mysql.supplier;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.asset.controller.admin.supplier.vo.SupplierPageReqVO;
+import cn.iocoder.yudao.module.asset.dal.dataobject.supplier.SupplierDO;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * 供应商信息 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface SupplierMapper extends BaseMapperX<SupplierDO> {
+
+    default PageResult<SupplierDO> selectPage(SupplierPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<SupplierDO>()
+                .eqIfPresent(SupplierDO::getSupplierCode, reqVO.getSupplierCode())
+                .inIfPresent(SupplierDO::getCoopStatus, reqVO.getCoopStatus())
+                .likeIfPresent(SupplierDO::getSupplierName, reqVO.getSupplierName())
+                .inIfPresent(SupplierDO::getType, reqVO.getType())
+                .inIfPresent(SupplierDO::getRegion, reqVO.getRegion())
+                .eqIfPresent(SupplierDO::getCity, reqVO.getCity())
+                .eqIfPresent(SupplierDO::getCreator, reqVO.getCreator())
+                .orderByDesc(SupplierDO::getId));
+    }
+
+}
--- a/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/enums/ErrorCodeConstants.java
+++ b/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/enums/ErrorCodeConstants.java
@@ -20,4 +20,7 @@ public interface ErrorCodeConstants {
    // ========== 客户管理 1-008-003-000 ==========
    ErrorCode CUSTOMER_NOT_EXISTS = new ErrorCode(1_008_003_000, "客户不存在");

+    // ========== 供应商管理 1-008-004-000 ==========
+    ErrorCode SUPPLIER_NOT_EXISTS = new ErrorCode(1_008_004_000, "供应商不存在");
+
 }
--- a/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/service/supplier/SupplierService.java
+++ b/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/service/supplier/SupplierService.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.asset.service.supplier;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.asset.controller.admin.supplier.vo.SupplierPageReqVO;
+import cn.iocoder.yudao.module.asset.controller.admin.supplier.vo.SupplierSaveReqVO;
+import cn.iocoder.yudao.module.asset.dal.dataobject.supplier.SupplierDO;
+
+import jakarta.validation.Valid;
+
+/**
+ * 供应商信息 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface SupplierService {
+
+    /**
+     * 创建供应商
+     *
+     * @param createReqVO 创建信息
+     * @return 编号
+     */
+    Long createSupplier(@Valid SupplierSaveReqVO createReqVO);
+
+    /**
+     * 更新供应商
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateSupplier(@Valid SupplierSaveReqVO updateReqVO);
+
+    /**
+     * 删除供应商
+     *
+     * @param id 编号
+     */
+    void deleteSupplier(Long id);
+
+    /**
+     * 获得供应商
+     *
+     * @param id 编号
+     * @return 供应商
+     */
+    SupplierDO getSupplier(Long id);
+
+    /**
+     * 获得供应商分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 供应商分页
+     */
+    PageResult<SupplierDO> getSupplierPage(SupplierPageReqVO pageReqVO);
+
+}
--- a/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/service/supplier/SupplierServiceImpl.java
+++ b/yudao-module-asset/yudao-module-asset-server/src/main/java/cn/iocoder/yudao/module/asset/service/supplier/SupplierServiceImpl.java
@@ -0,0 +1,83 @@
+package cn.iocoder.yudao.module.asset.service.supplier;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.asset.controller.admin.supplier.vo.SupplierPageReqVO;
+import cn.iocoder.yudao.module.asset.controller.admin.supplier.vo.SupplierSaveReqVO;
+import cn.iocoder.yudao.module.asset.convert.supplier.SupplierConvert;
+import cn.iocoder.yudao.module.asset.dal.dataobject.supplier.SupplierDO;
+import cn.iocoder.yudao.module.asset.dal.mysql.supplier.SupplierMapper;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import jakarta.annotation.Resource;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.asset.enums.ErrorCodeConstants.SUPPLIER_NOT_EXISTS;
+
+/**
+ * 供应商信息 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+@Slf4j
+public class SupplierServiceImpl implements SupplierService {
+
+    @Resource
+    private SupplierMapper supplierMapper;
+
+    @Override
+    public Long createSupplier(SupplierSaveReqVO createReqVO) {
+        // 插入
+        SupplierDO supplier = SupplierConvert.INSTANCE.convert(createReqVO);
+        supplierMapper.insert(supplier);
+
+        log.info("[createSupplier][创建供应商成功，ID：{}，供应商编码：{}，供应商名称：{}]",
+                supplier.getId(), supplier.getSupplierCode(), supplier.getSupplierName());
+
+        return supplier.getId();
+    }
+
+    @Override
+    public void updateSupplier(SupplierSaveReqVO updateReqVO) {
+        // 校验存在
+        validateSupplierExists(updateReqVO.getId());
+
+        // 更新
+        SupplierDO updateObj = SupplierConvert.INSTANCE.convert(updateReqVO);
+        supplierMapper.updateById(updateObj);
+
+        log.info("[updateSupplier][更新供应商成功，ID：{}，供应商编码：{}，供应商名称：{}]",
+                updateObj.getId(), updateObj.getSupplierCode(), updateObj.getSupplierName());
+    }
+
+    @Override
+    public void deleteSupplier(Long id) {
+        // 校验存在
+        validateSupplierExists(id);
+
+        // 删除
+        supplierMapper.deleteById(id);
+
+        log.info("[deleteSupplier][删除供应商成功，ID：{}]", id);
+    }
+
+    private void validateSupplierExists(Long id) {
+        if (supplierMapper.selectById(id) == null) {
+            throw exception(SUPPLIER_NOT_EXISTS);
+        }
+    }
+
+    @Override
+    public SupplierDO getSupplier(Long id) {
+        return supplierMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<SupplierDO> getSupplierPage(SupplierPageReqVO pageReqVO) {
+        return supplierMapper.selectPage(pageReqVO);
+    }
+
+}