Back in Time
Техническая Архитектура

users (пользователи)

id              UUID PRIMARY KEY
email           VARCHAR(255) UNIQUE
password_hash   VARCHAR(255)
username        VARCHAR(50) UNIQUE
role            ENUM('user', 'moderator', 'admin')
is_active       BOOLEAN
created_at      TIMESTAMPTZ
                        

events (события)

id              UUID PRIMARY KEY
title           VARCHAR(500)
description     TEXT
date_start      DATE
date_end        DATE
date_precision  ENUM('year', 'month', 'day', 'hour')
location        GEOGRAPHY(POINT, 4326)
author_id       UUID REFERENCES users
status          ENUM('draft', 'pending', 'published', 'rejected')
vote_count      INTEGER DEFAULT 0
                        

event_blocks (нулевые блоки)

id              UUID PRIMARY KEY
event_id        UUID REFERENCES events
block_type      VARCHAR(50)
sort_order      INTEGER
data            JSONB
created_at      TIMESTAMPTZ
                        

token_balances (балансы)

user_id         UUID PRIMARY KEY
amount          INTEGER CHECK (amount >= 0)
frozen_amount   INTEGER CHECK (frozen_amount >= 0)
version         INTEGER
                        

token_transactions (транзакции)

id              UUID PRIMARY KEY
user_id         UUID REFERENCES users
type            ENUM('grant', 'earn', 'spend', 'stake_lock', 'bonus')
amount          INTEGER
balance_after   INTEGER
related_event_id UUID REFERENCES events
                        

event_stakes (залоги)

id              UUID PRIMARY KEY
event_id        UUID UNIQUE REFERENCES events
user_id         UUID REFERENCES users
amount          INTEGER
status          ENUM('active', 'returned', 'burned')
expires_at      TIMESTAMPTZ
                        

Регистрация нового пользователя

{
  "email": "user@example.com",
  "password": "secure_password",
  "username": "historian_2024"
}
                            

Вход в систему

{
  "email": "user@example.com",
  "password": "secure_password"
}
                            

OAuth аутентификация через VK

{
  "code": "oauth_code_from_vk",
  "state": "csrf_protection_state",
  "redirectUri": "https://app.backintime.io/auth/callback"
}
                            

Поиск и фильтрация событий

?dateFrom=1800-01-01
&dateTo=1900-12-31
&bbox=2.2,48.8,2.5,49.0
&status=published
&page=1&limit=20
                            

Создание нового события (черновик)

{
  "title": "Взятие Бастилии",
  "description": "Начало Великой французской революции",
  "date": "1789-07-14",
  "location": {"lat": 48.8530, "lng": 2.3691},
  "blocks": [
    {"type": "politics", "data": {"actor": "Парижские sans-culottes"}}
  ]
}
                            

Отправка на верификацию

{
  "stakeRequired": 10,
  "expiresAt": "2024-02-15T10:30:00Z"
}