# 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](https://dotnet.microsoft.com/download) 与 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.cs`、`Startup.cs`：应用启动入口与依赖注入、Swagger、CORS 等管线配置。

## 开发命令
- `dotnet test`（待建立测试项目）运行自动化测试。
- `dotnet publish -c Release -o bin/Publish/net8.0` 生成部署包。

## 更多资料
- `AGENTS.md`：贡献指南，包含代码风格、提测、PR 要求等说明。