バージョン比較（差分表示）機能要件定義

30-仕様書 Public

最終更新: 2025/08/13

---
title: 'バージョン比較（差分表示）機能 要件定義'
slug: feature-requirements-version-diff
status: public
author: loga-protocol
category: specification
purpose: 2つの異なるバージョン間の変更点を視覚的にハイライト表示することで、ユーザーが改訂履歴を直感的に把握できるようにする。
summary: 何が変わり、何が変わらなかったのか。思考の進化の軌跡を可視化する、究極のタイムマシン「差分表示」機能の設計図。
id: 20250808125047-68957417c7b214.35791394
image: /syntext-assets/images/cards/20250808125047-68957417c7b214.35791394.jpg
created_at: '2025-08-08 12:50:47'
updated_at: '2025-08-13 12:24:27'
---
0. (idea) **バージョン比較（差分表示）機能 要件定義** 📜
1. (s) (why) 1. 目的とゴール
  11. (g) 変更点の可視化: どの行が追加・削除・変更されたかを、色分けなどで明確に表示する。
    111. (g) レビューの効率化: 共同編集者やクライアントが、前回のバージョンからの変更点を迅速に確認できるようにする。
    112. (g) 思考プロセスの内省: ユーザー自身が、自分の思考がどのように変化・発展したかを振り返るためのツールを提供する。
2. (s) (what) 2. 機能要件
  21. (s) UI/UX
    211. (s) stxt閲覧ページのバージョン履歴メニューに、「比較」モードを追加する。
      2111. (s) ユーザーが比較したい2つのバージョンを選択できるインターフェースを用意する。（例：チェックボックス）
        21111. (s) 比較結果は、左右に並べた「Side by Side」形式で表示する。
          211111. (g) 追加された行は緑色でハイライトする。
            2111111. (r) 削除された行は赤色でハイライトする。
    212. (s) 技術要件
      2121. (action) PHP差分ライブラリの導入: `jblond/php-diff` などの実績あるライブラリをComposerでプロジェクトに導入する。
        21211. (action) 新しいルートの作成: `/stxt/compare/{stxt_id}/{version_id_from}/{version_id_to}` のようなURLを処理するロジックを`index.php`に追加する。
        21212. (action) 新しいテンプレートの作成: 比較結果を表示するための `templates/pages/stxt/compare.php` を新規作成する。
    213. (s) データフロー
      2131. (s) `index.php`は、URLから2つのバージョンIDを取得し、`stxt_versions`テーブルからそれぞれの`full_content`を取得する。
        21311. (s) 取得した2つのテキストをPHPライブラリに渡し、差分を計算させたHTMLを生成する。
        21312. (s) 生成された差分HTMLを`compare.php`テンプレートに渡して描画する。
3. (s) (scope) 3. スコープ外
  31. (x) リアルタイムでの差分表示。
    311. (x) 差分表示画面からの直接編集機能。

バージョン比較（差分表示）機能 要件定義

SUMMARY

バージョン比較（差分表示）機能要件定義