Skip to content

docs: align docs site and demo script with the 2:00 demo narration - #13

Merged
KCL1104 merged 1 commit into
mainfrom
docs/demo-script-flow-diagram
Sep 5, 2026
Merged

KCL1104 merged 1 commit into
mainfrom
docs/demo-script-flow-diagram

Conversation

@KCL1104

@KCL1104 KCL1104 commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

依 2:00 影片講稿與現行程式碼更新文件。流程圖「Mello|採購流程」放在文件站首頁「認識 Mello」第一節(apps/docs/public/diagrams/procurement-flow.png),錄影腳本開場引用同一個檔案;README 只修正四處與現行流程不符的敘述,不改版面。

文件站(apps/docs)

  • 認識 Mello:以「x402 解決付款程序,卻進不了採購流程」開場,加入流程圖與「五個階段,Mello 補上什麼」對照表。
  • 採購操作:新增「事前設定:公司、統編與政策」、「人工審核候選清單並送出」、「執行採購與付款」,說明附件只保存不解析、額度與白名單為唯讀政策。
  • 付款、發票與對帳:補 EIP-3009(ERC-3009)授權的限額/限地址/限時間語意、發票台幣等值使用 DEMO_TWD_PER_USDC 示範匯率、三方對帳結果寫入稽核紀錄。
  • 實作範圍:加入設定頁與附件保存;明列附件解析、即時匯率、工作區內編輯額度與白名單不在範圍。
  • 新增 .doc-figure 樣式,圖片以 next/image unoptimized 提供,不需 sharp。

錄影腳本(docs/demo-recording-script.md)

  • 改為 2:00 版六段時間軸:每段列出畫面操作與旁白。
  • 旁白保留講稿原文,只調整三處與實作不符的說法,並保留「講稿與實作的對照」說明理由:額度/白名單唯讀、附件不解析、匯率為示範匯率且畫面不顯示台幣。

README

  • 核心功能第一點、安裝步驟 4/6、限制第一點改為目前的服務優先流程與四項市場分析服務;其餘不動。

驗證

  • @mello/docs:lint(僅既有 <img> 警告)、typecheck、next build 通過。
  • 以 Dockerfile.docs 相同的 standalone 佈局本機啟動:/diagrams/procurement-flow.png 回 200(image/png),首頁含流程圖與新章節,/purchase-guide、/records、/implementation 皆為 200 且含新內容。
  • git diff --check 通過。未觸及 API、Web、合約或部署設定。

🤖 Generated with Claude Code

- Add the procurement flow diagram (需求 → 選供應商 → 付款 → 發票 → 對帳)
  to the docs site overview and reference it as the video opening slide
- Overview: x402 covers payment only; new 五個階段 table maps each stage
  to what Mello adds
- Purchase guide: add company/統編/policy setup, human review of the
  candidate list, and x402 execution sections
- Records: EIP-3009 authorization scope, demo FX rate for the invoice TWD
  equivalent, three-way reconciliation written to audit events
- Implementation scope: list settings page and attachments; exclude
  attachment parsing, live FX and in-workspace policy editing
- Demo script: 2:00 timestamped narration with on-screen operations and a
  script-vs-implementation reconciliation
- README: fix stale flow descriptions (no 開始探索 step, four market
  services)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@KCL1104
KCL1104 merged commit e5f5e46 into main Sep 5, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant