304 lines
5.6 KiB
Markdown
304 lines
5.6 KiB
Markdown
# Official Plugins
|
||
|
||
Официальные плагины - это базовый набор инструментов Верстака. Они не должны быть скрытыми частями core. Их задача - показать, что платформа действительно работает через capabilities и contribution points.
|
||
|
||
## 1. `official.files`
|
||
|
||
Назначение:
|
||
|
||
- дерево/список файлов внутри дела;
|
||
- добавление файлов;
|
||
- перемещение/копирование в vault;
|
||
- открытие системным приложением;
|
||
- file metadata;
|
||
- file actions registry consumer.
|
||
|
||
Provides:
|
||
|
||
```text
|
||
workspace.files
|
||
vault.files
|
||
entity.file
|
||
file.browser
|
||
```
|
||
|
||
Optional requires:
|
||
|
||
```text
|
||
editor.text
|
||
viewer.file
|
||
preview.file
|
||
search.provider
|
||
```
|
||
|
||
Поведение:
|
||
|
||
- если есть подходящий editor capability, показывает "Edit";
|
||
- если есть viewer/preview capability, показывает "Preview";
|
||
- если нет, оставляет "Open externally".
|
||
|
||
## 2. `official.notes`
|
||
|
||
Назначение:
|
||
|
||
- markdown notes as first-class Verstak entities;
|
||
- canonical `Notes/` folder inside case/project;
|
||
- Overview note;
|
||
- note metadata;
|
||
- note links.
|
||
|
||
Provides:
|
||
|
||
```text
|
||
workspace.notes
|
||
entity.note
|
||
note.registry
|
||
```
|
||
|
||
Requires:
|
||
|
||
```text
|
||
vault.files
|
||
```
|
||
|
||
Optional requires:
|
||
|
||
```text
|
||
editor.text.markdown
|
||
preview.markdown
|
||
search.provider
|
||
```
|
||
|
||
Важное правило:
|
||
|
||
- title и filename должны оставаться синхронизированными;
|
||
- filename - человекочитаемая проекция title;
|
||
- при конфликте имени не добавлять `_2` молча, а показывать понятный conflict dialog.
|
||
|
||
## 3. `official.markdown-editor`
|
||
|
||
Назначение:
|
||
|
||
- редактирование markdown/text;
|
||
- toolbar;
|
||
- save flow;
|
||
- dirty state;
|
||
- keyboard shortcuts.
|
||
|
||
Provides:
|
||
|
||
```text
|
||
editor.text
|
||
editor.text.markdown
|
||
editor.note.markdown
|
||
```
|
||
|
||
Optional requires:
|
||
|
||
```text
|
||
preview.markdown
|
||
```
|
||
|
||
Не должен:
|
||
|
||
- сам решать, где хранятся notes;
|
||
- напрямую зависеть от `official.notes`;
|
||
- тащить file manager внутрь себя.
|
||
|
||
## 4. `official.markdown-preview`
|
||
|
||
Назначение:
|
||
|
||
- безопасный markdown render;
|
||
- internal `verstak://` links;
|
||
- optional syntax highlight.
|
||
|
||
Provides:
|
||
|
||
```text
|
||
preview.markdown
|
||
viewer.markdown
|
||
```
|
||
|
||
Optional requires:
|
||
|
||
```text
|
||
link.resolver
|
||
```
|
||
|
||
## 5. `official.file-preview`
|
||
|
||
Назначение:
|
||
|
||
- просмотр изображений;
|
||
- просмотр text-like файлов;
|
||
- базовый PDF/image metadata preview, если возможно;
|
||
- fallback to system open.
|
||
|
||
Provides:
|
||
|
||
```text
|
||
viewer.file
|
||
viewer.image
|
||
viewer.text
|
||
preview.file
|
||
```
|
||
|
||
## 6. `official.activity`
|
||
|
||
Назначение:
|
||
|
||
- сбор activity events;
|
||
- отображение истории;
|
||
- реконструкция работы;
|
||
- подсказки для worklog.
|
||
|
||
Provides:
|
||
|
||
```text
|
||
activity.log
|
||
activity.provider
|
||
activity.reconstruction
|
||
```
|
||
|
||
Subscribes:
|
||
|
||
```text
|
||
file.opened
|
||
file.changed
|
||
note.saved
|
||
action.started
|
||
browser.capture.received
|
||
case.selected
|
||
```
|
||
|
||
## 7. `official.journal`
|
||
|
||
Назначение:
|
||
|
||
- ручной журнал работ;
|
||
- billable/non-billable;
|
||
- отчеты по делу/клиенту;
|
||
- принятие suggested time из activity.
|
||
|
||
Provides:
|
||
|
||
```text
|
||
worklog
|
||
journal
|
||
report.worklog
|
||
```
|
||
|
||
Optional requires:
|
||
|
||
```text
|
||
activity.reconstruction
|
||
```
|
||
|
||
## 8. `official.browser-inbox`
|
||
|
||
Назначение:
|
||
|
||
- прием ссылок, выделенного текста, страниц и snippets из browser extension;
|
||
- pending queue;
|
||
- привязка доменов к делам;
|
||
- создание inbox entries;
|
||
- превращение inbox entry в note/link/file/activity.
|
||
|
||
Provides:
|
||
|
||
```text
|
||
capture.browser
|
||
browser.inbox
|
||
domain.binding
|
||
```
|
||
|
||
Requires:
|
||
|
||
```text
|
||
network.local
|
||
```
|
||
|
||
Optional requires:
|
||
|
||
```text
|
||
workspace.notes
|
||
activity.log
|
||
search.provider
|
||
```
|
||
|
||
## 9. `official.search`
|
||
|
||
Назначение:
|
||
|
||
- общий поиск по vault;
|
||
- индекс notes/files/activity/worklog;
|
||
- providers from plugins;
|
||
- typo/layout tolerant search later.
|
||
|
||
Provides:
|
||
|
||
```text
|
||
search
|
||
search.provider
|
||
search.indexer
|
||
```
|
||
|
||
## 10. `official.secrets`
|
||
|
||
Назначение:
|
||
|
||
- защищенное хранилище клиентских доступов;
|
||
- SSH/CMS/VPS/database/API secrets;
|
||
- bridge secret, sync token, device private key, pairing token;
|
||
- permissions for secret access.
|
||
|
||
Provides:
|
||
|
||
```text
|
||
secret-store
|
||
secrets.read-ui
|
||
secrets.write-ui
|
||
```
|
||
|
||
Важное правило:
|
||
|
||
- секреты не должны храниться как обычный markdown/plain text;
|
||
- доступ к secret-store должен идти через permissions;
|
||
- плагины не получают `secrets.read` автоматически.
|
||
|
||
## 11. `official.templates`
|
||
|
||
Назначение:
|
||
|
||
- шаблоны дел;
|
||
- client/project/server/device structures;
|
||
- initial folder/note/action layout.
|
||
|
||
Provides:
|
||
|
||
```text
|
||
case.templates
|
||
```
|
||
|
||
Optional requires:
|
||
|
||
```text
|
||
workspace.notes
|
||
workspace.files
|
||
```
|
||
|
||
## 12. Первый минимальный набор
|
||
|
||
Для первого платформенного этапа достаточно:
|
||
|
||
- `official.files`;
|
||
- `official.notes`;
|
||
- `official.markdown-editor`;
|
||
- `official.markdown-preview`;
|
||
- `official.activity`;
|
||
- `official.browser-inbox`;
|
||
|
||
Но все они должны быть настоящими динамическими плагинами, даже если поставляются вместе с приложением.
|
||
|