コンテンツにスキップ

lenses/research-result.schema.json

research/results/lenses/<brand-id>/<result-id>.jsonに置く、調査結果データ1件を検証します。 一つの候補製品について、現在の収録判断、確認した情報源、未解決の確認事項を記録します。

収録判断の3状態

一つの調査結果データが持つ判断は一つです。 次の実例では状態ごとに異なる候補製品を使い、条件による構造の違いだけを示します。

製品：NIKKOR Z 24-70mm f/2.8 S II

参照元：research/results/lenses/nikkor/nikkor-z-24-to-70mm-f2p8-s-ii.json

参照箇所：decision

{
  "decision": {
    "status": "included",
    "recordId": "nikkor-z-24-to-70mm-f2p8-s-ii"
  }
}

recordIdは、対応する収録製品データの製品IDです。

製品：Lightdow 900mm F8 Mirror Lens

参照元：research/results/lenses/lightdow/lightdow-900mm-f8-mirror-lens.json

参照箇所：decision

{
  "decision": {
    "status": "excluded",
    "reason": "The product is a generic T2-mount mirror lens sold with camera-side adapter rings. It is not a direct, supplied lens-specific, or dedicated-series Nikon Z configuration."
  }
}

この例では、汎用T2マウントレンズとカメラ側アダプターの組み合わせであり、収録条件を満たさないと判断しています。

製品：SIRUI Saturn V2 Full-Frame Anamorphic Lens Series

参照元：research/results/lenses/sirui/sirui-saturn-v2-full-frame-anamorphic-lens-series.json

参照箇所：decision、unresolved

{
  "decision": {
    "status": "needs-review"
  },
  "unresolved": [
    "Has SIRUI published a product release announcement or confirmed sale or availability for the Saturn V2 series?",
    "Has SIRUI announced or offered a Nikon Z configuration for the Saturn V2 series?"
  ]
}

この例では、発売発表または販売の確認と、Zマウント用製品の有無が未解決です。

判断状態ごとの条件

decision.status 追加必須フィールド sources
included decision.recordId 1件以上
excluded decision.reason 1件以上
needs-review ルートのunresolvedを1件以上 記録できる情報源が見つからない場合に限り[]を使用できる

decisionは、状態に対応するフィールドだけを持ちます。 includedではreasonを、needs-reviewではrecordIdを使用しません。

共通フィールド

$schema、id、subject、reviewedOn、decision、sourcesは必須です。 notesとunresolvedは、必要な場合だけ追加します。

パス 型・値 説明
$schema "../../../../schemas/lenses/research-result.schema.json" 調査結果データを検証するJSON Schemaへの固定相対パス
id ID文字列 調査対象を一意に表す結果ID
subject オブジェクト 調査時点で把握している候補製品の名称情報
subject.manufacturerId ID文字列またはnull 判明しているメーカーID
subject.brandId ID文字列またはnull 判明しているブランドID
subject.name 文字列 調査対象とした製品名
subject.aliases 重複のない文字列[] 同じ候補製品を指す別名。ない場合は省略する
reviewedOn 日付 現在の判断と情報源を最後に確認した日
decision.status included / excluded / needs-review 現在の収録判断
decision.recordId ID文字列 includedの場合に対応する収録製品データの製品ID
decision.reason 文字列 excludedの場合に対象外と判断した根拠
sources sourceの配列 判断のために確認した情報源
sources[].url HTTP(S) URL 確認したページのURL
sources[].publisherRelationship 列挙値 発行者とメーカー・ブランドとの関係
sources[].sourceType 列挙値 ページまたは媒体の種別
sources[].checked 重複のない列挙値[] そのURLで確認した製品用JSON Schemaのフィールドパス
sources[].decisionChecks 重複のない列挙値[] 収録製品データに対応するフィールドがない収録判断用の確認事項
sources[].note 文字列 構造化フィールドだけでは表せない短い補足。不要な場合は省略する
notes 重複のない文字列[] 判断を変えない補足。ない場合は省略する
unresolved 重複のない文字列[] 未解決の確認事項。needs-reviewでは1件以上必須

