84 lines
2.7 KiB
Markdown
84 lines
2.7 KiB
Markdown
# AGENTS.md — Verstak Sync Server
|
||
|
||
## Назначение
|
||
|
||
Отдельный сервер синхронизации для Верстака. Обеспечивает синхронизацию vault между устройствами.
|
||
|
||
## Правила
|
||
|
||
- Sync server не импортирует desktop UI или official plugins.
|
||
- Sync server синхронизирует vault metadata, файлы/blobs, plugin state (где разрешено).
|
||
- Плагины явно указывают, какие данные можно синхронизировать.
|
||
- Sync — не источник правды, а дополнение.
|
||
|
||
## API (текущий)
|
||
|
||
Desktop sync client:
|
||
|
||
```
|
||
POST /api/client/pair — pair device with username/password
|
||
POST /api/auth/test — validate username/password
|
||
GET /api/client/me — current authenticated device details
|
||
POST /api/client/revoke-current — revoke current device token
|
||
POST /api/client/revoke-device — revoke another device
|
||
POST /api/v1/sync/push — push local operations
|
||
POST /api/v1/sync/pull — pull operations since server sequence
|
||
POST /api/v1/blobs/ — store a blob, return SHA-256
|
||
GET /api/v1/blobs/{sha256} — download a stored blob
|
||
```
|
||
|
||
User API:
|
||
|
||
```
|
||
POST /api/v1/auth/register — register a user
|
||
GET /api/v1/auth/confirm — confirm email (GET shows form, POST confirms)
|
||
POST /api/v1/auth/login — user login
|
||
POST /api/v1/auth/forgot — request password reset
|
||
POST /api/v1/auth/reset — reset password
|
||
GET /api/v1/user/devices — list user devices
|
||
```
|
||
|
||
Operational:
|
||
|
||
```
|
||
GET /api/v1/health — server health and storage status
|
||
GET /livez — liveness probe
|
||
GET /readyz — readiness probe
|
||
```
|
||
|
||
Embedded web console:
|
||
|
||
```
|
||
GET / — public page
|
||
GET /login, /register, /forgot, /reset, /logout
|
||
GET /dashboard — user device management
|
||
GET /admin/login — admin console
|
||
GET /admin/... — admin sections (users, devices, vaults, storage, audit, SMTP, diagnostics)
|
||
```
|
||
|
||
## Структура
|
||
|
||
```
|
||
verstak-sync-server/
|
||
AGENTS.md
|
||
cmd/
|
||
server/
|
||
internal/
|
||
server/
|
||
server.go
|
||
routes.go
|
||
handlers_api.go
|
||
handlers_auth.go
|
||
handlers_admin.go
|
||
schema.go
|
||
web/
|
||
...
|
||
go.mod
|
||
README.md
|
||
```
|
||
|
||
## Подробнее
|
||
|
||
См. [README.md](README.md) для полной документации по развёртыванию,
|
||
конфигурации, backup/restore и архитектуре.
|