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

نسخهٔ شیوه‌نامه: ۹

همگام با نسخهٔ ۵۲ درگاه

وضعیت مبنا: نسخهٔ ۵۳؛ ۴٬۵۷۱ فیلم یکتا، ۷۳۹ مستند، ۲۷۴ انیمیشن مستقل و ۶۰ فیلم موسیقی‌محور

## ۱. هدف، مالکیت و دامنه

درگاه موزیکال پایگاه پژوهشی علیرضا کاوه برای فیلم‌ها، اشخاص، همکاری‌ها، سبک‌های موسیقایی و شماره‌های موزیکال است. هدف فقط گردآوری عنوان‌ها نیست؛ باید بتوان از فیلم به عوامل، از شخص به فیلم‌ها، از یک همکاری به شبکهٔ همکاران و از هر رکورد به منابع بیرونی رسید.

تعریف موزیکال در این پروژه گسترده اما پژوهش‌پذیر است. فیلم موزیکال کلاسیک، سنت‌های آواز و رقص سینمای هند، فیلم موسیقی، کنسرت، مستند موسیقی، انیمیشن موزیکال و آثار تجربی متکی بر موسیقی می‌توانند وارد شوند؛ اما صرف داشتن موسیقی متن یا چند ترانه برای ورود کافی نیست. نقش موسیقی در ساختمان فیلم یا ارزش پژوهشی اثر باید روشن باشد.

اصل دامنه: مرز را حذف نمی‌کنیم؛ آن را با برچسب‌های ژانر اصلی، ژانر تکمیلی، قالب، سبک، سنت و مجموعه قابل مشاهده می‌کنیم.

## ۲. تاریخچهٔ شکل‌گیری

هستهٔ مرجع با ۴٬۴۰۹ فیلم شکل گرفت: ۴٬۲۷۵ عنوان اصلی و ۱۳۴ عنوان تکمیلی. داده‌ها از آرشیو شخصی، Movie Collector، فهرست IMDb و پژوهش‌های کتاب موزیکال گرد آمد و به CSV منتقل شد. اتصال‌های اشخاص و نقش‌های موسیقی، ژانرها، قالب‌ها و سبک‌ها به‌تدریج از جدول اصلی جدا شدند تا هر بخش مستقل توسعه یابد.

در مرحلهٔ گسترش Movie Collector، ۳۰۷ عنوان دیگر افزوده شد و شمار فیلم‌ها به ۴٬۷۱۶ رسید. سپس چهار فیلم موزیکال کارگردانی‌شده به‌دست آمول پالکار — Ankahee، Thodasa Roomani Ho Jaayen، Daayraa و Paheli — همراه با پروندهٔ شخص و اتصال‌ها افزوده شدند و نسخهٔ ۴۰ به ۴٬۷۲۰ فیلم رسید.

نام تاریخی فایل اصلی، `musical_portal_4409.csv`، برای سازگاری حفظ شده است؛ عدد نام فایل دیگر شمار زندهٔ رکوردها نیست.

## ۳. ساختار داده و شناسه‌ها

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

شناسهٔ جدید فیلم با الگوی `MUS-F-000001`، شناسهٔ شخص با `MUS-P-000001`، شناسهٔ شماره با `MUS-N-000001`، شناسهٔ مستند با `MUS-D-000001` و شناسهٔ فیلم موسیقی‌محور با `MUS-MC-000001` ساخته می‌شود. شناسه‌های قدیمی مانند `lb:`، `vault:` و `indian_core:` حذف یا بازنویسی نمی‌شوند؛ زیرا اتصال جدول‌های قدیمی به آن‌ها وابسته است. هر شناسه باید یکتا و پایدار بماند.

شناسهٔ مستقل انیمیشن با الگوی `MUS-A-000001` ساخته می‌شود. در ادغام تکراری‌ها، شناسهٔ هسته در `film_id` می‌ماند، شناسه‌های دیگر در `legacy_film_ids` حفظ می‌شوند و پرونده‌های قدیمی از راه همین شناسه‌های جایگزین همچنان قابل بازیابی‌اند. اختلاف‌های متنیِ منبع نیز در `merge_preserved_values_json` و دفتر ممیزی ادغام عیناً نگهداری می‌شوند.

