From cd774afb4780b3b84c8272104df091ab201026d8 Mon Sep 17 00:00:00 2001 From: hided62 Date: Tue, 18 Aug 2026 12:41:38 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20preserved=20=ED=8C=8C=EC=9D=BC=20?= =?UTF-8?q?=EB=A1=9C=EA=B7=B8=20=EC=9D=B4=EA=B4=80=20=EA=B2=BD=EA=B3=84=20?= =?UTF-8?q?=EB=AA=85=EC=8B=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/legacy-db-migration.md | 11 +++++++++++ tools/legacy-db-migration/README.md | 7 +++++++ 2 files changed, 18 insertions(+) diff --git a/docs/legacy-db-migration.md b/docs/legacy-db-migration.md index e18f3d0b..2ad258c4 100644 --- a/docs/legacy-db-migration.md +++ b/docs/legacy-db-migration.md @@ -124,6 +124,17 @@ shape. Missing battle aggregates and logs are `null` plus explicit `availability`, never fabricated zeroes. The source JSON remains in `legacy_archive.general.raw_data` for recovery, but no API returns it. +Ref also retains per-season filesystem trees under `logs/preserved`. They are +not a MariaDB source: season reset moves the whole prior log directory there, +and the tree mixes legacy `gen*`, `batlog*`, `batres*`, tournament `fight*`, +SQLite API logs, and administrative/operational logs. The long-lived importer +therefore never reads a local or remote filesystem path. The required condensed +general history is already embedded by Ref in `ng_old_generals.data.history`, +and yearbook history comes from `ng_history`. Importing the other file artifacts +would require a separately reviewed archive format, ownership mapping, privacy +policy, and storage budget; their absence is reported as not preserved rather +than guessed from filenames. + The source contains legitimate duplicate `(server_id, nation)` old-nation rows and `(server_id, year, month)` history rows. `source_id` is consequently part of their current-schema archive keys, while the dedicated legacy archive uses diff --git a/tools/legacy-db-migration/README.md b/tools/legacy-db-migration/README.md index 0261b771..00b9917b 100644 --- a/tools/legacy-db-migration/README.md +++ b/tools/legacy-db-migration/README.md @@ -89,6 +89,13 @@ archive rows are immutable. Incremental mode does not mirror source deletions. If either assumption is false, take a new reviewed backup and run full mode; do not edit checkpoint rows by hand. +The command reads MariaDB only. Ref `logs/preserved//` directories are +heterogeneous filesystem archives (old general/battle text, tournament text, +SQLite API logs, and operational logs), not an incremental database feed. +`ng_old_generals.data.history` and `ng_history` carry the supported long-lived +history. Do not point this CLI at, copy, or infer database rows from preserved +log files; a file-log archive needs a separate reviewed migration contract. + ## Commands ```sh