/** * 坐标准入与「无地图位置」(票 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), } }