- `musical_portal_4409.csv`: اطلاعات اصلی فیلم و اتصال‌های بیرونی
- `documentaries.csv`: همهٔ مستندها، دامنهٔ موسیقایی/عمومی، شناسهٔ مستقل و پیوند با فیلم موجود
- `documentary_credits.csv`: کارگردان، آهنگ‌ساز، عوامل اصلی و دپارتمان موسیقی مستندها
- `documentary_subjects.csv`: شخصیت‌ها، گروه‌ها و Bandهای موضوع یا حاضر در مستند
- `animations.csv`: انیمیشن‌های یکتا، شناسهٔ مستقل و اتصال به فیلم یا ۳۰نما
- `animation_credits.csv`: کارگردان‌ها، آهنگ‌سازها، صداپیشگان و عوامل اصلی انیمیشن‌ها
- `music_centered_films.csv`: فهرست مستقل فیلم‌های موسیقی‌محور و اتصال‌های IMDb به موجودی‌های قبلی
- `imdb_music_labels_report.json`: شمار و وضعیت تطبیق دو برچسب مستقل `Music` و `Musical` در IMDb
- `film_genres.csv`: ژانر اصلی و ژانرهای تکمیلی
- `film_formats.csv`: قالب نمایش یا تولید
- `film_styles.csv`: سبک‌های موسیقایی
- `featured_people.csv`: اشخاص منتخب و شناسه‌های آنان
- `musical_numbers_572.csv`: شماره‌های موزیکال و اتصال ویدئویی
- `music_department_relations_3516.csv`: نقش‌های جزئی دپارتمان موسیقی
- `music_groups.csv`: هویت‌های قطعی گروه و Band موسیقی
- `music_group_relations.csv`: اتصال گروه‌ها به فیلم یا مستند
- `merge_audit/`: نگاشت شناسه‌ها، ردیف‌های پیش از ادغام و بازنویسی اتصال‌ها
- `docs/musical-portal-history.md`: تاریخچهٔ اجرایی نسخه‌به‌نسخه
- `docs/musical-portal-operations.md`: دستور کار ادامه، کنترل کیفیت و بازیابی

## ۴. الگوی پروندهٔ فیلم

هر فیلم باید کارت فهرست و پروندهٔ کامل داشته باشد. کارت شامل عنوان فارسی و اصلی، سال، کشور، برچسب‌ها، عوامل اصلی و اتصال‌های مهم است. پروندهٔ کامل همهٔ داده‌های موجود، دکمهٔ تحلیل GPT، شماره‌های موزیکال و پیوند عوامل به پروندهٔ شخص را نشان می‌دهد.

برچسب‌های رسمی `Music` و `Musical` در دو ستون مستقل `imdb_music` و `imdb_musical` نگهداری می‌شوند. این دو با ژانر اصلی پژوهشی درگاه یکی نیستند و جایگزین آن نمی‌شوند. مقدار `1` یعنی برچسب در دادهٔ روز IMDb وجود داشته، `0` یعنی وجود نداشته و خانهٔ خالی یعنی فیلم فاقد شناسه یا شناسه در دادهٔ IMDb پیدا نشده است.

1. عنوان اصلی با املای معتبر و عنوان فارسی روشن.
2. سال انتشار اصلی؛ در اختلاف منابع، سال قطعی‌تر و یادداشت اختلاف.
3. کشور یا کشورهای تولید، نه زبان به‌جای کشور.
4. کارگردان، بازیگران شاخص، آهنگساز و ترانه‌سرا؛ نقش‌های دیگر در صورت قطعیت.
5. ژانر اصلی، ژانرهای تکمیلی، قالب و سبک بدون پرکردن اجباری.
6. مجموعه یا منشأ ورود برای پیگیری پژوهشی.
7. اتصال مستقیم معتبر یا اتصال جست‌وجویی مشخص‌شده.

اصل عدم حدس: خانهٔ خالی بهتر از دادهٔ ساختگی است. دادهٔ نامطمئن ثبت نمی‌شود یا با وضعیت «نیازمند بازبینی» نگه داشته می‌شود.

## ۵. الگوی پروندهٔ شخص و همکاری‌ها

