Rekeeply Specification#

Спецификация описывает core-контракт и клиентские реализации для личной системы управления контентом: единое хранение материалов, прогресс, заметки и быстрый поиск.

Цель — превратить хаотичное “на потом” в управляемый поток: сохранить -> пройти -> зафиксировать -> быстро найти.

Общая архитектура системы#

Режим по умолчанию (offline-first, fastest)
-------------------------------------------

    +---------+     in-process calls     +----------------+
    |   CLI   | -----------------------> |  Core runtime  |
    +---------+                          |   (embedded)   |
                                         +--------+-------+
                                                  |
                                                  | local DB I/O
                                                  v
                                         +----------------+
                                         |  Local Vault   |
                                         | (encrypted DB) |
                                         +----------------+

Опциональный режим синхронизации
--------------------------------

    +----------------+      secure sync      +----------------+
    |  Local Vault   | <-------------------> | Remote Service |
    +----------------+                       +----------------+


Правила сессии
--------------

    account
      |
      +-- library A
      +-- library B

    active session -> exactly one account context
    library operations -> exactly one active library

Базовая модель хранения
-----------------------

    Library (structured) + Raw (quick capture)