verstak/docs/05_UI_UX.md

Верстак — UI/UX

1. Главный экран — Сегодня

Сегодня
──────────────────────────────

Активные дела:
[ООО Ромашка / Сайт]       примерно 3ч     12 следов    [подтвердить]
[sshkeeper]                42м             5 следов     [открыть]
[Документы / Договоры]     3 новых файла   разобрать    [разобрать]

Неразобранное:
- screenshot_2026-05-30.png
- dogovor-final2.docx
- backup-site-old.zip
- import/dokuwiki/mysql-cleanup.txt

Быстрые действия:
[Новое дело] [Быстрая заметка] [Добавить файл] [Импорт DokuWiki] [Sync] *(future)*

2. Общий layout

┌───────────────┬────────────────────────────────────┐
│ Tree sidebar  │ Header: Section/Node Title           │
│               ├────────────────────────────────────┤
│ Сегодня       │ Main content                        │
│ Клиенты       │ Case / Note / File / Search         │
│ Проекты       │                                    │
│ Рецепты       │                                    │
│ Документы     │                                    │
└───────────────┴────────────────────────────────────┘

*Примечание: Quick Add и Sync Status из оригинального макета пока не реализованы — в планах на будущее.*

3. Sidebar tree

Сегодня
Неразобранное

Клиенты
  ООО Ромашка
    Сайт
    Почта
    Договоры

Личные проекты
  sshkeeper
  Tyaplyapiya

Рецепты
  MySQL
  Сайты

Документы
  Служебки
  Договоры
  Серийники

Архив

4. Экран дела

ООО Ромашка / Сайт
──────────────────────────────

Описание:
Сайт клиента. WordPress/nginx. Иногда обновление витрины, формы, почта.

Быстрые действия:
[Открыть сайт] [Открыть админку] [Открыть sshkeeper] [Открыть папку] [Добавить работу]

Последнее:
2026-05-30 — обновление витрины, баннеры, проверка — примерно 3ч
2026-05-12 — чистка кеша и проверка формы — 40м

Вкладки:
Обзор | Заметки | Файлы | Документы | Скрипты | Действия | Журнал | Активность

5. Заметки

• список заметок;
• Markdown editor;
• preview;
• save;
• move;
• rename;
• search within note later.

6. Файлы и документы

Actions:

• add file;
• drag & drop;
• copy into vault;
• link external;
• open with system app;
• show in folder;
• delete to trash;
• rename;
• move.

MVP:

• preview только для markdown;
• системное открытие для office/pdf/images.

Later:

• image preview;
• PDF preview;
• thumbnails;
• document metadata.

7. Действия

Вкладка Actions:

Открыть сайт          open_url
Открыть админку       open_url
Открыть sshkeeper     run_command
Открыть папку         open_folder
Backup сайта          run_script, confirm required

При опасном action:

Команда:
./backup-site.sh

Рабочая папка:
.../clients/romashka/scripts

[Запустить] [Отмена]

8. Журнал работ

2026-05-30
3ч, примерно
Обновил витрину сайта, товары, баннеры, проверил отображение.

2026-05-12
40м
Почистил кеш и проверил форму обратной связи.

Кнопки:

• add entry;
• edit;
• copy report;
• mark billable;
• approximate/exact.

9. Активность

14:05 opened admin.romashka.ru
14:18 opened catalog.xlsx
14:44 changed price-list.csv
15:58 sshkeeper profile romashka-vps
16:40 opened romashka.ru/catalog

Suggestion:

Похоже, работа по Ромашка / Сайт:
14:05–17:12, примерно 3ч.

[Записать] [Изменить] [Игнорировать]

10. Поиск

Search results:

[Recipe] Рецепты / MySQL / Очистка таблиц
[Note] Клиенты / Ромашка / mysql-cleanup.md
[Script] Клиенты / Петров / scripts/cleanup.sql
[Worklog] 2026-04-28 — удалял старые записи из таблиц

11. Неразобранное

Туда попадают:

• импортированные DokuWiki pages;
• файлы без дела;
• папки из scan work;
• конфликты sync;
• activity suggestions без уверенного дела.

Actions:

• создать дело;
• привязать к делу;
• переместить;
• архивировать;
• игнорировать;
• удалить в trash.

12. TUI UX

TUI нужен для быстрого:

• fuzzy search;
• открыть дело;
• добавить worklog;
• запустить action;
• sync now.

Не нужно делать в TUI:

• импорт DokuWiki;
• сложный conflict resolver;
• preview документов;
• настройки sync.

13. CLI UX

CLI команды:

verstak sync
verstak index rebuild
verstak import-dokuwiki --pages /path/data/pages
verstak log "Ромашка" --time 3h --text "Обновил витрину"
verstak open "sshkeeper"
verstak action run "Ромашка/Открыть сайт"