Repository navigation
演示就绪:修复演示阻塞缺陷 + 全链路实测 + 演示视频与指南 - #24
Merged
Merged
Conversation
added 17 commits
September 7, 2026 22:38
Apply the Arrival Ready design contract (tokens + native CSS, spec FirstGuest_Frontend_Design_Spec_v0.1) to the evidence viewer: AppShell frame, status/severity chips, review action buttons, task panel with workflow badges, bbox evidence figures. All B09/B11 logic, copy and e2e-relied texts unchanged. Adds .link-btn/.detail-label/.table helpers.
Apply the design contract to the audit run view: run status badge, finalize report with Score Ring + D1-D7 dimension bars + blocking alert, retest/diff panel as styled table, findings as severity-dot rows with review badges. All polling, finalize, retest and diff logic byte-identical; e2e texts (待人审, a[href^='/findings/']) preserved.
「与上一轮对比」按钮的 onClick 缺 catch,api.getDiff 失败时成为 未处理的 Promise rejection,页面无任何反馈;与相邻复测按钮对齐, 补 catch + setError。 验证:biome check 18 files 0 问题;tsc --noEmit 通过; next dev 热加载后 http://localhost:3000 服务该修复。
创建 3 个演示店铺(全聚德·前门店/restaurant、中国国家博物馆/museum、 前门中轴线文创/retail),经正式证据链路(upload-url 签名 PUT → complete 校验 magic bytes/sha256)上传 8 张网络图片,全部 READY。 图片运行时下载不入库;按项目名去重,可安全重跑。 验证:python scripts/seed_demo.py 三店 8 份材料全部 READY; 重跑输出「跳过(已存在)」幂等成立;GET /projects 列出 3 家店铺。
…ring)
GET /audits/{id} now returns the scoring frozen at finalize plus top-level
total_score, per the OpenAPI AuditRun schema (契约本就承诺评分快照,实现缺列).
Finalize report gains algorithm_version=adr-0002-v1. Also stops swallowing
ListFindings/PendingReviewCount errors (500 instead of misleading empty view).
Verified: go build/vet/test green; live GET on completed run returns
scoring.dimensions (D2=100, D3=100, coverage 29.41, partial=true).
… payload - READY_FOR_RETEST→RESOLVED now requires a human-confirmed PASS for the same rule key in a child retest run (state-machines.md §4 人工点击不产生 RESOLVED); refusal maps to 409 with a diagnosable message. - Task transitions take the caller's version (optimistic lock; stale → 409). - edit review validates the new status enum; edit→NA keeps the reason requirement; reject requires a note (state-machines.md §3). - DiffEntry gains json tags (parent/child were serialized capitalized, so the UI Before/After table showed placeholders — demo-blocking); diff rows sorted by rule key; org filter added to both sides of the comparison. - Failure-path integration tests for version mismatch and RESOLVED guard; worker suite reset clears review/fix-task rows (FK order in shared DB). Verified: go test -p 1 ./... green incl. new TestTaskVersionMismatchConflicts and TestResolveRequiresRetestPass; live retest diff returns real per-rule statuses.
…honest copy - Completed audits render the frozen score report (previously the score ring vanished ~2s after finalize — the money shot was invisible exactly when the run was done); ScoreCard is shared by both states. - Dimensions with no evaluated weight show 未评 instead of 0 (诚实未知不惩罚). - Audit findings list: per-row quick 确认 for UNREVIEWED candidates (10 page round-trips → one screen), review-status labels in Chinese, subtitle no longer claims 待人审 after disposition. - Polling survives transient request failures (soft banner + retry; only the initial load failure is fatal); action errors render inline instead of replacing the page. - Finding page: 驳回 collects the required note; review labels localized; READY_FOR_RETEST hint states the enforced retest-PASS rule. Verified: biome clean, tsc clean, vitest green; full loop exercised in browser (login → audit → review → finalize → retest → diff → RESOLVED).
…real - dev-e2e.ps1 only sets ARRIVAL_FAKE_MODEL=1 when services/ai/.env has no MODEL_API_KEY — the judge guide previously relaunched the stack in fake mode while DELIVERY.md claims real-model results (自相矛盾). - verify_loop.py replaces the two always-true assertions with real checks: duplicate review must 409, illegal task transition must 409/422. - scripts/demo/: full-loop browser test + retest continuation used for the demo-readiness run (screenshots gitignored).
- docs/demo/arrivalready_demo.mp4 (144s, 1080p, zh narration + burned subtitles) and .srt — the fallback for live-demo failure; tells the full loop with the honest-UNKNOWN story front and center. - docs/demo/DEMO_SCRIPT.md: scene table, 8-minute live demo path, fallback notes (fake/real boundary, real-model latency, immutable runs, protected volumes), regeneration commands. - scripts/demo/video/: reproducible pipeline (Playwright segments with token injection + HTML cards, edge-tts narration, ffmpeg alignment/concat/subtitle burn/loudnorm), scenes.json holds storyboard + narration copy. - README/DELIVERY: current capability statement, judge quickstart with seed script, video links; TODO T-009 closed with verification note; COMMUNICATING S-9 session record.
首版解说词偏专业(哈希指纹/落库/IRRS/run/跨租户),按 docs/PRD_大白话解读 的「给店铺做体检」比喻重写全部旁白与第 9 幕工程卡片文案(分数机器算 / 结果可复现 / 中断接着跑 / 数据各归各家),界面术语保留并口播解释。 重新 TTS + 合成(147.6s)并抽帧复检:字幕同步、卡片换文、音量正常。 Verified: 抽帧核对 s05/s07/s08/s09/s10 字幕与画面对齐;volumedetect mean -21.5dB / max -1.2dB。
面向非技术读者的通俗解读,全程贯穿「给店铺做体检」的比方。 非官方口径:与正式 PRD 不一致处以 01_ArrivalReady_PRD_v0.1.md 为准。
面向路演/评委场景:本机起完整三端(真模型 AI),经 cloudflared 快速隧道把 Web/API/MinIO 暴露为三个临时公网 URL,无需 Cloudflare 账号。URL 写入 %TEMP%/arrival-demo/demo-urls.txt,日志同目录。
基于《PRD 大白话解读》的评委向展示稿:瑞士极简版式,配图取自 演示视频真实界面帧(已裁除烧录字幕)。PPTX 每页内嵌讲稿备注, 与 PDF 同源同版本;README「2 分钟看懂」补入口。
展示稿的中间产物(SVG 源、逐页 PNG、导出备份、预览日志)留在 本地 projects/;最终交付物 arrivalready_showcase.pdf/.pptx 已入 docs/demo/。
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
批次
B12 后续(演示就绪)。依赖:包含 PR #23(B12 UI)之后的 3 个尾提交(930b8a1 种子脚本 / 42df75b diff 错误呈现 / ce387ca D-022 决策登记),合并本 PR 即全量。
演示阻塞修复(评委视角 P0/P1,均有实测)
验证
新增交付物
回滚
revert 本 PR merge commit;无迁移。