| | |
|---|
| | | ## LW_PdaService |
|---|
| | | # LW_PdaService |
|---|
| | | |
|---|
| | | 龙巍PDA后端 |
|---|
| | | 蓝宝 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 要求等说明。 |
|---|
| | | |
|---|
