docs: clear task and layer shorthand IDs

Replace task/batch shorthand IDs and residual layer labels in
human-facing docs with semantic phrases. Add the new cleanup
policy to docs/编号规范.md and update the entry docs.

Machine keys (TC/CODE-RULE/MENU-STATE/TRAP/FR), hardware
designators/pins/MAC, protocol/version numbers and frozen
historical evidence are intentionally kept.

Docs only; no code behavior change. Verified with
check_doc_links.py --all and git diff --check.
This commit is contained in:
2026-11-02 03:33:51 +08:00
parent f81bb38b64
commit 72b4b0943c
35 changed files with 188 additions and 167 deletions
+8 -8
View File
@@ -21,7 +21,7 @@
| USART1 | 串口 | PA9 TX, PA10 RX | 115200bps 调试串口 |
| SD2506 RTC | I2C1 | PB6 SCL, PB7 SDA | 墙钟基准与日志时间戳 |
| 6x LED | GPIO | PC5, PB0, PB1, PB2, PF11, PF12 | 低电平点亮 |
| RS-485 | UART4 | PC10 TX, PC11 RX, PA15 DE | 半双工通信(B2 暂缓,见 `docs/任务规划/暂缓-RS485.md`) |
| RS-485 | UART4 | PC10 TX, PC11 RX, PA15 DE | 半双工通信(暂缓,见 `docs/任务规划/暂缓-RS485.md`) |
| SWD | — | PA13 SWDIO, PA14 SWCLK | 调试口 CN2(XH-3A) |
## 项目架构
@@ -30,19 +30,19 @@
flowchart TB
subgraph APP["应用层 (App/)"]
direction LR
A1["app/app_main.c"] ~~~ A2["task/net_task.c"] ~~~ A3["task/ui_task.c"] ~~~ A4["sync/time_sync.c"] ~~~ A5["algo/(语义取数与有效性~保护判据)"]
APPMAIN["app/app_main.c"] ~~~ NETTASK["task/net_task.c"] ~~~ UITASK["task/ui_task.c"] ~~~ TIMESYNC["sync/time_sync.c"] ~~~ ALGO["algo/(语义取数与有效性~保护判据)"]
end
subgraph BSP["驱动层 (Drivers/BSP/)"]
direction LR
B1["CH395F"] ~~~ B2["GD5F2GQ5UE"] ~~~ B3["TPAFE5160"] ~~~ B4["SD2506"] ~~~ B5["RS485"] ~~~ B6["UI"]
ETH["CH395F"] ~~~ NAND["GD5F2GQ5UE"] ~~~ ADC["TPAFE5160"] ~~~ RTC["SD2506"] ~~~ RS485["RS485"] ~~~ UI["UI"]
end
subgraph MW["中间件 (Middlewares/ & Lib/)"]
direction LR
C1["FreeRTOS"] ~~~ C2["FatFs"] ~~~ C3["dhara FTL"] ~~~ C4["LVGL"]
FREERTOS["FreeRTOS"] ~~~ FATFS["FatFs"] ~~~ DHARA["dhara FTL"] ~~~ LVGL["LVGL"]
end
subgraph HAL["HAL 层 / CMSIS"]
direction LR
D1["STM32F4xx_HAL_Driver/"] ~~~ D2["CMSIS/"]
HALDRV["STM32F4xx_HAL_Driver/"] ~~~ CMSIS["CMSIS/"]
end
HW["硬件 (STM32F407ZGTx)"]
APP --> BSP --> MW --> HAL --> HW
@@ -85,7 +85,7 @@ main.c
| timeSyncTask | 640 words | Normal | 墙钟时间同步 |
| adcTask | 640 words | AboveNormal | TPAFE5160 采样(TIM3 1kHz 事件驱动 + 原子快照 + STM32 ADC DMA,纯消费者) |
| iec104Task | 640 words | Normal | IEC 60870-5-104 上行(工厂默认 :2404 监听,遥信/遥测/定值区) |
| protectTask | 512 words | Normal | 保护判据 20ms 节拍(保护判据元件 + 采样故障闭锁,B5) |
| protectTask | 512 words | Normal | 保护判据 20ms 节拍(保护判据元件 + 采样故障闭锁) |
<!-- TASK_TABLE:END -->
> 上表与 `Src/freertos.c` 的 `osThreadAttr_t` 一致(2026-10-14 校准,9 任务);改动栈大小前先读
@@ -131,7 +131,7 @@ STM32F4-Base/
│ │ ├── adc_task.c/h # ADC 任务(语义取数与有效性/全周傅氏相量纯消费者,TIM3 1kHz 唤醒)
│ │ ├── iec104_serv.c/h # IEC 60870-5-104 上行服务
│ │ ├── protect_task.c/h # 保护判据任务(保护判据 20ms 节拍)
│ │ └── rs485_task.c/h # RS-485 任务(已实现,未创建,B2 暂缓)
│ │ └── rs485_task.c/h # RS-485 任务(已实现,未创建,暂缓)
│ ├── util/ # 工具函数(crc / ringbuf / sys_clock)
│ └── protocol/ # 通信协议(预留)
├── Drivers/
@@ -421,7 +421,7 @@ pre-commit run --all-files
| `docs/网络/BSD_Socket_API_使用指南.md` | BSD Socket API 使用指南(`net_socket` / `net_select`:线程安全 / 快速开始 / TCP / UDP / I/O 多路复用 / 事件回调 / API 参考 / 常见问题) |
| `docs/网络/Net层阻塞模型架构设计.md` | NET 阻塞模型(挂起请求表五路语义,recv 一期 / SEND 二期已落地) |
| `docs/网络/网络自愈架构设计.md` | 网络自愈架构(监听重建 / 沉降隔离 / 周期对账) |
| `docs/子系统设计/IEC104上行设计说明.md` | IEC 60870-5-104 上行(工厂默认 :2404 监听,B4) |
| `docs/子系统设计/IEC104上行设计说明.md` | IEC 60870-5-104 上行(工厂默认 :2404 监听) |
| `docs/子系统设计/ADC采样节拍设计说明.md` | TIM3 1kHz 采样节拍(两片转换器同源硬件驱动) |
| `docs/UI设计/UI_设计架构.md` | LVGL UI 系统架构(菜单 / 内容页 / 内存预算) |
| `docs/UI设计/菜单页面设计.md` | 菜单导航行为、数据流与内容页设计 |