# JiuZuClass

**Repository Path**: liweiye888/jiu-zu-class

## Basic Information

- **Project Name**: JiuZuClass
- **Description**: No description available
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-10
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MES 质量管理后端

## 开发启动顺序

后端必须由开发者手动启动，并成功连接远程 MySQL 后，才能启动 MES 前端。请在本仓库根目录运行：

```powershell
cd .\MESXiang
dotnet run --project .\MESXiang\MESXiang.csproj --launch-profile http
```

后端统一监听 `5050`。Debug 构建和 Visual Studio 的 `http` 配置启动前会运行
`scripts\Release-BackendPort.ps1`：只停止本仓库遗留的 `MESXiang` 进程，不会结束其他项目。
因此重复点击启动会由新实例接管 `5050`，不会再出现 AddressInUse。

`GET http://127.0.0.1:5050/api/health` 仅表示进程存活，
`GET http://127.0.0.1:5050/api/health/ready` 返回成功才表示远程数据库也已连接。
前端启动脚本会强制检查后一个接口；后端或数据库未就绪时，前端不会启动。

## 队友首次拉取

真实数据库密码和 JWT 密钥不会提交到 Git。首次拉取后，在仓库根目录运行一次：

```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\Initialize-DevelopmentConfig.ps1
```

按提示输入 Smart71 的 MySQL 地址、用户名和密码。脚本会生成已被 Git 忽略的
`MESXiang\MESXiang\appsettings.Development.json`，所有模块共用这一份本地配置。

随后启动唯一后端：

```powershell
cd .\MESXiang
dotnet run --project .\MESXiang\MESXiang.csproj --launch-profile http
```

后端统一监听 `5050`，Swagger 同时展示质量、生产、主数据和系统监控接口。已有本地配置时脚本不会覆盖；确需重建可增加 `-Force`。

本仓库在保留原有项目名和七层结构的基础上，实现常见缺陷、检测项、检测模板、待检任务，以及来料、过程、出货检验 API。运行时使用 .NET 8、EF Core 8 和 Pomelo MySQL。

## 本机配置

数据库 `Smart71` 必须由小组预先创建，程序只创建质量模块表。复制
`MESXiang\MESXiang\appsettings.template.json` 为同目录下的
`appsettings.Development.json`，替换服务器、账号和密码占位符。真实开发配置已被
Git 忽略，不得提交。

在开发配置中保留以下设置，程序启动时会依次获取 MySQL 命名锁、应用 Migration、
写入幂等种子数据并释放锁：

```json
"Database": {
  "AutoMigrate": true,
  "MigrationLockTimeoutSeconds": 60
}
```

## Windows 启动与验证

```powershell
cd .\MESXiang
dotnet restore .\MESXiang.sln
dotnet build .\MESXiang.sln
dotnet test .\MESXiang.sln
dotnet run --project .\MESXiang\MESXiang.csproj --launch-profile http
```

没有共享数据库凭据时，将 `AutoMigrate` 保持为 `false`，服务仍可启动用于验证路由、
CORS 和前端布局，但访问业务接口会因数据库不可用而返回统一错误。

## Migration 协作规则

表结构变更由一名成员生成并提交 Migration，其他成员拉取后由启动流程自动应用，
不要针对同一模型并行生成不同迁移。

```powershell
dotnet ef migrations add <MigrationName> `
  --project .\Mes.Repository\Mes.Repository.csproj `
  --startup-project .\MESXiang\MESXiang.csproj `
  --context QualityDbContext `
  --output-dir QualityData\Migrations
```

初始迁移为 `InitialQualityModule`，包含八张 `quality_*` 业务表；不会调用
`EnsureCreated`，也不会创建 `Smart71` 数据库本身。
# 天气生产预警

MES 已内置天气 MCP 与生产活动预警模块，部署参数和环境变量见 [`docs/weather-production-alerts-deployment.md`](docs/weather-production-alerts-deployment.md)。