نام هر عامل در پروندهٔ فیلم باید به صفحهٔ شخص متصل شود. صفحهٔ شخص نقش‌ها، کشور در صورت قطعیت، شمار فیلم‌های موجود، فیلم‌ها به‌ترتیب زمانی و دکمهٔ تحلیل جایگاه او در نظریهٔ علیرضا کاوه را نمایش می‌دهد.

همکاری پرتکرار وقتی نمایش داده می‌شود که دو شخص دست‌کم دو فیلم مشترک داشته باشند. شبکه‌های سه‌نفره و بزرگ‌تر فقط با دست‌کم سه فیلم مشترک محاسبه می‌شوند؛ تا هشت شبکهٔ مهم نمایش داده می‌شود و محاسبه هنگام بازشدن بخش انجام می‌گیرد تا درگاه سبک بماند.

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

## ۶. دسته‌بندی بر پایهٔ نظریهٔ علیرضا کاوه

دسته‌بندی نهایی بر پنج محور رسانه، سبک، ژانر، قالب و سنت استوار است. این محورها جای یکدیگر را نمی‌گیرند. انیمیشن قالب یا شیوهٔ رسانه‌ای است؛ فانتزی ژانر است؛ جاز سبک موسیقایی است؛ بالیوود یا موزیکال کلاسیک هالیوود سنت تاریخی و تولیدی است.

- ژانر اصلی: برای رکوردهای هسته معمولاً «موزیکال» است.
- ژانر تکمیلی: عاشقانه، فانتزی، جنایی، مستند، زندگی‌نامه‌ای، کوییر و مانند آن.
- قالب: فیلم بلند، کوتاه، انیمیشن، مستند، کنسرت، تلویزیونی و مانند آن.
- سبک: فقط وقتی ثبت شود که سبک موسیقایی قابل تشخیص یا مستند باشد.
- سنت: نسبت تاریخی و جغرافیایی اثر، نه صرفاً کشور تولید.

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

## ۷. قواعد اتصال‌های بیرونی

اتصال‌ها بخش اصلی درگاه‌اند و باید به عمیق‌ترین صفحهٔ معتبر همان فیلم یا آلبوم برسند. ترتیب مطلوب برای هر فیلم: IMDb، Wikipedia، Letterboxd، Spotify و YouTube. نبود یک اتصال مانع ورود فیلم نیست، اما باید بعداً قابل شناسایی و تکمیل باشد.

- IMDb: شناسه و نشانی با هم ثبت می‌شوند. شناسهٔ تکراری خودکار حذف نمی‌شود؛ ابتدا احتمال فیلم تکراری یا نسخهٔ دیگر بررسی می‌شود.
- Wikipedia: صفحهٔ دقیق فیلم مقدم است؛ در نبود آن اتصال جست‌وجویی بهتر از صفحهٔ اشتباه است.
- Letterboxd: صفحهٔ همان فیلم و همان سال؛ عنوان جایگزین بررسی شود.
- Spotify: آلبوم یا موسیقی متن رسمی، نه فهرست پخش نامرتبط.
- YouTube: نسخهٔ رسمی یا قابل‌اعتبار فیلم/شماره مقدم است. ویدئوی نقد، معرفی یا نسخهٔ ناقص نباید «فیلم کامل» نام بگیرد.

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

## ۸. ثبت شماره‌های موزیکال

شمارهٔ موزیکال رکوردی مستقل با شناسهٔ `MUS-N` است و به شناسهٔ فیلم وصل می‌شود. حداقل داده‌ها: عنوان شماره، عنوان و سال فیلم، پیوند YouTube، وضعیت ویدئو، نوع تطبیق، میزان اطمینان و یادداشت بازبینی.

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

## ۹. ثبت مستندها

هر مستند رکوردی مستقل با شناسهٔ `MUS-D` است. از نسخهٔ ۴۶، وجود برچسب `Documentary` در IMDb برای ورود به زبانه کافی است و `Music/Musical` فقط دامنهٔ «مستند موسیقایی» را مشخص می‌کند. رکوردهای موجود فیلم از راه `film_id` و `linked_film_ids` حفظ می‌شوند.

انیمیشن، ضبط صرف کنسرت، تور و اجرای صحنه‌ای از این مسیر کنار گذاشته می‌شوند. مستندی که دربارهٔ یک کنسرت، گروه یا سنت موسیقایی پژوهش می‌کند می‌تواند بماند؛ مرز، موضوع و ساختار مستند است نه صرف حضور اجرای زنده.

