Files
fparkan/docs/baseline/notion-reconciliation.md

7.8 KiB
Raw Permalink Blame History

Сверка локальной книги с FParkan в Notion

Проверка выполнена 18 июля 2026 года по странице FParkan, её восьми томам, плану Vulkan revision и приложениям A--D. Цель — не копировать структуру Notion, а убедиться, что каждый доказательный контракт доступен в docs/ и остается применимым к Windows/Vulkan scope.

Notion Локальное место
Статьи 1--3 tomes/01-guide.md
Статьи 4--8 tomes/02-architecture.md
Статьи 9--13 tomes/03-resources.md и reference/
Статьи 14--18 tomes/04-world.md и reference/tma.md
Статьи 19--27 tomes/05-render.md, reference/ и rendering/
Статьи 28--32 tomes/06-behavior.md
Статьи 33--37 tomes/07-implementation.md и baseline/vulkan-revision-plan.md
Статьи 38--42 tomes/08-evidence.md, appendices/glossary.md, evidence/
Приложение A этот audit, baseline/current-project-audit.md и тематические тома
Приложение B appendices/ui-shell.md
Приложение C appendices/saves-campaign.md
Приложение D appendices/script-vm.md

В ходе сверки добавлены отсутствовавшие локальные контракты UI/Shell, сохранений/campaign и Script VM. Повторы не переносились: форматы, ABI и corpus statistics уже находятся рядом с соответствующими readers/consumers.

Не перенесены только противоречащие утвержденному scope цели: Linux, macOS, MoltenVK, GLES/RG40XX и hosted CI. Они не считаются пробелами. Текущие доказательства Windows/Vulkan и все последующие уточнения ведутся только в локальных файлах.

Повторная содержательная сверка (18 июля 2026)

Повторная сверка проверяет не количество дочерних страниц в Notion, а утверждения, которые они добавляют к реализации. Источником были корневая страница FParkan, восемь оглавлений с 42 статьями, а также две специальные страницы: План реализации stage 05: Vulkan revision (редакция 18 июля) и Ревью перехода на Vulkan: решение, доказательства и ограничения.

Контракт из Notion Локальное подтверждение Результат
Статьи 1–3: терминология, уровень доказательств, методика tomes/01-guide.md Полностью покрыто.
Статьи 48: bootstrap, DLL, frame loop, World3D tomes/02-architecture.md Полностью покрыто.
Статьи 913: VFS, NRes, RsLi, registry, unit и auxiliary formats tomes/03-resources.md и reference/ Полностью покрыто.
Статьи 1418: TMA, mission loader, Land, ArealMap и world construction tomes/04-world.md, reference/tma.md, reference/msh.md Полностью покрыто.
Статьи 1927: Ngi32, MSH, animation, MAT0/WEAR/Texm, terrain и кадр tomes/05-render.md, reference/, rendering/ Покрыто; локально дополнено более свежими evidence по D3D7 camera, Node38 и Terrain/GetShade.
Статьи 2832: AI, control, camera, audio, network tomes/06-behavior.md, appendices/script-vm.md Полностью покрыто.
Статьи 3337 и Vulkan revision: ports, stages, deterministic gates, Vulkan profile tomes/07-implementation.md, baseline/vulkan-revision-plan.md Полностью покрыто в Windows-only редакции.
Статьи 38–42 и приложения AD: ABI, corpus, knowledge boundaries, glossary, shell, saves, VM tomes/08-evidence.md, appendices/, evidence/, этот audit Полностью покрыто.

Пропущенных применимых технических контрактов в этом срезе не найдено. В частности, локальный Vulkan plan уже содержит независимость решений Vulkan и winit, Vulkan 1.1 baseline, ash-изоляцию, SPIR-V manifest/hash, capability gates, canonical RGBA8 upload и первичность backend-neutral command capture. Не переносились только исторические cross-platform acceptance требования из Notion: они прямо отменены текущим Windows-only scope, а не потеряны при синхронизации.

Следовательно, новые факты следует добавлять непосредственно в тематический локальный документ; повторный перенос дерева или дублирование страниц Notion не требуется.

Проверяемые источники и правило разрешения расхождений

Содержательная сверка опирается не только на оглавления. Были прочитаны корневая страница FParkan, оглавления томов I--VIII и актуальные специальные страницы Vulkan revision, Vulkan review, а также исторические статьи 33--34. Это позволяет отличить контракт от исторического статуса работы.

  • В локальной книге сохранены применимые контракты Vulkan revision: Windows как единственная acceptance-платформа, Vulkan 1.1 baseline, изоляция ash/raw handles в adapter-е, capability gates, offline SPIR-V и первичность backend-neutral command capture.
  • Не переносится прежний статус-аудит Notion (например, утверждения о synthetic-only renderer или незакрытом Windows smoke): он описывал состояние до последующих локальных captures и потому не является спецификацией.
  • Не переносятся Linux, macOS/MoltenVK и portability-enumeration требования. Это сознательно исключённая область, а не пробел документации.
  • Если страница Notion и свежий локальный evidence расходятся, локальный evidence с командой воспроизведения, артефактом и датой имеет приоритет; спорный факт отмечается как граница знания, пока не будет перепроверен.

Таким образом, на момент сверки не обнаружено пропущенных применимых технических контрактов: содержательные добавления из Notion уже разнесены по тематическим локальным документам, а новые результаты разработки должны добавляться только локально.