Document Phase 0 scaffold and architecture

This commit is contained in:
2026-07-10 22:48:08 +03:00
parent 39fec46ab6
commit d646c51b90
26 changed files with 8222 additions and 1 deletions

37
PRODUCT.md Normal file
View File

@@ -0,0 +1,37 @@
# Product
## Register
product
## Users
Команды и ведущие встреч, которым нужен лёгкий локальный индикатор повторяющихся фраз во время дейликов и других разговоров. Основной сценарий происходит прямо во время встречи: пользователь должен одним взглядом понимать состояние индекса и управлять прослушиванием, не отвлекаясь на технические детали распознавания речи.
## Product Purpose
Max Index локально слушает выбранный источник звука, находит настроенные русские фразы и превращает каждое подтверждённое срабатывание в понятное изменение индекса и реакцию персонажа. Успех означает, что приложение ощущается как смешной живой индикатор встречи, работает без облака и не превращается в систему записи или полной транскрибации.
## Brand Personality
Живой, ироничный, ненавязчивый. Интерфейс должен быстро сообщать состояние, а характер проявлять через оригинального персонажа и короткие реакции, не через декоративный шум.
## Anti-references
- Тяжёлые панели транскрибации, аналитики и наблюдения за сотрудниками.
- Скрытое прослушивание или интерфейс, который маскирует активный микрофон.
- Техническая консоль с терминами PCM, ONNX и endpointing в основном пользовательском потоке.
- Копирование HUD, спрайтов или визуального языка Doom.
- Универсальный Electron hello-world и безликий SaaS-dashboard.
## Design Principles
1. Лицо, индекс и состояние прослушивания считываются за один взгляд.
2. Каждое действие пользователя имеет немедленный и однозначный результат.
3. Юмор живёт в реакции персонажа, а не мешает управлению встречей.
4. Приватность видима: активное прослушивание нельзя перепутать с паузой.
5. Техническая сложность остаётся за человеческими сообщениями и одним следующим действием.
## Accessibility & Inclusion
Интерфейс должен работать с клавиатуры, иметь заметный focus state и достаточный контраст, не полагаться только на цвет для передачи состояния и уважать `prefers-reduced-motion`. Формальный уровень WCAG пока не заявляется; доступность проверяется как обязательная часть каждого пользовательского среза.