鼎味肉市DESIGN ATELIER
← 资料目录docs/design/prototypes/admin-console/deployment.md阅读原文

后台原型预览与维护

项目根目录执行:

python3 docs/design/prototypes/admin-console/workbench/build-design.py
python3 docs/design/prototypes/admin-console/workbench/build-stories.py
python3 docs/design/prototypes/admin-console/workbench/generate-spec.py
.claude/bin/loop-harness scenario generate --module admin-console --root .
python3 docs/design/prototypes/admin-console/workbench/build-manifest.py
docker compose -f docs/design/prototypes/admin-console/compose.yml up -d --wait
# 若容器已在运行且服务程序/白名单变化:
docker compose -f docs/design/prototypes/admin-console/compose.yml restart preview

访问 http://100.90.0.100:4302/,4301的后台展示页会加载同一入口。需连接对应网络。这是只读静态原型服务,客户端仅使用合成资料与本地记录;没有真实身份认证或业务接口。

内容边界

server.mjs只提供两个资源白名单声明的文件。workbench-manifest.json列当前作品与可阅读设计文档;site-manifest.json保留旧版资产。/指向当前工作台,旧global入口映射到对应新业务功能。旧版回退入口为 /legacy/proof/signal-study/site/global.html。

全局tokens仍以docs/design/tokens/tokens.json/css为权威,build-design.py将CSS原样分发到workbench/tokens.css,供仅挂载模块目录的容器使用;不要编辑这个副本。字体是底座的自托管Noto Sans SC子集,缺字仍由系统回退;完整中文字体覆盖与多平台排版需后续验证。

原型记录与恢复

本地存储键:dingwei.admin.prototype.workbench.1。顶部重置先确认,可以下载备份;不影响小程序记录。存储读取失败时暂停写入并提供恢复提示;写入失败不显示成功。旧版site文件没有删除,可切回服务入口恢复旧预览;新记录保持保留。

浏览器验证

永久定义位于web/e2e/admin-console/:

使用已安装的@playwright/test运行;长期配置为web/e2e/admin-console/playwright.config.cjs,可通过PW_CHROMIUM指定浏览器、PW_WORKERS指定并行数、PW_RESULTS/PW_ARTIFACTS指定产物。支持环境变量 DINGWEI_ROOT 和 PREVIEW_URL。测试前置只创建隔离合成数据,不执行受测动作。运行产物与实际结果见VERIFICATION.md。

本轮临时验证环境放在/tmp/dingwei-admin-tools,没有引入产品依赖或改系统共享库。可用其配置复跑:

NODE_PATH=/tmp/dingwei-admin-tools/node_modules \
LD_LIBRARY_PATH=/tmp/dingwei-admin-tools/libs/extracted/usr/lib/x86_64-linux-gnu \
/tmp/dingwei-admin-tools/node_modules/.bin/playwright test \
  --config /tmp/dingwei-admin-tools/playwright.config.cjs

正式工程仓的包管理、CI与产品测试命令未在本轮建立,不把临时原型测试环境当作正式工具链。

通用复跑入口(已装浏览器和Playwright):

PREVIEW_URL=http://127.0.0.1:4302 npx playwright test --config web/e2e/admin-console/playwright.config.cjs

独立设计检查:

python3 docs/design/prototypes/admin-console/workbench/verify-static.py
python3 docs/design/prototypes/admin-console/workbench/verify-preview.py
# 同样使用已安装的Playwright;PW_CHROMIUM可选。
PREVIEW_URL=http://127.0.0.1:4302 node docs/design/prototypes/admin-console/workbench/verify-layout.mjs

布局产物默认写入/tmp/dingwei-admin-layout-check,可设置LAYOUT_OUTPUT。资源校验前应先生成manifest并重启预览以载入新增白名单;生成manifest不改变浏览器业务实现。

报告验收(要求完整一轮,无跳过或重试,并核对输入指纹):

python3 docs/design/prototypes/admin-console/workbench/verify-browser-report.py /path/to/playwright-results.json

tested-inputs.json应在测试开始前捕获。不能在测试之后为修改过的产品文件重写该基线,也不能合并中断轮次来声称完整一轮通过。