Week 11 - 阶段检查

用户执行操作
-> PermissionService 检查权限
-> Service 执行业务规则
-> AuditLog 记录成功或失败
-> 导入导出按行返回结果
-> BackgroundTask 显示进度并支持取消
-> Settings 保存和恢复偏好
-> RC 清单判断是否能发布

给商品管理项目补上可靠性能力，让它不只是能用，还能控制、追踪、恢复、验收和交付。

using System;
using System.Collections.Generic;
using System.Linq;
 
var auditLogs = new List<string>();
 
TryDelete(Role.Viewer, "Alice", auditLogs);
TryDelete(Role.Admin, "Cindy", auditLogs);
 
Console.WriteLine("审计日志：");
 
foreach (string log in auditLogs)
{
    Console.WriteLine(log);
}
 
string[] csvLines =
{
    "Id,Name,Price,Stock",
    "1,Keyboard,199,10",
    "2,,59,30",
    "3,Monitor,abc,5",
    "4,Mouse,59,20"
};
 
ImportSummary importSummary = ImportProducts(csvLines);
Console.WriteLine($"导入成功：{importSummary.SuccessCount}");
Console.WriteLine($"导入失败：{importSummary.Errors.Count}");
 
foreach (string error in importSummary.Errors)
{
    Console.WriteLine(error);
}
 
AppSettings settings = NormalizeSettings(new AppSettings("Blue", 999, ""));
Console.WriteLine($"设置：Theme={settings.Theme}, PageSize={settings.PageSize}, DataPath={settings.DataPath}");
 
await RunBackgroundJobAsync(progress =>
{
    Console.WriteLine($"后台任务进度：{progress}%");
});
 
string[] releaseChecklist =
{
    "版本号已更新",
    "主流程已回归",
    "README 已写运行方式",
    "CHANGELOG 已写变更",
    "已知问题已记录"
};
 
Console.WriteLine("发布候选检查：");
 
foreach (string item in releaseChecklist)
{
    Console.WriteLine($"[x] {item}");
}
 
void TryDelete(Role role, string user, List<string> audit)
{
    if (role != Role.Admin)
    {
        audit.Add($"{DateTimeOffset.UtcNow:HH:mm:ss} {user} Product.Delete denied");
        Console.WriteLine($"{user} 没有删除权限。");
        return;
    }
 
    audit.Add($"{DateTimeOffset.UtcNow:HH:mm:ss} {user} Product.Delete success");
    Console.WriteLine($"{user} 删除成功。");
}
 
ImportSummary ImportProducts(IReadOnlyList<string> lines)
{
    int successCount = 0;
    var errors = new List<string>();
    var usedIds = new HashSet<int>();
 
    for (int index = 1; index < lines.Count; index++)
    {
        int lineNumber = index + 1;
        string line = lines[index];
        string[] parts = line.Split(',');
 
        if (parts.Length != 4)
        {
            errors.Add($"第 {lineNumber} 行：列数必须是 4。");
            continue;
        }
 
        if (!int.TryParse(parts[0], out int id))
        {
            errors.Add($"第 {lineNumber} 行：Id 必须是整数。");
            continue;
        }
 
        if (!usedIds.Add(id))
        {
            errors.Add($"第 {lineNumber} 行：Id 重复。");
            continue;
        }
 
        if (string.IsNullOrWhiteSpace(parts[1]))
        {
            errors.Add($"第 {lineNumber} 行：Name 不能为空。");
            continue;
        }
 
        if (!decimal.TryParse(parts[2], out decimal price) || price <= 0)
        {
            errors.Add($"第 {lineNumber} 行：Price 必须是大于 0 的数字。");
            continue;
        }
 
        if (!int.TryParse(parts[3], out int stock) || stock < 0)
        {
            errors.Add($"第 {lineNumber} 行：Stock 必须是大于或等于 0 的整数。");
            continue;
        }
 
        successCount++;
    }
 
    return new ImportSummary(successCount, errors);
}
 
AppSettings NormalizeSettings(AppSettings settings)
{
    string theme = settings.Theme is "Light" or "Dark"
        ? settings.Theme
        : "Light";
 
    int pageSize = settings.PageSize is >= 10 and <= 500
        ? settings.PageSize
        : 50;
 
    string dataPath = string.IsNullOrWhiteSpace(settings.DataPath)
        ? "products.json"
        : settings.DataPath;
 
    return new AppSettings(theme, pageSize, dataPath);
}
 
async Task RunBackgroundJobAsync(Action<int> reportProgress)
{
    for (int index = 1; index <= 5; index++)
    {
        await Task.Delay(80);
        reportProgress(index * 20);
    }
}
 
public enum Role
{
    Viewer,
    Admin
}
 
public sealed record ImportSummary(int SuccessCount, IReadOnlyList<string> Errors);
 
public sealed record AppSettings(string Theme, int PageSize, string DataPath);

dotnet new console -n Week11Checkpoint
cd Week11Checkpoint

dotnet run

Alice 没有删除权限。
Cindy 删除成功。
审计日志：
...
导入成功：2
导入失败：2
第 3 行：Name 不能为空。
第 4 行：Price 必须是大于 0 的数字。
设置：Theme=Light, PageSize=50, DataPath=products.json
后台任务进度：20%
后台任务进度：40%
后台任务进度：60%
后台任务进度：80%
后台任务进度：100%
发布候选检查：
[x] 版本号已更新
[x] 主流程已回归
[x] README 已写运行方式
[x] CHANGELOG 已写变更
[x] 已知问题已记录

1. 点击开始后进度条变化。
2. 任务运行时开始按钮禁用。
3. 任务运行时取消按钮启用。
4. 点击取消后任务停止。
5. 完成或取消后界面状态恢复。

1. 设置文件不存在时显示默认值。
2. 保存后生成 settings.json。
3. 重新加载能恢复保存值。
4. 非法页大小能提示或回退。
5. 恢复默认能回到 Light、50、products.json。

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