REVISION HISTORYは、SHIHA PROJECTの現在有効な正本と、試作資料、将来構想、置換済み仕様、保存記録の関係を確認するための改訂履歴索引です。
旧仕様は消さない。ただし、現行仕様として復活させない。
現在の判断にはCURRENT正本を使い、旧版は変更理由と検証過程を追跡するために保存します。
このページの役割
- 現在有効なRevisionと、置換された旧Revisionの関係を示す。
- 試作・比較案・将来構想をCURRENT仕様と混同しないようにする。
- 変更前の設計、判断根拠、互換性、移行対象を追跡できるようにする。
- 過去資料から旧仕様だけが切り取られて復活することを防ぐ。
- DEVLOG、CURRENT SPECIFICATIONS、CHRONICLEとの役割を分離する。
情報の参照先
| 知りたいこと | 参照先 |
|---|---|
| 現在何が正しいか | CURRENT SPECIFICATIONSとRecord StatusがCURRENTの正本 |
| 複数分野で共有する規則 | STANDARDS & INTERFACES |
| なぜ変更したか | 関連DEVLOG |
| 何を製作・試験したか | DEVLOGとPROTOTYPE資料 |
| 旧版と現行版の違い | REVISION HISTORY |
| 出来事や節目の意味 | CHRONICLE |
固定ページのRecord Status
| Status | 意味 | 設計での使用 |
|---|---|---|
| CURRENT | 現在の判断・製作で参照する現行正本 | 使用する。完成品であるとは限らない |
| PROTOTYPE | 試作、比較、実測、調整中の資料 | 検証には使用するが正式製作値としない |
| CONCEPT | 将来構想、理想形、未確定案 | 方向性の検討に限り、実装済みとみなさない |
| SUPERSEDED | 新しい仕様へ置き換えられた旧版 | 現行設計へ使用しない |
| ARCHIVED | 終了・保存された参照記録 | 履歴調査に限って使用する |
Revisionを更新する条件
次のいずれかが変わる場合は、正本のRevision更新対象とします。Rev.番号の具体的な増分方法は、全体の採番規則が確定するまで既存文書の慣例を維持します。
- 採用する寸法、基準面、座標、Clearance、許容範囲
- 構造、機構、材料、部品、配置、荷重経路
- 電源、通信、AIR、Connector、Pin、Interface条件
- 安全条件、Limit、E-STOP、Interlock、試験判定
- Identity、Canonical Memory、権限、Action、Recovery方針
- 互換性、接続先、着脱・整備・搬送方法
- 公開時の意味が変わる説明、Status、Reality、権利条件
Revisionを上げない修正
設計内容や判断を変えない誤字、表記統一、Link切れ、代替Text、HTML構造等の修正は、必ずしもRevision更新を必要としません。ただし、修正日と内容を管理記録へ残し、意味が変わっていないことを確認します。
- 単純な誤字・脱字・句読点
- 同一対象の表記ゆれ修正
- 移転していない同一正本へのLink修正
- 内容を変えないGutenberg・HTML・見出し構造の修正
- 仕様解釈を変えないアクセシビリティ改善
数値、単位、否定表現、Status、対象範囲、安全条件の修正は、誤記に見えても設計へ影響する可能性があるため、Revision更新の要否を必ず確認します。
置換関係に必要な情報
| 項目 | 記録内容 |
|---|---|
| Document ID | 同一文書系列を識別するID |
| Revision | 対象時点の版 |
| Record Status | CURRENT / SUPERSEDED等の位置づけ |
| 変更日 | 新Revisionを現行化した日 |
| 変更概要 | 何が変わったかの短い説明 |
| 変更理由 | 関連DEVLOGへのLink |
| 後継正本 | 現在有効なページへのLink |
| 互換性 | 既存部品、データ、治具、手順への影響 |
互換性の扱い
- 互換性がある変更でも、適用開始Revisionと確認試験を記録する。
- 互換性がない場合は、対象部品・データ・治具・Cable・Softwareを明示する。
- Adapterで吸収する場合は、Adapter自体を管理対象として識別する。
- 新旧を同時運用する場合は、誤接続防止と識別表示を設ける。
- 安全・電源・支持・熱・認証に関わる非互換変更は、実装前にFMEAを行う。
旧仕様を復活させないために
- 検索結果や過去会話だけで採用値を判断せず、CURRENT正本を確認する。
- 旧図面・STL・部品表・画像へSUPERSEDEDまたはARCHIVEDを表示する。
- Filenameだけに依存せず、Document ID、Revision、Statusを併記する。
- 比較のため旧版を引用するときは、旧版であることと後継正本を明示する。
- 旧版の一部を再採用する場合も、新しいCURRENT Revisionの正式変更として処理する。
媒体別のRevision
| 対象 | Revision管理 |
|---|---|
| 固定ページ | Document ID、Revision、Record Status、Document Kind |
| 設計画像 | Asset ID、Asset Revision、Media Status、Reality |
| 3Dデータ | 部位、左右、用途、Datum、Revision、単位、派生元 |
| Theme / Plugin | Version、Changelog、基準Version、検証結果 |
| DEVLOG | 投稿日、Component、Status、関連CURRENT正本 |
現在の運用状態
| Record Status | CURRENT |
|---|---|
| Development Status | COMPLETE |
| 確定済み | 正本・変更理由・旧版・出来事の役割分離、CURRENT優先、旧版保存、SUPERSEDED管理 |
| 継続運用 | Document Metadata登録、旧版保存、後継Link、互換性記録 |
| 未確定 | Document ID、全体共通のRev.番号増分規則、自動的な置換関係Metadata |