55 lines
2.2 KiB
C#
55 lines
2.2 KiB
C#
using Model;
|
||
using Model.Dto.System;
|
||
using SqlSugar;
|
||
using System.Collections.Generic;
|
||
using System.Threading.Tasks;
|
||
|
||
namespace Service.Interface
|
||
{
|
||
/// <summary>
|
||
/// 数据字典管理 服务接口
|
||
/// 约定：字典分类（DictType） + 字典项（DictItem） 二层结构，不支持级联
|
||
/// </summary>
|
||
public interface IDictService
|
||
{
|
||
// ==================== 字典分类 ====================
|
||
|
||
/// <summary>分页查询字典分类（关键字匹配 Code/Name）</summary>
|
||
Task<Result<List<DictTypeDto>>> GetTypesPagedAsync(int pageIndex, int pageSize, RefAsync<int> total, string? keyword = null);
|
||
|
||
/// <summary>全部启用的字典分类（下拉用，不缓存）</summary>
|
||
Task<Result<List<DictTypeDto>>> GetTypesAllAsync();
|
||
|
||
/// <summary>字典分类详情</summary>
|
||
Task<Result<DictTypeDto>> GetTypeByIdAsync(long id);
|
||
|
||
/// <summary>新增字典分类（校验编码唯一）</summary>
|
||
Task<Result<DictTypeDto>> AddTypeAsync(DictTypeDto dto);
|
||
|
||
/// <summary>修改字典分类</summary>
|
||
Task<Result<DictTypeDto>> UpdateTypeAsync(DictTypeDto dto);
|
||
|
||
/// <summary>删除字典分类（分类下有字典项时禁止删除）</summary>
|
||
Task<Result> DeleteTypeAsync(long id);
|
||
|
||
// ==================== 字典项 ====================
|
||
|
||
/// <summary>查询指定分类下的字典项（按 Sort、CreateTime 倒序）</summary>
|
||
Task<Result<List<DictItemDto>>> GetItemsByTypeAsync(long typeId);
|
||
|
||
/// <summary>新增字典项（校验同分类下编码唯一；IsDefault=1 时清零其它默认项）</summary>
|
||
Task<Result<DictItemDto>> AddItemAsync(DictItemDto dto);
|
||
|
||
/// <summary>修改字典项</summary>
|
||
Task<Result<DictItemDto>> UpdateItemAsync(DictItemDto dto);
|
||
|
||
/// <summary>删除字典项</summary>
|
||
Task<Result> DeleteItemAsync(long id);
|
||
|
||
// ==================== 业务侧（无权限，供其它模块调用） ====================
|
||
|
||
/// <summary>按字典编码查询启用项（带 IMemoryCache 缓存，增删改时失效）</summary>
|
||
Task<Result<List<DictOptionDto>>> GetOptionsByCodeAsync(string typeCode);
|
||
}
|
||
}
|