History

heaven 7f3798db0f Amend issued S3.7 prompt after owner review: F-35 i18n task added as caught omission, industry i18n mechanism required, journal pointers synced		2026-08-10 23:52:20 +03:00
..
docs	Amend issued S3.7 prompt after owner review: F-35 i18n task added as caught omission, industry i18n mechanism required, journal pointers synced	2026-08-10 23:52:20 +03:00
public	Accept and land the S3 data layer: contract 0.2.0 in the zone copy, revision gate composed with structural sharing, per-chapter notes, and a seventh partial-failure route	2026-08-08 02:24:06 +03:00
scripts	Land frontend S3.6 second-round fixpack: neutral palette from references, tabs returned to fleet pill, bank as measured table, vojo drag handle; acceptance record, S3.7 debt prompt, rows F-43..F-51	2026-08-10 22:30:45 +03:00
src	Land frontend S3.6 second-round fixpack: neutral palette from references, tabs returned to fleet pill, bank as measured table, vojo drag handle; acceptance record, S3.7 debt prompt, rows F-43..F-51	2026-08-10 22:30:45 +03:00
.gitignore	Land frontend S3.6 second-round fixpack: neutral palette from references, tabs returned to fleet pill, bank as measured table, vojo drag handle; acceptance record, S3.7 debt prompt, rows F-43..F-51	2026-08-10 22:30:45 +03:00
.npmrc	Add self-installing pre-commit gate: frontend commits demand green check, zone-mixing and never-commit files blocked, plus exact version pins and engine-strict npmrc	2026-08-02 19:39:29 +03:00
.prettierignore	Accept and land the S3 data layer: contract 0.2.0 in the zone copy, revision gate composed with structural sharing, per-chapter notes, and a seventh partial-failure route	2026-08-08 02:24:06 +03:00
.prettierrc.json	Land frontend S1: pinned Vite/React/TS scaffold, five-step check with verified colour gate, no-sudo Playwright shot loop, measured tokens.css, showcase converged with Fleet reference	2026-08-02 15:07:34 +03:00
.spectral.yaml	Land S3 contract work: OpenAPI 3.1 spec with generated types and drift test, provenance companion, zone journal rename, contract gate in check battery	2026-08-04 13:03:10 +03:00
eslint.config.js	Accept and land the S3 data layer: contract 0.2.0 in the zone copy, revision gate composed with structural sharing, per-chapter notes, and a seventh partial-failure route	2026-08-08 02:24:06 +03:00
index.html	Land frontend S1: pinned Vite/React/TS scaffold, five-step check with verified colour gate, no-sudo Playwright shot loop, measured tokens.css, showcase converged with Fleet reference	2026-08-02 15:07:34 +03:00
package-lock.json	Accept and land the S3 data layer: contract 0.2.0 in the zone copy, revision gate composed with structural sharing, per-chapter notes, and a seventh partial-failure route	2026-08-08 02:24:06 +03:00
package.json	Land frontend S3.6 second-round fixpack: neutral palette from references, tabs returned to fleet pill, bank as measured table, vojo drag handle; acceptance record, S3.7 debt prompt, rows F-43..F-51	2026-08-10 22:30:45 +03:00
README.md	Land frontend S3.6 second-round fixpack: neutral palette from references, tabs returned to fleet pill, bank as measured table, vojo drag handle; acceptance record, S3.7 debt prompt, rows F-43..F-51	2026-08-10 22:30:45 +03:00
stylelint.config.js	Build the three-panel shell and ui primitives on react-aria-components, virtualise chapter and bank lists at book scale, close the gate and structural-test tails, enable the spacing token gate	2026-08-04 01:45:17 +03:00
tsconfig.json	Land frontend S1: pinned Vite/React/TS scaffold, five-step check with verified colour gate, no-sudo Playwright shot loop, measured tokens.css, showcase converged with Fleet reference	2026-08-02 15:07:34 +03:00
vite.config.ts	Accept and land the S3 data layer: contract 0.2.0 in the zone copy, revision gate composed with structural sharing, per-chapter notes, and a seventh partial-failure route	2026-08-08 02:24:06 +03:00

README.md

frontend — веб-интерфейс

Зона записи сессий «Фронт». Пройдены S0 (план), S1 (инструменты, скриншот-цикл, токены, витрина), S2 (оболочка трёх панелей и слой src/ui/), S3 (слой данных на контракте API) и S3.5 (фикс-пак оболочки по 24 замечаниям владельца). Продуктовых экранов ещё нет — они на S4–S7 (docs/BACKLOG.md, Ф-1).

