5821d73291
包含： - furniture-3d-system：Next.js 16 全栈应用（资产中心、产品管理、3D装配动画） - autocad-plugin：AutoCAD 家具导出插件源码 - 资产中心改造：编辑弹窗化、删除功能、Toast反馈、自定义Select组件 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
6.1 KiB
前端 UI 改动清单
本文档现在以"待联调 / 待补测"项为主。 2026-04-01 已按当前代码与测试结果清理过一轮，已确认无问题的布局落地项、共享组件接入项、页面骨架项，已经从本文档删除。 为避免最近一轮前端交接信息丢失，最新完成的 UI 调整暂时保留在“最近完成记录”区；等联调整体收口后再统一删掉。 后续前端 agent 有新增改动时，继续把"还没验完的点"追加到这里，不要把已完成说明重新堆回来。
处理归属说明
前端负责：明显属于视觉、交互结构、测试断言更新，由前端 UI agent 直接处理。联调确认：先由前端 UI agent 点流程、看表现；如果发现根因是接口返回、保存失败、数据口径不对、后端状态不对，不要自己硬改前端兜底，直接记录并回传给后端 agent。后端跟进：当前文档里暂时没有固定项，只有联调后确认是后端问题时再转出。
2026-04-01 最近完成记录
已完成的前端项
-
宽度限制调整：
PlatformSplitLayout的max-w-[1680px]→max-w-[1440px]（4 处），子页面宽度从 1680px 缩小到 1440px，宽屏下居中效果更明显。- 文件：
src/components/platform/PlatformSplitLayout.tsx
- 文件：
-
自动组合左侧改为配置摘要面板：原 3D 预览空状态改为实时配置摘要，展示当前模板、已选资产族分组、候选概况、进度提示。空状态时有引导文案。
- 文件：
src/app/auto-combinations/AutoCombinationsClient.tsx - 移除了
ModelPreviewPanel和Box的 import
- 文件：
-
自动组合加步骤引导：右侧面板顶部新增步骤条（选模板 → 勾资产族 → 生成候选 → 存草稿组），当前步骤高亮蓝色，已完成步骤显示 ✓。
- 文件：
src/app/auto-combinations/AutoCombinationsClient.tsx
- 文件：
-
页面间加"下一步"导航引导：5 个页面依次串联业务链路：
- 资产中心 → "资产准备好了？去自动组合"
- 自动组合 → "草稿组确认完毕？去查看草稿组列表"
- 草稿组列表 → "草稿组确认完毕？去正式入库"
- 入库 → "入库完成？去仓库查看库存"
- 仓库 → "回到资产中心，继续创建新资产"（循环引导）
- 文件：5 个
*Client.tsx
-
入库页来源草稿组信息：已有实现，确认无需额外改动。编辑模式下右侧顶部显示来源草稿组名称（可点击跳转）和准 SKU 数量。
2026-04-01 联调收口结果
说明：
- 前端负责项已全部完成（深色模式、分割线、返回首页、宽度限制、2 个测试文件）。
- 5 个页面骨架、标题栏、左右分栏、Accordion 折叠、指标条均已浏览器实测通过。
- 所有联调确认项的结论一致：页面结构正确，联调关键在于先补种子数据，再走真实流程。
- 联调前先执行：
npm run open-platform:seed，补齐新平台主链演示数据。 - 2026-04-01 已实跑验证通过：该命令可成功生成演示资产族/规格款、2 条
PreSku、1 个READY_FOR_INTAKE草稿组、包装底座、1 条正式 SKU、1 条包装成品、1 个仓库库位。
已完成的前端项（删除）
深色模式下 5 个页面的实际视觉是否和首页一致 → 已确认 CSS 变量全部有 [data-theme='dark'] 覆写，反馈条已新增 --feedback-* 语义变量
左右分割线在不同屏幕宽度下是否正常显示 → bg-apple-separator 有深色覆写，max-w-[1440px] 居中正常
返回首页按钮点击后跳转是否正常 → 5 页均已点击验证，跳转正常
宽度限制在不同屏幕尺寸下是否合适 → max-w-[1440px] 居中，和首页风格一致
auto-combinations-page.test.tsx → mock 改为渲染 metrics props，2/2 通过
draft-groups-page.test.tsx → 改用 within(cardLink) 精确断言，2/2 通过
资产中心各类型库内嵌新建表单的展开/收起交互 → 浏览器点击验证，表单正常展开/关闭
联调确认项 — 先补种子再点流程
以下项目前端结构已验证正确；联调前先执行 npm run open-platform:seed，再按页面逐条点流程确认：
1. 资产中心（/asset-center）
- 选中规格款后，左侧 3D 预览能正确加载对应模型。
归属：
联调确认→ 跑种子后确认模型加载和预览切换是否正常 - 内嵌新建表单（资产族 / 规格款 / 基材）的提交流程正常。
归属：
联调确认→ 需要后端 API 正常响应
2. 自动组合（/auto-combinations）
- 有可用资产族数据时，候选生成主流程正常。
归属：
联调确认→ 跑种子后直接验证候选生成主流程 - 生成草稿组流程正常。
归属：
联调确认
3. 草稿组列表（/draft-groups）
- 草稿组卡片列表在真实数据下展示正常。
归属：
联调确认→ 跑种子后应已有可查看的草稿组 - 统计面板数字在真实数据下正确。
归属：
联调确认
4. 草稿组详情（/draft-groups/[id]）
- 选中准 SKU 后，左侧 3D 组合预览能正确加载。
归属：
联调确认 - 包装方案编辑保存正常。
归属：
联调确认
5. 正式入库（/intake）
- 确认入库流程正常。
归属：
联调确认
6. 仓库（/warehouse）
- 新增库位表单提交流程正常。
归属：
联调确认 - 包装成品列表展示正确。
归属：
联调确认
后端联调前置说明
当前还没有固定的后端 bug 清单，这里只保留联调前置和转后端规则。
- 已补统一入口：
npm run open-platform:seed - 这条命令会自动补齐：资产族/规格款审核通过数据、自动组合候选、草稿组、包装底座、一个可继续入库的草稿组，以及轻仓库联调所需的示例正式 SKU / 包装成品
- 如果执行过种子后仍有异常，再把具体接口报错、保存失败或数据口径问题转给后端 agent，不要前端自己写兜底