План міграції MySQL

ЗАГАЛЬНИЙ ПРОГРЕС МІГРАЦІЇ

0 / 41 кроків 0 / 5 фаз завершено

JSON файлів

Мігровано

Критичні

Середні

Прості

~2.2MB

Обсяг даних

check_circle Вже мігровано: Publisher

База даних

ua5web_publisher

Таблиці

publisher_folders, publisher_messages, publisher_migration_log

Міграції

4 міграції (001–004)

Шаблон

publisherStorageAdapter.js + publisherRepository.js

Підключення

mysql2/promise pool, connection.js

ENV перемикач

PUBLISHER_STORAGE_MODE=mysql

Фаза 1 — Nexus

Критична 0/9

Джерело

nexus-profiles.json (541 KB)

Таблиці

nexus_profiles, nexus_profile_static, nexus_profile_state, nexus_timeline_events

Записи

~20 профілів, ~500 подій таймлайну

Складність

Висока (вкладені обʼєкти, звʼязки 1:1 + 1:N)

Створити схему бази (4 таблиці з FK, індекси)SQL
Створити nexusRepository.js (маппери, CRUD, upsert)бекенд
Створити nexusStorageAdapter.js (перемикач JSON/MySQL)бекенд
Написати скрипт міграції: nexus-profiles.json → MySQLміграція
Оновити b5-nexus.js бекенд модульбекенд
Оновити anbu-bot/modules/5-nexus.jsбот
Оновити anbu-bot/modules/core/profile-manager.jsбот
Тест: читання/запис через адаптер, перевірка цілісностітест
Переключити NEXUS_STORAGE_MODE=mysql, деплойдеплой

Фаза 2 — Executor

Критична 0/8

Джерела

executor-history.json (95.9 KB), executor-stats.json (14.8 KB), executor-cards.json (12.6 KB), executor-sessions.json

Таблиці

executor_cards, executor_sessions, executor_session_participants, executor_points_adjustments, executor_user_stats

Записи

21 картка, 90+ сесій, 5 статистик

Складність

Середньо-висока (сесії з учасниками + коригування балів)

Створити схему бази (5 таблиць)SQL
Створити executorRepository.jsбекенд
Створити executorStorageAdapter.jsбекенд
Міграція: картки, історія, статистика, сесії → MySQLміграція
Оновити b3-executor.js бекенд модульбекенд
Оновити модулі executor в anbu-botбот
Тест: життєвий цикл сесій, бали, агрегація статистикитест
Переключити EXECUTOR_STORAGE_MODE=mysql, деплойдеплой

Фаза 3 — Challenger

Критична 0/8

Джерела

challenger-achievements.json (98.9 KB), challenger-activity.json (65 KB)

Таблиці

challenger_achievement_levels, _categories, _achievements, challenger_daily_activity, _streaks, _activity_history, _activity_metadata

Записи

47 досягнень, 5 активностей, щоденні скиди

Складність

Середня (щоденна активність + стріки + розблокування досягнень)

Створити схему бази (7 таблиць)SQL
Створити challengerRepository.jsбекенд
Створити challengerStorageAdapter.jsбекенд
Міграція: досягнення, активність, стріки → MySQLміграція
Оновити b6-challenger.js бекенд модульбекенд
Оновити модулі challenger в anbu-botбот
Тест: щоденний скид, підрахунок стріків, розблокування досягненьтест
Переключити CHALLENGER_STORAGE_MODE=mysql, деплойдеплой

Фаза 4 — Applicant + Observer

Середня 0/8

Джерела

applications.json (9.2 KB), members.json (1.1 KB)

Таблиці

applicant_applications, applicant_config, observer_members, observer_member_counter

Записи

7 заявок, 6 учасників

Складність

Проста (плоскі структури, мінімум даних)

Створити схему бази (4 таблиці)SQL
Створити applicantRepository.js + observerRepository.jsбекенд
Створити адаптери сховищабекенд
Міграція: заявки + учасники → MySQLміграція
Оновити b4-applicant.js + b1-observer.jsбекенд
Оновити модулі applicant + observer в anbu-botбот
Тест: потік заявок, лічильник учасниківтест
Переключити режими сховища, деплойдеплой

Фаза 5 — Paymaster + Очищення Publisher

Проста 0/8

Джерела

paymaster-drafts.json (1.2 KB), paymaster-history.json, paymaster-audit.json

Таблиці

paymaster_drafts, paymaster_history, paymaster_audit, paymaster_config

Записи

1 чернетка, порожня історія/аудит

Додатково

Видалити JSON fallback Publisher, прибрати застарілі файли