Как запустить

npm install
npm run dev          # http://localhost:5173/showcase
npm run check        # prettier → eslint → stylelint → contract → tsc → vitest
npm run check:full   # + сборка + скриншоты
npm run shot         # снимки в .shots/ — открыть и посмотреть глазами
npm run scenes       # сценарии интеракций: клик → кадр → проверка состояния

Маршрутов семь, и все снимаются (/showcase /scale /empty /loading /error /offline /partial) — маршрут выбирает мир фикстур. Новый экран заводится вместе с маршрутом и строкой в scripts/shot.mjs — расхождение двух списков падает тестом.

Два ключа снимка стоит знать: --size 1280x764 даёт вьюпорт референса для прямого наложения, --dpr 1 снимает то, что видит владелец на своём мониторе (при дефолтных 2x полупиксель CSS ложится в целый пиксель устройства, и мыло на штрихах иконок в кадр не попадает вовсе). Замер кадра — python3 scripts/measure.py references/fleet.png .shots/showcase.png.

Для скриншот-цикла нужен Chromium Playwright и локальные библиотеки в .tooling/ (ставятся без sudo, процедура — docs/FRONTEND_PLAN.md §4).

npm install заодно ставит pre-commit хук (scripts/githooks/): коммит с frontend-путями не проходит без зелёного npm run check; смесь frontend/ с чужой зоной и файлы «никогда не коммитить» блокируются для всех (D39.88). Обход — git commit --no-verify.

Что здесь будет

Веб-приложение поверх ../platform/. MVP — не IDE, а дашборд + читалка: библиотека книг, наблюдение за прогоном, подпись банка памяти, сравнение оригинала с переводом, добавление главы. Редактирование перевода прямо в интерфейсе — ПОЗЖЕ (тогда появится редактор текста; в MVP не нужен).

Десктоп — то же самое приложение в окне (Tauri), отдельной логики не имеет. В MVP не делается.

Документы

docs/FRONTEND_SESSION_PROMPT.md — промт фронт-сессий: область этапов, референсы с измеренными значениями, экраны, ограничения, порядок работы.
docs/STACK_DECISIONS.md — пины версий, ловушки и список того, что достраивается в движке. Источник: многоагентное исследование 02.08.2026.
docs/FRONTEND_PLAN.md — план S0: сверенные пины, карта src/, слои каскада, правила поддерживаемости в проверяемой форме, протокол скриншот-цикла, перепроверенные замеры референса и список расхождений витрины.
docs/frontend-PROGRESS.md — журнал зоны: текущее состояние, решения владельца по продукту, открытые вопросы, хроника сессий. Имя с префиксом frontend- намеренно: журнал оркестратора называется docs/PROGRESS.md, и одноимённые файлы путали ссылки. Прогресс фронта пишут сюда все, включая оркестратора (слово владельца 04.08).
docs/BACKLOG.md — зонный бэклог фронта.
docs/API_CONTRACT_INPUT.md — ⚠ исполнено, не поддерживается: вход в контракт, написанный до него. Всё содержимое ушло в спеку и спутник ниже; остаётся как аудиторский след (как каждая просьба выводилась из кода движка), место ему в docs/archive/.
docs/api-contract/openapi.yaml — сам контракт v0, OpenAPI 3.1: нормативная поверхность. Линтуется spectral шестым шагом npm run check, из неё генерится src/api/schema.ts. Черновик на ратификацию: дом готовой копии — docs/architecture/14-api-contract/, зона оркестратора.
docs/API_CONTRACT_DRAFT.md — спутник спеки: откуда взято каждое решение (выведено из кода движка · предложено фронтом · открыто), обоснования, зависимости и двенадцать открытых вопросов. При расхождении по форме побеждает YAML, при вопросе «почему так» — этот файл.
references/ — три скриншота-референса (Fleet, Antigravity).

Источник внешнего вида — один

Замеры с references/fleet.png, зафиксированные в tokens.css. Промежуточных дизайн-макетов нет: инструменты проектирования макетов не используются (решение владельца 02.08). Палитра и геометрия сняты с референса пипеткой и лежат в STACK_DECISIONS.md и §1.1 промта — их берут как данность, а не выводят заново.