داده‌های غیرتجاری IMDb یک‌بار دریافت و بدون فراخوانی جداگانه برای هر عنوان پالایش می‌شوند. کارگردان و عوامل اصلی از شناسه‌های پایدار استخراج می‌شوند. «موضوع مستند» از اعتبارهای Self و Archive جداست و با سطح اطمینان نگهداری می‌شود؛ حضور یک شخص لزوماً به‌معنای موضوع اصلی بودن او نیست.

1. تطبیق با IMDb و ثبت شناسه، سال، نوع و ژانرها.
2. حذف تکراری‌ها با IMDb؛ عنوان مشابه به‌تنهایی معیار ادغام نیست.
3. اتصال رکوردهای قبلی به `film_id` بدون شکستن شناسه‌های تاریخی.
4. ثبت پیوند مستقیم ۳۰نما و جست‌وجوی دانلودروز؛ جست‌وجو با برچسب صریح.
5. خالی‌گذاشتن کارگردان یا کشور تا زمان منبع معتبر، به‌جای حدس.

## ۱۰. ثبت انیمیشن‌ها

هر انیمیشن رکوردی مستقل با شناسهٔ `MUS-A` دارد. معیار ورود، برچسب رسمی `Animation` در IMDb است و ادغام تکراری‌ها فقط با شناسهٔ IMDb انجام می‌شود.

نسخهٔ ۴۸ شامل ۲۰۵ عنوان یکتای موجودی پیشین و ۴۵ انیمیشن بلند تازهٔ ۳۰نماست. کوتاه‌ها و قالب‌های دیگر موجودی قبلی حفظ شده‌اند، اما از ۳۰نما فقط نوع `movie` وارد شده است.

کارگردان، آهنگ‌ساز، صداپیشگان و عوامل اصلی از داده‌های غیرتجاری IMDb استخراج می‌شوند و با شناسهٔ شخص به پرونده‌های ضربه‌پذیر متصل‌اند. دادهٔ نامطمئن خالی می‌ماند.

## ۱۰-الف. ثبت فیلم‌های موسیقی‌محور

فیلم موسیقی‌محور الزاماً موزیکال یا شبه‌موزیکال نیست. موسیقی باید در روایت، شخصیت، اجرا، حافظه، ادراک یا ساختمان صوری اثر نقش تعیین‌کننده داشته باشد؛ موسیقی متن درخشان به‌تنهایی برای ورود کافی نیست.

این گروه جدول مستقل `music_centered_films.csv` و شناسهٔ `MUS-MC` دارد و در شمار فیلم‌های اصلی، مستندها و انیمیشن‌ها محاسبه نمی‌شود. تطبیق با موجودی‌های پیشین فقط با IMDb دقیق انجام می‌شود. عنوان متصل دوباره ساخته نمی‌شود و عنوان مستقل نیز وارد هیچ‌یک از سه فهرست اصلی نمی‌شود.

آزمون ورود: با حذف موسیقی باید دست‌کم یکی از این‌ها فروبپاشد: کنش یا هویت شخصیت، مسیر روایت، منطق اجرا و آفرینش، حافظه و ادراک، یا سازمان زمانی و تصویری فیلم.

## ۱۱. نام‌گذاری، تطبیق و جلوگیری از تکرار

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

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

### گروه‌ها و Bandهای موسیقی

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

نسخهٔ ۵۱ دارای ۱۲۷ گروه تأییدشده و ۱۳۹ رابطه است: ۵۹ رابطه با فیلم و ۸۰ رابطه با مستند. ۲۲ نامزد مبهم در صف بازبینی انسانی نگه داشته شده‌اند. روش استخراج گروهی بوده و فراخوانی AI برای تشخیص رکوردبه‌رکورد انجام نشده است.

## ۱۲. کنترل کیفیت و بازبینی

پیش از انتشار هر بستهٔ تغییر:

