Skip to content

docs: define D1.4 two-book product architecture#31

Merged
sunpole merged 13 commits into
mainfrom
docs/two-book-architecture-d1.4
Jul 24, 2026
Merged

docs: define D1.4 two-book product architecture#31
sunpole merged 13 commits into
mainfrom
docs/two-book-architecture-d1.4

Conversation

@sunpole

@sunpole sunpole commented Jul 23, 2026

Copy link
Copy Markdown
Owner

Цель

Завершить architecture-only этап D1.4: определить безопасную работу uDream с двумя исходными книгами до extraction второй базы и до любой реализации selector, combined search или side-by-side comparison.

Что добавлено

  • docs/TWO_BOOK_ARCHITECTURE.md;
  • machine-readable docs/two-book-architecture.json;
  • permanent scripts/validate-two-book-architecture.mjs;
  • CI-проверка архитектурного контракта;
  • factual patchnote 23.8.11;
  • новый real PNG, относящийся именно к D1.4.

Главные решения

  • default остаётся ru-current-v1;
  • второй сохранённый PDF пока не является registered dataset;
  • global identity: (dataset_id, record_id);
  • первый будущий режим — separate dataset switching;
  • combined search — federated по отдельным indexes без destructive JSON merge;
  • comparison — только через explicit reviewed relation map;
  • URLs, history и sharing сохраняют dataset identity;
  • activation атомарная, с автоматическим fallback к ru-current-v1;
  • unrelated origin caches не затрагиваются.

Границы

Не изменяются:

  • существующие файлы data/;
  • runtime и PWA;
  • Service Worker и package metadata;
  • versions/;
  • _archive/;
  • текущие 4 086 записей.

Проверки

  • regression tests;
  • project/provenance/registry/audit validators;
  • new two-book architecture validator;
  • patchnote/new-image validation;
  • JavaScript syntax checks;
  • полный review changed files и protected paths перед merge.

Issue

Closes #30 после успешного merge и финального READY-handoff.

@sunpole
sunpole marked this pull request as ready for review July 23, 2026 08:13

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

https://github.com/sunpole/udream/blob/24bf2f828368ecd7a07a67e94699d7bd879c6c37/docs/two-book-architecture.json#L346-L350
P2 Badge Include activation failure in automatic fallback

The human-readable contract requires automatic fallback for an activation failure, but the machine-readable automatic_on list omits that condition. A failure after validation while atomically activating a new dataset would therefore have no mandated recovery path for future consumers of this JSON (and the new validator does not detect the mismatch), despite the architecture's required stable-fallback behavior; add and validate an activation-failure trigger.

AGENTS.md reference: AGENTS.md:L219-L225

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread ROADMAP.md
See `docs/DATA_QUALITY_AUDIT.md` and `reports/data-quality-audit.md`.

## Next approved work: D1.4 two-book product architecture
## Completed: D1.4 two-book product architecture v23.8.11

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Synchronize all project status documents

Marking D1.4 complete here leaves the repository's other current-state sources contradictory: README.md still reports the 23.8.10 baseline and says D1.4 is next, docs/PRODUCT_VISION.md, docs/PROJECT_STATE.md, and docs/TRANSLATION_WORKFLOW.md likewise still present D1.4 as pending, and CHANGELOG.md has no 23.8.11 entry. This can send the next handoff or planning task down an already-completed phase; update those maintained documents together with this milestone.

AGENTS.md reference: AGENTS.md:L199-L203

Useful? React with 👍 / 👎.

@sunpole
sunpole merged commit 897f89a into main Jul 24, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

D1.4: спроектировать архитектуру двух книг без изменения runtime

1 participant