Створити схему бази (4 таблиці)SQL
Створити paymasterRepository.jsбекенд
Створити paymasterStorageAdapter.jsбекенд
Міграція: чернетки, історія, аудит → MySQLміграція
Оновити b7-paymaster.js + модулі ботабекенд
Видалити JSON fallback код Publisherочищення
Тест: потік paymaster, publisher без JSONтест
Переключити PAYMASTER_STORAGE_MODE=mysql, фінальний деплойдеплой

database Довідник схем

table_chartnexus_profilesочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
user_id	`VARCHAR(20)`	UNIQUE NOT NULL
thread_id	`VARCHAR(20)`
thread_url	`VARCHAR(255)`
created_at	`DATETIME`	CURRENT_TIMESTAMP
updated_at	`DATETIME`	ON UPDATE

table_chartnexus_profile_staticочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
user_id	`VARCHAR(20)`	UNIQUE, FK → nexus_profiles
discord_username	`VARCHAR(100)`
discord_global_name	`VARCHAR(100)`
first_joined_at	`DATETIME`
account_created_at	`DATETIME`
invite_code	`VARCHAR(50)`
invited_by_id	`VARCHAR(20)`
member_number	`INT`
is_legacy_user	`BOOLEAN`	DEFAULT FALSE
legacy_note	`TEXT`

table_chartnexus_profile_stateочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
user_id	`VARCHAR(20)`	UNIQUE, FK → nexus_profiles
server_nickname	`VARCHAR(255)`
avatar_url	`VARCHAR(512)`
is_on_server	`BOOLEAN`	DEFAULT TRUE
is_banned	`BOOLEAN`	DEFAULT FALSE
current_tag	`VARCHAR(50)`
current_rank	`VARCHAR(50)`	INDEX
reputation	`INT`	DEFAULT 0
points	`INT`	DEFAULT 0, INDEX
tasks_completed	`INT`	DEFAULT 0
tasks_failed	`INT`	DEFAULT 0
voice_time_minutes	`INT`	DEFAULT 0
messages_count	`INT`	DEFAULT 0
last_active	`DATETIME`	INDEX
warnings_total	`INT`	DEFAULT 0
timeouts_total	`INT`	DEFAULT 0
kicks_received	`INT`	DEFAULT 0
bans_received	`INT`	DEFAULT 0
achievements	`JSON`	Масив ID
roles	`JSON`	Масив ID
rank_history	`JSON`	Масив обʼєктів

table_chartnexus_timeline_eventsочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
event_id	`VARCHAR(50)`	UNIQUE
user_id	`VARCHAR(20)`	FK → nexus_profiles, INDEX
type	`VARCHAR(50)`	INDEX
timestamp	`DATETIME`	INDEX
message_id	`VARCHAR(20)`
data	`JSON`	Payload події

table_chartexecutor_cardsочікує

Колонка	Тип	Примітки
id	`VARCHAR(20)`	PRIMARY KEY
name	`VARCHAR(255)`	NOT NULL
description	`TEXT`
objective	`TEXT`
type	`VARCHAR(20)`	DEFAULT 'neutral'
category	`ENUM('easy','medium','hard')`	INDEX
level	`INT`	DEFAULT 1
points	`INT`	DEFAULT 0
reward_money	`INT`	DEFAULT 0
min_participants	`INT`	DEFAULT 2
max_participants	`INT`	DEFAULT 8
estimated_duration	`INT`	Хвилини
is_active	`BOOLEAN`	DEFAULT TRUE, INDEX

table_chartexecutor_sessionsочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
session_id	`VARCHAR(50)`	UNIQUE
card_id	`VARCHAR(20)`	FK → executor_cards
task_name	`VARCHAR(255)`
curator_id	`VARCHAR(20)`	INDEX
status	`ENUM('active','completed','cancelled')`	INDEX
total_points	`INT`	DEFAULT 0
completed_at	`DATETIME`	INDEX

table_chartexecutor_session_participantsочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
session_id	`VARCHAR(50)`	FK → executor_sessions
user_id	`VARCHAR(20)`	INDEX
is_curator	`BOOLEAN`	DEFAULT FALSE
confirmed	`BOOLEAN`	DEFAULT FALSE
earned_points	`INT`	DEFAULT 0
final_points	`INT`	DEFAULT 0

table_chartexecutor_user_statsочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
user_id	`VARCHAR(20)`	UNIQUE
total_points	`INT`	DEFAULT 0, INDEX
tasks_completed	`INT`	DEFAULT 0
mvp_count	`INT`	DEFAULT 0
penalties_received	`INT`	DEFAULT 0
bans_received	`INT`	DEFAULT 0
tasks_by_card	`JSON`	Статистика по картках