1. شمار ستون‌های همهٔ CSVها یکسان و فایل‌ها قابل خواندن باشند.
2. شناسهٔ فیلم‌ها یکتا باشد و شناسهٔ تازه تداخل نکند.
3. رکورد فیلم در جدول ژانر، قالب و سبک با همان شناسه وصل شود.
4. عنوان، سال و کارگردان با دست‌کم یک منبع معتبر تطبیق داشته باشند.
5. اتصال‌های مستقیم به همان اثر برسند و اتصال جست‌وجویی برچسب درست داشته باشد.
6. پروندهٔ فیلم، صفحهٔ شخص، جست‌وجو و نمایش تلفن همراه بررسی شوند.
7. شمار فیلم صفحهٔ اصلی و نام فایل خروجی کامل به‌روز شود.
8. خروجی CSV و بستهٔ پشتیبان تازه ساخته شوند.

در خطاهای موردی روی یک رکورد متوقف نمی‌شویم: وضعیت آن ثبت می‌شود و بستهٔ سالم ادامه می‌یابد. این قاعده برای YouTube و منابع کم‌داده اهمیت ویژه دارد.

## ۱۳. انتشار، خروجی و پشتیبان‌گیری

هر انتشار یک شمارهٔ نسخه دارد و تغییر مهم آن در دفتر تغییرات ثبت می‌شود. خروجی کامل، اطلاعات اصلی، ژانر، قالب، سبک، عوامل و اتصال‌ها را در یک CSV ادغام می‌کند. بستهٔ ZIP کد درگاه، جدول‌های داده، خروجی یکپارچه و راهنمای بازیابی را نگه می‌دارد.

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

## ۱۴. روند استاندارد افزودن فیلم، مستند، انیمیشن یا شخص

1. تعریف دقیق بسته: یک فیلم، آثار موزیکال یک شخص، یک کشور یا یک منبع.
2. تهیهٔ فهرست اولیه و جداسازی موارد قطعی، تکمیلی و نیازمند بازبینی.
3. بررسی تکراری‌نبودن با عنوان، سال، کارگردان و IMDb.
4. ساخت شناسهٔ پایدار و افزودن اطلاعات اصلی.
5. ثبت ژانر، قالب و سبک فقط به‌اندازهٔ دادهٔ قابل دفاع.
6. افزودن عوامل و اطمینان از ساخته‌شدن پیوند پروندهٔ شخص.
7. افزودن اتصال‌های مستقیم و سپس جست‌وجویی.
8. افزودن شماره‌های موزیکال در صورت بررسی مستقل.
9. اجرای کنترل‌های ساختاری و دیداری.
10. به‌روزرسانی شمارها، خروجی، پشتیبان و دفتر تغییرات.
11. انتشار نسخه و ثبت نتیجه در شیوه‌نامه.

## ۱۵. وضعیت کنونی و دفتر تغییرات

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

### نسخهٔ ۵۲

زبانهٔ مستقل «فیلم‌های موسیقی‌محور» با ۶۰ عنوان منتخب ساخته شد. تطبیق فقط با IMDb انجام گرفت: ۲۱ عنوان به فیلم موجود متصل‌اند، `Koyaanisqatsi` هم‌زمان به رکورد مستند موجود وصل است و ۳۹ عنوان بیرون از موجودی‌های اصلی، صرفاً در جدول `MUS-MC` باقی مانده‌اند. شمار ۴٬۵۷۱ فیلم، ۷۳۹ مستند و ۲۷۴ انیمیشن هیچ تغییری نکرد.

### نسخهٔ ۵۱

جدول مستقل گروه‌ها و Bandهای موسیقی از فیلم‌ها، مستندها و داده‌های غیرتجاری IMDb ساخته شد: ۱۲۷ گروه قطعی، ۵۴ گروه دارای فیلم، ۷۵ گروه دارای مستند، ۵۹ رابطهٔ فیلم و ۸۰ رابطهٔ مستند. ۲۲ مورد مبهم بدون حدس در صف بازبینی ماند. هم‌زمان حافظهٔ پروژه به سه سند همگام تقسیم شد: شیوه‌نامهٔ اصلی، تاریخچهٔ اجرایی نسخه‌به‌نسخه و دستور کار ادامه/بازیابی. گزارش مستندها، انیمیشن‌ها، دپارتمان موسیقی، گروه‌ها، ادغام بی‌اتلاف IMDb و خروجی پایگاه داده در این اسناد تثبیت شد.

### نسخهٔ ۵۰

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

### نسخهٔ ۴۸

