Day 7 - 复盘与下一步

第一天学了变量。
第二天学了判断。
第三天学了循环。

遇到列表数据，用 List 保存，用 LINQ 搜索和筛选。
遇到保存失败，用 try/catch 捕获异常，用日志记录原因。
遇到界面按钮，用 Command 连接 ViewModel 方法。

Avalonia 界面 -> ViewModel -> 采集服务 -> 协议驱动 -> 真实设备

dotnet new console -n LearningReview
cd LearningReview

using System;
using System.Collections.Generic;
using System.Linq;
 
List<SkillItem> skills = new()
{
    new(
        "C# 基础",
        "变量、类型、判断、循环、方法",
        "能写输入、处理、输出这条最小流程",
        "写一个商品总价计算程序"),
    new(
        "面向对象",
        "类、对象、属性、接口、泛型",
        "能把商品、订单、用户这些概念写成清楚的代码结构",
        "写 Product、IProductRepository、ProductService"),
    new(
        "数据处理",
        "集合、LINQ、文件、JSON",
        "能保存多条数据、搜索数据、把数据写入文件",
        "写商品搜索和 JSON 保存"),
    new(
        "错误处理",
        "异常、边界条件、日志",
        "能在输入错误、文件失败时给出明确处理",
        "写商品校验和保存失败日志"),
    new(
        "异步和任务",
        "async、await、Task、取消操作",
        "能处理耗时操作，不让界面卡住",
        "写导入 CSV 的后台任务"),
    new(
        "Avalonia MVVM",
        "XAML、Binding、Command、ViewModel",
        "能做桌面端列表、表单、按钮操作",
        "写商品管理主窗口"),
    new(
        "项目交付",
        "测试、文档、版本、发布、验收",
        "能把项目整理成可交付版本",
        "写测试、README、发布说明和验收清单")
};
 
List<NextPractice> practices = new()
{
    new(1, "重做设备管理页面", "不看旧代码，重新完成设备新增、编辑、删除、搜索和保存"),
    new(2, "学习串口通信", "掌握字节、十六进制、帧边界和 SerialPort"),
    new(3, "学习 TCP 与 UDP", "掌握连接、收发、拆包、心跳和重连"),
    new(4, "学习 Modbus", "读写线圈和寄存器，处理地址、字序和缩放"),
    new(5, "学习 OPC UA", "连接、浏览、读写和订阅设备节点")
};
 
static void PrintTitle(string title)
{
    Console.WriteLine();
    Console.WriteLine("==== " + title + " ====");
}
 
static void PrintSkills(IEnumerable<SkillItem> skills)
{
    foreach (SkillItem skill in skills)
    {
        Console.WriteLine($"模块：{skill.Area}");
        Console.WriteLine($"内容：{skill.Content}");
        Console.WriteLine($"作用：{skill.Value}");
        Console.WriteLine($"练习：{skill.Practice}");
        Console.WriteLine();
    }
}
 
static void PrintPractices(IEnumerable<NextPractice> practices)
{
    foreach (NextPractice practice in practices.OrderBy(item => item.Order))
    {
        Console.WriteLine($"{practice.Order}. {practice.Name}");
        Console.WriteLine($"   目标：{practice.Goal}");
    }
}
 
PrintTitle("12 周能力复盘");
PrintSkills(skills);
 
PrintTitle("下一步练习路线");
PrintPractices(practices);
 
PrintTitle("复盘结论");
Console.WriteLine("如果能独立重做 Avalonia 设备管理项目，并能解释每一层代码放在哪里，就进入 Week 13 的串口与字节学习。");
 
 
 
 
public sealed record SkillItem(
    string Area,
    string Content,
    string Value,
    string Practice);
 
public sealed record NextPractice(
    int Order,
    string Name,
    string Goal);

dotnet run

public decimal CalculateTotal(decimal price, int count)
{
    if (price < 0 || count < 0)
        throw new ArgumentOutOfRangeException();
 
    return price * count;
}

string json = JsonSerializer.Serialize(products);
await File.WriteAllTextAsync("products.json", json);

[RelayCommand]
private async Task SaveAsync()
{
    await _service.SaveAsync(Products);
    StatusMessage = "保存成功";
}

