编辑 | blame | 历史 | 原始文档

LW_PdaService

蓝宝 MES PDA 后端服务,基于 ASP.NET Core Web API,为 PDA 终端提供仓储、质检、工单等业务接口。项目采用 SqlSugar 访问 SQL Server,并通过统一响应结构 ResponseResult 返回数据。

功能概览

  • Warehouse:库存查询、出入库、调拨与条码追溯 API。
  • QC:IPQC、量检记录等质检流程接口。
  • Wom:工单、生产报工及工序进度管理。
  • Auth/Login:账号认证、消息与权限相关基础能力。

技术栈

  • .NET 8 / ASP.NET Core Web API。
  • SqlSugarCore 进行 ORM 与数据库操作,DbHelperSQL 封装部分存储过程调用。
  • Swashbuckle 提供 Swagger 文档,Newtonsoft.Json 负责序列化。

快速开始

  1. 安装 .NET 8 SDK 与 SQL Server(或兼容实例)。
  2. 复制 appsettings.Development.json,填入环境实际的 AppSettings:测试与生产 ERP 地址、DataBaseConn 连接串。建议在本地使用 dotnet user-secrets 隐藏敏感信息。
  3. 在仓库根目录执行:
    powershell dotnet restore dotnet build NewPdaSqlServer.csproj -c Debug dotnet run --project NewPdaSqlServer.csproj --launch-profile Development
  4. 访问 https://localhost:5001/swagger(或启动日志中的端口)查看接口说明。

目录结构速览

  • Controllers/:按业务域划分的 Web API 控制器,Controllers/base 存放共用查询。
  • service/:与控制器同名的业务层,封装 SqlSugar 查询与事务。
  • Dto/:请求/响应数据传输对象,entity/ 为数据库实体。
  • util/:公用工具(配置、日志、编号生成等);Config/ 维护外部系统配置。
  • Program.csStartup.cs:应用启动入口与依赖注入、Swagger、CORS 等管线配置。

开发命令

  • dotnet test(待建立测试项目)运行自动化测试。
  • dotnet publish -c Release -o bin/Publish/net8.0 生成部署包。

更多资料

  • AGENTS.md:贡献指南,包含代码风格、提测、PR 要求等说明。