table_chartchallenger_achievementsочікує

Колонка	Тип	Примітки
id	`INT`	PRIMARY KEY
name	`VARCHAR(255)`	NOT NULL
description	`TEXT`
icon	`VARCHAR(50)`
level	`INT`	FK → achievement_levels
category	`VARCHAR(50)`	FK → achievement_categories
points	`INT`	DEFAULT 0
conditions	`JSON`	Умови розблокування
reward	`JSON`	Необовʼязкове
card_config	`JSON`	Візуальні налаштування

table_chartchallenger_daily_activityочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
user_id	`VARCHAR(20)`	UNIQUE(user_id, date)
date	`DATE`	INDEX
voice_minutes	`INT`	DEFAULT 0
messages	`INT`	DEFAULT 0
reactions_given	`INT`	DEFAULT 0
tasks_completed	`INT`	DEFAULT 0
total_points	`INT`	DEFAULT 0
is_active	`BOOLEAN`	DEFAULT FALSE

table_chartchallenger_streaksочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
user_id	`VARCHAR(20)`	UNIQUE
current_streak	`INT`	DEFAULT 0, INDEX
longest_streak	`INT`	DEFAULT 0
last_active_date	`DATE`
streak_started_at	`DATE`

table_chartapplicant_applicationsочікує

Колонка	Тип	Примітки
id	`VARCHAR(100)`	PRIMARY KEY
user_id	`VARCHAR(20)`	INDEX
username	`VARCHAR(100)`
display_name	`VARCHAR(200)`
form_data	`JSON`	NOT NULL
status	`ENUM('pending','accepted','rejected')`	INDEX
submitted_at	`DATETIME`	INDEX
reviewed_at	`DATETIME`
reviewed_by	`VARCHAR(20)`
reject_reason	`TEXT`

table_chartobserver_membersочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
number	`INT`	NOT NULL
discord_id	`VARCHAR(20)`	UNIQUE
username	`VARCHAR(100)`
joined_at	`DATETIME`	NOT NULL
source	`VARCHAR(50)`	DEFAULT 'real'

table_chartpaymaster_draftsочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
week_id	`VARCHAR(20)`	UNIQUE
week_start	`DATETIME`
week_end	`DATETIME`
income	`JSON`
deductions	`JSON`
distributable	`INT`	DEFAULT 0
directions_allocation	`JSON`
published	`BOOLEAN`	DEFAULT FALSE
created_at	`DATETIME`
updated_at	`DATETIME`

table_chartpaymaster_historyочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
week_id	`VARCHAR(20)`	INDEX
data	`JSON`	Повний знімок тижня
completed_at	`DATETIME`

table_chartpaymaster_auditочікує

Колонка	Тип	Примітки
id	`INT AUTO_INCREMENT`	PRIMARY KEY
action	`VARCHAR(100)`	NOT NULL
user_id	`VARCHAR(20)`	INDEX
details	`JSON`
timestamp	`DATETIME`	INDEX

account_tree Архітектура міграції

swap_horizАдаптер сховища

Кожен модуль отримує адаптер, який зчитує *_STORAGE_MODE з ENV. Якщо json — читає/пише JSON файли. Якщо mysql — делегує в репозиторій.

Зразок: adapters/publisherStorageAdapter.js

storageРепозиторій

Чистий MySQL шар. Маппери fromDB() / toDB() конвертують camelCase ↔ snake_case. Використовує INSERT ... ON DUPLICATE KEY UPDATE для upsert.

Зразок: repositories/publisherRepository.js

hubПул підключень

Єдиний mysql2/promise пул в connection.js. Спільний для всіх репозиторіїв. Авто-міграція через ensureSchema() при старті.

Зразок: database/connection.js

move_downСкрипт міграції

Одноразовий скрипт для кожного модуля: читає JSON, трансформує дані, вставляє в MySQL. Логує в *_migration_log. Запускається вручну.

Зразок: database/migrations/migrate.js

tuneENV конфігурація

Кожен модуль керується незалежно:
PUBLISHER_STORAGE_MODE=mysql
NEXUS_STORAGE_MODE=json
EXECUTOR_STORAGE_MODE=json
CHALLENGER_STORAGE_MODE=json

Файл: .env

undoСтратегія відкату

JSON файли зберігаються як бекап. Переключити ENV назад на json і рестартнути — миттєвий відкат. Втрата даних неможлива під час переходу.

Міграція без простою