project_versions

project_versions

Таблица версий проектов — хранит снимки данных проекта (BotDataWithSheets)

Columns

Name	Type	Default	Nullable	Children	Parents	Comment
id	serial	-	NO	-	-	Уникальный идентификатор версии
project_id	integer	-	NO	-	bot_projects.id	Идентификатор проекта (ссылка на bot_projects.id)
snapshot	jsonb	-	YES	-	-	Снимок данных проекта (BotDataWithSheets)
snapshot_storage_id	text	-	YES	-	-	ID приватной конфигурации S3 для снимка
snapshot_key	text	-	YES	-	-	Неизменяемый ключ сжатого JSON в S3
snapshot_sha256	text	-	YES	-	-	SHA-256 исходного JSON
snapshot_bytes	bigint	-	YES	-	-	Размер исходного JSON в байтах
snapshot_state	text	'postgres'	NO	-	-	Состояние снимка: postgres, pending или ready
snapshot_retry_at	timestamp	-	YES	-	-	Следующая попытка переноса после ошибки S3
snapshot_attempts	integer	0	NO	-	-	Число неудачных попыток переноса
label	text	-	YES	-	-	Опциональная метка версии (например имя проекта на момент снимка)
author_id	bigint	-	YES	-	telegram_users.id	Идентификатор автора снимка (ссылка на telegram_users.id)
kind	text	'auto'	NO	-	-	Тип версии: "auto" — авто-снимок при сохранении, "manual" — ручной коммит-чекпоинт
author_kind	text	-	YES	-	-	Тип автора снимка: 'agent' — ИИ-агент (MCP), NULL/'user' — обычный пользователь
created_at	timestamp	now()	YES	-	-	Время создания версии

Constraints

Name	Type	Definition
fk_project_id_bot_projects	FOREIGN KEY	(project_id) → bot_projects(id)
fk_author_id_telegram_users	FOREIGN KEY	(author_id) → telegram_users(id)

Indexes

Name	Columns	Unique	Type
idx_project_versions_project	project_id	NO	-
idx_project_versions_order	project_id, created_at, id	NO	-

Relations

Parent	Child	Type
bot_projects.id	project_versions.project_id	Many to One
telegram_users.id	project_versions.author_id	Many to One