#360

Reviewed-on: #382

AGENTS.md

@@ -132,6 +132,10 @@ npm run preview
 - Tabs are only for leading indentation, never for spaces after non-space text.
 - TypeScript and TSX imports may stay on one line if they remain within the
   line limit; do not expand short type-only imports mechanically.
+- In TypeScript and TSX, when breaking a line at an operator, break before the
+  operator and put the operator at the beginning of the next line. A trailing
+  operator at end of line is unacceptable. This rule does not apply to Ruby,
+  where it can change the syntactic structure.
 - In TypeScript and TSX, when a function takes one destructured object
   argument plus an inline type, prefer this shape when it fits locally:
 
@@ -231,6 +235,22 @@ const value =
 - Keep page-level code under `frontend/src/pages` and shared UI/feature code
   under `frontend/src/components` unless existing patterns point elsewhere.
 - Match existing Tailwind, component, and import alias conventions.
+- `<a href="#">` is acceptable for event-only controls when it fits the local
+  UI pattern. Do not use `<a>` for internal navigation or other non-external
+  links.
+- Internal links must use `PrefetchLink`.
+- External links must use `<a>` with `target="_blank"`.
+- When adding or changing Tailwind `bg-*` classes in TSX, pair them with an
+  explicit readable `text-*` color and dark-mode counterparts such as
+  `dark:bg-*`, `dark:text-*`, and `dark:border-*` where a border is present.
+- Do not rely on inherited text color for light backgrounds. This is especially
+  important for chips, cards, buttons, and panels that may inherit white text in
+  dark mode.
+- Mobile UI must be checked as a first-class layout. Avoid wide fixed content,
+  make dense controls wrap or scroll intentionally, and keep tag/filter
+  controls usable without horizontal page overflow.
+- For mobile horizontal scrollers, make the scroll direction and item sizing
+  explicit, and ensure chip text remains readable in both light and dark modes.
 - In TypeScript and TSX, prefer direct comparison operators such as `===` and
   `!==` over negating a comparison like `!(a === b)`.
 - In TypeScript and TSX, prefer `++i` or `--i` over `i += 1` or `i -= 1` for
@@ -248,7 +268,25 @@ const value =
 - Put two blank lines before and after top-level `const` function
   declarations, unless imports, exports, or file boundaries make that awkward.
 - In TSX, indent with 4-space logical indentation.
+- In TypeScript and TSX, convert every leading run of 8 spaces to a tab
+  character.
 - A leading tab is exactly equivalent to 8 leading spaces.
+- In TypeScript and TSX function declarations, including `const` arrow
+  function declarations, when the parameter list spans multiple lines, always
+  put the closing parenthesis at the beginning of its own line before the return
+  type or `=>`.
+- In TypeScript and TSX, never place a closing parenthesis at the beginning of
+  a line except for a multi-line function declaration parameter list.
+- Never place a closing square bracket at the beginning of a line.
+- For object literals and other associative-array-style braces, do not place
+  the closing brace at the beginning of a line. Function, lambda, callback, and
+  block closing braces are exempt and should stay on their own line when that
+  fits the local style.
+- When writing braces on a single line in TypeScript or TSX JavaScript
+  context, put exactly one space inside the braces, as in `{ value }` or
+  `{ key: value }`.
+- Do not add inner spaces to React/JSX expression braces, as in
+  `prop={value}`, `{children}`, or `<Component>{{...props}}</Component>`.
 - Keep a tag's closing marker on the same line as the final prop when the tag
   spans multiple lines.
 - Do not put `/>` or `>` on its own line unless the existing surrounding code

backend/app/controllers/material_sync_suppressions_controller.rb

@@ -0,0 +1,49 @@
+class MaterialSyncSuppressionsController < ApplicationController
+  def index
+    return head :unauthorized unless current_user
+    return head :forbidden unless current_user.gte_member?
+
+    suppressions =
+        MaterialSyncSuppression
+        .includes(:created_by_user)
+        .order(created_at: :desc, id: :desc)
+
+    render json: { suppressions: suppressions.map { |s| repr(s) } }
+  end
+
+  def create
+    return head :unauthorized unless current_user
+    return head :forbidden unless current_user.gte_member?
+
+    suppression =
+        MaterialSyncSuppressionRegistrar.create!(suppression_params,
+                                                 created_by_user: current_user)
+
+    render json: repr(suppression), status: :created
+  rescue ActiveRecord::RecordInvalid => e
+    render_validation_error e.record
+  end
+
+  private
+
+  def suppression_params
+    params.permit(:source_kind,
+                  :source_uri,
+                  :drive_path,
+                  :drive_file_id,
+                  :reason)
+  end
+
+  def repr suppression
+    { id: suppression.id,
+      source_kind: suppression.source_kind,
+      source_uri: suppression.source_uri,
+      drive_path: suppression.drive_path,
+      drive_file_id: suppression.drive_file_id,
+      normalized_source_key: suppression.normalized_source_key,
+      reason: suppression.reason,
+      created_by_user: suppression.created_by_user&.as_json(UserRepr::BASE),
+      created_at: suppression.created_at,
+      updated_at: suppression.updated_at }
+  end
+end

backend/app/controllers/material_versions_controller.rb

@@ -0,0 +1,54 @@
+class MaterialVersionsController < ApplicationController
+  def index
+    page = (params[:page].presence || 1).to_i
+    limit = (params[:limit].presence || 20).to_i
+
+    page = 1 if page < 1
+    limit = 1 if limit < 1
+
+    offset = (page - 1) * limit
+
+    q = MaterialVersion.includes(:created_by_user)
+    q = q.where(material_id: params[:material_id]) if params[:material_id].present?
+    q = q.where(tag_name: params[:tag].to_s.strip) if params[:tag].present?
+    q = q.where(event_type: params[:event_type]) if params[:event_type].present?
+
+    count = q.except(:order, :limit, :offset).count
+    versions =
+        q
+        .order(Arel.sql('material_versions.created_at DESC, material_versions.id DESC'))
+        .limit(limit)
+        .offset(offset)
+
+    render json: { versions: serialise_versions(versions), count: }
+  end
+
+  private
+
+  def serialise_versions rows
+    rows.map do |row|
+      { id: row.id,
+        material_id: row.material_id,
+        version_no: row.version_no,
+        event_type: row.event_type,
+        tag_id: row.tag_id,
+        tag_name: row.tag_name,
+        tag_category: row.tag_category,
+        url: row.url,
+        source_kind: row.source_kind,
+        source_uri: row.source_uri,
+        source_path: row.source_path,
+        source_file_id: row.source_file_id,
+        normalized_source_key: row.normalized_source_key,
+        file_blob_id: row.file_blob_id,
+        file_filename: row.file_filename,
+        file_content_type: row.file_content_type,
+        file_byte_size: row.file_byte_size,
+        file_sha256: row.file_sha256,
+        export_paths_json: row.export_paths_hash,
+        discarded_at: row.discarded_at,
+        created_by_user: row.created_by_user&.as_json(UserRepr::BASE),
+        created_at: row.created_at }
+    end
+  end
+end

backend/app/controllers/materials_controller.rb

@@ -1,6 +1,10 @@
+require 'set'
+
+
 class MaterialsController < ApplicationController
   rescue_from MaterialZipExporter::EmptyExportError, with: :render_zip_empty
   rescue_from MaterialZipExporter::DuplicatePathError, with: :render_zip_duplicate_path
+  rescue_from MaterialZipExporter::MissingFileError, with: :render_zip_missing_file
 
   def index
     page = (params[:page].presence || 1).to_i
@@ -11,28 +15,55 @@ class MaterialsController < ApplicationController
 
     offset = (page - 1) * limit
 
-    tag_id = params[:tag_id].presence
+    filters = material_index_filters
-    parent_id = params[:parent_id].presence
+    tag_graph = material_index_tag_graph(filters)
+    q = Material.includes(:material_export_items,
+                          thumbnail_attachment: :blob,
+                          file_attachment: :blob,
+                          tag: :tag_name)
+    q = q.where(tag_id: nil) if filters[:tag_state] == 'untagged'
+    q = q.where.not(tag_id: nil) if filters[:tag_state] == 'tagged'
+    q = apply_material_tag_filter(q, filters, tag_graph)
+    q = q.where('materials.created_at >= ?', filters[:created_from]) if filters[:created_from]
+    q = q.where('materials.created_at <= ?', filters[:created_to]) if filters[:created_to]
+    q = q.where('materials.updated_at >= ?', filters[:updated_from]) if filters[:updated_from]
+    q = q.where('materials.updated_at <= ?', filters[:updated_to]) if filters[:updated_to]
 
-    q = Material.includes(:tag, :created_by_user, :material_export_items).with_attached_file
+    q = material_index_join_tag_name(q) if material_index_needs_tag_name?(filters)
-    q = q.where(tag_id:) if tag_id
+    q = material_index_join_file_blob(q) if material_index_needs_file_blob?(filters)
-    q = q.where(parent_id:) if parent_id
+    q = apply_material_query(q, filters[:q]) if filters[:q].present?
+    q = apply_material_media_kind(q, filters[:media_kind])
 
-    count = q.count
+    count = q.distinct.count(:id)
-    materials = q.order(created_at: :desc, id: :desc).limit(limit).offset(offset)
+    materials =
+        q
+        .order(Arel.sql(material_index_order_sql(filters)))
+        .limit(limit)
+        .offset(offset)
+        .to_a
 
-    render json: { materials: MaterialRepr.many(materials, host: request.base_url), count: count }
+    response = { materials: MaterialRepr.list_many(materials, host: request.base_url),
+                 count: }
+    if filters[:tag_id]
+      response[:tag_scope] = material_index_tag_scope(filters, tag_graph)
+    end
+    if filters[:group_by] == 'parent_tag'
+      response[:groups] = material_index_groups(materials, tag_graph)
+    end
+
+    render json: response
   end
 
   def show
     material =
         Material
         .includes(:tag, :material_export_items)
+        .with_attached_thumbnail
         .with_attached_file
         .find_by(id: params[:id])
     return head :not_found unless material
 
-    wiki_page_body = material.tag.tag_name.wiki_page&.current_revision&.body
+    wiki_page_body = material.tag&.tag_name&.wiki_page&.current_revision&.body
 
     render json: MaterialRepr.base(material, host: request.base_url).merge(wiki_page_body:)
   end
@@ -53,24 +84,31 @@ class MaterialsController < ApplicationController
     block = MaterialImportBlockMatcher.match_for_sha256(file_sha256)
     return render_material_import_block(block) if block
 
+    uploaded_blob = build_uploaded_material_blob!(file, file_sha256)
     material = nil
-    Material.transaction do
-      tag_name = TagName.find_undiscard_or_create_by!(name: tag_name_raw)
-      tag = tag_name.tag
-      tag = Tag.create!(tag_name:, category: :material) unless tag
 
-      material = Material.new(tag:, url:,
+    begin
-                              created_by_user: current_user,
+      Material.transaction do
-                              updated_by_user: current_user)
+        tag_name = TagName.find_undiscard_or_create_by!(name: tag_name_raw)
-      material.file.attach(file) if file
+        tag = tag_name.tag
-      apply_file_sha256!(material, file_sha256)
+        tag = Tag.create!(tag_name:, category: :material) unless tag
-      material.save!
+
-      upsert_export_paths!(material)
+        material = Material.new(tag:, url:,
-      MaterialVersionRecorder.record!(material:, event_type: :create,
+                                created_by_user: current_user,
-                                      created_by_user: current_user)
+                                updated_by_user: current_user)
+        material.file.attach(uploaded_blob) if uploaded_blob
+        material.save!
+        upsert_export_paths!(material)
+        MaterialVersionRecorder.record!(material:, event_type: :create,
+                                        created_by_user: current_user)
+      end
+    rescue StandardError
+      uploaded_blob&.purge_later
+      raise
     end
 
     if material
+      log_thumbnail_generation(material, MaterialThumbnailGenerator.generate!(material))
       render json: MaterialRepr.base(material, host: request.base_url), status: :created
     else
       render_validation_error material
@@ -96,21 +134,33 @@ class MaterialsController < ApplicationController
     block = MaterialImportBlockMatcher.match_for_sha256(file_sha256)
     return render_material_import_block(block) if block
 
-    Material.transaction do
+    uploaded_blob = build_uploaded_material_blob!(file, file_sha256)
-      MaterialVersionRecorder.ensure_snapshot!(material, created_by_user: current_user)
-      tag_name = TagName.find_undiscard_or_create_by!(name: tag_name_raw)
-      tag = tag_name.tag
-      tag = Tag.create!(tag_name:, category: :material) unless tag
 
-      material.update!(tag:, url:, updated_by_user: current_user)
+    begin
-      material.file.attach(file) if file
+      Material.transaction do
-      apply_file_sha256!(material, file_sha256)
+        MaterialVersionRecorder.ensure_snapshot!(material, created_by_user: current_user)
-      material.file.detach if params.key?(:url) && url.present? && file.blank?
+        tag_name = TagName.find_undiscard_or_create_by!(name: tag_name_raw)
-      upsert_export_paths!(material)
+        tag = tag_name.tag
-      MaterialVersionRecorder.record!(material:, event_type: :update,
+        tag = Tag.create!(tag_name:, category: :material) unless tag
-                                      created_by_user: current_user)
+
+        material.assign_attributes(tag:, url:, updated_by_user: current_user)
+        if uploaded_blob
+          material.file.attach(uploaded_blob)
+        elsif params.key?(:url) && url.present? && file.blank?
+          material.file.detach
+        end
+        material.save!
+        upsert_export_paths!(material)
+        MaterialVersionRecorder.record!(material:, event_type: :update,
+                                        created_by_user: current_user)
+      end
+    rescue StandardError
+      uploaded_blob&.purge_later
+      raise
     end
 
+    log_thumbnail_generation(material, MaterialThumbnailGenerator.generate!(material))
+
     render json: MaterialRepr.base(material, host: request.base_url)
   end
 
@@ -140,38 +190,281 @@ class MaterialsController < ApplicationController
               filename: "btrc-materials-#{ profile }.zip"
   end
 
-  def suppress_file
+  private
-    return head :unauthorized unless current_user
-    return head :forbidden unless current_user.admin?
 
-    material = Material.with_attached_file.find_by(id: params[:id])
+  def material_index_filters
-    return head :not_found unless material
+    tag_state = params[:tag_state].to_s.presence
+    tag_state = 'untagged' if bool?(:unclassified)
+    tag_state = 'all' unless ['all', 'tagged', 'untagged'].include?(tag_state)
 
-    reason = params[:reason].to_s.strip.presence
+    media_kind = params[:media_kind].to_s.presence
-    return render_unprocessable_entity('理由は必須です．', field: :reason) unless reason
+    unless ['all', 'image', 'video', 'audio', 'file_other', 'url_only'].include?(media_kind)
-    purge = bool?(:purge)
+      media_kind = 'all'
-    file_snapshot = purge_material_file_snapshot(material) if purge
-    attachment = purge && material.file.attached? ? material.file.attachment : nil
-
-    Material.transaction do
-      MaterialVersionRecorder.ensure_snapshot!(material, created_by_user: current_user)
-      material.update!(file_suppressed_at: Time.current,
-                       file_suppressed_by_user: current_user,
-                       file_suppression_reason: reason,
-                       updated_by_user: current_user)
-      MaterialVersionRecorder.record!(material:, event_type: :suppress,
-                                      created_by_user: current_user,
-                                      file_snapshot:)
     end
-    # Enqueue failure raises here after the suppress metadata has been committed.
-    # In that case the file remains suppressed in UI/ZIP and purge can be retried.
-    attachment&.purge_later
-    material.reload if purge
 
-    render json: MaterialRepr.base(material, host: request.base_url)
+    sort = params[:sort].to_s.presence
+    unless ['created_at', 'updated_at', 'tag_name', 'media_kind', 'file_byte_size',
+            'version_no', 'id'].include?(sort)
+      sort = 'created_at'
+    end
+
+    direction = params[:direction].to_s.downcase
+    direction = 'desc' unless ['asc', 'desc'].include?(direction)
+
+    group_by = params[:group_by].to_s.presence
+    group_by = 'none' unless ['none', 'parent_tag'].include?(group_by)
+
+    tag_id = params[:tag_id].to_i
+    tag_id = nil if tag_id <= 0
+
+    { q: params[:q].to_s.strip.presence,
+      tag_state:,
+      media_kind:,
+      tag_id:,
+      include_descendants: bool?(:include_descendants),
+      group_by:,
+      created_from: parse_time_param(:created_from),
+      created_to: parse_time_param(:created_to),
+      updated_from: parse_time_param(:updated_from),
+      updated_to: parse_time_param(:updated_to),
+      sort:,
+      direction: }
   end
 
-  private
+  def parse_time_param name
+    value = params[name].to_s.strip
+    return nil if value.blank?
+
+    Time.zone.parse(value)
+  rescue ArgumentError
+    nil
+  end
+
+  def material_index_needs_tag_name? filters
+    filters[:q].present? || filters[:sort] == 'tag_name'
+  end
+
+  def material_index_needs_file_blob? filters
+    filters[:q].present? ||
+        filters[:media_kind] != 'all' ||
+        ['media_kind', 'file_byte_size'].include?(filters[:sort])
+  end
+
+  def material_index_join_tag_name q
+    q.left_joins(tag: :tag_name)
+  end
+
+  def material_index_join_file_blob q
+    q.joins(<<~SQL.squish)
+      LEFT JOIN active_storage_attachments material_file_attachments
+        ON material_file_attachments.record_type = 'Material'
+       AND material_file_attachments.record_id = materials.id
+       AND material_file_attachments.name = 'file'
+      LEFT JOIN active_storage_blobs material_file_blobs
+        ON material_file_blobs.id = material_file_attachments.blob_id
+    SQL
+  end
+
+  def apply_material_query q, term
+    like = "%#{ ActiveRecord::Base.sanitize_sql_like(term) }%"
+    q.where('tag_names.name LIKE :q OR materials.url LIKE :q OR ' \
+            'material_file_blobs.filename LIKE :q',
+            q: like)
+  end
+
+  def apply_material_media_kind q, media_kind
+    case media_kind
+    when 'image'
+      q.where('material_file_blobs.content_type LIKE ?', 'image/%')
+    when 'video'
+      q.where('material_file_blobs.content_type LIKE ?', 'video/%')
+    when 'audio'
+      q.where('material_file_blobs.content_type LIKE ?', 'audio/%')
+    when 'file_other'
+      q.where('material_file_attachments.id IS NOT NULL')
+       .where.not('material_file_blobs.content_type LIKE ?', 'image/%')
+       .where.not('material_file_blobs.content_type LIKE ?', 'video/%')
+       .where.not('material_file_blobs.content_type LIKE ?', 'audio/%')
+    when 'url_only'
+      q.where('material_file_attachments.id IS NULL').where.not(url: [nil, ''])
+    else
+      q
+    end
+  end
+
+  def apply_material_tag_filter q, filters, tag_graph
+    return q unless filters[:tag_id]
+
+    tag_ids =
+        if tag_graph
+          tag_graph[:scope_tag_ids]
+        else
+          [filters[:tag_id]]
+        end
+
+    q.where(tag_id: tag_ids)
+  end
+
+  def material_index_tag_graph filters
+    return nil unless filters[:tag_id]
+
+    children_by_parent_id = Hash.new { |h, k| h[k] = [] }
+    TagImplication.pluck(:parent_tag_id, :tag_id).each do |parent_id, child_id|
+      children_by_parent_id[parent_id] << child_id
+    end
+
+    scope_tag_ids =
+        if filters[:include_descendants]
+          collect_material_descendant_ids(filters[:tag_id], children_by_parent_id)
+        else
+          Set.new([filters[:tag_id]])
+        end
+    tags_by_id =
+        Tag
+        .joins(:tag_name)
+        .where(id: scope_tag_ids)
+        .pluck('tags.id', 'tag_names.name', 'tags.category', 'tags.deprecated_at')
+        .each_with_object({ }) do |(id, name, category, deprecated_at), hash|
+          hash[id] = { id:, name:, category:, deprecated: deprecated_at.present? }
+        end
+
+    selected_tag = tags_by_id[filters[:tag_id]]
+    return nil unless selected_tag
+
+    group_tag_id_by_tag_id = { }
+    children_by_parent_id[filters[:tag_id]].each do |child_tag_id|
+      assign_material_group_branch(child_tag_id,
+                                   children_by_parent_id:,
+                                   tags_by_id:,
+                                   group_tag_id_by_tag_id:,
+                                   current_group_tag_id: nil,
+                                   seen: Set.new([filters[:tag_id]]))
+    end
+
+    { selected_tag_id: filters[:tag_id],
+      selected_tag:,
+      scope_tag_ids: scope_tag_ids.to_a,
+      tags_by_id:,
+      group_tag_id_by_tag_id: }
+  end
+
+  def collect_material_descendant_ids selected_tag_id, children_by_parent_id
+    ids = Set.new([selected_tag_id])
+    stack = [selected_tag_id]
+
+    until stack.empty?
+      tag_id = stack.pop
+      children_by_parent_id[tag_id].each do |child_tag_id|
+        next if ids.include?(child_tag_id)
+
+        ids << child_tag_id
+        stack << child_tag_id
+      end
+    end
+
+    ids
+  end
+
+  def assign_material_group_branch tag_id, children_by_parent_id:, tags_by_id:,
+                                   group_tag_id_by_tag_id:, current_group_tag_id:, seen:
+    return if seen.include?(tag_id)
+
+    tag = tags_by_id[tag_id]
+    return unless tag
+
+    seen = seen.dup << tag_id
+    next_group_tag_id = current_group_tag_id
+    next_group_tag_id = tag_id if next_group_tag_id.nil? && !tag[:deprecated]
+    group_tag_id_by_tag_id[tag_id] = next_group_tag_id if next_group_tag_id
+
+    children_by_parent_id[tag_id].each do |child_tag_id|
+      assign_material_group_branch(child_tag_id,
+                                   children_by_parent_id:,
+                                   tags_by_id:,
+                                   group_tag_id_by_tag_id:,
+                                   current_group_tag_id: next_group_tag_id,
+                                   seen:)
+    end
+  end
+
+  def material_index_groups materials, tag_graph
+    return [] unless tag_graph
+
+    groups_by_key = { }
+
+    materials.each do |material|
+      next unless material.tag_id
+
+      group_tag_id =
+          if material.tag_id == tag_graph[:selected_tag_id]
+            tag_graph[:selected_tag_id]
+          else
+            tag_graph[:group_tag_id_by_tag_id][material.tag_id] || tag_graph[:selected_tag_id]
+          end
+
+      group_tag = tag_graph[:tags_by_id][group_tag_id]
+      next unless group_tag
+
+      key = "tag:#{ group_tag_id }"
+      group =
+          groups_by_key[key] ||= { key:,
+                                   tag: group_tag_repr(group_tag),
+                                   material_ids: [],
+                                   count: 0 }
+      group[:material_ids] << material.id
+      group[:count] += 1
+    end
+
+    groups_by_key.values.sort_by { |group| group[:tag][:name] }
+  end
+
+  def material_index_tag_scope filters, tag_graph
+    return nil unless tag_graph
+
+    {
+      tag: group_tag_repr(tag_graph[:selected_tag]),
+      include_descendants: filters[:include_descendants]
+    }
+  end
+
+  def group_tag_repr group_tag
+    { id: group_tag[:id],
+      name: group_tag[:name],
+      category: group_tag[:category] }
+  end
+
+  def material_index_order_sql filters
+    direction = filters[:direction] == 'asc' ? 'ASC' : 'DESC'
+    sort_sql =
+        case filters[:sort]
+        when 'tag_name'
+          'tag_names.name'
+        when 'media_kind'
+          material_media_kind_sql
+        when 'file_byte_size'
+          'material_file_blobs.byte_size'
+        when 'updated_at'
+          'materials.updated_at'
+        when 'version_no'
+          'materials.version_no'
+        when 'id'
+          'materials.id'
+        else
+          'materials.created_at'
+        end
+
+    "#{ sort_sql } #{ direction }, materials.id #{ direction }"
+  end
+
+  def material_media_kind_sql
+    "CASE " \
+      "WHEN material_file_attachments.id IS NULL AND materials.url IS NOT NULL THEN 5 " \
+      "WHEN material_file_blobs.content_type LIKE 'image/%' THEN 1 " \
+      "WHEN material_file_blobs.content_type LIKE 'video/%' THEN 2 " \
+      "WHEN material_file_blobs.content_type LIKE 'audio/%' THEN 3 " \
+      "WHEN material_file_attachments.id IS NOT NULL THEN 4 " \
+      "ELSE 6 END"
+  end
 
   def upsert_export_paths! material
     raw = params[:export_paths]
@@ -203,29 +496,50 @@ class MaterialsController < ApplicationController
     render_unprocessable_entity("ZIP export path が重複してゐます: #{ error.message }")
   end
 
-  def apply_file_sha256! material, file_sha256
+  def render_zip_missing_file error
-    return if file_sha256.blank?
+    missing_files = error.missing_files.map do |missing_file|
-    return unless material.file.attached?
+      { material_id: missing_file.material_id,
+        export_path: missing_file.export_path,
+        blob_id: missing_file.blob_id,
+        filename: missing_file.filename }
+    end
 
-    blob = material.file.blob
+    render json: { type: 'validation_error',
-    blob.metadata['sha256'] = file_sha256
+                   message: 'ZIP export に必要な素材ファイルが欠損しています．',
-    blob.save! if blob.changed?
+                   errors: { },
+                   base_errors: ['ZIP export に必要な素材ファイルが欠損しています．'],
+                   missing_files: },
+           status: :unprocessable_entity
   end
 
-  def purge_material_file_snapshot material
+  def build_uploaded_material_blob! file, file_sha256
-    return nil unless material.file.attached?
+    return nil unless file
 
-    blob = material.file.blob
+    file.tempfile.rewind
 
-    { file_blob_id: blob.id,
+    blob = ActiveStorage::Blob.create_and_upload!(
-      file_filename: blob.filename.to_s,
+        io: file.tempfile,
-      file_content_type: blob.content_type,
+        filename: file.original_filename,
-      file_byte_size: blob.byte_size,
+        content_type: file.content_type,
-      file_checksum: blob.checksum,
+    )
-      file_sha256: blob.metadata['sha256'] || MaterialFileSha256.from_blob(blob) }
+
+    MaterialFileSha256.assign_metadata_sha256!(blob, file_sha256)
+
+    blob
+  ensure
+    file.tempfile.rewind if file&.tempfile
   end
 
   def render_material_import_block block
     render_validation_error fields: { file: ["抑止された素材です: #{ block.reason }"] }
   end
+
+  def log_thumbnail_generation material, result
+    material.reload
+    Rails.logger.info(
+        "Material thumbnail generation: material_id=#{ material.id } " \
+        "result=#{ result } " \
+        "thumbnail_attached=#{ material.thumbnail.attached? } " \
+        "content_type=#{ material.content_type }")
+  end
 end

backend/app/controllers/posts_controller.rb

@@ -140,10 +140,11 @@ class PostsController < ApplicationController
     original_created_from = params[:original_created_from]
     original_created_before = params[:original_created_before]
     parent_post_ids = parse_parent_post_ids
+    resized_thumbnail = thumbnail.present? ? Post.resized_thumbnail_attachment(thumbnail) : nil
 
     post = Post.new(title:, url:, thumbnail_base: nil, uploaded_user: current_user,
                     original_created_from:, original_created_before:)
-    post.thumbnail.attach(thumbnail) if thumbnail.present?
+    post.thumbnail.attach(resized_thumbnail) if resized_thumbnail
 
     ApplicationRecord.transaction do
       post.save!
@@ -156,8 +157,6 @@ class PostsController < ApplicationController
 
       sync_parent_posts!(post, parent_post_ids)
 
-      post.resized_thumbnail!
-
       PostVersionRecorder.record!(post:, event_type: :create, created_by_user: current_user)
     end
 
@@ -167,6 +166,8 @@ class PostsController < ApplicationController
     render_validation_error fields: { tags: 'ニコニコ・タグは直接指定できません．' }
   rescue Tag::DeprecatedTagNormalisationError
     render_unprocessable_entity '廃止済みタグは付与できません．', field: :tags
+  rescue MiniMagick::Error
+    render_validation_error fields: { thumbnail: ['サムネイル画像の変換に失敗しました．'] }
   rescue ArgumentError => e
     render_validation_error fields: { parent_post_ids: [e.message] }
   rescue ActiveRecord::RecordInvalid => e

backend/app/controllers/tags_controller.rb

@@ -82,8 +82,9 @@ class TagsController < ApplicationController
   def with_depth
     parent_tag_id = params[:parent].to_i
     parent_tag_id = nil if parent_tag_id <= 0
+    material_filter = material_filter_param(default: 'any')
 
-    graph = build_with_depth_graph
+    graph = build_with_depth_graph(material_filter)
 
     tag_ids =
         if parent_tag_id
@@ -92,19 +93,9 @@ class TagsController < ApplicationController
           visible_root_tag_ids(graph)
         end
 
-    tags =
+    render json: tag_ids
-        Tag
+                 .sort_by { |tag_id| graph[:tags_by_id][tag_id][:name] }
-        .joins(:tag_name)
+                 .map { |tag_id| with_depth_lightweight_repr(tag_id, graph) }
-        .includes(:tag_name, :materials, tag_name: :wiki_page)
-        .where(id: tag_ids)
-        .order('tag_names.name')
-        .distinct
-        .to_a
-
-    render json: tags.map { |tag|
-      TagRepr.base(tag).merge(has_children: visible_child_tag_ids(tag.id, graph).present?,
-                              children: [])
-    }
   end
 
   def autocomplete
@@ -229,13 +220,16 @@ class TagsController < ApplicationController
   def materials_by_name
     name = params[:name].to_s.strip
     return render_bad_request('name は必須です．') if name.blank?
+    material_filter = material_filter_param(default: 'any')
 
     tag = Tag.joins(:tag_name)
              .includes(:tag_name, :materials, tag_name: :wiki_page)
              .find_by(tag_names: { name: })
     return head :not_found unless tag
 
-    render json: build_tag_children(tag)
+    graph = build_with_depth_graph(material_filter)
+
+    render json: build_tag_children(tag, graph:)
   end
 
   def update_all
@@ -251,10 +245,7 @@ class TagsController < ApplicationController
     return render_unprocessable_entity('カテゴリは必須です．', field: :category) if category.blank?
     return render_unprocessable_entity '廃止状態は必須です．', field: :deprecated unless params.key?(:deprecated)
 
-    if (name != tag.name &&
+    return unless validate_tag_rename(tag, name)
-        tag.in?([Tag.tagme, Tag.bot, Tag.no_deerjikist, Tag.video, Tag.niconico]))
-      return render_unprocessable_entity 'システム・タグの名称は変更できません．', field: :name
-    end
 
     alias_names = params[:aliases].to_s.split.uniq
     parent_names = params[:parent_tags].to_s.split.uniq
@@ -280,7 +271,7 @@ class TagsController < ApplicationController
       else
         tag.update!(category:, deprecated_at: deprecated ? Time.current : nil)
       end
-      tag.tag_name.update!(name:)
+      rename_tag_name!(tag, name) if name_changed
 
       alias_names << old_name if name_changed
       alias_names.delete(name)
@@ -316,6 +307,8 @@ class TagsController < ApplicationController
       return render_unprocessable_entity 'ニコタグは廃止できません．', field: :deprecated
     end
 
+    return unless validate_tag_rename(tag, name)
+
     if tag.nico? || (category.present? && category == 'nico')
       return render_unprocessable_entity 'ニコタグは変更できません．', field: :category
     end
@@ -327,7 +320,7 @@ class TagsController < ApplicationController
       name_changed = name.present? && name != old_name
       wiki_page = tag.tag_name.wiki_page if name_changed
 
-      tag.tag_name.update!(name:) if name.present?
+      rename_tag_name!(tag, name) if name_changed
       tag.update!(category:) if category.present?
       if deprecated_given && tag.deprecated? != deprecated
         tag.update!(deprecated_at: deprecated ? Time.current : nil)
@@ -348,7 +341,14 @@ class TagsController < ApplicationController
 
   private
 
-  def build_with_depth_graph
+  def material_filter_param default:
+    value = params[:material_filter].to_s.presence
+    return default unless ['present', 'missing', 'any'].include?(value)
+
+    value
+  end
+
+  def build_with_depth_graph material_filter
     children_by_parent_id = Hash.new { |h, k| h[k] = [] }
     parent_ids_by_child_id = Hash.new { |h, k| h[k] = [] }
 
@@ -361,23 +361,37 @@ class TagsController < ApplicationController
                parent_ids_by_child_id.keys +
                Tag.where(category: ['meme', 'character', 'material']).pluck(:id)).uniq
 
-    tags_by_id = Tag.where(id: tag_ids)
+    material_tag_ids = Material.unscoped.kept.where.not(tag_id: nil).distinct.pluck(:tag_id).to_set
-                    .pluck(:id, :category, :deprecated_at)
+
-                    .each_with_object({ }) do |(id, category, deprecated_at), h|
+    tags_by_id = Tag.joins(:tag_name)
-      h[id] = { category:, deprecated: deprecated_at.present? }
+                    .where(id: tag_ids)
+                    .pluck('tags.id', 'tag_names.name', 'tags.category', 'tags.deprecated_at')
+                    .each_with_object({ }) do |(id, name, category, deprecated_at), h|
+      h[id] = { name:, category:, deprecated: deprecated_at.present?,
+                has_material: material_tag_ids.include?(id) }
     end
 
     { children_by_parent_id:, parent_ids_by_child_id:, tags_by_id:,
-      visible_child_tag_ids_by_parent_id: { } }
+      visible_child_tag_ids_by_parent_id: { },
+      visible_subtree_by_tag_id: { },
+      material_filter: }
   end
 
   def visible_root_tag_ids graph
-    graph[:tags_by_id].filter_map do |tag_id, attrs|
+    root_ids = Set.new
-      next unless with_depth_visible_tag?(attrs)
-      next unless visible_root_tag?(tag_id, graph)
 
-      tag_id
+    graph[:tags_by_id].each do |tag_id, attrs|
+      next unless visible_root_tag?(tag_id, graph)
+      next unless visible_subtree?(tag_id, graph)
+
+      if attrs[:deprecated]
+        collect_visible_child_tag_ids(tag_id, graph, root_ids, Set.new)
+      else
+        root_ids << tag_id
+      end
     end
+
+    root_ids.to_a
   end
 
   def visible_root_tag? tag_id, graph
@@ -428,18 +442,76 @@ class TagsController < ApplicationController
       return
     end
 
-    visible_ids << tag_id if with_depth_visible_tag?(tag)
+    if with_depth_visible_tag?(tag, graph[:material_filter])
+      visible_ids << tag_id
+      return
+    end
+
+    visible_ids << tag_id if graph[:children_by_parent_id][tag_id].any? { |child_tag_id|
+      visible_subtree?(child_tag_id, graph)
+    }
   end
 
-  def with_depth_visible_tag? tag
+  def with_depth_visible_tag? tag, material_filter
-    tag[:category].in?(['meme', 'character', 'material']) && !tag[:deprecated]
+    return false unless tag[:category].in?(['meme', 'character', 'material']) && !tag[:deprecated]
+
+    case material_filter
+    when 'present'
+      tag[:has_material]
+    when 'missing'
+      !tag[:has_material]
+    else
+      true
+    end
   end
 
-  def build_tag_children tag
+  def visible_subtree? tag_id, graph
+    cache = graph[:visible_subtree_by_tag_id]
+    return cache[tag_id] if cache.key?(tag_id)
+
+    tag = graph[:tags_by_id][tag_id]
+    return cache[tag_id] = false unless tag
+
+    if tag[:deprecated]
+      return cache[tag_id] =
+                 graph[:children_by_parent_id][tag_id].any? { |child_tag_id|
+                   visible_subtree?(child_tag_id, graph)
+                 }
+    end
+
+    cache[tag_id] =
+        with_depth_visible_tag?(tag, graph[:material_filter]) ||
+        graph[:children_by_parent_id][tag_id].any? { |child_tag_id|
+          visible_subtree?(child_tag_id, graph)
+        }
+  end
+
+  def with_depth_lightweight_repr tag_id, graph
+    tag = graph[:tags_by_id][tag_id]
+
+    { id: tag_id,
+      name: tag[:name],
+      category: tag[:category],
+      deprecated: tag[:deprecated],
+      has_material: tag[:has_material],
+      has_children: visible_child_tag_ids(tag_id, graph).present?,
+      children: [] }
+  end
+
+  def build_tag_children tag, graph: nil
     material = tag.materials.first
+    tag_graph = graph && graph[:tags_by_id][tag.id]
+    material =
+        nil if tag_graph && !with_depth_visible_tag?(tag_graph, graph[:material_filter])
+
+    children = tag.children.sort_by(&:name)
+    if graph
+      children = children.filter { |child_tag| visible_subtree?(child_tag.id, graph) }
+    end
 
     TagRepr.base(tag).merge(
-        children: tag.children.sort_by { _1.name }.map { build_tag_children(_1) },
+        children: children.map { build_tag_children(_1, graph:) },
+        has_material: tag_graph ? tag_graph[:has_material] : material.present?,
         material: material && MaterialRepr.base(material, host: request.base_url))
   end
 
@@ -462,6 +534,67 @@ class TagsController < ApplicationController
         created_by_user:)
   end
 
+  def validate_tag_rename tag, name
+    return true if name.blank? || name == tag.name
+
+    if tag.in?([Tag.tagme, Tag.bot, Tag.no_deerjikist, Tag.video, Tag.niconico])
+      render_unprocessable_entity 'システム・タグの名称は変更できません．', field: :name
+      return false
+    end
+
+    target_tag_name = TagName.with_discarded.find_by(name:)
+    return true if target_tag_name.nil?
+    return true if target_tag_name.canonical_id?
+
+    render_unprocessable_entity 'その名前は既に使はれてゐます．', field: :name
+    false
+  end
+
+  def rename_tag_name! tag, name
+    return if name == tag.name
+
+    current_tag_name = tag.tag_name
+    target_tag_name = TagName.with_discarded.find_by(name:)
+
+    if target_tag_name.nil?
+      current_tag_name.update!(name:)
+      return
+    end
+
+    promote_tag_alias!(
+        tag,
+        current_tag_name:,
+        promoted_tag_name: target_tag_name)
+  end
+
+  def promote_tag_alias! tag, current_tag_name:, promoted_tag_name:
+    old_owner_tag = promoted_tag_name.canonical&.tag
+
+    if old_owner_tag && old_owner_tag != tag
+      TagVersioning.ensure_snapshot!(old_owner_tag, created_by_user: current_user)
+    end
+
+    promoted_tag_name.undiscard! if promoted_tag_name.discarded?
+    promoted_tag_name.update!(canonical: nil)
+
+    TagName.with_discarded
+           .where(canonical_id: current_tag_name.id)
+           .where.not(id: promoted_tag_name.id)
+           .find_each do |alias_tag_name|
+      alias_tag_name.update!(canonical: promoted_tag_name)
+    end
+
+    current_tag_name.wiki_page&.update!(tag_name: promoted_tag_name)
+    tag.update!(tag_name: promoted_tag_name)
+    current_tag_name.association(:wiki_page).reset
+    current_tag_name.association(:tag).reset
+    current_tag_name.reload.update!(canonical: promoted_tag_name)
+
+    return unless old_owner_tag && old_owner_tag != tag
+
+    record_tag_version!(old_owner_tag.reload, event_type: :update, created_by_user: current_user)
+  end
+
   def update_aliases! tag, alias_names
     alias_names = alias_names.uniq
 

backend/app/models/material.rb

@@ -1,6 +1,9 @@
 class Material < ApplicationRecord
   include MyDiscard
 
+  SOURCE_KINDS = ['uri', 'google_drive_path', 'google_drive_file',
+                  'legacy_drive_path'].freeze
+
   default_scope -> { kept }
 
   belongs_to :parent, class_name: 'Material', optional: true
@@ -9,26 +12,40 @@ class Material < ApplicationRecord
   belongs_to :tag, optional: true
   belongs_to :created_by_user, class_name: 'User', optional: true
   belongs_to :updated_by_user, class_name: 'User', optional: true
-  belongs_to :file_suppressed_by_user, class_name: 'User', optional: true
 
   has_many :material_versions, dependent: :destroy
   has_many :material_export_items, dependent: :destroy
 
   has_one_attached :file, dependent: :purge
+  has_one_attached :thumbnail, dependent: :purge
 
-  validates :tag_id, presence: true, uniqueness: true
+  before_validation :assign_normalized_source_key
+
+  validates :tag_id, uniqueness: true, allow_nil: true
+  validates :source_kind,
+            inclusion: { in: SOURCE_KINDS },
+            allow_blank: true
 
   validate :file_must_be_attached
   validate :tag_must_be_material_category
 
   def content_type
-    return nil if file_suppressed?
     return nil unless file&.attached?
 
     file.blob.content_type
   end
 
-  def file_suppressed? = file_suppressed_at.present?
+  def file_byte_size
+    return nil unless file&.attached?
+
+    file.blob.byte_size
+  end
+
+  def file_filename
+    return nil unless file&.attached?
+
+    file.blob.filename.to_s
+  end
 
   def snapshot_export_paths
     material_export_items.order(:profile).pluck(:profile, :export_path).to_h
@@ -36,6 +53,19 @@ class Material < ApplicationRecord
 
   private
 
+  def assign_normalized_source_key
+    if source_kind.blank?
+      self.normalized_source_key = nil
+      return
+    end
+
+    self.normalized_source_key =
+        MaterialSyncSuppression.normalize_source_key(source_kind:,
+                                                     source_uri:,
+                                                     drive_path: source_path,
+                                                     drive_file_id: source_file_id)
+  end
+
   def file_must_be_attached
     return if url.present? || file.attached?
 

backend/app/models/material_sync_source.rb

@@ -0,0 +1,45 @@
+class MaterialSyncSource < ApplicationRecord
+  SOURCE_KINDS = ['uri', 'google_drive_path', 'google_drive_file', 'legacy_drive_path'].freeze
+
+  belongs_to :created_by_user, class_name: 'User', optional: true
+  belongs_to :updated_by_user, class_name: 'User', optional: true
+
+  validates :name, presence: true
+  validates :source_kind,
+            presence: true,
+            inclusion: { in: SOURCE_KINDS }
+  validates :profile, presence: true, inclusion: { in: MaterialExportItem::VALID_PROFILES }
+  validate :source_value_must_be_present
+
+  scope :enabled, -> { where(enabled: true) }
+
+  def normalized_source_key
+    MaterialSyncSuppression.normalize_source_key(source_kind:,
+                                                 source_uri:,
+                                                 source_path:,
+                                                 source_file_id:)
+  end
+
+  private
+
+  def source_value_must_be_present
+    return if source_value_present?
+
+    errors.add(:base, '同期元を指定してください．')
+  end
+
+  def source_value_present?
+    case source_kind
+    when 'uri'
+      source_uri.present?
+    when 'google_drive_file'
+      source_file_id.present? || source_uri.present?
+    when 'google_drive_path'
+      source_file_id.present? || source_uri.present?
+    when 'legacy_drive_path'
+      source_path.present?
+    else
+      normalized_source_key.present?
+    end
+  end
+end

backend/app/models/material_sync_suppression.rb

@@ -0,0 +1,105 @@
+class MaterialSyncSuppression < ApplicationRecord
+  SOURCE_KINDS = [
+    'uri',
+    'google_drive_path',
+    'google_drive_path_prefix',
+    'google_drive_file',
+    'legacy_drive_path',
+    'legacy_drive_path_prefix'
+  ].freeze
+
+  REASONS = [
+    'copyright_high_risk',
+    'copyright_takedown',
+    'adult_or_sensitive',
+    'personal_information',
+    'malware_or_dangerous_file',
+    'duplicate_or_low_quality',
+    'source_owner_request',
+    'other'
+  ].freeze
+
+  belongs_to :created_by_user, class_name: 'User', optional: true
+
+  before_validation :assign_normalized_source_key
+
+  validates :source_kind, presence: true, inclusion: { in: SOURCE_KINDS }
+  validates :reason, presence: true, inclusion: { in: REASONS }
+  validates :normalized_source_key, presence: true, uniqueness: true
+  validate :source_value_must_be_present
+  validate :drive_path_must_be_safe_relative_path
+
+  def self.normalize_source_key source_kind:,
+                                source_uri: nil,
+                                drive_path: nil,
+                                drive_file_id: nil,
+                                source_path: nil,
+                                source_file_id: nil
+    kind = source_kind.to_s
+    value =
+        case kind
+        when 'uri'
+          source_uri.to_s.strip
+        when 'google_drive_path', 'google_drive_path_prefix',
+             'legacy_drive_path', 'legacy_drive_path_prefix'
+          (source_path || drive_path).to_s.strip.gsub(%r{/+}, '/')
+        when 'google_drive_file'
+          (source_file_id || drive_file_id).to_s.strip
+        else
+          ''
+        end
+
+    return nil if kind.blank? || value.blank?
+
+    "#{ kind }:#{ value }"
+  end
+
+  private
+
+  def assign_normalized_source_key
+    normalize_path_fields!
+    self.normalized_source_key =
+        self.class.normalize_source_key(source_kind:,
+                                        source_uri:,
+                                        drive_path:,
+                                        drive_file_id:)
+  end
+
+  def source_value_must_be_present
+    return if normalized_source_key.present?
+
+    errors.add(:base, '同期元を指定してください．')
+  end
+
+  def drive_path_must_be_safe_relative_path
+    return unless source_kind.in?(
+        ['google_drive_path', 'google_drive_path_prefix',
+         'legacy_drive_path', 'legacy_drive_path_prefix'])
+
+    value = drive_path.to_s
+    return if value.blank?
+
+    if value.start_with?('/') || value.match?(/\A[A-Za-z]:\//)
+      errors.add(:drive_path, '相対 path を指定してください．')
+    end
+    if value.start_with?('My Drive/', 'マイドライブ/')
+      errors.add(:drive_path, '同期元フォルダからの相対 path を指定してください．')
+    end
+    errors.add(:drive_path, 'NUL は使へません．') if value.include?("\0")
+    errors.add(:drive_path, '連続スラッシュは使へません．') if value.include?('//')
+    errors.add(:drive_path, '末尾スラッシュは使へません．') if value.end_with?('/')
+
+    parts = value.split('/')
+    if parts.any? { |part| part.in?(['.', '..']) }
+      errors.add(:drive_path, '. や .. は使へません．')
+    end
+  end
+
+  def normalize_path_fields!
+    return unless source_kind.in?(
+        ['google_drive_path', 'google_drive_path_prefix',
+         'legacy_drive_path', 'legacy_drive_path_prefix'])
+
+    self.drive_path = drive_path.to_s.tr('\\', '/').strip.presence
+  end
+end

backend/app/models/material_version.rb

@@ -2,8 +2,7 @@ class MaterialVersion < ApplicationRecord
   EVENT_TYPE_MAP = { create: 'create',
                      update: 'update',
                      discard: 'discard',
-                     restore: 'restore',
+                     restore: 'restore' }.freeze
-                     suppress: 'suppress' }.freeze
 
   include VersionRecord
 

backend/app/models/post.rb

@@ -1,5 +1,19 @@
 class Post < ApplicationRecord
   require 'mini_magick'
+  require 'stringio'
+
+  def self.resized_thumbnail_attachment(upload)
+    upload.rewind
+    image = MiniMagick::Image.read(upload.read)
+    image.resize '180x180'
+    image.format 'jpg'
+
+    { io: StringIO.new(image.to_blob),
+      filename: 'resized_thumbnail.jpg',
+      content_type: 'image/jpeg' }
+  ensure
+    upload.rewind
+  end
 
   belongs_to :uploaded_user, class_name: 'User', optional: true
 
@@ -87,12 +101,7 @@ class Post < ApplicationRecord
   def resized_thumbnail!
     return unless thumbnail.attached?
 
-    image = MiniMagick::Image.read(thumbnail.download)
+    thumbnail.attach(self.class.resized_thumbnail_attachment(StringIO.new(thumbnail.download)))
-    image.resize '180x180'
-    thumbnail.purge
-    thumbnail.attach(io:            File.open(image.path),
-                     filename:      'resized_thumbnail.jpg',
-                     content_type:  'image/jpeg')
   end
 
   private

backend/app/models/tag_implication.rb

@@ -6,6 +6,7 @@ class TagImplication < ApplicationRecord
   validates :parent_tag_id, presence: true
 
   validate :parent_tag_mustnt_be_itself
+  validate :parent_tag_mustnt_create_cycle
 
   private
 
@@ -14,4 +15,27 @@ class TagImplication < ApplicationRecord
       errors.add :parent_tag_id, '親タグは子タグと同一であってはなりません．'
     end
   end
+
+  def parent_tag_mustnt_create_cycle
+    return if tag_id.blank? || parent_tag_id.blank?
+    return if errors[:parent_tag_id].present?
+
+    seen = { }
+    stack = [parent_tag_id]
+
+    until stack.empty?
+      current_id = stack.pop
+      next if seen[current_id]
+
+      seen[current_id] = true
+
+      if current_id == tag_id
+        errors.add :parent_tag_id, '親タグに子孫タグを指定すると循環します．'
+        errors.add :base, 'タグの親子関係が循環します．'
+        return
+      end
+
+      stack.concat(TagImplication.where(tag_id: current_id).pluck(:parent_tag_id))
+    end
+  end
 end

backend/app/representations/material_repr.rb

@@ -2,8 +2,9 @@
 
 
 module MaterialRepr
-  BASE = { only: [:id, :url, :version_no, :file_suppressed_at,
+  BASE = { only: [:id, :url, :version_no, :source_kind, :source_uri,
-                  :file_suppression_reason, :created_at, :updated_at],
+                  :source_path, :source_file_id, :normalized_source_key,
+                  :created_at, :updated_at],
            methods: [:content_type],
            include: { tag: TagRepr::BASE,
                       created_by_user: UserRepr::BASE,
@@ -13,10 +14,15 @@ module MaterialRepr
 
   def base material, host:
     material.as_json(BASE).merge(
-        file: if material.file.attached? && !material.file_suppressed?
+        file: if material.file.attached?
                 Rails.application.routes.url_helpers.rails_storage_proxy_url(
                     material.file, host:)
               end,
+        thumbnail: thumbnail_url(material, host:),
+        thumbnail_fallback_text: thumbnail_fallback_text(material),
+        thumbnail_fallback_kind: thumbnail_fallback_kind(material),
+        media_kind: media_kind(material),
+        file_byte_size: material.file_byte_size,
         export_paths: export_paths(material),
         export_items: export_items(material))
   end
@@ -25,6 +31,32 @@ module MaterialRepr
     materials.map { |m| base(m, host:) }
   end
 
+  def list material, host:
+    { id: material.id,
+      version_no: material.version_no,
+      url: material.url,
+      source_kind: material.source_kind,
+      source_uri: material.source_uri,
+      source_path: material.source_path,
+      source_file_id: material.source_file_id,
+      normalized_source_key: material.normalized_source_key,
+      tag: compact_tag(material.tag),
+      thumbnail: thumbnail_url(material, host:),
+      thumbnail_fallback_text: thumbnail_fallback_text(material),
+      thumbnail_fallback_kind: thumbnail_fallback_kind(material),
+      media_kind: media_kind(material),
+      content_type: material.content_type,
+      file_byte_size: material.file_byte_size,
+      created_at: material.created_at,
+      updated_at: material.updated_at,
+      export_paths: export_paths(material),
+      export_items: export_items(material) }
+  end
+
+  def list_many materials, host:
+    materials.map { |m| list(m, host:) }
+  end
+
   def export_paths material
     material.material_export_items.each_with_object({ }) do |item, hash|
       hash[item.profile] = item.enabled ? item.export_path : ''
@@ -39,4 +71,39 @@ module MaterialRepr
         enabled: item.enabled }
     end
   end
+
+  def thumbnail_url material, host:
+    return nil unless material.thumbnail.attached?
+
+    Rails.application.routes.url_helpers.rails_storage_proxy_url(
+        material.thumbnail, host:)
+  end
+
+  def thumbnail_fallback_text material
+    material.tag&.name || material.created_at&.strftime('%Y-%m-%d')
+  end
+
+  def thumbnail_fallback_kind material
+    material.tag.present? ? 'tag_name' : 'created_at'
+  end
+
+  def media_kind material
+    return 'url_only' unless material.file.attached?
+
+    content_type = material.file.blob.content_type.to_s
+    return 'image' if content_type.start_with?('image/')
+    return 'video' if content_type.start_with?('video/')
+    return 'audio' if content_type.start_with?('audio/')
+
+    'file_other'
+  end
+
+  def compact_tag tag
+    return nil unless tag
+
+    { id: tag.id,
+      name: tag.name,
+      category: tag.category,
+      deprecated_at: tag.deprecated_at }
+  end
 end

backend/app/services/google_drive/api_client.rb

@@ -0,0 +1,233 @@
+require 'json'
+require 'jwt'
+require 'net/http'
+require 'openssl'
+require 'tempfile'
+require 'uri'
+
+
+module GoogleDrive
+  class ApiClient
+    DRIVE_ENDPOINT = 'https://www.googleapis.com/drive/v3'
+    TOKEN_ENDPOINT = 'https://oauth2.googleapis.com/token'
+    FOLDER_MIME_TYPE = 'application/vnd.google-apps.folder'
+    NATIVE_FILE_MIME_TYPE_PREFIX = 'application/vnd.google-apps.'
+    DRIVE_SCOPE = 'https://www.googleapis.com/auth/drive.readonly'
+
+    def initialize service_account_email: ENV['GOOGLE_DRIVE_SERVICE_ACCOUNT_EMAIL'],
+                   private_key: ENV['GOOGLE_DRIVE_PRIVATE_KEY'],
+                   private_key_path: ENV['GOOGLE_DRIVE_PRIVATE_KEY_PATH'],
+                   subject: ENV['GOOGLE_DRIVE_SUBJECT']
+      @service_account_email = service_account_email.to_s
+      @private_key = load_private_key(private_key, private_key_path)
+      @subject = subject.to_s.presence
+      @access_token = nil
+    end
+
+    def list_material_files_under_folder folder_id
+      files = []
+      each_material_file_under_folder(folder_id) { |entry| files << entry }
+      files
+    end
+
+    def each_material_file_under_folder folder_id
+      return enum_for(__method__, folder_id) unless block_given?
+
+      walk_folder(folder_id, nil) do |entry, relative_path|
+        next if entry['mimeType'] == FOLDER_MIME_TYPE
+        next if native_file?(entry['mimeType'])
+
+        yield build_file_entry(entry, relative_path)
+      end
+    end
+
+    def fetch_material_file file_id
+      metadata = get_file(file_id)
+      return nil if native_file?(metadata['mimeType'])
+
+      build_file_entry(metadata, metadata['name'])
+    end
+
+    def download_to_tempfile file_id, filename:
+      tempfile = Tempfile.new(['material-sync', File.extname(filename.to_s)])
+      tempfile.binmode
+      request_binary("/files/#{ file_id }",
+                     { alt: 'media', supportsAllDrives: true }) do |chunk|
+        tempfile.write(chunk.b)
+      end
+      tempfile.rewind
+      tempfile
+    rescue StandardError
+      tempfile&.close!
+      raise
+    end
+
+    def extract_file_id value
+      raw = value.to_s.strip
+      return nil if raw.blank?
+      return raw unless raw.include?('/')
+
+      uri = URI.parse(raw)
+      return uri.query.to_s[%r{(?:^|&)id=([^&]+)}, 1] if uri.query.present?
+      return uri.path[%r{/folders/([^/]+)}, 1] if uri.path.include?('/folders/')
+
+      uri.path[%r{/d/([^/]+)}, 1]
+    rescue URI::InvalidURIError
+      nil
+    end
+
+    private
+
+    def walk_folder folder_id, prefix, &block
+      list_children(folder_id).each do |entry|
+        relative_path = MaterialSyncExportPath.build(prefix:,
+                                                     relative_path: entry['name'])
+        if entry['mimeType'] == FOLDER_MIME_TYPE
+          walk_folder(entry['id'], relative_path, &block)
+          next
+        end
+
+        block.call(entry, relative_path)
+      end
+    end
+
+    def build_file_entry entry, relative_path
+      { id: entry['id'],
+        name: entry['name'],
+        mime_type: entry['mimeType'],
+        relative_path: MaterialSyncExportPath.normalize_path(relative_path),
+        sha256_checksum: entry['sha256Checksum'],
+        web_view_link: entry['webViewLink'],
+        web_content_link: entry['webContentLink'] }
+    end
+
+    def list_children folder_id
+      files = []
+      page_token = nil
+
+      loop do
+        response =
+            request_json('/files', {
+                q: "'#{ folder_id }' in parents and trashed = false",
+                fields: 'nextPageToken,files(id,name,mimeType,sha256Checksum,' \
+                        'webViewLink,webContentLink)',
+                orderBy: 'folder,name',
+                pageSize: 1000,
+                supportsAllDrives: true,
+                includeItemsFromAllDrives: true,
+                pageToken: page_token }.compact)
+        files.concat(response.fetch('files'))
+        page_token = response['nextPageToken']
+        break if page_token.blank?
+      end
+
+      files
+    end
+
+    def get_file file_id
+      request_json("/files/#{ file_id }",
+                   fields: 'id,name,mimeType,sha256Checksum,webViewLink,webContentLink',
+                   supportsAllDrives: true)
+    end
+
+    def request_json path, params = {}
+      response = request(:get, path, params:)
+      unless response.is_a?(Net::HTTPSuccess)
+        raise "Google Drive API error: #{ response.code } #{ response.body }"
+      end
+
+      JSON.parse(response.body)
+    end
+
+    def request_binary path, params = {}
+      request(:get, path, params:) do |response|
+        unless response.is_a?(Net::HTTPSuccess)
+          raise "Google Drive download error: #{ response.code } #{ response.body }"
+        end
+
+        response.read_body do |chunk|
+          yield chunk.b
+        end
+      end
+    end
+
+    def request method, path, params: nil
+      uri = URI(DRIVE_ENDPOINT + path)
+      uri.query = URI.encode_www_form(params) if params.present?
+
+      klass =
+          case method
+          when :get
+            Net::HTTP::Get
+          else
+            raise ArgumentError, "Unsupported Google Drive request method: #{ method }"
+          end
+      request = klass.new(uri)
+      request['Authorization'] = "Bearer #{ access_token }"
+
+      Net::HTTP.start(uri.host,
+                      uri.port,
+                      use_ssl: true,
+                      open_timeout: 10,
+                      read_timeout: 60) do |http|
+        if block_given?
+          http.request(request) do |response|
+            return yield response
+          end
+        else
+          http.request(request)
+        end
+      end
+    end
+
+    def access_token
+      @access_token ||= fetch_access_token
+    end
+
+    def fetch_access_token
+      raise 'GOOGLE_DRIVE_SERVICE_ACCOUNT_EMAIL is required' if @service_account_email.blank?
+      raise 'Google Drive private key is required' if @private_key.blank?
+
+      payload = { iss: @service_account_email,
+                  scope: DRIVE_SCOPE,
+                  aud: TOKEN_ENDPOINT,
+                  exp: 1.hour.from_now.to_i,
+                  iat: Time.current.to_i }
+      payload[:sub] = @subject if @subject.present?
+
+      assertion = JWT.encode(payload, @private_key, 'RS256')
+      uri = URI(TOKEN_ENDPOINT)
+      request = Net::HTTP::Post.new(uri)
+      request.set_form_data(
+          grant_type: 'urn:ietf:params:oauth:grant-type:jwt-bearer',
+          assertion:)
+
+      response =
+          Net::HTTP.start(uri.host,
+                          uri.port,
+                          use_ssl: true,
+                          open_timeout: 10,
+                          read_timeout: 30) do |http|
+            http.request(request)
+          end
+      unless response.is_a?(Net::HTTPSuccess)
+        raise "Google OAuth error: #{ response.code } #{ response.body }"
+      end
+
+      JSON.parse(response.body).fetch('access_token')
+    end
+
+    def load_private_key private_key, private_key_path
+      raw = private_key.to_s
+      raw = raw.gsub('\n', "\n") if raw.present?
+      raw = File.read(private_key_path) if raw.blank? && private_key_path.present?
+      return nil if raw.blank?
+
+      OpenSSL::PKey::RSA.new(raw)
+    end
+
+    def native_file? mime_type
+      mime_type.to_s.start_with?(NATIVE_FILE_MIME_TYPE_PREFIX)
+    end
+  end
+end

backend/app/services/material_file_sha256.rb

@@ -1,15 +1,47 @@
 require 'digest'
+require 'json'
 
 class MaterialFileSha256
-  def self.from_blob blob
+  def self.blob_metadata blob
-    sha256 = blob.metadata['sha256']
+    metadata = blob.metadata
-    return sha256 if sha256.present?
+    return metadata if metadata.is_a?(Hash)
+    return { } if metadata.blank?
 
-    blob.open do |file|
+    JSON.parse(metadata)
-      sha256 = Digest::SHA256.file(file.path).hexdigest
+  rescue JSON::ParserError
-      blob.metadata['sha256'] = sha256
+    { }
-      blob.save! if blob.changed?
+  end
-      sha256
+
+  def self.metadata_sha256 blob
+    blob_metadata(blob)['sha256'].presence
+  end
+
+  def self.assign_metadata_sha256! blob, sha256
+    return if sha256.blank?
+
+    metadata = blob_metadata(blob)
+    metadata['sha256'] = sha256
+    blob.metadata = metadata
+    blob.save! if blob.changed?
+  end
+
+  def self.from_blob blob, allow_download: false
+    sha256 = metadata_sha256(blob)
+    return sha256 if sha256.present?
+    return nil unless allow_download
+
+    begin
+      blob.open do |file|
+        sha256 = Digest::SHA256.file(file.path).hexdigest
+        assign_metadata_sha256!(blob, sha256)
+        sha256
+      end
+    rescue ActiveStorage::FileNotFoundError, ArgumentError => error
+      Rails.logger.warn(
+          "MaterialFileSha256.from_blob failed for blob_id=#{blob.id}: " \
+          "#{error.class}: #{error.message}",
+      )
+      nil
     end
   end
 

backend/app/services/material_sync_export_path.rb

@@ -0,0 +1,56 @@
+class MaterialSyncExportPath
+  class << self
+    def build prefix: nil, relative_path: nil, filename: nil, source_file_id: nil
+      path = normalize_path(relative_path)
+      path = fallback_filename(filename, source_file_id) if path.blank?
+
+      normalized_prefix = normalize_path(prefix)
+      return path if normalized_prefix.blank?
+      return normalized_prefix if path.blank?
+
+      [normalized_prefix, path].join('/')
+    end
+
+    def normalize_path path
+      raw = path.to_s.delete("\0").tr('\\', '/').strip
+      raw = raw.sub(%r{\A[A-Za-z]:/+}, '')
+      raw = raw.sub(%r{\A/+}, '')
+      return nil if raw.blank?
+
+      segments = raw.split('/').filter_map do |segment|
+        normalized = normalize_segment(segment)
+        normalized.presence
+      end
+      return nil if segments.empty?
+
+      segments.join('/')
+    end
+
+    def uniquify path, source_file_id
+      normalized = normalize_path(path)
+      return normalized if normalized.blank? || source_file_id.blank?
+
+      ext = File.extname(normalized)
+      base = ext.present? ? normalized.delete_suffix(ext) : normalized
+      "#{ base }--#{ source_file_id }#{ ext }"
+    end
+
+    private
+
+    def fallback_filename filename, source_file_id
+      name = normalize_path(filename)
+      return name if name.present?
+      return nil if source_file_id.blank?
+
+      source_file_id.to_s
+    end
+
+    def normalize_segment segment
+      cleaned = segment.to_s.delete("\0").tr('\\/', '_').strip
+      return nil if cleaned.blank? || cleaned == '.'
+      return '__' if cleaned == '..'
+
+      cleaned
+    end
+  end
+end

backend/app/services/material_sync_importer.rb

@@ -0,0 +1,259 @@
+require 'digest'
+
+class MaterialSyncImporter
+  Result = Struct.new(:material, :action, :suppressed, :suppression, keyword_init: true)
+
+  def self.import! attributes
+    new(attributes).import!
+  end
+
+  def initialize attributes
+    @attributes = attributes
+  end
+
+  def import!
+    source = source_attributes
+    key = normalized_source_key(source)
+    raise ArgumentError, 'normalized_source_key is required for material sync' if key.blank?
+
+    suppression = suppression_for(source)
+    if suppression
+      return Result.new(material: nil,
+                        action: :suppressed,
+                        suppressed: true,
+                        suppression:)
+    end
+
+    material =
+        Material
+        .unscoped
+        .find_or_initialize_by(normalized_source_key: key)
+    if unchanged?(material, source)
+      return Result.new(material:,
+                        action: :unchanged,
+                        suppressed: false,
+                        suppression: nil)
+    end
+
+    event_type =
+        if material.new_record?
+          :create
+        elsif material.discarded?
+          :restore
+        else
+          :update
+        end
+    uploaded_blob = uploaded_blob!
+    if @import_block
+      return Result.new(material: nil,
+                        action: :suppressed,
+                        suppressed: true,
+                        suppression: @import_block)
+    end
+
+    Material.transaction do
+      if material.persisted?
+        MaterialVersionRecorder.ensure_snapshot!(material,
+                                                 created_by_user: @attributes[:updated_by_user])
+      end
+      material.assign_attributes(material_attributes_for(material).merge(source))
+      material.discarded_at = nil if material.respond_to?(:discarded_at=)
+      material.file.attach(uploaded_blob) if uploaded_blob
+      material.save!
+      upsert_export_item!(material)
+      MaterialVersionRecorder.record!(material:,
+                                      event_type:,
+                                      created_by_user: @attributes[:updated_by_user])
+    end
+    MaterialThumbnailGenerator.generate!(material)
+
+    Result.new(material:,
+               action: event_type == :create ? :imported : :updated,
+               suppressed: false,
+               suppression: nil)
+  rescue StandardError
+    uploaded_blob&.purge_later
+    raise
+  ensure
+    close_tempfile!
+  end
+
+  private
+
+  def source_attributes
+    { source_kind: @attributes[:source_kind],
+      source_uri: @attributes[:source_uri],
+      source_path: @attributes[:source_path],
+      source_file_id: @attributes[:source_file_id] }
+  end
+
+  def normalized_source_key source
+    MaterialSyncSuppression.normalize_source_key(source_kind: source[:source_kind],
+                                                 source_uri: source[:source_uri],
+                                                 source_path: source[:source_path],
+                                                 source_file_id: source[:source_file_id])
+  end
+
+  def material_attributes_for material
+    attrs =
+        @attributes
+        .except(:source_kind, :source_uri, :source_path, :source_file_id,
+                :file_blob, :file_tempfile, :file_downloader,
+                :filename, :content_type,
+                :file_sha256, :export_path, :profile, :tag, :url)
+
+    if material.new_record?
+      attrs[:tag] = @attributes[:tag] if @attributes.key?(:tag)
+      attrs[:url] = @attributes[:url] if @attributes.key?(:url)
+      return attrs
+    end
+
+    if @attributes.key?(:tag) && @attributes[:tag].present?
+      attrs[:tag] = @attributes[:tag]
+    end
+    if @attributes.key?(:url) && @attributes[:url].present?
+      attrs[:url] = @attributes[:url]
+    end
+
+    attrs
+  end
+
+  def suppression_for source
+    if source[:source_kind] == 'google_drive_file' && source[:source_path].present?
+      return MaterialSyncSuppressionMatcher.match_google_drive_candidate(
+          drive_file_id: source[:source_file_id],
+          relative_path: source[:source_path])
+    end
+
+    MaterialSyncSuppressionMatcher.match(**source)
+  end
+
+  def uploaded_blob!
+    return @attributes[:file_blob] if @attributes[:file_blob]
+
+    tempfile = upload_tempfile
+    return nil unless tempfile
+
+    tempfile.rewind
+    file_sha256 = @attributes[:file_sha256] || Digest::SHA256.file(tempfile.path).hexdigest
+    @attributes[:file_sha256] = file_sha256
+
+    @import_block = MaterialImportBlockMatcher.match_for_sha256(file_sha256)
+    if @import_block
+      tempfile.rewind
+      return nil
+    end
+
+    blob = ActiveStorage::Blob.create_and_upload!(
+        io: tempfile,
+        filename: @attributes[:filename],
+        content_type: @attributes[:content_type])
+    MaterialFileSha256.assign_metadata_sha256!(blob, file_sha256)
+    tempfile.rewind
+    blob
+  end
+
+  def upload_tempfile
+    return @upload_tempfile if defined?(@upload_tempfile)
+
+    @upload_tempfile = @attributes[:file_tempfile]
+    if @upload_tempfile.blank? && @attributes[:file_downloader]
+      @upload_tempfile = @attributes[:file_downloader].call
+    end
+    @upload_tempfile
+  end
+
+  def upsert_export_item! material
+    export_path = resolved_export_path(material)
+    return if export_path.blank?
+
+    item = material.material_export_items.find_or_initialize_by(profile: effective_profile)
+    item.export_path = export_path
+    item.enabled = true
+    item.created_by_user ||= @attributes[:created_by_user]
+    item.save!
+  end
+
+  def export_path_taken_by_other? material, profile, export_path
+    MaterialExportItem
+      .where(profile:, export_path:)
+      .where.not(material_id: material.id)
+      .exists?
+  end
+
+  def close_tempfile!
+    tempfile = upload_tempfile
+    return unless tempfile
+
+    tempfile.close! unless tempfile.closed?
+  rescue StandardError
+    nil
+  end
+
+  def unchanged? material, source
+    return false if material.new_record? || material.discarded?
+    return false unless same_source_attributes?(material, source)
+    return false unless same_export_path?(material)
+    return false unless same_material_attributes?(material)
+
+    same_file_snapshot?(material)
+  end
+
+  def same_source_attributes? material, source
+    material.source_kind == source[:source_kind] \
+      && material.source_uri == source[:source_uri] \
+      && material.source_path == source[:source_path] \
+      && material.source_file_id == source[:source_file_id]
+  end
+
+  def same_export_path? material
+    expected = resolved_export_path(material)
+    current = material.material_export_items.find { |item| item.profile == effective_profile }
+
+    return current.blank? if expected.blank?
+
+    current&.enabled && current.export_path == expected
+  end
+
+  def same_material_attributes? material
+    same_tag_attribute?(material) && same_url_attribute?(material)
+  end
+
+  def same_file_snapshot? material
+    expected_sha256 = @attributes[:file_sha256].to_s.presence
+
+    if expected_sha256.present?
+      return false unless material.file.attached?
+
+      return MaterialFileSha256.metadata_sha256(material.file.blob) == expected_sha256
+    end
+
+    !material.file.attached?
+  end
+
+  def effective_profile
+    @attributes[:profile].presence || 'legacy_drive'
+  end
+
+  def resolved_export_path material
+    export_path = @attributes[:export_path].to_s.strip
+    return export_path if export_path.blank?
+    return export_path unless export_path_taken_by_other?(material, effective_profile, export_path)
+
+    MaterialSyncExportPath.uniquify(export_path, @attributes[:source_file_id])
+  end
+
+  def same_tag_attribute? material
+    return true unless @attributes.key?(:tag)
+    return true if @attributes[:tag].blank?
+
+    material.tag_id == @attributes[:tag].id
+  end
+
+  def same_url_attribute? material
+    return true unless @attributes.key?(:url)
+    return true if @attributes[:url].blank?
+
+    material.url == @attributes[:url]
+  end
+end

backend/app/services/material_sync_runner.rb

@@ -0,0 +1,251 @@
+class MaterialSyncRunner
+  Result = Struct.new(:imported, :updated, :unchanged, :suppressed, :failed,
+                      :errors, keyword_init: true)
+
+  def self.sync_enabled!
+    results = MaterialSyncSource.enabled.order(:id).map { |source| new(source).sync! }
+
+    Result.new(imported: results.sum(&:imported),
+               updated: results.sum(&:updated),
+               unchanged: results.sum(&:unchanged),
+               suppressed: results.sum(&:suppressed),
+               failed: results.sum(&:failed),
+               errors: results.flat_map(&:errors))
+  end
+
+  def initialize source
+    @source = source
+  end
+
+  def sync!
+    result = Result.new(imported: 0, updated: 0, unchanged: 0,
+                        suppressed: 0, failed: 0, errors: [])
+
+    if @source.source_kind == 'google_drive_path'
+      sync_google_drive_path!(result)
+    else
+      candidates.each do |candidate|
+        next if candidate.blank?
+
+        sync_candidate!(candidate, result)
+      end
+    end
+
+    @source.update!(last_synced_at: Time.current)
+    log_result(result)
+    result
+  rescue NotImplementedError, StandardError => e
+    result.failed += 1
+    result.errors << { source_id: @source.id, error: e.message }
+    log_result(result)
+    result
+  end
+
+  private
+
+  def candidates
+    case @source.source_kind
+    when 'uri'
+      [uri_candidate]
+    when 'google_drive_file'
+      [google_drive_file_candidate]
+    when 'legacy_drive_path'
+      raise NotImplementedError, 'legacy_drive_path material sync is not implemented'
+    else
+      raise NotImplementedError, "Unsupported material sync source_kind: #{ @source.source_kind }"
+    end
+  end
+
+  def uri_candidate
+    { source_kind: @source.source_kind,
+      source_uri: @source.source_uri,
+      source_path: @source.source_path,
+      source_file_id: @source.source_file_id,
+      url: @source.source_uri,
+      tag: nil,
+      created_by_user: @source.created_by_user,
+      updated_by_user: @source.updated_by_user || @source.created_by_user }
+  end
+
+  def sync_candidate! candidate, result
+    block = MaterialImportBlockMatcher.match_for_sha256(candidate[:file_sha256])
+    if block
+      result.suppressed += 1
+      Rails.logger.info(
+          material_sync_log(action: 'suppressed',
+                            reason: block.reason,
+                            normalized_source_key: candidate_normalized_source_key(candidate)))
+      return
+    end
+
+    suppression = suppression_for(candidate)
+
+    if suppression
+      result.suppressed += 1
+      Rails.logger.info(
+          material_sync_log(action: 'suppressed',
+                            normalized_source_key: suppression.normalized_source_key))
+      return
+    end
+
+    import = MaterialSyncImporter.import!(candidate)
+    result.public_send("#{ import.action }=", result.public_send(import.action) + 1)
+  rescue StandardError => e
+    result.failed += 1
+    result.errors << { source_id: @source.id,
+                       normalized_source_key: candidate_normalized_source_key(candidate),
+                       error: e.message }
+    Rails.logger.warn(
+        material_sync_log(action: 'failed',
+                          error: e.message,
+                          normalized_source_key: candidate_normalized_source_key(candidate)))
+  ensure
+    close_candidate_tempfile(candidate)
+  end
+
+  def google_drive_path_candidates
+    folder_id = google_drive_folder_id
+    Enumerator.new do |entries|
+      drive_client.each_material_file_under_folder(folder_id).each do |entry|
+        entries << build_google_drive_candidate(entry)
+      end
+    end
+  end
+
+  def sync_google_drive_path! result
+    folder_id = google_drive_folder_id
+    scanned_count = 0
+
+    drive_client.each_material_file_under_folder(folder_id) do |entry|
+      scanned_count += 1
+      sync_candidate!(build_google_drive_candidate(entry), result)
+      log_google_drive_progress(folder_id, scanned_count, result) if progress_log_scan_count?(scanned_count)
+    end
+
+    log_google_drive_progress(folder_id, scanned_count, result, summary: true)
+  end
+
+  def google_drive_file_candidate
+    entry = drive_client.fetch_material_file(google_drive_file_id)
+    return nil unless entry
+
+    build_google_drive_candidate(entry, single_file: true)
+  end
+
+  def build_google_drive_candidate entry, single_file: false
+    relative_path =
+        if single_file
+          nil
+        else
+          entry[:relative_path]
+        end
+    export_path =
+        MaterialSyncExportPath.build(prefix: @source.export_path_prefix,
+                                     relative_path:,
+                                     filename: entry[:name],
+                                     source_file_id: entry[:id])
+
+    { source_kind: 'google_drive_file',
+      source_uri: entry[:web_view_link] || google_drive_file_url(entry[:id]),
+      source_path: relative_path.presence || MaterialSyncExportPath.normalize_path(entry[:name]),
+      source_file_id: entry[:id],
+      filename: entry[:name],
+      content_type: entry[:mime_type],
+      file_downloader: lambda {
+        drive_client.download_to_tempfile(entry[:id], filename: entry[:name])
+      },
+      file_sha256: entry[:sha256_checksum],
+      export_path:,
+      profile: @source.profile,
+      tag: nil,
+      url: nil,
+      created_by_user: @source.created_by_user,
+      updated_by_user: @source.updated_by_user || @source.created_by_user }
+  end
+
+  def candidate_normalized_source_key candidate
+    MaterialSyncSuppression.normalize_source_key(source_kind: candidate[:source_kind],
+                                                 source_uri: candidate[:source_uri],
+                                                 source_path: candidate[:source_path],
+                                                 source_file_id: candidate[:source_file_id])
+  end
+
+  def suppression_for candidate
+    if candidate[:source_kind] == 'google_drive_file' && candidate[:source_path].present?
+      return MaterialSyncSuppressionMatcher.match_google_drive_candidate(
+          drive_file_id: candidate[:source_file_id],
+          relative_path: candidate[:source_path])
+    end
+
+    MaterialSyncSuppressionMatcher.match(source_kind: candidate[:source_kind],
+                                         source_uri: candidate[:source_uri],
+                                         source_path: candidate[:source_path],
+                                         source_file_id: candidate[:source_file_id])
+  end
+
+  def drive_client
+    @drive_client ||= GoogleDrive::ApiClient.new
+  end
+
+  def google_drive_folder_id
+    google_drive_target_id.tap do |id|
+      if id.blank?
+        raise ArgumentError, 'google_drive_path source_file_id or source_uri is required'
+      end
+    end
+  end
+
+  def google_drive_file_id
+    google_drive_target_id.tap do |id|
+      if id.blank?
+        raise ArgumentError, 'google_drive_file source_file_id or source_uri is required'
+      end
+    end
+  end
+
+  def google_drive_target_id
+    @source.source_file_id.presence || drive_client.extract_file_id(@source.source_uri)
+  end
+
+  def google_drive_file_url file_id
+    "https://drive.google.com/file/d/#{ file_id }/view"
+  end
+
+  def close_candidate_tempfile candidate
+    tempfile = candidate[:file_tempfile]
+    return unless tempfile
+
+    tempfile.close! unless tempfile.closed?
+  rescue StandardError
+    nil
+  end
+
+  def log_result result
+    Rails.logger.info(material_sync_log(imported: result.imported,
+                                        updated: result.updated,
+                                        unchanged: result.unchanged,
+                                        suppressed: result.suppressed,
+                                        failed: result.failed))
+  end
+
+  def progress_log_scan_count? scanned_count
+    scanned_count == 1 || (scanned_count % 50).zero?
+  end
+
+  def log_google_drive_progress folder_id, scanned_count, result, summary: false
+    Rails.logger.info(
+        material_sync_log(folder_id:,
+                          scanned_count:,
+                          imported: result.imported,
+                          updated: result.updated,
+                          unchanged: result.unchanged,
+                          suppressed: result.suppressed,
+                          failed: result.failed,
+                          progress: summary ? 'summary' : 'scan'))
+  end
+
+  def material_sync_log fields
+    { material_sync_source_id: @source.id,
+      material_sync_source_name: @source.name }.merge(fields).to_json
+  end
+end

backend/app/services/material_sync_suppression_matcher.rb

@@ -0,0 +1,68 @@
+class MaterialSyncSuppressionMatcher
+  def self.match source_kind:,
+                 source_uri: nil,
+                 drive_path: nil,
+                 drive_file_id: nil,
+                 source_path: nil,
+                 source_file_id: nil
+    key = MaterialSyncSuppression.normalize_source_key(source_kind:,
+                                                       source_uri:,
+                                                       drive_path:,
+                                                       drive_file_id:,
+                                                       source_path:,
+                                                       source_file_id:)
+    return nil if key.blank?
+
+    MaterialSyncSuppression.find_by(normalized_source_key: key)
+  end
+
+  def self.match_google_drive_candidate drive_file_id:, relative_path:
+    normalized_path = validate_relative_path!(relative_path)
+
+    exact = [
+      normalize_key('google_drive_file', drive_file_id),
+      normalize_key('google_drive_path', normalized_path),
+      normalize_key('legacy_drive_path', normalized_path),
+    ].compact
+
+    suppression =
+        MaterialSyncSuppression.find_by(normalized_source_key: exact)
+    return suppression if suppression
+
+    MaterialSyncSuppression
+      .where(source_kind: ['google_drive_path_prefix', 'legacy_drive_path_prefix'])
+      .where('drive_path = :path OR :path LIKE CONCAT(drive_path, "/%")', path: normalized_path)
+      .order(:id)
+      .first
+  end
+
+  def self.suppressed?(...)
+    match(...).present?
+  end
+
+  def self.validate_relative_path! relative_path
+    raw = relative_path.to_s.delete("\0").tr('\\', '/').strip
+    raise ArgumentError, 'relative_path is required' if raw.blank?
+    raise ArgumentError, 'relative_path must be relative' if raw.start_with?('/')
+    raise ArgumentError, 'relative_path must be relative' if raw.match?(/\A[A-Za-z]:\//)
+    if raw.start_with?('My Drive/', 'マイドライブ/')
+      raise ArgumentError, 'relative_path must be relative to source folder'
+    end
+    raise ArgumentError, 'relative_path must not contain //' if raw.include?('//')
+    raise ArgumentError, 'relative_path must not end with /' if raw.end_with?('/')
+
+    parts = raw.split('/')
+    if parts.any? { |part| part.in?(['.', '..']) }
+      raise ArgumentError, 'relative_path must not contain dot segments'
+    end
+
+    raw
+  end
+
+  def self.normalize_key source_kind, value
+    return nil if value.blank?
+
+    MaterialSyncSuppression.normalize_source_key(source_kind:, source_path: value,
+                                                 source_file_id: value)
+  end
+end

backend/app/services/material_sync_suppression_registrar.rb

@@ -0,0 +1,51 @@
+class MaterialSyncSuppressionRegistrar
+  def self.create! attributes, created_by_user:
+    new(attributes, created_by_user:).create!
+  end
+
+  def initialize attributes, created_by_user:
+    @attributes = attributes
+    @created_by_user = created_by_user
+  end
+
+  def create!
+    suppression = nil
+
+    MaterialSyncSuppression.transaction do
+      suppression = MaterialSyncSuppression.create!(
+          @attributes.merge(created_by_user: @created_by_user))
+      discard_existing_materials!(suppression)
+    end
+
+    suppression
+  end
+
+  private
+
+  def discard_existing_materials! suppression
+    matching_materials(suppression).find_each do |material|
+      MaterialVersionRecorder.ensure_snapshot!(material, created_by_user: @created_by_user)
+      material.discard!
+      MaterialVersionRecorder.record!(material:,
+                                      event_type: :discard,
+                                      created_by_user: @created_by_user)
+    end
+  end
+
+  def matching_materials suppression
+    materials = Material.unscoped.kept
+
+    case suppression.source_kind
+    when 'google_drive_path', 'legacy_drive_path'
+      materials.where(source_path: suppression.drive_path)
+    when 'google_drive_path_prefix', 'legacy_drive_path_prefix'
+      path = suppression.drive_path.to_s
+      materials.where(
+          'source_path = :path OR source_path LIKE :prefix',
+          path:,
+          prefix: "#{ path }/%")
+    else
+      materials.where(normalized_source_key: suppression.normalized_source_key)
+    end
+  end
+end

backend/app/services/material_thumbnail_generator.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require 'mini_magick'
+require 'open3'
+require 'tempfile'
+
+
+class MaterialThumbnailGenerator
+  SIZE = '180x180'
+
+  class << self
+    def generate! material
+      new(material).generate!
+    end
+  end
+
+  def initialize material
+    @material = material
+    @ffmpeg_stderr = []
+  end
+
+  def generate!
+    return log_result(:no_file) unless @material.file.attached?
+    return log_result(:unsupported_content_type) unless image? || video?
+
+    @material.file.blob.open do |file|
+      thumbnail = image? ? image_thumbnail(file.path) : video_thumbnail(file.path)
+      return log_result(:generation_failed) unless thumbnail
+
+      return attach_thumbnail(thumbnail)
+    end
+  rescue ActiveStorage::FileNotFoundError => e
+    log_result(:file_not_found, error: e)
+  rescue MiniMagick::Error => e
+    log_result(:mini_magick_error, error: e)
+  rescue ArgumentError, StandardError => e
+    log_result(:generation_failed, error: e)
+  end
+
+  private
+
+  def image? = content_type.start_with?('image/')
+
+  def video? = content_type.start_with?('video/')
+
+  def content_type
+    return nil unless @material.file.attached?
+
+    @material.file.blob.content_type.to_s
+  end
+
+  def image_thumbnail path
+    image = MiniMagick::Image.open(path)
+    image.resize(SIZE)
+    image.format('jpg')
+    image
+  end
+
+  def video_thumbnail path
+    [1, 0].each do |seconds|
+      tempfile = Tempfile.new(['material-thumbnail', '.jpg'])
+      tempfile.close
+      ok = extract_video_frame(path, tempfile.path, seconds)
+      next unless ok && File.size?(tempfile.path)
+
+      return image_thumbnail(tempfile.path)
+    ensure
+      tempfile&.unlink
+    end
+
+    nil
+  end
+
+  def extract_video_frame input_path, output_path, seconds
+    _stdout, stderr, status =
+        Open3.capture3('ffmpeg',
+                       '-y',
+                       '-ss', seconds.to_s,
+                       '-i', input_path,
+                       '-frames:v', '1',
+                       '-f', 'image2',
+                       output_path)
+    @ffmpeg_stderr << stderr if stderr.present?
+    status.success?
+  rescue Errno::ENOENT => e
+    @ffmpeg_stderr << "ffmpeg unavailable: #{ e.message }"
+    false
+  end
+
+  def attach_thumbnail image
+    blob = nil
+    File.open(image.path) do |io|
+      blob = ActiveStorage::Blob.create_and_upload!(
+          io:,
+          filename: 'material-thumbnail.jpg',
+          content_type: 'image/jpeg')
+    end
+    @material.thumbnail.attach(blob)
+    log_result(:attached)
+  rescue StandardError => e
+    blob&.purge_later
+    log_result(:attach_failed, error: e)
+  end
+
+  def log_result result, error: nil
+    log_payload = { material_id: @material.id,
+                    file_blob_id: file_blob_id,
+                    content_type:,
+                    result:,
+                    error_class: error&.class&.name,
+                    error_message: error&.message,
+                    ffmpeg_stderr: @ffmpeg_stderr.join("\n").presence }
+    if [:attached, :no_file, :unsupported_content_type].include?(result)
+      Rails.logger.info("Material thumbnail generation: #{ log_payload.to_json }")
+    else
+      Rails.logger.warn("Material thumbnail generation: #{ log_payload.to_json }")
+    end
+    result
+  end
+
+  def file_blob_id
+    return nil unless @material.file.attached?
+
+    @material.file.blob.id
+  end
+end

backend/app/services/material_version_recorder.rb

@@ -1,5 +1,5 @@
 class MaterialVersionRecorder < VersionRecorder
-  EVENT_TYPES = ['create', 'update', 'discard', 'restore', 'suppress'].freeze
+  EVENT_TYPES = ['create', 'update', 'discard', 'restore'].freeze
 
   def self.record! material:, event_type:, created_by_user:, file_snapshot: nil
     new(material:, event_type:, created_by_user:, file_snapshot:).record!
@@ -33,6 +33,11 @@ class MaterialVersionRecorder < VersionRecorder
       tag: @record.tag,
       tag_name: @record.tag&.name,
       tag_category: @record.tag&.category,
+      source_kind: @record.source_kind,
+      source_uri: @record.source_uri,
+      source_path: @record.source_path,
+      source_file_id: @record.source_file_id,
+      normalized_source_key: @record.normalized_source_key,
       export_paths_json: @record.snapshot_export_paths,
       discarded_at: @record.discarded_at,
       file_blob_id: file_snapshot[:file_blob_id],
@@ -40,24 +45,19 @@ class MaterialVersionRecorder < VersionRecorder
       file_content_type: file_snapshot[:file_content_type],
       file_byte_size: file_snapshot[:file_byte_size],
       file_checksum: file_snapshot[:file_checksum],
-      file_sha256: file_snapshot[:file_sha256],
+      file_sha256: file_snapshot[:file_sha256] }
-      file_suppressed_at: @record.file_suppressed_at,
-      file_suppression_reason: @record.file_suppression_reason }
   end
 
   def build_file_snapshot blob
     return @file_snapshot if @file_snapshot
     return empty_file_snapshot unless blob
 
-    blob.metadata['sha256'] ||= MaterialFileSha256.from_blob(blob)
-    blob.save! if blob.changed?
-
     { file_blob_id: blob.id,
       file_filename: blob.filename.to_s,
       file_content_type: blob.content_type,
       file_byte_size: blob.byte_size,
       file_checksum: blob.checksum,
-      file_sha256: blob.metadata['sha256'] }
+      file_sha256: MaterialFileSha256.metadata_sha256(blob) }
   end
 
   def empty_file_snapshot

backend/app/services/material_zip_exporter.rb

@@ -5,9 +5,19 @@ require 'zlib'
 # Keep this service boundary stable so job/cached export paths can replace it later.
 class MaterialZipExporter
   Entry = Struct.new(:path, :data, :mtime, keyword_init: true)
+  MissingFile = Struct.new(:material_id, :export_path, :blob_id, :filename, keyword_init: true)
 
   class EmptyExportError < StandardError; end
   class DuplicatePathError < StandardError; end
+  class MissingFileError < StandardError
+    attr_reader :missing_files
+
+    def initialize missing_files
+      @missing_files = missing_files
+
+      super("Missing files: #{missing_files.map(&:export_path).join(', ')}")
+    end
+  end
 
   def initialize profile: 'legacy_drive', tag_id: nil
     @profile = profile.presence || 'legacy_drive'
@@ -30,20 +40,26 @@ class MaterialZipExporter
            .joins(:material)
            .merge(Material.kept)
            .where(profile: @profile)
-           .where(materials: { file_suppressed_at: nil })
            .order(:export_path)
 
     rows = rows.where(materials: { tag_id: @tag_id }) if @tag_id
 
+    missing_files = []
+
     entries = rows.filter_map do |item|
       material = item.material
       next unless material.file.attached?
 
+      data = download_blob(item, missing_files)
+      next unless data
+
       Entry.new(path: item.export_path,
-                data: material.file.blob.download,
+                data:,
                 mtime: material.updated_at || Time.current)
     end
 
+    raise MissingFileError.new(missing_files) if missing_files.any?
+
     paths = entries.map(&:path)
     duplicated = paths.find { |path| paths.count(path) > 1 }
     raise DuplicatePathError, duplicated if duplicated
@@ -51,6 +67,20 @@ class MaterialZipExporter
     entries
   end
 
+  def download_blob item, missing_files
+    blob = item.material.file.blob
+
+    blob.download
+  rescue ActiveStorage::FileNotFoundError
+    missing_files << MissingFile.new(
+        material_id: item.material_id,
+        export_path: item.export_path,
+        blob_id: blob.id,
+        filename: blob.filename.to_s,
+    )
+    nil
+  end
+
   class ZipWriter
     VERSION_NEEDED = 20
     GP_FLAG = 0x0800

backend/config/routes.rb

@@ -114,9 +114,7 @@ Rails.application.routes.draw do
   end
 
   get 'materials/download.zip', to: 'materials#download'
-  resources :materials, only: [:index, :show, :create, :update, :destroy] do
+  get 'materials/versions', to: 'material_versions#index'
-    member do
+  resources :material_sync_suppressions, path: 'materials/suppressions', only: [:index, :create]
-      patch :suppress_file
+  resources :materials, only: [:index, :show, :create, :update, :destroy]
-    end
-  end
 end

backend/db/migrate/20260623000000_enhance_material_management.rb

@@ -2,9 +2,6 @@ class EnhanceMaterialManagement < ActiveRecord::Migration[8.0]
   def up
     change_table :materials, bulk: true do |t|
       t.integer :version_no, null: false, default: 1
-      t.datetime :file_suppressed_at
-      t.references :file_suppressed_by_user, foreign_key: { to_table: :users }
-      t.string :file_suppression_reason
     end
 
     change_table :material_versions, bulk: true do |t|
@@ -18,8 +15,6 @@ class EnhanceMaterialManagement < ActiveRecord::Migration[8.0]
       t.bigint :file_byte_size
       t.string :file_checksum
       t.string :file_sha256
-      t.datetime :file_suppressed_at
-      t.string :file_suppression_reason
     end
 
     execute <<~SQL.squish
@@ -35,7 +30,7 @@ class EnhanceMaterialManagement < ActiveRecord::Migration[8.0]
     add_index :material_versions, :file_blob_id
 
     add_check_constraint :material_versions,
-                         "event_type IN ('create', 'update', 'discard', 'restore', 'suppress')",
+                         "event_type IN ('create', 'update', 'discard', 'restore')",
                          name: 'material_versions_event_type_valid'
 
     create_table :material_export_items do |t|
@@ -87,12 +82,7 @@ class EnhanceMaterialManagement < ActiveRecord::Migration[8.0]
     remove_column :material_versions, :file_byte_size
     remove_column :material_versions, :file_checksum
     remove_column :material_versions, :file_sha256
-    remove_column :material_versions, :file_suppressed_at
-    remove_column :material_versions, :file_suppression_reason
 
-    remove_reference :materials, :file_suppressed_by_user, foreign_key: { to_table: :users }
     remove_column :materials, :version_no
-    remove_column :materials, :file_suppressed_at
-    remove_column :materials, :file_suppression_reason
   end
 end

backend/db/migrate/20260625000000_reconcile_material_sync_suppressions.rb

@@ -0,0 +1,118 @@
+class ReconcileMaterialSyncSuppressions < ActiveRecord::Migration[8.0]
+  MATERIAL_VERSION_EVENT_CONSTRAINT = 'material_versions_event_type_valid'
+
+  def up
+    ensure_material_sync_suppressions!
+    ensure_material_source_columns!
+    ensure_material_active_source_key!
+    remove_material_file_suppression!
+    remove_material_version_file_suppression!
+    reconcile_material_version_event_constraint!
+  end
+
+  def down
+    raise ActiveRecord::IrreversibleMigration
+  end
+
+  private
+
+  def ensure_material_sync_suppressions!
+    return if table_exists?(:material_sync_suppressions)
+
+    create_table :material_sync_suppressions do |t|
+      t.string :source_kind, null: false
+      t.string :source_uri
+      t.string :drive_path
+      t.string :drive_file_id
+      t.string :normalized_source_key, null: false
+      t.string :reason, null: false
+      t.references :created_by_user, foreign_key: { to_table: :users }
+      t.timestamps
+
+      t.index :normalized_source_key, unique: true
+      t.index :source_kind
+      t.index :drive_file_id
+    end
+  end
+
+  def ensure_material_source_columns!
+    add_column :materials, :source_kind, :string unless column_exists?(:materials, :source_kind)
+    add_column :materials, :source_uri, :string unless column_exists?(:materials, :source_uri)
+    add_column :materials, :source_path, :string unless column_exists?(:materials, :source_path)
+    unless column_exists?(:materials, :source_file_id)
+      add_column :materials, :source_file_id, :string
+    end
+    unless column_exists?(:materials, :normalized_source_key)
+      add_column :materials, :normalized_source_key, :string
+    end
+
+    if index_exists?(:materials, :normalized_source_key)
+      remove_index :materials, column: :normalized_source_key
+    end
+  end
+
+  def ensure_material_active_source_key!
+    unless column_exists?(:materials, :active_normalized_source_key)
+      change_table :materials do |t|
+        t.virtual :active_normalized_source_key,
+                  type: :string,
+                  as: 'IF(discarded_at IS NULL, normalized_source_key, NULL)',
+                  stored: false
+      end
+    end
+
+    return if index_exists?(:materials,
+                            :active_normalized_source_key,
+                            name: 'index_materials_on_active_normalized_source_key')
+
+    add_index :materials,
+              :active_normalized_source_key,
+              unique: true,
+              name: 'index_materials_on_active_normalized_source_key'
+  end
+
+  def remove_material_file_suppression!
+    if foreign_key_exists?(:materials, :users, column: :file_suppressed_by_user_id)
+      remove_foreign_key :materials, column: :file_suppressed_by_user_id
+    end
+
+    if index_exists?(:materials,
+                    :file_suppressed_by_user_id,
+                    name: 'index_materials_on_file_suppressed_by_user_id')
+      remove_index :materials, name: 'index_materials_on_file_suppressed_by_user_id'
+    end
+
+    remove_column :materials, :file_suppressed_at if column_exists?(
+        :materials,
+        :file_suppressed_at)
+    remove_column :materials, :file_suppressed_by_user_id if column_exists?(
+        :materials,
+        :file_suppressed_by_user_id)
+    remove_column :materials, :file_suppression_reason if column_exists?(
+        :materials,
+        :file_suppression_reason)
+  end
+
+  def remove_material_version_file_suppression!
+    remove_column :material_versions, :file_suppressed_at if column_exists?(
+        :material_versions,
+        :file_suppressed_at)
+    remove_column :material_versions, :file_suppression_reason if column_exists?(
+        :material_versions,
+        :file_suppression_reason)
+  end
+
+  def reconcile_material_version_event_constraint!
+    constraint = check_constraints(:material_versions).find do |candidate|
+      candidate.name == MATERIAL_VERSION_EVENT_CONSTRAINT
+    end
+    return if constraint && !constraint.expression.include?('suppress')
+
+    if constraint
+      remove_check_constraint :material_versions, name: MATERIAL_VERSION_EVENT_CONSTRAINT
+    end
+    add_check_constraint :material_versions,
+                         "event_type IN ('create', 'update', 'discard', 'restore')",
+                         name: MATERIAL_VERSION_EVENT_CONSTRAINT
+  end
+end

backend/db/migrate/20260625010000_create_material_sync_sources.rb

@@ -0,0 +1,22 @@
+class CreateMaterialSyncSources < ActiveRecord::Migration[8.0]
+  def change
+    create_table :material_sync_sources do |t|
+      t.string :name, null: false
+      t.string :source_kind, null: false
+      t.string :source_uri
+      t.string :source_path
+      t.string :source_file_id
+      t.string :profile, null: false, default: 'legacy_drive'
+      t.boolean :enabled, null: false, default: true
+      t.string :default_tag_name
+      t.string :export_path_prefix
+      t.datetime :last_synced_at
+      t.references :created_by_user, foreign_key: { to_table: :users }
+      t.references :updated_by_user, foreign_key: { to_table: :users }
+      t.timestamps
+
+      t.index :enabled
+      t.index :source_kind
+    end
+  end
+end

backend/db/migrate/20260626000000_add_source_snapshot_to_material_versions.rb

@@ -0,0 +1,19 @@
+class AddSourceSnapshotToMaterialVersions < ActiveRecord::Migration[8.0]
+  def change
+    unless column_exists?(:material_versions, :source_kind)
+      add_column :material_versions, :source_kind, :string
+    end
+    unless column_exists?(:material_versions, :source_uri)
+      add_column :material_versions, :source_uri, :string
+    end
+    unless column_exists?(:material_versions, :source_path)
+      add_column :material_versions, :source_path, :string
+    end
+    unless column_exists?(:material_versions, :source_file_id)
+      add_column :material_versions, :source_file_id, :string
+    end
+    unless column_exists?(:material_versions, :normalized_source_key)
+      add_column :material_versions, :normalized_source_key, :string
+    end
+  end
+end

backend/db/migrate/20260626010000_backfill_initial_material_versions.rb

@@ -0,0 +1,171 @@
+require 'json'
+
+class BackfillInitialMaterialVersions < ActiveRecord::Migration[8.0]
+  class MigrationMaterial < ActiveRecord::Base
+    self.table_name = 'materials'
+  end
+
+  class MigrationMaterialExportItem < ActiveRecord::Base
+    self.table_name = 'material_export_items'
+  end
+
+  class MigrationMaterialVersion < ActiveRecord::Base
+    self.table_name = 'material_versions'
+  end
+
+  class MigrationStorageAttachment < ActiveRecord::Base
+    self.table_name = 'active_storage_attachments'
+  end
+
+  class MigrationStorageBlob < ActiveRecord::Base
+    self.table_name = 'active_storage_blobs'
+  end
+
+  class MigrationTag < ActiveRecord::Base
+    self.table_name = 'tags'
+  end
+
+  class MigrationTagName < ActiveRecord::Base
+    self.table_name = 'tag_names'
+  end
+
+  def up
+    say_with_time 'Backfilling initial material versions' do
+      materials_without_versions.find_in_batches(batch_size: 500) do |materials|
+        material_ids = materials.map(&:id)
+        tags_by_id = load_tags(materials.map(&:tag_id).compact.uniq)
+        export_paths_by_material_id = load_export_paths(material_ids)
+        file_snapshots_by_material_id = load_file_snapshots(material_ids)
+
+        rows = materials.map do |material|
+          tag = tags_by_id[material.tag_id]
+          file_snapshot = file_snapshots_by_material_id[material.id] || empty_file_snapshot
+
+          { material_id: material.id,
+            version_no: 1,
+            event_type: 'create',
+            url: material.url,
+            parent_id: material.parent_id,
+            tag_id: material.tag_id,
+            tag_name: tag&.fetch(:name, nil),
+            tag_category: tag&.fetch(:category, nil),
+            source_kind: material.source_kind,
+            source_uri: material.source_uri,
+            source_path: material.source_path,
+            source_file_id: material.source_file_id,
+            normalized_source_key: material.normalized_source_key,
+            export_paths_json: export_paths_by_material_id[material.id] || { },
+            discarded_at: material.discarded_at,
+            file_blob_id: file_snapshot[:file_blob_id],
+            file_filename: file_snapshot[:file_filename],
+            file_content_type: file_snapshot[:file_content_type],
+            file_byte_size: file_snapshot[:file_byte_size],
+            file_checksum: file_snapshot[:file_checksum],
+            file_sha256: file_snapshot[:file_sha256],
+            created_by_user_id: material.created_by_user_id,
+            updated_by_user_id: material.updated_by_user_id,
+            created_at: material.created_at,
+            updated_at: material.created_at }
+        end
+
+        MigrationMaterialVersion.insert_all!(rows) if rows.present?
+      end
+    end
+
+    execute <<~SQL.squish
+      UPDATE materials
+      SET version_no = COALESCE(
+        (
+          SELECT MAX(material_versions.version_no)
+          FROM material_versions
+          WHERE material_versions.material_id = materials.id
+        ),
+        1
+      )
+    SQL
+  end
+
+  def down
+    raise ActiveRecord::IrreversibleMigration
+  end
+
+  private
+
+  def materials_without_versions
+    MigrationMaterial.where.not(id: MigrationMaterialVersion.select(:material_id))
+  end
+
+  def load_tags tag_ids
+    return { } if tag_ids.empty?
+
+    tag_name_ids_by_tag_id = MigrationTag.where(id: tag_ids).pluck(:id, :tag_name_id).to_h
+    tag_names_by_id =
+        MigrationTagName
+        .where(id: tag_name_ids_by_tag_id.values.uniq)
+        .pluck(:id, :name)
+        .to_h
+    categories_by_tag_id = MigrationTag.where(id: tag_ids).pluck(:id, :category).to_h
+
+    tag_ids.each_with_object({ }) do |tag_id, hash|
+      hash[tag_id] = { name: tag_names_by_id[tag_name_ids_by_tag_id[tag_id]],
+                       category: categories_by_tag_id[tag_id] }
+    end
+  end
+
+  def load_export_paths material_ids
+    MigrationMaterialExportItem
+      .where(material_id: material_ids)
+      .order(:material_id, :profile)
+      .pluck(:material_id, :profile, :export_path)
+      .each_with_object({ }) do |(material_id, profile, export_path), hash|
+        hash[material_id] ||= { }
+        hash[material_id][profile] = export_path
+      end
+  end
+
+  def load_file_snapshots material_ids
+    attachments_by_material_id =
+        MigrationStorageAttachment
+        .where(record_type: 'Material', name: 'file', record_id: material_ids)
+        .pluck(:record_id, :blob_id)
+        .to_h
+
+    blobs_by_id =
+        MigrationStorageBlob
+        .where(id: attachments_by_material_id.values.uniq)
+        .index_by(&:id)
+
+    attachments_by_material_id.each_with_object({ }) do |(material_id, blob_id), hash|
+      blob = blobs_by_id[blob_id]
+      next unless blob
+
+      hash[material_id] = {
+        file_blob_id: blob.id,
+        file_filename: blob.filename.to_s,
+        file_content_type: blob.content_type,
+        file_byte_size: blob.byte_size,
+        file_checksum: blob.checksum,
+        file_sha256: blob_metadata(blob)['sha256']
+      }
+    end
+  end
+
+  def empty_file_snapshot
+    { file_blob_id: nil,
+      file_filename: nil,
+      file_content_type: nil,
+      file_byte_size: nil,
+      file_checksum: nil,
+      file_sha256: nil }
+  end
+
+  def blob_metadata blob
+    metadata = blob.metadata
+    return metadata if metadata.is_a?(Hash)
+    return { } if metadata.blank?
+
+    JSON.parse(metadata)
+  rescue JSON::ParserError
+    { }
+  end
+end

backend/db/schema.rb

@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema[8.0].define(version: 2026_06_23_000000) do
+ActiveRecord::Schema[8.0].define(version: 2026_06_26_010000) do
   create_table "active_storage_attachments", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
     t.string "name", null: false
     t.string "record_type", null: false
@@ -156,6 +156,43 @@ ActiveRecord::Schema[8.0].define(version: 2026_06_23_000000) do
     t.index ["created_by_user_id"], name: "index_material_import_blocks_on_created_by_user_id"
   end
 
+  create_table "material_sync_sources", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
+    t.string "name", null: false
+    t.string "source_kind", null: false
+    t.string "source_uri"
+    t.string "source_path"
+    t.string "source_file_id"
+    t.string "profile", default: "legacy_drive", null: false
+    t.boolean "enabled", default: true, null: false
+    t.string "default_tag_name"
+    t.string "export_path_prefix"
+    t.datetime "last_synced_at"
+    t.bigint "created_by_user_id"
+    t.bigint "updated_by_user_id"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["created_by_user_id"], name: "index_material_sync_sources_on_created_by_user_id"
+    t.index ["enabled"], name: "index_material_sync_sources_on_enabled"
+    t.index ["source_kind"], name: "index_material_sync_sources_on_source_kind"
+    t.index ["updated_by_user_id"], name: "index_material_sync_sources_on_updated_by_user_id"
+  end
+
+  create_table "material_sync_suppressions", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
+    t.string "source_kind", null: false
+    t.string "source_uri"
+    t.string "drive_path"
+    t.string "drive_file_id"
+    t.string "normalized_source_key", null: false
+    t.string "reason", null: false
+    t.bigint "created_by_user_id"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["created_by_user_id"], name: "index_material_sync_suppressions_on_created_by_user_id"
+    t.index ["drive_file_id"], name: "index_material_sync_suppressions_on_drive_file_id"
+    t.index ["normalized_source_key"], name: "index_material_sync_suppressions_on_normalized_source_key", unique: true
+    t.index ["source_kind"], name: "index_material_sync_suppressions_on_source_kind"
+  end
+
   create_table "material_versions", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
     t.bigint "material_id", null: false
     t.integer "version_no", null: false
@@ -177,8 +214,11 @@ ActiveRecord::Schema[8.0].define(version: 2026_06_23_000000) do
     t.bigint "file_byte_size"
     t.string "file_checksum"
     t.string "file_sha256"
-    t.datetime "file_suppressed_at"
+    t.string "source_kind"
-    t.string "file_suppression_reason"
+    t.string "source_uri"
+    t.string "source_path"
+    t.string "source_file_id"
+    t.string "normalized_source_key"
     t.index ["created_by_user_id"], name: "index_material_versions_on_created_by_user_id"
     t.index ["discarded_at"], name: "index_material_versions_on_discarded_at"
     t.index ["file_blob_id"], name: "index_material_versions_on_file_blob_id"
@@ -188,7 +228,7 @@ ActiveRecord::Schema[8.0].define(version: 2026_06_23_000000) do
     t.index ["tag_id"], name: "index_material_versions_on_tag_id"
     t.index ["updated_by_user_id"], name: "index_material_versions_on_updated_by_user_id"
     t.index ["url"], name: "index_material_versions_on_url"
-    t.check_constraint "`event_type` in (_utf8mb4'create',_utf8mb4'update',_utf8mb4'discard',_utf8mb4'restore',_utf8mb4'suppress')", name: "material_versions_event_type_valid"
+    t.check_constraint "`event_type` in (_utf8mb4'create',_utf8mb4'update',_utf8mb4'discard',_utf8mb4'restore')", name: "material_versions_event_type_valid"
   end
 
   create_table "materials", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
@@ -202,13 +242,16 @@ ActiveRecord::Schema[8.0].define(version: 2026_06_23_000000) do
     t.datetime "discarded_at"
     t.virtual "active_url", type: :string, as: "if((`discarded_at` is null),`url`,NULL)"
     t.integer "version_no", default: 1, null: false
-    t.datetime "file_suppressed_at"
+    t.string "source_kind"
-    t.bigint "file_suppressed_by_user_id"
+    t.string "source_uri"
-    t.string "file_suppression_reason"
+    t.string "source_path"
+    t.string "source_file_id"
+    t.string "normalized_source_key"
+    t.virtual "active_normalized_source_key", type: :string, as: "if((`discarded_at` is null),`normalized_source_key`,NULL)"
+    t.index ["active_normalized_source_key"], name: "index_materials_on_active_normalized_source_key", unique: true
     t.index ["active_url"], name: "index_materials_on_active_url", unique: true
     t.index ["created_by_user_id"], name: "index_materials_on_created_by_user_id"
     t.index ["discarded_at"], name: "index_materials_on_discarded_at"
-    t.index ["file_suppressed_by_user_id"], name: "index_materials_on_file_suppressed_by_user_id"
     t.index ["parent_id"], name: "index_materials_on_parent_id"
     t.index ["tag_id"], name: "index_materials_on_tag_id"
     t.index ["updated_by_user_id"], name: "index_materials_on_updated_by_user_id"
@@ -615,6 +658,9 @@ ActiveRecord::Schema[8.0].define(version: 2026_06_23_000000) do
   add_foreign_key "material_export_items", "materials"
   add_foreign_key "material_export_items", "users", column: "created_by_user_id"
   add_foreign_key "material_import_blocks", "users", column: "created_by_user_id"
+  add_foreign_key "material_sync_sources", "users", column: "created_by_user_id"
+  add_foreign_key "material_sync_sources", "users", column: "updated_by_user_id"
+  add_foreign_key "material_sync_suppressions", "users", column: "created_by_user_id"
   add_foreign_key "material_versions", "materials"
   add_foreign_key "material_versions", "materials", column: "parent_id"
   add_foreign_key "material_versions", "tags"
@@ -623,7 +669,6 @@ ActiveRecord::Schema[8.0].define(version: 2026_06_23_000000) do
   add_foreign_key "materials", "materials", column: "parent_id"
   add_foreign_key "materials", "tags"
   add_foreign_key "materials", "users", column: "created_by_user_id"
-  add_foreign_key "materials", "users", column: "file_suppressed_by_user_id"
   add_foreign_key "materials", "users", column: "updated_by_user_id"
   add_foreign_key "nico_tag_relations", "tags"
   add_foreign_key "nico_tag_relations", "tags", column: "nico_tag_id"

backend/db/seeds.rb

@@ -7,3 +7,21 @@
 #   ["Action", "Comedy", "Drama", "Horror"].each do |genre_name|
 #     MovieGenre.find_or_create_by!(name: genre_name)
 #   end
+
+material_sync_source_uri = ENV['MATERIAL_SYNC_SOURCE_URI']
+material_sync_source_file_id = ENV['MATERIAL_SYNC_SOURCE_FILE_ID']
+
+if material_sync_source_uri.present? || material_sync_source_file_id.present?
+  source = MaterialSyncSource.find_or_initialize_by(
+      name: ENV.fetch('MATERIAL_SYNC_SOURCE_NAME', 'Legacy URI material sync'))
+  source.assign_attributes(
+      source_kind: ENV.fetch('MATERIAL_SYNC_SOURCE_KIND', 'uri'),
+      source_uri: material_sync_source_uri,
+      source_path: ENV['MATERIAL_SYNC_SOURCE_PATH'],
+      source_file_id: material_sync_source_file_id,
+      profile: ENV.fetch('MATERIAL_SYNC_SOURCE_PROFILE', 'legacy_drive'),
+      enabled: ENV.fetch('MATERIAL_SYNC_SOURCE_ENABLED', 'true') != 'false',
+      default_tag_name: ENV['MATERIAL_SYNC_SOURCE_TAG_NAME'],
+      export_path_prefix: ENV['MATERIAL_SYNC_EXPORT_PATH_PREFIX'])
+  source.save!
+end

backend/lib/tasks/sync_materials.rake

@@ -0,0 +1,51 @@
+namespace :materials do
+  desc '素材同期'
+  task sync: :environment do
+    result = MaterialSyncRunner.sync_enabled!
+    message = [
+      "materials:sync imported=#{ result.imported }",
+      "updated=#{ result.updated }",
+      "unchanged=#{ result.unchanged }",
+      "suppressed=#{ result.suppressed }",
+      "failed=#{ result.failed }"
+    ].join(' ')
+
+    Rails.logger.info(message)
+    puts message
+
+    result.errors.each do |error|
+      Rails.logger.warn(error.to_json)
+      warn error.to_json
+    end
+  end
+
+  namespace :thumbnails do
+    desc '素材サムネールを補完'
+    task backfill: :environment do
+      counts = Hash.new(0)
+
+      Material
+        .with_attached_file
+        .with_attached_thumbnail
+        .find_each do |material|
+          next unless material.file.attached?
+          next if material.thumbnail.attached?
+
+          result = MaterialThumbnailGenerator.generate!(material)
+          counts[result] += 1
+        end
+
+      message =
+          "materials:thumbnails:backfill " \
+          "attached=#{ counts[:attached] } " \
+          "no_file=#{ counts[:no_file] } " \
+          "unsupported_content_type=#{ counts[:unsupported_content_type] } " \
+          "generation_failed=#{ counts[:generation_failed] } " \
+          "attach_failed=#{ counts[:attach_failed] } " \
+          "file_not_found=#{ counts[:file_not_found] } " \
+          "mini_magick_error=#{ counts[:mini_magick_error] }"
+      Rails.logger.info(message)
+      puts message
+    end
+  end
+end

backend/spec/models/material_spec.rb

@@ -0,0 +1,19 @@
+require 'rails_helper'
+
+RSpec.describe Material, type: :model do
+  let(:user) { create(:user, :member) }
+
+  it 'allows only material source kinds, not suppression prefix kinds' do
+    material = described_class.new(url: 'https://example.com/material',
+                                   source_kind: 'google_drive_path_prefix',
+                                   source_path: '素材/危険',
+                                   created_by_user: user,
+                                   updated_by_user: user)
+
+    expect(material).not_to be_valid
+    expect(material.errors[:source_kind]).to be_present
+
+    material.source_kind = 'google_drive_path'
+    expect(material).to be_valid
+  end
+end

backend/spec/models/tag_implication_spec.rb

@@ -0,0 +1,36 @@
+require 'rails_helper'
+
+RSpec.describe TagImplication, type: :model do
+  it 'rejects a parent tag that would create a cycle' do
+    child = create(:tag, name: 'tag_implication_cycle_child')
+    parent = create(:tag, name: 'tag_implication_cycle_parent')
+
+    described_class.create!(tag: child, parent_tag: parent)
+
+    implication = described_class.new(tag: parent, parent_tag: child)
+
+    expect(implication).not_to be_valid
+    expect(implication.errors[:parent_tag_id]).to include(
+      '親タグに子孫タグを指定すると循環します．'
+    )
+    expect(implication.errors[:base]).to be_present
+  end
+
+  it 'terminates even when existing data already contains a cycle' do
+    child = create(:tag, name: 'tag_implication_existing_cycle_child')
+    parent = create(:tag, name: 'tag_implication_existing_cycle_parent')
+    ancestor = create(:tag, name: 'tag_implication_existing_cycle_ancestor')
+
+    described_class.create!(tag: parent, parent_tag: ancestor)
+    described_class.insert_all!(
+      [
+        { tag_id: ancestor.id, parent_tag_id: parent.id,
+          created_at: Time.current, updated_at: Time.current }
+      ]
+    )
+
+    implication = described_class.new(tag: child, parent_tag: parent)
+
+    expect(implication).to be_valid
+  end
+end

backend/spec/models/tag_spec.rb

@@ -54,7 +54,17 @@ RSpec.describe Tag, type: :model do
       first = create(:tag, name: 'expand_cycle_first')
       second = create(:tag, name: 'expand_cycle_second')
       TagImplication.create!(tag: first, parent_tag: second)
-      TagImplication.create!(tag: second, parent_tag: first)
+      now = Time.current
+      TagImplication.insert_all!(
+        [
+          {
+            tag_id: second.id,
+            parent_tag_id: first.id,
+            created_at: now,
+            updated_at: now
+          }
+        ]
+      )
 
       expect(described_class.expand_parent_tags([first])).to contain_exactly(first, second)
     end

backend/spec/requests/materials_spec.rb

@@ -64,27 +64,36 @@ RSpec.describe 'Materials API', type: :request do
         'name' => 'material_index_b',
         'category' => 'material'
       )
-      expect(row['created_by_user']).to include(
-        'id' => member_user.id,
-        'name' => member_user.name
-      )
       expect(row['content_type']).to eq('image/png')
+      expect(row['media_kind']).to eq('image')
     end
 
-    it 'filters materials by tag_id' do
+    it 'filters materials by q' do
-      get '/materials', params: { tag_id: material_a.tag_id }
+      get '/materials', params: { q: 'material_index_a' }
 
       expect(response).to have_http_status(:ok)
       expect(json['count']).to eq(1)
       expect(response_materials.map { |m| m['id'] }).to eq([material_a.id])
     end
 
-    it 'filters materials by parent_id' do
+    it 'filters materials by tag_state' do
-      get '/materials', params: { parent_id: material_a.id }
+      untagged =
+          build_material(tag: nil, user: member_user,
+                         file: dummy_upload(filename: 'untagged.png'))
+
+      get '/materials', params: { tag_state: 'untagged' }
 
       expect(response).to have_http_status(:ok)
       expect(json['count']).to eq(1)
-      expect(response_materials.map { |m| m['id'] }).to eq([material_b.id])
+      expect(response_materials.map { |m| m['id'] }).to eq([untagged.id])
+    end
+
+    it 'filters materials by media_kind' do
+      get '/materials', params: { media_kind: 'image' }
+
+      expect(response).to have_http_status(:ok)
+      expect(json['count']).to eq(2)
+      expect(response_materials.map { |m| m['media_kind'] }).to all(eq('image'))
     end
 
     it 'paginates and keeps total count' do
@@ -104,6 +113,68 @@ RSpec.describe 'Materials API', type: :request do
       expect(response_materials.size).to eq(1)
       expect(response_materials.first['id']).to eq(material_b.id)
     end
+
+    it 'filters by descendant tags and returns stable parent tag groups' do
+      root =
+          Tag.create!(tag_name: TagName.create!(name: 'material_scope_root'),
+                      category: :material)
+      child_b =
+          Tag.create!(tag_name: TagName.create!(name: 'material_scope_b'),
+                      category: :material)
+      child_a =
+          Tag.create!(tag_name: TagName.create!(name: 'material_scope_a'),
+                      category: :material)
+      deprecated =
+          Tag.create!(tag_name: TagName.create!(name: 'material_scope_old'),
+                      category: :material,
+                      deprecated_at: Time.current)
+      grandchild =
+          Tag.create!(tag_name: TagName.create!(name: 'material_scope_grandchild'),
+                      category: :material)
+      root_material =
+          build_material(tag: root, user: member_user,
+                         file: dummy_upload(filename: 'root.png'))
+      child_a_material =
+          build_material(tag: child_a, user: member_user,
+                         file: dummy_upload(filename: 'child_a.png'))
+      grandchild_material =
+          build_material(tag: grandchild, user: member_user,
+                         file: dummy_upload(filename: 'grandchild.png'))
+
+      TagImplication.create!(parent_tag: root, tag: child_b)
+      TagImplication.create!(parent_tag: root, tag: child_a)
+      TagImplication.create!(parent_tag: child_b, tag: deprecated)
+      TagImplication.create!(parent_tag: deprecated, tag: grandchild)
+
+      get '/materials',
+          params: { tag_id: root.id, include_descendants: '1',
+                    group_by: 'parent_tag', sort: 'id', direction: 'asc' }
+
+      expect(response).to have_http_status(:ok)
+      expect(response_materials.map { |m| m['id'] })
+        .to include(root_material.id, child_a_material.id, grandchild_material.id)
+      expect(json['tag_scope']).to eq(
+        'tag' => {
+          'id' => root.id,
+          'name' => 'material_scope_root',
+          'category' => 'material'
+        },
+        'include_descendants' => true
+      )
+      expect(json['groups'].map { |group| group.dig('tag', 'name') })
+        .to eq(['material_scope_a', 'material_scope_b', 'material_scope_root'])
+      expect(json['groups'].find { |group| group.dig('tag', 'id') == child_b.id }
+        .fetch('material_ids')).to eq([grandchild_material.id])
+    end
+
+    it 'returns nil tag_scope when tag_id is unknown' do
+      get '/materials', params: { tag_id: 999_999, group_by: 'parent_tag' }
+
+      expect(response).to have_http_status(:ok)
+      expect(json['tag_scope']).to be_nil
+      expect(json['groups']).to eq([])
+      expect(response_materials).to eq([])
+    end
   end
 
   describe 'GET /materials/:id' do
@@ -528,9 +599,8 @@ RSpec.describe 'Materials API', type: :request do
       expect(response.body.b).not_to include('素材/b.png'.b)
     end
 
-    it 'does not include suppressed materials' do
+    it 'does not include disabled export items' do
-      material_b.update!(file_suppressed_at: Time.current,
+      material_b.material_export_items.first.update!(enabled: false)
-                         file_suppression_reason: 'copyright_high_risk')
 
       get '/materials/download.zip', params: { profile: 'legacy_drive' }
 
@@ -540,62 +610,78 @@ RSpec.describe 'Materials API', type: :request do
     end
   end
 
-  describe 'PATCH /materials/:id/suppress_file' do
+  describe 'GET /materials/versions' do
     let!(:tag) do
-      Tag.create!(tag_name: TagName.create!(name: 'material_suppress'), category: :material)
+      Tag.create!(tag_name: TagName.create!(name: 'material_history'), category: :material)
     end
     let!(:material) do
-      build_material(tag:, user: member_user, file: dummy_upload(filename: 'suppress.png'))
+      build_material(tag:, user: member_user, file: dummy_upload(filename: 'history.png'))
     end
 
-    it 'allows admin to suppress a file and records a suppress version' do
+    it 'returns material versions in reverse chronological order' do
-      sign_in_as(admin_user)
+      MaterialVersionRecorder.record!(material:, event_type: :create,
+                                      created_by_user: member_user)
+      material.update!(url: 'https://example.com/history')
+      MaterialVersionRecorder.record!(material:, event_type: :update,
+                                      created_by_user: admin_user)
+
+      get '/materials/versions', params: { material_id: material.id }
+
+      expect(response).to have_http_status(:ok)
+      expect(json['count']).to eq(2)
+      versions = json.fetch('versions')
+      expect(versions.map { |v| v['version_no'] }).to eq([2, 1])
+      expect(versions.first).to include(
+        'material_id' => material.id,
+        'event_type' => 'update',
+        'tag_name' => 'material_history',
+        'file_filename' => 'history.png',
+        'url' => 'https://example.com/history'
+      )
+      expect(versions.first['created_by_user']).to include('id' => admin_user.id)
+    end
+
+    it 'filters material versions by tag and event_type' do
       MaterialVersionRecorder.record!(material:, event_type: :create,
                                       created_by_user: member_user)
 
-      expect do
+      get '/materials/versions', params: {
-        patch "/materials/#{ material.id }/suppress_file",
+        tag: 'material_history',
-              params: { reason: 'copyright_high_risk' }
+        event_type: 'create'
-      end.to change(MaterialVersion, :count).by(1)
+      }
 
       expect(response).to have_http_status(:ok)
+      expect(json.fetch('versions').map { |v| v['material_id'] }).to include(material.id)
+      expect(json.fetch('versions').map { |v| v['event_type'] }).to all(eq('create'))
+    end
+  end
 
-      material.reload
+  describe 'material sync suppressions' do
-      expect(material.file_suppressed_at).to be_present
+    it 'requires member permission for index' do
-      expect(material.file_suppressed_by_user).to eq(admin_user)
+      sign_out
-      expect(material.file_suppression_reason).to eq('copyright_high_risk')
+
-      expect(material.material_versions.order(:version_no).last.event_type).to eq('suppress')
+      get '/materials/suppressions'
-      expect(json['file']).to be_nil
+
-      expect(json['file_suppressed_at']).to be_present
+      expect(response).to have_http_status(:unauthorized)
     end
 
-    it 'purges blob when purge=true is requested' do
+    it 'creates source suppression as member' do
-      sign_in_as(admin_user)
-      old_blob_id = material.file.blob.id
-      MaterialVersionRecorder.record!(material:, event_type: :create,
-                                      created_by_user: member_user)
-
-      expect do
-        patch "/materials/#{ material.id }/suppress_file",
-              params: { reason: 'copyright_takedown', purge: '1' }
-      end.to have_enqueued_job(ActiveStorage::PurgeJob)
-
-      expect(response).to have_http_status(:ok)
-
-      version = material.material_versions.order(:version_no).last
-      expect(version.event_type).to eq('suppress')
-      expect(version.file_blob_id).to eq(old_blob_id)
-      expect(version.file_filename).to eq('suppress.png')
-      expect(version.file_sha256).to be_present
-    end
-
-    it 'rejects member suppression' do
       sign_in_as(member_user)
 
-      patch "/materials/#{ material.id }/suppress_file",
+      expect do
-            params: { reason: 'copyright_high_risk' }
+        post '/materials/suppressions', params: {
+          source_kind: 'google_drive_path_prefix',
+          drive_path: '伊地知ニジカ/危険素材',
+          reason: 'copyright_high_risk'
+        }
+      end.to change(MaterialSyncSuppression, :count).by(1)
 
-      expect(response).to have_http_status(:forbidden)
+      expect(response).to have_http_status(:created)
+      expect(json).to include(
+        'source_kind' => 'google_drive_path_prefix',
+        'drive_path' => '伊地知ニジカ/危険素材',
+        'normalized_source_key' => 'google_drive_path_prefix:伊地知ニジカ/危険素材'
+      )
     end
   end
 

backend/spec/requests/posts_spec.rb

@@ -1,4 +1,5 @@
 require 'rails_helper'
+require 'base64'
 require 'set'
 
 include ActiveSupport::Testing::TimeHelpers
@@ -8,6 +9,11 @@ RSpec.describe 'Posts API', type: :request do
   # resized_thumbnail! が MiniMagick 依存でコケやすいので request spec ではスタブしとくのが無難。
   before do
     allow_any_instance_of(Post).to receive(:resized_thumbnail!).and_return(true)
+    allow(Post).to receive(:resized_thumbnail_attachment).and_return(
+      io: StringIO.new('dummy'),
+      filename: 'resized_thumbnail.jpg',
+      content_type: 'image/jpeg'
+    )
   end
 
   def create_nico_tag!(name)
@@ -19,6 +25,18 @@ RSpec.describe 'Posts API', type: :request do
     Rack::Test::UploadedFile.new(StringIO.new('dummy'), 'image/jpeg', original_filename: 'dummy.jpg')
   end
 
+  def real_thumbnail_upload
+    gif =
+        Base64.decode64(
+            'R0lGODdhAQABAIABAP///wAAACwAAAAAAQABAAACAkQBADs=')
+
+    Rack::Test::UploadedFile.new(
+      StringIO.new(gif),
+      'image/gif',
+      original_filename: 'thumbnail.gif'
+    )
+  end
+
   def post_write_params params = { }
     { parent_post_ids: '' }.merge(params)
   end
@@ -696,6 +714,66 @@ RSpec.describe 'Posts API', type: :request do
       expect(json['tags'][0]).to have_key('name')
     end
 
+    it '201 when posting manually with a thumbnail' do
+      sign_in_as(member)
+      allow(Post).to receive(:resized_thumbnail_attachment).and_call_original
+
+      post '/posts', params: post_write_params(
+        title: 'thumbnail post',
+        url: 'https://example.com/thumbnail-post',
+        tags: 'spec_tag',
+        thumbnail: real_thumbnail_upload
+      )
+
+      expect(response).to have_http_status(:created)
+      post_record = Post.find(json.fetch('id'))
+      expect(post_record.thumbnail).to be_attached
+      expect(post_record.thumbnail.blob.content_type).to eq('image/jpeg')
+      expect { post_record.thumbnail.download }.not_to raise_error
+    end
+
+    it 'resizes the thumbnail before the create transaction begins' do
+      sign_in_as(member)
+
+      open_transactions = []
+      baseline_open_transactions = Post.connection.open_transactions
+      allow(Post).to receive(:resized_thumbnail_attachment) do |_upload|
+        open_transactions << Post.connection.open_transactions
+        { io: StringIO.new('dummy'),
+          filename: 'resized_thumbnail.jpg',
+          content_type: 'image/jpeg' }
+      end
+
+      post '/posts', params: post_write_params(
+        title: 'transaction post',
+        url: 'https://example.com/transaction-post',
+        tags: 'spec_tag',
+        thumbnail: dummy_upload
+      )
+
+      expect(response).to have_http_status(:created)
+      expect(open_transactions).to eq([baseline_open_transactions])
+    end
+
+    it 'returns 422 and does not create a post when thumbnail resize fails' do
+      sign_in_as(member)
+      allow(Post).to receive(:resized_thumbnail_attachment).and_raise(MiniMagick::Error)
+
+      expect {
+        post '/posts', params: post_write_params(
+          title: 'broken thumbnail post',
+          url: 'https://example.com/broken-thumbnail-post',
+          tags: 'spec_tag',
+          thumbnail: dummy_upload
+        )
+      }.not_to change(Post, :count)
+
+      expect(response).to have_http_status(:unprocessable_entity)
+      expect(json.fetch('errors')).to include(
+        'thumbnail' => ['サムネイル画像の変換に失敗しました．']
+      )
+    end
+
     it '201 and creates post + tags when member and tags have aliases' do
       sign_in_as(member)
 

backend/spec/requests/tag_children_spec.rb

@@ -56,6 +56,17 @@ RSpec.describe "TagChildren", type: :request do
 
         expect(response).to have_http_status(:no_content)
       end
+
+      it 'returns 422 and does not create relation when the new link makes a cycle' do
+        TagImplication.create!(tag: parent, parent_tag: child)
+
+        expect {
+          do_request
+        }.not_to change(TagImplication, :count)
+
+        expect(response).to have_http_status(:unprocessable_entity)
+        expect(TagImplication.where(tag: child, parent_tag: parent)).not_to exist
+      end
     end
 
     context "when Tag.find raises (invalid ids)" do

backend/spec/requests/tags_spec.rb

@@ -581,6 +581,58 @@ RSpec.describe 'Tags API', type: :request do
         expect(response).to have_http_status(:ok)
         expect(wiki_page.reload.wiki_versions.count).to eq(before_wiki_version_count)
       end
+
+      it 'full update で旧名 alias が残った tag を PATCH で旧名へ戻せる' do
+        put "/tags/#{ tag.id }", params: {
+          name: 'patch_roundtrip_target',
+          category: 'general',
+          aliases: 'unko',
+          parent_tags: '',
+          deprecated: '0',
+        }
+
+        expect(response).to have_http_status(:ok)
+        expect(TagName.find_by!(name: 'spec_tag').canonical).to eq(tag.reload.tag_name)
+
+        patch "/tags/#{ tag.id }", params: { name: 'spec_tag' }
+
+        expect(response).to have_http_status(:ok)
+
+        tag.reload
+
+        expect(tag.name).to eq('spec_tag')
+        expect(tag.tag_name.canonical_id).to be_nil
+        expect(TagName.find_by!(name: 'patch_roundtrip_target').canonical).to eq(tag.tag_name)
+      end
+
+      it '別 tag の正規名には変更できない' do
+        wiki_page =
+            Wiki::Commit.create_content!(
+                tag_name: tag.tag_name,
+                body: 'patch collision wiki',
+                created_by_user: member_user,
+                message: 'init')
+
+        patch "/tags/#{ tag.id }", params: { name: 'unknown' }
+
+        expect(response).to have_http_status(:unprocessable_entity)
+        expect(json.fetch('errors')).to include(
+          'name' => ['その名前は既に使はれてゐます．']
+        )
+
+        expect(tag.reload.name).to eq('spec_tag')
+        expect(tag.tag_name.aliases.map(&:name)).to contain_exactly('unko')
+        expect(wiki_page.reload.tag_name).to eq(tag.tag_name)
+      end
+
+      it 'system tag の name は変更できない' do
+        system_tag = Tag.bot
+
+        patch "/tags/#{ system_tag.id }", params: { name: 'patch_system_tag_renamed' }
+
+        expect(response).to have_http_status(:unprocessable_entity)
+        expect(system_tag.reload.name).to eq('bot操作')
+      end
     end
   end
 
@@ -745,7 +797,17 @@ RSpec.describe 'Tags API', type: :request do
       )
       TagImplication.create!(tag: first, parent_tag: root_material)
       TagImplication.create!(tag: second, parent_tag: first)
-      TagImplication.create!(tag: first, parent_tag: second)
+      now = Time.current
+      TagImplication.insert_all!(
+        [
+          {
+            tag_id: first.id,
+            parent_tag_id: second.id,
+            created_at: now,
+            updated_at: now
+          }
+        ]
+      )
 
       get '/tags/with-depth', params: { parent: root_material.id }
 
@@ -1029,6 +1091,42 @@ RSpec.describe 'Tags API', type: :request do
         expect(versions.second.created_by_user_id).to eq(member_user.id)
       end
 
+      it '同じ tag の旧 alias へ戻しても rename できる' do
+        put "/tags/#{ tag.id }", params: {
+          name: 'put_roundtrip_b',
+          category: 'general',
+          aliases: 'unko',
+          parent_tags: '',
+          deprecated: '0',
+        }
+
+        expect(response).to have_http_status(:ok)
+
+        put "/tags/#{ tag.id }", params: {
+          name: 'spec_tag',
+          category: 'general',
+          aliases: 'unko',
+          parent_tags: '',
+          deprecated: '0',
+        }
+
+        expect(response).to have_http_status(:ok)
+
+        tag.reload
+
+        expect(tag.name).to eq('spec_tag')
+        expect(TagName.find_by!(name: 'put_roundtrip_b').canonical).to eq(tag.tag_name)
+        expect(tag.tag_name.aliases.map(&:name)).to contain_exactly('put_roundtrip_b', 'unko')
+        expect(tag.tag_name.aliases.map(&:name)).not_to include('spec_tag')
+        expect(alias_tn.reload.canonical).to eq(tag.tag_name)
+
+        version = tag.tag_versions.order(:version_no).last
+
+        expect(version.event_type).to eq('update')
+        expect(version.name).to eq('spec_tag')
+        expect(version.aliases.split).to contain_exactly('put_roundtrip_b', 'unko')
+      end
+
       it 'parent tag の snapshot も作成する' do
         old_parent = Tag.create!(
           tag_name: TagName.create!(name: 'put_snapshot_old_parent'),
@@ -1153,6 +1251,48 @@ RSpec.describe 'Tags API', type: :request do
         )
       end
 
+      it 'wiki を持つ tag を旧 alias へ戻しても wiki を新 canonical へ移す' do
+        wiki_page =
+            Wiki::Commit.create_content!(
+                tag_name: tag.tag_name,
+                body: 'wiki body before',
+                created_by_user: member_user,
+                message: 'init')
+
+        expect {
+          put "/tags/#{ tag.id }", params: {
+            name: 'put_wiki_roundtrip_b',
+            category: 'general',
+            aliases: 'unko',
+            parent_tags: '',
+            deprecated: '0',
+          }
+
+          put "/tags/#{ tag.id }", params: {
+            name: 'spec_tag',
+            category: 'general',
+            aliases: 'unko',
+            parent_tags: '',
+            deprecated: '0',
+          }
+        }
+            .to change(TagVersion, :count).by(3)
+            .and change(WikiVersion, :count).by(2)
+
+        expect(response).to have_http_status(:ok)
+
+        tag.reload
+
+        expect(wiki_page.reload.tag_name).to eq(tag.tag_name)
+        expect(TagName.find_by!(name: 'put_wiki_roundtrip_b').wiki_page).to be_nil
+        expect(TagName.find_by!(name: 'put_wiki_roundtrip_b').canonical).to eq(tag.tag_name)
+
+        versions = wiki_page.wiki_versions.order(:version_no).last(2)
+
+        expect(versions.map(&:event_type)).to eq(['update', 'update'])
+        expect(versions.map(&:title)).to eq(['put_wiki_roundtrip_b', 'spec_tag'])
+      end
+
       it '別名を他 tag から奪った場合、奪はれた側の tag version も作成する' do
         old_owner = Tag.create!(
           tag_name: TagName.create!(name: 'put_alias_old_owner'),
@@ -1191,9 +1331,49 @@ RSpec.describe 'Tags API', type: :request do
         expect(old_owner_versions.second.aliases.split).not_to include('put_stolen_alias')
       end
 
-      it 'parent_tags に指定すると循環する tag は 422 にする' do
+      it '別 tag の alias 名を rename で奪へる' do
-        pending '#332 で対応予定'
+        old_owner = Tag.create!(
+          tag_name: TagName.create!(name: 'put_alias_collision_owner'),
+          category: :general
+        )
+        stolen_alias = TagName.create!(
+          name: 'put_alias_collision_name',
+          canonical: old_owner.tag_name
+        )
+        wiki_page =
+            Wiki::Commit.create_content!(
+                tag_name: tag.tag_name,
+                body: 'put collision wiki',
+                created_by_user: member_user,
+                message: 'init')
 
+        put "/tags/#{ tag.id }", params: {
+          name: 'put_alias_collision_name',
+          category: 'general',
+          aliases: 'unko',
+          parent_tags: '',
+          deprecated: '0',
+        }
+
+        expect(response).to have_http_status(:ok)
+
+        tag.reload
+        old_owner.reload
+        stolen_alias.reload
+
+        expect(tag.name).to eq('put_alias_collision_name')
+        expect(stolen_alias.canonical_id).to be_nil
+        expect(TagName.find_by!(name: 'spec_tag').canonical).to eq(tag.tag_name)
+        expect(old_owner.tag_name.aliases.map(&:name)).not_to include('put_alias_collision_name')
+
+        old_owner_versions = old_owner.tag_versions.order(:version_no)
+
+        expect(old_owner_versions.last.event_type).to eq('update')
+        expect(old_owner_versions.last.aliases.split).not_to include('put_alias_collision_name')
+        expect(wiki_page.reload.tag_name).to eq(tag.tag_name)
+      end
+
+      it 'parent_tags に指定すると循環する tag は 422 にする' do
         child = Tag.create!(
           tag_name: TagName.create!(name: 'put_cycle_child'),
           category: :general

backend/spec/services/material_file_sha256_spec.rb

@@ -0,0 +1,23 @@
+require 'rails_helper'
+
+RSpec.describe MaterialFileSha256 do
+  describe '.metadata_sha256' do
+    it 'reads sha256 from Hash metadata' do
+      blob = instance_double(ActiveStorage::Blob, metadata: { 'sha256' => 'abc123' })
+
+      expect(described_class.metadata_sha256(blob)).to eq('abc123')
+    end
+
+    it 'reads sha256 from JSON string metadata' do
+      blob = instance_double(ActiveStorage::Blob, metadata: '{"sha256":"abc123"}')
+
+      expect(described_class.metadata_sha256(blob)).to eq('abc123')
+    end
+
+    it 'returns nil for invalid metadata' do
+      blob = instance_double(ActiveStorage::Blob, metadata: '{')
+
+      expect(described_class.metadata_sha256(blob)).to be_nil
+    end
+  end
+end

backend/spec/services/material_sync_importer_spec.rb

@@ -0,0 +1,128 @@
+require 'rails_helper'
+
+RSpec.describe MaterialSyncImporter do
+  let(:user) { create(:user, :member) }
+  let(:tag) { Tag.create!(tag_name: TagName.create!(name: 'sync_tag'), category: :material) }
+
+  def tempfile_for body
+    Tempfile.new(['material-sync-importer', '.png']).tap do |file|
+      file.binmode
+      file.write(body)
+      file.rewind
+    end
+  end
+
+  it 'creates an untagged material from a sync candidate with file_downloader' do
+    result =
+        described_class.import!(
+            source_kind: 'google_drive_file',
+            source_path: '素材/a.png',
+            source_file_id: 'drive-file-a',
+            normalized_source_key: 'google_drive_file:drive-file-a',
+            filename: 'a.png',
+            content_type: 'image/png',
+            file_sha256: Digest::SHA256.hexdigest('sync-body'),
+            file_downloader: -> { tempfile_for('sync-body') },
+            export_path: '素材/a.png',
+            tag: nil,
+            url: nil,
+            created_by_user: user,
+            updated_by_user: user)
+
+    material = result.material.reload
+    expect(result.action).to eq(:imported)
+    expect(material.tag).to be_nil
+    expect(material.url).to be_nil
+    expect(material.file).to be_attached
+    expect(material.file.blob.filename.to_s).to eq('a.png')
+    expect(material.material_export_items.first.export_path).to eq('素材/a.png')
+  end
+
+  it 'does not clear a human-assigned tag or URL on existing Drive sync' do
+    material =
+        Material.create!(tag:, url: 'https://example.com/human',
+                         source_kind: 'google_drive_file',
+                         source_path: '素材/a.png',
+                         source_file_id: 'drive-file-a',
+                         created_by_user: user,
+                         updated_by_user: user)
+    material.file.attach(
+        io: StringIO.new('same-body'),
+        filename: 'a.png',
+        content_type: 'image/png')
+    material.file.blob.metadata['sha256'] = Digest::SHA256.hexdigest('same-body')
+    material.file.blob.save!
+    MaterialExportItem.create!(material:,
+                               profile: 'legacy_drive',
+                               export_path: '素材/a.png',
+                               created_by_user: user)
+
+    result =
+        described_class.import!(
+            source_kind: 'google_drive_file',
+            source_path: '素材/a.png',
+            source_file_id: 'drive-file-a',
+            filename: 'a.png',
+            content_type: 'image/png',
+            file_sha256: Digest::SHA256.hexdigest('same-body'),
+            export_path: '素材/a.png',
+            tag: nil,
+            url: nil,
+            updated_by_user: user)
+
+    expect(result.action).to eq(:unchanged)
+    expect(material.reload.tag).to eq(tag)
+    expect(material.url).to eq('https://example.com/human')
+  end
+
+  it 'suppresses a Google Drive candidate by relative path prefix' do
+    MaterialSyncSuppression.create!(source_kind: 'google_drive_path_prefix',
+                                    drive_path: '素材/危険',
+                                    reason: 'copyright_high_risk',
+                                    created_by_user: user)
+
+    result =
+        described_class.import!(
+            source_kind: 'google_drive_file',
+            source_path: '素材/危険/a.png',
+            source_file_id: 'drive-file-b',
+            filename: 'a.png',
+            content_type: 'image/png',
+            file_sha256: Digest::SHA256.hexdigest('blocked-body'),
+            file_downloader: -> { tempfile_for('blocked-body') },
+            export_path: '素材/危険/a.png',
+            updated_by_user: user)
+
+    expect(result.action).to eq(:suppressed)
+    expect(result.suppression.normalized_source_key)
+      .to eq('google_drive_path_prefix:素材/危険')
+    expect(Material.find_by(source_file_id: 'drive-file-b')).to be_nil
+  end
+
+  it 'rechecks import blocks after downloaded file sha256 is known' do
+    MaterialImportBlock.create!(match_kind: 'sha256',
+                                sha256: Digest::SHA256.hexdigest('blocked-body'),
+                                reason: 'copyright_high_risk',
+                                created_by_user: user)
+    blob_count = ActiveStorage::Blob.count
+
+    expect do
+      result =
+          described_class.import!(
+              source_kind: 'google_drive_file',
+              source_path: '素材/blocked.png',
+              source_file_id: 'drive-file-blocked',
+              filename: 'blocked.png',
+              content_type: 'image/png',
+              file_downloader: -> { tempfile_for('blocked-body') },
+              export_path: '素材/blocked.png',
+              updated_by_user: user)
+
+      expect(result.action).to eq(:suppressed)
+      expect(result.suppression.reason).to eq('copyright_high_risk')
+    end.not_to change(Material, :count)
+
+    expect(ActiveStorage::Blob.count).to eq(blob_count)
+    expect(Material.find_by(source_file_id: 'drive-file-blocked')).to be_nil
+  end
+end

backend/spec/services/material_sync_runner_spec.rb

@@ -0,0 +1,89 @@
+require 'rails_helper'
+
+RSpec.describe MaterialSyncRunner do
+  let(:user) { create(:user, :member) }
+  let(:source) do
+    MaterialSyncSource.create!(
+        name: 'Drive source',
+        source_kind: 'google_drive_path',
+        source_file_id: 'folder-123',
+        profile: 'legacy_drive',
+        created_by_user: user,
+        updated_by_user: user)
+  end
+  let(:drive_client) { instance_double(GoogleDrive::ApiClient) }
+
+  describe '#sync!' do
+    it 'imports google drive path candidates as they are yielded' do
+      first_entry = { id: 'file-1',
+                      name: 'a.png',
+                      mime_type: 'image/png',
+                      relative_path: '素材/a.png',
+                      sha256_checksum: 'sha-a',
+                      web_view_link: 'https://drive.google.com/file/d/file-1/view',
+                      web_content_link: nil }
+      second_entry = { id: 'file-2',
+                       name: 'b.png',
+                       mime_type: 'image/png',
+                       relative_path: '素材/b.png',
+                       sha256_checksum: 'sha-b',
+                       web_view_link: 'https://drive.google.com/file/d/file-2/view',
+                       web_content_link: nil }
+      yielded = []
+
+      allow(GoogleDrive::ApiClient).to receive(:new).and_return(drive_client)
+      allow(drive_client).to receive(:each_material_file_under_folder) do |folder_id, &block|
+        expect(folder_id).to eq('folder-123')
+        block.call(first_entry)
+        expect(yielded).to eq(['素材/a.png'])
+        block.call(second_entry)
+      end
+      allow(MaterialSyncImporter).to receive(:import!) do |candidate|
+        yielded << candidate.fetch(:source_path)
+        instance_double(MaterialSyncImporter::Result,
+                        action: yielded.last == '素材/a.png' ? :imported : :updated)
+      end
+
+      result = described_class.new(source).sync!
+
+      expect(yielded).to eq(['素材/a.png', '素材/b.png'])
+      expect(result.imported).to eq(1)
+      expect(result.updated).to eq(1)
+      expect(result.unchanged).to eq(0)
+      expect(source.reload.last_synced_at).to be_present
+    end
+
+    it 'logs google drive path progress at first item and summary' do
+      entry = { id: 'file-1',
+                name: 'a.png',
+                mime_type: 'image/png',
+                relative_path: '素材/a.png',
+                sha256_checksum: 'sha-a',
+                web_view_link: 'https://drive.google.com/file/d/file-1/view',
+                web_content_link: nil }
+      logged = []
+
+      allow(GoogleDrive::ApiClient).to receive(:new).and_return(drive_client)
+      allow(drive_client).to receive(:each_material_file_under_folder) do |_folder_id, &block|
+        block.call(entry)
+      end
+      allow(MaterialSyncImporter).to receive(:import!)
+        .and_return(instance_double(MaterialSyncImporter::Result, action: :imported))
+      allow(Rails.logger).to receive(:info) { |message| logged << JSON.parse(message) }
+
+      described_class.new(source).sync!
+
+      progress_logs = logged.select { |row| row['folder_id'] == 'folder-123' }
+      expect(progress_logs.map { |row| row['progress'] }).to eq(['scan', 'summary'])
+      expect(progress_logs.last).to include(
+          'material_sync_source_id' => source.id,
+          'material_sync_source_name' => 'Drive source',
+          'scanned_count' => 1,
+          'imported' => 1,
+          'updated' => 0,
+          'unchanged' => 0,
+          'suppressed' => 0,
+          'failed' => 0)
+    end
+  end
+end

docs/commands.md

@@ -10,6 +10,15 @@ bundle exec rspec
 bundle exec rails routes
 ```
 
+Material video thumbnail generation requires `ffmpeg` on the host. If `ffmpeg`
+is missing or frame extraction fails, `MaterialThumbnailGenerator` logs the
+result and stderr, then leaves the existing thumbnail unchanged.
+
+```sh
+cd backend
+bundle exec rails materials:thumbnails:backfill
+```
+
 ## Frontend
 
 ```sh

frontend/src/App.tsx

@@ -14,8 +14,10 @@ import { apiPost, isApiError } from '@/lib/api'
 import DeerjikistDetailPage from '@/pages/deerjikists/DeerjikistDetailPage'
 import MaterialBasePage from '@/pages/materials/MaterialBasePage'
 import MaterialDetailPage from '@/pages/materials/MaterialDetailPage'
+import MaterialHistoryPage from '@/pages/materials/MaterialHistoryPage'
 import MaterialListPage from '@/pages/materials/MaterialListPage'
 import MaterialNewPage from '@/pages/materials/MaterialNewPage'
+import MaterialSyncSuppressionsPage from '@/pages/materials/MaterialSyncSuppressionsPage'
 // import MaterialSearchPage from '@/pages/materials/MaterialSearchPage'
 import MorePage from '@/pages/MorePage'
 import GekanatorPage from '@/pages/GekanatorPage'
@@ -68,10 +70,11 @@ const RouteTransitionWrapper = ({ user, setUser }: {
 	  <Route path="/theatres/:id" element={<TheatreDetailPage user={user}/>}/>
 	  <Route path="/materials" element={<MaterialBasePage/>}>
 	    <Route index element={<MaterialListPage/>}/>
+	    <Route path="changes" element={<MaterialHistoryPage/>}/>
 	    <Route path="new" element={<MaterialNewPage/>}/>
-	    <Route path=":id" element ={<MaterialDetailPage user={user}/>}/>
+	    <Route path="suppressions" element={<MaterialSyncSuppressionsPage/>}/>
+	    <Route path=":id" element ={<MaterialDetailPage/>}/>
 	  </Route>
-	  {/* <Route path="/materials/search" element={<MaterialSearchPage/>}/> */}
 	  <Route path="/wiki" element={<WikiSearchPage/>}/>
 	  <Route path="/wiki/:title" element={<WikiDetailPage/>}/>
 	  <Route path="/wiki/new" element={<WikiNewPage user={user}/>}/>

frontend/src/components/MaterialSidebar.tsx

@@ -1,23 +1,43 @@
-import { Fragment, useEffect, useState } from 'react'
+import { useQuery } from '@tanstack/react-query'
+import { useEffect, useRef, useState } from 'react'
+import { useLocation, useNavigate } from 'react-router-dom'
 
-import TagLink from '@/components/TagLink'
 import SidebarComponent from '@/components/layout/SidebarComponent'
-import { apiGet } from '@/lib/api'
+import TagLink from '@/components/TagLink'
+import { fetchMaterialTagTree, parseMaterialFilter } from '@/lib/materials'
+import { materialsKeys } from '@/lib/queryKeys'
+import { cn } from '@/lib/utils'
 
-import type { FC, ReactNode } from 'react'
+import type { CSSProperties, Dispatch, FC, ReactNode, SetStateAction } from 'react'
 
-import type { Tag } from '@/types'
+import type { MaterialFilter, MaterialSidebarTag, Tag } from '@/types'
 
-type TagWithDepth = Tag & {
+const FILTERS: MaterialFilter[] = ['missing', 'present', 'any']
-    hasChildren:  boolean
+const FILTER_LABELS: Record<MaterialFilter, string> = { present: '有', missing: '無', any: '全' }
-    children:     TagWithDepth[] }
+
+
+const px = (value: string): number => {
+  const parsed = Number.parseFloat (value)
+  return Number.isFinite (parsed) ? parsed : 0
+}
+
+
+const verticalChrome = (el: HTMLElement): number => {
+  const style = window.getComputedStyle (el)
+
+  return (
+      px (style.paddingTop)
+      + px (style.paddingBottom)
+      + px (style.borderTopWidth)
+      + px (style.borderBottomWidth))
+}
 
 
 const setChildrenById = (
-    tags:     TagWithDepth[],
+    tags:     MaterialSidebarTag[],
     targetId: number,
-    children: TagWithDepth[],
+    children: MaterialSidebarTag[],
-): TagWithDepth[] => (
+): MaterialSidebarTag[] => (
     tags.map (tag => {
       if (tag.id === targetId)
 	return { ...tag, children }
@@ -25,75 +45,462 @@ const setChildrenById = (
       if (tag.children.length === 0)
 	return tag
 
-      return { ...tag,
+      return { ...tag, children: setChildrenById (tag.children, targetId, children) }
-	       children: (setChildrenById (tag.children, targetId, children)
-			  .filter (t => t.category !== 'meme' || t.hasChildren)) }
     }))
 
 
-const MaterialSidebar: FC = () => {
+const materialPath = (
-  const [tags, setTags] = useState<TagWithDepth[]> ([])
+    tagId: number,
-  const [openTags, setOpenTags] = useState<Record<number, boolean>> ({ })
+    materialFilter: MaterialFilter,
-  const [tagFetchedFlags, setTagFetchedFlags] = useState<Record<number, boolean>> ({ })
+): string =>
+    `/materials?tag_id=${ tagId }&include_descendants=1&group_by=parent_tag`
+    + `&material_filter=${ materialFilter }`
 
-  useEffect (() => {
-    void (async () => {
-      setTags ((await apiGet<TagWithDepth[]> ('/tags/with-depth'))
-	       .filter (t => t.category !== 'meme' || t.hasChildren))
-    }) ()
-  }, [])
 
-  const renderTags = (ts: TagWithDepth[], nestLevel = 0): ReactNode => (
+const sidebarTagToTag = (tag: MaterialSidebarTag): Tag => ({
-      ts.map (t => (
+    id:             tag.id,
-	  <Fragment key={t.id}>
+    name:           tag.name,
-	    <li>
+    category:       tag.category,
-	      <div className="flex">
+    deprecatedAt:   tag.deprecated ? '' : null,
-		<div className="flex-none w-4">
+    aliases:        [],
-		  {t.hasChildren && (
+    parents:        [],
-		      <a
+    postCount:      0,
-			  href="#"
+    createdAt:      '',
-			  onClick={async e => {
+    updatedAt:      '',
-			    e.preventDefault ()
+    hasWiki:        false,
-			    if (!(tagFetchedFlags[t.id]))
+    materialId:     null,
-			      {
+    hasDeerjikists: false,
-				try
+    matchedAlias:   null })
-				{
-				  const data =
-				      await apiGet<TagWithDepth[]> (
-					  '/tags/with-depth', { params: { parent: String (t.id) } })
-				  setTags (prev => setChildrenById (prev, t.id, data))
-				  setTagFetchedFlags (prev => ({ ...prev, [t.id]: true }))
-				}
-				catch
-				{
-				  ;
-				}
-			      }
-			    setOpenTags (prev => ({ ...prev, [t.id]: !(prev[t.id]) }))
-			  }}>
-			{openTags[t.id] ? <>&minus;</> : '+'}
-		      </a>)}
-		</div>
-		<div className="flex-1 truncate">
-		  <TagLink
-		      tag={t}
-		      nestLevel={nestLevel}
-		      title={t.name}
-		      withCount={false}
-		      withWiki={false}
-		      to={`/materials?tag=${ encodeURIComponent (t.name) }`}/>
-		</div>
-	      </div>
-	    </li>
-	    {openTags[t.id] && renderTags (t.children, nestLevel + 1)}
-	  </Fragment>)))
 
-  return (
+
-      <SidebarComponent>
+const tagSelectionShellClass = (selected: boolean): string =>
-	<ul>
+    cn (selected
-	  {renderTags (tags)}
+	? ['rounded-md border border-sky-500 bg-sky-50 px-2 py-1 text-sky-700',
-	</ul>
+	   'dark:border-sky-400 dark:bg-sky-950 dark:text-sky-100']
-      </SidebarComponent>)
+	: 'px-2 py-1')
+
+
+const updateMaterialFilterQuery = (
+    pathname: string,
+    locationSearch: string,
+    navigate: ReturnType<typeof useNavigate>,
+    materialFilter: MaterialFilter,
+) => {
+  const qs = new URLSearchParams (locationSearch)
+  qs.set ('material_filter', materialFilter)
+  navigate (`${ pathname }${ qs.toString () ? `?${ qs.toString () }` : '' }`)
 }
 
-export default MaterialSidebar
+
+const MaterialFilterButtons: FC<{ materialFilter: MaterialFilter
+				  onChange:       (materialFilter: MaterialFilter) => void }> = (
+    { materialFilter, onChange },
+) => (
+    <div className="flex flex-wrap gap-2 justify-end md:justify-start flex-center">
+      <label className="my-auto text-sm font-bold">素材：</label>
+      {FILTERS.map (value => (
+	  <button
+	      key={value}
+	      type="button"
+	      onClick={() => onChange (value)}
+	      className={cn (
+		  'rounded-full border px-3 py-1 text-sm',
+		  (materialFilter === value
+		   ? ['border-sky-500 bg-sky-50 text-sky-700 dark:border-sky-400',
+		      'dark:bg-sky-950 dark:text-sky-100']
+		   : ['border-neutral-300 bg-white text-neutral-700 dark:border-stone-700',
+		      'dark:bg-stone-900 dark:text-stone-200']))}>
+	    {FILTER_LABELS[value]}
+	  </button>))}
+    </div>)
+
+
+const MaterialTreeNode: FC<{
+    materialFilter: MaterialFilter
+    selectedTagId:  number | null
+    nestLevel?:     number
+    onChildren:     (tagId: number, children: MaterialSidebarTag[]) => void
+    openTags:       Record<number, boolean>
+    setOpenTags:    Dispatch<SetStateAction<Record<number, boolean>>>
+    tag:            MaterialSidebarTag
+}> = ({ materialFilter, nestLevel = 0, onChildren, openTags, selectedTagId,
+	 setOpenTags, tag }) => {
+  const open = Boolean (openTags[tag.id])
+  const { data } = useQuery ({
+      queryKey: materialsKeys.tree ({ parentId: tag.id, materialFilter }),
+      queryFn:	() => fetchMaterialTagTree ({ parentId: tag.id, materialFilter }),
+      enabled:	open && tag.hasChildren && tag.children.length === 0})
+
+  useEffect (() => {
+    if (open && data && tag.children.length === 0)
+      onChildren (tag.id, data)
+  }, [data, onChildren, open, tag.children.length, tag.id])
+
+  return (
+      <>
+	<li>
+	  <div className="flex flex-center">
+	    <div className="flex-none w-4 my-auto">
+	      {tag.hasChildren && (
+		  <button
+		      type="button"
+		      onClick={() => setOpenTags (prev => ({ ...prev, [tag.id]: !prev[tag.id] }))}
+		      className="text-neutral-500 dark:text-stone-400">
+		    {open ? <>&minus;</> : '+'}
+		  </button>)}
+	    </div>
+	    <div className="min-w-0 flex-1 my-auto">
+	      <div className={cn (tagSelectionShellClass (selectedTagId === tag.id),
+				  'min-w-0 truncate')}>
+		<TagLink
+		    tag={sidebarTagToTag (tag)}
+		    nestLevel={nestLevel}
+		    title={tag.name}
+		    withCount={false}
+		    withWiki={false}
+		    to={materialPath (tag.id, materialFilter)}/>
+	      </div>
+	    </div>
+	  </div>
+	</li>
+	{open && tag.children.length > 0 && (
+	    <ul>
+	      {tag.children.map (child => (
+		  <MaterialTreeNode
+		      key={child.id}
+		      tag={child}
+		      nestLevel={nestLevel + 1}
+		      materialFilter={materialFilter}
+		      selectedTagId={selectedTagId}
+		      openTags={openTags}
+		      setOpenTags={setOpenTags}
+		      onChildren={onChildren}/>))}
+	    </ul>)}
+      </>)
+}
+
+
+const MobileMaterialTreeNode: FC<{ depth?: number
+				   availableInlineSizePx?: number | null
+				   materialFilter: MaterialFilter
+				   selectedTagId: number | null
+				   onChildren: (tagId: number, children: MaterialSidebarTag[]) =>
+						   void
+				   openTags: Record<number, boolean>
+				   setOpenTags: Dispatch<SetStateAction<Record<number, boolean>>>
+				   tag: MaterialSidebarTag }> = (
+    {
+      depth = 0,
+      availableInlineSizePx = null,
+      materialFilter,
+      onChildren,
+      openTags,
+      selectedTagId,
+      setOpenTags,
+      tag,
+    },
+) => {
+  const open = Boolean (openTags[tag.id])
+  const tagColumnRef = useRef<HTMLDivElement | null> (null)
+  const chipRef = useRef<HTMLDivElement | null> (null)
+  const buttonRef = useRef<HTMLButtonElement | null> (null)
+  const expansionSlotRef = useRef<HTMLDivElement | null> (null)
+  const expansionBorderRef = useRef<HTMLDivElement | null> (null)
+  const [tagChipInlineSizePx, setTagChipInlineSizePx] = useState<number | null> (null)
+  const [tagLinkInlineSizePx, setTagLinkInlineSizePx] = useState<number | null> (null)
+  const [childAvailableInlineSizePx, setChildAvailableInlineSizePx] = useState<number | null> (null)
+  const { data } = useQuery ({
+      queryKey: materialsKeys.tree ({ parentId: tag.id, materialFilter }),
+      queryFn:  () => fetchMaterialTagTree ({ parentId: tag.id, materialFilter }),
+      enabled:  open && tag.hasChildren && tag.children.length === 0})
+
+  useEffect (() => {
+    if (open && data && tag.children.length === 0)
+      onChildren (tag.id, data)
+  }, [data, onChildren, open, tag.children.length, tag.id])
+
+  useEffect (() => {
+    const tagColumn = tagColumnRef.current
+    const chip = chipRef.current
+    if (!(tagColumn) || !(chip))
+      return
+
+    const updateTagInlineSize = () => {
+      const buttonHeight = buttonRef.current?.offsetHeight ?? 0
+      const gap = tag.hasChildren ? px (window.getComputedStyle (tagColumn).rowGap) : 0
+      const columnHeight =
+	  availableInlineSizePx == null
+	  ? tagColumn.clientHeight
+	  : Math.min (tagColumn.clientHeight, availableInlineSizePx)
+      const nextChipInlineSize = Math.max (24, columnHeight - buttonHeight - gap)
+      const nextLinkInlineSize = Math.max (
+	  16,
+	  nextChipInlineSize - verticalChrome (chip),
+      )
+
+      setTagChipInlineSizePx (prev => prev === nextChipInlineSize ? prev : nextChipInlineSize)
+      setTagLinkInlineSizePx (prev => prev === nextLinkInlineSize ? prev : nextLinkInlineSize)
+    }
+
+    updateTagInlineSize ()
+
+    const resizeObserver = new ResizeObserver (() => {
+      updateTagInlineSize ()
+    })
+
+    resizeObserver.observe (tagColumn)
+    resizeObserver.observe (chip)
+
+    if (buttonRef.current)
+      resizeObserver.observe (buttonRef.current)
+
+    return () => {
+      resizeObserver.disconnect ()
+    }
+  }, [availableInlineSizePx, open, tag.hasChildren, tag.children.length])
+
+  useEffect (() => {
+    const expansionSlot = expansionSlotRef.current
+    const expansionBorder = expansionBorderRef.current
+    if (!(expansionSlot) || !(expansionBorder))
+      return
+
+    const updateChildInlineSize = () => {
+      const base =
+	  availableInlineSizePx == null
+	  ? expansionSlot.clientHeight
+	  : availableInlineSizePx
+      const chrome = verticalChrome (expansionSlot) + verticalChrome (expansionBorder)
+      const nextInlineSize = Math.max (24, base - chrome)
+      setChildAvailableInlineSizePx (prev => prev === nextInlineSize ? prev : nextInlineSize)
+    }
+
+    updateChildInlineSize ()
+
+    const resizeObserver = new ResizeObserver (() => {
+      updateChildInlineSize ()
+    })
+
+    resizeObserver.observe (expansionSlot)
+    resizeObserver.observe (expansionBorder)
+
+    return () => {
+      resizeObserver.disconnect ()
+    }
+  }, [availableInlineSizePx, open, tag.children.length])
+
+  return (
+      <div className="flex h-full min-h-0 max-h-full flex-row-reverse items-start gap-2
+		      overflow-hidden">
+	<div
+	    ref={tagColumnRef}
+	    className="flex h-full min-h-0 max-h-full flex-col items-center gap-1
+		       overflow-hidden">
+	  <div
+	      ref={chipRef}
+	      className={cn (
+		  tagSelectionShellClass (selectedTagId === tag.id),
+		  'box-border rounded-xl border px-3 py-2 text-sm shadow-sm',
+		  'min-h-0 overflow-hidden [max-inline-size:var(--tag-chip-inline-size)]',
+		  '[max-height:var(--tag-chip-inline-size)]',
+	      )}
+	      style={{
+		writingMode: 'vertical-rl',
+		'--tag-chip-inline-size': (
+		    tagChipInlineSizePx == null
+		    ? undefined
+		    : `${ tagChipInlineSizePx }px`),
+		'--tag-link-inline-size': (
+		    tagLinkInlineSizePx == null
+		    ? undefined
+		    : `${ tagLinkInlineSizePx }px`),
+	      } as CSSProperties}>
+	    <TagLink
+		tag={sidebarTagToTag (tag)}
+		title={tag.name}
+		withCount={false}
+		withWiki={false}
+		to={materialPath (tag.id, materialFilter)}
+		className="block overflow-hidden text-ellipsis whitespace-nowrap
+			   [max-inline-size:var(--tag-link-inline-size)]
+			   [max-height:var(--tag-link-inline-size)]"/>
+	  </div>
+	  {tag.hasChildren && (
+	      <button
+		  ref={buttonRef}
+		  type="button"
+		  onClick={() => setOpenTags (prev => ({ ...prev, [tag.id]: !prev[tag.id] }))}
+		  className="flex-none rounded-full border border-stone-300 bg-white
+			     px-2 py-0.5 text-sm text-stone-700 dark:border-stone-700
+			     dark:bg-stone-900 dark:text-stone-100">
+		{open ? <>&minus;</> : '+'}
+	      </button>)}
+	</div>
+	{open && tag.children.length > 0 && (
+	    <div
+		ref={expansionSlotRef}
+		className={cn (
+		    'h-full min-h-0 max-h-full overflow-hidden box-border',
+		    depth === 0 ? 'pt-5' : 'pt-3')}>
+	      <div
+		  ref={expansionBorderRef}
+		  className="relative max-h-full overflow-hidden rounded-2xl border border-stone-200
+			     bg-stone-100/70 py-2 pl-2 pr-2 text-stone-900
+			     dark:border-stone-700 dark:bg-stone-900/70 dark:text-stone-100">
+		<div className="flex h-full min-h-0 max-h-full flex-row-reverse items-start gap-2
+				overflow-hidden">
+		  <span
+		      aria-hidden="true"
+		      className="absolute -right-3 top-4 h-px w-3 bg-stone-300 dark:bg-stone-600"/>
+		  {tag.children.map (child => (
+		      <div
+			  key={child.id}
+			  className="relative h-full min-h-0 max-h-full overflow-hidden">
+			<MobileMaterialTreeNode
+			    tag={child}
+			    depth={depth + 1}
+			    availableInlineSizePx={childAvailableInlineSizePx}
+			    materialFilter={materialFilter}
+			    selectedTagId={selectedTagId}
+			    openTags={openTags}
+			    setOpenTags={setOpenTags}
+			    onChildren={onChildren}/>
+		      </div>))}
+		</div>
+	      </div>
+	    </div>)}
+      </div>)
+}
+
+
+const MaterialSidebar: FC = () => {
+  const location = useLocation ()
+  const navigate = useNavigate ()
+  const qs = new URLSearchParams (location.search)
+  const materialFilter = parseMaterialFilter (qs.get ('material_filter'), 'any')
+  const selectedTagId = Number (qs.get ('tag_id') ?? 0) || null
+
+  const [desktopTags, setDesktopTags] = useState<MaterialSidebarTag[]> ([])
+  const [openTags, setOpenTags] = useState<Record<number, boolean>> ({ })
+  const mobileRailRef = useRef<HTMLDivElement | null> (null)
+  const [mobileAvailableInlineSizePx, setMobileAvailableInlineSizePx] =
+      useState<number | null> (null)
+
+  const { data: rootTags = [], isLoading, isError } = useQuery ({
+      queryKey: materialsKeys.tree ({ parentId: null, materialFilter }),
+      queryFn:  () => fetchMaterialTagTree ({ parentId: null, materialFilter })})
+
+  useEffect (() => {
+    setDesktopTags (rootTags)
+  }, [rootTags])
+
+  useEffect (() => {
+    const el = mobileRailRef.current
+    if (!(el))
+      return
+
+    requestAnimationFrame (() => {
+      el.scrollLeft = el.scrollWidth
+    })
+  }, [rootTags, materialFilter])
+
+  useEffect (() => {
+    const el = mobileRailRef.current
+    if (!(el))
+      return
+
+    const updateAvailableInlineSize = () => {
+      const nextInlineSize = Math.max (24, el.clientHeight)
+      setMobileAvailableInlineSizePx (prev => prev === nextInlineSize ? prev : nextInlineSize)
+    }
+
+    updateAvailableInlineSize ()
+
+    const resizeObserver = new ResizeObserver (() => {
+      updateAvailableInlineSize ()
+    })
+
+    resizeObserver.observe (el)
+
+    return () => {
+      resizeObserver.disconnect ()
+    }
+  }, [rootTags, materialFilter])
+
+  const visibleRootTags = desktopTags.length > 0 ? desktopTags : rootTags
+
+  const setChildren = (tagId: number, children: MaterialSidebarTag[]) => {
+    setDesktopTags (prev => {
+      const base = prev.length > 0 ? prev : rootTags
+      return setChildrenById (base, tagId, children)
+    })
+  }
+
+  const handleFilterChange = (value: MaterialFilter) => {
+    setDesktopTags ([])
+    setOpenTags ({ })
+    updateMaterialFilterQuery (location.pathname, location.search, navigate, value)
+  }
+
+  const renderDesktopTree = (tags: MaterialSidebarTag[]): ReactNode => (
+      tags.map (tag => (
+	  <MaterialTreeNode
+	      key={tag.id}
+	      tag={tag}
+	      materialFilter={materialFilter}
+	      selectedTagId={selectedTagId}
+	      openTags={openTags}
+	      setOpenTags={setOpenTags}
+	      onChildren={setChildren}/>)))
+
+  return (
+      <>
+	<div className="border-b bg-stone-50 p-3 dark:border-stone-700 dark:bg-stone-950
+			dark:text-stone-100 md:hidden flex h-[25dvh] min-h-0 flex-col
+			overflow-hidden">
+	  <MaterialFilterButtons
+	      materialFilter={materialFilter}
+	      onChange={handleFilterChange}/>
+	  <div
+	      ref={mobileRailRef}
+	      className="mt-3 min-h-0 flex-1 overflow-x-auto overflow-y-hidden">
+	    <div className="flex min-w-max flex-row-reverse items-start gap-3 pb-1 h-full
+			    min-h-0 max-h-full">
+	      {visibleRootTags.map (tag => (
+		  <MobileMaterialTreeNode
+		      key={tag.id}
+		      tag={tag}
+		      availableInlineSizePx={mobileAvailableInlineSizePx}
+		      materialFilter={materialFilter}
+		      selectedTagId={selectedTagId}
+		      openTags={openTags}
+		      setOpenTags={setOpenTags}
+		      onChildren={setChildren}/>))}
+	    </div>
+	  </div>
+	</div>
+
+	<div className="hidden md:block">
+	  <SidebarComponent>
+	    <div className="space-y-4">
+	      <MaterialFilterButtons
+		  materialFilter={materialFilter}
+		  onChange={handleFilterChange}/>
+	      {isLoading && (
+		  <p className="text-sm text-neutral-500 dark:text-stone-400">読込中……</p>)}
+	      {isError && (
+		  <p className="text-sm text-red-600 dark:text-red-300">
+		    タグ一覧の取得に失敗しました．
+		  </p>)}
+	      {(!isLoading && !isError) && (
+		  <ul>
+		    {renderDesktopTree (visibleRootTags)}
+		  </ul>)}
+	    </div>
+	  </SidebarComponent>
+	</div>
+      </>)
+}
+
+
+export default MaterialSidebar

frontend/src/components/NicoViewer.tsx

@@ -107,8 +107,7 @@ export default forwardRef ((props: Props, ref: ForwardedRef<NiconicoViewerHandle
     loadCompleteTimerRef.current = setTimeout (() => {
       onError?.({
 	  eventName: 'loadCompleteTimeout',
-	  reason:    'niconico video length was not reported by embed',
+	  reason:    'niconico video length was not reported by embed'})
-      })
     }, LOAD_COMPLETE_TIMEOUT_MS)
   }, [clearLoadCompleteTimer, onError])
 

frontend/src/components/PostOriginalCreatedTimeField.tsx

@@ -19,8 +19,7 @@ const PostOriginalCreatedTimeField: FC<Props> = (
       setOriginalCreatedFrom,
       originalCreatedBefore,
       setOriginalCreatedBefore,
-      errors }: Props,
+      errors }: Props) => (
-) => (
     <FormField label="オリジナルの作成日時" messages={errors}>
       {({ describedBy, invalid }) => (
 	  <>

frontend/src/components/TagDetailSidebar.tsx

@@ -37,8 +37,7 @@ const renderTagTree = (
     path:             string,
     suppressClickRef: MutableRefObject<boolean>,
     parentTagId?:     number,
-    sp?:              boolean,
+    sp?:              boolean): ReactNode[] => {
-): ReactNode[] => {
   const key = `${ path }-${ tag.id }`
 
   const self = (
@@ -64,8 +63,7 @@ const renderTagTree = (
 
 const isDescendant = (
     root:     Tag,
-    targetId: number,
+    targetId: number): boolean => {
-): boolean => {
   if (!(root.children))
     return false
 
@@ -83,8 +81,7 @@ const isDescendant = (
 
 const findTag = (
     byCat:  TagByCategory,
-    id:     number,
+    id:     number): Tag | undefined => {
-): Tag | undefined => {
   const walk = (nodes: Tag[]): Tag | undefined => {
     for (const t of nodes)
       {
@@ -130,8 +127,7 @@ const buildTagByCategory = (post: Post): TagByCategory => {
 
 const changeCategory = async (
     tagId:    number,
-    category: Category,
+    category: Category): Promise<void> => {
-): Promise<void> => {
   await apiPatch (`/tags/${ tagId }`, { category })
 }
 
@@ -294,8 +290,7 @@ const TagDetailSidebar: FC<Props> = ({ post, sp }) => {
 	      addEventListener ('click', e => {
 		e.preventDefault ()
 		e.stopPropagation ()
-		suppressClickRef.current = false
+		suppressClickRef.current = false}, { capture: true, once: true })
-	      }, { capture: true, once: true })
 	    }}
 	    onDragCancel={() => {
 	      setActiveTagId (null)

frontend/src/components/TagLink.tsx

@@ -28,11 +28,12 @@ type Props =
 
 
 const TagLink: FC<Props> = ({ tag,
-		   nestLevel = 0,
+			      nestLevel = 0,
-		   linkFlg   = true,
+			      linkFlg   = true,
-		   withWiki  = true,
+			      withWiki  = true,
-		   withCount = true,
+			      withCount = true,
-		   ...props }) => {
+			      className,
+			      ...props }) => {
   const spanClass = cn (
       `text-${ TAG_COLOUR[tag.category] }-${ LIGHT_COLOUR_SHADE }`,
       `dark:text-${ TAG_COLOUR[tag.category] }-${ DARK_COLOUR_SHADE }`)
@@ -105,7 +106,7 @@ const TagLink: FC<Props> = ({ tag,
 	    </span>)}
 	{tag.matchedAlias != null && (
 	    <>
-	      <span className={spanClass} {...props}>
+	      <span className={cn (spanClass, className)} {...props}>
 		{tag.matchedAlias}
 	      </span>
 	      <> → </>
@@ -114,12 +115,12 @@ const TagLink: FC<Props> = ({ tag,
 	 ? (
 	    <PrefetchLink
 		to={`/posts?${ (new URLSearchParams ({ tags: tag.name })).toString () }`}
-		className={linkClass}
+		className={cn (linkClass, className)}
 		{...props}>
 	      {tag.name}
 	    </PrefetchLink>)
 	 : (
-	    <span className={spanClass}
+	    <span className={cn (spanClass, className)}
 		  {...props}>
 	      {tag.name}
 	    </span>)}

frontend/src/components/TopNav.tsx

@@ -7,30 +7,36 @@ import Separator from '@/components/MenuSeparator'
 import PrefetchLink from '@/components/PrefetchLink'
 import TopNavUser from '@/components/TopNavUser'
 import { WikiIdBus } from '@/lib/eventBus/WikiIdBus'
-import { tagsKeys, wikiKeys } from '@/lib/queryKeys'
+import { materialsKeys, tagsKeys, wikiKeys } from '@/lib/queryKeys'
 import { fetchTag, fetchTagByName } from '@/lib/tags'
+import { fetchMaterial } from '@/lib/materials'
 import { cn } from '@/lib/utils'
 import { fetchWikiPage } from '@/lib/wiki'
 
 import type { FC, MouseEvent } from 'react'
 
-import type { Menu, MenuVisibleItem, Tag, User } from '@/types'
+import type { Material, Menu, MenuVisibleItem, Tag, User } from '@/types'
 
 type Props = { user: User | null }
 
 
-export const menuOutline = ({ tag, wikiId, user, pathName }: { 
+export const menuOutline = (
-    tag?: Tag | null
+    { tag, material, wikiId, user, pathName }: {
-    wikiId: number | null
+	tag?: Tag | null
-    user: User | null,
+	material?: Material | null
-    pathName: string }): Menu => {
+	wikiId: number | null
-  const postCount = tag?.postCount ?? 0
+	user: User | null,
+	pathName: string },
+): Menu => {
+  const postCount = tag?.postCount ?? material?.tag?.postCount ?? 0
 
   const wikiPageFlg = Boolean (/^\/wiki\/(?!new|changes)[^/]+/.test (pathName) && wikiId)
   const wikiTitle = pathName.split ('/')[2] ?? ''
 
   const tagFlg = /^\/tags\/\d+/.test (pathName)
 
+  const materialFlg = /^\/materials\/\d+/.test (pathName)
+
   return [
       { name: '広場', to: '/posts', subMenu: [
 	  { name: '一覧', to: '/posts' },
@@ -49,12 +55,18 @@ export const menuOutline = ({ tag, wikiId, user, pathName }: {
 	    visible: tagFlg },
 	  { name: '履歴', to: `/tags/changes?id=${ tag?.id }`,
 	    visible: tagFlg && tag?.category !== 'nico' }] },
-      { name: '素材', to: '/materials', visible: false, subMenu: [
+      { name: '素材', to: '/materials', visible: true, subMenu: [
 	  { name: '一覧', to: '/materials' },
-	  { name: '検索', to: '/materials/search', visible: false }, 
 	  { name: '追加', to: '/materials/new' },
-	  { name: '全体履歴', to: '/materials/changes', visible: false },
+	  { name: '抑止', to: '/materials/suppressions' },
-	  { name: 'ヘルプ', to: '/wiki/ヘルプ:素材集' }] },
+	  { name: '全体履歴', to: '/materials/changes' },
+	  { name: 'ヘルプ', to: '/wiki/ヘルプ:素材管理' },
+	  { component: <Separator/>, visible: materialFlg },
+	  { name: `広場 (${ postCount || 0 })`,
+	    to: `/posts?tags=${ encodeURIComponent (material?.tag?.name ?? '') }`,
+	    visible: materialFlg && Boolean (material?.tag) },
+	  { name: '履歴', to: `/materials/changes?material_id=${ material?.id }`,
+	    visible: materialFlg }] },
       { name: 'Wiki', to: '/wiki/ヘルプ:ホーム', base: '/wiki', subMenu: [
 	  { name: '検索', to: '/wiki' },
 	  { name: '新規', to: '/wiki/new' },
@@ -119,15 +131,23 @@ const TopNav: FC<Props> = ({ user }) => {
       queryFn: () => fetchWikiPage (wikiIdStr, { }) })
 
   const tagFlg = /^\/tags\/\d+/.test (location.pathname)
-  const effectiveTitle = (tagFlg ? location.pathname.split ('/')[2] : wikiPage?.title) ?? ''
+  const materialFlg = /^\/materials\/\d+/.test (location.pathname)
+  const effectiveTitle = (((tagFlg || materialFlg)
+			   ? location.pathname.split ('/')[2]
+			   : wikiPage?.title)
+			  ?? '')
 
   const { data: tag } = useQuery ({
       enabled: Boolean (effectiveTitle),
       queryKey: tagsKeys.show (effectiveTitle),
       queryFn: () => (tagFlg ? fetchTag : fetchTagByName) (effectiveTitle) })
 
+  const { data: material } = useQuery ({
+      enabled: Boolean (effectiveTitle),
+      queryKey: materialsKeys.show (effectiveTitle),
+      queryFn: () => fetchMaterial (effectiveTitle) })
 
-  const menu = menuOutline ({ tag, wikiId, user, pathName: location.pathname })
+  const menu = menuOutline ({ tag, material, wikiId, user, pathName: location.pathname })
   const visibleMenu = menu.filter ((item): item is MenuVisibleItem => item.visible ?? true)
   const moreMenu = menu.filter (item =>
       !(item.visible ?? true)

frontend/src/components/common/PageTitle.tsx

@@ -1,12 +1,14 @@
 import React from 'react'
 
+import { cn } from '@/lib/utils'
+
 import type { FC } from 'react'
 
-type Props = { children: React.ReactNode }
+type Props = { children: React.ReactNode; className?: string }
 
 
-const PageTitle: FC<Props> = ({ children }) => (
+const PageTitle: FC<Props> = ({ children, className, ...rest }) => (
-    <h1 className="text-2xl font-bold mb-2">
+    <h1 className={cn ('text-2xl font-bold mb-2', className)} {...rest}>
       {children}
     </h1>)
 

frontend/src/components/common/Pagination.tsx

@@ -16,8 +16,7 @@ const range = (start: number, end: number): number[] =>
 const getPages = (
     page:         number,
     total:        number,
-    siblingCount: number,
+    siblingCount: number): (number | '…')[] => {
-): (number | '…')[] => {
   if (total <= 1)
     return [1]
 

frontend/src/components/dialogues/DialogueProvider.tsx

@@ -103,8 +103,7 @@ const DialogueProvider: FC<Props> = ({ children }) => {
       choice: options => new Promise (resolve => {
 	push ({ kind: 'choice',
 		options: options as ChoiceOptions<string>,
-		resolve: resolve as (value: string | null) => void })
+		resolve: resolve as (value: string | null) => void })}) }), [push])
-      }) }), [push])
 
   const active = queue[0]
 

frontend/src/components/ui/button.tsx

@@ -10,41 +10,35 @@ const buttonVariants = cva (
     'rounded-md text-sm font-medium transition-colors',
     'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-slate-400',
     'disabled:pointer-events-none disabled:opacity-50',
-    '[&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0',
+    '[&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0'].join (' '),
-  ].join (' '),
   {
     variants: {
       variant: {
-        default:
+	default:
-          'bg-slate-900 text-white hover:bg-slate-700 dark:bg-slate-100 dark:text-slate-900 dark:hover:bg-slate-300',
+	  'bg-slate-900 text-white hover:bg-slate-700 dark:bg-slate-100 dark:text-slate-900 dark:hover:bg-slate-300',
 
-        destructive:
+	destructive:
-          'bg-red-600 text-white hover:bg-red-700 dark:bg-red-700 dark:hover:bg-red-600',
+	  'bg-red-600 text-white hover:bg-red-700 dark:bg-red-700 dark:hover:bg-red-600',
 
-        outline:
+	outline:
-          'border border-slate-300 bg-white text-slate-900 hover:bg-slate-100 dark:border-slate-700 dark:bg-slate-900 dark:text-slate-100 dark:hover:bg-slate-800',
+	  'border border-slate-300 bg-white text-slate-900 hover:bg-slate-100 dark:border-slate-700 dark:bg-slate-900 dark:text-slate-100 dark:hover:bg-slate-800',
 
-        secondary:
+	secondary:
-          'bg-slate-100 text-slate-900 hover:bg-slate-200 dark:bg-slate-800 dark:text-slate-100 dark:hover:bg-slate-700',
+	  'bg-slate-100 text-slate-900 hover:bg-slate-200 dark:bg-slate-800 dark:text-slate-100 dark:hover:bg-slate-700',
 
-        ghost:
+	ghost:
-          'text-slate-900 hover:bg-slate-100 dark:text-slate-100 dark:hover:bg-slate-800',
+	  'text-slate-900 hover:bg-slate-100 dark:text-slate-100 dark:hover:bg-slate-800',
 
-        link:
+	link:
-          'text-blue-700 underline-offset-4 hover:underline dark:text-blue-300',
+	  'text-blue-700 underline-offset-4 hover:underline dark:text-blue-300'},
-      },
       size: {
-        default: 'h-10 px-4 py-2',
+	default: 'h-10 px-4 py-2',
-        sm:      'h-9 rounded-md px-3',
+	sm:      'h-9 rounded-md px-3',
-        lg:      'h-11 rounded-md px-8',
+	lg:      'h-11 rounded-md px-8',
-        icon:    'h-10 w-10',
+	icon:    'h-10 w-10'}},
-      },
-    },
     defaultVariants: {
       variant: 'default',
-      size:    'default',
+      size:    'default'}})
-    },
-  })
 
 export interface ButtonProps
   extends React.ButtonHTMLAttributes<HTMLButtonElement>,
@@ -57,13 +51,11 @@ const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
     const Comp = asChild ? Slot : "button"
     return (
       <Comp
-        className={cn(buttonVariants({ variant, size, className }))}
+	className={cn(buttonVariants({ variant, size, className }))}
-        ref={ref}
+	ref={ref}
-        {...props}
+	{...props}
-      />
+      />)
-    )
+  })
-  }
-)
 Button.displayName = "Button"
 
 export { Button, buttonVariants }

frontend/src/components/ui/dialog.tsx

@@ -22,11 +22,9 @@ const DialogOverlay = React.forwardRef<
     ref={ref}
     className={cn(
       "fixed inset-0 z-50 bg-black/80 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0",
-      className
+      className)}
-    )}
     {...props}
-  />
+  />))
-))
 DialogOverlay.displayName = DialogPrimitive.Overlay.displayName
 
 const DialogContent = React.forwardRef<
@@ -62,8 +60,7 @@ const DialogContent = React.forwardRef<
 	<span className="sr-only">閉ぢる</span>
       </DialogPrimitive.Close>
     </DialogPrimitive.Content>
-  </DialogPortal>
+  </DialogPortal>))
-))
 DialogContent.displayName = DialogPrimitive.Content.displayName
 
 const DialogHeader = ({
@@ -73,11 +70,9 @@ const DialogHeader = ({
   <div
     className={cn(
       "flex flex-col space-y-1.5 text-center sm:text-left",
-      className
+      className)}
-    )}
     {...props}
-  />
+  />)
-)
 DialogHeader.displayName = "DialogHeader"
 
 const DialogFooter = ({
@@ -87,11 +82,9 @@ const DialogFooter = ({
   <div
     className={cn(
       "flex flex-col-reverse sm:flex-row sm:justify-end sm:space-x-2",
-      className
+      className)}
-    )}
     {...props}
-  />
+  />)
-)
 DialogFooter.displayName = "DialogFooter"
 
 const DialogTitle = React.forwardRef<
@@ -102,11 +95,9 @@ const DialogTitle = React.forwardRef<
     ref={ref}
     className={cn(
       "text-lg font-semibold leading-none tracking-tight",
-      className
+      className)}
-    )}
     {...props}
-  />
+  />))
-))
 DialogTitle.displayName = DialogPrimitive.Title.displayName
 
 const DialogDescription = React.forwardRef<
@@ -117,8 +108,7 @@ const DialogDescription = React.forwardRef<
     ref={ref}
     className={cn("text-sm text-muted-foreground", className)}
     {...props}
-  />
+  />))
-))
 DialogDescription.displayName = DialogPrimitive.Description.displayName
 
 export {

frontend/src/components/ui/input.tsx

@@ -1,22 +1,19 @@
-import * as React from "react"
+import * as React from 'react'
 
-import { cn } from "@/lib/utils"
+import { cn } from '@/lib/utils'
 
-const Input = React.forwardRef<HTMLInputElement, React.ComponentProps<"input">>(
+const Input = React.forwardRef<HTMLInputElement, React.ComponentProps<'input'>>(
   ({ className, type, ...props }, ref) => {
     return (
       <input
-        type={type}
+	type={type}
-        className={cn(
+	className={cn(
-          "flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-base ring-offset-background file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+	  'flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-base ring-offset-background file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 md:text-sm',
-          className
+	  className)}
-        )}
+	ref={ref}
-        ref={ref}
+	{...props}
-        {...props}
+      />)
-      />
+  })
-    )
+Input.displayName = 'Input'
-  }
-)
-Input.displayName = "Input"
 
 export { Input }

frontend/src/components/ui/switch.tsx

@@ -1,9 +1,9 @@
-"use client"
+'use client'
 
-import * as React from "react"
+import * as React from 'react'
-import * as SwitchPrimitives from "@radix-ui/react-switch"
+import * as SwitchPrimitives from '@radix-ui/react-switch'
 
-import { cn } from "@/lib/utils"
+import { cn } from '@/lib/utils'
 
 const Switch = React.forwardRef<
   React.ElementRef<typeof SwitchPrimitives.Root>,
@@ -11,19 +11,16 @@ const Switch = React.forwardRef<
 >(({ className, ...props }, ref) => (
   <SwitchPrimitives.Root
     className={cn(
-      "peer inline-flex h-6 w-11 shrink-0 cursor-pointer items-center rounded-full border-2 border-transparent transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:cursor-not-allowed disabled:opacity-50 data-[state=checked]:bg-primary data-[state=unchecked]:bg-input",
+      'peer inline-flex h-6 w-11 shrink-0 cursor-pointer items-center rounded-full border-2 border-transparent transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:cursor-not-allowed disabled:opacity-50 data-[state=checked]:bg-primary data-[state=unchecked]:bg-input',
-      className
+      className)}
-    )}
     {...props}
     ref={ref}
   >
     <SwitchPrimitives.Thumb
       className={cn(
-        "pointer-events-none block h-5 w-5 rounded-full bg-background shadow-lg ring-0 transition-transform data-[state=checked]:translate-x-5 data-[state=unchecked]:translate-x-0"
+	'pointer-events-none block h-5 w-5 rounded-full bg-background shadow-lg ring-0 transition-transform data-[state=checked]:translate-x-5 data-[state=unchecked]:translate-x-0')}
-      )}
     />
-  </SwitchPrimitives.Root>
+  </SwitchPrimitives.Root>))
-))
 Switch.displayName = SwitchPrimitives.Root.displayName
 
 export { Switch }

frontend/src/components/ui/toast.tsx

@@ -1,129 +1,115 @@
-"use client"
+"use client"
-
+
-import * as React from "react"
+import * as React from "react"
-import * as ToastPrimitives from "@radix-ui/react-toast"
+import * as ToastPrimitives from "@radix-ui/react-toast"
-import { cva, type VariantProps } from "class-variance-authority"
+import { cva, type VariantProps } from "class-variance-authority"
-import { X } from "lucide-react"
+import { X } from "lucide-react"
-
+
-import { cn } from "@/lib/utils"
+import { cn } from "@/lib/utils"
-
+
-const ToastProvider = ToastPrimitives.Provider
+const ToastProvider = ToastPrimitives.Provider
-
+
-const ToastViewport = React.forwardRef<
+const ToastViewport = React.forwardRef<
-  React.ElementRef<typeof ToastPrimitives.Viewport>,
+  React.ElementRef<typeof ToastPrimitives.Viewport>,
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Viewport>
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Viewport>
->(({ className, ...props }, ref) => (
+>(({ className, ...props }, ref) => (
-  <ToastPrimitives.Viewport
+  <ToastPrimitives.Viewport
-    ref={ref}
+    ref={ref}
-    className={cn(
+    className={cn(
-      "fixed top-0 z-[100] flex max-h-screen w-full flex-col-reverse p-4 sm:bottom-0 sm:right-0 sm:top-auto sm:flex-col md:max-w-[420px]",
+      "fixed top-0 z-[100] flex max-h-screen w-full flex-col-reverse p-4 sm:bottom-0 sm:right-0 sm:top-auto sm:flex-col md:max-w-[420px]",
-      className
+      className
)}
-    )}
+    {...props}
-    {...props}
+  />
))
-  />
+ToastViewport.displayName = ToastPrimitives.Viewport.displayName
-))
+
-ToastViewport.displayName = ToastPrimitives.Viewport.displayName
+const toastVariants = cva(
-
+  "group pointer-events-auto relative flex w-full items-center justify-between space-x-4 overflow-hidden rounded-md border p-6 pr-8 shadow-lg transition-all data-[swipe=cancel]:translate-x-0 data-[swipe=end]:translate-x-[var(--radix-toast-swipe-end-x)] data-[swipe=move]:translate-x-[var(--radix-toast-swipe-move-x)] data-[swipe=move]:transition-none data-[state=open]:animate-in data-[state=closed]:animate-out data-[swipe=end]:animate-out data-[state=closed]:fade-out-80 data-[state=closed]:slide-out-to-right-full data-[state=open]:slide-in-from-top-full data-[state=open]:sm:slide-in-from-bottom-full",
-const toastVariants = cva(
+  {
-  "group pointer-events-auto relative flex w-full items-center justify-between space-x-4 overflow-hidden rounded-md border p-6 pr-8 shadow-lg transition-all data-[swipe=cancel]:translate-x-0 data-[swipe=end]:translate-x-[var(--radix-toast-swipe-end-x)] data-[swipe=move]:translate-x-[var(--radix-toast-swipe-move-x)] data-[swipe=move]:transition-none data-[state=open]:animate-in data-[state=closed]:animate-out data-[swipe=end]:animate-out data-[state=closed]:fade-out-80 data-[state=closed]:slide-out-to-right-full data-[state=open]:slide-in-from-top-full data-[state=open]:sm:slide-in-from-bottom-full",
+    variants: {
-  {
+      variant: {
-    variants: {
+	default: "border bg-background text-foreground",
-      variant: {
+	destructive:
-        default: "border bg-background text-foreground",
+	  "destructive group border-destructive bg-destructive text-destructive-foreground",
-        destructive:
+      },
-          "destructive group border-destructive bg-destructive text-destructive-foreground",
+    },
-      },
+    defaultVariants: { variant: "default" } }
)
-    },
+
-    defaultVariants: {
+const Toast = React.forwardRef<
-      variant: "default",
+  React.ElementRef<typeof ToastPrimitives.Root>,
-    },
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Root> &
-  }
+    VariantProps<typeof toastVariants>
-)
+>(({ className, variant, ...props }, ref) => {
-
+  return (
-const Toast = React.forwardRef<
+    <ToastPrimitives.Root
-  React.ElementRef<typeof ToastPrimitives.Root>,
+      ref={ref}
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Root> &
+      className={cn(toastVariants({ variant }), className)}
-    VariantProps<typeof toastVariants>
+      {...props}
->(({ className, variant, ...props }, ref) => {
+    />
)
})
-  return (
+Toast.displayName = ToastPrimitives.Root.displayName
-    <ToastPrimitives.Root
+
-      ref={ref}
+const ToastAction = React.forwardRef<
-      className={cn(toastVariants({ variant }), className)}
+  React.ElementRef<typeof ToastPrimitives.Action>,
-      {...props}
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Action>
-    />
+>(({ className, ...props }, ref) => (
-  )
+  <ToastPrimitives.Action
-})
+    ref={ref}
-Toast.displayName = ToastPrimitives.Root.displayName
+    className={cn(
-
+      "inline-flex h-8 shrink-0 items-center justify-center rounded-md border bg-transparent px-3 text-sm font-medium ring-offset-background transition-colors hover:bg-secondary focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 group-[.destructive]:border-muted/40 group-[.destructive]:hover:border-destructive/30 group-[.destructive]:hover:bg-destructive group-[.destructive]:hover:text-destructive-foreground group-[.destructive]:focus:ring-destructive",
-const ToastAction = React.forwardRef<
+      className
)}
-  React.ElementRef<typeof ToastPrimitives.Action>,
+    {...props}
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Action>
+  />
))
->(({ className, ...props }, ref) => (
+ToastAction.displayName = ToastPrimitives.Action.displayName
-  <ToastPrimitives.Action
+
-    ref={ref}
+const ToastClose = React.forwardRef<
-    className={cn(
+  React.ElementRef<typeof ToastPrimitives.Close>,
-      "inline-flex h-8 shrink-0 items-center justify-center rounded-md border bg-transparent px-3 text-sm font-medium ring-offset-background transition-colors hover:bg-secondary focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 group-[.destructive]:border-muted/40 group-[.destructive]:hover:border-destructive/30 group-[.destructive]:hover:bg-destructive group-[.destructive]:hover:text-destructive-foreground group-[.destructive]:focus:ring-destructive",
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Close>
-      className
+>(({ className, ...props }, ref) => (
-    )}
+  <ToastPrimitives.Close
-    {...props}
+    ref={ref}
-  />
+    className={cn(
-))
+      "absolute right-2 top-2 rounded-md p-1 text-foreground/50 opacity-0 transition-opacity hover:text-foreground focus:opacity-100 focus:outline-none focus:ring-2 group-hover:opacity-100 group-[.destructive]:text-red-300 group-[.destructive]:hover:text-red-50 group-[.destructive]:focus:ring-red-400 group-[.destructive]:focus:ring-offset-red-600",
-ToastAction.displayName = ToastPrimitives.Action.displayName
+      className
)}
-
+    toast-close=""
-const ToastClose = React.forwardRef<
+    {...props}
-  React.ElementRef<typeof ToastPrimitives.Close>,
+  >
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Close>
+    <X className="h-4 w-4" />
->(({ className, ...props }, ref) => (
+  </ToastPrimitives.Close>
))
-  <ToastPrimitives.Close
+ToastClose.displayName = ToastPrimitives.Close.displayName
-    ref={ref}
+
-    className={cn(
+const ToastTitle = React.forwardRef<
-      "absolute right-2 top-2 rounded-md p-1 text-foreground/50 opacity-0 transition-opacity hover:text-foreground focus:opacity-100 focus:outline-none focus:ring-2 group-hover:opacity-100 group-[.destructive]:text-red-300 group-[.destructive]:hover:text-red-50 group-[.destructive]:focus:ring-red-400 group-[.destructive]:focus:ring-offset-red-600",
+  React.ElementRef<typeof ToastPrimitives.Title>,
-      className
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Title>
-    )}
+>(({ className, ...props }, ref) => (
-    toast-close=""
+  <ToastPrimitives.Title
-    {...props}
+    ref={ref}
-  >
+    className={cn("text-sm font-semibold", className)}
-    <X className="h-4 w-4" />
+    {...props}
-  </ToastPrimitives.Close>
+  />
))
-))
+ToastTitle.displayName = ToastPrimitives.Title.displayName
-ToastClose.displayName = ToastPrimitives.Close.displayName
+
-
+const ToastDescription = React.forwardRef<
-const ToastTitle = React.forwardRef<
+  React.ElementRef<typeof ToastPrimitives.Description>,
-  React.ElementRef<typeof ToastPrimitives.Title>,
+  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Description>
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Title>
+>(({ className, ...props }, ref) => (
->(({ className, ...props }, ref) => (
+  <ToastPrimitives.Description
-  <ToastPrimitives.Title
+    ref={ref}
-    ref={ref}
+    className={cn("text-sm opacity-90", className)}
-    className={cn("text-sm font-semibold", className)}
+    {...props}
-    {...props}
+  />
))
-  />
+ToastDescription.displayName = ToastPrimitives.Description.displayName
-))
+
-ToastTitle.displayName = ToastPrimitives.Title.displayName
+type ToastProps = React.ComponentPropsWithoutRef<typeof Toast>
-
+
-const ToastDescription = React.forwardRef<
+type ToastActionElement = React.ReactElement<typeof ToastAction>
-  React.ElementRef<typeof ToastPrimitives.Description>,
+
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Description>
+export {
->(({ className, ...props }, ref) => (
+  type ToastProps,
-  <ToastPrimitives.Description
+  type ToastActionElement,
-    ref={ref}
+  ToastProvider,
-    className={cn("text-sm opacity-90", className)}
+  ToastViewport,
-    {...props}
+  Toast,
-  />
+  ToastTitle,
-))
+  ToastDescription,
-ToastDescription.displayName = ToastPrimitives.Description.displayName
+  ToastClose,
-
+  ToastAction,
-type ToastProps = React.ComponentPropsWithoutRef<typeof Toast>
+}
-
-type ToastActionElement = React.ReactElement<typeof ToastAction>
-
-export {
-  type ToastProps,
-  type ToastActionElement,
-  ToastProvider,
-  ToastViewport,
-  Toast,
-  ToastTitle,
-  ToastDescription,
-  ToastClose,
-  ToastAction,
-}

frontend/src/components/ui/toaster.tsx

@@ -1,31 +1,30 @@
-'use client'
+'use client'
-
+
-import { useToast } from '@/components/ui/use-toast'
+import { useToast } from '@/components/ui/use-toast'
-import { Toast,
+import { Toast,
-	 ToastClose,
+	 ToastClose,
-	 ToastDescription,
+	 ToastDescription,
-	 ToastProvider,
+	 ToastProvider,
-	 ToastTitle,
+	 ToastTitle,
-	 ToastViewport } from '@/components/ui/toast'
+	 ToastViewport } from '@/components/ui/toast'
-
+
-
+
-export const Toaster = () => {
+export const Toaster = () => {
-  const { toasts } = useToast ()
+  const { toasts } = useToast ()
-
+
-  return (
+  return (
-    <ToastProvider>
+    <ToastProvider>
-      {toasts.map (({ id, title, description, action, ...props }) => (
+      {toasts.map (({ id, title, description, action, ...props }) => (
-	  <Toast key={id}
+	  <Toast key={id}
-		 className="bg-gray-300/80 dark:bg-gray-700/80"
+		 className="bg-gray-300/80 dark:bg-gray-700/80"
-		 {...props}>
+		 {...props}>
-	    <div className="grid gap-1">
+	    <div className="grid gap-1">
-	      {title && <ToastTitle>{title}</ToastTitle>}
+	      {title && <ToastTitle>{title}</ToastTitle>}
-	      {description && <ToastDescription>{description}</ToastDescription>}
+	      {description && <ToastDescription>{description}</ToastDescription>}
-	    </div>
+	    </div>
-	    {action}
+	    {action}
-	    <ToastClose />
+	    <ToastClose />
-	  </Toast>))}
+	  </Toast>))}
-      <ToastViewport />
+      <ToastViewport />
-    </ToastProvider>
+    </ToastProvider>
)
-  )
+}
-}

frontend/src/components/ui/use-toast.tsx

@@ -58,8 +58,7 @@ const addToRemoveQueue = (toastId: string) => {
     toastTimeouts.delete(toastId)
     dispatch({
       type: "REMOVE_TOAST",
-      toastId: toastId,
+      toastId: toastId})
-    })
   }, TOAST_REMOVE_DELAY)
 
   toastTimeouts.set(toastId, timeout)
@@ -69,17 +68,14 @@ export const reducer = (state: State, action: Action): State => {
   switch (action.type) {
     case "ADD_TOAST":
       return {
-        ...state,
+	...state,
-        toasts: [action.toast, ...state.toasts].slice(0, TOAST_LIMIT),
+	toasts: [action.toast, ...state.toasts].slice(0, TOAST_LIMIT)}
-      }
 
     case "UPDATE_TOAST":
       return {
-        ...state,
+	...state,
-        toasts: state.toasts.map((t) =>
+	toasts: state.toasts.map((t) =>
-          t.id === action.toast.id ? { ...t, ...action.toast } : t
+	  t.id === action.toast.id ? { ...t, ...action.toast } : t)}
-        ),
-      }
 
     case "DISMISS_TOAST": {
       const { toastId } = action
@@ -87,36 +83,31 @@ export const reducer = (state: State, action: Action): State => {
       // ! Side effects ! - This could be extracted into a dismissToast() action,
       // but I'll keep it here for simplicity
       if (toastId) {
-        addToRemoveQueue(toastId)
+	addToRemoveQueue(toastId)
       } else {
-        state.toasts.forEach((toast) => {
+	state.toasts.forEach((toast) => {
-          addToRemoveQueue(toast.id)
+	  addToRemoveQueue(toast.id)
-        })
+	})
       }
 
       return {
-        ...state,
+	...state,
-        toasts: state.toasts.map((t) =>
+	toasts: state.toasts.map((t) =>
-          t.id === toastId || toastId === undefined
+	  t.id === toastId || toastId === undefined
-            ? {
+	    ? {
-                ...t,
+		...t,
-                open: false,
+		open: false}
-              }
+	    : t)}
-            : t
-        ),
-      }
     }
     case "REMOVE_TOAST":
       if (action.toastId === undefined) {
-        return {
+	return {
-          ...state,
+	  ...state,
-          toasts: [],
+	  toasts: []}
-        }
       }
       return {
-        ...state,
+	...state,
-        toasts: state.toasts.filter((t) => t.id !== action.toastId),
+	toasts: state.toasts.filter((t) => t.id !== action.toastId)}
-      }
   }
 }
 
@@ -139,8 +130,7 @@ function toast({ ...props }: Toast) {
   const update = (props: ToasterToast) =>
     dispatch({
       type: "UPDATE_TOAST",
-      toast: { ...props, id },
+      toast: { ...props, id }})
-    })
   const dismiss = () => dispatch({ type: "DISMISS_TOAST", toastId: id })
 
   dispatch({
@@ -150,16 +140,13 @@ function toast({ ...props }: Toast) {
       id,
       open: true,
       onOpenChange: (open) => {
-        if (!open) dismiss()
+	if (!open) dismiss()
-      },
+      }}})
-    },
-  })
 
   return {
     id: id,
     dismiss,
-    update,
+    update}
-  }
 }
 
 function useToast() {
@@ -170,7 +157,7 @@ function useToast() {
     return () => {
       const index = listeners.indexOf(setState)
       if (index > -1) {
-        listeners.splice(index, 1)
+	listeners.splice(index, 1)
       }
     }
   }, [state])
@@ -178,8 +165,7 @@ function useToast() {
   return {
     ...state,
     toast,
-    dismiss: (toastId?: string) => dispatch({ type: "DISMISS_TOAST", toastId }),
+    dismiss: (toastId?: string) => dispatch({ type: "DISMISS_TOAST", toastId })}
-  }
 }
 
 export { useToast, toast }

frontend/src/config.sample.ts

@@ -3,8 +3,7 @@ const ENV: string = 'development'
 
 const config = {
   API_BASE_URL: ENV === 'production' ? 'https://hub.nizika.monster/api' : 'http://localhost:3002',
-  SITE_TITLE:   'ぼざクリ タグ広場'
+  SITE_TITLE:   'ぼざクリ タグ広場'}
-}
 
 export const API_BASE_URL = config.API_BASE_URL
 export const SITE_TITLE = config.SITE_TITLE

frontend/src/consts.ts

@@ -10,8 +10,7 @@ export const CATEGORIES = [
     'general',
     'material',
     'meta',
-    'nico',
+    'nico'] as const
-    ] as const
 
 export const CATEGORY_NAMES: Record<Category, string> = {
     deerjikist: 'ニジラー',
@@ -20,16 +19,14 @@ export const CATEGORY_NAMES: Record<Category, string> = {
     general:    '一般',
     material:   '素材',
     meta:       'メタタグ',
-    nico:       'ニコニコタグ',
+    nico:       'ニコニコタグ'} as const
-    } as const
 
 export const FETCH_POSTS_ORDER_FIELDS = [
     'title',
     'url',
     'original_created_at',
     'created_at',
-    'updated_at',
+    'updated_at'] as const
-    ] as const
 
 export const PLATFORMS = ['nico', 'youtube'] as const
 
@@ -43,13 +40,11 @@ export const TAG_COLOUR = {
     general:    'cyan',
     material:   'orange',
     meta:       'yellow',
-    nico:       'gray',
+    nico:       'gray'} as const satisfies Record<Category, string>
-    } as const satisfies Record<Category, string>
 
 export const USER_ROLES = ['admin', 'member', 'guest'] as const
 
 export const ViewFlagBehavior = {
     OnShowedDetail: 1,
     OnClickedLink:  2,
-    NotAuto:        3,
+    NotAuto:        3} as const
-    } as const

frontend/src/lib/api.ts

@@ -23,8 +23,7 @@ const apiP = async <T> (
     method: 'post' | 'put' | 'patch',
     path:   string,
     body?:  unknown,
-    opt?:   Opt,
+    opt?:   Opt): Promise<T> => {
-): Promise<T> => {
   const res = await client[method] (path, body ?? { }, withUserCode (opt))
   if (opt?.responseType === 'blob')
     return res.data as T
@@ -34,8 +33,7 @@ const apiP = async <T> (
 
 export const apiGet = async <T> (
     path: string,
-    opt?: Opt,
+    opt?: Opt): Promise<T> => {
-): Promise<T> => {
   const res = await client.get (path, withUserCode (opt))
   if (opt?.responseType === 'blob')
     return res.data as T
@@ -46,28 +44,24 @@ export const apiGet = async <T> (
 export const apiPost = async <T> (
     path:   string,
     body?:  unknown,
-    opt?:   Opt,
+    opt?:   Opt): Promise<T> => apiP ('post', path, body, opt)
-): Promise<T> => apiP ('post', path, body, opt)
 
 
 export const apiPut = async <T> (
     path:   string,
     body?:  unknown,
-    opt?:   Opt,
+    opt?:   Opt): Promise<T> => apiP ('put', path, body, opt)
-): Promise<T> => apiP ('put', path, body, opt)
 
 
 export const apiPatch = async <T> (
     path:   string,
     body?:  unknown,
-    opt?:   Opt,
+    opt?:   Opt): Promise<T> => apiP ('patch', path, body, opt)
-): Promise<T> => apiP ('patch', path, body, opt)
 
 
 export const apiDelete = async <T = void> (
     path: string,
-    opt?: Opt,
+    opt?: Opt): Promise<T> => {
-): Promise<T> => {
   const res = await client.delete (path, withUserCode (opt))
   if (res.data == null || res.data === '')
     return undefined as T

frontend/src/lib/gekanator.ts

@@ -104,8 +104,7 @@ export type BuildGekanatorQuestionsOptions = {
 
 
 export const normalizeTitleLengthCondition = (
-    condition:  GekanatorQuestionCondition,
+    condition:  GekanatorQuestionCondition): GekanatorQuestionCondition => {
-): GekanatorQuestionCondition => {
   switch (condition.type)
   {
   case 'title-length-greater-than':
@@ -119,8 +118,7 @@ export const normalizeTitleLengthCondition = (
 
 
 export const titleLengthMinimumForCondition = (
-    condition:  GekanatorQuestionCondition,
+    condition:  GekanatorQuestionCondition): number | null => {
-): number | null => {
   switch (condition.type)
   {
   case 'title-length-at-least':
@@ -134,8 +132,7 @@ export const titleLengthMinimumForCondition = (
 
 
 export const questionIdForCondition = (
-    condition:  NonPostSimilarityCondition,
+    condition:  NonPostSimilarityCondition): string => {
-): string => {
   switch (condition.type)
   {
   case 'tag':
@@ -161,8 +158,7 @@ export const questionIdForCondition = (
 
 const directExampleAnswerFor = (
     question:  StoredGekanatorQuestion,
-    post:      Post,
+    post:      Post): GekanatorAnswerValue | null => {
-): GekanatorAnswerValue | null => {
   if (question.kind !== 'post_similarity' && question.kind !== 'tag')
     return null
 
@@ -178,15 +174,13 @@ const directExampleAnswerFor = (
 
 
 export const isLearnedSemanticQuestion = (
-    question:  StoredGekanatorQuestion | GekanatorQuestion,
+    question:  StoredGekanatorQuestion | GekanatorQuestion): boolean =>
-): boolean =>
     question.kind === 'post_similarity'
     && question.source === 'user_suggested'
 
 
 export const learnedSemanticSideForAnswer = (
-    answer:  GekanatorAnswerValue | null,
+    answer:  GekanatorAnswerValue | null): LearnedSemanticSide => {
-): LearnedSemanticSide => {
   if (answer === 'yes' || answer === 'partial')
     return 'positive'
 
@@ -314,8 +308,7 @@ const questionableTag = (post: Post, key: string): boolean => {
 
 const questionMatches = (
     post:       Post,
-    question:   StoredGekanatorQuestion,
+    question:   StoredGekanatorQuestion): boolean => {
-): boolean => {
   const directAnswer = directExampleAnswerFor (question, post)
   if (directAnswer)
     return question.kind === 'post_similarity'
@@ -350,8 +343,7 @@ const questionMatches = (
 
 export const expectedAnswerForQuestion = (
     question:  StoredGekanatorQuestion | GekanatorQuestion | undefined,
-    post:      Post | null,
+    post:      Post | null): GekanatorAnswerValue | null => {
-): GekanatorAnswerValue | null => {
   if (!(question) || !(post))
     return null
 
@@ -382,14 +374,12 @@ export const expectedAnswerForQuestion = (
 
 export const learnedSemanticSideForPost = (
     question:  StoredGekanatorQuestion | GekanatorQuestion | undefined,
-    post:      Post | null,
+    post:      Post | null): LearnedSemanticSide =>
-): LearnedSemanticSide =>
     learnedSemanticSideForAnswer (expectedAnswerForQuestion (question, post))
 
 
 export const restoreGekanatorQuestion = (
-    question:  StoredGekanatorQuestion,
+    question:  StoredGekanatorQuestion): GekanatorQuestion => {
-): GekanatorQuestion => {
   const normalizedCondition = normalizeTitleLengthCondition (question.condition)
   const normalizedQuestion = {
       ...question,
@@ -408,8 +398,7 @@ export const restoreGekanatorQuestion = (
 
 
 export const storeGekanatorQuestion = (
-    question:  GekanatorQuestion,
+    question:  GekanatorQuestion): StoredGekanatorQuestion => ({
-): StoredGekanatorQuestion => ({
   id: question.condition.type === 'title-length-greater-than'
       ? `title:length-at-least:${ question.condition.length + 1 }`
       : question.id,
@@ -436,8 +425,7 @@ export const fetchGekanatorQuestions = async (): Promise<StoredGekanatorQuestion
 
 export const fetchGekanatorExtraQuestions = async (
     gameId:  number,
-    nonce?: string,
+    nonce?: string): Promise<GekanatorExtraQuestion[]> => {
-): Promise<GekanatorExtraQuestion[]> => {
   const data = await apiGet<{ questions: GekanatorExtraQuestion[] }> (
       `/gekanator/games/${ gameId }/extra_questions`,
       { params: nonce ? { nonce } : undefined })
@@ -447,8 +435,7 @@ export const fetchGekanatorExtraQuestions = async (
 
 export const buildGekanatorQuestions = (
     posts:    Post[],
-    options:  BuildGekanatorQuestionsOptions = { },
+    options:  BuildGekanatorQuestionsOptions = { }): GekanatorQuestion[] => {
-): GekanatorQuestion[] => {
   const {
       includeTitleContains = true,
       tagQuestionCap = 192,
@@ -490,8 +477,7 @@ export const buildGekanatorQuestions = (
 
   const usefulEntries = <T extends string | number> (
       counts:  Map<T, number>,
-      cap:     number,
+      cap:     number) =>
-  ) =>
       [...counts.entries ()]
       .filter (([, count]) => count > 0 && count < posts.length)
       .sort ((a, b) => Math.abs (posts.length / 2 - a[1])

frontend/src/lib/gekanatorCandidateRecovery.ts

@@ -32,8 +32,7 @@ export const candidatePostsFor = (
 				   answers:                 GekanatorAnswerLog[]
 				   softenedQuestionIds:     Set<string>
 				   rejectedPostIds:         Set<number>
-				   recoveredCandidatePosts: Map<number, RecoveredCandidateState> },
+				   recoveredCandidatePosts: Map<number, RecoveredCandidateState> }): Post[] => {
-): Post[] => {
   const questionById = new Map (questions.map (question => [question.id, question]))
 
   return posts.filter (post => {
@@ -76,8 +75,7 @@ export const candidatePostsFor = (
 export const hardFilteredPostsForAnswer = (
     { posts, question, answer }: { posts:     Post[]
 				   question:  GekanatorQuestion
-				   answer:    GekanatorAnswerValue },
+				   answer:    GekanatorAnswerValue }): Post[] => {
-): Post[] => {
   if (!(questionSupportsAnswerBasedHardFiltering (question)))
     return posts
 
@@ -98,8 +96,7 @@ const concreteAnswerOptions: GekanatorAnswerValue[] = ['yes', 'no', 'partial', '
 
 export const allConcreteAnswerOptionsExhausted = (
     posts:      Post[],
-    question:   GekanatorQuestion | null,
+    question:   GekanatorQuestion | null): boolean => {
-): boolean => {
   if (!(question))
     return false
 
@@ -125,8 +122,7 @@ export const recoverCandidatePosts = (
 			     recoveredCandidatePosts: Map<number, RecoveredCandidateState>
 			     eligiblePostIds:         Set<number>
 			     answerCountAtRecovery:   number
-			     recoveryStepCount:       number },
+			     recoveryStepCount:       number }): { recoveredCandidatePosts: Map<number, RecoveredCandidateState>
-): { recoveredCandidatePosts: Map<number, RecoveredCandidateState>
      recoveryStepCount:       number } | null => {
   const recovered = new Map (recoveredCandidatePosts)
   const targetSize = nextRecoveryTargetSize (recoveryStepCount)

frontend/src/lib/gekanatorQuestionFilters.ts

@@ -8,8 +8,7 @@ import type {
 
 
 export const monthForCondition = (
-    condition:  GekanatorQuestion['condition'],
+    condition:  GekanatorQuestion['condition']): number | null => {
-): number | null => {
   if (condition.type === 'original-month')
     return condition.month
 
@@ -24,8 +23,7 @@ export const monthForCondition = (
 const isTitleLengthContradiction = (
     candidate:  GekanatorQuestion['condition'],
     previous:   GekanatorQuestion['condition'],
-    answer:     GekanatorAnswerValue,
+    answer:     GekanatorAnswerValue): boolean => {
-): boolean => {
   const candidateLength = titleLengthMinimumForCondition (candidate)
   const previousLength = titleLengthMinimumForCondition (previous)
   if (candidateLength === null || previousLength === null)
@@ -45,8 +43,7 @@ const isTitleLengthContradiction = (
 
 const isQuestionRedundantAfterAnswers = (
     question:  GekanatorQuestion,
-    answers:   GekanatorAnswerLog[],
+    answers:   GekanatorAnswerLog[]): boolean => answers.some (answer => {
-): boolean => answers.some (answer => {
   const previous = answer.questionCondition
   return previous !== undefined
       && isTitleLengthContradiction (question.condition, previous, answer.answer)
@@ -56,8 +53,7 @@ const isQuestionRedundantAfterAnswers = (
 const isSourceFactBlocked = (
     candidate:  GekanatorQuestion['condition'],
     previous:   GekanatorQuestion['condition'],
-    answer:     GekanatorAnswerValue,
+    answer:     GekanatorAnswerValue): boolean => {
-): boolean => {
   if (candidate.type !== 'source' || previous.type !== 'source')
     return false
 
@@ -76,8 +72,7 @@ const isSourceFactBlocked = (
 const isOriginalYearFactBlocked = (
     candidate:  GekanatorQuestion['condition'],
     previous:   GekanatorQuestion['condition'],
-    answer:     GekanatorAnswerValue,
+    answer:     GekanatorAnswerValue): boolean => {
-): boolean => {
   if (candidate.type !== 'original-year' || previous.type !== 'original-year')
     return false
 
@@ -96,8 +91,7 @@ const isOriginalYearFactBlocked = (
 const isOriginalMonthFactBlocked = (
     candidate:  GekanatorQuestion['condition'],
     previous:   GekanatorQuestion['condition'],
-    answer:     GekanatorAnswerValue,
+    answer:     GekanatorAnswerValue): boolean => {
-): boolean => {
   switch (answer)
   {
   case 'yes':
@@ -143,8 +137,7 @@ const isOriginalMonthFactBlocked = (
 const isFactQuestionBlocked = (
     candidate:  GekanatorQuestion['condition'],
     previous:   GekanatorQuestion['condition'],
-    answer:     GekanatorAnswerValue,
+    answer:     GekanatorAnswerValue): boolean => {
-): boolean => {
   if (!(answer === 'yes' || answer === 'no'))
     return false
 
@@ -156,8 +149,7 @@ const isFactQuestionBlocked = (
 
 export const isQuestionHardFilteredAfterAnswers = (
     question:  GekanatorQuestion,
-    answers:   GekanatorAnswerLog[],
+    answers:   GekanatorAnswerLog[]): boolean => answers.some (answer => {
-): boolean => answers.some (answer => {
   const previous = answer.questionCondition
   if (previous === undefined)
     return false

frontend/src/lib/materials.ts

@@ -0,0 +1,139 @@
+import { apiGet, isApiError, apiPost, apiPut } from '@/lib/api'
+
+import type { Material,
+	      MaterialIndexResponse,
+	      MaterialVersion,
+	      FetchMaterialsParams,
+	      MaterialFilter,
+	      MaterialSyncSuppression,
+	      MaterialSidebarTag,
+	      MaterialTagTree } from '@/types'
+
+export type FetchMaterialTreeParams = {
+    parentId?:       number | null
+    materialFilter:  MaterialFilter }
+
+export type MaterialSyncSuppressionResponse = { suppressions: MaterialSyncSuppression[] }
+
+export type MaterialChangesResponse = {
+    versions: MaterialVersion[]
+    count:    number }
+
+const MATERIAL_FILTERS: MaterialFilter[] = ['present', 'missing', 'any']
+
+
+export const parseMaterialFilter = (
+    value: unknown,
+    fallback: MaterialFilter = 'present',
+): MaterialFilter =>
+    typeof value === 'string' && MATERIAL_FILTERS.includes (value as MaterialFilter)
+    ? value as MaterialFilter
+    : fallback
+
+
+export const fetchMaterials = async (
+    { q, tagState, mediaKind, createdFrom, createdTo,
+      updatedFrom, updatedTo, sort, direction, page,
+      tagId, includeDescendants, groupBy,
+      limit }: FetchMaterialsParams,
+): Promise<MaterialIndexResponse> =>
+    await apiGet ('/materials', { params: {
+	...(q && { q }),
+	tag_state:   tagState,
+	media_kind:  mediaKind,
+	...(tagId != null && { tag_id: tagId }),
+	...(includeDescendants && { include_descendants: '1' }),
+	...(groupBy !== 'none' && { group_by: groupBy }),
+	...(createdFrom && { created_from: createdFrom }),
+	...(createdTo && { created_to: createdTo }),
+	...(updatedFrom && { updated_from: updatedFrom }),
+	...(updatedTo && { updated_to: updatedTo }),
+	sort,
+	direction,
+	page,
+	limit} })
+
+
+export const fetchMaterial = async (id: string): Promise<Material | null> => {
+  try
+  {
+    return await apiGet (`/materials/${ id }`)
+  }
+  catch (error)
+  {
+    if (isApiError (error) && error.response?.status === 404)
+      return null
+    throw error
+  }
+}
+
+
+export const fetchMaterialChanges = async (
+    { materialId, tag, eventType, page, limit }: {
+	materialId?: string
+	tag?:        string
+	eventType?:  string
+	page:        number
+	limit:       number
+    }): Promise<MaterialChangesResponse> =>
+    await apiGet ('/materials/versions', { params: {
+	...(materialId && { material_id: materialId }),
+	...(tag && { tag }),
+	...(eventType && { event_type: eventType }),
+	page,
+	limit} })
+
+
+export const fetchMaterialTagTree = async (
+    { parentId, materialFilter }: FetchMaterialTreeParams): Promise<MaterialSidebarTag[]> =>
+    await apiGet ('/tags/with-depth', { params: {
+	...(parentId != null && { parent: String (parentId) }),
+	material_filter: materialFilter} })
+
+
+export const fetchMaterialTagByName = async (
+    name: string,
+    materialFilter: MaterialFilter): Promise<MaterialTagTree | null> => {
+  try
+  {
+    return await apiGet (`/tags/name/${ encodeURIComponent (name) }/materials`,
+			 { params: { material_filter: materialFilter } })
+  }
+  catch (error)
+  {
+    if (isApiError (error) && error.response?.status === 404)
+      return null
+    throw error
+  }
+}
+
+
+export const createMaterial = async (formData: FormData): Promise<Material> =>
+    await apiPost ('/materials', formData)
+
+
+export const updateMaterial = async (
+    id: string,
+    formData: FormData): Promise<Material> =>
+    await apiPut (`/materials/${ id }`, formData)
+
+
+export const fetchMaterialSyncSuppressions =
+    async (): Promise<MaterialSyncSuppressionResponse> =>
+        await apiGet ('/materials/suppressions')
+
+
+export const createMaterialSyncSuppression = async (
+    payload: {
+        sourceKind:   string
+        sourceUri?:   string
+        drivePath?:   string
+        driveFileId?: string
+        reason:       string
+    }): Promise<MaterialSyncSuppression> =>
+    await apiPost ('/materials/suppressions', {
+        source_kind:   payload.sourceKind,
+        source_uri:    payload.sourceUri,
+        drive_path:    payload.drivePath,
+        drive_file_id: payload.driveFileId,
+        reason:        payload.reason})

frontend/src/lib/posts.ts

@@ -5,8 +5,7 @@ import type { FetchPostsParams, Post, PostVersion } from '@/types'
 
 export const fetchPosts = async (
     { url, title, tags, match, createdFrom, createdTo, updatedFrom, updatedTo,
-      originalCreatedFrom, originalCreatedTo, page, limit, order }: FetchPostsParams,
+      originalCreatedFrom, originalCreatedTo, page, limit, order }: FetchPostsParams): Promise<{
-): Promise<{
     posts:  Post[]
     count:  number }> =>
 	await apiGet ('/posts', { params: {
@@ -33,8 +32,7 @@ export const fetchPostChanges = async (
 	post?:  string
 	tag?:   string
 	page:   number
-	limit:  number },
+	limit:  number }): Promise<{
-): Promise<{
     versions: PostVersion[]
     count:    number }> =>
 	await apiGet ('/posts/versions', { params: { ...(post && { post }),
@@ -52,8 +50,7 @@ export const updatePost = async (
     { baseVersionNo, force, merge }: {
 	baseVersionNo?: number
 	force?:         boolean
-	merge?:         boolean }
+	merge?:         boolean }) =>
-) =>
     await apiPut<Post> (
 	`/posts/${ post.id }`,
 	{ title: post.title,

frontend/src/lib/queryKeys.ts

@@ -1,4 +1,10 @@
-import type { FetchNicoTagsParams, FetchPostsParams, FetchTagsParams } from '@/types'
+import type {
+    FetchNicoTagsParams,
+    FetchMaterialsParams,
+    FetchPostsParams,
+    FetchTagsParams,
+    MaterialFilter,
+} from '@/types'
 
 export const postsKeys = {
     root:     ['posts'] as const,
@@ -25,6 +31,27 @@ export const tagsKeys = {
 		      ['tags', 'changes', p] as const,
     deerjikists:  (id: string) => ['tags', 'deerjikists', id] as const }
 
+export const materialsKeys = {
+    root:         ['materials'] as const,
+    index:        (p: FetchMaterialsParams) => ['materials', 'index', p] as const,
+    changes:      (p: {
+	materialId?: string
+	tag?:        string
+	eventType?:  string
+	page:        number
+	limit:       number
+    }) => ['materials', 'changes', p] as const,
+    byTagName:     (name: string, materialFilter: MaterialFilter) =>
+		      ['materials', 'tag', name, materialFilter] as const,
+    show:         (id: string) => ['materials', id] as const,
+    suppressions: () => ['materials', 'suppressions'] as const,
+    tree:         (p: {
+	parentId?:       number | null
+	materialFilter:  MaterialFilter
+    }) => ['materials', 'tree', p] as const,
+    unclassified: (p: { page?: number; limit?: number } = { }) =>
+		      ['materials', 'unclassified', p] as const}
+
 export const wikiKeys = {
     root:   ['wiki'] as const,
     index:  (p: { title?: string }) => ['wiki', 'index', p] as const,

frontend/src/lib/tags.ts

@@ -11,8 +11,7 @@ import type { Deerjikist,
 export const fetchTags = async (
     { post, name, category, postCountGTE, postCountLTE, createdFrom, createdTo,
       updatedFrom, updatedTo, deprecated,
-      page, limit, order }: FetchTagsParams,
+      page, limit, order }: FetchTagsParams): Promise<{ tags:  Tag[]
-): Promise<{ tags:  Tag[]
 	     count: number }> =>
     await apiGet ('/tags', { params: {
 	...(post != null && { post }),
@@ -31,8 +30,7 @@ export const fetchTags = async (
 
 
 export const fetchNicoTags = async (
-    { name, linkedTag, linkStatus, page, limit, order }: FetchNicoTagsParams,
+    { name, linkedTag, linkStatus, page, limit, order }: FetchNicoTagsParams): Promise<{ tags:  NicoTag[]
-): Promise<{ tags:  NicoTag[]
 	     count: number }> =>
     await apiGet ('/tags/nico', { params: {
 	page,
@@ -70,14 +68,12 @@ export const fetchTagChanges = async (
     { id, page, limit }: {
 	id?:    string
 	page:   number
-	limit:  number },
+	limit:  number }): Promise<{
-): Promise<{
     versions: TagVersion[]
     count:    number }> =>
 	await apiGet ('/tags/versions', { params: { ...(id && { id }), page, limit } })
 
 
 export const fetchDeerjikistsByTag = async (
-    id: string,
+    id: string): Promise<{ tag: Tag; deerjikists: Deerjikist[] }> =>
-): Promise<{ tag: Tag; deerjikists: Deerjikist[]}> =>
     await apiGet (`/tags/${ id }/deerjikists`)

frontend/src/lib/users.ts

@@ -4,5 +4,4 @@ const CONTENT_EDITOR_ROLES: readonly UserRole[] = ['admin', 'member']
 
 
 export const canEditContent = (
-    user: Pick<User, 'role'> | null | undefined,
+    user: Pick<User, 'role'> | null | undefined): boolean => user != null && CONTENT_EDITOR_ROLES.includes (user.role)
-): boolean => user != null && CONTENT_EDITOR_ROLES.includes (user.role)

frontend/src/lib/utils.ts

@@ -12,8 +12,7 @@ export const cn = (...inputs: ClassValue[]) => twMerge (clsx (...inputs))
 
 export const dateString = (
     d:        string | Date,
-    unknown:  'month' | 'day' | 'hour' | 'minute' | 'second' | null = null,
+    unknown:  'month' | 'day' | 'hour' | 'minute' | 'second' | null = null): string =>
-): string =>
     toDate (d).toLocaleString (
 	'ja-JP-u-ca-japanese',
 	{ era: 'long',
@@ -28,8 +27,7 @@ export const dateString = (
 
 export const originalCreatedAtString = (
     f:  string | Date | null,
-    b:  string | Date | null,
+    b:  string | Date | null): string => {
-): string => {
   const from = f ? toDate (f) : null
   const before = b ? toDate (b) : null
 

frontend/src/lib/wiki.ts

@@ -4,22 +4,19 @@ import type { WikiPage } from '@/types'
 
 
 export const fetchWikiPages = async (
-    { title }:  { title?: string },
+    { title }:  { title?: string }): Promise<WikiPage[]> =>
-): Promise<WikiPage[]> =>
     await apiGet ('/wiki', { params: { title } })
 
 
 export const fetchWikiPage = async (
     id:           string,
-    { version }:  { version?: string },
+    { version }:  { version?: string }): Promise<WikiPage> =>
-): Promise<WikiPage> =>
     await apiGet (`/wiki/${ id }`, { params: version ? { version } : { } })
 
 
 export const fetchWikiPageByTitle = async (
     title:        string,
-    { version }:  { version?: string },
+    { version }:  { version?: string }): Promise<WikiPage | null> => {
-): Promise<WikiPage | null> => {
   try
   {
     return await apiGet (`/wiki/title/${ encodeURIComponent (title) }`, { params: { version } })

frontend/src/pages/GekanatorPage.tsx

@@ -238,8 +238,7 @@ const createGameSeed = (): string => {
 
 const normalizeStoredQuestionId = (
     questionId:  string,
-    condition?:  GekanatorQuestionCondition,
+    condition?:  GekanatorQuestionCondition): string => {
-): string => {
   if (condition?.type === 'title-length-greater-than')
     return `title:length-at-least:${ condition.length + 1 }`
 
@@ -312,8 +311,7 @@ const sourcePriorityForMerge = (question: GekanatorQuestion): number => {
 
 const shouldReplaceMergedQuestion = (
     current:    GekanatorQuestion | undefined,
-    candidate:  GekanatorQuestion,
+    candidate:  GekanatorQuestion): boolean => {
-): boolean => {
   if (!(current))
     return true
 
@@ -408,8 +406,7 @@ const loadRecentGames = (): RecentGameSummary[] => {
 
 
 const storeRecentGameSummary = (
-    summary:  RecentGameSummary,
+    summary:  RecentGameSummary): RecentGameSummary[] => {
-): RecentGameSummary[] => {
   const next =
       [summary,
        ...loadRecentGames ().filter (item => (item.savedAt !== summary.savedAt
@@ -459,8 +456,7 @@ const resettableExtraQuestionState = (): {
 
 const recoveredCandidateMapFromStored = (
     items:   RecoveredCandidatePost[],
-    scores:  [number, number][],
+    scores:  [number, number][]): Map<number, RecoveredCandidateState> => {
-): Map<number, RecoveredCandidateState> => {
   const storedScores = new Map (scores)
 
   return new Map (items.map (item => [item.postId, {
@@ -470,8 +466,7 @@ const recoveredCandidateMapFromStored = (
 
 
 const storedRecoveredCandidatesFromMap = (
-    recoveredCandidatePosts: Map<number, RecoveredCandidateState>,
+    recoveredCandidatePosts: Map<number, RecoveredCandidateState>): RecoveredCandidatePost[] =>
-): RecoveredCandidatePost[] =>
     [...recoveredCandidatePosts.entries ()]
     .map (([postId, recoveredCandidate]) => ({
 	postId,
@@ -513,8 +508,7 @@ const distributionEntropy = (weights: number[]): number =>
 const questionCategoryPenalty = (
     question:       GekanatorQuestion,
     answerCount:    number,
-    repeatPenalty:  number,
+    repeatPenalty:  number): number => {
-): number => {
   const earlyFactor = Math.max (0, (3 - answerCount) / 3)
   const titleLengthPenalty = (() => {
     if (titleLengthMinimumForCondition (question.condition) == null)
@@ -553,8 +547,7 @@ const relatedPostIdsOf = (post: Post): number[] => {
 
 const userPriorWeightsFor = (
     posts:        Post[],
-    recentGames:  RecentGameSummary[],
+    recentGames:  RecentGameSummary[]): Map<number, number> => {
-): Map<number, number> => {
   const postById = new Map (posts.map (post => [post.id, post]))
   const weights = new Map<number, number> ()
   const addWeight = (postId: number, weight: number) => {
@@ -581,14 +574,12 @@ const userPriorWeightsFor = (
 
 const answerWeightFor = (
     questionId:           string,
-    softenedQuestionIds:  Set<string>,
+    softenedQuestionIds:  Set<string>): number => softenedQuestionIds.has (questionId) ? softenedAnswerWeight : 1
-): number => softenedQuestionIds.has (questionId) ? softenedAnswerWeight : 1
 
 
 const scoreWeightForAnswer = (
     answer:               GekanatorAnswerLog,
-    softenedQuestionIds:  Set<string>,
+    softenedQuestionIds:  Set<string>): number =>
-): number =>
     answerWeightFor (answer.questionId, softenedQuestionIds)
     * (
 	answer.questionPurpose === 'learning_user_suggested'
@@ -638,8 +629,7 @@ const titleTermPattern =
 const addPostIdToIndex = <K extends string | number> (
     index:   Map<K, Set<number>>,
     key:     K,
-    postId:  number,
+    postId:  number) => {
-) => {
   const current = index.get (key)
   if (current)
     {
@@ -652,8 +642,7 @@ const addPostIdToIndex = <K extends string | number> (
 
 
 const buildMaterialIndex = (
-    posts:  Post[],
+    posts:  Post[]): GekanatorQuestionMaterialIndex => {
-): GekanatorQuestionMaterialIndex => {
   const postById = new Map<number, Post> ()
   const tagKeysByPostId = new Map<number, string[]> ()
   const postIdsByTagKey = new Map<string, Set<number>> ()
@@ -784,8 +773,7 @@ const originalDateQuestionTextFor = (
     condition:  Extract<
 	GekanatorQuestionCondition,
 	{ type: 'original-year' | 'original-month' | 'original-month-day' }
-    >,
+    >): string => {
-): string => {
   switch (condition.type)
   {
   case 'original-year':
@@ -852,8 +840,7 @@ const isLearnableTagKey = (key: string): boolean => !(key.startsWith ('nico:'))
 
 
 const isUserSuggestedLearnedSemanticQuestion = (
-    question:  GekanatorQuestion,
+    question:  GekanatorQuestion): boolean => isLearnedSemanticQuestion (question)
-): boolean => isLearnedSemanticQuestion (question)
 
 
 type LearnedSemanticCandidateStats = {
@@ -872,8 +859,7 @@ const learnedSemanticStatsForCandidateIds = (
       question }: {
 	candidateIds:  number[]
 	posts:         Post[]
-	question:      GekanatorQuestion },
+	question:      GekanatorQuestion }): LearnedSemanticCandidateStats => {
-): LearnedSemanticCandidateStats => {
   const candidateIdSet = new Set (candidateIds)
   const positiveIds = new Set<number> ()
   const negativeIds = new Set<number> ()
@@ -915,8 +901,7 @@ const learnedSemanticQuestionIsEffectiveForCandidateIds = (
       question }: {
 	candidateIds:  number[]
 	posts:         Post[]
-	question:      GekanatorQuestion },
+	question:      GekanatorQuestion }): boolean => {
-): boolean => {
   if (!(isUserSuggestedLearnedSemanticQuestion (question)))
     return false
 
@@ -936,8 +921,7 @@ const learnedSemanticQuestionIsEffectiveForCandidateIds = (
 
 const directSemanticAnswerForPost = (
     question:  GekanatorQuestion,
-    post:      Post,
+    post:      Post): GekanatorAnswerValue | null => {
-): GekanatorAnswerValue | null => {
   const direct = question.exampleAnswers?.[String (post.id) as `${ number }`]
   if (direct)
     return direct
@@ -956,8 +940,7 @@ const learnedSemanticLearningValueForTopPosts = (
 	question:      GekanatorQuestion
 	learningTargetPosts: Post[]
 	candidateIds:  number[]
-	posts:         Post[] },
+	posts:         Post[] }): { missingTopCount: number
-): { missingTopCount: number
      knownCount:      number
      hasLearningValue: boolean } => {
   const missingTopCount =
@@ -1000,8 +983,7 @@ const learningTargetPostsForCandidates = ({
 
 
 const questionPurposeCountsFor = (
-    answers:  GekanatorAnswerLog[],
+    answers:  GekanatorAnswerLog[]): {
-): {
     effectiveUserSuggestedCount: number
     learningUserSuggestedCount:  number
     normalQuestionCount:         number
@@ -1041,8 +1023,7 @@ const questionPurposeCountsFor = (
 
 const learnedSemanticNarrowPenaltyForStats = (
     candidateCount:  number,
-    stats:           LearnedSemanticCandidateStats,
+    stats:           LearnedSemanticCandidateStats): number => {
-): number => {
   const minSide = candidateCount < 10 ? 1 : Math.max (3, candidateCount * .08)
   return stats.positiveCount < minSide || stats.negativeCount < minSide ? .15 : 0
 }
@@ -1050,8 +1031,7 @@ const learnedSemanticNarrowPenaltyForStats = (
 
 const learnedSemanticScoreDeltaForExpectedAnswer = (
     userAnswer:      GekanatorAnswerValue,
-    expectedAnswer:  GekanatorAnswerValue | null,
+    expectedAnswer:  GekanatorAnswerValue | null): number => {
-): number => {
   switch (userAnswer)
   {
   case 'yes':
@@ -1089,8 +1069,7 @@ const learnedSemanticScoreDeltaForExpectedAnswer = (
 const scoreDropDeltaForRecoveredPost = (
     postId:                   number,
     totalScore:               number,
-    recoveredCandidatePosts:  Map<number, RecoveredCandidateState>,
+    recoveredCandidatePosts:  Map<number, RecoveredCandidateState>): number => {
-): number => {
   const recoveredCandidate = recoveredCandidatePosts.get (postId)
   if (recoveredCandidate == null)
     return totalScore
@@ -1114,8 +1093,7 @@ const postPassesScoreDrop = (
       recoveredCandidatePosts }: {
 	postId:                   number
 	scores:                   Map<number, number>
-	recoveredCandidatePosts:  Map<number, RecoveredCandidateState> },
+	recoveredCandidatePosts:  Map<number, RecoveredCandidateState> }): boolean => {
-): boolean => {
   if (!(activeCandidateScoreDropEnabled (scores)))
     return true
 
@@ -1129,8 +1107,7 @@ const postPassesScoreDrop = (
 
 // `post_similarities` is the score-propagation graph, not the question kind.
 const questionUsesPostSimilarityPropagationGraphForScoring = (
-    question:  GekanatorQuestion,
+    question:  GekanatorQuestion): boolean =>
-): boolean =>
     (question.kind === 'post_similarity'
      && !(isUserSuggestedLearnedSemanticQuestion (question)))
       || (question.kind === 'tag'
@@ -1139,8 +1116,7 @@ const questionUsesPostSimilarityPropagationGraphForScoring = (
 
 
 const questionSupportsAnswerBasedHardFiltering = (
-    question:  GekanatorQuestion,
+    question:  GekanatorQuestion): boolean => !(questionUsesPostSimilarityPropagationGraphForScoring (question))
-): boolean => !(questionUsesPostSimilarityPropagationGraphForScoring (question))
     && !(isUserSuggestedLearnedSemanticQuestion (question))
 
 
@@ -1160,8 +1136,7 @@ const usesLearnedTagExamples = (question: GekanatorQuestion): boolean =>
 
 const searchedQuestionsFor = (
     questions:  GekanatorQuestion[],
-    search:     string,
+    search:     string): GekanatorQuestion[] => {
-): GekanatorQuestion[] => {
   const needle = search.trim ()
   if (!(needle))
     return []
@@ -1235,8 +1210,7 @@ type QuestionMatchResolver = {
 
 const buildGekanatorMatchIndex = (
     posts:      Post[],
-    questions:  GekanatorQuestion[],
+    questions:  GekanatorQuestion[]): GekanatorMatchIndex => new Map (
-): GekanatorMatchIndex => new Map (
     questions.map (question => [
 	question.id,
 	new Set (
@@ -1285,8 +1259,7 @@ const matchingPostIdsForQuestion = ({
 
 
 const positiveMatchingPostIdsForQuestion = (
-    resolver:  QuestionMatchResolver,
+    resolver:  QuestionMatchResolver): Set<number> => {
-): Set<number> => {
   if (isUserSuggestedLearnedSemanticQuestion (resolver.question))
     {
       const cached = resolver.dynamicMatchIndex?.get (resolver.question.id)
@@ -1356,8 +1329,7 @@ const matchingWeightInCandidates = (
 			     materialIndex:       GekanatorQuestionMaterialIndex
 			     matchIndex:          GekanatorMatchIndex
 			     question:            GekanatorQuestion
-			     dynamicMatchIndex?:  GekanatorMatchIndex },
+			     dynamicMatchIndex?:  GekanatorMatchIndex }): number => {
-): number => {
   const matched = positiveMatchingPostIdsForQuestion ({
       posts,
       materialIndex,
@@ -1380,8 +1352,7 @@ const signatureForCandidateIds = (
 			      materialIndex:      GekanatorQuestionMaterialIndex
 			      matchIndex:         GekanatorMatchIndex
 			      question:           GekanatorQuestion
-			      dynamicMatchIndex?: GekanatorMatchIndex },
+			      dynamicMatchIndex?: GekanatorMatchIndex }): string => {
-): string => {
   if (isUserSuggestedLearnedSemanticQuestion (question))
     {
       const postById = new Map (posts.map (post => [post.id, post]))
@@ -1421,8 +1392,7 @@ const postIdsForHardAnswer = (
 			     posts:               Post[]
 			     materialIndex:       GekanatorQuestionMaterialIndex
 			     matchIndex:          GekanatorMatchIndex
-			     dynamicMatchIndex?:  GekanatorMatchIndex },
+			     dynamicMatchIndex?:  GekanatorMatchIndex }): number[] => {
-): number[] => {
   if (!(questionSupportsAnswerBasedHardFiltering (question)))
     return candidateIds
 
@@ -1562,8 +1532,7 @@ const buildIndexedQuestion = (
 	text:           string
 	kind:           GekanatorQuestionKind
 	priorityWeight: number
-	materialIndex:  GekanatorQuestionMaterialIndex },
+	materialIndex:  GekanatorQuestionMaterialIndex }): GekanatorQuestion => ({
-): GekanatorQuestion => ({
     id: questionIdForCondition (condition),
     text,
     kind,
@@ -1578,8 +1547,7 @@ const buildIndexedQuestion = (
 const rankedEntriesForCounts = <T extends string | number> (
     { counts, total, cap }: { counts:  Map<T, number>
 			      total:   number
-    			      cap:     number },
+    			      cap:     number }): [T, number][] =>
-): [T, number][] =>
     ([...counts.entries ()]
      .filter (([, count]) => count > 0 && count < total)
      .sort ((a, b) => Math.abs (total / 2 - a[1]) - Math.abs (total / 2 - b[1]))
@@ -1594,8 +1562,7 @@ const buildQuestionsForCandidateIds = (
 				     materialIndex:     GekanatorQuestionMaterialIndex
 				     acceptedQuestions: GekanatorQuestion[]
 				     mode?:            QuestionBuildMode
-				     confirmationPostId?: number | null },
+				     confirmationPostId?: number | null }): GekanatorQuestion[] => {
-): GekanatorQuestion[] => {
   const total = candidateIds.length
   const confirmationPost = (() => {
     if (confirmationPostId == null)
@@ -1652,8 +1619,7 @@ const buildQuestionsForCandidateIds = (
       condition: Extract<
 	  GekanatorQuestionCondition,
 	  { type: 'original-year' | 'original-month' | 'original-month-day' }
-      >,
+      >): GekanatorQuestion => {
-  ): GekanatorQuestion => {
     const priorityWeight = (() => {
       if (condition.type === 'original-year')
 	return 1.04
@@ -1673,8 +1639,7 @@ const buildQuestionsForCandidateIds = (
   const specialMonthDays = rankedEntriesForCounts ({
       counts: monthDayCounts,
       total,
-      cap: factCap
+      cap: factCap}).filter (([monthDay]) => specialOriginalMonthDayLabelFor (String (monthDay)) != null)
-  }).filter (([monthDay]) => specialOriginalMonthDayLabelFor (String (monthDay)) != null)
 
   if (mode === 'split')
     {
@@ -2124,8 +2089,7 @@ type ExclusiveConditionGroup =
 
 
 const exclusiveConditionGroupFor = (
-    condition:  GekanatorQuestion['condition'],
+    condition:  GekanatorQuestion['condition']): ExclusiveConditionGroup | null => {
-): ExclusiveConditionGroup | null => {
   switch (condition.type)
   {
   case 'original-month':
@@ -2144,8 +2108,7 @@ const exclusiveConditionGroupFor = (
 
 const sameConditionValue = (
     left:   GekanatorQuestion['condition'],
-    right:  GekanatorQuestion['condition'],
+    right:  GekanatorQuestion['condition']): boolean => {
-): boolean => {
   const leftTitleLength = titleLengthMinimumForCondition (left)
   const rightTitleLength = titleLengthMinimumForCondition (right)
   if (leftTitleLength != null || rightTitleLength != null)
@@ -2187,8 +2150,7 @@ const sameConditionValue = (
 
 const isMonthCrossMatch = (
     candidate:  GekanatorQuestion['condition'],
-    previous:   GekanatorQuestion['condition'],
+    previous:   GekanatorQuestion['condition']): boolean => {
-): boolean => {
   const candidateMonth = monthForCondition (candidate)
   const previousMonth = monthForCondition (previous)
   if (candidateMonth == null || previousMonth == null)
@@ -2204,8 +2166,7 @@ const isMonthCrossMatch = (
 
 const isExclusiveContradiction = (
     candidate:  GekanatorQuestion['condition'],
-    previous:   GekanatorQuestion['condition'],
+    previous:   GekanatorQuestion['condition']): boolean => {
-): boolean => {
   const candidateGroup = exclusiveConditionGroupFor (candidate)
   const previousGroup = exclusiveConditionGroupFor (previous)
 
@@ -2242,16 +2203,14 @@ const contradictionPenaltyFor = ({
     case 'no':
       if (
 	  sameConditionValue (question.condition, previous)
-	  || isMonthCrossMatch (question.condition, previous)
+	  || isMonthCrossMatch (question.condition, previous))
-      )
 	return sum + 40
 
       return sum
     case 'probably_no':
       if (
 	  sameConditionValue (question.condition, previous)
-	  || isMonthCrossMatch (question.condition, previous)
+	  || isMonthCrossMatch (question.condition, previous))
-      )
 	return sum + 20
 
       return sum
@@ -2281,8 +2240,7 @@ const chooseQuestion = (
 		      recentFirstQuestionPenaltyById: Map<string, number>
 		      userPriorWeights: Map<number, number>
 		      materialIndex: GekanatorQuestionMaterialIndex
-		      matchIndex: GekanatorMatchIndex },
+		      matchIndex: GekanatorMatchIndex }): QuestionSelection | null => {
-): QuestionSelection | null => {
   const dynamicMatchIndex = new Map<string, Set<number>> ()
 
   const invertedSignature = (signature: string): string =>
@@ -2327,8 +2285,7 @@ const chooseQuestion = (
   const rank = (
       questionsToRank:    GekanatorQuestion[],
       candidates:         { post: Post; score: number }[],
-      weightedCandidates: { post: Post; score: number; weight: number }[],
+      weightedCandidates: { post: Post; score: number; weight: number }[]) => {
-  ) => {
     const redundant = redundantSignatures (candidates.map (item => item.post))
     const candidateById = new Map (candidates.map (item => [item.post.id, item.post]))
     const candidateIds = candidates.map (item => item.post.id)
@@ -2613,8 +2570,7 @@ const chooseQuestion = (
   if (
 	effectiveRatio < targetEffectiveUserSuggestedQuestionRatio
 	&& totalUserSuggestedRatio < targetTotalUserSuggestedQuestionRatio
-	&& effectiveUserSuggestedPool.length > 0
+	&& effectiveUserSuggestedPool.length > 0)
-  )
     {
       selectedPool = effectiveUserSuggestedPool
       selectedPurpose = 'effective_user_suggested'
@@ -2622,8 +2578,7 @@ const chooseQuestion = (
   else if (
 	learningRatio < targetLearningUserSuggestedQuestionRatio
 	&& totalUserSuggestedRatio < targetTotalUserSuggestedQuestionRatio
-	&& learningUserSuggestedPool.length > 0
+	&& learningUserSuggestedPool.length > 0)
-  )
     {
       selectedPool = learningUserSuggestedPool
       selectedPurpose = 'learning_user_suggested'
@@ -2683,8 +2638,7 @@ const chooseQuestion = (
 
 
 const winningRunPriorityFor = (
-    expected:    GekanatorAnswerValue,
+    expected:    GekanatorAnswerValue): number | null => {
-): number | null => {
   if (expected === 'yes')
     return 0
   if (expected === 'partial')
@@ -2719,8 +2673,7 @@ const chooseWinningRunQuestion = ({
       materialIndex,
       acceptedQuestions,
       mode: 'confirmation',
-      confirmationPostId: targetPost.id
+      confirmationPostId: targetPost.id})
-  })
       .filter (question => {
 	if (askedIds.has (question.id))
 	  return false
@@ -2829,8 +2782,7 @@ const chooseFallbackQuestion = ({
 	  materialIndex,
 	  acceptedQuestions: [],
 	  mode: 'confirmation',
-	  confirmationPostId: post.id
+	  confirmationPostId: post.id})))
-      })))
       .slice (0, 32)
   const dynamicMatchIndex = new Map<string, Set<number>> ()
   const ranked = mergeQuestions ([
@@ -2905,8 +2857,7 @@ const chooseFallbackQuestion = ({
 
 
 const shouldEnterGuessPhase = (
-    reason: GuessReason | null,
+    reason: GuessReason | null): reason is 'hard_max_questions' | 'winning_run_finished' | 'question_count_checkpoint' =>
-): reason is 'hard_max_questions' | 'winning_run_finished' | 'question_count_checkpoint' =>
     (reason === 'hard_max_questions'
      || reason === 'winning_run_finished'
      || reason === 'question_count_checkpoint')
@@ -2914,15 +2865,13 @@ const shouldEnterGuessPhase = (
 
 const isWinningRunActive = (
     winningRunTargetId:         number | null,
-    winningRunStartAnswerCount: number | null,
+    winningRunStartAnswerCount: number | null): boolean =>
-): boolean =>
     winningRunTargetId != null && winningRunStartAnswerCount != null
 
 
 const winningRunQuestionCount = (
     answers:                    GekanatorAnswerLog[],
-    winningRunStartAnswerCount: number | null,
+    winningRunStartAnswerCount: number | null): number => {
-): number => {
   if (winningRunStartAnswerCount == null)
     return 0
 
@@ -2962,8 +2911,7 @@ const nextQuestionPlanFor = (
     				      matchIndex: GekanatorMatchIndex
     				      lastGuessQuestionCount: number
     				      winningRunTargetId: number | null
-    				      winningRunStartAnswerCount: number | null },
+    				      winningRunStartAnswerCount: number | null }): { question: GekanatorQuestion | null
-): { question: GekanatorQuestion | null
      guess: Post | null
      guessReason: GuessReason | null
      questionMode: QuestionMode
@@ -3013,8 +2961,7 @@ const nextQuestionPlanFor = (
     if (
 	isWinningRunActive (winningRunTargetId, winningRunStartAnswerCount)
 	&& winningRunTargetId === nextWinningRunTargetId
-	&& winningRunStartAnswerCount != null
+	&& winningRunStartAnswerCount != null)
-    )
       return winningRunStartAnswerCount
 
     return answers.length
@@ -3188,8 +3135,7 @@ const mascotStateFor = (
     resultWon:             boolean | null,
     eligiblePostCount:     number,
     bestConfidencePercent: number,
-    winningRunActive:      boolean,
+    winningRunActive:      boolean): MascotState => {
-): MascotState => {
   const resultPhase =
       phase === 'end'
       || phase === 'review'
@@ -3210,13 +3156,11 @@ const mascotStateFor = (
     if (
 	winningRunActive
 	|| eligiblePostCount <= 2
-	|| bestConfidencePercent >= 70
+	|| bestConfidencePercent >= 70)
-    )
       return 'thinking_near'
     if (
 	eligiblePostCount >= 15
-	&& bestConfidencePercent < 45
+	&& bestConfidencePercent < 45)
-    )
       return 'thinking_far'
     return 'thinking_mid'
   case 'guess':
@@ -3327,8 +3271,7 @@ const GekanatorBackdrop: FC<{
 
   const settingsForMode = useCallback (
       (
-	  mode: 'normal' | 'winning_run' | 'guess',
+	  mode: 'normal' | 'winning_run' | 'guess'): { columns: number; rows: number; opacity: number } => {
-      ): { columns: number; rows: number; opacity: number } => {
 	if (mode === 'winning_run' || mode === 'guess')
 	  return { columns: 8, rows: 8, opacity: motionMode === 'calm' ? .18 : .24 }
 
@@ -3342,8 +3285,7 @@ const GekanatorBackdrop: FC<{
   const scaleForMode = useCallback (
       (
 	  mode:                    'normal' | 'winning_run' | 'guess',
-	  displayedWinningCount:   number,
+	  displayedWinningCount:   number): number => {
-      ): number => {
 	if (mode === 'guess')
 	  return 8
 
@@ -3355,8 +3297,7 @@ const GekanatorBackdrop: FC<{
       [])
 
   const postsForMode = useCallback ((
-      mode: 'normal' | 'winning_run' | 'guess',
+      mode: 'normal' | 'winning_run' | 'guess'): Post[] => {
-  ): Post[] => {
     if (mode === 'guess' && displayedGuess)
       return [displayedGuess]
     if (mode === 'winning_run' && winningRunTargetPost)
@@ -3366,8 +3307,7 @@ const GekanatorBackdrop: FC<{
 
   const thumbnailsForMode = useCallback ((
       mode:      'normal' | 'winning_run' | 'guess',
-      count:     number,
+      count:     number): string[] => {
-  ): string[] => {
     const modePosts = postsForMode (mode)
     if (modePosts.length === 0)
       return []
@@ -3734,8 +3674,7 @@ const GekanatorBackdrop: FC<{
 
 const expectedAnswerFor = (
     question:     GekanatorQuestion | undefined,
-    correctPost:  Post | null,
+    correctPost:  Post | null): GekanatorAnswerValue | null =>
-): GekanatorAnswerValue | null =>
     expectedAnswerForQuestion (question, correctPost)
 
 
@@ -4169,8 +4108,7 @@ const GekanatorPage: FC<{ user: User | null }> = ({ user }) => {
 	setSaved (true)
 	setSavedGameId (data.id)
 	setLearnedExampleCount (data.learnedExampleCount)
-	setResultWon (variables.guessedPostId === variables.correctPostId)
+	setResultWon (variables.guessedPostId === variables.correctPostId)}})
-      }})
   const questionSuggestionMutation = useMutation ({
       mutationFn: saveGekanatorQuestionSuggestion,
       onSuccess: async data => {
@@ -4180,15 +4118,13 @@ const GekanatorPage: FC<{ user: User | null }> = ({ user }) => {
 	setQuestionSuggestionSearch ('')
 	setQuestionSuggestionSelectedId (null)
 	setQuestionSuggestion ('')
-	setQuestionSuggestionAnswer ('yes')
+	setQuestionSuggestionAnswer ('yes')}})
-      }})
   const extraQuestionAnswersMutation = useMutation ({
       mutationFn: saveGekanatorExtraQuestionAnswers,
       onSuccess: async () => {
 	await queryClient.refetchQueries ({ queryKey: gekanatorKeys.questions () })
 	setExtraQuestionState ('saved')
-	setPhase ('end')
+	setPhase ('end')}})
-      }})
 
   const resetExtraQuestionState = () => {
     const next = resettableExtraQuestionState ()
@@ -4330,8 +4266,7 @@ const GekanatorPage: FC<{ user: User | null }> = ({ user }) => {
       if (
 	  !(allowPreQuestionRecovery)
 	  || recoveredEligiblePosts.length === 0
-	  || recoveredEligiblePosts.length === 1
+	  || recoveredEligiblePosts.length === 1)
-      )
 	return false
 
       const nextQuestion = chooseQuestion ({
@@ -4493,8 +4428,7 @@ const GekanatorPage: FC<{ user: User | null }> = ({ user }) => {
     if (
 	!(nextPlan.question)
 	&& !(shouldEnterGuessPhase (nextPlan.guessReason))
-	&& recovered.eligiblePosts.length !== 1
+	&& recovered.eligiblePosts.length !== 1)
-    )
       {
 	const recoveredForQuestion = recoverQuestionState ({
 	    nextAnswers,
@@ -4602,8 +4536,7 @@ const GekanatorPage: FC<{ user: User | null }> = ({ user }) => {
 	!(canPersistGame)
 	|| reviewGuessedPostId == null
 	|| reviewCorrectPostId == null
-	|| saveMutation.isPending
+	|| saveMutation.isPending)
-    )
       return
 
     if (savedGameId != null)
@@ -4666,8 +4599,7 @@ const GekanatorPage: FC<{ user: User | null }> = ({ user }) => {
 	!(canPersistGame)
 	|| savedGameId == null
 	|| extraQuestionAnswersMutation.isPending
-	|| extraQuestions.some (question => !(extraQuestionAnswers[String (question.id)]))
+	|| extraQuestions.some (question => !(extraQuestionAnswers[String (question.id)])))
-    )
       return
 
     extraQuestionAnswersMutation.mutate ({
@@ -4870,8 +4802,7 @@ const GekanatorPage: FC<{ user: User | null }> = ({ user }) => {
 
   const answerExtraQuestion = (
       questionId:  number,
-      value:       GekanatorAnswerValue,
+      value:       GekanatorAnswerValue) => {
-  ) => {
     setExtraQuestionAnswers ({
 	...extraQuestionAnswers,
 	[String (questionId)]: value })
@@ -4909,8 +4840,7 @@ const GekanatorPage: FC<{ user: User | null }> = ({ user }) => {
 	|| isLoading
 	|| acceptedQuestionsLoading
 	|| shouldEnterGuessPhase (questionPlan.guessReason)
-	|| eligiblePosts.length === 1
+	|| eligiblePosts.length === 1)
-    )
       return
 
     const recovered = recoverQuestionState ({
@@ -4926,8 +4856,7 @@ const GekanatorPage: FC<{ user: User | null }> = ({ user }) => {
     if (
 	recovered.recoveryStepCount === recoveryStepCount
 	&& recovered.recoveredCandidatePosts.size === recoveredCandidatePosts.size
-	&& recovered.softenedQuestionIds.size === softenedQuestionIds.size
+	&& recovered.softenedQuestionIds.size === softenedQuestionIds.size)
-    )
       return
 
     setSoftenedQuestionIds (recovered.softenedQuestionIds)
@@ -4954,15 +4883,13 @@ const GekanatorPage: FC<{ user: User | null }> = ({ user }) => {
     if (
 	phase !== 'question'
 	|| isLoading
-	|| acceptedQuestionsLoading
+	|| acceptedQuestionsLoading)
-    )
       return
 
     if (
 	currentQuestion
 	|| !(questionPlan.guess)
-	|| !(shouldEnterGuessPhase (questionPlan.guessReason))
+	|| !(shouldEnterGuessPhase (questionPlan.guessReason)))
-    )
       return
 
     setWinningRunTargetId (questionPlan.winningRunTargetId)

frontend/src/pages/deerjikists/DeerjikistDetailPage.tsx

@@ -145,8 +145,7 @@ const DeerjikistDetailPage: FC = () => {
 				  return rtn
 				})}/>)}
 		      </FormField>
-		    </fieldset>
+		    </fieldset>))}
-		))}
 
 		<div className="py-3">
 		  <button
@@ -169,8 +168,7 @@ const DeerjikistDetailPage: FC = () => {
 		  </button>
 		</div>
 	      </form>
-	    </div>
+	    </div>)}
-	)}
       </MainArea>)
 }
 

frontend/src/pages/materials/MaterialDetailPage.test.tsx

@@ -7,9 +7,9 @@ import { buildMaterial, buildTag } from '@/test/factories'
 import { renderWithProviders } from '@/test/render'
 
 const api = vi.hoisted (() => ({
-  apiGet: vi.fn (),
+  apiGet:     vi.fn (),
-  apiPatch: vi.fn (),
+  apiPut:     vi.fn (),
-  apiPut: vi.fn (),
+  isApiError: vi.fn (),
 }))
 
 const wikiApi = vi.hoisted (() => ({
@@ -35,7 +35,11 @@ const renderPage = () =>
 describe ('MaterialDetailPage', () => {
   beforeEach (() => {
     vi.clearAllMocks ()
-    api.apiGet.mockResolvedValue ([])
+    api.apiGet.mockImplementation (async (path: string) =>
+      path === '/tags/autocomplete'
+      ? []
+      : buildMaterial ({ id: 8 }))
+    api.isApiError.mockReturnValue (false)
     wikiApi.fetchWikiPages.mockResolvedValue ([])
     vi.stubGlobal ('fetch', vi.fn (async () => ({
       blob: async () => new Blob (['image'], { type: 'image/png' }),
@@ -86,4 +90,22 @@ describe ('MaterialDetailPage', () => {
     expect (formData.get ('export_paths[legacy_drive]')).toBe ('素材/new.png')
     expect (toastApi.toast).toHaveBeenCalledWith ({ title: '更新成功!' })
   })
+
+  it ('shows not found when material API returns 404', async () => {
+    api.isApiError.mockReturnValue (true)
+    api.apiGet.mockRejectedValueOnce ({ response: { status: 404 } })
+
+    renderPage ()
+
+    expect (await screen.findByText ('素材が見つかりませんでした．')).toBeInTheDocument ()
+  })
+
+  it ('shows an error for non-404 material API failures', async () => {
+    api.isApiError.mockReturnValue (false)
+    api.apiGet.mockRejectedValueOnce (new Error ('network error'))
+
+    renderPage ()
+
+    expect (await screen.findByText ('素材の取得に失敗しました．')).toBeInTheDocument ()
+  })
 })

frontend/src/pages/materials/MaterialDetailPage.tsx

@@ -1,3 +1,4 @@
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
 import { useEffect, useState } from 'react'
 import { Helmet } from 'react-helmet-async'
 import { useParams } from 'react-router-dom'
@@ -13,156 +14,130 @@ import MainArea from '@/components/layout/MainArea'
 import { Button } from '@/components/ui/button'
 import { toast } from '@/components/ui/use-toast'
 import { SITE_TITLE } from '@/config'
-import { apiGet, apiPatch, apiPut } from '@/lib/api'
+import {
+    fetchMaterial,
+    updateMaterial,
+} from '@/lib/materials'
+import { materialsKeys } from '@/lib/queryKeys'
 import { inputClass } from '@/lib/utils'
 import { useValidationErrors } from '@/lib/useValidationErrors'
 
 import type { FC } from 'react'
 
-import type { Material, Tag, User } from '@/types'
-
-type MaterialWithTag = Material & { tag: Tag }
-
 type MaterialFormField = 'tag' | 'file' | 'url' | 'exportPaths'
 
 
-const MaterialDetailPage: FC<{ user: User | null }> = ({ user }) => {
+const MaterialDetailPage: FC = () => {
   const { id } = useParams ()
+  const qc = useQueryClient ()
 
   const [exportPath, setExportPath] = useState ('')
   const [file, setFile] = useState<File | null> (null)
   const [filePreview, setFilePreview] = useState ('')
-  const [loading, setLoading] = useState (false)
-  const [material, setMaterial] = useState<MaterialWithTag | null> (null)
-  const [sending, setSending] = useState (false)
   const [tag, setTag] = useState ('')
   const [url, setURL] = useState ('')
   const { baseErrors, fieldErrors, clearValidationErrors, applyValidationError } =
       useValidationErrors<MaterialFormField> ()
 
-  const handleSubmit = async () => {
+  const { data: material, isError, isLoading } = useQuery ({
-    clearValidationErrors ()
+      queryKey: materialsKeys.show (id ?? ''),
-
+      queryFn:  () => fetchMaterial (id ?? ''),
-    const formData = new FormData
+      enabled:  id != null})
-    if (tag.trim ())
+  const materialTitle = material
-      formData.append ('tag', tag)
+      ? material.tag?.name ?? `素材 #${ material.id }`
-    if (file)
+      : ''
-      formData.append ('file', file)
-    if (url.trim ())
-      formData.append ('url', url)
-    formData.append ('export_paths[legacy_drive]', exportPath)
-
-    try
-    {
-      setSending (true)
-      const data = await apiPut<Material> (`/materials/${ id }`, formData)
-      setMaterial (data)
-      toast ({ title: '更新成功!' })
-    }
-    catch (e)
-    {
-      applyValidationError (e)
-      toast ({ title: '更新失敗……', description: '入力を見直してください．' })
-    }
-    finally
-    {
-      setSending (false)
-    }
-  }
-
-  const handleSuppress = async () => {
-    const reason = window.prompt ('抑止理由を入力してください。')
-    if (reason == null || reason.trim () === '')
-      return
-    if (!window.confirm ('素材ファイルを抑止します。表示と ZIP export から除外されます。'))
-      return
-
-    try
-    {
-      const data = await apiPatch<Material> (
-	  `/materials/${ id }/suppress_file`,
-	  { reason },
-      )
-      setMaterial (data)
-      setFile (null)
-      setFilePreview ('')
-      toast ({ title: '抑止しました' })
-    }
-    catch
-    {
-      toast ({ title: '抑止に失敗しました' })
-    }
-  }
 
   useEffect (() => {
-    if (!(id))
+    if (!(material))
       return
 
-    void (async () => {
+    setTag (material.tag?.name ?? '')
-      try
+    setURL (material.url ?? '')
+    setExportPath (material.exportPaths.legacyDrive ?? '')
+    if (material.file && material.contentType)
       {
-	setLoading (true)
+	setFilePreview (material.file)
-	const data = await apiGet<MaterialWithTag> (`/materials/${ id }`)
+	setFile (null)
-	setMaterial (data)
-	setTag (data.tag.name)
-	if (data.file && data.contentType)
-	  {
-	    setFilePreview (data.file)
-	    setFile (null)
-	  }
-	setURL (data.url ?? '')
-	setExportPath (data.exportPaths.legacyDrive ?? '')
       }
-      finally
+  }, [material])
-      {
+
-	setLoading (false)
+  const invalidateMaterialQueries = async () => {
-      }
+    await qc.invalidateQueries ({ queryKey: materialsKeys.root })
-    }) ()
+  }
-  }, [id])
+
+  const updateMutation = useMutation ({
+      mutationFn: async () => {
+	const formData = new FormData
+	if (tag.trim ())
+	  formData.append ('tag', tag)
+	if (file)
+	  formData.append ('file', file)
+	if (url.trim ())
+	  formData.append ('url', url)
+	formData.append ('export_paths[legacy_drive]', exportPath)
+
+	return await updateMaterial (id ?? '', formData)
+      },
+      onSuccess: async data => {
+	qc.setQueryData (materialsKeys.show (id ?? ''), data)
+	await invalidateMaterialQueries ()
+	toast ({ title: '更新成功!' })
+      },
+      onError: error => {
+	applyValidationError (error)
+	toast ({ title: '更新失敗……', description: '入力を見直してください．' })
+      }})
+
+  const handleSubmit = () => {
+    clearValidationErrors ()
+    updateMutation.mutate ()
+  }
 
   return (
       <MainArea>
 	{material && (
 	    <Helmet>
-	      <title>{`${ material.tag.name } 素材照会 | ${ SITE_TITLE }`}</title>
+	      <title>{`${ materialTitle } 素材照会 | ${ SITE_TITLE }`}</title>
 	    </Helmet>)}
 
-	{loading ? 'Loading...' : (material && (
+	{isLoading ? 'Loading...' : isError ? (
+	    <p className="text-red-600 dark:text-red-300">
+	      素材の取得に失敗しました．
+	    </p>) : material == null ? (
+	    <p className="text-stone-700 dark:text-stone-300">
+	      素材が見つかりませんでした．
+	    </p>) : (
 	    <>
 	      <PageTitle>
-		<TagLink
+		{material.tag
-		    tag={material.tag}
+		 ? (
-		    withWiki={false}
+		    <TagLink
-		    withCount={false}/>
+			tag={material.tag}
+			withWiki={false}
+			withCount={false}/>)
+		 : materialTitle}
 	      </PageTitle>
 
-	      {material.fileSuppressedAt && (
+	      {(material.file && material.contentType) && (
-		  <div className="mb-4 rounded border border-red-300 bg-red-50 p-3 text-red-700">
-		    <span>素材ファイルは抑止済みです。</span>
-		    {material.fileSuppressionReason && (
-			<span> 理由: {material.fileSuppressionReason}</span>)}
-		  </div>)}
-
-	      {(!material.fileSuppressedAt && material.file && material.contentType) && (
 		  (/image\/.*/.test (material.contentType) && (
-		      <img src={material.file} alt={material.tag.name || undefined}/>))
+		      <img src={material.file} alt={material.tag?.name || undefined}/>))
 		  || (/video\/.*/.test (material.contentType) && (
 		      <video src={material.file} controls/>))
 		  || (/audio\/.*/.test (material.contentType) && (
 		      <audio src={material.file} controls/>)))}
 
 	      <TabGroup>
-		<Tab name="Wiki">
+		{material.tag && (
-		  <WikiBody
+		    <Tab name="Wiki">
-		      title={material.tag.name}
+		      <WikiBody
-		      body={material.wikiPageBody ?? undefined}/>
+			  title={material.tag.name}
-		</Tab>
+			  body={material.wikiPageBody ?? undefined}/>
+		    </Tab>)}
 
 		<Tab name="編輯">
-		  <div className="max-w-wl pt-2 space-y-4">
+		  <div className="max-w-wl space-y-4 pt-2">
 		    <FieldError messages={baseErrors}/>
 
-		    {/* タグ */}
 		    <FormField label="タグ" messages={fieldErrors.tag}>
 		      {({ describedBy, invalid }) => (
 			  <TagInput
@@ -172,7 +147,6 @@ const MaterialDetailPage: FC<{ user: User | null }> = ({ user }) => {
 			      setValue={setTag}/>)}
 		    </FormField>
 
-		    {/* ファイル */}
 		    <FormField label="ファイル" messages={fieldErrors.file}>
 		      {({ describedBy, invalid }) => (
 			  <>
@@ -182,9 +156,10 @@ const MaterialDetailPage: FC<{ user: User | null }> = ({ user }) => {
 				aria-describedby={describedBy}
 				aria-invalid={invalid}
 				onChange={e => {
-				  const f = e.target.files?.[0]
+				  const nextFile = e.target.files?.[0]
-				  setFile (f ?? null)
+				  setFile (nextFile ?? null)
-				  setFilePreview (f ? URL.createObjectURL (f) : '')
+				  setFilePreview (
+				      nextFile ? URL.createObjectURL (nextFile) : '')
 				}}/>
 			    {(file && filePreview) && (
 				(/image\/.*/.test (file.type) && (
@@ -209,7 +184,6 @@ const MaterialDetailPage: FC<{ user: User | null }> = ({ user }) => {
 			  </>)}
 		    </FormField>
 
-		    {/* 参考 URL */}
 		    <FormField label="参考 URL" messages={fieldErrors.url}>
 		      {({ describedBy, invalid }) => (
 			  <input
@@ -221,9 +195,7 @@ const MaterialDetailPage: FC<{ user: User | null }> = ({ user }) => {
 			      className={inputClass (invalid)}/>)}
 		    </FormField>
 
-		    <FormField
+		    <FormField label="ZIP 出力パス" messages={fieldErrors.exportPaths}>
-			label="ZIP 出力パス"
-			messages={fieldErrors.exportPaths}>
 		      {({ describedBy, invalid }) => (
 			  <input
 			      type="text"
@@ -235,26 +207,19 @@ const MaterialDetailPage: FC<{ user: User | null }> = ({ user }) => {
 			      className={inputClass (invalid)}/>)}
 		    </FormField>
 
-		    {/* 送信 */}
 		    <div className="flex flex-wrap gap-2">
 		      <Button
 			  onClick={handleSubmit}
-			  className="px-4 py-2 bg-blue-600 text-white rounded disabled:bg-gray-400"
+			  className="rounded bg-blue-600 px-4 py-2 text-white
-			  disabled={sending}>
+				     disabled:bg-gray-400"
+			  disabled={updateMutation.isPending}>
 			更新
 		      </Button>
-		      {user?.role === 'admin' && !material.fileSuppressedAt && (
-			  <Button
-			      type="button"
-			      variant="destructive"
-			      onClick={handleSuppress}>
-			    ファイルを抑止
-			  </Button>)}
 		    </div>
 		  </div>
 		</Tab>
 	      </TabGroup>
-	    </>))}
+	    </>)}
       </MainArea>)
 }
 

frontend/src/pages/materials/MaterialHistoryPage.tsx

@@ -0,0 +1,189 @@
+import { useQuery } from '@tanstack/react-query'
+import { useEffect, useState } from 'react'
+import { Helmet } from 'react-helmet-async'
+import { useLocation, useNavigate } from 'react-router-dom'
+
+import PrefetchLink from '@/components/PrefetchLink'
+import FormField from '@/components/common/FormField'
+import PageTitle from '@/components/common/PageTitle'
+import Pagination from '@/components/common/Pagination'
+import MainArea from '@/components/layout/MainArea'
+import { SITE_TITLE } from '@/config'
+import { fetchMaterialChanges } from '@/lib/materials'
+import { materialsKeys } from '@/lib/queryKeys'
+import { dateString, inputClass } from '@/lib/utils'
+
+import type { FC, FormEvent } from 'react'
+
+
+const MaterialHistoryPage: FC = () => {
+  const location = useLocation ()
+  const navigate = useNavigate ()
+  const query = new URLSearchParams (location.search)
+
+  const materialId = query.get ('material_id') ?? ''
+  const tag = query.get ('tag') ?? ''
+  const eventType = query.get ('event_type') ?? ''
+  const page = Number (query.get ('page') ?? 1)
+  const limit = Number (query.get ('limit') ?? 20)
+
+  const [materialIdInput, setMaterialIdInput] = useState (materialId)
+  const [tagInput, setTagInput] = useState (tag)
+  const [eventTypeInput, setEventTypeInput] = useState (eventType)
+
+  useEffect (() => {
+    setMaterialIdInput (materialId)
+    setTagInput (tag)
+    setEventTypeInput (eventType)
+  }, [eventType, materialId, tag])
+
+  const { data, isLoading, isError } = useQuery ({
+      queryKey: materialsKeys.changes ({
+	  ...(materialId && { materialId }),
+	  ...(tag && { tag }),
+	  ...(eventType && { eventType }),
+	  page,
+	  limit }),
+      queryFn: () => fetchMaterialChanges ({
+	  ...(materialId && { materialId }),
+	  ...(tag && { tag }),
+	  ...(eventType && { eventType }),
+	  page,
+	  limit }) })
+
+  const versions = data?.versions ?? []
+  const totalPages = data ? Math.ceil (data.count / limit) : 0
+
+  useEffect (() => {
+    document.querySelector ('table')?.scrollIntoView ({ behavior: 'smooth' })
+  }, [location.search])
+
+  const handleSearch = (event: FormEvent) => {
+    event.preventDefault ()
+
+    const qs = new URLSearchParams ()
+    if (materialIdInput.trim ())
+      qs.set ('material_id', materialIdInput.trim ())
+    if (tagInput.trim ())
+      qs.set ('tag', tagInput.trim ())
+    if (eventTypeInput.trim ())
+      qs.set ('event_type', eventTypeInput.trim ())
+    qs.set ('page', '1')
+    qs.set ('limit', String (limit))
+    navigate (`/materials/changes?${ qs.toString () }`)
+  }
+
+  return (
+      <MainArea>
+	<Helmet>
+	  <title>{`素材履歴 | ${ SITE_TITLE }`}</title>
+	</Helmet>
+
+	<div className="space-y-5">
+	  <PageTitle>素材履歴</PageTitle>
+
+	  <form
+	      onSubmit={handleSearch}
+	      className="max-w-3xl rounded-lg border border-stone-200 bg-white p-4
+			 text-stone-900 dark:border-stone-700 dark:bg-stone-900
+			 dark:text-stone-100">
+	    <div className="space-y-3">
+	      <FormField label="素材 ID">
+		{({ invalid }) => (
+		    <input
+			type="text"
+			value={materialIdInput}
+			onChange={e => setMaterialIdInput (e.target.value)}
+			className={inputClass (invalid)}/>)}
+	      </FormField>
+
+	      <FormField label="タグ名">
+		{({ invalid }) => (
+		    <input
+			type="text"
+			value={tagInput}
+			onChange={e => setTagInput (e.target.value)}
+			className={inputClass (invalid)}/>)}
+	      </FormField>
+	    </div>
+
+	    <button
+		type="submit"
+		className="mt-4 rounded-full border border-stone-300 bg-white px-4 py-2
+			   text-sm text-stone-900 hover:bg-stone-100 dark:border-stone-700
+			   dark:bg-stone-900 dark:text-stone-100 dark:hover:bg-stone-800">
+	      絞り込む
+	    </button>
+	  </form>
+
+	  {isLoading
+	   ? 'Loading...'
+	   : isError
+	   ? (
+	      <p className="text-red-600 dark:text-red-300">
+		素材履歴の取得に失敗しました．
+	      </p>)
+	   : (
+	      <>
+		<div className="overflow-x-auto">
+		  <table className="w-full min-w-[1200px] table-fixed border-collapse">
+		    <colgroup>
+		      <col className="w-48"/>
+		      <col className="w-28"/>
+		      <col className="w-24"/>
+		      <col className="w-64"/>
+		      <col className="w-64"/>
+		      <col className="w-80"/>
+		      <col className="w-80"/>
+		      <col className="w-48"/>
+		    </colgroup>
+
+		    <thead className="border-b-2 border-black dark:border-white">
+		      <tr>
+			<th className="p-2 text-left">日時</th>
+			<th className="p-2 text-left">素材 ID</th>
+			<th className="p-2 text-left">版</th>
+			<th className="p-2 text-left">タグ名</th>
+			<th className="p-2 text-left">ファイル名</th>
+			<th className="p-2 text-left">URL</th>
+			<th className="p-2 text-left">export_path</th>
+			<th className="p-2 text-left">操作者</th>
+		      </tr>
+		    </thead>
+
+		    <tbody>
+		      {versions.map (version => (
+			  <tr
+			      key={version.id}
+			      className="even:bg-gray-100 dark:even:bg-gray-700">
+			    <td className="p-2">{dateString (version.createdAt)}</td>
+			    <td className="p-2">
+			      <PrefetchLink to={`/materials/${ version.materialId }`}>
+				#{version.materialId}
+			      </PrefetchLink>
+			    </td>
+			    <td className="p-2">{version.versionNo}</td>
+			    <td className="p-2 break-all">{version.tagName}</td>
+			    <td className="p-2 break-all">{version.fileFilename}</td>
+			    <td className="p-2 break-all">{version.url}</td>
+			    <td className="p-2 break-all">
+			      {version.exportPathsJson.legacy_drive}
+			    </td>
+			    <td className="p-2">
+			      {version.createdByUser
+			       ? version.createdByUser.name || `#${ version.createdByUser.id }`
+			       : 'bot 操作'}
+			    </td>
+			  </tr>))}
+		    </tbody>
+		  </table>
+		</div>
+
+		<Pagination page={page} totalPages={totalPages}/>
+	      </>)}
+	</div>
+      </MainArea>)
+}
+
+
+export default MaterialHistoryPage

frontend/src/pages/materials/MaterialListPage.test.tsx

@@ -1,5 +1,5 @@
-import { screen, waitFor } from '@testing-library/react'
+import { fireEvent, screen, waitFor } from '@testing-library/react'
-import { describe, expect, it, vi } from 'vitest'
+import { beforeEach, describe, expect, it, vi } from 'vitest'
 
 import MaterialListPage from '@/pages/materials/MaterialListPage'
 import { buildMaterial, buildTag } from '@/test/factories'
@@ -12,51 +12,169 @@ const api = vi.hoisted (() => ({
 vi.mock ('@/lib/api', () => api)
 
 describe ('MaterialListPage', () => {
-  it ('shows the empty selection guide without a tag query', () => {
+  beforeEach (() => {
-    renderWithProviders (<MaterialListPage/>, { route: '/materials' })
+    vi.clearAllMocks ()
-
+    api.apiGet.mockResolvedValue ({ materials: [], count: 0 })
-    expect (screen.getByText ('左のリストから照会したいタグを選択してください。')).toBeInTheDocument ()
-    expect (screen.getByRole ('link', { name: '素材を新規追加する' })).toHaveAttribute (
-        'href',
-        '/materials/new',
-    )
   })
 
-  it ('loads materials for a tag query', async () => {
+  it ('loads the material index on the initial page', async () => {
-    const tag = {
+    renderWithProviders (<MaterialListPage/>, { route: '/materials' })
-      ...buildTag ({
-        id:       4,
-        name:     '素材タグ',
-        category: 'material',
-      }),
-      material: buildMaterial ({ id: 8, contentType: 'image/png', file: 'image.png' }),
-      children: [],
-    }
-    api.apiGet.mockResolvedValueOnce (tag)
-
-    renderWithProviders (<MaterialListPage/>, { route: '/materials?tag=%E7%B4%A0%E6%9D%90' })
 
     await waitFor (() => {
       expect (api.apiGet).toHaveBeenCalledWith (
-          '/tags/name/%E7%B4%A0%E6%9D%90/materials',
+          '/materials',
+          { params: {
+              tag_state:  'all',
+              media_kind: 'all',
+              sort:       'created_at',
+              direction:  'desc',
+              page:       1,
+              limit:      20,
+          } },
       )
     })
-    expect (await screen.findByRole ('link', { name: '素材タグ' })).toBeInTheDocument ()
+    expect (await screen.findByText ('素材はありません。')).toBeInTheDocument ()
-    expect (screen.getByRole ('link', { name: '' })).toHaveAttribute ('href', '/materials/8')
   })
 
-  it ('offers adding a missing non-meme material', async () => {
+  it ('shows materials in the default card view', async () => {
     api.apiGet.mockResolvedValueOnce ({
-      ...buildTag ({ name: '未登録', category: 'material' }),
+      materials: [
-      material: null,
+        buildMaterial ({
-      children: [],
+          id:          8,
+          tag:         buildTag ({ name: '素材タグ', category: 'material' }),
+          thumbnail:   'thumb.png',
+          mediaKind:   'image',
+          contentType: 'image/png',
+        }),
+      ],
+      count: 1,
     })
 
-    renderWithProviders (<MaterialListPage/>, { route: '/materials?tag=x' })
+    renderWithProviders (<MaterialListPage/>, { route: '/materials' })
 
-    expect (await screen.findByRole ('link', { name: '追加' })).toHaveAttribute (
+    expect ((await screen.findByText ('素材タグ')).closest ('a'))
+      .toHaveAttribute ('href', '/materials/8')
+    expect (screen.getByText (/画像 \/ 令和8年1月2日/)).toBeInTheDocument ()
+  })
+
+  it ('submits list filters as material index params', async () => {
+    renderWithProviders (<MaterialListPage/>, { route: '/materials' })
+
+    fireEvent.change (screen.getByPlaceholderText ('タグ名 / URL / ファイル名'), {
+      target: { value: '虹夏' },
+    })
+    const selects = screen.getAllByRole ('combobox')
+    fireEvent.change (selects[0], {
+      target: { value: 'untagged' },
+    })
+    fireEvent.change (selects[1], {
+      target: { value: 'image' },
+    })
+    fireEvent.click (screen.getByRole ('button', { name: '検索' }))
+
+    await waitFor (() => {
+      expect (api.apiGet).toHaveBeenCalledWith (
+          '/materials',
+          expect.objectContaining ({ params: expect.objectContaining ({
+            q:          '虹夏',
+            tag_state:  'untagged',
+            media_kind: 'image',
+          }) }),
+      )
+    })
+  })
+
+  it ('keeps a route back to the material search top for untagged materials', async () => {
+    renderWithProviders (
+        <MaterialListPage/>,
+        { route: '/materials?tag_state=untagged&material_filter=any' },
+    )
+
+    expect (await screen.findByRole (
+        'link',
+        { name: '素材検索トップへ戻る' },
+    )).toHaveAttribute ('href', '/materials?material_filter=any')
+  })
+
+  it ('uses list view for detailed material rows', async () => {
+    api.apiGet.mockResolvedValueOnce ({
+      materials: [
+        buildMaterial ({
+          id:           9,
+          tag:          buildTag ({ name: '詳細素材', category: 'material' }),
+          mediaKind:    'file_other',
+          fileByteSize: 2048,
+        }),
+      ],
+      count: 1,
+    })
+
+    renderWithProviders (<MaterialListPage/>, { route: '/materials?view=list' })
+
+    expect (await screen.findByRole ('link', { name: '詳細素材' })).toHaveAttribute (
         'href',
-        '/materials/new?tag=%E6%9C%AA%E7%99%BB%E9%8C%B2',
+        '/materials/9',
+    )
+    expect (screen.getByText ('サイズ:')).toBeInTheDocument ()
+    expect (screen.getByText ('2.0 KB')).toBeInTheDocument ()
+  })
+
+  it ('shows the selected tag scope and tag-specific add links', async () => {
+    api.apiGet.mockResolvedValueOnce ({
+      materials: [
+        buildMaterial ({
+          id:  10,
+          tag: buildTag ({ id: 30, name: '泣き', category: 'material' }),
+        }),
+      ],
+      count:    1,
+      tagScope: {
+        tag:                { id: 20, name: '伊地知ニジカ', category: 'material' },
+        includeDescendants: true,
+      },
+      groups: [
+        {
+          key:         'tag:30',
+          tag:         { id: 30, name: '泣き', category: 'material' },
+          materialIds: [10],
+          count:       1,
+        },
+      ],
+    })
+
+    renderWithProviders (
+        <MaterialListPage/>,
+        { route: '/materials?tag_id=20&include_descendants=1&group_by=parent_tag' },
+    )
+
+    expect (await screen.findByText (
+        (_, element) => element?.textContent === '伊地知ニジカ 配下の素材を表示中',
+    )).toBeInTheDocument ()
+
+    expect (screen.getByRole ('link', { name: '泣き' })).toHaveAttribute (
+        'href',
+        '/materials?tag_id=30&include_descendants=1&group_by=parent_tag&material_filter=present',
+    )
+    expect (screen.getByRole ('link', { name: 'タグ選択を解除' })).toHaveAttribute (
+        'href',
+        '/materials?material_filter=present',
+    )
+  })
+
+  it ('shows a clear link when tag_id does not resolve to tag_scope', async () => {
+    api.apiGet.mockResolvedValueOnce ({
+      materials: [],
+      count:     0,
+      tagScope:  null,
+      groups:    [],
+    })
+
+    renderWithProviders (<MaterialListPage/>, { route: '/materials?tag_id=999' })
+
+    expect (await screen.findByText ('選択中タグが見つかりません．')).toBeInTheDocument ()
+    expect (screen.getByRole ('link', { name: 'タグ選択を解除' })).toHaveAttribute (
+        'href',
+        '/materials?material_filter=present',
     )
   })
 })

frontend/src/pages/materials/MaterialListPage.tsx

@@ -1,80 +1,395 @@
-import { Fragment, useEffect, useState } from 'react'
+import { useQuery } from '@tanstack/react-query'
+import { useEffect, useMemo, useState } from 'react'
 import { Helmet } from 'react-helmet-async'
-import { useLocation } from 'react-router-dom'
+import { useLocation, useNavigate } from 'react-router-dom'
 
 import nikumaru from '@/assets/fonts/nikumaru.otf'
 import PrefetchLink from '@/components/PrefetchLink'
-import TagLink from '@/components/TagLink'
+import DateTimeField from '@/components/common/DateTimeField'
+import FormField from '@/components/common/FormField'
 import PageTitle from '@/components/common/PageTitle'
-import SectionTitle from '@/components/common/SectionTitle'
+import Pagination from '@/components/common/Pagination'
-import SubsectionTitle from '@/components/common/SubsectionTitle'
 import MainArea from '@/components/layout/MainArea'
-import { API_BASE_URL, SITE_TITLE } from '@/config'
+import { SITE_TITLE } from '@/config'
-import { apiGet } from '@/lib/api'
+import { fetchMaterials, parseMaterialFilter } from '@/lib/materials'
+import { materialsKeys } from '@/lib/queryKeys'
+import { dateString, inputClass } from '@/lib/utils'
 
-import type { FC } from 'react'
+import type { FC, FormEvent } from 'react'
 
-import type { Material, Tag } from '@/types'
+import type { FetchMaterialsParams,
+	      Material,
+	      MaterialFilter,
+	      MaterialIndexGroup,
+	      MaterialIndexGroupBy,
+	      MaterialIndexDirection,
+	      MaterialIndexMediaKind,
+	      MaterialIndexSort,
+	      MaterialIndexTagState,
+	      MaterialIndexView } from '@/types'
 
-type TagWithMaterial = Omit<Tag, 'children'> & {
+const MEDIA_KIND_LABELS: Record<Material['mediaKind'], string> = {
-    children: TagWithMaterial[]
+    image:      '画像',
-    material: Material | null }
+    video:      '動画',
+    audio:      '音声',
+    file_other: 'その他ファイル',
+    url_only:   'URL のみ'}
+
+const MEDIA_FILTER_LABELS: Record<MaterialIndexMediaKind, string> = {
+    all:        'すべて',
+    image:      '画像',
+    video:      '動画',
+    audio:      '音声',
+    file_other: 'その他ファイル',
+    url_only:   '外部リンクのみ'}
+
+const SORT_LABELS: Record<MaterialIndexSort, string> = {
+    created_at:     '作成日時',
+    updated_at:     '更新日時',
+    tag_name:       'タグ名',
+    media_kind:     '種類',
+    file_byte_size: '容量',
+    version_no:     '版',
+    id:             'Id.'}
 
 
-const MaterialCard = ({ tag }: { tag: TagWithMaterial }) => {
+const setIf = (qs: URLSearchParams, key: string, value: string | null) => {
-  if (!(tag.material))
+  const next = value?.trim ()
-    return
+  if (next)
-
+    qs.set (key, next)
-  return (
-      <PrefetchLink
-	  to={`/materials/${ tag.material.id }`}
-	  className="block w-40 h-40">
-	<div
-	    className={`w-full h-full overflow-hidden rounded-xl shadow
-			text-center content-center text-4xl ${
-			tag.material.fileSuppressedAt
-			? 'border-2 border-red-300 bg-red-50 text-base text-red-700'
-			: '' }`}
-	    style={{ fontFamily: 'Nikumaru' }}>
-	  {tag.material.fileSuppressedAt
-	   ? <span>抑止済み</span>
-	   : (tag.material.contentType && /image\/.*/.test (tag.material.contentType))
-	   ? <img src={tag.material.file || undefined}/>
-	   : <span>照会</span>}
-	</div>
-      </PrefetchLink>)
 }
 
 
-const MaterialListPage: FC = () => {
+const parseOption = <T extends string> (
-  const [loading, setLoading] = useState (false)
+    value: string | null,
-  const [tag, setTag] = useState<TagWithMaterial | null> (null)
+    allowed: readonly T[],
+    fallback: T): T => allowed.includes (value as T) ? value as T : fallback
 
+
+const fileSizeText = (bytes: number | null): string => {
+  if (bytes == null)
+    return ''
+  if (bytes < 1024)
+    return `${ bytes } B`
+  if (bytes < 1024 * 1024)
+    return `${ (bytes / 1024).toFixed (1) } KB`
+  return `${ (bytes / 1024 / 1024).toFixed (1) } MB`
+}
+
+
+const materialTitle = (material: Material): string =>
+    material.tag?.name ?? `素材 #${ material.id }`
+
+
+const groupedTagPath = (
+    tagId: number,
+    materialFilter: MaterialFilter,
+): string =>
+    `/materials?tag_id=${ tagId }&include_descendants=1&group_by=parent_tag`
+    + `&material_filter=${ materialFilter }`
+
+
+const materialNewPath = (
+    tagName: string,
+    returnTo: string,
+): string =>
+    `/materials/new?tag=${ encodeURIComponent (tagName) }`
+    + `&return_to=${ encodeURIComponent (returnTo) }`
+
+
+const clearedTagSelectionPath = (
+    locationSearch: string,
+    materialFilter: MaterialFilter,
+): string => {
+    const qs = new URLSearchParams (locationSearch)
+    qs.delete ('tag_id')
+    qs.delete ('include_descendants')
+    qs.delete ('group_by')
+    qs.delete ('page')
+    qs.set ('material_filter', materialFilter)
+    return `/materials?${ qs.toString () }`
+}
+
+
+const MaterialThumb: FC<{ material: Material }> = ({ material }) => (
+    <div
+	className={`flex aspect-square h-[180px] w-[180px] items-center justify-center
+		    overflow-hidden rounded-lg border border-stone-200 bg-white text-center
+		    text-stone-900 shadow-sm dark:border-stone-700 dark:bg-stone-900
+		    dark:text-stone-100`}>
+      {material.thumbnail
+       ? <img src={material.thumbnail} alt="" className="block h-full w-full object-cover"/>
+       : (
+	  <span
+	      className="px-2 text-2xl leading-tight"
+	      style={{ fontFamily: material.thumbnailFallbackKind === 'tag_name'
+		  ? 'Nikumaru'
+		  : undefined }}>
+	    {material.thumbnailFallbackText}
+	  </span>)}
+    </div>)
+
+
+const MaterialCard: FC<{ material: Material }> = ({ material }) => (
+    <article className="w-[180px] justify-self-center">
+      <PrefetchLink to={`/materials/${ material.id }`} className="block">
+	<MaterialThumb material={material}/>
+	<div className="mt-2 w-[180px]">
+	  <p className="truncate text-sm font-medium text-stone-900 dark:text-stone-100">
+	    {materialTitle (material)}
+	  </p>
+	  <p className="truncate text-xs text-stone-600 dark:text-stone-300">
+	    {MEDIA_KIND_LABELS[material.mediaKind]} / {dateString (material.createdAt)}
+	  </p>
+	</div>
+      </PrefetchLink>
+    </article>)
+
+
+const MaterialListItem: FC<{ material: Material }> = ({ material }) => (
+    <article
+	className="rounded-lg border border-stone-200 bg-white p-3 text-stone-900
+		   shadow-sm dark:border-stone-700 dark:bg-stone-900 dark:text-stone-100">
+      <div className="flex gap-3">
+	<MaterialThumb material={material}/>
+	<div className="min-w-0 flex-1 space-y-2">
+	  <div>
+	    <PrefetchLink
+		to={`/materials/${ material.id }`}
+		className="font-medium text-sky-700 underline underline-offset-2
+			   dark:text-sky-300">
+	      {materialTitle (material)}
+	    </PrefetchLink>
+	  </div>
+	  <dl className="space-y-1 text-sm text-stone-600 dark:text-stone-300">
+	    <div>
+	      <dt className="inline">種類: </dt>
+	      <dd className="inline">{MEDIA_KIND_LABELS[material.mediaKind]}</dd>
+	    </div>
+	    {material.fileByteSize != null && (
+		<div>
+		  <dt className="inline">サイズ: </dt>
+		  <dd className="inline">{fileSizeText (material.fileByteSize)}</dd>
+		</div>)}
+	    {material.url && (
+		<div>
+		  <dt className="inline">URL: </dt>
+		  <dd className="inline break-all">{material.url}</dd>
+		</div>)}
+	    <div>
+	      <dt className="inline">作成: </dt>
+	      <dd className="inline">{dateString (material.createdAt)}</dd>
+	    </div>
+	  </dl>
+	</div>
+      </div>
+    </article>)
+
+
+const GroupHeading: FC<{
+    count:          number
+    materialFilter: MaterialFilter
+    title:          string
+    tagId:          number
+}> = ({ count, materialFilter, title, tagId }) => (
+    <div className="flex items-center gap-2 border-b border-stone-200 pb-2
+		    dark:border-stone-700">
+      <PrefetchLink
+	  to={groupedTagPath (tagId, materialFilter)}
+	  className="font-medium text-sky-700 underline underline-offset-2
+		     dark:text-sky-300 w-full">
+	{title}
+      </PrefetchLink>
+      <div className="text-right w-auto">
+	<span className="text-nowrap text-sm text-stone-600 dark:text-stone-300">
+	  {count} 件
+	</span>
+      </div>
+    </div>)
+
+
+const MaterialListPage: FC = () => {
   const location = useLocation ()
-  const query = new URLSearchParams (location.search)
+  const navigate = useNavigate ()
-  const tagQuery = query.get ('tag') ?? ''
+  const query = useMemo (() => new URLSearchParams (location.search), [location.search])
+  const materialFilter = parseMaterialFilter (query.get ('material_filter'), 'present')
+
+  const page = Number (query.get ('page') ?? 1)
+  const limit = Number (query.get ('limit') ?? 20)
+  const qQuery = query.get ('q') ?? ''
+  const tagIdQuery = Number (query.get ('tag_id') ?? 0)
+  const tagId = tagIdQuery > 0 ? tagIdQuery : null
+  const includeDescendants = query.get ('include_descendants') === '1'
+  const tagState = query.get ('unclassified') === '1'
+      ? 'untagged'
+      : parseOption<MaterialIndexTagState> (
+	  query.get ('tag_state'),
+	  ['all', 'tagged', 'untagged'],
+	  'all')
+  const mediaKind = parseOption<MaterialIndexMediaKind> (
+      query.get ('media_kind'),
+      ['all', 'image', 'video', 'audio', 'file_other', 'url_only'],
+      'all')
+  const sort = parseOption<MaterialIndexSort> (
+      query.get ('sort'),
+      ['created_at', 'updated_at', 'tag_name', 'media_kind', 'file_byte_size',
+       'version_no', 'id'],
+      'created_at')
+  const direction = parseOption<MaterialIndexDirection> (
+      query.get ('direction'),
+      ['asc', 'desc'],
+      'desc')
+  const groupByQuery = parseOption<MaterialIndexGroupBy> (
+      query.get ('group_by'),
+      ['none', 'parent_tag'],
+      'none')
+  const groupBy = tagId == null ? 'none' : groupByQuery
+  const view = parseOption<MaterialIndexView> (query.get ('view'), ['card', 'list'], 'card')
+  const createdFromQuery = query.get ('created_from') ?? ''
+  const createdToQuery = query.get ('created_to') ?? ''
+  const updatedFromQuery = query.get ('updated_from') ?? ''
+  const updatedToQuery = query.get ('updated_to') ?? ''
+
+  const [q, setQ] = useState ('')
+  const [tagStateInput, setTagStateInput] = useState<MaterialIndexTagState> ('all')
+  const [mediaKindInput, setMediaKindInput] = useState<MaterialIndexMediaKind> ('all')
+  const [groupByInput, setGroupByInput] = useState<MaterialIndexGroupBy> ('none')
+  const [createdFrom, setCreatedFrom] = useState<string | null> (null)
+  const [createdTo, setCreatedTo] = useState<string | null> (null)
+  const [updatedFrom, setUpdatedFrom] = useState<string | null> (null)
+  const [updatedTo, setUpdatedTo] = useState<string | null> (null)
+
+  const keys: FetchMaterialsParams = {
+      q: qQuery,
+      tagState,
+      mediaKind,
+      tagId,
+      includeDescendants,
+      groupBy,
+      createdFrom: createdFromQuery,
+      createdTo: createdToQuery,
+      updatedFrom: updatedFromQuery,
+      updatedTo: updatedToQuery,
+      sort,
+      direction,
+      view,
+      page,
+      limit}
+  const { data, isLoading, isError } = useQuery ({
+      queryKey: materialsKeys.index (keys),
+      queryFn:  () => fetchMaterials (keys)})
+  const tagScope = data?.tagScope ?? null
+  const materials = data?.materials ?? []
+  const groups = data?.groups ?? []
+  const totalPages = data ? Math.ceil (data.count / limit) : 0
+  const materialsById = useMemo (
+      () => new Map (materials.map (material => [material.id, material])),
+      [materials],
+  )
+  const groupedMaterialIds = useMemo (
+      () => new Set (groups.flatMap (group => group.materialIds)),
+      [groups],
+  )
+  const ungroupedMaterials = useMemo (
+      () => materials.filter (material => !groupedMaterialIds.has (material.id)),
+      [groupedMaterialIds, materials],
+  )
 
   useEffect (() => {
-    if (!(tagQuery))
+    setQ (qQuery)
-      {
+    setTagStateInput (tagState)
-	setTag (null)
+    setMediaKindInput (mediaKind)
-	return
+    setGroupByInput (groupBy)
-      }
+    setCreatedFrom (createdFromQuery)
+    setCreatedTo (createdToQuery)
+    setUpdatedFrom (updatedFromQuery)
+    setUpdatedTo (updatedToQuery)
+  }, [createdFromQuery, createdToQuery, groupBy, mediaKind, qQuery, tagState,
+      updatedFromQuery, updatedToQuery])
 
-    void (async () => {
+  const search = (e: FormEvent) => {
-      try
+    e.preventDefault ()
-      {
+
-	setLoading (true)
+    const qs = new URLSearchParams ()
-	setTag (
+    setIf (qs, 'q', q)
-	    await apiGet<TagWithMaterial> (
+    qs.set ('tag_state', tagStateInput)
-		`/tags/name/${ encodeURIComponent (tagQuery) }/materials`))
+    qs.set ('media_kind', mediaKindInput)
-      }
+    setIf (qs, 'created_from', createdFrom)
-      finally
+    setIf (qs, 'created_to', createdTo)
-      {
+    setIf (qs, 'updated_from', updatedFrom)
-	setLoading (false)
+    setIf (qs, 'updated_to', updatedTo)
-      }
+    qs.set ('sort', sort)
-    }) ()
+    qs.set ('direction', direction)
-  }, [location.search, tagQuery])
+    qs.set ('group_by', tagId == null ? 'none' : groupByInput)
+    qs.set ('view', view)
+    qs.set ('page', '1')
+    qs.set ('limit', String (limit))
+    qs.set ('material_filter', materialFilter)
+    if (tagId != null)
+      qs.set ('tag_id', String (tagId))
+
+    if (includeDescendants)
+      qs.set ('include_descendants', '1')
+
+    navigate (`/materials?${ qs.toString () }`)
+  }
+
+  const updateQuery = (changes: Record<string, string>) => {
+    const qs = new URLSearchParams (location.search)
+    Object.entries (changes).forEach (([key, value]) => {
+      if (value === '')
+	qs.delete (key)
+      else
+	qs.set (key, value)
+    })
+    navigate (`/materials?${ qs.toString () }`)
+  }
+
+  const renderMaterialCollection = (rows: Material[]) =>
+      view === 'card'
+      ? (
+	  <div className="grid grid-cols-[repeat(auto-fill,minmax(196px,1fr))]
+			  justify-items-center gap-4">
+	    {rows.map (material => (
+		<MaterialCard key={material.id} material={material}/>))}
+	  </div>)
+      : (
+	  <div className="space-y-3">
+	    {rows.map (material => (
+		<MaterialListItem key={material.id} material={material}/>))}
+	  </div>)
+
+  const renderGroupedMaterials = (materialGroups: MaterialIndexGroup[]) => (
+      <div className="space-y-6">
+	{materialGroups.map (group => {
+	  const groupMaterials =
+	      group.materialIds
+	      .map (materialId => materialsById.get (materialId))
+	      .filter ((material): material is Material => material != null)
+
+	  if (groupMaterials.length === 0)
+	    return null
+
+	  return (
+	      <section key={group.key} className="space-y-3">
+		<GroupHeading
+		    tagId={group.tag.id}
+		    title={group.tag.name}
+		    count={group.count}
+		    materialFilter={materialFilter}/>
+		{renderMaterialCollection (groupMaterials)}
+	      </section>)
+	})}
+	{ungroupedMaterials.length > 0 && (
+	    <section className="space-y-3">
+	      <div className="border-b border-stone-200 pb-2 dark:border-stone-700">
+		<span className="font-medium text-stone-900 dark:text-stone-100">
+		  その他
+		</span>
+	      </div>
+	      {renderMaterialCollection (ungroupedMaterials)}
+	    </section>)}
+      </div>)
 
   return (
       <MainArea>
@@ -87,90 +402,205 @@ const MaterialListPage: FC = () => {
 		  src: url(${ nikumaru }) format('opentype');
 		}`}
 	  </style>
-	  <title>{`${ tag ? `${ tag.name } 素材集` : '素材集' } | ${ SITE_TITLE }`}</title>
+	  <title>{`素材管理 | ${ SITE_TITLE }`}</title>
 	</Helmet>
 
-	{loading ? 'Loading...' : (
+	<div className="space-y-5">
-	    tag
+	  <div className="flex flex-wrap items-center justify-between gap-3">
-	    ? (
+	    <PageTitle className="my-auto">素材管理</PageTitle>
-		<>
+	    <div className="flex flex-wrap gap-2">
-		  <PageTitle>
+	      {/* TODO: 局所出力を可能にする */}
-		    <TagLink
+	      {/* <a
-			tag={tag}
+		  href={`${ API_BASE_URL }/materials/download.zip?profile=legacy_drive`}
-			withWiki={false}
+		  target="_blank"
-			withCount={false}
+		  rel="noopener noreferrer"
-			to={tag.material
+		  className="rounded-full border border-stone-300 bg-white px-4 py-2 text-sm
-			    ? `/materials/${ tag.material.id }`
+			     text-stone-900 hover:bg-stone-100 dark:border-stone-700
-			    : `/materials?tag=${ encodeURIComponent (tag.name) }`}/>
+			     dark:bg-stone-900 dark:text-stone-100 dark:hover:bg-stone-800">
-		  </PageTitle>
+		ZIP をダウンロード
-		  {(!(tag.material) && tag.category !== 'meme') && (
+	      </a> */}
-		      <div className="-mt-2">
+	    </div>
-			<PrefetchLink
+	  </div>
-			    to={`/materials/new?tag=${ encodeURIComponent (tag.name) }`}>
-			  追加
-			</PrefetchLink>
-		      </div>)}
 
-		  <MaterialCard tag={tag}/>
+	  {tagScope && (
+	      <div className="flex flex-wrap items-center gap-3 rounded-lg border
+			      border-sky-200 bg-sky-50 px-4 py-3 text-sm text-sky-900
+			      dark:border-sky-800 dark:bg-sky-950 dark:text-sky-100">
+		<span>
+		  {tagScope.tag.name}
+		  {tagScope.includeDescendants ? ' 配下の素材を表示中' : ' の素材を表示中'}
+		</span>
+		<PrefetchLink
+		    to={clearedTagSelectionPath (location.search, materialFilter)}
+		    className="font-medium underline underline-offset-2
+			       text-sky-700 dark:text-sky-300">
+		  タグ選択を解除
+		</PrefetchLink>
+	      </div>)}
+	  {(tagId != null && tagScope == null) && (
+	      <div className="flex flex-wrap items-center gap-3 rounded-lg border
+			      border-amber-200 bg-amber-50 px-4 py-3 text-sm text-amber-900
+			      dark:border-amber-800 dark:bg-amber-950 dark:text-amber-100">
+		<span>選択中タグが見つかりません．</span>
+		<PrefetchLink
+		    to={clearedTagSelectionPath (location.search, materialFilter)}
+		    className="font-medium underline underline-offset-2
+			       text-amber-800 dark:text-amber-200">
+		  タグ選択を解除
+		</PrefetchLink>
+	      </div>)}
 
-		  <div className="ml-2 overflow-x-auto pb-2">
+	  {tagState === 'untagged' && (
-		    {tag.children.map (c2 => (
+	      <PrefetchLink
-			<Fragment key={c2.id}>
+		  to={`/materials?material_filter=${ materialFilter }`}
-			  <SectionTitle>
+		  className="text-sm text-sky-700 underline underline-offset-2 dark:text-sky-300">
-			    <TagLink
+		素材検索トップへ戻る
-				tag={c2}
+	      </PrefetchLink>)}
-				withWiki={false}
-				withCount={false}
-				to={`/materials?tag=${ encodeURIComponent (c2.name) }`}/>
-			  </SectionTitle>
-			  {(!(c2.material) && c2.category !== 'meme') && (
-			      <div className="-mt-4">
-				<PrefetchLink
-				    to={`/materials/new?tag=${ encodeURIComponent (c2.name) }`}>
-				  追加
-				</PrefetchLink>
-			      </div>)}
 
-			  <MaterialCard tag={c2}/>
+	  <form
+	      onSubmit={search}
+	      className="max-w-3xl rounded-lg border border-stone-200 bg-white p-4
+			 text-stone-900 dark:border-stone-700 dark:bg-stone-900
+			 dark:text-stone-100">
+	    <div className="space-y-3">
+	      <FormField label="検索">
+		{({ invalid }) => (
+		    <input
+			type="search"
+			value={q}
+			onChange={e => setQ (e.target.value)}
+			placeholder="タグ名 / URL / ファイル名"
+			className={inputClass (invalid)}/>)}
+	      </FormField>
 
-			  <div className="ml-2">
+	      <FormField label="タグ状態">
-			    {c2.children.map (c3 => (
+		{({ invalid }) => (
-				<Fragment key={c3.id}>
+		    <select
-				  <SubsectionTitle>
+			value={tagStateInput}
-				    <TagLink
+			onChange={e => setTagStateInput (
-					tag={c3}
+			    e.target.value as MaterialIndexTagState)}
-					withWiki={false}
+			className={inputClass (invalid)}>
-					withCount={false}
+		      <option value="all">すべて</option>
-					to={`/materials?tag=${ encodeURIComponent (c3.name) }`}/>
+		      <option value="tagged">タグあり</option>
-				  </SubsectionTitle>
+		      <option value="untagged">タグなし</option>
-				  {(!(c3.material) && c3.category !== 'meme') && (
+		    </select>)}
-				      <div className="-mt-2">
+	      </FormField>
-					<PrefetchLink
-					    to={`/materials/new?tag=${
-						encodeURIComponent (c3.name) }`}>
-					  追加
-					</PrefetchLink>
-				      </div>)}
 
-				  <MaterialCard tag={c3}/>
+	      <FormField label="メディア">
-				</Fragment>))}
+		{({ invalid }) => (
-			  </div>
+		    <select
-			</Fragment>))}
+			value={mediaKindInput}
-		  </div>
+			onChange={e => setMediaKindInput (
-		</>)
+			    e.target.value as MaterialIndexMediaKind)}
-	    : (
+			className={inputClass (invalid)}>
-		<>
+		      {Object.entries (MEDIA_FILTER_LABELS).map (([value, label]) => (
-		  <p>左のリストから照会したいタグを選択してください。</p>
+			  <option key={value} value={value}>
-		  <p>もしくは……</p>
+			    {label}
-		  <ul>
+			  </option>))}
-		    <li><PrefetchLink to="/materials/new">素材を新規追加する</PrefetchLink></li>
+		    </select>)}
-		    <li>
+	      </FormField>
-		      <a href={`${ API_BASE_URL }/materials/download.zip?profile=legacy_drive`}>
+
-			すべての素材をダウンロードする
+	      <FormField label="作成日時">
-		      </a>
+		{() => (
-		    </li>
+		    <div className="flex flex-wrap items-center gap-2">
-		  </ul>
+		      <DateTimeField value={createdFrom ?? undefined} onChange={setCreatedFrom}/>
-		</>))}
+		      <span>〜</span>
+		      <DateTimeField value={createdTo ?? undefined} onChange={setCreatedTo}/>
+		    </div>)}
+	      </FormField>
+
+	      <FormField label="更新日時">
+		{() => (
+		    <div className="flex flex-wrap items-center gap-2">
+		      <DateTimeField value={updatedFrom ?? undefined} onChange={setUpdatedFrom}/>
+		      <span>〜</span>
+		      <DateTimeField value={updatedTo ?? undefined} onChange={setUpdatedTo}/>
+		    </div>)}
+	      </FormField>
+	    </div>
+
+	    <div className="mt-4 flex flex-wrap gap-3">
+	      <button
+		  type="submit"
+		  className="rounded bg-sky-600 px-4 py-2 text-white hover:bg-sky-700
+			     dark:bg-sky-500 dark:text-stone-950 dark:hover:bg-sky-400">
+		検索
+	      </button>
+	    </div>
+	  </form>
+
+	  <div className="flex flex-wrap items-center justify-between gap-3">
+	    <div className="flex flex-wrap gap-2">
+	      <button
+		  type="button"
+		  onClick={() => updateQuery ({ view: 'card' })}
+		  className={`rounded-full border px-4 py-2 text-sm ${
+		      view === 'card'
+		      ? [
+			  'border-sky-500 bg-sky-50 text-sky-700 dark:border-sky-400',
+			  'dark:bg-sky-950 dark:text-sky-100'].join (' ')
+		      : [
+			  'border-stone-300 bg-white text-stone-900 dark:border-stone-700',
+			  'dark:bg-stone-900 dark:text-stone-100'].join (' ') }`}>
+		アイコン
+	      </button>
+	      <button
+		  type="button"
+		  onClick={() => updateQuery ({ view: 'list' })}
+		  className={`rounded-full border px-4 py-2 text-sm ${
+		      view === 'list'
+		      ? [
+			  'border-sky-500 bg-sky-50 text-sky-700 dark:border-sky-400',
+			  'dark:bg-sky-950 dark:text-sky-100'].join (' ')
+		      : [
+			  'border-stone-300 bg-white text-stone-900 dark:border-stone-700',
+			  'dark:bg-stone-900 dark:text-stone-100'].join (' ') }`}>
+		詳細
+	      </button>
+	    </div>
+
+	    <div className="flex flex-wrap items-center gap-2 text-sm">
+	      <select
+		  value={sort}
+		  onChange={e => updateQuery ({ sort: e.target.value, page: '1' })}
+		  className={inputClass (false, 'w-auto')}>
+		{Object.entries (SORT_LABELS).map (([value, label]) => (
+		    <option key={value} value={value}>
+		      {label}
+		    </option>))}
+	      </select>
+	      <select
+		  value={direction}
+		  onChange={e => updateQuery ({ direction: e.target.value, page: '1' })}
+		  className={inputClass (false, 'w-auto')}>
+		<option value="desc">降順</option>
+		<option value="asc">昇順</option>
+	      </select>
+	    </div>
+	  </div>
+
+	  {isLoading && <p>Loading...</p>}
+	  {isError && (
+	      <p className="text-red-600 dark:text-red-300">素材一覧の取得に失敗しました．</p>)}
+	  {(!isLoading && !isError && materials.length === 0) && (
+	      <p>
+		素材はありません。
+		{(tagScope && ['character', 'material'].includes (tagScope.tag.category)) && (
+		    <>
+		      <PrefetchLink
+			  to={materialNewPath (tagScope.tag.name, location.pathname + location.search)}
+			  className="font-medium underline underline-offset-2
+				     text-sky-700 dark:text-sky-300">
+			追加してください
+		      </PrefetchLink>。
+		    </>)}
+	      </p>)}
+	  {materials.length > 0 && (
+	      groupBy === 'parent_tag' && groups.length > 0
+	      ? renderGroupedMaterials (groups)
+	      : renderMaterialCollection (materials))}
+	  <Pagination page={page} totalPages={totalPages}/>
+	</div>
       </MainArea>)
 }
 

frontend/src/pages/materials/MaterialNewPage.test.tsx

@@ -1,5 +1,6 @@
 import { fireEvent, screen, waitFor } from '@testing-library/react'
 import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { Route, Routes, useLocation } from 'react-router-dom'
 
 import MaterialNewPage from '@/pages/materials/MaterialNewPage'
 import { renderWithProviders } from '@/test/render'
@@ -17,6 +18,11 @@ const toastApi = vi.hoisted (() => ({
 vi.mock ('@/lib/api', () => api)
 vi.mock ('@/components/ui/use-toast', () => toastApi)
 
+const LocationView = () => {
+  const location = useLocation ()
+  return <div>{location.pathname + location.search}</div>
+}
+
 describe ('MaterialNewPage', () => {
   beforeEach (() => {
     vi.clearAllMocks ()
@@ -69,4 +75,50 @@ describe ('MaterialNewPage', () => {
     expect (await screen.findAllByText ('ファイルまたは URL は必須です．')).toHaveLength (2)
     expect (screen.getAllByRole ('textbox')[1]).toHaveAttribute ('aria-invalid', 'true')
   })
+
+  it ('returns only to safe material URLs after successful creation', async () => {
+    api.apiPost.mockResolvedValueOnce ({})
+
+    renderWithProviders (
+        <Routes>
+          <Route path="/materials/new" element={<MaterialNewPage/>}/>
+          <Route path="/materials" element={<LocationView/>}/>
+        </Routes>,
+        {
+          route:
+              '/materials/new?tag=%E8%99%B9%E5%A4%8F'
+              + '&return_to=%2Fmaterials%3Ftag_id%3D20',
+        },
+    )
+
+    fireEvent.change (screen.getAllByRole ('textbox')[1], {
+      target: { value: 'https://example.com/ref' },
+    })
+    fireEvent.click (screen.getByRole ('button', { name: '追加' }))
+
+    expect (await screen.findByText ('/materials?tag_id=20')).toBeInTheDocument ()
+  })
+
+  it ('ignores unsafe return_to values after successful creation', async () => {
+    api.apiPost.mockResolvedValueOnce ({})
+
+    renderWithProviders (
+        <Routes>
+          <Route path="/materials/new" element={<MaterialNewPage/>}/>
+          <Route path="/materials" element={<LocationView/>}/>
+        </Routes>,
+        {
+          route:
+              '/materials/new?tag=%E8%99%B9%E5%A4%8F'
+              + '&return_to=https%3A%2F%2Fexample.com%2Fevil',
+        },
+    )
+
+    fireEvent.change (screen.getAllByRole ('textbox')[1], {
+      target: { value: 'https://example.com/ref' },
+    })
+    fireEvent.click (screen.getByRole ('button', { name: '追加' }))
+
+    expect (await screen.findByText ('/materials')).toBeInTheDocument ()
+  })
 })

frontend/src/pages/materials/MaterialNewPage.tsx

@@ -1,3 +1,4 @@
+import { useMutation, useQueryClient } from '@tanstack/react-query'
 import { useState } from 'react'
 import { Helmet } from 'react-helmet-async'
 import { useLocation, useNavigate } from 'react-router-dom'
@@ -11,7 +12,8 @@ import MainArea from '@/components/layout/MainArea'
 import { Button } from '@/components/ui/button'
 import { toast } from '@/components/ui/use-toast'
 import { SITE_TITLE } from '@/config'
-import { apiPost } from '@/lib/api'
+import { createMaterial } from '@/lib/materials'
+import { materialsKeys } from '@/lib/queryKeys'
 import { inputClass } from '@/lib/utils'
 import { useValidationErrors } from '@/lib/useValidationErrors'
 
@@ -21,49 +23,49 @@ type MaterialFormField = 'tag' | 'file' | 'url' | 'exportPaths'
 
 
 const MaterialNewPage: FC = () => {
+  const qc = useQueryClient ()
   const location = useLocation ()
   const query = new URLSearchParams (location.search)
   const tagQuery = query.get ('tag') ?? ''
+  const returnToQuery = query.get ('return_to') ?? ''
+  const safeReturnTo = returnToQuery.startsWith ('/materials') ? returnToQuery : ''
 
   const navigate = useNavigate ()
 
   const [file, setFile] = useState<File | null> (null)
   const [filePreview, setFilePreview] = useState ('')
-  const [sending, setSending] = useState (false)
   const [tag, setTag] = useState (tagQuery)
   const [url, setURL] = useState ('')
   const [exportPath, setExportPath] = useState ('')
   const { baseErrors, fieldErrors, clearValidationErrors, applyValidationError } =
       useValidationErrors<MaterialFormField> ()
 
-  const handleSubmit = async () => {
+  const createMutation = useMutation ({
+      mutationFn: async () => {
+	const formData = new FormData
+	if (tag)
+	  formData.append ('tag', tag)
+	if (file)
+	  formData.append ('file', file)
+	if (url)
+	  formData.append ('url', url)
+	formData.append ('export_paths[legacy_drive]', exportPath)
+
+	return await createMaterial (formData)
+      },
+      onSuccess: async () => {
+	await qc.invalidateQueries ({ queryKey: materialsKeys.root })
+	toast ({ title: '送信成功!' })
+	navigate (safeReturnTo || '/materials')
+      },
+      onError: error => {
+	applyValidationError (error)
+	toast ({ title: '送信失敗……', description: '入力を見直してください．' })
+      }})
+
+  const handleSubmit = () => {
     clearValidationErrors ()
-
+    createMutation.mutate ()
-    const formData = new FormData
-    if (tag)
-      formData.append ('tag', tag)
-    if (file)
-      formData.append ('file', file)
-    if (url)
-      formData.append ('url', url)
-    formData.append ('export_paths[legacy_drive]', exportPath)
-
-    try
-    {
-      setSending (true)
-      await apiPost ('/materials', formData)
-      toast ({ title: '送信成功!' })
-      navigate (`/materials?tag=${ encodeURIComponent (tag) }`)
-    }
-    catch (e)
-    {
-      applyValidationError (e)
-      toast ({ title: '送信失敗……', description: '入力を見直してください．' })
-    }
-    finally
-    {
-      setSending (false)
-    }
   }
 
   return (
@@ -153,7 +155,7 @@ const MaterialNewPage: FC = () => {
 	  <Button
 	      onClick={handleSubmit}
 	      className="px-4 py-2 bg-blue-600 text-white rounded disabled:bg-gray-400"
-	      disabled={sending}>
+	      disabled={createMutation.isPending}>
 	    追加
 	  </Button>
 	</Form>

frontend/src/pages/materials/MaterialSearchPage.tsx

@@ -1,51 +0,0 @@
-import { useState } from 'react'
-import { Helmet } from 'react-helmet-async'
-
-import FormField from '@/components/common/FormField'
-import PageTitle from '@/components/common/PageTitle'
-import TagInput from '@/components/common/TagInput'
-import MainArea from '@/components/layout/MainArea'
-import { SITE_TITLE } from '@/config'
-
-import type { FC, FormEvent } from 'react'
-
-
-const MaterialSearchPage: FC = () => {
-  const [tagName, setTagName] = useState ('')
-  const [parentTagName, setParentTagName] = useState ('')
-
-  const handleSearch = (e: FormEvent) => {
-    e.preventDefault ()
-  }
-
-  return (
-      <MainArea>
-	<Helmet>
-	  <title>素材集 | {SITE_TITLE}</title>
-	</Helmet>
-
-	<div className="max-w-xl">
-	  <PageTitle>素材集</PageTitle>
-
-	  <form onSubmit={handleSearch} className="space-y-2">
-	    {/* タグ */}
-	    <FormField label="タグ">
-	      {() => (
-		  <TagInput
-		      value={tagName}
-		      setValue={setTagName}/>)}
-	    </FormField>
-
-	    {/* 親タグ */}
-	    <FormField label="親タグ">
-	      {() => (
-		  <TagInput
-		      value={parentTagName}
-		      setValue={setParentTagName}/>)}
-	    </FormField>
-	  </form>
-	</div>
-      </MainArea>)
-}
-
-export default MaterialSearchPage

frontend/src/pages/materials/MaterialSyncSuppressionsPage.tsx

@@ -0,0 +1,202 @@
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
+import { useState } from 'react'
+import { Helmet } from 'react-helmet-async'
+
+import FormField from '@/components/common/FormField'
+import PageTitle from '@/components/common/PageTitle'
+import MainArea from '@/components/layout/MainArea'
+import { Button } from '@/components/ui/button'
+import { toast } from '@/components/ui/use-toast'
+import { SITE_TITLE } from '@/config'
+import { createMaterialSyncSuppression, fetchMaterialSyncSuppressions } from '@/lib/materials'
+import { materialsKeys } from '@/lib/queryKeys'
+import { dateString, inputClass } from '@/lib/utils'
+
+import type { FC, FormEvent } from 'react'
+
+import type { MaterialSyncSuppressionSourceKind } from '@/types'
+
+const SOURCE_KIND_LABELS: Record<MaterialSyncSuppressionSourceKind, string> = {
+    uri:               'URI',
+    google_drive_path: 'Google Drive ファイル',
+    google_drive_path_prefix: 'Google Drive フォルダ',
+    google_drive_file: 'Google Drive ファイル Id.',
+    legacy_drive_path: '汎用ファイル',
+    legacy_drive_path_prefix: '汎用フォルダ' }
+
+const REASONS = [
+    'copyright_high_risk',
+    'copyright_takedown',
+    'adult_or_sensitive',
+    'personal_information',
+    'malware_or_dangerous_file',
+    'duplicate_or_low_quality',
+    'source_owner_request',
+    'other'] as const
+
+type MaterialSyncSuppressionReason = typeof REASONS[number]
+
+const REASON_NAMES: Record<MaterialSyncSuppressionReason, string> = {
+    ['copyright_high_risk']: '著作権への懸念',
+    ['copyright_takedown']: '著作者からの申出',
+    ['adult_or_sensitive']: '成人向け',
+    ['personal_information']: '個人情報',
+    ['malware_or_dangerous_file']: '危険なソフトウェア',
+    ['duplicate_or_low_quality']: '重複',
+    ['source_owner_request']: '同期元管理者からの申出',
+    ['other']: 'その他' } as const
+
+
+const reasonName = (reason: string): string =>
+    REASON_NAMES[reason as MaterialSyncSuppressionReason] ?? reason
+
+
+const MaterialSyncSuppressionsPage: FC = () => {
+  const qc = useQueryClient ()
+  const [sourceKind, setSourceKind] =
+      useState<MaterialSyncSuppressionSourceKind> ('uri')
+  const [sourceUri, setSourceUri] = useState ('')
+  const [drivePath, setDrivePath] = useState ('')
+  const [driveFileId, setDriveFileId] = useState ('')
+  const [reason, setReason] = useState<MaterialSyncSuppressionReason> (REASONS[0])
+
+  const { data, isError, isLoading } = useQuery ({
+      queryKey: materialsKeys.suppressions (),
+      queryFn:  fetchMaterialSyncSuppressions})
+
+  const createMutation = useMutation ({
+      mutationFn: async () =>
+	  await createMaterialSyncSuppression ({
+	      sourceKind,
+	      sourceUri,
+	      drivePath,
+	      driveFileId,
+	      reason}),
+      onSuccess: async () => {
+	await qc.invalidateQueries ({ queryKey: materialsKeys.suppressions () })
+	await qc.invalidateQueries ({ queryKey: materialsKeys.root })
+	setSourceUri ('')
+	setDrivePath ('')
+	setDriveFileId ('')
+	toast ({ title: '同期元抑止を登録しました' })
+      },
+      onError: () => {
+	toast ({ title: '同期元抑止の登録に失敗しました' })
+      }})
+
+  const handleSubmit = (event: FormEvent) => {
+    event.preventDefault ()
+    createMutation.mutate ()
+  }
+
+  const suppressions = data?.suppressions ?? []
+
+  return (
+      <MainArea>
+	<Helmet>
+	  <title>{`素材同期抑止 | ${ SITE_TITLE }`}</title>
+	</Helmet>
+
+	<div className="space-y-5">
+	  <PageTitle>同期抑止</PageTitle>
+
+	  <form
+	      onSubmit={handleSubmit}
+	      className="max-w-3xl rounded-lg border border-stone-200 bg-white p-4
+			 text-stone-900 dark:border-stone-700 dark:bg-stone-900
+			 dark:text-stone-100">
+	    <div className="space-y-3">
+	      <FormField label="同期元種別">
+		{({ invalid }) => (
+		    <select
+			value={sourceKind}
+			onChange={e => setSourceKind (
+			    e.target.value as MaterialSyncSuppressionSourceKind)}
+			className={inputClass (invalid)}>
+		      {Object.entries (SOURCE_KIND_LABELS).map (([value, label]) => (
+			  <option key={value} value={value}>
+			    {label}
+			  </option>))}
+		    </select>)}
+	      </FormField>
+
+	      <FormField label="同期元 URI">
+		{({ invalid }) => (
+		    <input
+			type="text"
+			value={sourceUri}
+			onChange={e => setSourceUri (e.target.value)}
+			className={inputClass (invalid)}/>)}
+	      </FormField>
+
+	      <FormField label="Google Drive パス">
+		{({ invalid }) => (
+		    <input
+			type="text"
+			value={drivePath}
+			onChange={e => setDrivePath (e.target.value)}
+			className={inputClass (invalid)}/>)}
+	      </FormField>
+
+	      <FormField label="Google Drive ファイル Id.">
+		{({ invalid }) => (
+		    <input
+			type="text"
+			value={driveFileId}
+			onChange={e => setDriveFileId (e.target.value)}
+			className={inputClass (invalid)}/>)}
+	      </FormField>
+
+	      <FormField label="事由">
+		{({ invalid }) => (
+		    <select
+			value={reason}
+			onChange={e => setReason (e.target.value as MaterialSyncSuppressionReason)}
+			className={inputClass (invalid)}>
+		      {REASONS.map (value => (
+			  <option key={value} value={value}>
+			    {REASON_NAMES[value]}
+			  </option>))}
+		    </select>)}
+	      </FormField>
+	    </div>
+
+	    <Button
+		type="submit"
+		className="mt-4 rounded bg-blue-600 px-4 py-2 text-white
+			   disabled:bg-gray-400"
+		disabled={createMutation.isPending}>
+	      登録
+	    </Button>
+	  </form>
+
+	  {isLoading && <p>Loading...</p>}
+	  {isError && (
+	      <p className="text-red-600 dark:text-red-300">
+		同期元抑止一覧の取得に失敗しました．
+	      </p>)}
+
+	  <div className="space-y-3">
+	    {suppressions.map (suppression => (
+		<article
+		    key={suppression.id}
+		    className="rounded-lg border border-stone-200 bg-white p-3
+			       text-stone-900 shadow-sm dark:border-stone-700
+			       dark:bg-stone-900 dark:text-stone-100">
+		  <div className="font-medium">
+		    {SOURCE_KIND_LABELS[suppression.sourceKind]}
+		  </div>
+		  <div className="break-all text-sm text-stone-700 dark:text-stone-300">
+		    {suppression.normalizedSourceKey}
+		  </div>
+		  <div className="mt-2 text-sm text-stone-600 dark:text-stone-400">
+		    事由: {reasonName (suppression.reason)} /
+		    登録: {dateString (suppression.createdAt)}
+		  </div>
+		</article>))}
+	  </div>
+	</div>
+      </MainArea>)
+}
+
+export default MaterialSyncSuppressionsPage

frontend/src/pages/posts/PostDetailPage.tsx

@@ -62,8 +62,7 @@ const PostDetailPage: FC<Props> = ({ user }) => {
 	toast ({ title: '失敗……', description: '通信に失敗しました……' })
       },
       onSuccess: () => {
-	qc.invalidateQueries ({ queryKey: postsKeys.root })
+	qc.invalidateQueries ({ queryKey: postsKeys.root })} })
-      } })
 
   useEffect (() => {
     if (!(errorFlg))
@@ -114,8 +113,7 @@ const PostDetailPage: FC<Props> = ({ user }) => {
 		      <PostList posts={[{ ...post, childPosts: [{ } as Post] },
 					...post.childPosts!.map (p => ({
 					    ...p, parentPosts: [{ } as Post] }))]}/>
-		    </div>
+		    </div>)}
-		)}
 		{(post.parentPosts ?? []).map (pp => {
 		  const siblings = post.siblingPosts?.[String (pp.id) as `${ number }`]
 		  if (!(siblings))

frontend/src/pages/tags/NicoTagListPage.tsx

@@ -1,6 +1,6 @@
 import { useQuery, useQueryClient } from '@tanstack/react-query'
 import { Check, LoaderCircle, Pencil, X } from 'lucide-react'
-import { useEffect, useMemo, useState } from 'react'
+import { Fragment, useEffect, useMemo, useState } from 'react'
 import { Helmet } from 'react-helmet-async'
 import { useLocation, useNavigate } from 'react-router-dom'
 
@@ -87,8 +87,7 @@ const NicoTagListPage: FC<Props> = ({ user }) => {
   const defaultDirection = {
       name:       'asc',
       created_at: 'desc',
-      updated_at: 'desc',
+      updated_at: 'desc'} as const
-  } as const
 
   const beginEdit = async (tag: NicoTag) => {
     const editingTag = nicoTags.find (tag => tag.id === editingId)
@@ -99,15 +98,13 @@ const NicoTagListPage: FC<Props> = ({ user }) => {
 	&& !(await dialogue.confirm ({
 	  title:       '編集中の内容を破棄しますか?',
 	  confirmText: '破棄',
-	  variant:     'danger',
+	  variant:     'danger'})))
-	})))
       return
 
     setEditingId (tag.id)
     setRawTags (rawTags => ({
 	...rawTags,
-	[tag.id]: tag.linkedTags.map (linkedTag => linkedTag.name).join (' '),
+	[tag.id]: tag.linkedTags.map (linkedTag => linkedTag.name).join (' ')}))
-    }))
     setErrorsByTagId (errors => ({ ...errors, [tag.id]: [] }))
   }
 
@@ -115,8 +112,7 @@ const NicoTagListPage: FC<Props> = ({ user }) => {
     setEditingId (null)
     setRawTags (rawTags => ({
 	...rawTags,
-	[tag.id]: tag.linkedTags.map (linkedTag => linkedTag.name).join (' '),
+	[tag.id]: tag.linkedTags.map (linkedTag => linkedTag.name).join (' ')}))
-    }))
     setErrorsByTagId (errors => ({ ...errors, [tag.id]: [] }))
   }
 
@@ -141,8 +137,7 @@ const NicoTagListPage: FC<Props> = ({ user }) => {
 	  ...errors,
 	  [id]: validationError?.fieldErrors.tags
 	      ?? validationError?.baseErrors
-	      ?? ['更新できませんでした．'],
+	      ?? ['更新できませんでした．']}))
-      }))
       toast ({ title: '更新失敗', description: '入力内容を確認してください．' })
     }
     finally
@@ -166,8 +161,7 @@ const NicoTagListPage: FC<Props> = ({ user }) => {
 
     setRawTags (Object.fromEntries (data.tags.map (tag => [
       tag.id,
-      tag.linkedTags.map (linkedTag => linkedTag.name).join (' '),
+      tag.linkedTags.map (linkedTag => linkedTag.name).join (' ')])))
-    ])))
   }, [data])
 
   useEffect (() => {
@@ -282,7 +276,8 @@ const NicoTagListPage: FC<Props> = ({ user }) => {
 			{nicoTags.map (tag => {
 			  const isEditing = editingId === tag.id
 
-			  return [
+			  return (
+			      <Fragment key={tag.id}>
 			    <tr
 				key={tag.id}
 				className={cn (
@@ -321,8 +316,8 @@ const NicoTagListPage: FC<Props> = ({ user }) => {
 					  編集
 					</button>)}
 				  </td>)}
-			    </tr>,
+			    </tr>
-			    isEditing && (
+			    {isEditing && (
 				<tr key={`${ tag.id }-edit`}
 				    className="border-b border-rose-200 bg-rose-50 dark:border-rose-900
 					       dark:bg-rose-950/30">
@@ -340,8 +335,7 @@ const NicoTagListPage: FC<Props> = ({ user }) => {
 					  placeholder="タグ名を空白または改行で区切って入力"
 					  onChange={e => setRawTags (rawTags => ({
 					      ...rawTags,
-					      [tag.id]: e.target.value,
+					      [tag.id]: e.target.value}))}/>
-					  }))}/>
 				      <FieldError messages={errorsByTagId[tag.id]}/>
 				      <div className="flex justify-end gap-2">
 					<button
@@ -368,8 +362,8 @@ const NicoTagListPage: FC<Props> = ({ user }) => {
 				      </div>
 				    </div>
 				  </td>
-				</tr>),
+				</tr>)}
-			  ]
+			      </Fragment>)
 			})}
 		      </tbody>
 		    </table>

frontend/src/pages/theatres/TheatreDetailPage.test.tsx

@@ -1,9 +1,10 @@
-import { act, fireEvent, screen, waitFor } from '@testing-library/react'
+import { act, fireEvent, screen, waitFor, within } from '@testing-library/react'
 import { Route, Routes } from 'react-router-dom'
 import { beforeEach, describe, expect, it, vi } from 'vitest'
 
 import TheatreDetailPage from '@/pages/theatres/TheatreDetailPage'
 import { buildPost,
+	 buildTag,
 	 buildTheatre,
 	 buildTheatreComment,
 	 buildTheatreInfo,
@@ -96,6 +97,9 @@ const renderPage = (user = buildUser ({ id: 1, role: 'member' })) =>
       { route: '/theatres/7' },
   )
 
+const tagSection = (): HTMLElement =>
+  screen.getAllByRole ('heading', { name: 'タグ' })[0].closest ('section')!
+
 const mockDefaultApi = () => {
   api.apiGet.mockImplementation ((path: string) => {
     switch (path)
@@ -245,6 +249,53 @@ describe ('TheatreDetailPage', () => {
     expect (postEmbed.seek).not.toHaveBeenCalledWith (0)
   })
 
+  it ('shows child tags from the post tag tree in both vertical and horizontal layouts', async () => {
+    const childTag = buildTag ({ id: 12, name: '子タグ', category: 'general' })
+    const parentTag = buildTag ({
+      id:       11,
+      name:     '親タグ',
+      category: 'general',
+      children: [childTag],
+    })
+    const duplicateParentTag = buildTag ({
+      id:       13,
+      name:     '別親タグ',
+      category: 'general',
+      children: [childTag],
+    })
+
+    postsApi.fetchPost.mockResolvedValueOnce (buildPost ({
+      ...currentPost,
+      tags: [parentTag, duplicateParentTag],
+    }))
+
+    renderPage ()
+
+    await screen.findByText ('Embed:上映中の投稿')
+
+    expect (within (tagSection ()).getByRole ('link', { name: '親タグ' }))
+      .toBeInTheDocument ()
+    expect (within (tagSection ()).getByRole ('link', { name: '別親タグ' }))
+      .toBeInTheDocument ()
+    expect (within (tagSection ()).getAllByRole ('link', { name: '子タグ' })[0])
+      .toBeInTheDocument ()
+    expect (within (tagSection ()).getAllByText ('↳').length).toBeGreaterThan (0)
+
+    fireEvent.click (screen.getByRole ('button', { name: '2 列 A 型' }))
+    fireEvent.click (screen.getAllByRole ('button', { name: '横並び' })[0])
+
+    await waitFor (() => {
+      expect (within (tagSection ()).getByRole ('link', { name: '親タグ' }))
+	.toBeInTheDocument ()
+      expect (within (tagSection ()).getByRole ('link', { name: '別親タグ' }))
+	.toBeInTheDocument ()
+      expect (within (tagSection ()).getByRole ('link', { name: '子タグ' }))
+	.toBeInTheDocument ()
+      expect (within (tagSection ()).getAllByRole ('link', { name: '子タグ' }))
+	.toHaveLength (1)
+    })
+  })
+
   it ('does not advance host post while video length is unknown', async () => {
     api.apiPut.mockImplementation ((path: string) => {
       switch (path)

frontend/src/pages/theatres/TheatreDetailPage.tsx

@@ -69,8 +69,7 @@ const userName = (user: Pick<User, 'id' | 'name'> | null | undefined): string =>
 
 const commentBox = (
     comment: TheatreComment,
-    programme: TheatreProgramme | null = null,
+    programme: TheatreProgramme | null = null): ReactNode[] =>
-): ReactNode[] =>
     [(
 	<div key={`${ comment.no }-content`} className="w-full">
 	  {comment.deleted
@@ -103,6 +102,28 @@ const compareTagName = (a: Tag, b: Tag): number =>
     a.name === b.name ? 0 : (a.name < b.name ? -1 : 1)
 
 
+const flattenTags = (tags: Tag[]): Tag[] => {
+  const flattened: Tag[] = []
+  const seen = new Set<number> ()
+
+  const visit = (tag: Tag) => {
+    if (seen.has (tag.id))
+      return
+
+    seen.add (tag.id)
+    flattened.push (tag)
+
+    for (const child of tag.children ?? [])
+      visit (child)
+  }
+
+  for (const tag of tags)
+    visit (tag)
+
+  return flattened
+}
+
+
 const tagsByCategory = (tags: Tag[]): Partial<Record<Category, Tag[]>> => {
   const grouped: Partial<Record<Category, Tag[]>> = { }
 
@@ -119,16 +140,39 @@ const tagsByCategory = (tags: Tag[]): Partial<Record<Category, Tag[]>> => {
 }
 
 
+const renderReadonlyTagTree = (
+    tag:       Tag,
+    nestLevel: number,
+    path:      string,
+    ancestors: Set<number> = new Set<number> (),
+): ReactNode[] => {
+  const key = `${ path }-${ tag.id }`
+  const nextAncestors = new Set (ancestors)
+  nextAncestors.add (tag.id)
+
+  return [
+      (
+	  <li key={key} className="text-left leading-tight">
+	    <TagLink tag={tag} nestLevel={nestLevel} withCount={false}/>
+	  </li>),
+      ...((tag.children ?? [])
+	  .filter (child => !(nextAncestors.has (child.id)))
+	  .sort (compareTagName)
+	  .flatMap (child =>
+	      renderReadonlyTagTree (child, nestLevel + 1, key, nextAncestors)))]
+}
+
+
 const TagList: FC<{ tags: Tag[]; compact?: boolean; flow?: TagFlow }> = (
-    { tags, compact, flow = 'vertical' },
+    { tags, compact, flow = 'vertical' }) => {
-) => {
+  const horizontalGrouped = tagsByCategory (flattenTags (tags))
-  const grouped = tagsByCategory (tags)
+  const verticalGrouped = tagsByCategory (tags)
 
   if (flow === 'horizontal')
     {
       return (
 	  <ul className={cn ('flex flex-wrap gap-x-3 gap-y-1', compact && 'text-sm')}>
-	    {CATEGORIES.flatMap (cat => grouped[cat] ?? []).map (tag => (
+	    {CATEGORIES.flatMap (cat => horizontalGrouped[cat] ?? []).map (tag => (
 		<li key={tag.id} className="text-left leading-tight">
 		  <TagLink tag={tag} withCount={false}/>
 		</li>))}
@@ -138,7 +182,7 @@ const TagList: FC<{ tags: Tag[]; compact?: boolean; flow?: TagFlow }> = (
   return (
       <div className="space-y-3">
 	{CATEGORIES.map (cat => {
-	  const rows = grouped[cat] ?? []
+	  const rows = verticalGrouped[cat] ?? []
 	  if (rows.length === 0)
 	    return null
 
@@ -148,10 +192,8 @@ const TagList: FC<{ tags: Tag[]; compact?: boolean; flow?: TagFlow }> = (
 		  {CATEGORY_NAMES[cat]}
 		</div>
 		<ul className={cn ('space-y-1', compact && 'text-sm')}>
-		  {rows.map (tag => (
+		  {rows.flatMap (tag =>
-		      <li key={tag.id} className="text-left leading-tight">
+		      renderReadonlyTagTree (tag, 0, `cat-${ cat }`))}
-			<TagLink tag={tag} withCount={false}/>
-		      </li>))}
 		</ul>
 	      </div>)
 	})}

frontend/src/stores/sharedTransitionStore.ts

@@ -15,5 +15,4 @@ export const useSharedTransitionStore = create<SharedTransitionState> (set => ({
 	set (state => {
 	  const next = { ...state.byLocationKey }
 	  delete next[locationKey]
-	  return { byLocationKey: next }
+	  return { byLocationKey: next }}) }))
-	}) }))

frontend/src/test/factories.ts

@@ -76,10 +76,18 @@ export const buildMaterial = (overrides: Partial<Material> = {}): Material => ({
   tag:                   buildTag (),
   file:                  null,
   url:                   null,
+  sourceKind:            null,
+  sourceUri:             null,
+  sourcePath:            null,
+  sourceFileId:          null,
+  normalizedSourceKey:   null,
   wikiPageBody:          null,
+  thumbnail:             null,
+  thumbnailFallbackText: 'テストタグ',
+  thumbnailFallbackKind: 'tag_name',
+  mediaKind:             'url_only',
   contentType:           null,
-  fileSuppressedAt:      null,
+  fileByteSize:          null,
-  fileSuppressionReason: null,
   exportPaths:           {},
   exportItems:           [],
   createdAt:             '2026-01-02T03:04:05.000Z',

frontend/src/types.ts

@@ -65,16 +65,77 @@ export type FetchNicoTagsOrder = `${ FetchNicoTagsOrderField }:${ 'asc' | 'desc'
 
 export type FetchNicoTagsOrderField = 'name' | 'created_at' | 'updated_at'
 
+export type MaterialFilter = 'present' | 'missing' | 'any'
+
+export type MaterialIndexDirection = 'asc' | 'desc'
+
+export type MaterialIndexMediaKind =
+    | 'all'
+    | 'image'
+    | 'video'
+    | 'audio'
+    | 'file_other'
+    | 'url_only'
+
+export type MaterialIndexSort =
+    | 'created_at'
+    | 'updated_at'
+    | 'tag_name'
+    | 'media_kind'
+    | 'file_byte_size'
+    | 'version_no'
+    | 'id'
+
+export type MaterialIndexTagState = 'all' | 'tagged' | 'untagged'
+
+export type MaterialIndexGroupBy = 'none' | 'parent_tag'
+
+export type MaterialIndexView = 'card' | 'list'
+
+export type MaterialTagScope = {
+    tag:                {
+	id:          number
+	name:        string
+	category:    Category
+    }
+    includeDescendants: boolean
+}
+
+export type FetchMaterialsParams = {
+    q:            string
+    tagState:     MaterialIndexTagState
+    mediaKind:    MaterialIndexMediaKind
+    tagId:        number | null
+    includeDescendants: boolean
+    groupBy:      MaterialIndexGroupBy
+    createdFrom:  string
+    createdTo:    string
+    updatedFrom:  string
+    updatedTo:    string
+    sort:         MaterialIndexSort
+    direction:    MaterialIndexDirection
+    view:         MaterialIndexView
+    page:         number
+    limit:        number }
+
 export type Material = {
     id:                     number
     versionNo:              number
-    tag:                    Tag
+    tag:                    Tag | null
     file:                   string | null
     url:                    string | null
+    sourceKind:             string | null
+    sourceUri:              string | null
+    sourcePath:             string | null
+    sourceFileId:           string | null
+    normalizedSourceKey:    string | null
     wikiPageBody?:          string | null
+    thumbnail:              string | null
+    thumbnailFallbackText:  string | null
+    thumbnailFallbackKind:  'tag_name' | 'created_at'
+    mediaKind:              'image' | 'video' | 'audio' | 'file_other' | 'url_only'
     contentType:            string | null
-    fileSuppressedAt:       string | null
+    fileByteSize:           number | null
-    fileSuppressionReason:  string | null
     exportPaths:            Record<string, string>
     exportItems:            MaterialExportItem[]
     createdAt:              string
@@ -82,12 +143,88 @@ export type Material = {
     updatedAt:              string
     updatedByUser:          { id: number; name: string } }
 
+export type MaterialSyncSuppressionSourceKind =
+    | 'uri'
+    | 'google_drive_path'
+    | 'google_drive_path_prefix'
+    | 'google_drive_file'
+    | 'legacy_drive_path'
+    | 'legacy_drive_path_prefix'
+
+export type MaterialSyncSuppression = {
+    id:                  number
+    sourceKind:          MaterialSyncSuppressionSourceKind
+    sourceUri:           string | null
+    drivePath:           string | null
+    driveFileId:         string | null
+    normalizedSourceKey: string
+    reason:              string
+    createdByUser:       { id: number; name: string } | null
+    createdAt:           string
+    updatedAt:           string }
+
+export type MaterialSidebarTag = {
+    id:          number
+    name:        string
+    category:    Category
+    deprecated:  boolean
+    hasChildren: boolean
+    hasMaterial: boolean
+    children:    MaterialSidebarTag[] }
+
+export type MaterialTagTree = Omit<Tag, 'children'> & {
+    hasChildren: boolean
+    hasMaterial: boolean
+    children:    MaterialTagTree[]
+    material?:   Material | null }
+
 export type MaterialExportItem = {
     id:          number
     profile:     string
     exportPath:  string
     enabled:     boolean }
 
+export type MaterialIndexGroup = {
+    key:         string
+    tag:         {
+	id:          number
+	name:        string
+	category:    Category
+    }
+    materialIds: number[]
+    count:       number }
+
+export type MaterialIndexResponse = {
+    materials: Material[]
+    count:     number
+    groups?:   MaterialIndexGroup[]
+    tagScope?: MaterialTagScope | null
+}
+
+export type MaterialVersion = {
+    id:               number
+    materialId:       number
+    versionNo:        number
+    eventType:        'create' | 'update' | 'discard' | 'restore'
+    tagId:            number | null
+    tagName:          string | null
+    tagCategory:      Category | null
+    url:              string | null
+    sourceKind:       string | null
+    sourceUri:        string | null
+    sourcePath:       string | null
+    sourceFileId:     string | null
+    normalizedSourceKey: string | null
+    fileBlobId:       number | null
+    fileFilename:     string | null
+    fileContentType:  string | null
+    fileByteSize:     number | null
+    fileSha256:       string | null
+    exportPathsJson:  Record<string, string>
+    discardedAt:      string | null
+    createdByUser:    { id: number; name: string | null } | null
+    createdAt:        string }
+
 export type Menu = MenuItem[]
 
 export type MenuInvisibleItem = {