66 lines
2.6 KiB
YAML
66 lines
2.6 KiB
YAML
id: https://nde.nl/ontology/hc/class/SourceCommentCount
|
|
name: source_comment_count_class
|
|
title: Source Comment Count Class
|
|
prefixes:
|
|
linkml: https://w3id.org/linkml/
|
|
hc: https://nde.nl/ontology/hc/
|
|
schema: http://schema.org/
|
|
prov: http://www.w3.org/ns/prov#
|
|
imports:
|
|
- linkml:types
|
|
- ../metadata
|
|
- ../slots/has_or_had_quantity
|
|
- ../slots/was_fetched_at
|
|
default_prefix: hc
|
|
classes:
|
|
SourceCommentCount:
|
|
class_uri: hc:SourceCommentCount
|
|
description: "Comment count metadata from an external source (API, web page).\n\
|
|
\n**PURPOSE**:\n\nStructured representation of comment retrieval metadata, tracking\n\
|
|
how many comments were fetched versus the total available at the source.\nReplaces\
|
|
\ simple integer count with rich provenance data.\n\n**DESIGN RATIONALE**:\n\
|
|
\nCreated per slot_fixes.yaml migration from `comments_fetched` integer\nto\
|
|
\ structured `was_fetched_at` + `Timestamp` + `is_or_was_part_of_total`\n+ `SourceCommentCount`\
|
|
\ for complete retrieval tracking.\n\n**USE CASES**:\n\n- YouTube API: Track\
|
|
\ fetched comments vs total comment count\n- Social media: Partial comment retrieval\
|
|
\ with pagination\n- Web scraping: Track scraped vs visible comments\n\n**EXAMPLE**:\n\
|
|
\n```yaml\nis_or_was_part_of_total:\n fetched_count: 100\n total_count: 500\n\
|
|
\ fetch_complete: false\n was_fetched_at:\n has_or_had_timestamp: \"2025-01-14T10:30:00Z\"\
|
|
\n```\n"
|
|
close_mappings:
|
|
- schema:InteractionCounter
|
|
- prov:Entity
|
|
slots:
|
|
- was_fetched_at
|
|
- has_or_had_quantity
|
|
slot_usage:
|
|
was_fetched_at:
|
|
range: Timestamp
|
|
inlined: true
|
|
required: false
|
|
examples:
|
|
- value:
|
|
has_or_had_timestamp: '2025-01-14T10:30:00Z'
|
|
has_or_had_quantity:
|
|
range: integer
|
|
inlined: false # Fixed invalid inline for primitive type
|
|
required: false
|
|
examples:
|
|
- value:
|
|
was_fetched_at:
|
|
has_or_had_timestamp: '2025-01-14T10:30:00Z'
|
|
- value: null
|
|
- value: null
|
|
comments:
|
|
- Created 2026-01-22 from comments_fetched migration (Rule 53)
|
|
- Tracks fetched vs total comment counts
|
|
- Includes fetch timestamp for provenance
|
|
- Supports partial/paginated data retrieval
|
|
see_also:
|
|
- https://schema.org/InteractionCounter
|
|
annotations:
|
|
custodian_types: '["*"]'
|
|
custodian_types_rationale: Universal - any custodian with video/social media
|
|
content.
|
|
specificity_score: '0.70'
|
|
specificity_rationale: Specific to video/social media comment fetching contexts.
|