機能 #10513
未完了
[VEND-V2-03] 診断項目説明・実測根拠コメント・成熟度文言改善
Redmine Admin さんが12日前に追加.
12日前に更新.
説明
親Epic: #10493
先行: #10512
診断結果の意味を非専門家にも理解でき、具体的な改善判断へ使える文章へ改修する。
- 各項目に定義を表示。「直接回答性とは、想定質問に結論を明確・簡潔に返せる度合いです。」等
-
レベル2相当まで高まっていますのような抽象表現を廃止
- 成熟度は影響を明記。例:
AI対策が未整備で、AI検索から引用・言及される可能性が低い状態です。基礎整備が必要です。
- できていること/できていないことには実際の測定シグナルを列挙
-
著者情報、運営者情報、外部根拠は十分対策されています。監修方針は改善余地があります。のように具体化
- LLM評価項目も、判定可能な下位シグナルをAPIで構造化して保存・表示する設計を検討
- 断定の根拠を画面に明記
受入基準¶
- 全6項目に定義
- 全7段階に影響説明
- 抽象的なレベル言及のみのコメント0件
- 測定項目名と結果を具体表示
- スコア・コメント矛盾なし
- 実ブラウザ・Claude Codeレビュー合格
[要件追加] AIOの具体的な便益とベストプラクティス集
利用者に「AIOを行うと何が起きるのか」を抽象論ではなく、実際の検索・相談シーンとサービス名の提示例で理解させる。
コンテンツ要件¶
- セクション見出し例:
AIOを行うと、AIの回答候補として見つけてもらいやすくなります
- 実例:
メルマガを配信したいという相談に対してblastmailのような具体的サービス名が公式サイトへのリンク付きで紹介されるケース
- 地域ビジネス例: ホームページ制作会社が、
地元でホームページを作ってくれる業者を探してという相談の回答候補に表示されるケース
- EC、士業、SaaS、製造業、医療・介護、採用等にも展開
- 誇大表現を避け、
引用・紹介を保証するものではないことを明記
- 単なるサービス名羅列ではなく、AIが推薦しやすい情報設計を示す
ベストプラクティス集¶
- 誰向け・何ができる・何が違うを冒頭で明示
- サービス名、会社名、対象地域、料金、導入条件を具体化
- 比較表、導入事例、実測データ、FAQを公開
- 運営者、著者、監修者、根拠、更新日を明示
- Organization/Product/Service/Article/FAQ等の構造化データ
- canonical、sitemap、robots、lang、HTTPS等の技術基盤
- AIが引用可能な短い結論文と詳細説明を併記
- ページ間で名称・価格・対象範囲を統一
表示案¶
診断結果下部または説明セクションに、相談例→AI回答例→期待できる効果→実施すべき対策、の4段構成カードを配置する。
受入基準追加¶
- 具体例5件以上
- 実名サービス例を少なくとも1件含む
- すべてに期待効果と対応策を併記
- 誇大保証表現なし
- 外部リンクはnoopener/noreferrer、表示URL・リンク先を検証
着手。診断項目の定義、成熟度の影響説明、実測根拠コメント、AIO具体例・ベストプラクティス集を同一リリースで実装する。
- ステータス を 進行中 から 解決 に変更
- 進捗率 を 0 から 100 に変更
[開発リード最終検収 2026-07-27 JST]
VERDICT: approve / Blockingなし
- 新規診断を schema_version=2.1 / rubric_version=ai-citation-2026.2へ更新
- 直接回答性、権威性、独自情報、構造化、鮮度の15測定根拠を evidence_signals として追加
- public evidence itemは
{status} のみ。raw HTML、URL、日付、prompt、header、secretは非公開
- 既存V2テーブルへ evidence_signals_json を冪等追加。旧2.0行はversion維持、evidence nullで取得可能
- LLMは未信頼本文分離とstrict 8-key応答、max_tokens=240
- 6指標の定義を表示
- 成熟度コメントを利用者影響中心へ改修し、
レベルN相当等を廃止
- pass/fail/unknownの実測項目名から、できていること・不足・改善策を具体生成
- 旧診断はスコアから根拠を推測せず再診断案内
- AIO具体例5件、ベストプラクティス8件を常時表示
- ブラストメール公式リンクをnoopener/noreferrer付きで表示
コミット・本番¶
- source ce6fc23 feat(vend): add evidence-based AIO guidance
- public 33fb0f4 feat(vend01): publish evidence-based AIO guidance
- API image sha256:9d25c119bc5feb06b48a9c2ddb32cf4c54f9812465227ced6cedbcb9bd721e15
- rollback image vend01-vend01-api:pre-10513
- frontend 24/24
- backend/DB migration/SSRF/prompt 19/19 Node20 Docker
- independent review approve / Blockingなし
- 実Gateway候補実行成功
- 公開API: malformed URL 400、DB未保存
- 旧V2 id=1: schema2.0/rubric2026.1/evidence nullを維持
- 新V2: schema2.1/rubric2026.2、全6score numeric、15 evidence exact
{status}
- V1 GET 200
- Chromium: AIO例5、各4見出し、best practice8、safe external link
- 診断: 定義6、具体測定項目、抽象レベル文言0、radar 7層/6軸/6頂点
- 390/768/1440px横溢れ0、JS/MIMEエラー0
- DB integrity ok
- DB backup /root/backup/website-vending-machine/20260727-1038-10513
- frontend backup /root/backup/website-vending-machine/20260727-1040-10513/frontend
- browser /root/backup/website-vending-machine/20260727-1043-10513/browser
受入基準を満たしたため解決。次は#10514。
進捗: 2026-07-27 JST #10513本番完了。schema2.1/rubric2026.2、15 evidence_signals、厳格8-key LLM契約、V2 DB冪等migration、旧2.0互換。6指標定義、利用者影響中心の成熟度文、実測根拠コメント、AIO具体例5件・best practice8件を公開。source ce6fc23、public 33fb0f4、API image 9d25c119。frontend24/24、backend19/19 Node20、independent review approve。公開API新旧V2/V1・不正URL、Chromium 390/768/1440、DB integrity、ログ漏洩を検収。次は#10514 サイト種別・業種・所在地/商圏入力。
他の形式にエクスポート: Atom
PDF