yuanlin/Evergreen-Health
1
0
Fork 0
Code Pull Requests Actions Releases Activity

feat: initialize Evergreen Health backend

Browse Source
This commit is contained in:
fuenmao
2026-09-21 14:08:22 +08:00
commit 8553df5dd2
493 changed files with 75649 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Admin.NET.Core/Service/LangText/Dto/SysLangTextDto.cs
+73
View File
@@ -0,0 +1,73 @@
// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
//
// 本项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
//
// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动！任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任！
namespace Admin.NET.Core;
/// <summary>
/// 翻译表输出参数
/// </summary>
public class SysLangTextDto
{
/// <summary>
/// 主键Id
/// </summary>
public long Id { get; set; }
/// <summary>
/// 所属实体名
/// </summary>
public string EntityName { get; set; }
/// <summary>
/// 所属实体ID
/// </summary>
public long EntityId { get; set; }
/// <summary>
/// 字段名
/// </summary>
public string FieldName { get; set; }
/// <summary>
/// 语言代码
/// </summary>
public string LangCode { get; set; }
/// <summary>
/// 翻译内容
/// </summary>
public string Content { get; set; }
/// <summary>
/// 创建时间
/// </summary>
public DateTime? CreateTime { get; set; }
/// <summary>
/// 更新时间
/// </summary>
public DateTime? UpdateTime { get; set; }
/// <summary>
/// 创建者Id
/// </summary>
public long? CreateUserId { get; set; }
/// <summary>
/// 创建者姓名
/// </summary>
public string? CreateUserName { get; set; }
/// <summary>
/// 修改者Id
/// </summary>
public long? UpdateUserId { get; set; }
/// <summary>
/// 修改者姓名
/// </summary>
public string? UpdateUserName { get; set; }
}
Admin.NET.Core/Service/LangText/Dto/SysLangTextInput.cs
+274
View File
@@ -0,0 +1,274 @@
// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
//
// 本项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
//
// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动！任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任！
namespace Admin.NET.Core;
/// <summary>
/// 翻译表基础输入参数
/// </summary>
public class SysLangTextBaseInput
{
/// <summary>
/// 主键Id
/// </summary>
public virtual long? Id { get; set; }
/// <summary>
/// 所属实体名
/// </summary>
[Required(ErrorMessage = "所属实体名不能为空")]
public virtual string EntityName { get; set; }
/// <summary>
/// 所属实体ID
/// </summary>
[Required(ErrorMessage = "所属实体ID不能为空")]
public virtual long? EntityId { get; set; }
/// <summary>
/// 字段名
/// </summary>
[Required(ErrorMessage = "字段名不能为空")]
public virtual string FieldName { get; set; }
/// <summary>
/// 语言代码
/// </summary>
[Required(ErrorMessage = "语言代码不能为空")]
public virtual string LangCode { get; set; }
/// <summary>
/// 翻译内容
/// </summary>
[Required(ErrorMessage = "翻译内容不能为空")]
public virtual string Content { get; set; }
}
/// <summary>
/// 翻译表分页查询输入参数
/// </summary>
public class PageSysLangTextInput : BasePageInput
{
/// <summary>
/// 所属实体名
/// </summary>
public string EntityName { get; set; }
/// <summary>
/// 所属实体ID
/// </summary>
public long? EntityId { get; set; }
/// <summary>
/// 字段名
/// </summary>
public string FieldName { get; set; }
/// <summary>
/// 语言代码
/// </summary>
public string LangCode { get; set; }
/// <summary>
/// 翻译内容
/// </summary>
public string Content { get; set; }
/// <summary>
/// 选中主键列表
/// </summary>
public List<long> SelectKeyList { get; set; }
}
/// <summary>
/// 翻译表增加输入参数
/// </summary>
public class AddSysLangTextInput
{
/// <summary>
/// 所属实体名
/// </summary>
[Required(ErrorMessage = "所属实体名不能为空")]
[MaxLength(255, ErrorMessage = "所属实体名字符长度不能超过255")]
public string EntityName { get; set; }
/// <summary>
/// 所属实体ID
/// </summary>
[Required(ErrorMessage = "所属实体ID不能为空")]
public long? EntityId { get; set; }
/// <summary>
/// 字段名
/// </summary>
[Required(ErrorMessage = "字段名不能为空")]
[MaxLength(255, ErrorMessage = "字段名字符长度不能超过255")]
public string FieldName { get; set; }
/// <summary>
/// 语言代码
/// </summary>
[Required(ErrorMessage = "语言代码不能为空")]
[MaxLength(255, ErrorMessage = "语言代码字符长度不能超过255")]
public string LangCode { get; set; }
/// <summary>
/// 翻译内容
/// </summary>
[Required(ErrorMessage = "翻译内容不能为空")]
public string Content { get; set; }
}
/// <summary>
/// 翻译表输入参数
/// </summary>
public class ListSysLangTextInput
{
/// <summary>
/// 所属实体名
/// </summary>
[Required(ErrorMessage = "所属实体名不能为空")]
public string EntityName { get; set; }
/// <summary>
/// 所属实体ID
/// </summary>
[Required(ErrorMessage = "所属实体ID不能为空")]
public long? EntityId { get; set; }
/// <summary>
/// 字段名
/// </summary>
[Required(ErrorMessage = "字段名不能为空")]
public string FieldName { get; set; }
/// <summary>
/// 语言代码
/// </summary>
public string LangCode { get; set; }
}
/// <summary>
/// 翻译表删除输入参数
/// </summary>
public class DeleteSysLangTextInput
{
/// <summary>
/// 主键Id
/// </summary>
[Required(ErrorMessage = "主键Id不能为空")]
public long? Id { get; set; }
}
/// <summary>
/// 翻译表更新输入参数
/// </summary>
public class UpdateSysLangTextInput
{
/// <summary>
/// 主键Id
/// </summary>
[Required(ErrorMessage = "主键Id不能为空")]
public long? Id { get; set; }
/// <summary>
/// 所属实体名
/// </summary>
[Required(ErrorMessage = "所属实体名不能为空")]
[MaxLength(255, ErrorMessage = "所属实体名字符长度不能超过255")]
public string EntityName { get; set; }
/// <summary>
/// 所属实体ID
/// </summary>
[Required(ErrorMessage = "所属实体ID不能为空")]
public long? EntityId { get; set; }
/// <summary>
/// 字段名
/// </summary>
[Required(ErrorMessage = "字段名不能为空")]
[MaxLength(255, ErrorMessage = "字段名字符长度不能超过255")]
public string FieldName { get; set; }
/// <summary>
/// 语言代码
/// </summary>
[Required(ErrorMessage = "语言代码不能为空")]
[MaxLength(255, ErrorMessage = "语言代码字符长度不能超过255")]
public string LangCode { get; set; }
/// <summary>
/// 翻译内容
/// </summary>
[Required(ErrorMessage = "翻译内容不能为空")]
public string Content { get; set; }
}
/// <summary>
/// 翻译表主键查询输入参数
/// </summary>
public class QueryByIdSysLangTextInput : DeleteSysLangTextInput
{
}
/// <summary>
/// 翻译表数据导入实体
/// </summary>
[ExcelImporter(SheetIndex = 1, IsOnlyErrorRows = true)]
public class ImportSysLangTextInput : BaseImportInput
{
/// <summary>
/// 所属实体名
/// </summary>
[ImporterHeader(Name = "*所属实体名")]
[ExporterHeader("*所属实体名", Format = "", Width = 25, IsBold = true)]
public string EntityName { get; set; }
/// <summary>
/// 所属实体ID
/// </summary>
[ImporterHeader(Name = "*所属实体ID")]
[ExporterHeader("*所属实体ID", Format = "", Width = 25, IsBold = true)]
public long? EntityId { get; set; }
/// <summary>
/// 字段名
/// </summary>
[ImporterHeader(Name = "*字段名")]
[ExporterHeader("*字段名", Format = "", Width = 25, IsBold = true)]
public string FieldName { get; set; }
/// <summary>
/// 语言代码
/// </summary>
[ImporterHeader(Name = "*语言代码")]
[ExporterHeader("*语言代码", Format = "", Width = 25, IsBold = true)]
public string LangCode { get; set; }
/// <summary>
/// 翻译内容
/// </summary>
[ImporterHeader(Name = "*翻译内容")]
[ExporterHeader("*翻译内容", Format = "", Width = 25, IsBold = true)]
public string Content { get; set; }
}
/// <summary>
///
/// </summary>
public class AiTranslateTextInput
{
/// <summary>
/// 原文
/// </summary>
public string OriginalText { get; set; }
/// <summary>
/// 目标语言
/// </summary>
public string TargetLang { get; set; }
}
Admin.NET.Core/Service/LangText/Dto/SysLangTextOutput.cs
+82
View File
@@ -0,0 +1,82 @@
// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
//
// 本项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
//
// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动！任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任！
namespace Admin.NET.Core;
/// <summary>
/// 翻译表输出参数
/// </summary>
public class SysLangTextOutput
{
/// <summary>
/// 主键Id
/// </summary>
public long Id { get; set; }
/// <summary>
/// 所属实体名
/// </summary>
public string EntityName { get; set; }
/// <summary>
/// 所属实体ID
/// </summary>
public long EntityId { get; set; }
/// <summary>
/// 字段名
/// </summary>
public string FieldName { get; set; }
/// <summary>
/// 语言代码
/// </summary>
public string LangCode { get; set; }
/// <summary>
/// 翻译内容
/// </summary>
public string Content { get; set; }
/// <summary>
/// 创建时间
/// </summary>
public DateTime? CreateTime { get; set; }
/// <summary>
/// 更新时间
/// </summary>
public DateTime? UpdateTime { get; set; }
/// <summary>
/// 创建者Id
/// </summary>
public long? CreateUserId { get; set; }
/// <summary>
/// 创建者姓名
/// </summary>
public string? CreateUserName { get; set; }
/// <summary>
/// 修改者Id
/// </summary>
public long? UpdateUserId { get; set; }
/// <summary>
/// 修改者姓名
/// </summary>
public string? UpdateUserName { get; set; }
}
/// <summary>
/// 翻译表数据导入模板实体
/// </summary>
public class ExportSysLangTextOutput : ImportSysLangTextInput
{
[ImporterHeader(IsIgnore = true)]
[ExporterHeader(IsIgnore = true)]
public override string Error { get; set; }
}
Admin.NET.Core/Service/LangText/SysLangTextCacheService.cs
+343
View File
@@ -0,0 +1,343 @@
// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
//
// 本项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
//
// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动！任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任！
namespace Admin.NET.Core.Service;
public class LangFieldMap<TEntity>
{
/// <summary>实体名，如 Product</summary>
public string EntityName { get; set; }
/// <summary>字段名，如 Name/Description</summary>
public string FieldName { get; set; }
/// <summary>如何取主键ID</summary>
public Func<TEntity, long> IdSelector { get; set; }
/// <summary>如何写回翻译值</summary>
public Action<TEntity, string> SetTranslatedValue { get; set; }
}
/// <summary>
/// 翻译缓存服务 🧩
/// </summary>
[ApiDescriptionSettings(Order = 100, Description = "翻译缓存服务")]
public class SysLangTextCacheService : IDynamicApiController, ITransient
{
private readonly SysCacheService _sysCacheService;
private readonly SqlSugarRepository<SysLangText> _sysLangTextRep;
private TimeSpan expireSeconds = TimeSpan.FromHours(1);
public SysLangTextCacheService(
SysCacheService sysCacheService,
SqlSugarRepository<SysLangText> sysLangTextRep)
{
_sysCacheService = sysCacheService;
_sysLangTextRep = sysLangTextRep;
}
private string BuildKey(string entityName, string fieldName, long entityId, string langCode)
{
return $"LangCache_{entityName}_{fieldName}_{entityId}_{langCode}";
}
/// <summary>
/// 【单条翻译获取】
/// 根据实体类型、字段、主键ID 和语言编码获取翻译内容。<br/>
/// 适用于：小表（如菜单、字典），可设置较长缓存时间。<br/>
/// <br/>
/// 【示例】<br/>
/// var content = await _sysLangTextCacheService.GetTranslation("Product", "Name", 123, "en-US");
/// </summary>
/// <param name="entityName">实体名称，如 "Product"</param>
/// <param name="fieldName">字段名称，如 "Name"</param>
/// <param name="entityId">实体主键ID</param>
/// <param name="langCode">语言编码，如 "zh-CN"</param>
/// <returns>翻译后的内容（若无则返回 null 或空）</returns>
[NonAction]
public async Task<string> GetTranslation(string entityName, string fieldName, long entityId, string langCode)
{
var key = BuildKey(entityName, fieldName, entityId, langCode);
var value = _sysCacheService.Get<string>(key);
if (!string.IsNullOrEmpty(value)) return value;
value = await _sysLangTextRep.AsQueryable()
.Where(u => u.EntityName == entityName && u.FieldName == fieldName && u.EntityId == entityId && u.LangCode == langCode)
.Select(u => u.Content)
.FirstAsync();
if (!string.IsNullOrEmpty(value))
{
_sysCacheService.Set(key, value, expireSeconds); // 设置过期
}
return value;
}
/// <summary>
/// 根据实体类型、字段、主键ID 和语言编码获取翻译实体
/// </summary>
/// <param name="entityName">实体名称</param>
/// <param name="fieldName">字段名称</param>
/// <param name="entityId">实体主键ID</param>
/// <param name="langCode">语言编码</param>
/// <returns></returns>
[NonAction]
public async Task<SysLangText> GetTranslationEntity(string entityName, string fieldName, long entityId, string langCode)
{
var key = BuildKey(entityName, fieldName, entityId, langCode) + "_entity";
var value = _sysCacheService.Get<SysLangText>(key);
if (!value.IsNullOrEmpty()) return value;
value = await _sysLangTextRep.AsQueryable()
.Where(u => u.EntityName == entityName && u.FieldName == fieldName && u.EntityId == entityId && u.LangCode == langCode)
.FirstAsync();
if (!value.IsNullOrEmpty())
{
_sysCacheService.Set(key, value, expireSeconds); // 设置过期
}
return value;
}
/// <summary>
/// 【批量翻译获取】<br/>
/// 根据实体、字段和一批主键ID获取对应翻译内容，自动从缓存或数据库获取。<br/>
/// 适用于：SKU、多商品、批量字典等需要高效批量获取的场景。<br/>
///
/// 【示例】<br/>
/// var dict = await _sysLangTextCacheService.GetTranslations("SKU", "Name", skuIds, "en_US");
/// </summary>
/// <param name="entityName">实体名称</param>
/// <param name="fieldName">字段名称</param>
/// <param name="entityIds">主键ID集合</param>
/// <param name="langCode">语言编码</param>
/// <returns>主键ID到翻译内容的字典</returns>
[NonAction]
public async Task<Dictionary<long, string>> GetTranslations(string entityName, string fieldName, List<long> entityIds, string langCode)
{
var result = new Dictionary<long, string>();
var missingIds = new HashSet<long>(); // 用 HashSet 提高后面 Contains 的性能
foreach (var id in entityIds.Distinct()) // 先去重，防止重复缓存 Key
{
var key = BuildKey(entityName, fieldName, id, langCode);
var value = _sysCacheService.Get<string>(key);
if (!string.IsNullOrWhiteSpace(value))
{
result[id] = value;
}
else
{
missingIds.Add(id);
}
}
if (missingIds.Any())
{
var list = await _sysLangTextRep.AsQueryable()
.Where(u => u.EntityName == entityName &&
u.FieldName == fieldName &&
missingIds.Contains(u.EntityId) &&
u.LangCode == langCode)
.ToListAsync();
foreach (var item in list)
{
if (string.IsNullOrWhiteSpace(item.Content)) continue; // 跳过脏数据
var key = BuildKey(item.EntityName, item.FieldName, item.EntityId, item.LangCode);
_sysCacheService.Set(key, item.Content, expireSeconds);
// 用 TryAdd 防止异常
result[item.EntityId] = item.Content;
}
}
return result;
}
/// <summary>
/// 【列表翻译】<br/>
/// 按配置把同一字段的翻译写回到实体列表中。内部会调用批量翻译接口。<br/>
/// <br/>
/// 【示例】<br/>
/// await _sysLangTextCacheService.TranslateList(products, "Product", "Name", p =&gt; p.Id, (p, val) =&gt; p.Name = val, "zh-CN");
/// </summary>
/// <typeparam name="TEntity">实体类型</typeparam>
/// <param name="list">待翻译的实体列表</param>
/// <param name="entityName">实体名称</param>
/// <param name="fieldName">字段名称</param>
/// <param name="idSelector">用于取出主键ID的表达式</param>
/// <param name="setTranslatedValue">写回翻译值的委托</param>
/// <param name="langCode">语言编码</param>
/// <returns>翻译后的实体列表（引用传递）</returns>
[NonAction]
public async Task<List<TEntity>> TranslateList<TEntity>(List<TEntity> list, string entityName, string fieldName, Func<TEntity, long> idSelector, Action<TEntity, string> setTranslatedValue, string langCode)
{
var ids = list.Select(idSelector).Distinct().ToList();
var dict = await GetTranslations(entityName, fieldName, ids, langCode);
foreach (var item in list)
{
var id = idSelector(item);
if (dict.TryGetValue(id, out var value))
{
setTranslatedValue(item, value);
}
}
return list;
}
/// <summary>
/// 【多字段批量翻译】
/// 对列表中的实体对象，按配置的字段映射进行多字段翻译处理。<br/>
/// 常用于：菜单多语言、商品多语言、SKU多语言等需要多字段翻译的场景。<br/><br/>
/// ✅ 特点：<br/>
/// 1️⃣ 可同时翻译同一实体的多个字段（如 Name、Description、Title 等）<br/>
/// 2️⃣ 内部先尝试从缓存读取，如缓存未命中则批量查询数据库，并自动写回缓存<br/>
/// 3️⃣ 引用传递，直接对原实体对象赋值，无需额外返回<br/><br/>
/// 【使用示例】：<br/>
/// <code>
/// var fields = new List&lt;LangFieldMap&lt;Product&gt;&gt;
/// {
/// new LangFieldMap&lt;Product&gt; {
/// EntityName = "Product",
/// FieldName = "Name",
/// IdSelector = p =&gt; p.Id,
/// SetTranslatedValue = (p, val) =&gt; p.Name = val
/// },
/// new LangFieldMap&lt;Product&gt; {
/// EntityName = "Product",
/// FieldName = "Description",
/// IdSelector = p =&gt; p.Id,
/// SetTranslatedValue = (p, val) =&gt; p.Description = val
/// }
/// };
/// await _sysLangTextCacheService.TranslateMultiFields(products, fields, "zh-CN");
/// </code>
/// </summary>
/// <typeparam name="TEntity">要翻译的实体类型，如 Product/Menu/SKU 等</typeparam>
/// <param name="list">需要翻译的实体对象列表</param>
/// <param name="fields">需要翻译的字段映射集合，支持多个字段</param>
/// <param name="langCode">语言编码，如 "zh-CN"、"en-US"、"it-IT" 等</param>
/// <returns>翻译后的实体列表（引用传递，原对象已直接赋值）</returns>
[NonAction]
public async Task<List<TEntity>> TranslateMultiFields<TEntity>(
List<TEntity> list,
List<LangFieldMap<TEntity>> fields,
string langCode)
{
var keyToField = new Dictionary<string, (TEntity Entity, LangFieldMap<TEntity> FieldMap)>();
var missingKeys = new List<string>();
// 先尝试从缓存读取
foreach (var item in list)
{
foreach (var field in fields)
{
var id = field.IdSelector(item);
var key = BuildKey(field.EntityName, field.FieldName, id, langCode);
var cached = _sysCacheService.Get<string>(key);
if (!string.IsNullOrEmpty(cached))
{
// 命中缓存，直接赋值
field.SetTranslatedValue(item, cached);
}
else
{
// 缓存未命中，加入待查表
keyToField[key] = (item, field);
missingKeys.Add(key);
}
}
}
if (missingKeys.Any())
{
// 把缺失的 keys 拆解成组合实体
var missingTuples = missingKeys
.Select(key =>
{
var parts = key.Split('_');
return new
{
EntityName = parts[1],
FieldName = parts[2],
EntityId = long.Parse(parts[3])
};
})
.ToList();
// 按 EntityName + FieldName 分组
var grouped = missingTuples
.GroupBy(x => new { x.EntityName, x.FieldName })
.ToList();
var result = new List<SysLangText>();
// 分批查询，每组单独查询
const int chunkSize = 500;
foreach (var g in grouped)
{
var allIds = g.Select(x => x.EntityId).Distinct().ToList();
for (int i = 0; i < allIds.Count; i += chunkSize)
{
var chunk = allIds.Skip(i).Take(chunkSize).ToList();
var temp = await _sysLangTextRep.AsQueryable()
.Where(u => u.LangCode == langCode
&& u.EntityName == g.Key.EntityName
&& u.FieldName == g.Key.FieldName
&& chunk.Contains(u.EntityId))
.ToListAsync();
result.AddRange(temp);
}
}
// 遍历查询结果，写回实体和缓存
foreach (var item in result)
{
var key = BuildKey(item.EntityName, item.FieldName, item.EntityId, item.LangCode);
if (keyToField.TryGetValue(key, out var tuple))
{
tuple.FieldMap.SetTranslatedValue(tuple.Entity, item.Content);
_sysCacheService.Set(key, item.Content, expireSeconds);
}
}
}
return list;
}
/// <summary>
/// 删除缓存
/// </summary>
/// <param name="entityName"></param>
/// <param name="fieldName"></param>
/// <param name="entityId"></param>
/// <param name="langCode"></param>
public void DeleteCache(string entityName, string fieldName, long entityId, string langCode)
{
var key = BuildKey(entityName, fieldName, entityId, langCode);
_sysCacheService.Remove(key);
}
/// <summary>
/// 更新缓存
/// </summary>
/// <param name="entityName"></param>
/// <param name="fieldName"></param>
/// <param name="entityId"></param>
/// <param name="langCode"></param>
/// <param name="newValue"></param>
public void UpdateCache(string entityName, string fieldName, long entityId, string langCode, string newValue)
{
var key = BuildKey(entityName, fieldName, entityId, langCode);
_sysCacheService.Set(key, newValue, expireSeconds);
}
}
Admin.NET.Core/Service/LangText/SysLangTextService.cs
+436
View File
@@ -0,0 +1,436 @@
// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
//
// 本项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
//
// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动！任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任！
using Newtonsoft.Json;
namespace Admin.NET.Core.Service;
/// <summary>
/// 翻译服务 🧩
/// </summary>
[ApiDescriptionSettings(Order = 100, Description = "翻译服务")]
public partial class SysLangTextService : IDynamicApiController, ITransient
{
private readonly SqlSugarRepository<SysLangText> _sysLangTextRep;
private readonly ISqlSugarClient _sqlSugarClient;
private readonly SysLangTextCacheService _sysLangTextCacheService;
public SysLangTextService(
SqlSugarRepository<SysLangText> sysLangTextRep,
SysLangTextCacheService sysLangTextCacheService,
ISqlSugarClient sqlSugarClient)
{
_sysLangTextRep = sysLangTextRep;
_sqlSugarClient = sqlSugarClient;
_sysLangTextCacheService = sysLangTextCacheService;
}
/// <summary>
/// 分页查询翻译表 🔖
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
[DisplayName("分页查询翻译表")]
[ApiDescriptionSettings(Name = "Page"), HttpPost]
public async Task<SqlSugarPagedList<SysLangTextOutput>> Page(PageSysLangTextInput input)
{
input.Keyword = input.Keyword?.Trim();
var query = _sysLangTextRep.AsQueryable()
.WhereIF(!string.IsNullOrWhiteSpace(input.Keyword), u => u.EntityName.Contains(input.Keyword) || u.FieldName.Contains(input.Keyword) || u.LangCode.Contains(input.Keyword) || u.Content.Contains(input.Keyword))
.WhereIF(!string.IsNullOrWhiteSpace(input.EntityName), u => u.EntityName.Contains(input.EntityName.Trim()))
.WhereIF(!string.IsNullOrWhiteSpace(input.FieldName), u => u.FieldName.Contains(input.FieldName.Trim()))
.WhereIF(!string.IsNullOrWhiteSpace(input.LangCode), u => u.LangCode.Contains(input.LangCode.Trim()))
.WhereIF(!string.IsNullOrWhiteSpace(input.Content), u => u.Content.Contains(input.Content.Trim()))
.WhereIF(input.EntityId != null, u => u.EntityId == input.EntityId)
.Select<SysLangTextOutput>();
return await query.OrderBuilder(input).ToPagedListAsync(input.Page, input.PageSize);
}
[DisplayName("获取翻译表")]
[ApiDescriptionSettings(Name = "List"), HttpPost]
public async Task<List<SysLangTextOutput>> List(ListSysLangTextInput input)
{
var query = _sysLangTextRep.AsQueryable()
.Where(u => u.EntityName == input.EntityName.Trim() && u.FieldName == input.FieldName.Trim() && u.EntityId == input.EntityId)
.WhereIF(!string.IsNullOrWhiteSpace(input.LangCode), u => u.LangCode == input.LangCode.Trim())
.Select<SysLangTextOutput>();
return await query.ToListAsync();
}
/// <summary>
/// 获取翻译表详情 ℹ️
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
[DisplayName("获取翻译表详情")]
[ApiDescriptionSettings(Name = "Detail"), HttpGet]
public async Task<SysLangText> Detail([FromQuery] QueryByIdSysLangTextInput input)
{
return await _sysLangTextRep.GetFirstAsync(u => u.Id == input.Id);
}
/// <summary>
/// 增加翻译表 ➕
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
[DisplayName("增加翻译表")]
[ApiDescriptionSettings(Name = "Add"), HttpPost]
public async Task<long> Add(AddSysLangTextInput input)
{
var entity = input.Adapt<SysLangText>();
return await _sysLangTextRep.InsertAsync(entity) ? entity.Id : 0;
}
/// <summary>
/// 更新翻译表 ✏️
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
[DisplayName("更新翻译表")]
[ApiDescriptionSettings(Name = "Update"), HttpPost]
public async Task Update(UpdateSysLangTextInput input)
{
var entity = input.Adapt<SysLangText>();
await _sysLangTextRep.AsUpdateable(entity)
.ExecuteCommandAsync();
_sysLangTextCacheService.UpdateCache(entity.EntityName, entity.FieldName, entity.EntityId, entity.LangCode, entity.Content);
}
/// <summary>
/// 删除翻译表 ❌
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
[DisplayName("删除翻译表")]
[ApiDescriptionSettings(Name = "Delete"), HttpPost]
public async Task Delete(DeleteSysLangTextInput input)
{
var entity = await _sysLangTextRep.GetFirstAsync(u => u.Id == input.Id) ?? throw Oops.Oh(ErrorCodeEnum.D1002);
await _sysLangTextRep.DeleteAsync(entity); //真删除
_sysLangTextCacheService.DeleteCache(entity.EntityName, entity.FieldName, entity.EntityId, entity.LangCode);
}
/// <summary>
/// 批量删除翻译表 ❌
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
[DisplayName("批量删除翻译表")]
[ApiDescriptionSettings(Name = "BatchDelete"), HttpPost]
public async Task BatchDelete([Required(ErrorMessage = "主键列表不能为空")] List<DeleteSysLangTextInput> input)
{
var exp = Expressionable.Create<SysLangText>();
foreach (var row in input) exp = exp.Or(it => it.Id == row.Id);
var list = await _sysLangTextRep.AsQueryable().Where(exp.ToExpression()).ToListAsync();
await _sysLangTextRep.DeleteAsync(list); //真删除
foreach (var item in list)
{
_sysLangTextCacheService.DeleteCache(item.EntityName, item.FieldName, item.EntityId, item.LangCode);
}
}
private static readonly object _sysLangTextBatchSaveLock = new object();
/// <summary>
/// 批量保存翻译表 ✏️
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
[DisplayName("批量保存翻译表")]
[ApiDescriptionSettings(Name = "BatchSave"), HttpPost]
public void BatchSave([Required(ErrorMessage = "列表不能为空")] List<ImportSysLangTextInput> input)
{
lock (_sysLangTextBatchSaveLock)
{
// 校验并过滤必填基本类型为null的字段
var rows = input.Where(x =>
{
if (!string.IsNullOrWhiteSpace(x.Error)) return false;
if (x.EntityId == null)
{
x.Error = "所属实体ID不能为空";
return false;
}
return true;
}).Adapt<List<SysLangText>>();
var storageable = _sysLangTextRep.Context.Storageable(rows)
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.EntityName), "所属实体名不能为空")
.SplitError(it => it.Item.EntityName?.Length > 255, "所属实体名长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.FieldName), "字段名不能为空")
.SplitError(it => it.Item.FieldName?.Length > 255, "字段名长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.LangCode), "语言代码不能为空")
.SplitError(it => it.Item.LangCode?.Length > 255, "语言代码长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.Content), "翻译内容不能为空")
.WhereColumns(it => new { it.EntityId, it.EntityName, it.FieldName, it.LangCode })
.SplitInsert(it => it.NotAny())
.SplitUpdate(it => it.Any())
.ToStorage();
storageable.AsInsertable.ExecuteCommand();// 不存在插入
storageable.AsUpdateable.UpdateColumns(it => new
{
it.EntityName,
it.EntityId,
it.FieldName,
it.LangCode,
it.Content,
}).ExecuteCommand();// 存在更新
foreach (var item in rows)
{
_sysLangTextCacheService.DeleteCache(item.EntityName, item.FieldName, item.EntityId, item.LangCode);
}
if (storageable.ErrorList.Any())
{
throw Oops.Oh($"处理过程中出现以下错误：{string.Join("；", storageable.ErrorList.Distinct())}");
}
}
}
/// <summary>
/// 导出翻译表记录 🔖
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
[DisplayName("导出翻译表记录")]
[ApiDescriptionSettings(Name = "Export"), HttpPost, NonUnify]
public async Task<IActionResult> Export(PageSysLangTextInput input)
{
var list = (await Page(input)).Items?.Adapt<List<ExportSysLangTextOutput>>() ?? new();
if (input.SelectKeyList?.Count > 0) list = list.Where(x => input.SelectKeyList.Contains(x.Id)).ToList();
return ExcelHelper.ExportTemplate(list, "翻译表导出记录");
}
/// <summary>
/// 下载翻译表数据导入模板 ⬇️
/// </summary>
/// <returns></returns>
[DisplayName("下载翻译表数据导入模板")]
[ApiDescriptionSettings(Name = "Import"), HttpGet, NonUnify]
public IActionResult DownloadTemplate()
{
return ExcelHelper.ExportTemplate(new List<ExportSysLangTextOutput>(), "翻译表导入模板");
}
private static readonly object _sysLangTextImportLock = new object();
/// <summary>
/// 导入翻译表记录 💾
/// </summary>
/// <returns></returns>
[DisplayName("导入翻译表记录")]
[ApiDescriptionSettings(Name = "Import"), HttpPost, NonUnify, UnitOfWork]
public IActionResult ImportData([Required] IFormFile file)
{
lock (_sysLangTextImportLock)
{
var stream = ExcelHelper.ImportData<ImportSysLangTextInput, SysLangText>(file, (list, markerErrorAction) =>
{
_sqlSugarClient.Utilities.PageEach(list, 2048, pageItems =>
{
// 校验并过滤必填基本类型为null的字段
var rows = pageItems.Where(x =>
{
if (!string.IsNullOrWhiteSpace(x.Error)) return false;
if (x.EntityId == null)
{
x.Error = "所属实体ID不能为空";
return false;
}
return true;
}).Adapt<List<SysLangText>>();
var storageable = _sysLangTextRep.Context.Storageable(rows)
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.EntityName), "所属实体名不能为空")
.SplitError(it => it.Item.EntityName?.Length > 255, "所属实体名长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.FieldName), "字段名不能为空")
.SplitError(it => it.Item.FieldName?.Length > 255, "字段名长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.LangCode), "语言代码不能为空")
.SplitError(it => it.Item.LangCode?.Length > 255, "语言代码长度不能超过255个字符")
.SplitError(it => string.IsNullOrWhiteSpace(it.Item.Content), "翻译内容不能为空")
.SplitError(it => it.Item.Content?.Length > 255, "翻译内容长度不能超过255个字符")
.WhereColumns(it => new { it.EntityId, it.EntityName, it.FieldName, it.LangCode })
.SplitInsert(it => it.NotAny())
.SplitUpdate(it => it.Any())
.ToStorage();
storageable.AsInsertable.ExecuteCommand();// 不存在插入
storageable.AsUpdateable.UpdateColumns(it => new
{
it.EntityName,
it.EntityId,
it.FieldName,
it.LangCode,
it.Content,
}).ExecuteCommand();// 存在更新
foreach (var item in rows)
{
_sysLangTextCacheService.DeleteCache(item.EntityName, item.FieldName, item.EntityId, item.LangCode);
}
// 标记错误信息
markerErrorAction.Invoke(storageable, pageItems, rows);
});
});
return stream;
}
}
/// <summary>
/// DEEPSEEK 翻译接口
/// </summary>
/// <returns></returns>
[DisplayName("DEEPSEEK 翻译接口")]
[ApiDescriptionSettings(Name = "AiTranslateText"), HttpPost]
public async Task<string> AiTranslateText(AiTranslateTextInput input)
{
// 需要先把DeepSeek.example复制改名为DeepSeek.json文件，添加你的 API KEY
var deepSeekOptions = App.GetConfig<DeepSeekOptions>("DeepSeekSettings", true);
if (deepSeekOptions == null)
{
throw new InvalidOperationException("DeepSeek.json文件 未定义");
}
if (string.IsNullOrEmpty(deepSeekOptions.ApiKey))
{
throw new InvalidOperationException("环境变量 DEEPSEEK_API_KEY 未定义");
}
using (HttpClient client = new HttpClient())
{
// 构建请求头
client.DefaultRequestHeaders.Add("Authorization", $"Bearer {deepSeekOptions.ApiKey}");
// 构建系统提示词
string systemPrompt = BuildSystemPrompt(deepSeekOptions.SourceLang, input.TargetLang);
// 构建请求体
var requestBody = new
{
model = "deepseek-chat",
messages = new[]
{
new { role = "system", content = systemPrompt },
new { role = "user", content = input.OriginalText }
},
temperature = 0.3,
max_tokens = 2000
};
// 使用 Newtonsoft.Json 序列化
var json = JsonConvert.SerializeObject(requestBody);
var content = new StringContent(json, Encoding.UTF8, "application/json");
// 发送请求
HttpResponseMessage response = await client.PostAsync(deepSeekOptions.ApiUrl, content);
// 处理响应
string responseBody = await response.Content.ReadAsStringAsync();
if (!response.IsSuccessStatusCode)
{
// 使用 Newtonsoft.Json 反序列化错误响应
var errorResponse = JsonConvert.DeserializeObject<ErrorResponse>(responseBody);
string errorMsg = errorResponse?.error?.message ?? $"HTTP {response.StatusCode}: {response.ReasonPhrase}";
throw new HttpRequestException($"翻译API返回错误：{errorMsg}");
}
// 解析有效响应
var result = JsonConvert.DeserializeObject<TranslationResponse>(responseBody);
if (result?.choices == null || result.choices.Length == 0 ||
result.choices[0]?.message?.content == null)
{
throw new InvalidOperationException("API返回无效的翻译结果");
}
return result.choices[0].message.content.Trim();
}
}
// JSON 响应模型
private class TranslationResponse
{
public Choice[] choices { get; set; }
}
private class Choice
{
public Message message { get; set; }
}
private class Message
{
public string content { get; set; }
}
private class ErrorResponse
{
public ErrorInfo error { get; set; }
}
private class ErrorInfo
{
public string message { get; set; }
}
/// <summary>
/// 生成提示词
/// </summary>
/// <param name="sourceLang"></param>
/// <param name="targetLang"></param>
/// <returns></returns>
private static string BuildSystemPrompt(string sourceLang, string targetLang)
{
return $@"作为企业软件系统专业翻译，严格遵守以下铁律：
■ 核心原则
1. 严格逐符号翻译（{sourceLang}→{targetLang}）
2. 禁止添加/删除/改写任何内容
3. 保持批量翻译的编号格式
■ 符号保留规则
! 所有符号必须原样保留：
• 编程符号：\${{ }} <% %> @ # & |
• UI占位符：{{0}} %s [ ]
• 货币单位：¥100.00 kg cm²
• 中文符号：【 】 《 》 ：
■ 中文符号位置规范
# 三级处理机制：
1. 成对符号必须保持完整结构：
✓ 正确：【Warning】Text
✗ 禁止：Warning【 】Text
2. 独立符号位置：
• 优先句尾 → Text】?
• 次选句首 → 】Text?
• 禁止句中 → Text】Text?
3. 跨字符串符号处理：
• 前段含【时 → 保留在段尾（""Synchronize【""）
• 后段含】时 → 保留在段首（""】authorization data?""）
• 符号后接字母时添加空格：】 Authorization
■ 语法规范
• 外文 → 被动语态（""Item was created""）
• 中文 → 主动语态（""已创建项目""）
• 禁止推测上下文（只翻译当前字符串内容）
■ 错误预防（绝对禁止）
✗ 将中文符号改为西式符号（】→]）
✗ 移动非中文符号位置
✗ 添加原文不存在的内容
✗ 合并/拆分原始字符串
■ 批量处理
▸ 严格保持原始JSON结构
▸ 语言键名精确匹配（zh-cn/en/it等）";
}
}