Browse Source

docs(domain):定义供水工单和告警归属

Kazerin 2 tuần trước cách đây
mục cha
commit
e1d198c784

+ 10 - 0
CONTEXT-MAP.md

@@ -0,0 +1,10 @@
+# Context Map
+
+## Contexts
+
+- [管网业务服务](./pipe-network-service/CONTEXT.md):承载城市生命线中的管网业务;当前已建模供水安全运行监测领域,其他领域按需补充。
+
+## Relationships
+
+- **供水设施与监测设备**:供水设施描述供水系统中的业务对象;监测设备负责采集运行数据,两者不是同一概念。
+- **报警记录、设备报警状态与工单处置**:设备自动报警时生成报警记录并进入报警状态;人工可派发故障维修工单,但设备报警状态由运行系统根据有效报警原因自动维护。

+ 97 - 0
pipe-network-service/CONTEXT.md

@@ -0,0 +1,97 @@
+# 管网业务服务
+
+该上下文承载城市生命线中的管网业务。当前词汇表聚焦供水安全运行监测,覆盖供水设施、监测设备、监测报警和工单处置。
+
+## 供水设施
+
+**供水设施**:
+构成供水系统并被登记、查询、统计或在地图上展示的业务对象,包括水源地、水厂、泵站、供水管线和用水户。
+_Avoid_:把监测设备统称为供水设施
+
+**水源地**:
+为供水系统提供原水的来源地。
+_Avoid_:水源、水源点
+
+**水厂**:
+对原水进行处理并形成可供给用水户水量的生产设施。
+_Avoid_:供水厂、制水厂
+
+**泵站**:
+通过水泵为供水过程提供输送或增压能力的设施。
+_Avoid_:加压站
+
+**供水管线**:
+连接供水设施并输送水的线性设施。
+_Avoid_:管网、管道(指单条设施时)
+
+**用水户**:
+接受供水服务的居民、工业、商业或行政事业主体。
+_Avoid_:大用水户(除非明确指满足特定用水量或重要性标准的子集)、用户
+
+## 运行监测
+
+**监测设备**:
+用于采集供水运行数据的设备,例如水位、压力或流量监测设备;它与被监测的供水设施是不同业务对象。
+_Avoid_:供水设施、监测点(指设备本身时)
+
+**设备异常**:
+监测设备当前处于报警或维修状态的统称,可由一个或多个报警记录或处置过程造成。
+_Avoid_:报警记录(指一次事件时)、故障(原因尚未确认时)
+
+**设备报警状态**:
+表示监测设备当前是否处于报警中的设备级状态;`0` 表示正常,`1` 表示报警,是判断设备当前是否报警的主要依据,由运行系统根据设备的有效报警原因自动维护。
+_Avoid_:报警记录状态、工单状态
+
+**有效报警原因**:
+当前仍满足报警条件、尚未自行恢复的设备异常原因;同一设备可以同时存在多个有效报警原因。
+_Avoid_:报警记录、未结工单
+
+**报警记录**:
+设备因阈值越界或其他自动报警原因而产生的一次事件记录,用于保留报警事实和历史,不作为设备当前是否报警的主要依据。
+_Avoid_:设备报警状态、设备异常
+
+**报警记录状态**:
+表示单条报警记录是否已经人工处置的辅助状态;它不决定设备当前是否处于报警中。
+_Avoid_:设备报警状态
+
+**报警恢复**:
+某个有效报警原因不再满足报警条件的结果,可由实时监测数据、上游恢复事件或有权限人员的人工确认产生。
+_Avoid_:报警记录已处理、工单结案
+
+**清警复核**:
+汇总检查设备是否仍有有效报警原因的活动;报警恢复或工单结案可以触发复核,但只有不存在有效报警原因时才允许清警。
+_Avoid_:直接清警、工单验收
+
+**自动清警**:
+运行系统确认设备的所有有效报警原因均已消除后,将设备报警状态从报警恢复为正常;任一报警原因仍有效时不得清警。
+_Avoid_:工单结案、报警记录已处理
+
+## 工单处置
+
+**工单**:
+对设备故障、日常巡检或设备保养进行分派、执行和跟踪的统一处置载体。
+_Avoid_:维修任务、报警工单(作为独立于工单的概念)
+
+**故障维修工单**:
+用于核实并修复设备故障的工单,工单类型为 `1`;由设备维修需求或监测报警转入的处置都属于此类型。
+_Avoid_:维修任务、报警工单
+
+**工单派发**:
+用户针对报警或异常设备创建故障维修工单并指定后续处置责任人的活动;可从设备维修派单、设备异常管理或报警管理入口发起。
+_Avoid_:报警处理、报警审核
+
+**工单处置**:
+被派单人员对工单执行接收、处理、提交验收和结案等后续活动;工单进度不直接决定设备报警状态,也不阻止设备满足恢复条件时自动清警。
+_Avoid_:报警审核(指工单后续操作时)、报警记录已处理
+
+**工单验收**:
+对工单处置结果是否满足要求进行确认的活动;验收通过可以使工单结案,但不直接清除设备报警状态。
+_Avoid_:报警审核、自动清警
+
+**日常巡检工单**:
+用于执行计划内或临时巡查的工单,工单类型为 `2`。
+_Avoid_:巡检任务
+
+**设备保养工单**:
+用于执行设备预防性保养的工单,工单类型为 `3`。
+_Avoid_:保养任务、维修工单

+ 7 - 0
pipe-network-service/docs/adr/0001-unify-device-work-under-work-orders.md

@@ -0,0 +1,7 @@
+---
+status: accepted
+---
+
+# Unify device work under work orders
+
+Use the work order as the single lifecycle for device fault repair, routine inspection, and preventive maintenance, distinguished by order types `1`, `2`, and `3`. Device repair requests and alarm-driven dispatches are both fault repair work orders (`1`); they must not evolve as separate maintenance-task or alarm-order lifecycles because parallel workflows produce inconsistent assignment, processing, and acceptance states.

+ 7 - 0
pipe-network-service/docs/adr/0002-runtime-owns-device-alarm-state.md

@@ -0,0 +1,7 @@
+---
+status: accepted
+---
+
+# Runtime owns device alarm state
+
+The runtime monitoring system is the authority for a device's alarm state: it sets the device to alarming while any effective alarm cause remains and clears it only after all causes recover through monitoring data, an upstream recovery event, or an authorized manual confirmation. Work order completion may trigger a fresh evaluation but must never clear the device unconditionally, and an alarm record's handled state does not determine the device's current alarm state.