# تاریخچهٔ اجرایی درگاه موزیکال

این سند حافظهٔ فشرده اما کامل پروژه است. شمارها مربوط به نسخهٔ ۵۳ و تاریخ ۲۲ اوت ۲۰۲۶ هستند.

## خط زمانی

### هستهٔ ۴٬۴۰۹

درگاه با ۴٬۲۷۵ فیلم اصلی و ۱۳۴ مدخل تکمیلی شکل گرفت. منابع پایه آرشیو شخصی، Movie Collector، فهرست IMDb و پژوهش‌های کتاب «گونهٔ موزیکال سینمایی» بودند. شناسه‌های تاریخی `lb:`، `vault:` و مانند آن حفظ شدند.

### گسترش ۴٬۷۱۶ و دپارتمان موسیقی

۳۰۷ عنوان منتخب Movie Collector اضافه شد. در همین مرحله ۳٬۵۱۶ رابطهٔ جزئی دپارتمان موسیقی استخراج شد: آهنگ‌ساز، ترانه‌سرا، مدیر موسیقی، تنظیم‌کننده، ارکستراتور، تنظیم‌کنندهٔ آواز و رقص، رهبر ارکستر، سرپرست موسیقی، طراح رقص و عنوان دقیق شغل. نقش خالی یا نامطمئن حدس زده نشد.

### نسخهٔ ۴۰ — آمول پالکار

چهار فیلم `Ankahee`، `Thodasa Roomani Ho Jaayen`، `Daayraa` و `Paheli` همراه پروندهٔ شخص و اتصال‌ها افزوده شدند؛ شمار به ۴٬۷۲۰ رسید.

### نسخهٔ ۴۱ — حافظهٔ پروژه

صفحهٔ دائمی «شیوه‌نامه و تاریخچه» و نسخهٔ متنی قابل دریافت ساخته شد.

### نسخهٔ ۴۲ — ۳۰نما و دانلودروز

۹۷۸ ردیف فیلم به موجودی ۳۰نما متصل شد. پیوند مستقیم ۳۰نما و جست‌وجوی عنوان‌ـ‌سال در دانلودروز به پروندهٔ فیلم افزوده شد. اتصال جست‌وجویی صریحاً از اتصال مستقیم تفکیک شد.

### نسخهٔ ۴۳ — فیلم‌های هندی

۹۰ فیلم هندی IMDbدار از فهرست ۳۰نما وارد و چهار عنوان جایگزین به رکورد موجود متصل شدند. انیمیشن، کنسرت و قالب نامتناسب از این مسیر کنار گذاشته شد. شمار آن زمان به ۴٬۸۱۰ رسید.

### نسخهٔ ۴۴ — زبانهٔ مستند

شناسهٔ مستقل `MUS-D` و زبانه/پروندهٔ مستند ساخته شد. ۶۲۱ مستند تازه با ۷۲ مستند موجود پیوند خوردند؛ یک IMDb تکراری حذف و ۱۷ کنسرت/تور کنار گذاشته شد. موجودی نخست ۶۹۳ مستند بود.

### نسخهٔ ۴۵ — عوامل و موضوع مستند

داده‌های غیرتجاری IMDb به‌صورت گروهی و بدون درخواست جدا برای هر عنوان پردازش شد. برای ۶۹۳ مستند، کارگردان، آهنگ‌ساز، دپارتمان موسیقی و موضوع‌های پیشنهادی استخراج شد. «عامل»، «حضور Self/Archive» و «موضوع مستند» از هم جدا ماندند.

### نسخهٔ ۴۶ — همهٔ مستندها

دامنه از مستند موسیقی به همهٔ مستندهای موجود گسترش یافت. معیار ورود، برچسب رسمی `Documentary` در IMDb شد؛ `Music/Musical` فقط دامنهٔ موسیقایی را تعیین می‌کند. شمار نهایی ۷۳۹ مستند است: ۷۲۶ موسیقایی و ۱۳ عمومی. چهار ضبط صرف کنسرت/اجرای صحنه‌ای کنار گذاشته شد.

وضعیت نهایی مستندها:

