| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293 |
- /**
- * 坐标准入与「无地图位置」(票 07)。
- *
- * 权威判据在后端,不在前端。后端 `CockpitCoordinateValidator.validate()` 已经给出结论:
- * `state` = `VALID` | `INVALID` | `UNVERIFIED`,`reason` 七取一,`renderable` 是布尔结论。
- * (2026-10-12 起后端取消人工校核前置,准入改为自动判定:结构合法 + 落在主场景区内,
- * 新增 `OUTSIDE_PRIMARY_AREA`;`UNVERIFIED` 仅存在于历史快照与「后端未给校验段」的防御路径。)
- * 本文件**只消费这个结论**,绝不自己再查一遍经纬度范围 —— 票 07 的验收原句是
- * 「前端不自动纠偏、不使用默认坐标」;重算一遍既会与后端分歧,也正是「纠偏」的入口。
- * 唯一的准入判据因此是 `renderable === true`(票 09/22 的渲染必须走 `isRenderable()`)。
- *
- * 另一条纪律沿用票 05:**内部原因码不上界面**。`data-*` 上留 `reason` 原码供走查断言,
- * 给人看的只有中文文案;认不出的原因宁可只说「无地图位置」,也不把 `LONGITUDE_OUT_OF_RANGE`
- * 甩给值班人员。
- *
- * reason 词表照抄后端 `CockpitCoordinateValidator`(E:\pipe-ner-server,六个取值),
- * 保证「文案」与「后端结论」一一对应,而不是前端猜一套。
- */
- import { isPlainObject } from './fields.js'
- /** 后端坐标校验三态(`CockpitCoordinateValidation.state`)。 */
- export const COORDINATE_STATE = {
- VALID: 'VALID',
- INVALID: 'INVALID',
- UNVERIFIED: 'UNVERIFIED',
- }
- /**
- * 后端 reason 原码 → 中文文案。词表与后端 `CockpitCoordinateValidator` 一一对应。
- *
- * 2026-10-12:后端取消无入口的人工校核前置,改为「结构合法 + 落在主场景区内」自动准入,
- * 因此新增 `OUTSIDE_PRIMARY_AREA`(区外不上图,但坐标保留、对象仍在清单里)。
- * `UNVERIFIED_COORDINATE` 保留在词表中:它是历史快照与「后端未给校验段」防御路径的文案,
- * 不再是新数据的常态结论。
- */
- export const COORDINATE_REASON_TEXT = {
- UNVERIFIED_COORDINATE: '坐标未经校验',
- MISSING_LONGITUDE: '缺少经度',
- MISSING_LATITUDE: '缺少纬度',
- LONGITUDE_OUT_OF_RANGE: '经度超出合法范围',
- LATITUDE_OUT_OF_RANGE: '纬度超出合法范围',
- ZERO_COORDINATE: '零坐标(经纬度均为 0)',
- OUTSIDE_PRIMARY_AREA: '不在主场景区范围内',
- }
- /** 认不出原因时的统一文案(票 07 验收原句点名的那一个)。 */
- export const NO_MAP_LOCATION_TEXT = '无地图位置'
- /** 后端整段没给 `coordinateValidation` 时的文案(票 05 的 `validated:false`)。 */
- export const UNVALIDATED_TEXT = '坐标未校验'
- /**
- * 唯一准入判据:**只认后端 `renderable`**,不看经纬度数值、不看 state。
- *
- * 为什么连 `state === 'VALID'` 都不作为备选判据:那是第二套判据,一旦与 `renderable` 分歧
- * (后端将来加了新 state),两个答案必然有一个是错的,而错的会画到地图上。
- * @param {object} item 地图对象(`domain/mapSummary.js` 的形状)
- */
- export function isRenderable(item) {
- const coordinate = (item && item.coordinate) || null
- return !!coordinate && coordinate.renderable === true
- }
- /**
- * 某个编码的**坐标准入结论**(票 41:界面只读它,不自己调判据)。
- *
- * 三种情形必须分得开 —— 这是「无地图位置」最容易骗人的地方:
- * · `present:false` —— 该编码**不在已加载快照里**(分页没翻到 / 引擎未就绪):
- * 这是"暂时无法确认",**不是**无地图位置;界面应走暂隐并保留选择,
- * 绝不能显示一张"无地图位置"的固定详情去冒充结论;
- * · `present:true, renderable:false` —— 后端判定不可上图:带中文原因,走固定详情;
- * · `present:true, renderable:true` —— 可上图,走锚定跟随。
- *
- * 为什么单独成纯函数而不是写在 store 里:它是界面可见行为的判据(固定详情 vs 暂隐),
- * 必须能脱浏览器断言(本仓成例:判定收进 domain,store 只持有状态)。
- * @param {Array} objects 已加载的地图对象
- * @param {string} code 对象编码
- */
- export function locationVerdict(objects, code) {
- const wanted = typeof code === 'string' ? code.trim() : ''
- const found = wanted ? (Array.isArray(objects) ? objects : []).find((item) => item && item.code === wanted) : null
- if (!found) return { present: false, renderable: false, reasonText: '' }
- const renderable = isRenderable(found)
- return { present: true, renderable, reasonText: renderable ? '' : blockReason(found).text }
- }
- /**
- * 对象不上图的原因(给界面看)。
- *
- * 三层,按票 07 的裁定:
- * 1. 后端整段没给校验结果(`validated:false`)→「坐标未校验」——这是「缺失」,不是「非法」;
- * 2. reason 命中后端词表 → 具体原因(缺少经度 / 超范围 / 零坐标 …);
- * 3. 其余认不出 →「无地图位置」,不泄露原因码。
- * @param {object} item 地图对象
- * @returns {{code: string, text: string}} `code` 仅用于 `data-*` 与断言,不上界面
- */
- export function blockReason(item) {
- const coordinate = (item && item.coordinate) || {}
- if (!coordinate.validated) {
- return { code: '', text: UNVALIDATED_TEXT }
- }
- const code = coordinate.reason || ''
- const text = COORDINATE_REASON_TEXT[code]
- if (text) return { code, text }
- return { code, text: NO_MAP_LOCATION_TEXT }
- }
- /**
- * 按坐标准入把对象切成两堆(票 07 验收第 1 条)。
- *
- * **两堆都要交出去**:不上图 ≠ 不存在。对象必须仍在列表与详情里可见(`blocked` 就是给列表用的),
- * 静默丢掉才是票 07 明确禁止的(CONTEXT.md「无地图位置」的 _Avoid_: 静默隐藏)。
- * @param {Array} objects 地图对象数组
- */
- export function splitByCoordinate(objects) {
- const renderable = []
- const blocked = []
- for (const item of objects || []) {
- if (isRenderable(item)) renderable.push(item)
- else blocked.push(item)
- }
- return { renderable, blocked }
- }
- /**
- * 不上图对象的清单(列表渲染用):带上能认人的名字与中文原因。
- * @param {Array} objects 地图对象数组
- */
- export function blockedEntries(objects) {
- return splitByCoordinate(objects).blocked.map((item) => {
- const reason = blockReason(item)
- return {
- key: `${(item && item.kind) || ''}|${(item && item.code) || ''}`,
- kind: (item && item.kind) || '',
- code: (item && item.code) || '',
- name: (item && item.name) || '',
- reasonCode: reason.code,
- reasonText: reason.text,
- }
- })
- }
- /**
- * 后端**整份快照**的坐标校验汇总 → 领域对象(票 07 的 Q4 裁定:如实带出后端口径)。
- *
- * 后端 `CockpitMapSnapshotResponse.coordinateValidation`(`CockpitCoordinateValidationSummary`)
- * 是**全量**统计(`CockpitMapSnapshotService` 用整份 `points`/`equipment` 计算后再切片分页),
- * 与前端按分页持有的已加载对象**必然不等**。两个口径都要,但用途不同:
- * · 后端口径回答「全城到底有多少点位没上图」——不随翻页跳动,是该给值班人员看的那个数;
- * · 前端口径(`mapSummary.js` 的 `summarizeCoordinateValidation`)只回答「我已加载的这批里有多少」。
- *
- * 缺失时不补 0:`available:false` + 各项 null —— 0 会被读成「一个坏坐标都没有」,
- * 那是句谎话(票 05 的「不显示虚假零值」同一条纪律)。
- * @param {object} raw 后端 `coordinateValidation` 汇总段
- */
- export function toCoordinateSummary(raw) {
- const has = isPlainObject(raw)
- const count = (key) => {
- const value = has ? raw[key] : null
- return typeof value === 'number' && Number.isFinite(value) ? value : null
- }
- return {
- available: has,
- crs: has && typeof raw.crs === 'string' ? raw.crs : '',
- total: count('totalObjectCount'),
- renderable: count('renderableCount'),
- invalid: count('invalidCount'),
- unverified: count('unverifiedCount'),
- }
- }
- /**
- * 后端汇总 → 给人读的一行(票 07 验收第 3 条「显示明确原因」的全量口径)。
- *
- * 措辞刻意说「未取到」而不是「后端未发布」:这一段的缺失有两个来源 ——
- * 后端没给这一段,**或者**快照为空(票 05 的 `sectionFromResult` 对 `EMPTY` 分区不带载荷,
- * 那份全零汇总因此在适配层就被放下了)。说成「后端没发布」会把责任推错地方。
- * 不管哪种来源,此时界面都只剩已加载口径可用,如实说清楚即可。
- * @param {object} summary `toCoordinateSummary()` 的结果
- */
- export function coordinateSummaryText(summary) {
- const current = summary || {}
- if (!current.available) {
- return '未取到坐标校验汇总 · 仅显示已加载范围内的判定'
- }
- const total = current.total === null ? '—' : current.total
- const renderable = current.renderable === null ? '—' : current.renderable
- const invalid = current.invalid === null ? '—' : current.invalid
- const unverified = current.unverified === null ? '—' : current.unverified
- return `全量可上图 ${renderable}/${total} · 坐标非法 ${invalid} · 未校验 ${unverified}`
- }
- /**
- * 已加载范围 → 给人读的一行(前端口径,与上面那行的主语必须分清,否则两个数会互相打脸)。
- * @param {{total: number, renderable: number, blocked: number}} loaded
- */
- export function loadedCoordinateText(loaded) {
- const current = loaded || {}
- return `已加载 ${current.total || 0} 个 · 可上图 ${current.renderable || 0} · 无地图位置 ${current.blocked || 0}`
- }
- /**
- * 设施与管线的准入汇总(票 24)。
- *
- * **为什么单独收口再并入**:设施/管线不是监测点(CONTEXT.md:二者不可混算),
- * 所以它们不上 `map-snapshot` 的对象序列、不参与翻页统计;但「无地图位置」清单回答的是
- * 「这次驾驶舱里哪些东西没上图」,那是**跨类**的问题——只列监测点会把没上图的管线藏起来。
- * 故本函数把设施/管线折成与地图对象同形的清单条目与计数,由总览并表。
- *
- * 缺 `data`(几何取数失败/未取过)时全部为 0:**失败不得变成"零个没上图的"**——
- * 那正是 `infrastructureApi.js` 注释里点名的那个谎报。
- * @param {object} layer `domain/pipeNetwork.js` 的图层(`pipes`/`components`/`blocked`)
- */
- export function facilityCoordinateExtra(layer) {
- const source = layer || {}
- const blocked = Array.isArray(source.blocked) ? source.blocked : []
- const renderable = (Array.isArray(source.pipes) ? source.pipes.length : 0)
- + (Array.isArray(source.components) ? source.components.length : 0)
- return {
- blockedEntries: blocked.map((row) => ({
- // key 带 `facility|` 前缀:设施编码与监测点编码可能撞号,不能互相顶掉。
- key: `facility|${(row && row.kind) || ''}|${(row && row.code) || ''}`,
- kind: (row && row.kind) || 'facility',
- code: (row && row.code) || '',
- name: (row && row.name) || (row && row.code) || '',
- reasonCode: (row && row.reasonCode) || '',
- reasonText: (row && row.reasonText) || NO_MAP_LOCATION_TEXT,
- })),
- renderable,
- }
- }
- /**
- * 合并多份「无地图位置」附加项(票 68)。
- *
- * 管线/构件一份、设施点一份,各自如实说明自己那批;合并只做加法,
- * 不改任何一份的判定 —— 这样「徽标与清单自洽」在所有附加项上同时成立。
- * @param {...object} extras `facilityCoordinateExtra()` / `facilityPointCoordinateExtra()` 的输出
- */
- export function mergeCoordinateExtras(...extras) {
- const list = extras.filter(Boolean)
- return {
- renderable: list.reduce((sum, item) => sum + (Number.isFinite(item.renderable) ? item.renderable : 0), 0),
- blockedEntries: list.flatMap((item) => (Array.isArray(item.blockedEntries) ? item.blockedEntries : [])),
- }
- }
- /**
- * 坐标准入总览(纯函数,界面与走查唯一读的那个对象)。
- *
- * 把**两个口径**并排给出,主语写清楚(票 07 的 Q4 裁定,也是本票最容易骗人的地方):
- * · `backend` —— 后端全量汇总,不随翻页跳动;
- * · `loaded` —— 前端按已加载对象算的自检口径。
- * 二者不相等是**正常**的(后端是全量、前端只持有已翻到的页),界面必须分开说,不得混成一个数。
- *
- * `loaded` 的主语是**「本次驾驶舱已加载范围内不上图/可上图的对象」**,因此含设施与管线
- * (`extra`,票 24)。徽标与清单取的是同一个对象里的两个字段,所以并进来之后两者仍自洽——
- * 不会出现「徽标写 3、清单列 5」这种自相矛盾。
- *
- * @param {Array} objects 已加载的地图对象
- * @param {object} backendSummary `toCoordinateSummary()` 的结果
- * @param {object} [extra] `facilityCoordinateExtra()` 的结果(缺省=没有设施图层)
- */
- export function coordinateOverview(objects, backendSummary, extra) {
- const { renderable, blocked } = splitByCoordinate(objects)
- const backend = backendSummary && backendSummary.available ? backendSummary : toCoordinateSummary(null)
- const facilities = extra && Array.isArray(extra.blockedEntries) ? extra : { blockedEntries: [], renderable: 0 }
- const extraRenderable = Number.isFinite(facilities.renderable) ? facilities.renderable : 0
- const extraBlocked = facilities.blockedEntries.length
- // 不变式:`total === renderable + blocked`。设施与管线同时进两侧,否则这个等式会破,
- // 而界面正是按「已加载 N 个 · 可上图 M · 无地图位置 K」把三个数并排显示的。
- const loaded = {
- total: renderable.length + blocked.length + extraRenderable + extraBlocked,
- renderable: renderable.length + extraRenderable,
- blocked: blocked.length + extraBlocked,
- }
- return {
- backend,
- backendText: coordinateSummaryText(backend),
- loaded,
- loadedText: loadedCoordinateText(loaded),
- // 不上图的清单:这是「保留在列表里」在本票的可见落点(后续票 10/18 的真列表接手同一份数据)。
- // 设施与管线并入同一份清单(票 24):只列监测点会把没上图的管线藏起来。
- blockedEntries: blockedEntries(objects).concat(facilities.blockedEntries),
- }
- }
|