coordinate.js 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293
  1. /**
  2. * 坐标准入与「无地图位置」(票 07)。
  3. *
  4. * 权威判据在后端,不在前端。后端 `CockpitCoordinateValidator.validate()` 已经给出结论:
  5. * `state` = `VALID` | `INVALID` | `UNVERIFIED`,`reason` 七取一,`renderable` 是布尔结论。
  6. * (2026-10-12 起后端取消人工校核前置,准入改为自动判定:结构合法 + 落在主场景区内,
  7. * 新增 `OUTSIDE_PRIMARY_AREA`;`UNVERIFIED` 仅存在于历史快照与「后端未给校验段」的防御路径。)
  8. * 本文件**只消费这个结论**,绝不自己再查一遍经纬度范围 —— 票 07 的验收原句是
  9. * 「前端不自动纠偏、不使用默认坐标」;重算一遍既会与后端分歧,也正是「纠偏」的入口。
  10. * 唯一的准入判据因此是 `renderable === true`(票 09/22 的渲染必须走 `isRenderable()`)。
  11. *
  12. * 另一条纪律沿用票 05:**内部原因码不上界面**。`data-*` 上留 `reason` 原码供走查断言,
  13. * 给人看的只有中文文案;认不出的原因宁可只说「无地图位置」,也不把 `LONGITUDE_OUT_OF_RANGE`
  14. * 甩给值班人员。
  15. *
  16. * reason 词表照抄后端 `CockpitCoordinateValidator`(E:\pipe-ner-server,六个取值),
  17. * 保证「文案」与「后端结论」一一对应,而不是前端猜一套。
  18. */
  19. import { isPlainObject } from './fields.js'
  20. /** 后端坐标校验三态(`CockpitCoordinateValidation.state`)。 */
  21. export const COORDINATE_STATE = {
  22. VALID: 'VALID',
  23. INVALID: 'INVALID',
  24. UNVERIFIED: 'UNVERIFIED',
  25. }
  26. /**
  27. * 后端 reason 原码 → 中文文案。词表与后端 `CockpitCoordinateValidator` 一一对应。
  28. *
  29. * 2026-10-12:后端取消无入口的人工校核前置,改为「结构合法 + 落在主场景区内」自动准入,
  30. * 因此新增 `OUTSIDE_PRIMARY_AREA`(区外不上图,但坐标保留、对象仍在清单里)。
  31. * `UNVERIFIED_COORDINATE` 保留在词表中:它是历史快照与「后端未给校验段」防御路径的文案,
  32. * 不再是新数据的常态结论。
  33. */
  34. export const COORDINATE_REASON_TEXT = {
  35. UNVERIFIED_COORDINATE: '坐标未经校验',
  36. MISSING_LONGITUDE: '缺少经度',
  37. MISSING_LATITUDE: '缺少纬度',
  38. LONGITUDE_OUT_OF_RANGE: '经度超出合法范围',
  39. LATITUDE_OUT_OF_RANGE: '纬度超出合法范围',
  40. ZERO_COORDINATE: '零坐标(经纬度均为 0)',
  41. OUTSIDE_PRIMARY_AREA: '不在主场景区范围内',
  42. }
  43. /** 认不出原因时的统一文案(票 07 验收原句点名的那一个)。 */
  44. export const NO_MAP_LOCATION_TEXT = '无地图位置'
  45. /** 后端整段没给 `coordinateValidation` 时的文案(票 05 的 `validated:false`)。 */
  46. export const UNVALIDATED_TEXT = '坐标未校验'
  47. /**
  48. * 唯一准入判据:**只认后端 `renderable`**,不看经纬度数值、不看 state。
  49. *
  50. * 为什么连 `state === 'VALID'` 都不作为备选判据:那是第二套判据,一旦与 `renderable` 分歧
  51. * (后端将来加了新 state),两个答案必然有一个是错的,而错的会画到地图上。
  52. * @param {object} item 地图对象(`domain/mapSummary.js` 的形状)
  53. */
  54. export function isRenderable(item) {
  55. const coordinate = (item && item.coordinate) || null
  56. return !!coordinate && coordinate.renderable === true
  57. }
  58. /**
  59. * 某个编码的**坐标准入结论**(票 41:界面只读它,不自己调判据)。
  60. *
  61. * 三种情形必须分得开 —— 这是「无地图位置」最容易骗人的地方:
  62. * · `present:false` —— 该编码**不在已加载快照里**(分页没翻到 / 引擎未就绪):
  63. * 这是"暂时无法确认",**不是**无地图位置;界面应走暂隐并保留选择,
  64. * 绝不能显示一张"无地图位置"的固定详情去冒充结论;
  65. * · `present:true, renderable:false` —— 后端判定不可上图:带中文原因,走固定详情;
  66. * · `present:true, renderable:true` —— 可上图,走锚定跟随。
  67. *
  68. * 为什么单独成纯函数而不是写在 store 里:它是界面可见行为的判据(固定详情 vs 暂隐),
  69. * 必须能脱浏览器断言(本仓成例:判定收进 domain,store 只持有状态)。
  70. * @param {Array} objects 已加载的地图对象
  71. * @param {string} code 对象编码
  72. */
  73. export function locationVerdict(objects, code) {
  74. const wanted = typeof code === 'string' ? code.trim() : ''
  75. const found = wanted ? (Array.isArray(objects) ? objects : []).find((item) => item && item.code === wanted) : null
  76. if (!found) return { present: false, renderable: false, reasonText: '' }
  77. const renderable = isRenderable(found)
  78. return { present: true, renderable, reasonText: renderable ? '' : blockReason(found).text }
  79. }
  80. /**
  81. * 对象不上图的原因(给界面看)。
  82. *
  83. * 三层,按票 07 的裁定:
  84. * 1. 后端整段没给校验结果(`validated:false`)→「坐标未校验」——这是「缺失」,不是「非法」;
  85. * 2. reason 命中后端词表 → 具体原因(缺少经度 / 超范围 / 零坐标 …);
  86. * 3. 其余认不出 →「无地图位置」,不泄露原因码。
  87. * @param {object} item 地图对象
  88. * @returns {{code: string, text: string}} `code` 仅用于 `data-*` 与断言,不上界面
  89. */
  90. export function blockReason(item) {
  91. const coordinate = (item && item.coordinate) || {}
  92. if (!coordinate.validated) {
  93. return { code: '', text: UNVALIDATED_TEXT }
  94. }
  95. const code = coordinate.reason || ''
  96. const text = COORDINATE_REASON_TEXT[code]
  97. if (text) return { code, text }
  98. return { code, text: NO_MAP_LOCATION_TEXT }
  99. }
  100. /**
  101. * 按坐标准入把对象切成两堆(票 07 验收第 1 条)。
  102. *
  103. * **两堆都要交出去**:不上图 ≠ 不存在。对象必须仍在列表与详情里可见(`blocked` 就是给列表用的),
  104. * 静默丢掉才是票 07 明确禁止的(CONTEXT.md「无地图位置」的 _Avoid_: 静默隐藏)。
  105. * @param {Array} objects 地图对象数组
  106. */
  107. export function splitByCoordinate(objects) {
  108. const renderable = []
  109. const blocked = []
  110. for (const item of objects || []) {
  111. if (isRenderable(item)) renderable.push(item)
  112. else blocked.push(item)
  113. }
  114. return { renderable, blocked }
  115. }
  116. /**
  117. * 不上图对象的清单(列表渲染用):带上能认人的名字与中文原因。
  118. * @param {Array} objects 地图对象数组
  119. */
  120. export function blockedEntries(objects) {
  121. return splitByCoordinate(objects).blocked.map((item) => {
  122. const reason = blockReason(item)
  123. return {
  124. key: `${(item && item.kind) || ''}|${(item && item.code) || ''}`,
  125. kind: (item && item.kind) || '',
  126. code: (item && item.code) || '',
  127. name: (item && item.name) || '',
  128. reasonCode: reason.code,
  129. reasonText: reason.text,
  130. }
  131. })
  132. }
  133. /**
  134. * 后端**整份快照**的坐标校验汇总 → 领域对象(票 07 的 Q4 裁定:如实带出后端口径)。
  135. *
  136. * 后端 `CockpitMapSnapshotResponse.coordinateValidation`(`CockpitCoordinateValidationSummary`)
  137. * 是**全量**统计(`CockpitMapSnapshotService` 用整份 `points`/`equipment` 计算后再切片分页),
  138. * 与前端按分页持有的已加载对象**必然不等**。两个口径都要,但用途不同:
  139. * · 后端口径回答「全城到底有多少点位没上图」——不随翻页跳动,是该给值班人员看的那个数;
  140. * · 前端口径(`mapSummary.js` 的 `summarizeCoordinateValidation`)只回答「我已加载的这批里有多少」。
  141. *
  142. * 缺失时不补 0:`available:false` + 各项 null —— 0 会被读成「一个坏坐标都没有」,
  143. * 那是句谎话(票 05 的「不显示虚假零值」同一条纪律)。
  144. * @param {object} raw 后端 `coordinateValidation` 汇总段
  145. */
  146. export function toCoordinateSummary(raw) {
  147. const has = isPlainObject(raw)
  148. const count = (key) => {
  149. const value = has ? raw[key] : null
  150. return typeof value === 'number' && Number.isFinite(value) ? value : null
  151. }
  152. return {
  153. available: has,
  154. crs: has && typeof raw.crs === 'string' ? raw.crs : '',
  155. total: count('totalObjectCount'),
  156. renderable: count('renderableCount'),
  157. invalid: count('invalidCount'),
  158. unverified: count('unverifiedCount'),
  159. }
  160. }
  161. /**
  162. * 后端汇总 → 给人读的一行(票 07 验收第 3 条「显示明确原因」的全量口径)。
  163. *
  164. * 措辞刻意说「未取到」而不是「后端未发布」:这一段的缺失有两个来源 ——
  165. * 后端没给这一段,**或者**快照为空(票 05 的 `sectionFromResult` 对 `EMPTY` 分区不带载荷,
  166. * 那份全零汇总因此在适配层就被放下了)。说成「后端没发布」会把责任推错地方。
  167. * 不管哪种来源,此时界面都只剩已加载口径可用,如实说清楚即可。
  168. * @param {object} summary `toCoordinateSummary()` 的结果
  169. */
  170. export function coordinateSummaryText(summary) {
  171. const current = summary || {}
  172. if (!current.available) {
  173. return '未取到坐标校验汇总 · 仅显示已加载范围内的判定'
  174. }
  175. const total = current.total === null ? '—' : current.total
  176. const renderable = current.renderable === null ? '—' : current.renderable
  177. const invalid = current.invalid === null ? '—' : current.invalid
  178. const unverified = current.unverified === null ? '—' : current.unverified
  179. return `全量可上图 ${renderable}/${total} · 坐标非法 ${invalid} · 未校验 ${unverified}`
  180. }
  181. /**
  182. * 已加载范围 → 给人读的一行(前端口径,与上面那行的主语必须分清,否则两个数会互相打脸)。
  183. * @param {{total: number, renderable: number, blocked: number}} loaded
  184. */
  185. export function loadedCoordinateText(loaded) {
  186. const current = loaded || {}
  187. return `已加载 ${current.total || 0} 个 · 可上图 ${current.renderable || 0} · 无地图位置 ${current.blocked || 0}`
  188. }
  189. /**
  190. * 设施与管线的准入汇总(票 24)。
  191. *
  192. * **为什么单独收口再并入**:设施/管线不是监测点(CONTEXT.md:二者不可混算),
  193. * 所以它们不上 `map-snapshot` 的对象序列、不参与翻页统计;但「无地图位置」清单回答的是
  194. * 「这次驾驶舱里哪些东西没上图」,那是**跨类**的问题——只列监测点会把没上图的管线藏起来。
  195. * 故本函数把设施/管线折成与地图对象同形的清单条目与计数,由总览并表。
  196. *
  197. * 缺 `data`(几何取数失败/未取过)时全部为 0:**失败不得变成"零个没上图的"**——
  198. * 那正是 `infrastructureApi.js` 注释里点名的那个谎报。
  199. * @param {object} layer `domain/pipeNetwork.js` 的图层(`pipes`/`components`/`blocked`)
  200. */
  201. export function facilityCoordinateExtra(layer) {
  202. const source = layer || {}
  203. const blocked = Array.isArray(source.blocked) ? source.blocked : []
  204. const renderable = (Array.isArray(source.pipes) ? source.pipes.length : 0)
  205. + (Array.isArray(source.components) ? source.components.length : 0)
  206. return {
  207. blockedEntries: blocked.map((row) => ({
  208. // key 带 `facility|` 前缀:设施编码与监测点编码可能撞号,不能互相顶掉。
  209. key: `facility|${(row && row.kind) || ''}|${(row && row.code) || ''}`,
  210. kind: (row && row.kind) || 'facility',
  211. code: (row && row.code) || '',
  212. name: (row && row.name) || (row && row.code) || '',
  213. reasonCode: (row && row.reasonCode) || '',
  214. reasonText: (row && row.reasonText) || NO_MAP_LOCATION_TEXT,
  215. })),
  216. renderable,
  217. }
  218. }
  219. /**
  220. * 合并多份「无地图位置」附加项(票 68)。
  221. *
  222. * 管线/构件一份、设施点一份,各自如实说明自己那批;合并只做加法,
  223. * 不改任何一份的判定 —— 这样「徽标与清单自洽」在所有附加项上同时成立。
  224. * @param {...object} extras `facilityCoordinateExtra()` / `facilityPointCoordinateExtra()` 的输出
  225. */
  226. export function mergeCoordinateExtras(...extras) {
  227. const list = extras.filter(Boolean)
  228. return {
  229. renderable: list.reduce((sum, item) => sum + (Number.isFinite(item.renderable) ? item.renderable : 0), 0),
  230. blockedEntries: list.flatMap((item) => (Array.isArray(item.blockedEntries) ? item.blockedEntries : [])),
  231. }
  232. }
  233. /**
  234. * 坐标准入总览(纯函数,界面与走查唯一读的那个对象)。
  235. *
  236. * 把**两个口径**并排给出,主语写清楚(票 07 的 Q4 裁定,也是本票最容易骗人的地方):
  237. * · `backend` —— 后端全量汇总,不随翻页跳动;
  238. * · `loaded` —— 前端按已加载对象算的自检口径。
  239. * 二者不相等是**正常**的(后端是全量、前端只持有已翻到的页),界面必须分开说,不得混成一个数。
  240. *
  241. * `loaded` 的主语是**「本次驾驶舱已加载范围内不上图/可上图的对象」**,因此含设施与管线
  242. * (`extra`,票 24)。徽标与清单取的是同一个对象里的两个字段,所以并进来之后两者仍自洽——
  243. * 不会出现「徽标写 3、清单列 5」这种自相矛盾。
  244. *
  245. * @param {Array} objects 已加载的地图对象
  246. * @param {object} backendSummary `toCoordinateSummary()` 的结果
  247. * @param {object} [extra] `facilityCoordinateExtra()` 的结果(缺省=没有设施图层)
  248. */
  249. export function coordinateOverview(objects, backendSummary, extra) {
  250. const { renderable, blocked } = splitByCoordinate(objects)
  251. const backend = backendSummary && backendSummary.available ? backendSummary : toCoordinateSummary(null)
  252. const facilities = extra && Array.isArray(extra.blockedEntries) ? extra : { blockedEntries: [], renderable: 0 }
  253. const extraRenderable = Number.isFinite(facilities.renderable) ? facilities.renderable : 0
  254. const extraBlocked = facilities.blockedEntries.length
  255. // 不变式:`total === renderable + blocked`。设施与管线同时进两侧,否则这个等式会破,
  256. // 而界面正是按「已加载 N 个 · 可上图 M · 无地图位置 K」把三个数并排显示的。
  257. const loaded = {
  258. total: renderable.length + blocked.length + extraRenderable + extraBlocked,
  259. renderable: renderable.length + extraRenderable,
  260. blocked: blocked.length + extraBlocked,
  261. }
  262. return {
  263. backend,
  264. backendText: coordinateSummaryText(backend),
  265. loaded,
  266. loadedText: loadedCoordinateText(loaded),
  267. // 不上图的清单:这是「保留在列表里」在本票的可见落点(后续票 10/18 的真列表接手同一份数据)。
  268. // 设施与管线并入同一份清单(票 24):只列监测点会把没上图的管线藏起来。
  269. blockedEntries: blockedEntries(objects).concat(facilities.blockedEntries),
  270. }
  271. }