FACTUAL ACTIVITY RECORD · 実際の作業をもとにした活動記録
AI社員9名の写真assetを揃える
lowercaseの名前、WebP、寸法、参照pathを一つのasset contractとして固定する
目的
コーポレートサイトでAI社員のプロフィール写真を扱う前に、9名分の画像を一貫した名前、形式、寸法で参照できるasset directoryが必要だった。
画像の準備と、画面への組み込み、注記、公開表示は別のgateにし、assetが存在するだけで公開準備まで完了したと解釈されない契約を残すことを目指した。
実装
portrait asset群へproject guideと9件の画像を追加した。画像のfilenameは各AI社員のlowercase UI nicknameに.webpを付ける規則へ揃えた。
mako.webp、yui.webp、ryoma.webpshiori.webp、aya.webp、manabu.webpikumi.webp、yasu.webp、ritsu.webp
project guideでは、repository rootを基準とするportrait assetと、サイトから参照する/images/ai-employees/<nickname>.webpを別のinterfaceとして定義した。保存場所とpublic URLを混同しないための境界である。
asset contractは、9件すべてをWebPのVP8画像、1536×1024に統一し、同名PNGやPNG fallbackを使わない構成とした。project guideには、assetの準備、画面への組み込み、注記、公開表示を別々に確認するgateも記載した。
検証では、想定する9つのfilenameと実際のdirectory内容を照合し、missingとextraを数えた。各画像のformatとdimensions、PNG assetの不存在、project guideの2種類のpath、差分の空白errorも確認した。
一次差分を行単位で照合し、ここまで説明した挙動がcutoff時点の変更範囲と一致することを確認した。
確認したこと
確認結果
想定した9つのfilenameが9 / 9揃い、missingとextraはいずれも0件だった。
9件すべてがWebPのVP8画像で、dimensionsは1536×1024だった。同名PNGとPNG fallbackは存在しなかった。
repository-relative pathとpublic URLの区別、asset準備と表示・公開を分けるgate、差分の空白errorがないことを確認した。
cutoff時点で、project guideと9件の画像がasset directoryへ反映された状態を確認した。画面への組み込み、写真に伴う注記の表示、production publicationはこのActivityでは確認していない。
完了とした根拠
project guideと9件の画像がasset directoryに揃い、filename set、format、dimensions、PNGの不存在、参照path、gateの静的検査が完了したことをもって、写真assetを準備する作業範囲を完了とした。