verstak/docs/05_UI_UX.md

246 lines
6.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Верстак — UI/UX
## 1. Главный экран — Сегодня
```text
Сегодня
──────────────────────────────
Активные дела:
[ООО Ромашка / Сайт] примерно 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
```text
┌───────────────┬────────────────────────────────────┐
│ Tree sidebar │ Header: Section/Node Title │
│ ├────────────────────────────────────┤
│ Сегодня │ Main content │
│ Клиенты │ Case / Note / File / Search │
│ Проекты │ │
│ Рецепты │ │
│ Документы │ │
└───────────────┴────────────────────────────────────┘
*Примечание: Quick Add и Sync Status из оригинального макета пока не реализованы — в планах на будущее.*
```
## 3. Sidebar tree
```text
Сегодня
Неразобранное
Клиенты
ООО Ромашка
Сайт
Почта
Договоры
Личные проекты
sshkeeper
Tyaplyapiya
Рецепты
MySQL
Сайты
Документы
Служебки
Договоры
Серийники
Архив
```
## 4. Экран дела
```text
ООО Ромашка / Сайт
──────────────────────────────
Описание:
Сайт клиента. 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:
```text
Открыть сайт open_url
Открыть админку open_url
Открыть sshkeeper run_command
Открыть папку open_folder
Backup сайта run_script, confirm required
```
При опасном action:
```text
Команда:
./backup-site.sh
Рабочая папка:
.../clients/romashka/scripts
[Запустить] [Отмена]
```
## 8. Журнал работ
```text
2026-05-30
3ч, примерно
Обновил витрину сайта, товары, баннеры, проверил отображение.
2026-05-12
40м
Почистил кеш и проверил форму обратной связи.
```
Кнопки:
- add entry;
- edit;
- copy report;
- mark billable;
- approximate/exact.
## 9. Активность
```text
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:
```text
Похоже, работа по Ромашка / Сайт:
14:0517:12, примерно 3ч.
[Записать] [Изменить] [Игнорировать]
```
## 10. Поиск
Search results:
```text
[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 команды:
```bash
verstak sync
verstak index rebuild
verstak import-dokuwiki --pages /path/data/pages
verstak log "Ромашка" --time 3h --text "Обновил витрину"
verstak open "sshkeeper"
verstak action run "Ромашка/Открыть сайт"
```