2.7 KiB

Raw Permalink Blame History

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 для полной документации по развёртыванию, конфигурации, backup/restore и архитектуре.

2.7 KiB Raw Permalink Blame History Unescape Escape