49 lines
3.8 KiB
Markdown
49 lines
3.8 KiB
Markdown
# frontend — веб-интерфейс
|
||
|
||
Зона записи сессий «Фронт». Пройдены этапы S0 (план) и S1 (инструменты, скриншот-цикл, токены,
|
||
витрина); продуктовых экранов ещё нет — они на S2–S7 (`docs/BACKLOG.md`, Ф-1).
|
||
|
||
## Как запустить
|
||
|
||
```bash
|
||
npm install
|
||
npm run dev # http://localhost:5173/showcase
|
||
npm run check # prettier → eslint → stylelint → tsc → vitest
|
||
npm run check:full # + сборка + скриншот
|
||
npm run shot # снимок витрины в .shots/ — открыть и посмотреть глазами
|
||
```
|
||
|
||
Для скриншот-цикла нужен Chromium Playwright и локальные библиотеки в `.tooling/`
|
||
(ставятся без sudo, процедура — `docs/FRONTEND_PLAN.md` §4).
|
||
|
||
## Что здесь будет
|
||
|
||
Веб-приложение поверх `../platform/`. MVP — не IDE, а **дашборд + читалка**: библиотека книг,
|
||
наблюдение за прогоном, подпись банка памяти, сравнение оригинала с переводом, добавление главы.
|
||
Редактирование перевода прямо в интерфейсе — ПОЗЖЕ (тогда появится редактор текста; в MVP не нужен).
|
||
|
||
Десктоп — то же самое приложение в окне (Tauri), отдельной логики не имеет. В MVP не делается.
|
||
|
||
## Документы
|
||
|
||
- [`docs/FRONTEND_SESSION_PROMPT.md`](docs/FRONTEND_SESSION_PROMPT.md) — промт фронт-сессий:
|
||
область этапов, референсы с измеренными значениями, экраны, ограничения, порядок работы.
|
||
- [`docs/STACK_DECISIONS.md`](docs/STACK_DECISIONS.md) — пины версий, ловушки и список того,
|
||
что достраивается в движке. Источник: многоагентное исследование 02.08.2026.
|
||
- [`docs/FRONTEND_PLAN.md`](docs/FRONTEND_PLAN.md) — план S0: сверенные пины, карта `src/`,
|
||
слои каскада, правила поддерживаемости в проверяемой форме, протокол скриншот-цикла,
|
||
перепроверенные замеры референса и список расхождений витрины.
|
||
- [`docs/PROGRESS.md`](docs/PROGRESS.md) — журнал зоны: текущее состояние, решения владельца
|
||
по продукту, открытые вопросы, хроника сессий.
|
||
- [`docs/BACKLOG.md`](docs/BACKLOG.md) — зонный бэклог фронта.
|
||
- `references/` — три скриншота-референса (Fleet, Antigravity).
|
||
|
||
## Источник внешнего вида — один
|
||
|
||
**Замеры с `references/fleet.png`, зафиксированные в `tokens.css`.** Промежуточных дизайн-макетов
|
||
нет: инструменты проектирования макетов не используются (решение владельца 02.08). Палитра и
|
||
геометрия сняты с референса пипеткой и лежат в `STACK_DECISIONS.md` и §1.1 промта — их берут
|
||
как данность, а не выводят заново.
|
||
|
||
⚠ JetBrains Fleet закрыт (скачивание прекращено 22.12.2025) — добрать новые измерения неоткуда.
|
||
Всё, что не замерено (кегли, интерлиньяж, внутренние отступы), подбирается на глаз по скриншоту.
|