后台原型预览与维护
项目根目录执行:
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/:
workbench.spec.ts:逐CASE显式注册;断言在runner.ts,共享参数来自功能目录。critical.spec.ts:独立编写的费用边界、资金与业务门禁、恢复、范围和并发窗口检查。projection.spec.ts:直接字段、等待核验与未知结果的摘要映射检查。- 生成器只注册已声明CASE,不生成通过结论。
使用已安装的@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应在测试开始前捕获。不能在测试之后为修改过的产品文件重写该基线,也不能合并中断轮次来声称完整一轮通过。