GS MES 服务

项目概览

GS MES Service 基于 ASP.NET Core 8.0 构建，Gs.HostIIS 负责托管 Web API、加载配置并暴露分组化 Swagger 文档。各业务模块（BaseInfo、Sales、Warehouse 等）以 Gs.<Module> 项目存在，控制器放在 Services/，数据模型位于 Models/，共享实体和 DTO 集中在 Gs.Entity。通用组件（授权、Excel、HTTP、依赖注入扩展等）统一封装在 Gs.Toolbox。

目录结构

• GsMesSolution.sln：解决方案入口，统一执行构建、测试。
• Gs.HostIIS/：宿主项目，包含 Program.cs、appsettings*.json、Swagger 配置以及 /down、/upload 静态资源映射。
• Gs.<Module>/：业务模块（如 Gs.BaseInfo、Gs.Sales、Gs.Warehouse），遵循 Models/ + Services/ 文件夹布局。
• Gs.Entity/：SqlSugar 实体与跨模块共享的 DTO。
• Gs.Toolbox/：依赖注入扩展、API 约定、日志、Excel 工具等基础设施能力。
• Gs.HostIIS/.config/：部署阶段使用的环境配置转换文件。

快速开始

1. 安装 .NET SDK 8.0，确认数据库连接信息与 appsettings.json 对应。
2. 恢复依赖：
   bash dotnet restore GsMesSolution.sln
3. 构建项目：
   bash dotnet build GsMesSolution.sln -c Release
4. 启动 API：
   bash dotnet run --project Gs.HostIIS/Gs.HostIIS.csproj
   启动后访问 http://localhost:<端口>/swagger 查看分组 API 文档。静态下载目录映射 /down，上传目录映射 /upload，路径由配置中的 DownPath、UploadPath 控制。

测试说明

仓库暂未引入自动化测试。新增功能时请在相应模块旁创建 xUnit 项目（示例：Gs.Sales.Tests），测试文件统一命名为 *Tests.cs。Mock SqlSugar 依赖保持测试可重复，并在解决方案根目录执行：
bash dotnet test
提交变更前记录手工冒烟结果（Swagger 可用性、核心接口、关键存储过程）并写入 PR。

配置与安全

• 禁止提交任何硬编码的连接字符串或密码，开发阶段通过 User Secrets 或环境变量注入。
• 环境差异配置放入 .config 目录，发布时执行转换，不直接修改基础配置。
• 调整 SqlSugar 数据结构前务必在预发布环境验证，并在公开部署前检查 Swagger 暴露范围。

贡献指南

• 遵循四空格缩进、类型 PascalCase、局部变量 camelCase、常量 ALL_CAPS 的命名规范，保持可空引用启用。
• 新增服务通过 Gs.Toolbox 的扩展方法注册，确保 builder.AddCustomInject() 流程定义统一。
• 提交信息沿用历史风格：简洁的中文单行说明，例如 Baobiao: 修复导出异常。
• PR 中需列出受影响模块、配置或数据库变更、自动化测试与手工冒烟结果，并附上示例请求或截图。