1. 把 12 周内容整理成一张能力地图
2. 判断哪些知识能继续用于桌面端和 Web
3. 用一个控制台程序复盘已学模块

1. SerialPort 串口收发
2. TcpClient TCP 通信
3. Modbus RTU/TCP 协议
4. SQLite 历史数据
5. 趋势图与报警统计
6. 真实设备联调

路线从通信到数据再到现场联调

public interface IDeviceClient
{
    Task ConnectAsync(CancellationToken token);
    Task<ushort[]> ReadRegistersAsync(int address, int count, CancellationToken token);
    Task DisconnectAsync();
}

串口或 Modbus 实现遵守同一通信边界

我能独立完成:
[ ] C# 模型与业务规则
[ ] async/await 与取消
[ ] Avalonia 布局与 MVVM
[ ] 配置、日志、测试与发布
[ ] 上位机项目分层
[ ] 故障定位和验收

勾选结果决定下一轮复习重点

# 12 周学习复盘
 
## 1. 已经学过的基础能力
 
### C# 基础
 
- 变量和类型：能保存名称、价格、库存、状态。
- 判断和循环：能做输入校验、列表遍历、条件分支。
- 方法：能把重复逻辑拆出去。
- 类和对象：能把商品、订单、用户这些业务概念变成代码。
- 接口：能把“怎么保存”从业务逻辑里抽出来。
- 泛型：能使用 `List<T>`、`ObservableCollection<T>`、`IEnumerable<T>`。
 
### 数据处理
 
- 集合：能保存多条商品数据。
- LINQ：能搜索、筛选、排序。
- 文件：能读写本地文件。
- JSON：能保存和加载结构化数据。
- CSV：能导入和导出表格数据。
 
### 程序可靠性
 
- 异常处理：能处理输入错误、文件失败、保存失败。
- 日志：能记录关键操作和错误原因。
- 测试：能用 xUnit 验证业务规则。
- 边界条件：能处理空值、重复、负数、格式错误。
 
### 异步和并发基础
 
- `Task`：能表示一个异步操作。
- `async/await`：能等待耗时操作完成。
- 取消操作：能用取消令牌停止后台任务。
- 线程概念：知道耗时任务不应该卡住界面线程。
 
## 2. 能做的项目能力
 
- 能做一个 Avalonia 商品管理桌面应用。
- 能用 MVVM 分离界面和逻辑。
- 能把商品数据保存到 JSON。
- 能做搜索、筛选、编辑、删除。
- 能处理保存失败和输入错误。
- 能写 README、用户手册、排错文档。
- 能生成 Release 发布目录。
- 能写验收清单和交付说明。
 
## 3. 还需要继续练的方向
 
- 串口：字节、十六进制、报文、校验和异步收发。
- TCP/UDP：连接、拆包、心跳、超时和重连。
- Modbus：线圈、寄存器、地址、字序和缩放。
- OPC UA：节点、读写、订阅、质量码和证书。
- 采集与数据库：队列、缓存、SQLite 和历史查询。
- 工业功能：趋势、报警、联锁、诊断和现场交付。
 
## 4. Week 13-16 学习计划
 
### Week 13：串口与字节
 
目标：
 
- 学会 bit、byte 和十六进制。
- 学会编码、大小端和报文边界。
- 使用 SerialPort 异步收发。
- 完成 Avalonia 串口调试助手。
 
### Week 14：TCP 与 UDP
 
目标：
 
- 使用 TcpClient 连接、发送和接收。
- 正确处理粘包和半包。
- 增加心跳、超时和重连。
- 完成 Avalonia 网络调试助手。
 
### Week 15：Modbus RTU / TCP
 
目标：
 
- 读写线圈、离散输入和寄存器。
- 处理地址偏移、大小端和比例。
- 区分 RTU CRC 与 TCP MBAP。
- 完成 Avalonia Modbus 监控器。
 
### Week 16：OPC UA
 
目标：
 
- 连接 OPC UA 测试服务器。
- 浏览节点并保存点位配置。
- 读取、写入和订阅数据。
- 处理质量码、证书和断线重连。