Antis.Erp.Plat/DEPLOYMENT_GUIDE.md

# 库存过滤修复 - 部署指南
## 📦 编译完成信息
### ✅ 后端编译完成
**编译时间**: 2024-10-29 01:43 (约7秒)
**编译模式**: Release (.NET 6.0)
**编译状态**: 成功 (0 错误, 37 个警告)
**输出位置**:
```
/Users/hexiaodong/Desktop/git/erp2025/Antis.Erp.Plat/netcore/src/Application/NCC.API/bin/Release/net6.0/
```
**关键 DLL 文件**:
- `NCC.API.dll` - 主应用程序
- `NCC.API.Core.dll` - 核心库
- `NCC.Extend.dll` - 扩展模块 ✨ **包含库存过滤修复**
---
### ✅ 前端编译完成
**编译时间**: 2024-10-29 01:43
**编译模式**: production (dotNetTest)
**编译状态**: 成功
**输出位置**:
```
/Users/hexiaodong/Desktop/git/erp2025/Antis.Erp.Plat/antis-ncc-admin/dist/
```
**输出内容**:
- `index.html` - 主页面 ✨ **包含库存过滤修复**
- `static/` - 静态资源 (JS, CSS)
- `cdn/` - CDN 资源 (Monaco Editor, ECharts)
---
## 🚀 部署步骤
### 步骤1️⃣: 部署后端服务 (2015端口)
#### 方式A: 直接替换 DLL (推荐快速部署)
```bash
# 停止 API 服务
# (根据你的部署方式停止 NCC.API)
# 备份原文件
cp -r /path/to/api/bin /path/to/api/bin.bak
# 复制新编译的文件
cp -r /Users/hexiaodong/Desktop/git/erp2025/Antis.Erp.Plat/netcore/src/Application/NCC.API/bin/Release/net6.0/* \
      /path/to/api/bin/
# 重启 API 服务
# (根据你的部署方式启动 NCC.API)
```
#### 方式B: 完整重新发布
```bash
cd /Users/hexiaodong/Desktop/git/erp2025/Antis.Erp.Plat/netcore
# 发布应用
dotnet publish -c Release -o /path/to/publish/
# 替换服务
# 停止服务 → 备份原目录 → 复制新版本 → 启动服务
```
---
### 步骤2️⃣: 部署前端应用 (3000端口)
#### 方式A: 复制到 Web 服务器目录
```bash
# 方式1: 如果是 Nginx/Apache 提供静态文件
cp -r /Users/hexiaodong/Desktop/git/erp2025/Antis.Erp.Plat/antis-ncc-admin/dist/* \
      /var/www/html/admin/
# 方式2: 如果使用 Node.js 开发服务器
cp -r /Users/hexiaodong/Desktop/git/erp2025/Antis.Erp.Plat/antis-ncc-admin/dist/* \
      /path/to/frontend/server/public/
```
#### 方式B: 如果有 Docker 容器
```bash
# 为前端构建新镜像
docker build -f antis-ncc-admin/Dockerfile -t ncc-admin:latest .
# 重启容器
docker-compose down
docker-compose up -d
```
---
## ✨ 修改内容总结
### 前端修改 (index.html)
**文件**: `antis-ncc-admin/dist/index.html`
修复：搜索商品时添加门店ID参数
```javascript
// 修改前：缺少 xsmd 参数
params: {
    keyword: that.keyword,
}
// 修改后：添加了 xsmd 参数
params: {
    keyword: that.keyword,
    xsmd: this.selectedStore.id || mdId  // ✨ 新增
}
```
### 后端修改 (NCC.Extend.dll)
**文件**: `NCC.Extend/WtSpService.cs`
修复位置：
1. **GetList 方法**（行154）
   - 添加门店过滤条件
2. **GetListByKeyword 方法**（行291）
   - 添加门店过滤条件
