Снимок локальной main: API-сервер, use-cases, PostgreSQL (не вливать до конца работ агента) #2
Loading…
Reference in a new issue
No description provided.
Delete branch "release/local-main-20261119"
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?
Что это
Ветка-снимок локальной (15 коммитов поверх ): рабочий HTTP-сервер , перевод операций на use-cases, PostgreSQL как основное хранилище, миграции очереди.
Зачем
Зафиксировать текущее состояние разработки на сервере, не трогая : агент параллельно ведёт карточки в отдельных worktree, и обновление сейчас сломало бы ему базовую ветку. Слияние — отдельным решением, когда очередь карточек закроется.
Проверка
Не проверялось в этом PR: ветка снята как есть. Деплой на canontrace.help собран из (лендинг + демо-рабочая область).
Зачем: уложиться в дедлайн и получить работающий продукт для поиска дефектов вместо обсуждения архитектуры. Поднят процесс `canontrace-server`: все 127 операций каталога имеют маршрут и работают против файлового хранилища; маршруты и заглушки выведены из `contract/capabilities.json` + `openapi.json` (`tools/mvp/gen-areas.mjs`), DTO строятся по схемам контракта (`dto::shape`), движок задач разбирает документы, прогоняет детерминированные правила канона и собирает выгрузки. Проверено: `smoke.mjs` 32/32, `coverage.mjs` — 0 ответов 404/501/5xx на 127 операций, 131 юнит-тест зелёный. Файлы: - crates/canon-api/src/{state,seed,dto,ops,engine}.rs — состояние, демо-наполнение, формы DTO из контракта, общий слой обработчиков, движок задач; - crates/canon-api/src/bin/canontrace-server.rs — процесс; - crates/canon-api/src/{auth,org,project,document,canon,analysis,billing,admin,export,sync,extensions}/mod.rs — обработчики 127 операций, маршруты из каталога; - crates/canon-api/src/router.rs, lib.rs, Cargo.toml — сборка областей, зависимости; - tools/mvp/{gen-areas,smoke,coverage}.mjs, tools/mvp/HANDLERS.md — генератор и проверки; - MVP.md — как запустить, что работает, чего нет; - decisions/2026-11-19.md — решения классов A–D по MVP (строки 16:20); - .gitignore — локальные каталоги данных MVP.Зачем: правила канона и инварианты жили в обработчиках HTTP, поэтому второй транспорт (MCP, воркер, синхронизация) получил бы их копию. Теперь они записаны один раз: домен держит типы и инварианты, адаптер `canon-rules` — сами правила как чистую функцию без хранилища и времени. Файлы: - crates/canon-domain/src/{lib,error,tenancy,org,project,version,entity,evidence, claim,finding,event,decision,workflow,subject,testing}.rs — 14 модулей: агрегаты (организация, участник, проект, сущность, утверждение, находка, событие, решение, задача), инварианты (последний владелец, слияние сущностей, диапазон цитаты, переходы статусов, CAS), граница тенанта, ключ субъекта, доменные ошибки с отображением в коды реестра; 74 теста; - crates/canon-rules/** — движок четырёх правил как чистая функция: снимок канона и момент проверки на входе, черновики находок на выходе; 54 теста; - crates/canon-api/src/engine.rs — правила больше не дублируются: слой собирает снимок, выдаёт находкам id и статус, пишет в хранилище; - crates/canon-api/Cargo.toml — зависимости на canon-domain и canon-rules; - migrations/postgres/0100_identity.{up,down}.sql — идентичность, доступ, организации, участники, приглашения, сессии, токены, устройства (POSTGRES §3) плюс триггер «последний владелец не понижается»; - migrations/postgres/0200_documents.{up,down}.sql — проекты, документы, ревизии, попытки разбора, спаны, конфигурация поиска russian_norm (POSTGRES §4, §9); - crates/canon-api/src/{seed,project,admin,analysis,export}/mod.rs, MVP.md — демо-идентификаторы приведены к канонической форме ULID: прежние литералы содержали запрещённый Crockford символ `O`, из-за чего `Id::parse` их отвергал и проверка канона на демо-проекте не запускалась.Зачем: use-case и адаптеры должны зависеть от трейтов, а не от SDK. Пока портов не было, обработчики HTTP работали с хранилищем напрямую, и заменить его на PostgreSQL без переписывания слоя было нельзя. Файлы: - crates/canon-ports/src/{lib,future,error,page}.rs — карта, боксованный future (dyn-совместимость), один тип ошибки порта, страница; - crates/canon-ports/src/{projects,documents,parser,search,blob,queue,models, decisions,mcp,reports,vault,events,usage,clock}.rs — 15 трейтов, 49 методов; - crates/canon-ports/src/testing.rs — 14 in-memory реализаций для тестов и сборки без БД и сети; - crates/canon-ports/Cargo.toml — зависимости canon-contract и canon-domain. 106 тестов, слоистость и verify зелёные.Зачем: движок задач жил в слое HTTP (engine::spawn), поэтому задача не могла исполняться без процесса API, а пауза и отмена были договорённостью внутри одного файла. Теперь задача — рабочий процесс домена, исполнение — воркер, а слой HTTP только ставит задачу в очередь. Файлы: - crates/canon-worker/src/{dispatcher,worker,handler,ports,registry,executor, inputs,lib}.rs — цикл воркера, шов рантайма, контекст задачи с прогрессом, чекпойнтом и heartbeat; - crates/canon-worker/src/handlers/{parse,analysis,export,excel_import, data_export}.rs — обработчики видов задач (перенос поведения engine.rs); - migrations/postgres/{0300_queue,0310_usage,0320_retention,0800_rls, 0900_sync}.{up,down}.sql — очередь задач, расход, retention, RLS-политики, журнал синхронизации; - crates/canon-store-postgres/** — репозитории поверх этих миграций. 40 тестов воркера, слоистость зелёная.Зачем: слой application был пуст — обработчики HTTP вызывали хранилище напрямую, поэтому граница транзакции нигде не была объявлена, а второй транспорт получил бы свою копию последовательности шагов. Файлы: - crates/canon-app/src/{project,canon,analysis,org,auth,billing,retention, export,sync}/mod.rs — 21 команда; в доке каждой — таблица «шаг -> отказ -> следствие», то есть граница транзакции объявлена явно; - crates/canon-app/src/lib.rs — карта команд и доктрина «use-case — граница транзакции», проверка подстановки всех in-memory портов; - crates/canon-app/tests/full_cycle.rs — проект -> импорт -> анализ -> находка -> решение -> отчёт на in-memory адаптерах; - crates/canon-app/src/analysis/mod.rs — трейт RuleEngine: application не может зависеть от adapter (canon-rules), поэтому форма вызова объявлена здесь; - crates/canon-api/src/composition.rs — адаптер canon-rules к RuleEngine в точке сборки; идентификаторы находок выводятся из содержимого, поэтому повторный прогон даёт те же находки, а не новые; - crates/canon-store-postgres/** — репозитории поверх миграций. 78 тестов приложения, 107 тестов API, слоистость зелёная.Зачем: обработчики писали в хранилище напрямую, поэтому use-case команды нельзя было вызвать из HTTP, а замена хранилища требовала правки каждой операции. Теперь у портов есть реализации поверх того же store.json, и область project работает через команды canon-app. Файлы: - crates/canon-api/src/adapters/{mod,mapping,projects,documents,blobs,jobs,events, usage,search,reports}.rs — реализации ProjectRepository, DocumentStore, BlobStore, JobQueue, EventBus, UsageMeter, SearchIndex, ReportWriter поверх файлового хранилища; отображение записей в доменные типы собрано в mapping; - crates/canon-api/src/state.rs — StoreHandle, ленивые порты, демо-организация; - crates/canon-api/src/ops.rs — помощники scope/path_id/body_id/port_error; - crates/canon-api/src/project/mod.rs — create/update/delete/restore/duplicate идут через CreateProject/UpdateProject/DeleteProject/RestoreProject; сводка проекта (настройки, ветка) дописывается без второго инкремента версии. Проверено: smoke 32/32, coverage 127 операций без 404/501/5xx, 173 теста API.Зачем: `CANON_STORE=postgres` переключает процесс на PostgreSQL — пул, транзакция на изменение с `SET LOCAL app.org_id` (ADR-050), CAS по версии строки. Мост `store_rows`/`store_rows_public` держит те же таблицы-записи, что и `store.json`, поэтому все 127 операций работают без переписывания; целевые таблицы пишутся стадиями S3–S9, мост убирается на S10. Файлы: - migrations/postgres/0110_store_rows.{up,down}.sql — таблицы моста, пара накат/откат; - crates/canon-store-postgres/src/store/ — сессия запроса (`Direct`, `PgRowStore`), CAS-запись, белый список §7 и тест сверки со списком `0800_rls`; - crates/canon-api/src/adapters/pgstore.rs — приёмник строк на своей нити с собственным соединением (пул на два рантайма не возвращает соединения); - crates/canon-api/src/middleware/pgstore.rs — транзакция и контекст тенанта на запрос; - crates/canon-api/src/state.rs — `StoreBackend`, `RowSink`, `diff`/`reset`, `begin_write` для фонового движка; - decisions/2026-11-19.md — 7 решений класса B/D по B1. Проверено: `smoke.mjs --spawn` 32/32 в обоих режимах, `coverage.mjs --spawn` 127 операций без 404/501/5xx, `cargo test --workspace --offline` зелёный, живые тесты PostgreSQL 9/9, `xtask verify --migrations` 11 миграций обратимы.45fda7652b723b0cda3cЗачем: схема доведена до 79 таблиц POSTGRES §3–§8 с RLS на всех тенант-таблицах; задачи исполняет отдельный процесс; OIDC и клиент sidecar-разбора перестали быть каркасами. Гейты: 127 операций без 404/501/5xx в обоих режимах хранилища, изоляция двух организаций без нарушений. Файлы: - migrations/postgres/0330, 0400–0430, 0500, 0600, 0700, 0810–0840, 0910, 0920 — таблицы §3–§8, пары накат/откат; RLS на таблицах после 0800 ставится в самих миграциях; `time_bucket` переписан на immutable-выражение; - crates/canon-store-postgres/src/store/ — мост строк, белый список §7 (`orgs`), сессия `Direct`, CAS; - crates/canon-api/src/adapters/{pg_claim,pgstore}.rs — забор задачи `FOR UPDATE SKIP LOCKED`, приёмник строк с записью по организации строки, `NOTIFY` с идентификатором процесса; - crates/canon-api/src/bin/canontrace-worker.rs — отдельный процесс-воркер; - crates/canon-api/src/{state,engine,middleware/pgstore}.rs — транзакция на изменение, контекст тенанта, прогресс задачи прямой записью; - crates/canon-security/src/session/ — OIDC: JWT, JWKS с кэшем, RS256 на чистом Rust, refresh с ротацией, dev-токен только локально; - crates/canon-parser-client/ — HTTP-клиент sidecar, перевод в `ParsedDocument` с валидацией ответа; - services/parsers/ — sidecar разбора PDF/DOCX/OCR с лимитами и тестами; - tools/mvp/isolation.mjs — проверка изоляции двух организаций. Проверено: `cargo test --workspace --offline` (65 блоков), живые тесты PostgreSQL 9/9, `smoke.mjs --spawn` 32/32 и `coverage.mjs --spawn` 127/0×404 в обоих режимах, `isolation.mjs` без нарушений, `xtask verify` 6/6, `--migrations` 25 пар, `deps check` чистый, `cargo check --all-targets` без предупреждений.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.