diff --git a/.trellis/tasks/08-31-parameter-panel-binding/design.md b/.trellis/tasks/08-31-parameter-panel-binding/design.md index f331f24..67de307 100644 --- a/.trellis/tasks/08-31-parameter-panel-binding/design.md +++ b/.trellis/tasks/08-31-parameter-panel-binding/design.md @@ -112,3 +112,27 @@ 父 `design.md` 已为 `boundaryIndex` 定义同类规则——"重放时若车道数变化导致越界,该约束转 `stale`,不做近似映射"——数值范围越界应同等处理。 属重放正确性,不属本任务;独立成任务。本任务的客户端校验不因该缺口存在而降级:范围在哪定义就在哪拦,并避免一次注定被拒的求解。 + +## 右侧工作台信息架构(2026-09-01) + +右栏是操作面板而非信息流。顶部固定呈现当前选择对象、其道路方向和修改状态;下方 +采用单主展开区的手风琴,避免所有表单在初始状态占满地图旁的空间。 + +| 分段 | 内容 | 展开规则 | 写入语义 | +| --- | --- | --- | --- | +| 道路 | 基础道路覆盖、直接编辑参数 | 选中道路时默认展开 | override 暂存;直接编辑 preview/session | +| 元素 | 车道箭头、标线、信号灯 | 选择相应地图元素时自动展开 | 箭头/标线暂存;信号灯即时 API | +| 连接 | 路口连接、行驶动作、手工候选 | 默认收起 | override 暂存 | +| 高级 | 复杂路口候选、技术 JSON | 始终默认收起 | 候选沿用现有调用 | + +每个分段使用受控 React 状态,而非依赖原生 `
` 的不可观察状态;这让地图选中 +事件可以可靠地展开相应段,且移动端与桌面端保持同一状态模型。分段标题显示摘要 +(如参数修改数、所选第几车道、连接数量),但不复制任何几何或约束值。 + +车道箭头在元素段显示 maneuver 选择、距路口端的米数读数和有限数值输入。数值输入与 +拖曳都写同一 `lane-maneuver.placementDistanceMeters`;客户端只限制为有限非负值,控制 +设施与端点安全位置仍由正式编译的 `nearestSafeTurnArrowPlacement()` 权威裁决。 + +为避免继续膨胀 `App.tsx`,右栏容器、对象摘要、手风琴、道路/连接/元素分段应迁入 +`workbench/client/src/components/`。现有 `ParameterPanel` 保持其 manifest 值所有权和 +DOM 直写性能策略,只作为“道路”分段的内容,不被重写为另一条输入链路。 diff --git a/.trellis/tasks/08-31-parameter-panel-binding/implement.md b/.trellis/tasks/08-31-parameter-panel-binding/implement.md index a72744d..c59daf8 100644 --- a/.trellis/tasks/08-31-parameter-panel-binding/implement.md +++ b/.trellis/tasks/08-31-parameter-panel-binding/implement.md @@ -82,3 +82,16 @@ npm run build - `workbench/client/src/edit/projection.ts`:`projectHandleValue` 的夹值是拖拽正确性的一部分(见其 75 行注释),不得为"统一行为"而移除。 - `workbench/client/src/edit/preview-request.ts`:防抖与 `previewSeq` 仲裁由两条通道共用,任何改动同时影响拖拽。 - `src/compile/direct-edit-solver.js`:**本任务不改**。若发现必须改,先确认不是把服务端校验缺口混进了本任务范围。 + +## 右侧工作台扩展(2026-09-01) + +1. 抽出受控手风琴和选择对象摘要组件,建立“道路 / 元素 / 连接 / 高级”四段及其 + 自动展开规则;先用静态现有内容验证不改变写入行为。 +2. 将现有 `Inspector` 的道路覆盖、连接、候选和技术详情迁入对应分段;将标线、箭头、 + 信号迁入元素分段。保留 `ParameterPanel` 的 API 和直接编辑数据流。 +3. 补充箭头位置的米数读数和精确输入,与拖曳使用同一 staged override;输入非法值不暂存。 +4. 用组件/纯逻辑单测覆盖自动展开、分段摘要、箭头位置写入和不同写入语义;手测桌面及 + 窄屏的空间、焦点和滚动。 +5. 执行 `npm run format:check`、`npm run test`、`npm run test:client`、 + `npm run test:client:unit`、`npm run build`,并验证选箭头、标线、信号、道路与连接的 + 现有保存流程未回归。 diff --git a/.trellis/tasks/08-31-parameter-panel-binding/prd.md b/.trellis/tasks/08-31-parameter-panel-binding/prd.md index 63fc011..a21d68b 100644 --- a/.trellis/tasks/08-31-parameter-panel-binding/prd.md +++ b/.trellis/tasks/08-31-parameter-panel-binding/prd.md @@ -97,3 +97,22 @@ 服务端只校验 finite/非负,不校验 manifest 的 `min`/`max`;而外缘偏移范围随道路宽度浮动,意味着保存时合法的值可能在几何变化后越界。这类越界**客户端结构上无法拦截**——它发生在保存之后的求解期。 `design.md` 已为 `boundaryIndex` 定义了同类规则("重放时若车道数变化导致越界,该约束转 `stale`"),数值范围越界应当同等处理。属重放正确性,独立成任务。 + +## 右侧工作台扩展(2026-09-01) + +当前右侧栏将道路基础覆盖、直接编辑参数、路口连接、车道转向箭头、标线样式、 +原生信号灯、复杂路口候选和技术 JSON 直接按顺序堆叠,缺少所选对象摘要、明确的 +编辑上下文和一致的表单层级。用户确认本轮应覆盖全部既有编辑器,而非只处理道路 +参数或车道箭头。 + +拟纳入范围: + +- 统一右侧栏的对象摘要、未保存/即时保存状态和表单布局。 +- 重新组织道路、元素、连接、调试/技术详情中的全部既有表单与信息展示。 +- 为车道转向箭头补足距路口位置的可读数与精确输入,继续复用 + `placementDistanceMeters` 覆盖和既有拖曳行为。 +- 保持各写入语义:普通 override 继续暂存并经保存/重新生成生效;信号灯继续走 + 现有即时 API;直接编辑继续走 manifest/preview/session 链路。 + +已决 UX:右栏使用手风琴式可折叠分段,以控制地图工作台中的垂直空间占用。 +所选地图元素的关联编辑段自动展开;调试与技术详情默认收起。 diff --git a/workbench/client/src/App.tsx b/workbench/client/src/App.tsx index 17b7fd7..85a0cc7 100644 --- a/workbench/client/src/App.tsx +++ b/workbench/client/src/App.tsx @@ -1,8 +1,9 @@ -import { useEffect, useMemo, useRef, useState } from 'react'; +import { useEffect, useMemo, useRef, useState, type ReactNode } from 'react'; import { Download, RefreshCw, Save, Upload } from 'lucide-react'; import { api, isVersionConflict } from './lib/api'; import { MapCanvas } from './components/MapCanvas'; import { ParameterPanel, type ParameterPanelHandle } from './components/ParameterPanel'; +import { InspectorSection } from './components/InspectorSection'; import { elementSelectionFor, groupMembers, @@ -45,21 +46,21 @@ import type { GeoFeature, GeoJson, Override, Road, WorkbenchState } from './type import type { LayerName } from './map/layers'; const layerLabels: Array<[LayerName, string]> = [ - ['osm', 'OSM 道路中心线'], + ['osm', '方向道路参考线'], ['native', '自研道路与路口面'], ['sidewalks', '路缘与步行带'], ['lanes', '车道与转向路径'], ['directionArrows', '道路方向箭头'], ['markings', '车道分隔线与路口转向箭头'], - ['centerLines', '道路中心线'], + ['centerLines', '道路中央标线'], ['edgeLines', '道路外缘线'], ['controls', '斑马线与停止线'], ['signals', '红绿灯设施'], - ['reference', 'osm2streets 参考面'], ]; -const defaultLayers = Object.fromEntries( - layerLabels.map(([key]) => [key, key !== 'edgeLines' && key !== 'reference']), -) as Record; +const defaultLayers = Object.fromEntries(layerLabels.map(([key]) => [key, key !== 'edgeLines'])) as Record< + LayerName, + boolean +>; const direction = (road: Road) => (road.direction === 'forward' ? '沿 OSM 方向' : '逆 OSM 方向'); const label = (road: Road) => road.tags.name || `${road.highway}(OSM ${road.osmWayIds.join(', ')})`; const laneIndex = (id: string) => Number(id.split(':').at(-1)); @@ -86,14 +87,6 @@ function Overview({ comparison }: { comparison: Record }) { ))} -
- osm2streets 参考面 - - {comparison.osm2streetsAvailable === true - ? `${Number(comparison.osm2streetsRoadSurfaceFeatures || 0)} 个` - : '未提供'} - -
{severity && (
编译诊断 @@ -562,9 +555,8 @@ function App() { const diagnostics = state.compiled.diagnostics.filter( (item) => item.rule !== 'ordinary-junction-surface' && - (filter === 'all' || filter === 'candidates' - ? Boolean(item.manualCandidates?.length) - : !item.manualCandidates?.length), + (filter === 'all' || + (filter === 'candidates' ? Boolean(item.manualCandidates?.length) : !item.manualCandidates?.length)), ); const handleFeature = (properties: Record) => { setMarking(properties); @@ -643,43 +635,60 @@ function App() {
+
    + {diagnostics.map((item) => ( +
  • + +
  • + ))} +
+
+
+
+ 当前编译概览 + +
@@ -815,6 +825,7 @@ function Inspector({ stage, status, setState, + children, }: { road: Road | null; state: WorkbenchState; @@ -824,6 +835,7 @@ function Inspector({ stage: (item: Override) => void; status: (value: string) => void; setState: (next: WorkbenchState) => void; + children?: ReactNode; }) { const [width, setWidth] = useState(0); const [lanes, setLanes] = useState(1); @@ -856,163 +868,206 @@ function Inspector({ }; const signalUid = typeof marking?.signal_uid === 'string' ? marking.signal_uid : ''; const signal = state.trafficSignals.assemblies.features.find((item) => item.properties?.signal_uid === signalUid); - // The `.inspector` aside now belongs to the layout in `main`, so the parameter - // panel can share the column. Same markup, one level up. + const [open, setOpen] = useState<'road' | 'element' | 'connections' | 'advanced' | null>('road'); + useEffect(() => { + if (element || marking) setOpen('element'); + else if (road) setOpen('road'); + }, [element, marking, road]); + const section = (name: NonNullable) => () => setOpen((current) => (current === name ? null : name)); + const selectedLabel = + element?.kind === 'lane-maneuver' + ? `第 ${laneIndex(element.laneId)} 车道` + : marking + ? '已选标线或设施' + : road + ? label(road) + : '未选择对象'; return ( - <> -

当前道路设置

- {road ? ( -
{ - event.preventDefault(); - stage({ - id: `道路:${road.id}`, - kind: 'road', - roadId: road.id, - widthMeters: width, - laneCount: lanes, - sidewalkLeft: left, - sidewalkRight: right, - }); - const opposite = state.compiled.model.roads.find( - (item) => item.id !== road.id && item.segmentId === road.segmentId, - ); - if (opposite) +
+
+ 编辑工作台 + {selectedLabel} + {staged.length ? `已暂存 ${staged.length} 项修改` : '没有待保存的覆盖修改'} +
+ + {road ? ( + { + event.preventDefault(); stage({ - id: `道路:${opposite.id}`, + id: `道路:${road.id}`, kind: 'road', - roadId: opposite.id, - sidewalkLeft: right, - sidewalkRight: left, + roadId: road.id, + widthMeters: width, + laneCount: lanes, + sidewalkLeft: left, + sidewalkRight: right, }); - status('有未保存修改'); - }} - > - - - {label(road)}({direction(road)}) - - - {movements.length - ? `已识别 ${movements.length} 个行驶动作,${movements.filter((item) => item.geometryPublished).length} 条已绘制路径` - : '当前方向没有已识别的行驶动作'} - - - - - - - - ) : ( -

点击道路、车道、标线、转向路径或路口面以查看详情。

- )} -
-

路口连接与行驶动作

- {road && - state.compiled.model.connections - .filter((connection) => connection.fromEndpointId === endpoint?.id) - .map((connection) => ( -
+ + + + + + + {road ? ( +
+ {state.compiled.model.connections + .filter((connection) => connection.fromEndpointId === endpoint?.id) + .map((connection) => ( + + ))} + {movements.map((movement) => ( + + ))} +
+ ) : ( +

选择一条道路以管理其驶入路口的连接。

+ )} + {endpoint && + state.compiled.diagnostics + .find((item) => item.endpointId === endpoint.id) + ?.manualCandidates?.map((candidate) => { + const target = state.compiled.model.roads.find((item) => item.id === candidate.roadId); + const targetEndpoint = state.compiled.model.endpoints.find( + (item) => item.roadId === candidate.roadId && item.side === 'start', + ); + return target && targetEndpoint ? ( + + ) : null; + })} +
+ + +
+ 技术详情与来源 +
+            {JSON.stringify(
+              road ? { OSM道路: road.osmWayIds, 当前方向节点顺序: road.sourceNodeIds, 原始标签: road.tags } : marking,
+              null,
+              2,
+            )}
+          
+
+
+
); } const MANEUVER_OPTIONS: Array<[string, string]> = [ @@ -1041,27 +1096,26 @@ function LaneManeuverEditor({ .find((item) => item.kind === 'lane-maneuver' && item.laneId === element.laneId); const id = override?.id || `车道转向:${element.laneId}`; const maneuver = typeof override?.maneuver === 'string' ? override.maneuver : element.maneuver; + const placementDistanceMeters = + typeof override?.placementDistanceMeters === 'number' + ? override.placementDistanceMeters + : (element.placementDistanceMeters ?? 6); + const update = (next: Partial>) => + stage({ + id, + kind: 'lane-maneuver', + laneId: element.laneId, + maneuver: typeof next.maneuver === 'string' ? next.maneuver : maneuver, + placementDistanceMeters: + typeof next.placementDistanceMeters === 'number' ? next.placementDistanceMeters : placementDistanceMeters, + }); return ( -
-
+

车道转向箭头

- 第 {laneIndex(element.laneId)} 车道 +

第 {laneIndex(element.laneId)} 车道。拖曳地图中的虚线箭头可粗调位置。

+ +

保存并重新生成时会避开停止线、斑马线和车道端点。

); } @@ -1119,12 +1187,12 @@ function MarkingEditor({ }; return (
{ event.preventDefault(); save(); }} > -

标线样式