поверхность: черновики, статистика сессии, обрезка журнала, живой ход #8
Loading…
Reference in a new issue
No description provided.
Delete branch "surface-web"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Что это
Бэкенд поверхности, который нужен веб-клиенту на Solid (PR
svuvich/snens-web#2). Ядро, журнал и конфиг не тронуты: всё, что здесь есть,
другим поверхностям (TUI, telegram) не нужно.
Маршруты
GET /v1/drafts— все черновики:{"drafts":[{id,text,updated_at}]}.PUT /v1/drafts/{id}—{"text"}; пустой текст = удаление.GET /v1/sessions/{id}/stats— итоги сессии.POST /v1/sessions/{id}/truncate—{"seq"}: отрезать журнал от репликичеловека.
Зачем каждое
Черновики. Начатое сообщение должно продолжаться на другом устройстве —
localStorage этого не умеет по определению. Храним в SQLite поверхности (не в
журнале сессии и не в конфиге: это состояние интерфейса). Ключ — id сессии
или
new:<поверхность>для ещё не созданной: пустых сессий в журнале быть недолжно, а черновик новой сессии клиент показывает отдельной строкой в списке.
Статистика. Человек спрашивает про сессию целиком: сколько ходов, сколько
стоило, какой кеш-хит-рейт, сколько модель и тулы реально работали. В клиенте
это считать нельзя — перезагрузка окна обнуляла бы цифры, а второй клиент не
видел бы насчитанного первым. Активное время — единственное число, которого нет
в журнале готовым: сумма длительностей ходов по записям
Doneплюс текущий ход.Обрезка. Правка реплики человека означает «переиграть ход с этого места»:
журнал режется по записи
User, текст возвращается в композер. Без этогомаршрута правка была бы только косметикой.
Живой ход
GET …/historyтеперь отдаёт два поля:live— события текущего хода сдельтами текста и рассуждения, и
run_started— время старта хода. Журналпополняется записями по границам шагов, поэтому клиент, открытый посреди хода,
видел только их и терял начало рассуждения до перезагрузки. Буфер живёт в
памяти
Runtime, заполняется вbuild_eventпо границамrun.started/run.finishedи чистится на конце хода; на диск не пишется.Проверки
cargo fmt --check— чисто;cargo clippy --all-targets— без новыхпредупреждений;
cargo test --bin snens surface— 80 тестов, все зелёные.User, вне диапазона,после обрезки), пустой черновик как удаление, чужой ключ — 400, статистика с
пустым журналом и с незакрытым ходом, буфер хода собирает дельты и чистится.
run, перезагрузкапосреди хода — лента собирается из
live, после ходаliveпуст.site/snens.svuvi.ch/content/api.md.Три маршрута в бэкенд поверхности — то, что нужно веб-клиенту и не нужно ядру: - `GET/PUT/DELETE /v1/drafts` — черновики сообщений в SQLite поверхности. Черновик обязан продолжаться на другом устройстве, поэтому он не в localStorage; ключ — id сессии или `new:<поверхность>` для ещё не созданной. - `GET /v1/sessions/{id}/stats` — итоги сессии по журналу: ходы, шаги, вызовы, токены, цена, активное время (сумма длительностей ходов плюс текущий), кеш-хит-рейт. Считается на бэкенде, чтобы переживало перезагрузку окна и совпадало у разных клиентов. - `POST /v1/sessions/{id}/truncate` — отрезать журнал от реплики человека: правка сообщения с повтором. Плюс `history` отдаёт `live` — события текущего хода с дельтами, и `run_started`: без них клиент, открытый посреди хода, видел только записи по границам шагов. Буфер живёт в памяти поверхности и чистится на конце хода. Ядро (журнал, ходы, конфиг) не тронуто; тесты поверхности — на каждый маршрут, включая границы обрезки и пустой черновик как удаление.View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.Merge
Merge the changes and update on Forgejo.Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.