# Верстак — описание продукта

## 1. Проблема

У фрилансеров, мастеров, разработчиков и мейкеров есть много
разнородной рабочей информации:

- клиентские проекты и переписка;
- договоры, счета, акты;
- заметки и инструкции;
- скриншоты и фото;
- скрипты и конфиги;
- доступы и серийники;
- файлы с правками и версиями.

Проблема не в хранении. Проблема в **контексте**:

- что к чему относится;
- где актуальная версия;
- что было сделано в прошлый раз;
- сколько времени ушло;
- где договор, где заметка, где скрипт.

Обычные инструменты закрывают только кусок: Obsidian — заметки,
CRM — продажи, таймтрекер — время, файловый менеджер — файлы без смысла.

## 2. Что такое Верстак

**Верстак** — local-first рабочий vault, где всё организовано вокруг "дел".

Дело — это контекст, в который складываются заметки, документы,
файлы, действия и история работы.

**Главная формула:**

> Верстак — локальная программа, где по каждому клиенту или проекту
> лежат все его файлы, заметки, документы, ссылки, действия и история работ.

## 3. Аудитория

Верстак нужен людям, у которых работа идёт через **дела**, а не через задачи.
Есть люди, которым нужен таск-трекер (task → done). А есть люди,
которым нужно место, где накапливается контекст по каждому клиенту
или проекту — и всё это доступно через месяц, через год.

### Сегменты

| Сегмент | Зачем Верстак |
|---------|---------------|
| Фрилансер / дизайнер | Клиенты, файлы, правки, история работ, отчёты |
| Мастер по ремонту/ПК | Клиенты, устройства, серийники, фото, журнал |
| Разработчик | Workspace: заметки, репозитории, команды, логи |
| Мейкер / писатель | Проекты: материалы, заметки, версии, история |
| Консультант | Клиенты, документы, журнал времени, отчёты |

## 4. Основные сущности (универсальные)

### Дело

Главный рабочий контекст. Поля: название, тип, родитель,
описание, статус (active / sleeping / archived), теги.

### Заметка

Markdown-файл внутри vault. Резервная копия при перезаписи.

### Файл / Документ

Любой файл, привязанный к делу. Открывается системным приложением.

### Действие

Кнопка запуска: URL, файл, папка, команда. Опасные — с подтверждением.

### Журнал работ

Записи о затраченном времени: дата, длительность, описание.

### Активность

Следы работы: открыт файл, изменена заметка, запущено действие.
Используется для восстановления времени.

## 5. Примеры дерева (универсальные)

```text
Клиенты
  ООО Ромашка
    Сайт
      Документы
      Скриншоты
      Журнал работ

Проекты
  Мой проект
    Notes
    Assets
    dist

Рецепты
  Сайты
    Backup одной строкой
    Очистка кеша

Документы
  Счета
  Договоры
  Серийники
```

## 6. Сценарии (сегмент-agnostic)

### Работа с клиентом

1. Открыть дело клиента.
2. Посмотреть заметки и документы.
3. Открыть связанный URL или папку.
4. Добавить файлы.
5. Записать время.
6. Сформировать отчёт для клиента.

### Личный проект

1. Открыть дело проекта.
2. Нажать "Открыть в IDE".
3. Обновить roadmap-заметку.
4. Записать "на чём остановился".

### Восстановление времени

Пользователь не нажимал таймер, но вечером видит:

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

Основания:
- открывался URL админки сайта;
- менялся catalog.xlsx;
- создавались скриншоты.

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

## 7. Расширяемость

Базовые сущности универсальны. Плагины добавляют функционал
без перекомпиляции программы:

- шаблоны дел (клиент, ремонт, проект, рецепт...);
- календарь;
- канбан;
- импортёры (DokuWiki, Obsidian, plain folder);
- интеграции с внешними сервисами.

Подробнее: [docs/09_Extensibility.md](docs/09_Extensibility.md).

## 8. Что не делать в начале

- не делать SaaS;
- не делать multi-user CRM;
- не делать офисный пакет;
- не делать password manager;
- не делать ИИ;
- не делать мобильное приложение;
- не делать сложные права пользователей;
- не делать бухгалтерию.

## 9. Уникальность

Верстак объединяет заметочник, файловый кабинет, лаунчер,
журнал работ и контекст вокруг одного понятия: **дело**.
Плагины делают его адаптируемым под любой сегмент.