verstak/docs/00_README.md

Верстак — индекс документации

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

Это не просто заметочник и не CRM. Главная сущность — дело. Верстак нужен людям, у которых работа организована через дела, а не через задачи.

Дело может быть:

• клиентом;
• сайтом клиента;
• личным проектом;
• набором документов;
• рецептом/инструкцией;
• архивом;
• разовой работой.

Внутри дела живут:

• вложенные папки;
• Markdown-заметки;
• документы (docx/pdf/xlsx/odt/png/zip);
• файлы любых типов;
• запускаемые действия (URL, файл, папка, команда);
• журнал работ;
• история активности.

Файлы пакета

1. 01_Product_Spec — описание продукта, аудитория, сценарии.
2. 02_Architecture — архитектура core/GUI/TUI/CLI/server, плагины.
3. 03_Data_Model_Storage — модель данных, SQLite, vault, files, notes.
4. 04_Sync_Backup_Activity — синхронизация, backup, activity.
5. 05_UI_UX — экраны GUI/TUI.
6. 06_Roadmap — план разработки по этапам.
7. 07_AI_Coder_Prompts — промпты для ИИ-кодера.
8. 08_MVP_Checklist — чеклист первого MVP.
9. 09_Extensibility — архитектура плагинов (Lua + шаблоны дел).
10. 10_Sync_Server_Guide — установка и настройка сервера синхронизации.

Главные принципы

1. Local-first. Рабочая копия всегда локальная. Сервер — для sync/backup.

2. Универсальная база + плагины. Базовая модель (дело + заметка + файл + действие + журнал) работает для любого сегмента. Плагины добавляют календарь, канбан, импортёры — без перекомпиляции.

3. Данные принадлежат пользователю. Заметки и файлы лежат обычными файлами. SQLite — индекс.

4. Дерево дел важнее тегов.

5. Не таймтрекер, а восстановитель следов.

6. GUI основной, TUI быстрый, CLI служебный.

7. Sync не уничтожает данные.

Короткая формула

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