Day 6 - 发布候选

这个版本已经准备好进入完整验收。如果验收没有发现阻塞问题，就可以作为正式发布版本的基础。

1.0.0-rc.2

1.0.0-rc.1

restore
-> build
-> test
-> publish
-> 从 publish 目录启动
-> 跑主流程
-> 更新文档和已知问题

release-candidate/
  app/
  README.md
  CHANGELOG.md
  KNOWN-ISSUES.md
  RELEASE-CHECKLIST.md
  sample-data/
    products-import.csv

dotnet build
dotnet publish -c Release -o ./release-candidate/app

dotnet publish -c Release -r osx-arm64 --self-contained true -o ./release-candidate/app-osx-arm64

# ProductApp 1.0.0-rc.1
 
## 第三部分：跟着准备发布候选
 
从这里开始动手。
 
### 第 1 步：确认版本号
 
先确定本次版本：
 
```text
1.0.0-rc.1

1.0.0-rc.2

dotnet build

dotnet publish -c Release -o ./release-candidate/app

release-candidate/
  app/
  README.md
  CHANGELOG.md
  KNOWN-ISSUES.md
  RELEASE-CHECKLIST.md
  sample-data/
    products-import.csv

可以进入测试。

需要修复后重新出 RC。

### CHANGELOG.md

```markdown
# CHANGELOG

## 1.0.0-rc.1 - 2026-06-12

### Added

- 新增商品管理主流程。
- 新增商品搜索和库存过滤。
- 新增 JSON 本地保存。
- 新增 CSV 导入导出。
- 新增角色权限检查。
- 新增审计日志。
- 新增设置页面。

### Fixed

- 修正空名称可以保存的问题。
- 修正价格不是数字时提示不清楚的问题。

### Notes

- 这是发布候选版本，不是最终正式版。

# Known Issues
 
## 1. CSV 不支持名称里包含英文逗号
 
影响：
商品名称如果包含英文逗号，当前导入器会把它拆成多列。
 
临时处理：
第一版导入文件中，商品名称不要包含英文逗号。
 
后续处理：
正式版前评估是否接入完整 CSV 解析库。
 
## 2. 当前没有安装包签名
 
影响：
部分系统可能提示应用来自未知开发者。
 
临时处理：
测试人员按内部测试流程启动。
 
后续处理：
正式发布前补签名和平台发布流程。

# Release Candidate Checklist
 
版本：1.0.0-rc.1
日期：2026-06-12
 
## 1. 构建检查
 
- [ ] `dotnet build` 通过。
- [ ] `dotnet publish -c Release` 通过。
- [ ] 发布目录存在。
- [ ] 主程序文件存在。
 
## 2. 启动检查
 
- [ ] 从发布目录启动程序。
- [ ] 主窗口能打开。
- [ ] 没有启动异常。
 
## 3. 商品主流程
 
- [ ] 能新增合法商品。
- [ ] 名称为空时不能保存。
- [ ] 价格不是数字时不能保存。
- [ ] 库存小于 0 时不能保存。
- [ ] 能编辑商品。
- [ ] 能删除商品。
- [ ] 删除前会检查权限。
 
## 4. 搜索过滤
 
- [ ] 空关键字显示全部商品。
- [ ] 输入关键字能过滤商品。
- [ ] 搜索忽略大小写。
- [ ] 仅显示有库存能过滤库存为 0 的商品。
- [ ] 无结果时有提示。
 
## 5. 文件功能
 
- [ ] JSON 保存成功。
- [ ] JSON 读取成功。
- [ ] CSV 导入成功行。
- [ ] CSV 错误行有原因。
- [ ] CSV 能导出成功数据。
 
## 6. 审计和设置
 
- [ ] 删除成功写审计。
- [ ] 权限拒绝写审计。
- [ ] 设置能保存。
- [ ] 设置能重新加载。
- [ ] 设置能恢复默认。
 
## 7. 结论
 
- [ ] 可以进入测试。
- [ ] 需要修复后重新出 RC。
 
结论说明：
填写本次验收结论。

<PropertyGroup>
    <Version>1.0.0-rc.1</Version>
    <AssemblyVersion>1.0.0.0</AssemblyVersion>
</PropertyGroup>

dotnet clean
dotnet restore
dotnet build -c Release
dotnet test -c Release

dotnet publish -c Release -r win-x64 --self-contained true \
  -o artifacts/1.0.0-rc.1

1. 什么是发布候选版本
2. RC 和最终发布有什么区别
3. 发布前为什么要冻结范围

- [ ] Release 构建成功
- [ ] 单元测试全部通过
- [ ] 目标电脑可启动
- [ ] 断网后有提示并可重连
- [ ] 配置和日志路径正确
- [ ] 升级后旧配置可读取

六项检查都完成才可交付

## 1.0.0-rc.1
- 新增设备总览和详情
- 新增报警确认与审计
- 新增点位 CSV 导入导出
- 已知问题: 趋势页仅保留 1000 点

用户和测试人员知道本版变化

string hash = Convert.ToHexString(
    SHA256.HashData(await File.ReadAllBytesAsync("Hmi.App.zip")));
Console.WriteLine(hash);

发布包有唯一 SHA256 校验值

dotnet build
dotnet publish -c Release -o ./release-candidate/app

release-candidate/
  app/
  README.md
  CHANGELOG.md
  KNOWN-ISSUES.md
  RELEASE-CHECKLIST.md
  sample-data/
    products-import.csv

# ProductApp 1.0.0-rc.1
 
## 运行方式
 
1. 解压发布包。
2. 进入 `app` 目录。
3. 启动 ProductApp。
 
如果是非自包含发布，目标电脑需要安装对应版本的 .NET Runtime。
 
## 本版包含功能
 
1. 商品列表。
2. 新增商品。
3. 编辑商品。
4. 删除商品。
5. 搜索和过滤商品。
6. JSON 本地保存。
7. CSV 导入导出。
8. 审计日志。
9. 设置保存。

# CHANGELOG
 
## 1.0.0-rc.1 - 2026-06-12
 
### Added
 
- 新增商品管理主流程。
- 新增搜索和过滤。
- 新增 JSON 保存。
- 新增 CSV 导入导出。
- 新增审计日志。
- 新增设置页面。
 
### Fixed
 
- 修正空名称保存问题。
- 修正错误价格提示不清楚的问题。
 
### Notes
 
- 这是发布候选版本，不是最终正式版。

# Known Issues
 
## CSV 不支持名称里包含英文逗号
 
影响：
商品名称如果包含英文逗号，当前导入器会把它拆成多列。
 
临时处理：
第一版导入文件中，商品名称不要包含英文逗号。
 
后续处理：
正式版前评估是否接入完整 CSV 解析库。

# Release Candidate Checklist
 
版本：1.0.0-rc.1
日期：2026-06-12
 
## 构建
 
- [ ] dotnet build 通过。
- [ ] dotnet publish -c Release 通过。
- [ ] 发布目录存在。
 
## 功能
 
- [ ] 能新增商品。
- [ ] 能编辑商品。
- [ ] 能删除商品。
- [ ] 能搜索商品。
- [ ] 无结果时有提示。
- [ ] 错误输入不会崩溃。
 
## 文件
 
- [ ] JSON 能保存和读取。
- [ ] CSV 能导入成功行。
- [ ] CSV 错误行有原因。
- [ ] 设置能保存和恢复默认。
 
## 结论
 
- [ ] 可以进入测试。
- [ ] 需要修复后重新出 RC。