docs: add AGENTS.md with platform architecture rules
This commit is contained in:
parent
271456d252
commit
8ead372c8d
|
|
@ -0,0 +1,44 @@
|
|||
# AGENTS.md — Verstak Sync Server
|
||||
|
||||
## Назначение
|
||||
|
||||
Отдельный сервер синхронизации для Верстака. Обеспечивает синхронизацию vault между устройствами.
|
||||
|
||||
## Правила
|
||||
|
||||
- Sync server не импортирует desktop UI или official plugins.
|
||||
- Sync server синхронизирует vault metadata, файлы/blobs, plugin state (где разрешено).
|
||||
- Плагины явно указывают, какие данные можно синхронизировать.
|
||||
- Sync — не источник правды, а дополнение.
|
||||
|
||||
## API
|
||||
|
||||
```
|
||||
POST /api/v1/pair — создание пары устройство-сервер
|
||||
POST /api/v1/auth — аутентификация
|
||||
GET /api/v1/devices — список устройств
|
||||
POST /api/v1/sync — синхронизация операций
|
||||
GET /api/v1/blob/:hash — скачать blob
|
||||
PUT /api/v1/blob/:hash — загрузить blob
|
||||
GET /api/v1/operations — получить операции с последнего sync point
|
||||
```
|
||||
|
||||
## Структура
|
||||
|
||||
```
|
||||
verstak-sync-server/
|
||||
AGENTS.md
|
||||
cmd/
|
||||
server/
|
||||
internal/
|
||||
api/
|
||||
auth/
|
||||
device/
|
||||
vault/
|
||||
blob/
|
||||
conflict/
|
||||
migrations/
|
||||
...
|
||||
go.mod
|
||||
README.md
|
||||
```
|
||||
Loading…
Reference in New Issue