model层实现:
LoginRequest.cs:
using System.ComponentModel.DataAnnotations;namespace FixedAssetInventory.Models
{/// <summary>/// 登录请求 DTO/// </summary>public class LoginRequest{/// <summary>/// 登录用户名/// </summary>[Required(ErrorMessage = "用户名不能为空")]public string UserName { get; set; }/// <summary>/// 登录密码/// </summary>[Required(ErrorMessage = "密码不能为空")]public string Password { get; set; }}
}
InventoryResultDto.cs
using System;namespace FixedAssetInventory.Models
{/// <summary>/// 盘点结果 DTO/// </summary>public class InventoryResultDto{/// <summary>/// 资产编号/// </summary>public string AssetCode { get; set; }/// <summary>/// 盘点状态(已盘点/未盘点/异常)/// </summary>public string Status { get; set; }/// <summary>/// 异常说明/// </summary>public string ExceptionRemark { get; set; }/// <summary>/// 盘点时间/// </summary>public DateTime CheckedAt { get; set; }/// <summary>/// 盘点人/// </summary>public string CheckedBy { get; set; }}
}
AssetDto.cs:
using System;namespace FixedAssetInventory.Models
{/// <summary>/// 固定资产 DTO/// </summary>public class AssetDto{public long Id { get; set; }/// <summary>/// 资产编号/// </summary>public string AssetCode { get; set; }/// <summary>/// 资产名称/// </summary>public string AssetName { get; set; }/// <summary>/// 所属部门/// </summary>public string Department { get; set; }/// <summary>/// 使用人/// </summary>public string UserName { get; set; }/// <summary>/// 存放位置/// </summary>public string Location { get; set; }/// <summary>/// 状态/// </summary>public string Status { get; set; }/// <summary>/// 创建时间/// </summary>public DateTime CreatedAt { get; set; }}
}
TaskDto.cs
using System;namespace FixedAssetInventory.Models
{/// <summary>/// 盘点任务 DTO/// </summary>public class TaskDto{public long Id { get; set; }/// <summary>/// 任务名称/// </summary>public string TaskName { get; set; }/// <summary>/// 任务状态(进行中/已完成/已取消)/// </summary>public string Status { get; set; }/// <summary>/// 创建人姓名/// </summary>public string CreatedBy { get; set; }/// <summary>/// 执行人姓名/// </summary>public string AssignedTo { get; set; }/// <summary>/// 创建时间/// </summary>public DateTime CreatedAt { get; set; }/// <summary>/// 预计完成时间/// </summary>public DateTime? DueDate { get; set; }}
}
ReportDto.cs
using System;
using System.Collections.Generic;namespace FixedAssetInventory.Models
{/// <summary>/// 盘点统计报表 DTO/// </summary>public class ReportDto{/// <summary>/// 任务名称/// </summary>public string TaskName { get; set; }/// <summary>/// 总资产数/// </summary>public int TotalAssets { get; set; }/// <summary>/// 已盘点资产数/// </summary>public int CheckedAssets { get; set; }/// <summary>/// 异常资产数/// </summary>public int ExceptionAssets { get; set; }/// <summary>/// 完成率(百分比)/// </summary>public double CompletionRate{get{if (TotalAssets == 0) return 0;return Math.Round((double)CheckedAssets / TotalAssets * 100, 2);}}/// <summary>/// 异常率(百分比)/// </summary>public double ExceptionRate{get{if (TotalAssets == 0) return 0;return Math.Round((double)ExceptionAssets / TotalAssets * 100, 2);}}/// <summary>/// 图表数据/// </summary>public List<ChartDataItem> ChartData { get; set; } = new List<ChartDataItem>();}/// <summary>/// 图表数据项 DTO/// </summary>public class ChartDataItem{public string Label { get; set; }public int Value { get; set; }}
}
严格区分 DTO 与 Entity
DTO 只暴露业务需要的字段,防止直接返回数据库字段(比如
PasswordHash
不会出现在 DTO 里)
数据验证
登录、资产导入等需要用
[Required]
、[StringLength]
等注解
计算属性
ReportDto
里的完成率、异常率是后端自动算的,前端不用重复计算
扩展性
ChartData
用于可视化(前端 Blazor 或 ECharts 直接绑定)AutoMapper 配置文件
AutoMapper 配置文件:
我们在 FixedAssetInventory.Core
下新建 Mapping/AutoMapperProfile.cs
using AutoMapper;
using FixedAssetInventory.Core.Entities;
using FixedAssetInventory.Models;namespace FixedAssetInventory.Core.Mapping
{/// <summary>/// AutoMapper 映射配置/// </summary>public class AutoMapperProfile : Profile{public AutoMapperProfile(){// User <-> LoginRequestCreateMap<User, LoginRequest>().ReverseMap();// Asset <-> AssetDtoCreateMap<Asset, AssetDto>().ReverseMap();// InventoryRecord -> InventoryResultDtoCreateMap<InventoryRecord, InventoryResultDto>().ForMember(dest => dest.AssetCode, opt => opt.MapFrom(src => src.AssetCode)).ForMember(dest => dest.CheckedAt, opt => opt.MapFrom(src => src.CheckedAt)).ForMember(dest => dest.CheckedBy, opt => opt.MapFrom(src => src.CheckedBy)).ForMember(dest => dest.Status, opt => opt.MapFrom(src => src.Status)).ForMember(dest => dest.ExceptionRemark, opt => opt.MapFrom(src => src.Remark)).ReverseMap();// Task <-> TaskDtoCreateMap<InventoryTask, TaskDto>().ForMember(dest => dest.CreatedBy, opt => opt.MapFrom(src => src.CreatedByName)).ForMember(dest => dest.AssignedTo, opt => opt.MapFrom(src => src.AssignedToName)).ReverseMap();// Report 数据映射CreateMap<ReportDto, ReportDto>().ReverseMap();}}
}
2. 在 Startup.cs 注册 AutoMapper
using AutoMapper;
using FixedAssetInventory.Core.Mapping;public class Startup
{public IConfiguration Configuration { get; }public Startup(IConfiguration configuration){Configuration = configuration;}public void ConfigureServices(IServiceCollection services){// 注册 AutoMapperservices.AddAutoMapper(typeof(AutoMapperProfile));// 注册控制器 + JSON 配置services.AddControllers().AddNewtonsoftJson(options =>{options.SerializerSettings.DateFormatString = "yyyy-MM-dd HH:mm:ss";});// 注册自定义服务(依赖注入)services.AddScoped<IAuthService, AuthService>();services.AddScoped<IInventoryService, InventoryService>();services.AddScoped<IAssetService, AssetService>();services.AddScoped<ITaskService, TaskService>();services.AddScoped<IReportService, ReportService>();// 注册 FreeSql 连接 Oracleservices.AddSingleton<IFreeSql>(sp =>{return new FreeSql.FreeSqlBuilder().UseConnectionString(FreeSql.DataType.Oracle, Configuration.GetConnectionString("OracleConnection")).UseMonitorCommand(cmd => Console.WriteLine($"SQL: {cmd.CommandText}")).Build();});// 添加跨域支持services.AddCors(options =>{options.AddPolicy("AllowAll", builder =>{builder.AllowAnyOrigin().AllowAnyMethod().AllowAnyHeader();});});// 添加Swaggerservices.AddSwaggerGen();}public void Configure(IApplicationBuilder app, IWebHostEnvironment env){if (env.IsDevelopment()){app.UseDeveloperExceptionPage();app.UseSwagger();app.UseSwaggerUI(c =>{c.SwaggerEndpoint("/swagger/v1/swagger.json", "FixedAssetInventory API V1");});}app.UseRouting();app.UseCors("AllowAll");app.UseMiddleware<AuthMiddleware>();app.UseMiddleware<LoggingMiddleware>();app.UseEndpoints(endpoints =>{endpoints.MapControllers();});}
}
3. 配置文件 appsettings.json
确保 appsettings.json
里有连接字符串和 OCR API URL:
json
复制编辑
{ "ConnectionStrings": { "OracleConnection": "Data Source=127.0.0.1:1521/ORCL;User Id=asset_user;Password=123456;" }, "OcrApi": { "BaseUrl": "http://127.0.0.1:5001/api/ocr" }, "Logging": { "LogLevel": { "Default": "Information", "Microsoft": "Warning", "Microsoft.Hosting.Lifetime": "Information" } }, "AllowedHosts": "*" }
4. Program.cs
csharp
复制编辑
using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Hosting; namespace FixedAssetInventory { public class Program { public static void Main(string[] args) { CreateHostBuilder(args).Build().Run(); } public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); }); } }