- ۷۳۵ عنوان دارای کارگردان
- ۳۸۹ عنوان دارای آهنگ‌ساز
- ۳۹۴ عنوان دارای دپارتمان موسیقی
- ۶۶۹ عنوان دارای موضوع پیشنهادی
- ۱۲٬۸۱۱ رابطهٔ عوامل
- ۵٬۵۹۵ رابطهٔ موضوع/حضور

### نسخهٔ ۴۷ — عوامل ضربه‌پذیر

نام کارگردان‌ها، آهنگ‌سازها، عوامل دپارتمان موسیقی و شخصیت‌ها یا گروه‌های مستند به پروندهٔ شخص متصل شد. صفحهٔ شخص، فیلم‌ها، مستندها و نقش هر شخص را جدا نمایش می‌دهد. شبکهٔ همکاری مستندها در این مرحله عمداً محاسبه نشد تا ادغام مبهم یا محاسبهٔ سنگین وارد درگاه نشود.

### نسخهٔ ۴۸ — زبانهٔ انیمیشن

شناسهٔ مستقل `MUS-A`، زبانه و پروندهٔ انیمیشن ساخته شد. معیار قطعی ورود برچسب رسمی `Animation` در IMDb است. کوتاه‌ها و قالب‌های موجود حفظ شدند؛ از ۳۰نما فقط نوع `movie` وارد شد. کارگردان، آهنگ‌ساز، صداپیشه و عوامل اصلی استخراج و به پروندهٔ شخص متصل شدند.

### نسخهٔ ۴۹ — بازیابی انیمیشن‌های جامانده

تطبیق سراسری شناسه‌های فیلم با ژانر رسمی IMDb انجام و ۲۴ انیمیشن قطعی جامانده بازیابی شد. موجودی نهایی:

- ۲۷۴ انیمیشن یکتا: ۲۳۰ موجودی پیشین و ۴۴ فیلم بلند تازهٔ ۳۰نما
- ۲۷۱ عنوان دارای کارگردان
- ۲۵۷ عنوان دارای آهنگ‌ساز
- ۲۶۲ عنوان دارای صداپیشه/بازیگر
- ۶٬۵۸۱ رابطهٔ عوامل

### نسخهٔ ۵۰ — ادغام بی‌اتلاف IMDb

۲۳۷ گروه تکراری قطعی فقط با IMDb یکسان ادغام شدند. ۴۷۶ رکورد منبع به ۲۳۷ فیلم یکتا رسید و ۲۳۹ ردیف از شمار زنده کنار رفت؛ شمار نهایی فیلم‌ها ۴٬۵۷۱ شد. هیچ مقدار غیرخالی حذف نشد. شناسه‌های تاریخی در `legacy_film_ids`، اختلاف‌ها در `merge_preserved_values_json` و تمام ردیف‌های اولیه در دفتر ممیزی حفظ شدند. اتصال ژانر، قالب، سبک، شماره، عامل، مستند و انیمیشن به شناسهٔ یکتا منتقل شد و نشانی قدیمی پرونده‌ها همچنان باز می‌شود.

### نسخهٔ ۵۱ — گروه‌ها و تثبیت حافظه

هویت‌های صرفاً موسیقاییِ گروه و Band از فیلم‌ها، مستندها و داده‌های غیرتجاری IMDb استخراج شد؛ اشخاص و هویت‌های صرفاً سینمایی وارد این جدول نشدند. نتیجهٔ قطعی:

- ۱۲۷ گروه تأییدشده
- ۵۴ گروه دارای فیلم
- ۷۵ گروه دارای مستند
- ۵۹ رابطهٔ فیلم و ۸۰ رابطهٔ مستند؛ در مجموع ۱۳۹ رابطه
- ۲۲ نامزد بازبینی برای تصمیم انسانی
- روش استخراج گروهی و بدون فراخوانی AI؛ ۱۰۱٬۲۹۶٬۷۱۳ ردیف principal بررسی شد

در همین نسخه، شیوه‌نامه، تاریخچه، دستور کار، راه بازیابی و شمارهای رسمی با هم همگام شدند.

### نسخهٔ ۵۲ — فیلم‌های موسیقی‌محور

