fastbee/docs/report-template-spec.md
2026-08-31 17:11:42 +08:00

502 lines
9.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# FastBee 设备监测报告模板设计规范
> 本文档定义各监测分类报告的专业内容结构,供 Word 模板 `.docx` 制作参考。
---
## 1. 裂缝计 (CRACK_METER)
### 专业物理量
- **裂缝宽度** (mm) - 主监测指标
- 裂缝变化量、变化速率
- 裂缝发展趋势(张开/闭合/稳定)
### 报告结构
```
一、监测设备信息
设备名称、设备编号、产品型号、安装位置
二、监测概况
统计周期:{{report.periodDesc}}
监测指标:裂缝宽度
数据采集频率:XX次/小时
三、裂缝宽度分析
当前裂缝宽度:{{analysis.statistics.current}} mm
初始裂缝宽度:{{analysis.statistics.initial}} mm
累计变化量:{{analysis.statistics.delta}} mm
变化速率:XX mm/天
四、极值统计
最大裂缝宽度:{{analysis.statistics.max}} mm
最小裂缝宽度:{{analysis.statistics.min}} mm
平均裂缝宽度:{{analysis.statistics.avg}} mm
五、趋势分析
{{analysis.trend.description}}
六、预警状态
预警等级:{{analysis.warning.status}}
{{analysis.warning.description}}
七、裂缝宽度时程曲线
{{@timeSeriesChart}}
八、分析结论
{{#conclusions}}{{seq}}. {{text}}{{/conclusions}}
```
---
## 2. 深部位移 (DEEP_DISPLACEMENT)
### 专业物理量
- **深部水平位移** (mm) - 主监测指标
- 位移方向(X/Y方向)
- 位移速率、累计位移量
- 滑移面位置识别
### 报告结构
```
一、监测设备信息
二、监测概况
监测指标:深部水平位移
监测深度范围:XXm ~ XXm
三、深部位移分析
当前位移量:XX mm
累计位移量:XX mm
位移方向:X向/Y向
位移速率:XX mm/天
四、极值统计
最大位移:XX mm
最小位移:XX mm
平均位移:XX mm
五、趋势分析
位移趋势(向坡体方向/背离坡体方向/稳定)
六、预警状态
七、深部位移时程曲线
八、分析结论
```
---
## 3. 轴力/应力 (AXIAL_FORCE)
### 专业物理量
- **轴力** (kN) 或 **应力** (MPa)
- 拉力/压力状态
- 轴力变化速率
- 锚索/钢筋受力状态
### 报告结构
```
一、监测设备信息
二、监测概况
监测指标:轴力/应力
构件类型:锚索/钢筋/钢支撑
三、轴力分析
当前轴力:XX kN
初始轴力:XX kN
轴力变化量:XX kN
轴力变化速率:XX kN/天
受力状态:受拉/受压
四、极值统计
最大轴力:XX kN
最小轴力:XX kN
平均轴力:XX kN
五、趋势分析
轴力变化趋势(增大/减小/稳定)
六、预警状态
七、轴力时程曲线
八、分析结论
```
---
## 4. 静力水准 (STATIC_LEVEL)
### 专业物理量
- **高程变化** (mm)
- **沉降量** (mm) - 主监测指标
- 沉降速率
- 不均匀沉降
### 报告结构
```
一、监测设备信息
二、监测概况
监测指标:高程/沉降
基准点信息
三、沉降分析
当前高程:XX m
初始高程:XX m
累计沉降量:XX mm
沉降速率:XX mm/天
四、极值统计
最大沉降:XX mm
最小沉降:XX mm
平均沉降:XX mm
五、趋势分析
沉降趋势(持续下沉/回弹/稳定)
六、预警状态
七、沉降时程曲线
八、分析结论
```
---
## 5. 振弦 (VIBRATING_WIRE)
### 专业物理量
- **频率** (Hz) - 原始测量值
- **温度** (℃) - 补偿参数
- **物理量** (应力/应变/压力等) - 计算值
- 频率-物理量转换公式
### 报告结构
```
一、监测设备信息
二、监测概况
监测指标:振弦频率/温度
振弦类型:钢筋计/渗压计/应变计
三、频率分析
当前频率:XX Hz
初始频率:XX Hz
频率变化量:XX Hz
四、温度补偿
当前温度:XX ℃
温度修正系数
五、物理量计算
计算物理量:XX (单位)
计算公式说明
六、趋势分析
七、频率时程曲线
八、分析结论
```
---
## 6. 应变计 (STRAIN_GAUGE)
### 专业物理量
- **应变** (με, 微应变)
- 应变速率
- 拉/压应变状态
- 徐变分析
### 报告结构
```
一、监测设备信息
二、监测概况
监测指标:应变
材料类型:混凝土/钢结构
三、应变分析
当前应变:XX με
初始应变:XX με
累计应变:XX με
应变速率:XX με/天
应变状态:拉应变/压应变
四、极值统计
最大应变:XX με
最小应变:XX με
平均应变:XX με
五、趋势分析
应变发展趋势
六、预警状态
七、应变时程曲线
八、分析结论
```
---
## 7. 水位计 (WATER_LEVEL)
### 专业物理量
- **水位** (m) - 主监测指标
- 水位变化速率
- 最高/最低水位
- 水位波动幅度
### 报告结构
```
一、监测设备信息
二、监测概况
监测指标:水位
监测点位:地下水位/河道水位/水库水位
三、水位分析
当前水位:XX m
初始水位:XX m
水位变化量:XX m
水位变化速率:XX m/天
四、极值统计
最高水位:XX m
最低水位:XX m
平均水位:XX m
水位波动幅度:XX m
五、趋势分析
水位变化趋势(上升/下降/稳定)
六、预警状态
七、水位时程曲线
八、分析结论
```
---
## 8. 测距仪 (RANGING_METER)
### 专业物理量
- **距离** (mm 或 m)
- 距离变化量
- 变化速率
- 相对位移
### 报告结构
```
一、监测设备信息
二、监测概况
监测指标:距离
监测对象:裂缝宽度/结构变形/位移监测
三、距离分析
当前距离:XX mm
初始距离:XX mm
距离变化量:XX mm
变化速率:XX mm/天
四、极值统计
最大距离:XX mm
最小距离:XX mm
平均距离:XX mm
五、趋势分析
距离变化趋势(增大/减小/稳定)
六、预警状态
七、距离时程曲线
八、分析结论
```
---
## 9. 倾角计 (INCLINOMETER)
### 专业物理量
- **倾角** (° 或 ′)
- X轴倾角、Y轴倾角
- 倾角变化速率
- 倾斜方向
### 报告结构
```
一、监测设备信息
二、监测概况
监测指标:倾角
监测方向:X轴倾角/Y轴倾角/综合倾角
三、倾角分析
当前倾角:XX°
初始倾角:XX°
倾角变化量:XX°
倾角变化速率:XX°/天
倾斜方向:XX方向
四、极值统计
最大倾角:XX°
最小倾角:XX°
平均倾角:XX°
五、趋势分析
倾斜发展趋势
六、预警状态
七、倾角时程曲线
八、分析结论
```
---
## 10. 温度计 (THERMOMETER)
### 专业物理量
- **温度** (℃)
- 最高/最低温度
- 温度变化速率
- 温差(日温差/周期温差)
### 报告结构
```
一、监测设备信息
二、监测概况
监测指标:温度
监测环境:结构温度/环境温度/水温
三、温度分析
当前温度:XX ℃
初始温度:XX ℃
温度变化量:XX ℃
温度变化速率:XX ℃/天
四、极值统计
最高温度:XX ℃
最低温度:XX ℃
平均温度:XX ℃
温差:XX ℃
五、趋势分析
温度变化趋势
六、预警状态
七、温度时程曲线
八、分析结论
```
---
## 11. 雨量计 (RAIN_GAUGE)
### 专业物理量
- **降雨量** (mm)
- 累计降雨量
- 降雨强度 (mm/h)
- 最大小时降雨量
### 报告结构
```
一、监测设备信息
二、监测概况
监测指标:降雨量
监测点位信息
三、降雨量分析
累计降雨量:XX mm
当前降雨强度:XX mm/h
降雨时长:XX 小时
四、极值统计
最大降雨量:XX mm
最大小时降雨:XX mm/h
平均降雨量:XX mm
五、趋势分析
降雨趋势(增强/减弱/停止)
六、预警状态
七、降雨量时程曲线
八、分析结论
```
---
## 模板占位符规范
所有模板统一使用以下占位符:
| 占位符 | 说明 |
|---|---|
| `{{report.no}}` | 报告编号 |
| `{{report.periodDesc}}` | 统计周期描述 |
| `{{report.generatedAt}}` | 生成时间 |
| `{{device.name}}` | 设备名称 |
| `{{device.serialNumber}}` | 设备编号 |
| `{{device.productName}}` | 产品型号 |
| `{{device.metricName}}` | 主监测指标名称 |
| `{{device.metricUnit}}` | 单位 |
| `{{analysis.statistics.current}}` | 当前值 |
| `{{analysis.statistics.initial}}` | 初始值 |
| `{{analysis.statistics.delta}}` | 变化量 |
| `{{analysis.statistics.max}}` | 最大值 |
| `{{analysis.statistics.min}}` | 最小值 |
| `{{analysis.statistics.avg}}` | 平均值 |
| `{{analysis.trend.description}}` | 趋势描述 |
| `{{analysis.warning.status}}` | 预警状态 |
| `{{analysis.warning.description}}` | 预警描述 |
| `{{#conclusions}}{{seq}}. {{text}}{{/conclusions}}` | 结论列表 |
| `{{@timeSeriesChart}}` | 时程曲线图 |
---
## 模板制作指南
1. **文件命名**:`DEVICE_{CATEGORY_NAME}_V1.docx`
2. **存放路径**:`fastbee-report/src/main/resources/templates/`
3. **格式要求**:
- 使用 poi-tl 语法 `{{变量名}}` 标记占位符
- 列表使用 `{{#list}}{{item}}{{/list}}`
- 图片使用 `{{@imageVar}}`
4. **样式要求**:
- 标题使用 Word 内置样式(标题1/标题2/标题3)
- 表格使用标准表格样式
- 图表占位符预留足够空间
---
## 更新记录
| 日期 | 版本 | 修改内容 |
|---|---|---|
| 2026-08-23 | V1 | 初始版本,定义11种监测分类报告结构 |