زبانه و پروندهٔ مستقل انیمیشن‌ها با شناسهٔ `MUS-A` ساخته شد. ۲۰۵ عنوان یکتای موجودی پیشین با ۴۵ انیمیشن بلند تازهٔ ۳۰نما ادغام شد. کارگردان، آهنگ‌ساز، صداپیشگان و عوامل اصلی به‌صورت گروهی از IMDb بازسازی و به پروندهٔ شخص متصل شدند.

### نسخهٔ ۴۷

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

### نسخهٔ ۴۶

گسترش زبانه از «مستندهای موسیقی» به همهٔ مستندهای موجود: ورود ۴۶ عنوان دیگر و رسیدن به ۷۳۹ مستند؛ ۷۲۶ عنوان موسیقایی و ۱۳ عنوان عمومی. چهار ضبط صرفِ کنسرت/اجرای صحنه‌ای کنار گذاشته شد. عوامل برای کل فهرست بازسازی شد: ۷۳۵ کارگردان، ۳۸۹ آهنگ‌ساز، ۳۹۴ دپارتمان موسیقی و ۶۶۹ عنوان دارای موضوع پیشنهادی.

### نسخهٔ ۴۵

استخراج گروهی عوامل ۶۹۳ مستند از داده‌های غیرتجاری IMDb: تکمیل کارگردان ۶۸۹ عنوان، آهنگ‌ساز ۳۴۳ عنوان، دپارتمان موسیقی ۳۴۸ عنوان و موضوع‌های موسیقایی پیشنهادی برای ۶۳۳ عنوان؛ چهار کارگردان نامشخص برای تکمیل دستی خالی مانده‌اند.

### نسخهٔ ۴۴

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

### نسخهٔ ۴۳

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

### نسخهٔ ۴۲

اتصال ۹۷۸ ردیف فیلم به نشانهٔ موجودی ۳۰نما، افزودن جست‌وجوی مستقیم دانلودروز و نگهداری پیوند ۳۰نما در پروندهٔ فیلم.

### نسخهٔ ۴۱

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

### نسخهٔ ۴۰

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

### گسترش ۴٬۷۱۶

افزودن ۳۰۷ عنوان منتخب از Movie Collector به هستهٔ ۴٬۴۰۹ فیلم و گسترش داده‌های عوامل موسیقی.

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

یکپارچه‌سازی ۴٬۲۷۵ فیلم اصلی و ۱۳۴ مدخل تکمیلی و پایه‌گذاری ساختار فیلم، شخص، ژانر، قالب، سبک و اتصال‌ها.

## ۱۶. کارهای باز

- تکمیل اتصال‌های IMDb و بررسی موارد تکراریِ تازه‌ای که در ورودهای بعدی پدید می‌آیند.
- گسترش اتصال‌های YouTube بدون توقف روی موارد نایاب.
- صریح‌کردن دو محور رسانه و سنت در ساختار داده.
- افزودن منظم تغییرات هر نسخه به همین شیوه‌نامه.
- همگام‌سازی دائمی شمارهای صفحهٔ اصلی، CSV کامل و پشتیبان.
- بازبینی ۲۲ نامزد گروه و Band و توسعهٔ شبکهٔ همکاری گروه‌ها بدون سنگین‌کردن درگاه.

## ۱۷. حافظهٔ رسمی و ترتیب مراجعه

برای ادامهٔ کار، سه سند باید به‌ترتیب خوانده شوند:

1. `musical-portal-guide.md`: تعریف‌ها، قواعد ورود، ساختار داده و وضعیت جاری.
2. `musical-portal-history.md`: اینکه در هر نسخه چه کاری، با چه شمار و چه تصمیمی انجام شد.
3. `musical-portal-operations.md`: شیوهٔ امن افزودن، ادغام، اعتبارسنجی، خروجی، پشتیبان و بازیابی.

هر تصمیم تازه‌ای که دامنه، شناسه، شمار یا روش استخراج را تغییر دهد باید هم‌زمان در صفحهٔ خواندنی درگاه، این سه سند و دفتر تغییرات نسخه ثبت شود.

---

مرجع اصلی خواندنی: صفحهٔ «شیوه‌نامه و تاریخچه» در درگاه موزیکال.  
نسخهٔ متنی: همین فایل، همراه درگاه و بسته‌های پشتیبان.