زبانهٔ مستقل «فیلم‌های موسیقی‌محور» برای مدخل کتاب ساخته شد. معیار این گروه موزیکال‌بودن نیست؛ موسیقی باید روایت، شخصیت، اجرا، حافظه، ادراک یا سازمان صوری فیلم را بسازد. هستهٔ نخست ۶۰ عنوان است.

- شناسهٔ مستقل: `MUS-MC`
- ۲۱ اتصال مستقیم به فیلم‌های موجود با IMDb یکسان
- یک اتصال مستند برای `Koyaanisqatsi` که هم‌زمان در فهرست فیلم نیز موجود است
- ۳۹ رکورد مستقل از هر سه موجودی اصلی
- صفر عنوان افزوده به شمار ۴٬۵۷۱ فیلم، ۷۳۹ مستند یا ۲۷۴ انیمیشن

عنوان، سال یا کارگردان مشابه معیار همپوشانی نیست؛ تنها IMDb دقیق اتصال را می‌سازد. اسکریپت `build-music-centered.py` جدول را بدون جهش جانبی بازسازی و وضعیت اتصال‌ها را گزارش می‌کند.

### نسخهٔ ۵۳ — برچسب‌های رسمی Music و Musical در IMDb

هر ۴٬۴۴۹ شناسهٔ IMDb موجود در جدول ۴٬۵۷۱ فیلم با دادهٔ غیرتجاری رسمی IMDb تطبیق داده شد. دو ستون مستقل `imdb_music` و `imdb_musical` به جدول اصلی افزوده شدند تا هیچ‌یک جای دیگری را نگیرد. نتیجه:

- ۱٬۲۲۶ فیلم دارای `Music`
- ۲٬۰۷۰ فیلم دارای `Musical`
- ۶۶ فیلم دارای هر دو برچسب
- ۱٬۱۶۰ فیلم فقط `Music` و ۲٬۰۰۴ فیلم فقط `Musical`
- ۱٬۲۱۷ فیلم دارای هیچ‌کدام
- ۱۲۴ عنوان نامشخص: ۱۲۲ فیلم بدون IMDb و دو شناسهٔ حذف‌شده/ناموجود در دادهٔ روز IMDb

برچسب‌های «موسیقی (IMDb)» و «موزیکال (IMDb)» روی کارت و پروندهٔ فیلم قابل کلیک‌اند و صافی مستقل `Music`، `Musical` و «هر دو» به فهرست فیلم‌ها افزوده شد. جدول شمارش در `public/imdb_music_labels_report.json` و روش بازسازی در `scripts/apply-imdb-music-labels.py` ثبت شده است.

## خروجی‌ها و نقاط بازگشت

- جدول اصلی زنده: `public/musical_portal_4409.csv` با نام تاریخی ثابت
- جدول مستقل موسیقی‌محورها: `public/music_centered_films.csv`
- خروجی یکپارچه: `exports/musical_portal_complete_4571.csv`
- پشتیبان کامل نسخهٔ ۵۰ و نسخه‌های نقطهٔ بازگشت پیش از تغییرهای بزرگ
- بستهٔ SQLite برای انتقال به Codex/پایگاه داده همراه CSV، طرح، اعتبارسنجی و دفتر ممیزی

## تصمیم‌های قطعی و تغییرناپذیر مگر با بازبینی انسانی

1. عنوان مشابه به‌تنهایی معیار ادغام نیست؛ IMDb یکسان معیار قطعی است.
2. شناسهٔ تاریخی حذف نمی‌شود.
3. خانهٔ خالی بهتر از دادهٔ حدسی است.
4. «عامل»، «حاضر در مستند» و «موضوع مستند» یک چیز نیستند.
5. انیمیشن و مستند با ژانر رسمی IMDb تشخیص داده می‌شوند.
6. کنسرت/تورِ صرف با مستندی دربارهٔ کنسرت یا گروه تفاوت دارد.
7. اتصال جست‌وجویی باید صریحاً «جست‌وجو» بماند.
8. هر انتشار مهم باید شمار، خروجی، پشتیبان و تاریخچه را هم‌زمان به‌روز کند.