 みてるぞ
|
2979fbac34
|
#389
|
2026-07-01 12:46:10 +09:00 |
|
|
みてるぞ
|
776dea87d9
|
素材管理 (#306) (#381)
開発環境では、**DB を壊さない前提で、migration → API → 画面 → 同期 → ZIP → 履歴**の順に見るのがよいです。今回の差分は素材管理全体に触っているので、単体でチョンチョン見るより、素材の一生を通すのが早いです。
## 0. 先に方針
**やらないこと:**
```sh id="snb3i6"
rails db:drop
rails db:reset
rails db:setup
DISABLE_DATABASE_ENVIRONMENT_CHECK=1 ...
```
これは禁止。
開発 DB に本番データを入れているなら、床板を剥がして耐震確認するようなものです。
---
## 1. migration 確認
まず現在の状態を見る。
```sh id="qsdfpt"
cd backend
RAILS_ENV=development bundle exec rails db:migrate:status
```
その後、通常 migration。
```sh id="a89fir"
RAILS_ENV=development bundle exec rails db:migrate
```
見るポイント:
```txt id="c1u57a"
materials に source_* / normalized_source_key / version_no がある
material_versions に event_type / file snapshot / source snapshot がある
material_export_items がある
material_sync_suppressions がある
material_sync_sources がある
既存 materials に material_versions version_no=1 create が backfill されている
```
確認用:
```sh id="g4vd4m"
RAILS_ENV=development bundle exec rails runner '
puts "materials=#{Material.count}"
puts "versions=#{MaterialVersion.count}"
puts "materials without versions=#{Material.left_joins(:material_versions).where(material_versions: { id: nil }).count}"
puts "sync suppressions table=#{ActiveRecord::Base.connection.table_exists?(:material_sync_suppressions)}"
'
```
ここで `materials without versions=0` になれば、backfill は通っています。
---
## 2. 既存素材一覧の画面確認
フロントを起動して `/materials` を見る。
```sh id="vl28jd"
cd frontend
npm run dev
```
見る観点:
```txt id="i2ovxw"
初期表示で素材が出る
初期表示ではグルーピングがオフ
タグなし素材も出る
カード表示でサムネまたは代替テキストが出る
一覧表示に切り替えられる
q / tag_state / media_kind / sort / direction が効く
```
ここでまず、普通の素材一覧が壊れていないことを確認します。
---
## 3. 左タグバーの確認
`/materials` を開いて左タグバーからタグを選ぶ。
見る観点:
```txt id="n6udul"
URL が tag_id=...&include_descendants=1&group_by=parent_tag になる
選択中タグが左バーで強調される
一覧上部に「選択中」の表示が出る
「タグ選択を解除」で通常表示に戻れる
解除後、tag_id / include_descendants / group_by / page が消える
子タグ・孫タグの素材も一覧に出る
親タググルーピングされる
```
特に重要なのはこれ。
```txt id="d33os0"
親タグ A を選択
A に直接紐づく素材
A > B に紐づく素材
A > B > C に紐づく素材
が同じ一覧に出ること
```
---
## 4. 選択タグから素材追加
左タグからタグを選択した状態で、一覧上部の **このタグに素材を追加** を押す。
見る観点:
```txt id="qdd5uw"
素材追加画面の tag 欄に選択中タグ名が初期入力されている
file または url を指定して保存できる
保存後 return_to で元のタグ選択済み一覧に戻る
戻った一覧に追加した素材が出る
material_versions に create が 1 件できる
```
Rails console でも確認できます。
```sh id="i07rrb"
RAILS_ENV=development bundle exec rails runner '
m = Material.order(id: :desc).first
puts({ id: m.id, tag: m.tag&.name, versions: m.material_versions.count, version_no: m.version_no }.inspect)
'
```
---
## 5. グループ見出しから素材追加
親タググルーピング表示中に、各グループ見出しの **このタグに素材を追加** を押す。
見る観点:
```txt id="fpx8w4"
グループタグ名が tag 欄に初期入力される
保存後、元の一覧に戻る
追加素材がそのグループ内に出る
```
ここは今回の導線の肝です。棚の見出しから直接その棚へ素材を置けるかを見る。
---
## 6. 素材更新と履歴
既存素材の詳細または編集導線から、タグ・URL・ファイル・export path を更新する。
見る観点:
```txt id="w36i61"
更新前 snapshot が無ければ create が補われる
更新後 update version ができる
file_blob_id / file_filename / file_sha256 が material_versions に入る
export_paths_json が履歴に残る
/materials/changes または /materials/versions で履歴が見える
```
console:
```sh id="a3okhv"
RAILS_ENV=development bundle exec rails runner '
m = Material.order(updated_at: :desc).first
puts m.material_versions.order(:version_no).map { |v|
[v.version_no, v.event_type, v.tag_name, v.file_filename, v.file_sha256, v.export_paths_hash]
}.inspect
'
```
---
## 7. サムネイル
画像素材を追加して、一覧にサムネイルが出るか確認。
動画素材があるなら、`ffmpeg` が入っている環境で backfill。
```sh id="qxm8fj"
cd backend
RAILS_ENV=development bundle exec rails materials:thumbnails:backfill
```
見る観点:
```txt id="s9a1vf"
画像は 180x180 のサムネが付く
動画はフレームからサムネが作られる
非対応ファイルは代替テキスト表示になる
ログに result が出る
```
---
## 8. ZIP export
export path がある素材を用意して、ブラウザで確認。
```txt id="aq7f7o"
/materials/download.zip?profile=legacy_drive
```
見る観点:
```txt id="h4rve5"
ZIP が落ちる
entry path が material_export_items.export_path になる
disabled な export item は入らない
ファイル実体が欠けている場合は 422 と missing_files が返る
```
---
## 9. 抑止
`/materials/suppressions` で path prefix 抑止を追加する。
見る観点:
```txt id="w80jbu"
member で作成できる
guest は forbidden / unauthorized
google_drive_path_prefix で既存素材が discard される
discard 履歴が material_versions に残る
同期時に同じ source_path 配下が再作成されない
```
---
## 10. Google Drive 同期
開発環境では、まず小さいフォルダでやるのがよいです。
いきなり本番素材集フォルダを食わせると、ログが藪になります 🌿
必要な ENV:
```sh id="kzbb7f"
GOOGLE_DRIVE_SERVICE_ACCOUNT_EMAIL=...
GOOGLE_DRIVE_PRIVATE_KEY_PATH=...
MATERIAL_SYNC_SOURCE_KIND=google_drive_path
MATERIAL_SYNC_SOURCE_FILE_ID=<folder_id>
MATERIAL_SYNC_SOURCE_NAME=dev-small-folder
MATERIAL_SYNC_SOURCE_PROFILE=legacy_drive
```
seed で source 作成、または console で作成。
```sh id="sec40c"
RAILS_ENV=development bundle exec rails db:seed
RAILS_ENV=development bundle exec rails materials:sync
```
見る観点:
```txt id="a5ltqu"
imported / updated / unchanged / suppressed / failed がログに出る
2 回目実行で unchanged が増える
tag は nil のままでも保存できる
人手で tag / url を付けた既存同期素材が、再同期で消えない
Google native file は skip される
download 後 sha256 block が効く
```
---
## 11. schema.rb は別途確認
これはテストというより merge gate です。
今回まだ怪しいので、差分に以下が混ざっていないことを確認します。
```txt id="s3k6da"
wiki_assets 削除
wiki_pages.next_asset_no 削除
素材管理と無関係な CHECK constraint 削除
素材管理と無関係な index order 消失
```
ここが残るなら、機能テストが通っても merge は止めた方がいいです。
---
## 最小テスト順
時間がないなら、この順で十分です。
```txt id="c1k2pw"
1. db:migrate
2. materials without versions = 0 を確認
3. /materials 初期表示
4. 左タグ選択 → 子孫込み表示 → グルーピング
5. タグ選択解除
6. 選択タグから素材追加 → return_to で戻る
7. グループ見出しから素材追加
8. 更新して material_versions を確認
9. ZIP export
10. 小さい Drive folder で materials:sync を 2 回
```
これで、今回の差分の主要な導線はほぼ踏めます。
Reviewed-on: #381
Co-authored-by: miteruzo <miteruzo@naver.com>
Co-committed-by: miteruzo <miteruzo@naver.com>
|
2026-06-28 06:35:53 +09:00 |
|
|
みてるぞ
|
7ab46f907f
|
グカネータ公開 (#361) (#368)
Reviewed-on: #368
Co-authored-by: miteruzo <miteruzo@naver.com>
Co-committed-by: miteruzo <miteruzo@naver.com>
|
2026-06-14 05:33:39 +09:00 |
|
|
みてるぞ
|
37ade2a988
|
グカネータ作成 (#041) (#362)
Reviewed-on: #362
Co-authored-by: miteruzo <miteruzo@naver.com>
Co-committed-by: miteruzo <miteruzo@naver.com>
|
2026-06-10 23:33:56 +09:00 |
|
|
みてるぞ
|
3980e9651e
|
上映会改修 (#302) (#357)
Reviewed-on: #357
Co-authored-by: miteruzo <miteruzo@naver.com>
Co-committed-by: miteruzo <miteruzo@naver.com>
|
2026-06-07 02:51:25 +09:00 |
|
|
みてるぞ
|
750aa40e8e
|
フォームのバリデーションとニコ連携の画面変更 (#090) (#355)
Reviewed-on: #355
Co-authored-by: miteruzo <miteruzo@naver.com>
Co-committed-by: miteruzo <miteruzo@naver.com>
|
2026-06-05 01:59:46 +09:00 |
|
|
みてるぞ
|
add60cb413
|
#155
|
2026-05-11 03:32:47 +09:00 |
|
|
みてるぞ
|
e03cc01109
|
投稿排他 (#171) (#345)
#171
#171
#171
#171
#171
#171
#171
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #345
|
2026-05-10 11:16:49 +09:00 |
|
|
みてるぞ
|
52aa1615b6
|
ニジラー詳細ページ作成 (#63) (#341)
#63
#63
#63
#63
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #341
|
2026-05-04 03:37:12 +09:00 |
|
|
みてるぞ
|
6235b293f0
|
タグ履歴ページ (#321) (#330)
#321
#321
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #330
|
2026-04-24 02:21:26 +09:00 |
|
|
みてるぞ
|
43cd38a216
|
タグ詳細 (#318) (#328)
#318
#318
#318
#318
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #328
|
2026-04-23 00:06:49 +09:00 |
|
|
みてるぞ
|
e72ec608f4
|
利用規約（#95） (#311)
#95
#95
#95
#95
#95
Merge remote-tracking branch 'origin/main' into feature/095
#95
#95
#95
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #311
|
2026-04-14 12:31:48 +09:00 |
|
|
みてるぞ
|
e021423904
|
スマホ・レーアウト・バグ（#304） (#305)
#304
#304
#304
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #305
|
2026-04-11 16:58:41 +09:00 |
|
|
みてるぞ
|
7b15cb2c5a
|
素材管理（#99） (#303)
#99
#99
#99
#99
#99
#99
#99
#99
#99
#99
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #303
|
2026-04-07 07:44:50 +09:00 |
|
|
みてるぞ
|
ee93ff8ea0
|
タグ一覧ページの作成（#61） (#298)
#61
#61
Merge remote-tracking branch 'origin/main' into feature/061
#61
#61
#61
#61
#61
#61
#61
#61
#61
#61
日づけ不詳の表示修正
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #298
|
2026-03-21 19:58:02 +09:00 |
|
|
みてるぞ
|
8cf7107445
|
上映会のし組み作り（#295） (#296)
#295
#295
#295
#295
#295
#295
#295
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #296
|
2026-03-18 23:01:04 +09:00 |
|
|
みてるぞ
|
9e3cbd2469
|
投稿検索ページ（#206） (#274)
#206 エラー修正
#206 updated_at の並び順修正
Merge remote-tracking branch 'origin/main' into feature/206
Merge branch 'main' into feature/206
Merge branch 'main' into feature/206
Merge branch 'main' into feature/206
#206
#206
#206
#206
#206
#206 タグ補完追加
#206
#206
#206
#206
#206
Merge remote-tracking branch 'origin/main' into feature/206
#206
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #274
|
2026-03-08 23:12:16 +09:00 |
|
|
みてるぞ
|
eb975e5301
|
プリフェッチ実装（#140） (#256)
Merge branch 'main' into feature/140
#140
Merge remote-tracking branch 'origin/main' into feature/140
#140
#140
#140
#140
#140
Merge remote-tracking branch 'origin/main' into feature/140
#140
#140
#140
#140
#140
#140
#140
#140
#140
#140
#140
Merge remote-tracking branch 'origin/main' into feature/140
Merge remote-tracking branch 'origin/main' into feature/140
#140 ぼちぼち
Merge remote-tracking branch 'origin/main' into feature/140
#140
#140
#140
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #256
|
2026-02-11 13:27:28 +09:00 |
|
|
みてるぞ
|
797e67ac37
|
アニメーション（#139） (#252)
#139
#139
#139
#139
#139
Merge branch 'feature/140' into feature/139
Merge remote-tracking branch 'origin/main' into feature/139
#140
Merge remote-tracking branch 'origin/main' into feature/140
Merge remote-tracking branch 'origin/main' into feature/140
#140 ぼちぼち
Merge remote-tracking branch 'origin/main' into feature/140
#140
#140
#140
#139 アニメーション
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #252
|
2026-02-05 23:25:27 +09:00 |
|
|
みてるぞ
|
f36837f0d8
|
feat: 耕作履歴ページ作成（#112） (#177)
#112 現在ページの表示を太く
#112 完了
Co-authored-by: miteruzo <miteruzo@naver.com>
Reviewed-on: #177
|
2025-12-14 03:49:03 +09:00 |
|
|
みてるぞ
|
7e2d94fdc0
|
#49
|
2025-08-23 18:40:03 +09:00 |
|
|
みてるぞ
|
e79688783e
|
#49
|
2025-08-23 18:01:23 +09:00 |
|
|
みてるぞ
|
2570323e3a
|
#23
|
2025-07-19 23:39:19 +09:00 |
|
|
みてるぞ
|
1a965146dc
|
#23
|
2025-07-19 23:26:18 +09:00 |
|
|
みてるぞ
|
315d511f41
|
#24
|
2025-07-17 04:51:57 +09:00 |
|
|
みてるぞ
|
9e0eb3b3c5
|
#77
|
2025-07-13 17:18:02 +09:00 |
|
|
みてるぞ
|
0c46cf28db
|
#49
|
2025-07-13 02:46:13 +09:00 |
|
|
みてるぞ
|
fdf242c060
|
#49
|
2025-07-11 10:11:22 +00:00 |
|
|
みてるぞ
|
3c89d14636
|
#77
|
2025-07-11 02:05:16 +09:00 |
|
|
みてるぞ
|
57070ed49b
|
#32
|
2025-07-08 02:40:49 +09:00 |
|
|
みてるぞ
|
191e5d3a76
|
#32
|
2025-07-06 19:57:20 +09:00 |
|
|
みてるぞ
|
0002cbd924
|
#32
|
2025-07-04 00:54:59 +09:00 |
|
|
みてるぞ
|
7af66db498
|
#24
|
2025-07-02 00:10:49 +09:00 |
|
|
みてるぞ
|
72a567e519
|
#49 ページの移動
|
2025-06-28 02:43:57 +09:00 |
|
|
みてるぞ
|
8020586ec6
|
#49 ぼちぼち
|
2025-06-28 02:32:40 +09:00 |
|
|
みてるぞ
|
6e6ee73857
|
#45 完了
|
2025-06-25 02:52:51 +09:00 |
|
|
みてるぞ
|
c6f7e8a696
|
#45 API ぼちぼち
|
2025-06-18 06:20:51 +09:00 |
|
|
みてるぞ
|
ceeefa9b7c
|
#44 完了
|
2025-06-17 02:30:26 +09:00 |
|
|
みてるぞ
|
729bb5e4ca
|
#43 完了
|
2025-06-15 22:34:00 +09:00 |
|
|
みてるぞ
|
fe8739b290
|
#19
|
2025-06-15 14:24:41 +09:00 |
|
|
みてるぞ
|
32ed235807
|
#30 #31 完了
|
2025-06-13 01:36:53 +09:00 |
|
|
みてるぞ
|
3363fcd2ae
|
#26 完了
|
2025-06-12 00:46:06 +09:00 |
|
|
みてるぞ
|
5b8a560024
|
#19 トップバーと新規作成ちょっとだけ
|
2025-06-10 01:23:24 +09:00 |
|
|
みてるぞ
|
39dce3a39f
|
#19 ひとまづ表示のみ
|
2025-06-08 05:51:03 +09:00 |
|
|
みてるぞ
|
5a3f79e7c7
|
#30 共通から外すとこだけ
|
2025-06-07 21:10:14 +09:00 |
|
|
みてるぞ
|
b61027be4b
|
#19
|
2025-06-07 18:54:10 +09:00 |
|
|
みてるぞ
|
0afba7f345
|
#14 ぼちぼち
|
2025-06-03 01:56:49 +09:00 |
|
|
みてるぞ
|
f93cea4e51
|
#22 完了
|
2025-05-30 01:21:30 +09:00 |
|
|
みてるぞ
|
ef38202815
|
#11 完了
|
2025-05-29 01:00:01 +09:00 |
|
|
みてるぞ
|
03c2434236
|
#11
|
2025-05-28 02:29:14 +09:00 |
|