-- How an imported document is presented on the physical investigation board.
-- This is deliberately separate from document_type_id/MIME type: the same PNG
-- may be a photograph, a scene, a clipping, or a complete page.

CREATE TABLE osint.document_capture_kinds (
  id TEXT PRIMARY KEY,
  name TEXT NOT NULL UNIQUE,
  description TEXT NOT NULL
);

INSERT INTO osint.document_capture_kinds (id,name,description) VALUES
  ('unclassified','Unclassified','Imported evidence that has not yet been classified.'),
  ('photo','Photo','A person or object is the subject of the image.'),
  ('scene','Scene','A place, situation, or event is shown.'),
  ('clipping','Clipping','An extract captured from a larger source.'),
  ('full_page','Full page','A complete page or document view.');

ALTER TABLE osint.document_exhibits
  ADD COLUMN capture_kind_id TEXT NOT NULL DEFAULT 'unclassified'
  REFERENCES osint.document_capture_kinds(id);

COMMENT ON COLUMN osint.document_exhibits.capture_kind_id IS
  'Player-selected evidentiary form used by board presentation and contextual connection copy; independent of the asset MIME type.';