修改内容：
```csharp
// 修改前：
var stockQuery = await _db.Queryable<WtSerialNumberEntity>()
    .Where(s => productIds.Contains(s.Spbh) && s.Status == 0)
    .GroupBy(s => s.Spbh)
    .Select(s => new { ... })
    .ToListAsync();
// 修改后：
var stockQuery = await _db.Queryable<WtSerialNumberEntity>()
    .Where(s => productIds.Contains(s.Spbh) && s.Status == 0)
    .WhereIF(!string.IsNullOrEmpty(input.xsmd), s => s.InWarehouse == input.xsmd)  // ✨ 新增
    .GroupBy(s => s.Spbh)
    .Select(s => new { ... })
    .ToListAsync();
```
---
## 🧪 验证部署
部署完成后，请按以下步骤验证：
### 验证步骤
1. **启动服务**
   ```bash
   # 启动后端 API (2015端口)
   # 启动前端服务 (3000端口)
   ```
2. **打开浏览器**
   ```
   http://localhost:3000  或  http://你的服务器:3000
   ```
3. **测试收银台功能**
   - 登录景枫店收银台
   - 搜索一个商品（使用关键词）
   - 查看显示的库存数字
4. **验证库存显示**
   - **修复前**: 显示 39 件（全公司库存）❌
   - **修复后**: 显示 10 件（景枫店库存）✅
---
## 🔍 调试信息
### 后端日志检查
编译后的 DLL 包含调试输出，可以查看日志：
```
=== GetList方法开始执行 ===
输入参数: spmc=..., spbm=..., xsmd=...
门店ID: [你输入的门店ID]
开始查询库存，商品数量: ...
```
### 浏览器控制台
打开浏览器开发者工具 (F12)，查看：
```javascript
// 应该看到 API 请求包含 xsmd 参数
// 示例: /api/Extend/wtsp/GetListByKeyword?keyword=商品名&xsmd=景枫店ID
```
---
## ⚠️ 常见问题
### Q1: 部署后库存仍然显示不正确
**A**: 
1. 确认后端 API 已重启（新 DLL 已加载）
2. 确认前端已更新（浏览器清除缓存 Ctrl+Shift+Delete）
3. 检查网络请求中是否包含 `xsmd` 参数
### Q2: 编译失败怎么办？
**A**: 
1. 确保 .NET 6.0 SDK 已安装
2. 清理编译输出：`dotnet clean`
3. 恢复依赖：`dotnet restore`
4. 重新编译：`dotnet build -c Release`
### Q3: 前端构建失败怎么办？
**A**:
1. 清除依赖：`rm -rf node_modules`
2. 重新安装：`npm install`
3. 重新构建：`npm run build:dotNetTest`
---
## 📌 文件清单
### 后端编译输出
```
/Users/hexiaodong/Desktop/git/erp2025/Antis.Erp.Plat/netcore/src/Application/NCC.API/bin/Release/net6.0/
├── NCC.API.dll              ← 主应用程序
├── NCC.API.Core.dll         ← 核心库
├── NCC.Extend.dll           ← ✨ 扩展模块（包含修复）
├── appsettings.json         ← 应用配置
├── web.config               ← IIS 配置
└── [其他依赖 DLL]
```
### 前端编译输出
```
/Users/hexiaodong/Desktop/git/erp2025/Antis.Erp.Plat/antis-ncc-admin/dist/
├── index.html               ← ✨ 主页面（包含修复）
├── static/
│   ├── js/                  ← JavaScript 文件
│   ├── css/                 ← 样式文件
│   └── img/                 ← 图片资源
├── cdn/                     ← CDN 资源
│   ├── echarts/             ← ECharts 库
│   └── monaco-editor/       ← 代码编辑器
└── [worker 文件]
```
---
## 📞 需要帮助？
如果部署过程中遇到问题：
1. 检查日志文件
2. 查看浏览器控制台错误
3. 对比本指南的验证步骤
4. 参考详细的技术文档：`INVENTORY_FILTER_FIX.md`
---
## ✅ 部署完成检查清单
- [ ] 后端 DLL 已复制
- [ ] API 服务已重启
- [ ] 前端文件已复制
- [ ] 浏览器缓存已清除
- [ ] 前端服务已启动
- [ ] 库存显示正确（显示门店库存，不是全公司库存）
- [ ] 其他功能正常运行