merge: 최신 main을 사령턴 대상 보강에 통합

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

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/<season>/` 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