subjectでは、manufacturerId、brandId、nameが必須です。 メーカーまたはブランドを特定できない場合は、対応するIDフィールドにnullを記録します。

収録製品データとの対応

decision.statusがincludedの場合、次の対応をリポジトリ検証で確認します。

確認項目 規則
ID 結果ID、decision.recordId、収録製品データの製品IDが一致する
識別情報 subjectのメーカーID、ブランドID、製品名が収録製品データのidentityと一致する
確認日 reviewedOnがdataVersionの日付より後にならない
製品の日付 lifecycle.announcementDateとlifecycle.officialDesignations[].observedOnがreviewedOnより後にならない
情報源の範囲 収録製品データに確認済みの値がある主要フィールド群を、いずれかの情報源のcheckedが覆う

checkedを変更しただけでは、reviewedOnを更新しません。 収録製品データの確定値またはcheckedの対象を変更する場合は、関係する情報源を再確認し、現在の判断と情報源を実際に確認した日を記録します。

falseと空配列も確認済みの値として扱い、nullは対象外です。 lens.specializedでは、cinema: {}のような空のマーカーオブジェクトも確認済みの事実として扱います。 specializedが空でない収録製品データには、対応する情報源のcheckedにlens.specializedが必要です。

情報源の分類と確認項目

publisherRelationshipには、次の値を使用できます。

  • manufacturer-or-brand、authorized-distributor、authorized-retailer
  • retailer、crowdfunding-platform、independent-publication、unknown

sourceTypeには、次の値を使用できます。

  • announcement、catalog、collection、company-profile
  • crowdfunding、distributor-page、faq、image
  • manual、news-report、product-page、retailer-listing
  • specification、support-page、technical-page、video、other

各sourceにはcheckedまたはdecisionChecksの少なくとも一方が必要です。 checkedは収録製品データのフィールド名に対応し、個々の数値や配列要素までは細分化しません。 親と子が個別に列挙されている場合、親パスは子パスの代わりになりません。

  • 共通項目
    • 基本情報：productType、identity、identity.modelNumberOptions、identity.alternateNames、identity.variants、lifecycle、officialProductPages
    • マウント：mount、mount.electronicContacts、mount.adapter
    • 外形：physical、physical.dimensionMeasurements、physical.weightMeasurements、physical.officialEnvironmentalProtectionClaims、physical.filterInterfaces、physical.tripodSupport
    • 全長と収納：physical.externalLengthDuringZoom、physical.externalLengthDuringFocus、physical.isRetractableForStorage、physical.frontAccessoryInterface
    • その他：controls、accessories、electronicServices
  • レンズ
    • 基本仕様：lens.focalLength、lens.aperture、lens.anglesOfView、lens.coverage、lens.imageCircleDiameters、lens.opticalConstruction
    • 光学要素：lens.specialElements、lens.coatings
    • 機能：lens.focus、lens.zoom、lens.stabilization、lens.specialized
  • テレコンバーター
    • 基本仕様：teleconverter.coverage、teleconverter.magnification、teleconverter.apertureLossStops、teleconverter.supportsAutofocus
    • 光学要素：teleconverter.opticalConstruction、teleconverter.specialElements、teleconverter.coatings
    • 対応レンズ：teleconverter.compatibleLensIds
  • ピンホール：pinhole.coverage、pinhole.focalLength、pinhole.imagingModes、pinhole.anglesOfView

decisionChecksには、availability、inclusion-criteria、licensing、release-statusのいずれかを使用します。 数値や事実そのものは、調査結果データではなく収録製品データに記録します。 情報源には調査時の会話、プロンプト、取得ログを保存しません。 情報源と判断の詳しい扱いは、調査結果データを編集するを参照してください。

関連ページ

JSON Schemaファイル