https://rekeeply.github.io/spec/en/core-api/storage-model/Recent content in Storage Model on Rekeeply SpecHugoenhttps://rekeeply.github.io/spec/en/core-api/storage-model/raw-model/Mon, 01 Jan 0001 00:00:00 +0000https://rekeeply.github.io/spec/en/core-api/storage-model/raw-model/<h1 id="raw-model">Raw Model<a class="anchor" href="#raw-model">#</a></h1> <h2 id="purpose">Purpose<a class="anchor" href="#purpose">#</a></h2> <ul> <li><code>Raw</code> is a separate domain because some user data must be stored in unstructured form before later processing.</li> <li><code>Raw</code> enables quick capture without mandatory classification or immediate placement into <code>Library</code>.</li> </ul> <h2 id="contract">Contract<a class="anchor" href="#contract">#</a></h2> <ul> <li>Core implementations MUST include <code>Raw</code> as an account-scoped storage domain for unstructured capture.</li> <li><code>Raw</code> MUST support quick save without selecting an active library.</li> <li><code>Raw</code> MUST support review and deferred processing of captured items.</li> <li><code>Raw</code> items MUST be eligible for explicit later promotion into <code>Library</code>.</li> </ul> <h2 id="supported-payload-types">Supported Payload Types<a class="anchor" href="#supported-payload-types">#</a></h2> <ul> <li><code>Raw</code> MUST support <code>text</code>, <code>link</code>, and <code>mixed</code> payload types.</li> <li><code>Raw</code> MAY support <code>file_ref</code> as reference-only payload.</li> <li><code>image</code>, <code>video</code>, and <code>audio</code> payload types are out of the mandatory baseline scope.</li> </ul> <h2 id="raw-item-storage-model">Raw Item Storage Model<a class="anchor" href="#raw-item-storage-model">#</a></h2> <ul> <li>Storage SHOULD use typed-columns-first design for hot read paths.</li> <li>Implementations MUST avoid JSON-only storage for list/filter hot paths.</li> <li>Each <code>RawItem</code> MUST include: <code>id</code>, <code>account_id</code>, <code>payload_type</code>, <code>status</code>, <code>created_at</code>, <code>updated_at</code>.</li> <li>Implementations SHOULD include fast list fields such as <code>title_preview</code> and source/type/status columns.</li> </ul> <h2 id="capture-inputs">Capture Inputs<a class="anchor" href="#capture-inputs">#</a></h2> <ul> <li><code>Raw</code> MUST accept capture from manual input and clipboard/paste flows.</li> <li><code>Raw</code> SHOULD accept external share/import flows when available in client/runtime.</li> <li>Capture MUST remain offline-capable and MUST NOT require network availability.</li> </ul> <h2 id="metadata-enrichment">Metadata Enrichment<a class="anchor" href="#metadata-enrichment">#</a></h2> <ul> <li>For <code>link</code> payloads, metadata enrichment MAY run asynchronously after capture.</li> <li>Metadata fetch failures MUST NOT block capture completion.</li> <li>When metadata is unavailable, implementations MUST provide deterministic fallback preview.</li> </ul> <h2 id="lifecycle-and-operations">Lifecycle and Operations<a class="anchor" href="#lifecycle-and-operations">#</a></h2> <ul> <li>Implementations MUST support item states equivalent to <code>new | triaged | promoted | archived</code>.</li> <li>Implementations MUST support listing and status transitions for triage.</li> <li>Implementations MUST support explicit <code>promote</code> from <code>Raw</code> to <code>Library</code>.</li> </ul> <h2 id="promote-flow-requirements">Promote Flow Requirements<a class="anchor" href="#promote-flow-requirements">#</a></h2> <ul> <li><code>promote</code> MUST validate that <code>target_library_id</code> belongs to the same <code>account_id</code>.</li> <li><code>promote</code> MUST be idempotent for the same <code>RawItem</code> and MUST NOT create duplicates on retry.</li> <li><code>promote</code> MUST persist linkage to created library entity (<code>promoted_content_id</code> or equivalent origin link).</li> </ul> <h2 id="promote-mapping-rules">Promote Mapping Rules<a class="anchor" href="#promote-mapping-rules">#</a></h2> <ul> <li> <p><code>Raw:text</code></p>