https://rekeeply.github.io/spec/ru/core-api/storage-model/Recent content in Модель хранения on Rekeeply SpecHugoruhttps://rekeeply.github.io/spec/ru/core-api/storage-model/raw-model/Mon, 01 Jan 0001 00:00:00 +0000https://rekeeply.github.io/spec/ru/core-api/storage-model/raw-model/<h1 id="модель-raw">Модель Raw<a class="anchor" href="#%d0%bc%d0%be%d0%b4%d0%b5%d0%bb%d1%8c-raw">#</a></h1> <h2 id="назначение">Назначение<a class="anchor" href="#%d0%bd%d0%b0%d0%b7%d0%bd%d0%b0%d1%87%d0%b5%d0%bd%d0%b8%d0%b5">#</a></h2> <ul> <li><code>Raw</code> выделен в отдельный домен, потому что часть пользовательских данных должна храниться в неструктурированном виде до последующей обработки.</li> <li><code>Raw</code> обеспечивает быстрый capture без обязательной классификации и без немедленного размещения в <code>Library</code>.</li> </ul> <h2 id="контракт">Контракт<a class="anchor" href="#%d0%ba%d0%be%d0%bd%d1%82%d1%80%d0%b0%d0%ba%d1%82">#</a></h2> <ul> <li>Реализация core ДОЛЖНА включать <code>Raw</code> как домен хранения уровня аккаунта для неструктурированного capture.</li> <li><code>Raw</code> ДОЛЖЕН поддерживать быстрое сохранение без выбора активной библиотеки.</li> <li><code>Raw</code> ДОЛЖЕН поддерживать разбор и отложенную обработку сохраненных элементов.</li> <li>Элементы <code>Raw</code> ДОЛЖНЫ поддерживать явный последующий перенос в <code>Library</code>.</li> </ul> <h2 id="поддерживаемые-payload-типы">Поддерживаемые payload-типы<a class="anchor" href="#%d0%bf%d0%be%d0%b4%d0%b4%d0%b5%d1%80%d0%b6%d0%b8%d0%b2%d0%b0%d0%b5%d0%bc%d1%8b%d0%b5-payload-%d1%82%d0%b8%d0%bf%d1%8b">#</a></h2> <ul> <li><code>Raw</code> ДОЛЖЕН поддерживать payload-типы <code>text</code>, <code>link</code>, <code>mixed</code>.</li> <li><code>Raw</code> МОЖЕТ поддерживать <code>file_ref</code> как reference-only payload.</li> <li>Типы <code>image</code>, <code>video</code>, <code>audio</code> не входят в обязательный baseline scope.</li> </ul> <h2 id="модель-хранения-raw-item">Модель хранения Raw Item<a class="anchor" href="#%d0%bc%d0%be%d0%b4%d0%b5%d0%bb%d1%8c-%d1%85%d1%80%d0%b0%d0%bd%d0%b5%d0%bd%d0%b8%d1%8f-raw-item">#</a></h2> <ul> <li>Хранение ДОЛЖНО быть ориентировано на typed-columns-first для горячих read-path.</li> <li>Реализация НЕ ДОЛЖНА опираться на JSON-only хранение для горячих list/filter-path.</li> <li>Каждый <code>RawItem</code> ДОЛЖЕН содержать: <code>id</code>, <code>account_id</code>, <code>payload_type</code>, <code>status</code>, <code>created_at</code>, <code>updated_at</code>.</li> <li>Реализация ДОЛЖНА/РЕКОМЕНДУЕТСЯ хранить легкие поля для быстрых списков (<code>title_preview</code>, source/type/status).</li> </ul> <h2 id="каналы-записи-capture">Каналы записи (capture)<a class="anchor" href="#%d0%ba%d0%b0%d0%bd%d0%b0%d0%bb%d1%8b-%d0%b7%d0%b0%d0%bf%d0%b8%d1%81%d0%b8-capture">#</a></h2> <ul> <li><code>Raw</code> ДОЛЖЕН принимать capture из ручного ввода и буфера обмена/paste.</li> <li><code>Raw</code> ДОЛЖЕН/МОЖЕТ принимать external share/import при поддержке клиентом/рантаймом.</li> <li>Capture НЕ ДОЛЖЕН зависеть от сетевой доступности.</li> </ul> <h2 id="обогащение-метаданными">Обогащение метаданными<a class="anchor" href="#%d0%be%d0%b1%d0%be%d0%b3%d0%b0%d1%89%d0%b5%d0%bd%d0%b8%d0%b5-%d0%bc%d0%b5%d1%82%d0%b0%d0%b4%d0%b0%d0%bd%d0%bd%d1%8b%d0%bc%d0%b8">#</a></h2> <ul> <li>Для <code>link</code> metadata enrichment МОЖЕТ выполняться асинхронно после capture.</li> <li>Ошибки получения метаданных НЕ ДОЛЖНЫ блокировать завершение capture.</li> <li>Если метаданные недоступны, реализация ДОЛЖНА использовать детерминированный fallback-preview.</li> </ul> <h2 id="lifecycle-и-операции">Lifecycle и операции<a class="anchor" href="#lifecycle-%d0%b8-%d0%be%d0%bf%d0%b5%d1%80%d0%b0%d1%86%d0%b8%d0%b8">#</a></h2> <ul> <li>Реализация ДОЛЖНА поддерживать состояния, эквивалентные <code>new | triaged | promoted | archived</code>.</li> <li>Реализация ДОЛЖНА поддерживать list и смену статусов для triage.</li> <li>Реализация ДОЛЖНА поддерживать явную операцию <code>promote</code> из <code>Raw</code> в <code>Library</code>.</li> </ul> <h2 id="требования-к-promote-flow">Требования к promote-flow<a class="anchor" href="#%d1%82%d1%80%d0%b5%d0%b1%d0%be%d0%b2%d0%b0%d0%bd%d0%b8%d1%8f-%d0%ba-promote-flow">#</a></h2> <ul> <li><code>promote</code> ДОЛЖЕН валидировать, что <code>target_library_id</code> принадлежит тому же <code>account_id</code>.</li> <li><code>promote</code> ДОЛЖЕН быть идемпотентным для одного <code>RawItem</code> и НЕ ДОЛЖЕН создавать дубли при retry.</li> <li><code>promote</code> ДОЛЖЕН сохранять связь с созданной сущностью библиотеки (<code>promoted_content_id</code> или эквивалент origin-link).</li> </ul> <h2 id="mapping-правила-promote">Mapping-правила promote<a class="anchor" href="#mapping-%d0%bf%d1%80%d0%b0%d0%b2%d0%b8%d0%bb%d0%b0-promote">#</a></h2> <ul> <li> <p><code>Raw:text</code></p>