AIタスク #10507
Redmine Admin さんが12日前に更新
親Epic: #10493 関連: #10495 後続: #10508 ## アーキテクチャ 目的 V1へ機能追加しない。V2を独立実装する。 診断結果を専門的かつ行動可能な形へ拡張する。各項目をヒストグラムで可視化し、達成・不足・改善コメントと7段階成熟度を表示する。 ### V1 - 現行 /diagnosis, /api/diagnosis - diagnosis_results - scoring.js - 凍結しロールバック専用 ### V2 - API: POST /v2/diagnosis、GET /v2/diagnosis/:id - DB: diagnosis_runs_v2 - 採点: scoring-v2.js - 契約: schema_version=2、rubric_version固定 - フロント: api/v2/diagnosisのみ使用 ## V2 DB 表示する6観点 個別列を増殖させず、版管理されたJSON契約を保存する。 - id INTEGER PK - url TEXT - schema_version TEXT - rubric_version TEXT - scores_json TEXT - technical_signals_json TEXT - total_score REAL - llm_provider TEXT - error_reason TEXT - created_at TEXT ## 6観点 1. 直接回答性 25% 2. 権威性 20% 3. 独自情報 20% 4. 構造化・意味付け 15% 5. 情報の鮮度 10% 6. AI技術対応力 10% ## AI技術対応力 llms.txtを単独評価しない。次の技術シグナルを複合採点する。 - index可能性/noindex: index可能性/noindex制御: 20 - 主要AI crawler robots許可: AI crawlerのrobots許可: 20 - sitemap発見・取得: 20 - canonical: canonical設定: 15 - HTTPS: 10 - html lang: lang指定: 10 - llms.txt: llms.txt取得: 5 llms.txtは補助要素として扱い、単独評価しない。 ## V2 API contract 総合点の重み - schema_version 直接回答性 25% - rubric_version 権威性 20% - id/url 独自情報 20% - gate 構造化・意味付け 15% - scores: 6観点 情報の鮮度 10% - weights - technical_signals - total_score - maturity - llm_provider/error_reason/created_at V1フィールドを混在させない。 AI技術対応力 10% ## 7段階成熟度 1. 0-14 未開拓の地 2. 15-29 基礎整備前 3. 30-44 対応の入口 4. 45-59 標準対応レベル 5. 60-74 実践・運用レベル 6. 75-89 先進対応レベル 7. 90-100 AI対策最先端 総合点と各項目に段階名、説明、次段階への目安を表示する。 ## UI - 6項目を7segmentヒストグラム表示 6項目をセグメント型ヒストグラムで表示 - 総合点と各項目にLevel/7、段階名、説明、次段階までの点数 現在スコア位置と7段階を明示 - 各項目にできていること/できていないこと/改善方法 各項目に「できていること」「できていないこと」「改善方法」 - AI技術対応力は取得した技術シグナルに一致する具体コメント AI技術対応力は実際に取得した技術シグナルを具体的に表示 - 0点と未評価を区別 - 390/768/1440px対応 ## 受入基準 - V1コード・DB・APIに新機能が混入しない llms.txt単独項目が画面から消え、AI技術対応力の5点要素として統合される - V2新テーブル・API・採点・フロント契約が独立 DB/APIにscore_ai_technicalとtechnical_detailsを追加し、既存データ・旧APIを壊さない - llms.txt単独項目なし 全6項目をヒストグラム表示 - 全6項目ヒストグラム 総合点・各項目で7段階説明 - 総合/各項目7段階 全6項目で達成・不足・改善コメント - コメント3種 技術コメントが実シグナルと一致 - V2 DB/API/採点/フロント単体試験 Node試験、DB migration試験、API互換試験、実ブラウザ3幅、実診断を合格 - 実診断・3幅ブラウザ・バックアップ復元 - Claude Git commit、Claude Code approve、Git/Redmine/Obsidian証跡 - #10508をV1廃止の必須後続とする approve、Redmine証跡